企业官网建设流程全解析

如果你跟我一样，已经不是在“体验”DeepSeek Harness，而是开始认真把它当日常生产力工具在跑，那一定会碰到一个绕不开的问题：官方内置能力撑不起复杂工作流，得装插件。可一个个去 GitHub 上找、手动解压、复制进插件目录，既低效又容易漏依赖。我这次直接在腾讯云上把dsh-market插件市场搭了起来，整个过程踩了不少坑，也积累了一套能稳定复现的流程，今天完整分享出来。

这篇文章会从环境准备讲到插件安装再到模型接入，适合准备在云服务器上部署 DeepSeek Harness、想通过 dsh-market 扩展插件能力的开发者参考。无论你是刚接触这套框架，还是已经本地跑过但没试过云端部署，按下面的步骤走，都能少走不少弯路。

1. 先把概念理清楚：dsh-market 在 DeepSeek Harness 里扮演什么角色

1.1 它是主程序的插件管理入口，不是独立应用

DeepSeek Harness 本身是一个面向多智能体编排的框架，提供桌面版和 CLI 版两套入口。它解决的问题是：让多个 Agent 角色协同工作、按流程调用工具、把外部数据源和模型响应串起来。但框架主程序不会把所有能力都内置，比如网页搜索、文档解析、定时任务、消息通知这类功能，都是通过插件扩展的。

dsh-market 就是干这个的。你可以把它理解成主程序里的“应用商店”，通过一条命令行或一个统一入口，完成插件的检索、安装、升级、卸载。它解决的不只是“把文件复制到目录”，而是连同插件的依赖、版本约束、注册信息一起处理。

我这里要强调一个容易混淆的点：dsh-market不是 DeepSeek 官方主程序自带的模块，至少在我部署的 v0.1.x 系列里，它需要单独安装和启用。装完之后，主程序会多出一组dsh market开头的子命令，这才是它在正常工作的标志。

1.2 为什么选腾讯云而不是本地机器

可能有人会问：既然 Harness 有桌面版，为什么还要折腾服务器？我的答案很直接：因为工作流要常驻跑。本地机器一关盖、一断网、一连不上公司内网，编排任务就断了。放在云服务器上之后，插件市场、Agent 任务、模型调用都能 7×24 小时运转，我这边只需要用浏览器或者 SSH 连上去看结果。

腾讯云在这个场景下的优势主要是两点：一是轻量应用服务器足够便宜，跑 Harness 这种负载完全够用；二是国内访问相关代码仓库和模型接口的网络路径更稳，尤其你如果用的模型服务是国内厂商的 API，云上部署的延迟会明显低于本地再到公网绕一圈。

1.3 部署前的基本认知：版本、目录、依赖关系

动手之前，建议先花五分钟搞清楚三件事：

• 主程序版本：不同版本的插件接口有差异，插件市场里的插件也会标注兼容版本。装错版本会直接导致插件加载失败。
• 服务目录：DeepSeek Harness 安装后默认会有apps、data、plugins几个核心目录，插件市场的数据和插件本体都集中在plugins目录下，后面配置时用的都是绝对路径。
• 运行依赖：主程序基于 Node.js 和一些 Python 工具链，云服务器上需要提前准备好这些基础环境，不然安装插件时会出现“依赖执行失败”之类的问题。

这些概念先在我脑子里过一遍，再开始动手，后面就不会被各种报错带偏方向了。

2. 腾讯云服务器选型与初始化：基础没做对，后面全白搭

2.1 轻量应用服务器还是 CVM：我的建议

腾讯云有两类常见产品：轻量应用服务器和云服务器 CVM。只看名字可能觉得差不多，实际上差距主要在扩展性和网络配置上。

如果你是第一次在云上搭 DeepSeek Harness，我建议直接从轻量应用服务器的 2 核 4G 配置起步。Harness 主程序本身内存占用不高，但模型加载和插件运行都会吃一些，4G 刚好是舒适区。后续如果跑的任务量上来了，再迁到 CVM 也不迟，配置迁移成本很低。

