DEEPSEEK HARNESS中文手册

从一条命令,
到一棵插件树

dsh(DeepSeek Harness)把模型、工具、插件和你本机的工作目录接在一起运行。这本手册从安装讲到源码,每一步都能自己复核。

npx @deepseek-ai/dsh@latest web

需要 Node 与 DeepSeek API Key。启动后浏览器会打开带 token 的地址。完整步骤

启动时,dsh 在读什么

  • profile列出要用的组合包
    • bundle一组配置改动
      • patch按 id 替换配置
        • loader合成运行中的服务
看插件树怎样组装
核验2026-10-31dsh0.2.1-rc.5版本差异

你属于哪种情况

第一次来就按第一条走;已经装好,直接看卡住或想深入的那条。

装完先做这三件事

顺序不重要,但三件都做完,Web UI 才算真的能用。

  1. 01

    填 API Key

    API Key 是一串用来调用 DeepSeek 模型的访问口令。打开设置 → 模型,在 DeepSeek 卡片里填入并保存;保存后的下一次请求就会用到它,不需要重启服务。见 模型配置。

  2. 02

    选工作区

    dsh 把工作区当作默认的读写位置,第一次启动后要在界面里选一次。没有选工作区时,界面上的输入框不可用。

  3. 03

    装一个插件,确认插件装上了

    profile 是 dsh 的一个配置目录,一个 profile 装一套插件。装完不显示,多半是插件装进了另一个 profile:先确认插件装进了哪个 profile,再确认 Web UI 用的是同一个。见 插件安装。

读源码:三条主线

源码文章固定到 dsh-v0.2.1-rc.5 的 commit,行号只对那份源码有效。

  1. 01插件树的组装过程profile、bundle、patch 逐层合成运行中的服务;base 组合包是共享的第一层,里面有 96 行配置。读这一篇
  2. 02一条消息怎样变成一个步骤一条消息从被领取、组装提示词、冻结请求,到流式返回和写入日志,中间会留下哪些记录。读这一篇
  3. 03一次工具调用要过哪些关卡模型要用工具时,一次调用要按顺序经过审批、各项守卫、执行和后置处理,最后冻结成一条结果;调用被拒绝也算一种结果。读这一篇

最近更新

核验方法

能在本机运行的命令,都在 Windows 11 + Node 24 的环境下执行过一次,本站把这种情况标为“实测”;本机跑不了的步骤按官方文档核对,并在页面上写明。每页头部标注核验到的 dsh 版本与核验日期,超过 30 天会显示提示条。

权威来源

当前版本:2026-10-31 核验

npm latest
0.2.1-rc.5
npm next
0.2.1-rc.5
GitHub 最新 tag
dsh-v0.2.1-rc.5

npx 默认安装 latest 标签指向的版本,而 latest 不一定是版本号最高的那个。latest 与 next 是 npm 给版本起的标签名,不是版本号本身;与 GitHub 标签的对应关系见 版本页。