企业官网建设流程全解析

如果你最近在折腾 DeepSeek Harness，那 dsh-market 这个名字你一定不陌生。简单说，DeepSeek Harness 是一个把 DeepSeek 模型能力包装成“可编排、可扩展”的智能体开发框架，而 dsh-market 就是为它准备的插件市场，类似 VS Code 的插件商店，只不过这里装的是能和智能体协同工作的工具模块与技能包。这篇文章把我的完整操作过程拆开来讲：从在腾讯云开一台服务器，到把 dsh-market 配置好、装下第一个插件，全部记录下来。我踩过的坑、反复试出来的正确配置顺序，也一并写出来。新手照着一步步点就行，想深入理解插件机制的老手，后边几节内容也不会让你觉得白看。

先说一个很多人问的问题：为什么非要在云服务器上搭，而不是直接在自己笔记本上跑？我的真实体会是，DeepSeek Harness 这类框架经常要长时间挂着跑批量任务，本地笔记本一合盖、一断网，任务就断了。而且多个智能体编排起来以后，互相之间要通信、要共享文件，固定公网 IP 和稳定网络环境比什么都重要。正好腾讯云的轻量应用服务器价格不贵，新用户活动价更低，拿来做 DeepSeek Harness 的“长期基地”性价比很合适。以下内容基于我在腾讯云云服务器 CVM / 轻量应用服务器上的实际操作，Ubuntu 22.04 系统，全程命令行操作。

1. 先搞清楚：DeepSeek Harness 和 dsh-market 到底解决什么问题

1.1 一个类比：Harness 是“操作系统”，dsh-market 是“应用商店”

很多人第一次听说 DeepSeek Harness 时，容易把它理解成一个“聊天机器人外壳”。其实不是。它是一个智能体编排框架，你可以把它想象成一台手机的底层操作系统：模型能力是 CPU，而各种插件就是一个个 App。你让一个智能体去写代码、让它去读文档、让它去调外部 API，这些能力默认是不全的，得靠插件补上。

dsh-market 就是这个“应用商店”。它不直接干活，它负责提供插件的索引、版本信息和下载地址。安装好 dsh-market 之后，你可以用一条命令搜索插件、安装插件、更新插件，整个体验和你在 VS Code 里装扩展几乎一样。

1.2 为什么要在腾讯云上搭，而不是本地跑

我最初是在 Mac 笔记本上装的 DeepSeek Harness，跑几个小 demo 没问题，但一旦开始用“多智能体编排”模式，电脑风扇直接起飞，而且任务一跑就是几小时，根本不敢合盖子。后来我把环境迁到腾讯云上，情况完全不一样了。

云服务器有几个明显的优势。第一，公网 IP 固定，如果你的插件市场要给别人访问，或者你想让手机在外面也能提交任务，云服务器是必须的。第二，安全组规则可以精确控制哪些端口对外开放，比寝室路由器端口转发省心多了。第三，腾讯云服务器在国内访问 DeepSeek API 的延迟很低，模型响应速度比我从本地跨网访问快很多，实测同样的 deepseek-chat 模型，请求耗时能差出一倍。第四，配置可以按需升级，先买个 2 核 4G 的机器跑通，以后不够了直接升配，不需要重装系统。

1.3 需要准备哪些东西

在正式动手之前，先把清单列出来，别做到一半才发现缺东西。

• 一台腾讯云服务器，系统选 Ubuntu 22.04 LTS，这是最稳妥的选择
• 一个 DeepSeek 开放平台的 API Key，用来让 Harness 调用模型
• SSH 终端工具，Windows 用户可以用自带 PowerShell 或者 MobaXterm，Mac 用户直接用系统终端
• 基本的 Linux 命令行常识，知道cd、ls、vim这几个命令就够
• 如果后续要让插件市场支持公网访问，需要一个域名或者直接用服务器 IP 访问

我使用的是腾讯云轻量应用服务器，2 核 4G 配置，系统盘 60G，对于跑 DeepSeek Harness 和插件市场来说完全够用。带宽选 5Mbps 起步，因为插件下载和模型请求都要走网络。

2. 核心机制拆解：dsh-market 是怎么工作的

2.1 插件市场的本质：一个远程注册表

dsh-market 听起来高大上，本质上就是一份远程的插件注册表。它维护了一个 JSON 格式的索引文件，里面记录了每个插件的名字、版本、描述、下载地址、依赖关系。DeepSeek Harness 在启动时会读取这个索引，然后你执行dsh plugin install xxx的时候，它就根据索引里的地址去下载插件包，解压到本地插件目录。