2.2 安全组与防火墙放行策略

这是我最想提醒新手的地方。腾讯云服务器默认的安全组策略很严格，如果你只放行了 22 端口，后面 Harness 的 Web 管理界面根本无法访问，而且你还找不出原因。

需要放行的端口建议如下：

• 22：SSH 登录端口，必须放行，但建议把密码登录改成密钥登录。
• 8080或3000：DeepSeek Harness 的 Web 管理界面端口，安装时按实际端口配置。
• 8000：部分插件的本地回调端口，比如 WebHook 类插件依赖这个端口接收外部事件。
• 11434：如果你打算连本地模型服务（Ollama），需要放行这个端口，但注意不要对公网开放，只允许指定 IP 或内网访问。

在腾讯云控制台的操作路径是：实例详情 → 防火墙 → 添加规则。轻量服务器和 CVM 的入口略有不同，但规则配置方式是类似的。安全组放行之后，还要看一眼服务器系统防火墙，Ubuntu 上用sudo ufw status确认没有拦截。

2.3 系统初始化：换源、装基础工具、确认 Node 环境

我用的是 Ubuntu 22.04 LTS，这版本对 Node.js 的兼容比较稳。登录服务器后，先把基础环境补齐：

sudo apt update && sudo apt upgrade -y sudo apt install -y git curl wget unzip build-essential

然后装 Node.js。DeepSeek Harness 对 Node 版本有要求，建议用 nvm 来装而不是直接 apt 装，方便以后切换版本：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash source ~/.bashrc nvm install 18.20.4 nvm use 18.20.4 node -v npm -v

我在初始化的时候顺手把 Python 3 也确认了一下，因为部分插件需要跑 Python 脚本。Ubuntu 22.04 自带 Python 3.10，如果没有就补装一下：

sudo apt install -y python3 python3-pip

到这里，服务器的“地基”就打好了。

3. 安装 DeepSeek Harness 主程序：几个容易出错的环节单独说

3.1 下载对应版本，而不是默认拉最新

每次装这个框架，我都会先看一眼官方仓库的 Releases 列表，挑一个相对稳定的版本，而不是盲目下载 latest。原因是 Harness 迭代速度很快，v0.1.6 和 v0.1.5-rc.2 之间的插件接口可能已经变了，你从市场里装的插件未必兼容新版主程序。

我这里以 v0.1.5 系列为例，下载命令大概是：

wget https://github.com/deepseek-harness/deepseek-harness/releases/download/v0.1.5/deepseek-harness-v0.1.5-linux-x64.tar.gz mkdir -p ~/deepseek-harness tar -zxvf deepseek-harness-v0.1.5-linux-x64.tar.gz -C ~/deepseek-harness

注意，解压之后不要直接运行，先把目录结构看清楚：

cd ~/deepseek-harness ls -la

正常情况下会看到bin、scripts、plugins、config这几个目录。确认存在plugins目录，后面 dsh-market 装插件就是往这里写。如果发现没有，先手动建一个，避免后面插件安装报目录不存在：

mkdir -p ~/deepseek-harness/plugins

3.2 初始化主程序配置

首次运行前，需要初始化配置文件。这一步不同版本的初始化和命令不太一样，我用的方式是运行 CLI 的初始化子命令：

cd ~/deepseek-harness ./bin/dsh init

初始化过程会问几个问题，比如数据目录位置、是否启用插件市场、Web 管理界面端口。按实际需求填写就可以了。如果不想交互式填写，也可以直接用--config参数指定配置文件。

初始化完成后，会生成一个配置文件，通常是~/.deepseek-harness/config.yaml。可以先打开看看里面的关键字段：

cat ~/.deepseek-harness/config.yaml

重点关注plugins_dir和server两个字段，前者决定插件安装到哪，后者控制 Web 端口。我需要手动把plugins_dir指到我前面创建的目录：

plugins_dir: /root/deepseek-harness/plugins server: host: 0.0.0.0 port: 8080

host必须设成0.0.0.0，否则 Web 管理界面只能在服务器本机访问，你从本地浏览器根本打不开。

3.3 启动主程序并确认服务状态

配置好之后，先别管插件市场，把主程序跑起来：

nohup ./bin/dsh serve > ~/dsh.log 2>&1 &

然后确认进程和端口：

ps aux | grep dsh ss -tlnp | grep 8080

如果ss输出里能看到监听在0.0.0.0:8080的进程，说明主程序已经正常启动。此时用你本地浏览器的http://服务器IP:8080访问一下，应该能看到 DeepSeek Harness 的登录或初始化页面。

如果页面打不开，大概率是腾讯云防火墙规则没放行 8080 端口，回 2.2 节检查一下。

4. 启用 dsh-market 插件市场：从零到能搜索插件

4.1 安装插件市场模块

DeepSeek Harness 主程序自带的 CLI 里，不一定默认包含dsh market命令。我装完 v0.1.5 后发现，需要单独安装插件市场模块。官方提供的安装方式是通过一个独立脚本完成的：

cd ~/deepseek-harness ./bin/dsh-plugin-enable dsh-market

如果你用的版本没有这个 enable 命令，也可以直接下载 market 模块的压缩包，解压到plugins目录下。我建议优先用命令方式，因为它会顺带处理模块的依赖和注册信息。

安装完成后，验证一下 market 命令是否可用：

./bin/dsh market --help

正常会输出子命令列表，比如search、install、list、update、remove。如果提示command not found，说明模块没安装成功，检查一下刚才的命令输出有没有报错。常见错误是权限不足，因为~/deepseek-harness目录可能会被系统限制写入。

4.2 配置插件源

插件源就是 dsh-market 从哪里拉取插件列表和安装包。默认配置指向官方维护的 registry，但网络环境不稳定时，可以考虑手动指定源地址。

执行以下命令配置源：

./bin/dsh market source add official https://registry.dsh-market.example.com/v1 ./bin/dsh market source set-default official

配置完成后，可以用source list确认当前源的状态：

./bin/dsh market source list

这一步我遇到过“无法解析主机名”的报错，基本是 DNS 问题或者网络隔离。检查一下服务器能否正常访问外网，必要时在/etc/resolv.conf里补充 DNS 地址。

4.3 验证市场连通性

配置好源之后，随手搜一个插件，验证整条链路是通的：

./bin/dsh market search web

如果命令返回了一串插件列表，说明 dsh-market 安装成功，并且能正常访问插件源。这时候可以开心一下，因为说明主程序、插件市场和网络链路都没问题。

如果返回超时，不要急着换源，先做三件事：一是确认服务器能 ping 通外网；二是确认防火墙没有阻断 443 和 8080 端口；三是检查系统时间是否准确，时间偏差过大可能导致 HTTPS 证书校验失败。

5. 实操环节：用 dsh-market 完成插件的搜索、安装、启停、卸载

5.1 搜索插件

搜索是使用频率最高的命令。语法很简单：

./bin/dsh market search <关键词>

比如我想找一个做网页搜索的插件：

./bin/dsh market search web-search

返回结果一般包括插件名称、版本、描述、作者、兼容的主程序版本号。这里我建议养成一个习惯：每次搜索完，都留意最后返回的compatible_versions字段，确认它跟你安装的主程序版本在同一个区间内，再决定装不装。

5.2 安装插件及依赖处理

安装命令很简单：

./bin/dsh market install web-search

但背后发生的事情值得说清楚。dsh-market 会自动做三件事：拉取插件压缩包、解压到 plugins 目录、解析并安装插件依赖。

依赖解析是里面最容易出问题的环节。如果插件依赖某个 Python 包，而当前环境的pip版本过旧或缺少编译工具，安装就会卡住。我遇到过一次安装docx-report插件时因为缺python3-dev包直接失败，后来补装才解决。

建议安装完一个插件后，在项目目录下确认一下插件的独立记录：

./bin/dsh market list --show-deps