这个过程和 Linux 的 apt 软件源机制是一样的。apt 的 sources.list 指向一个服务器，dsh-market 就是 DeepSeek Harness 的“软件源”。理解了这一点，后面遇到安装失败就知道往哪个方向排查了——要么是索引拉不下来，要么是插件包下载地址不通。

2.2 dsh-market 与 DeepSeek Harness 的交互流程

我把整个交互流程拆成四步，这样你在排查问题的时候思路会清晰很多。

第一步，Harness 启动时请求 dsh-market 的注册表接口，拉取最新的插件列表。第二步，当你搜索或安装插件时，Harness 根据本地缓存的插件元数据判断版本和依赖是否满足。第三步，确认无误后，Harness 从插件包的下载地址把压缩包拉下来。第四步，Harness 校验插件签名或哈希值（如果市场提供了的话），然后解压到插件目录并注册到本地。

这四个步骤中，任何一步网络不通都会导致安装失败。我在腾讯云上遇到最多的就是第三步超时，后面问题排查章节我会细说。

2.3 多智能体编排和插件是什么关系

如果你看过 DeepSeek Harness 的多智能体编排功能，可能会好奇：编排和插件到底什么关系？我的理解是，编排是“组织架构”，插件是“员工能力”。你可以用编排功能定义三个智能体：一个负责拆解需求，一个负责写代码，一个负责审查代码。但每个智能体具体能做什么事，取决于它加载了哪些插件。比如负责写代码的智能体，如果装了“代码执行器”插件，它就能真正运行代码；如果装了“Git 操作”插件，它就能自己提交代码。没有插件，智能体只能空对空聊方案，干不了实际活。

所以 dsh-market 不只是锦上添花，它决定了你的 Harness 到底能不能干活、能干多少活。

3. 实操全流程：腾讯云上从零搭建 dsh-market 插件市场

3.1 第一步：腾讯云服务器开出来，安全组别漏配

购买服务器的时候，地域选离你近的就行，但如果你主要调用 DeepSeek API，建议选国内地域，延迟低。我选的是广州。系统镜像选 Ubuntu 22.04 LTS，其他的保持默认。

服务器开起来以后，最重要的一件事就是配置防火墙和安全组。腾讯云的轻量应用服务器在控制台“防火墙”页面配置，CVM 则在“安全组”里配置。我建议至少放行 22 端口（SSH）和 8080 端口（后面 Harness Web 界面要用）。如果你打算把插件市场开放给团队其他人用，还要把你规划好的服务端口也放行。

注意：腾讯云服务器有双重网络限制，一个是轻量/CVM 控制台的防火墙，一个是系统内部的 ufw 或 iptables。别只开放了云控制台，忘记关系统防火墙，或者反过来只关了系统防火墙却忘了控制台规则，都会让端口不通。

确认端口放行后，用 SSH 登录服务器：

ssh root@你的服务器IP

登录成功之后，先做两件基础操作：更新系统包、创建非 root 用户（如果你习惯用 root 也问题不大，但我个人建议日常操作还是建一个普通用户，避免误操作）。

apt update && apt upgrade -y adduser dshuser usermod -aG sudo dshuser

新建用户之后，我通常会顺手开启 SSH 密钥登录。用ssh-keygen生成密钥对，然后把公钥追加到服务器的~/.ssh/authorized_keys里，之后每次登录就不用再输密码了。

3.2 第二步：基础环境——Python、Node.js、Git 一次到位

DeepSeek Harness 对运行环境有要求，目前官方推荐 Python 3.10 以上和 Node.js 18 以上。腾讯云默认的 Ubuntu 22.04 自带 Python 3.10，这就省事了，我们只需要确认一下，再补装 pip 和 venv。

python3 --version apt install -y python3-pip python3-venv git

Git 是必须的，因为插件市场仓库和很多插件的源码都托管在 Git 仓库里，而且后面你可能要自己拉取插件项目做修改，Git 版本不能太低。Ubuntu 22.04 自带的 Git 版本是 2.34，完全够用。

Node.js 的安装稍微注意下，Ubuntu 的 apt 源里版本往往偏旧，我建议用 NodeSource 源，或者在腾讯云的软件源里选一个国内镜像节点，速度会快很多。安装命令如下：

curl -fsSL https://deb.nodesource.com/setup_20.x | bash - apt install -y nodejs node --version npm --version

如果你打算用 Jupyter 类型的插件，可能还需要装 miniconda。这个我是在后边发现确实需要时才装上的，这里先不展开，避免一开始就被环境折腾劝退。

3.3 第三步：安装 DeepSeek Harness