这个命令会列出已安装插件的元信息、依赖状态和执行权限。如果某个插件的status显示broken，先用dsh market repair修复，不要急着重启主程序。

5.3 查看已安装插件、启用和停用

插件安装好不代表立即生效。DeepSeek Harness 的设计里，插件有 installed 和 enabled 两个状态，安装只是把文件放进目录，启用才会真正注册到主程序的调度循环里。

查看状态：

./bin/dsh market list

启用插件：

./bin/dsh market enable docx-report

停用插件：

./bin/dsh market disable docx-report

我一般不会一次性启用所有插件。原因是插件之间可能存在事件监听冲突，同时启用过多插件会让主程序启动变慢，还容易在日志里刷出一堆无关异常。建议按工作流所需，只开启必要的。

5.4 更新与回滚

插件市场里的插件会持续更新。更新命令：

./bin/dsh market update web-search

批量更新所有插件：

./bin/dsh market update --all

更新前务必看一眼变更日志。插件升级偶尔会伴随配置字段调整，如果旧配置里有废弃字段，主程序启动阶段会警告但不一定报错，后续功能会异常，非常隐蔽。

如果需要回滚到指定版本：

./bin/dsh market install web-search@1.2.0

这个命令强制指定版本号安装，会覆盖当前版本。回滚之后建议重启一次主程序，确保插件相关进程重新加载。

5.5 一个真实的插件安装组合案例

我目前的云端环境里，同时跑了三个插件，分别是web-search、docx-report、scheduler。组合逻辑是：scheduler 插件定时触发检索任务，web-search 抓取结果，docx-report 把结果格式化为报告文档。

这种组合用命令行依次安装即可：

./bin/dsh market install web-search ./bin/dsh market install docx-report ./bin/dsh market install scheduler

安装后确认状态全部是 enabled，然后我在 Web 管理界面里创建了一个“每晚八点执行检索并生成报告”的智能体流，第一次跑通的时候，整个链路从触发到出文件只花了不到两分钟，比手动操作高效太多了。

6. 让插件真正工作：配置 DeepSeek 模型与本地模型接入

6.1 配置在线 API 模型

dsh-market 里的插件大多需要调用语言模型来理解输入和生成输出，所以主程序必须先配置好模型服务。DeepSeek Harness 支持多种模型后端，最常用的就是 DeepSeek 官方 API。

在配置文件里添加：

model: provider: deepseek api_key: sk-你的APIKey base_url: https://api.deepseek.com/v1 model_name: deepseek-chat

配置完成后，用一条命令测试连通性：

./bin/dsh model test

如果返回模型回复内容，说明 API Key 和网络都没问题。这里叮嘱一句，API Key 绝对不要提交到 Git 仓库，建议直接用环境变量的方式注入：

export DEEPSEEK_API_KEY=sk-你的APIKey

6.2 配置本地模型（Ollama）与思考模式

部分场景下，我不希望所有数据都经过线上 API，比如内网文档分析，这时候就会把 Harness 接到本地模型服务。我用的是 Ollama，安装后拉取一个模型：

ollama pull qwen2.5:7b

然后修改 Harness 配置：

model: provider: ollama base_url: http://127.0.0.1:11434 model_name: qwen2.5:7b

如果你跟我在同一台腾讯云服务器上跑 Ollama，直接用127.0.0.1就可以，不要图省事填公网 IP，没意义还增加暴露风险。

关于搜索词里反复出现的“思考模式”，其实是 DeepSeek Harness 在模型推理前先走一段“思维链草稿”的选项，适用于需要复杂推演的任务。配置文件里开启：

model: thinking_mode: true thinking_model: deepseek-reasoner

开启后，Harness 会先把问题拆解成步骤，再让主模型生成答案。代价是响应时间变长、token 消耗变大。建议只在需要分析复杂问题时启动，简单问答保持关闭，否则插件任务的整体耗时会明显上升。

6.3 插件 + 模型的联动验证