到了核心环节。DeepSeek Harness 的安装方式主要有两种：官方安装脚本和 pip 安装。我用的是官方 Releases 里的 dsh 二进制版本，当时最新稳定版是 v0.1.5-rc.2，后来我又特意研究过怎么固定版本、怎么回退，这些细节后面讲。

先说最直接的 pip 安装方式。创建一个虚拟环境，避免把系统 Python 环境搞乱：

python3 -m venv ~/dsh-env source ~/dsh-env/bin/activate pip install --upgrade pip pip install deepseek-harness

如果你发现 pip 默认源下载很慢，可以临时换成腾讯云内部的 pip 镜像源：

pip install deepseek-harness -i https://mirrors.cloud.tencent.com/pypi/simple

官方脚本方式适合不想折腾虚拟环境的场景，执行一条命令：

curl -fsSL https://dsh.run/install.sh | bash

安装脚本会自动检测系统架构、下载对应的 dsh 二进制文件并加入 PATH。我强烈建议安装完以后执行一次dsh version确认版本信息，如果提示找不到命令，多半是 PATH 没有刷新，执行source ~/.bashrc或者重新登录 SSH 就行。

3.4 第四步：初始化配置，连上 DeepSeek 模型

安装好以后，先初始化工作目录：

dsh init

这个命令会在当前用户目录下生成~/.dsh/配置目录，里面包括主配置文件config.yaml和插件目录。然后我们需要把 DeepSeek 的 API Key 写进配置里。我建议不要直接改配置文件，而是用官方提供的命令式配置：

dsh config set api_base https://api.deepseek.com/v1 dsh config set api_key sk-你的APIKey dsh config set model deepseek-chat

这里有个非常容易踩的坑：DeepSeek 的 API Key 有时候会带有前导或者尾部空格，如果你是从网页控制台复制到终端里的，一定要注意看有没有多一个空格。我一开始就是因为这个空格，请求一直报 401 认证错误，排查了很久。

如果你想用本地模型而不是 DeepSeek 官方 API，也可以在这里把 api_base 改成你本地部署的 OpenAI 兼容地址，比如：

dsh config set api_base http://127.0.0.1:11434/v1 dsh config set model deepseek-r1:7b

这是通过 Ollama 暴露的兼容端点来连本地模型的，DeepSeek Harness 的配置层支持 OpenAI 兼容接口，所以很多本地推理服务都能直接对接。配置完成后，跑一条简单的命令验证连通性：

dsh run "用一句话介绍你自己"

如果正常回复，说明模型连接已经打通，接下来可以进入插件市场的配置了。

3.5 第五步：挂载 dsh-market 插件市场

配置 dsh-market 是这个教程的重点。先查看当前已经挂载了哪些市场：

dsh market list

默认情况下，DeepSeek Harness 会自带一个官方市场，名字一般叫official。你可以继续添加 dsh-market 社区市场地址。如果你用的是官方二进制的 GitHub 发布版，可以在 Releases 页面找到市场配置入口；如果是 pip 版本，则可以通过以下命令手动添加：

dsh market add dsh-market https://dsh-market.deepseek.com/registry/index.json

也可以用我们前面提到的注册表思路，把市场地址换成任意的 HTTP 服务。比如你想把插件目录部署在内网，只需要在任意一台服务器上放一个 index.json 文件，然后启动静态文件服务，再执行dsh market add指向它就行。

添加成功后，更新本地市场索引：

dsh market update

这个命令会拉取所有已挂载市场的插件列表，输出结果里会显示每个市场的插件数量。如果这一步失败，八成是网络连接问题，解决办法我在排查章节里说明。

3.6 第六步：装一个插件，验证全链路

市场挂载好以后，搜索你想要的插件。以社区里讨论比较多的 codex 插件为例（这个插件能帮你对接 Codex 风格的任务调度能力）：

dsh plugin search codex

搜索结果会显示插件名、版本、简介。确认找到后直接安装：

dsh plugin install codex

安装完成后，执行：

dsh plugin list

如果能看到 codex 以及它的状态显示为 enabled，说明整个链路已经通了。这时候你就可以在 Harness 里调用这个插件的能力了，比如：

dsh run --plugin codex "帮我规划一个项目的目录结构"

如果你想把插件市场做成团队内部共享的服务，还需要让 Harness 的 Web 界面跑起来。默认使用 8080 端口：

dsh serve --host 0.0.0.0 --port 8080

加上--host 0.0.0.0是为了监听所有网卡，这样你在本地浏览器输入http://服务器IP:8080就能访问。这里记得回到腾讯云控制台，确认 8080 端口已经在防火墙/安全组中放行，否则网页一定打不开。

4. 常见问题与排查技巧实录

4.1 问题速查表