配置好模型之后，一定要跑一个端到端验证，别等到工作流出问题才发现模型配置没生效。

我这里以web-search插件为例。用命令行直接执行插件的入口函数：

./bin/dsh plugin run web-search --query "DeepSeek Harness 插件市场"

如果最终能拿到搜索结果摘要，说明插件、模型、网络三层都通了。如果插件输出为空，先看~/dsh.log里的错误日志，重点排查是不是模型接口返回超时或者 API Key 权限不足。

7. 安装时的踩坑记录与排查思路

7.1dsh market命令找不到

这个问题我第一次在云服务器上就遇到了。现象是主程序能启动，但执行./bin/dsh market --help提示command not found。

排查顺序大概是：先确认 market 模块是否真的安装了，去plugins目录下看有没有dsh-market文件夹；再检查主程序 CLI 的插件列表，执行./bin/dsh plugin list，如果里面没有 market，说明模块没有注册成功。

最后的解决办法很直接，重新跑一次 enable 脚本，这次注意使用绝对路径，避免相对路径导致系统找不到模块：

cd /root/deepseek-harness ./bin/dsh-plugin-enable dsh-market

7.2 插件版本与主程序版本不匹配

这个坑非常隐蔽。现象是插件安装成功、启用成功，但运行时功能完全不生效，日志里反复出现method not found。

我一开始以为是网络问题，后来认真对比才发现，插件要求的 Harness 最低版本比服务器上装的版本高。我用dsh market install时用默认版本安装，默认版本往往是最新，对主程序的版本要求自然就高。

解决办法两种：一是把主程序升级到兼容版本；二是指定安装旧版插件：

./bin/dsh market install some-plugin@1.0.0

7.3 如何回退到 v0.1.5-rc.2

有搜索词提到“怎么退回到 v0.1.5-rc.2”，我在升级主程序后确实遇到过插件不兼容的问题，当时的处理路径是这样的：

先去官方仓库 Releases 页找到 v0.1.5-rc.2 的下载链接，然后保留现在的配置文件，把主程序目录整体备份，再解压旧版本覆盖。

mv ~/deepseek-harness ~/deepseek-harness.bak.$(date +%Y%m%d) mkdir ~/deepseek-harness tar -zxvf deepseek-harness-v0.1.5-rc.2-linux-x64.tar.gz -C ~/deepseek-harness

然后把备份目录里的plugins和config复制回去。注意只复制这两个目录，不要复制旧版本的二进制文件，否则覆盖解压就没有意义了。

回退后有一个常见现象：插件市场 API 可能报版本不匹配，因为服务器端已经升级。此时把插件源指向旧版兼容的 registry，或者直接离线安装插件包，都能正常跑起来。

7.4 下载中断和缓存问题

云服务器上下载安装包偶尔会失败，尤其是插件体积较大的情况。dsh-market 下载是断点续传还是整体重试，取决于插件源实现。我遇到的实际情况是：大插件下载一半断了，重试时校验不通过。

这时候最快的办法是清掉本地缓存再重装：

./bin/dsh market clean-cache ./bin/dsh market install big-plugin --force

如果多次失败，换一个时间段再试，或者临时切换到备用插件源。网络波动是常态，这不算环境问题，多试几次就好了。

8. 安装完成后的常规体检：让部署环境更稳健

经历完整套安装流程之后，我每在一台新服务器上搭建这个环境，最后都会做一套固定的“体检”：

• 用uptime确认服务器负载正常，避免 CPU 超售导致模型调用卡顿。
• 用free -h查看内存剩余量，插件装多之后内存会上去，4G 如果吃紧就先把不常用的插件停掉。
• 用crontab给 dsh 主进程加一个守护或者写一个简单的重启脚本，防止进程意外退出后中断任务。

另外，腾讯云控制台的“云监控”记得开一下，重点盯 CPU、内存和磁盘 IO。别等插件任务跑挂了才回去翻日志，监控告警才是长期稳定运行的关键。每次开新服务器，我都会先把这些配好再继续干正事，后面省心很多。