我把自己实际操作中遇到过的、以及帮朋友排查时遇到的问题整理成了一张表，按出现频率排序，你可以直接对照着查。

4.2 几个我反复确认过才弄明白的坑

第一个坑是插件市场的 index.json 缓存机制。Harness 会把市场索引缓存到本地，你在服务器上改了注册表内容，但调用方还是拿旧缓存，看起来就像“更新没生效”。解决办法是执行dsh market update --force强制刷新，或者干脆把本地缓存目录删掉让它重新拉取。我第一次改完市场配置后死活看不到新插件，就是这个原因。

第二个坑是启动服务的会话问题。如果你直接在 SSH 终端里运行dsh serve，关掉终端服务就停了。网上很多教程没提这件事，我一开始也被坑过——第二天起来发现 Web 界面打不开，排查半天才发现是 SSH 会话断开了。正确做法是把dsh serve做成 systemd 服务，让它常驻后台：

sudo vim /etc/systemd/system/dsh.service

写入以下内容：

[Unit] Description=DeepSeek Harness Service After=network.target [Service] User=dshuser WorkingDirectory=/home/dshuser ExecStart=/home/dshuser/dsh-env/bin/dsh serve --host 0.0.0.0 --port 8080 Restart=always RestartSec=5 [Install] WantedBy=multi-user.target

然后执行：

sudo systemctl daemon-reload sudo systemctl enable dsh sudo systemctl start dsh

这样就算服务器重启了，服务也会自动拉起来。

第三个坑和自定义插件打包有关。网上很多人问我怎么把自研插件打包进 dsh-market，其实流程不复杂。插件本质是一个符合规范的文件夹，包含plugin.yaml描述文件和若干个代码文件。标准的目录结构类似这样：

my-plugin/ plugin.yaml main.py assets/

其中 plugin.yaml 里至少要有 name、version、entry 三个字段，entry 指向插件入口文件。打包时用 Harness 自带的打包命令：

dsh plugin pack ./my-plugin -o my-plugin.dshp

得到 .dshp 文件后，你可以把它发布到一个 HTTP 目录，然后在市场注册表的 packages 字段里加一条指向这个文件的记录。这个流程我建议所有想深度使用 Harness 的人都要掌握，因为只有插件市场里有自己的插件，你才能真正按照自己的业务场景来定制智能体能力。

第四个坑是配置本地模型时的连接问题。如果你把 api_base 指向本机的 Ollama 或 vLLM，一定要在模型服务端确认它监听的地址。Ollama 默认只监听 127.0.0.1，Docker 容器里的 Harness 去访问就会连不上。解决方案是给 Ollama 配置OLLAMA_HOST=0.0.0.0，或者把模型服务的端口映射到宿主机。这个问题在腾讯云上尤其常见，因为很多人习惯所有服务都跑 Docker，结果容器网络和宿主机网络没打通。

4.3 插件市场搭建完成后的日常维护

插件市场搭好以后，日常维护要重点关注三件事：更新、备份、安全。

更新方面，建议每隔一两周执行一次dsh market update和dsh plugin list，看看有没有插件升级。腾讯云服务器上配置一个 cron 定时任务来拉取市场索引也可以，不过个人使用的话手动更新就够了。

备份方面，~/.dsh/目录里存放了所有配置、插件和本地缓存。我的习惯是每周用 tar 打包一次，传到腾讯云的 COS 对象存储里：

tar -czf dsh-backup-$(date +%Y%m%d).tar.gz ~/.dsh/

安全方面，如果插件市场要开放给团队使用，建议在服务器前面加一层腾讯云 API 网关或者 CLB 负载均衡，用访问密钥保护市场接口。如果只是自己用，做好 SSH 密钥登录和防火墙白名单就足够了。

最后再分享一个小技巧：如果你的插件市场是在 GitHub 仓库里维护的，腾讯云服务器拉取 GitHub 资源偶尔会超时，这时候不用反复重试，直接把仓库打包成 zip 下载到服务器，或者把仓库克隆到腾讯云的 Coding DevOps 仓库，再从那里拉取，速度快很多。这个方案比反复折腾网络省心多了。

我自己在实际操作中最深的一点感受是，DeepSeek Harness 这个框架最值钱的不是默认功能，而是它给了你把各种工具“插拔式”组合起来的能力。dsh-market 一旦跑通，你就拥有了一个可以根据任务需求随时调整工具链的智能体工作台。从最初在笔记本上折腾到最终在腾讯云稳定运行，中间踩了不少坑，但把这些坑填平之后，这套东西是真的能替你实打实干活。你如果有自己的自定义插件或者特殊的编排思路，完全可以在这套环境上继续扩展，玩法比我写出来的这些要丰富得多。