DeepSeek Harness(命令行里叫 dsh)是 DeepSeek 在 2026 年 8 月 13 日开源的一套 Agent 底座,按 MIT 协议免费,核心理念只有一句话:一切都是插件。模型适配器、工具、沙箱、会话存储、网页界面,全部挂在插件边界后面,下面是一颗叫 Cordis 的内核。原教程的野心不在“装一个新工具”,而是走通一条最小闭环:先读一份本地文件,再装别人的插件排版,最后自己做一个小插件,让它替你从一条热门帖子的评论里筛出值得写的选题。这一篇按原教程的 7 节重写,版本和价格按 2026 年 11 月 19 日当日核验的写。
先分清三件事:模型、Harness、工作区
动手之前先分清三件事的分工。模型负责读懂材料、决定怎么改;Harness 提供读写文件这些工具,并把每一步做了什么展示出来;工作区就是你选给它干活的那个文件夹。文件存在本机,但用在线模型分析时,参与分析的内容仍会发给模型服务,第一次练手建议用公开素材。

为什么说“一切都是插件”值得单独讲?因为常见的编码助手把权限检查、沙箱、模型接入都藏在你看不到的代码里,Harness 反过来:沙箱、工具层、连网页界面本身都是可以检查、可以替换的插件。换模型不用换工具,换沙箱不用重装整个程序。同一套代码能长出命令行、本地网页和桌面端三个形态,就是因为中间没有特权部件。
顺带说一下这个项目的体量。仓库 2026 年 8 月 13 日公开,11 月 13 日核到的数字是 28 万多 Star、3.4 万多 Fork,39 个发布全部标着 pre-release,至今没有稳定版、也没有可下载的安装包。官方 11 月 5 日公布的第一批使用数据是日活 154 万、每天约 92 万亿 Tokens,第三方插件约 3.5 万个,约六成活跃用户创建或安装过至少一个插件。官方还承诺了插件市场,以及一个叫 Creator Mode 的功能:一句话描述想要的插件,Harness 自己把它写出来、打包、装好。
但有一句丑话要先说:它至今仍是开发者预览版,README 里用大写字母提醒会有不兼容的改动。最近三周已经移掉一个执行后端、改过一次会话日志格式且不向下兼容。把它当生产工具之前,先接受这一点。
安装:桌面版,或装 dsh 启动 Web 版
两种入口选一种就够,后面装插件、开会话都在所选客户端里做。
桌面版。到 DeepSeek Harness 官网选“下载桌面端”。Windows 选 64 位版本;Mac 先在苹果菜单“关于本机”里看芯片,Apple M 系列选 Apple 芯片版。装好打开 Harness,在欢迎页用自己的 DeepSeek 账号登录;已有 DeepSeek API Key 也可以选“添加 API Key”。能在新会话里选到模型,就可以继续。
Web 版(dsh)。先装 Node.js,版本要求是 24.9.0 或更高,npm 会一并装好。装完重新打开终端,逐行输入 node -v 和 npm -v,两条都能显示版本号再往下走;如果 node -v 还是旧版本,先检查刚装的 Node.js 是否已生效。
然后装 dsh。原教程写的时候最新版是 0.2.2-rc.1,到 2026 年 11 月 19 日,npm 的 latest 和 next 通道都已经到了 0.2.2-rc.5,按当日最新版装,并把版本号记下来:
npm install --global @deepseek-ai/dsh@0.2.2-rc.5 dsh --version
第一条从 npm 下载并安装官方程序,等执行完成再运行第二条,看到 0.2.2-rc.5 即说明可用。版本跑得很快,几天就换一个预发布版,所以装好之后先核对版本,看到 0.2.2-rc.5 再往下走;一旦配通了,就用上面这种带版本号的写法固定住,别让下一个预发布版在你不知情的时候换掉它。

启动 Web 界面只用一条命令:
dsh web
浏览器通常会自动打开;没有打开,就复制终端打印的完整访问地址,包括地址后面的参数。默认端口是 3080,实际以终端输出为准,界面在 http://127.0.0.1:3080。服务运行期间留着这个终端,用完按 Ctrl+C 停止,下次重新打开终端再输入 dsh web 即可。如果全局安装报目录权限错误,改用 npx @deepseek-ai/dsh@0.2.2-rc.5 web,第一次询问是否安装时输入 y 回车,以后也用这条完整命令启动。注意只输 dsh 不加子命令会报错,它会提示需要 –profile 参数。
首次打开,按欢迎页提示登录自己的 DeepSeek 账号,或添加自己的 API Key。走 API 路线时,也可以点左下角“更多 → 设置 → 模型”,填密钥并保存,会按调用消耗 API 余额。回到新会话,在输入框右下角选模型,再添加、选中自己的工作区。全新的 Web 界面还没选工作区时,输入框不可用。
界面长什么样可以先认一下:左侧导航是“新会话”“插件”“自动化任务”,设置在左下角“更多”里;左侧是工作区和会话列表,文件夹对应工作区,下面挂会话;中间会话区显示你的要求、模型回复和读写文件等执行记录;输入框上方选工作区和“标准模式”等 Agent 模式,左下角“工作区内修改”管理访问权限,右下角选模型;输入 / 调技能,输入 @ 引用文件或对话;右侧是文件查看区,点会话中的文件链接可查看内容。
费用。软件本身免费,推理要自己带 Key。它接受 DeepSeek、Anthropic、OpenAI、Bedrock、Vertex、Azure 和 OpenAI 兼容端点。用 DeepSeek 官方模型的话,V4.1 Flash 非高峰时段是每百万 Tokens 输入 0.15 美元、输出 0.60 美元,工作日高峰时段翻倍(2026 年 11 月 13 日核验的官方价目,实际以 DeepSeek 官网为准)。
第一次动手:读一份原稿,把结果写回电脑
先拿最小的一件事验证整条链路是通的。在自己“文档”里新建文件夹“选题练习”,用纯文本编辑器在里面存一份“素材.txt”,可以写自己的素材,也可以先写这两行示例:本期主题是把采访录音整理成文字;读者留言问,一段录音里普通话和粤语混着说,转完以后怎么校对。
回到 Harness,在侧栏“工作区”旁添加文件夹,选中“选题练习”;Web 版也可以从输入框上方展开工作区菜单。然后在这个工作区新开会话,选好模型。
先别粘贴原文,直接发一句:读一下素材.txt,告诉我读者具体卡在哪里,先别改文件。能答出“两种语言混着说时怎么校对”,就算读对了。接着发第二句:在同一文件夹新建“选题卡.md”,只放一个建议标题和那条读者留言的原话,不要改素材.txt。如果弹出写入确认,核对文件名再允许。
最后打开电脑上的“选题练习”核对:原来的素材.txt 应该还在,旁边多了选题卡.md。再让它只把标题改成问句,留言原话不要动,重新打开文件核对一次。这一节的要点不是标题写得多好,而是确认三件事:它读对了文件、写到了正确位置、没动不该动的东西。
先用别人的插件:把选题卡排成一页网页
不用自己写代码也能体会插件是怎么回事。打开 Harness 侧栏“插件”,点“添加插件”,在输入框填 dsh-guizang-design,点“安装”,完成后点“立即启用”。如果版本不兼容,先看作者的安装说明和支持版本。装好后侧栏会出现“歸藏设计”。
回到刚才的会话,在输入框敲 /,选 guizang-page-skill,再告诉它:把工作区里的选题卡.md 排成一页中文网页,标题放大,读者原话单独成段,不改引语,保存为“选题卡.html”。等它写完,在文件夹里双击选题卡.html 看效果。
这里要分清两个东西:安装的是一款插件,聊天框里调用的是它带来的排版技能。接下来照这个用法做自己的插件,也只需要给它一条命令。
自己做个小插件:让它知道什么样的问题值得写
插件名叫 comment-pitch,目标很小:每次拿到同一格式的评论,就按同一套标准审题,不用重新交代“别按点赞排序”“给我看原话”。
创建步骤是:打开“插件”,点“添加插件”右侧的小箭头,选“让 Agent 创建插件”;在打开的创造模式会话里选自己的工作区;把需求发给它,大意是:帮我做一个本地选题插件,给普通会话加一条 /comment-pitch 命令,并在当前用的 Harness 里安装、启用。调用时让当前模型读取工作区里的 comments.json。接下来按创造模式里的提示确认安装和启用。等它说完成,先去“已安装插件”看开关,再回到普通会话输入 /comment-pitch,能看到、能选中这条技能,才算入口做好了。如果它只回了一段开发说明,就接着说:请把刚做的插件实际安装到当前客户端,检查为什么普通会话里还看不到这条命令。
这条命令的审题标准是插件的核心,规则写死在里面,一共五条:
- 证据只认直接回复。只有带原话、链接和正确父帖 ID 的直接回复才能作证据;重复、错串、自动回复和待复核项都不用于选题。
- 先看原帖讲过什么。再找读者补出的疑问、反例或新线索,别把原帖已经讲过的东西当新选题。
- 同类问题合并,最多给三个选题。每个写清三件事:谁卡在哪里、哪句原话支撑、先做什么小实验能验证。
- 每个选题都要给结论。“优先写/先核实/放弃”三选一,并写理由。
- 结果写进文件,输入文件不动。结果写成“选题判断-原帖ID.md”存到当前工作区,保留输入文件。没有读到评论就写“材料不足”;读到了却没有值得写的问题,就如实说没有。
拿一条真帖子,把流程从头跑到尾
插件做好了,拿一条真帖子跑完整流程。分三步。

第一步:把原帖链接给自己的 Grok Bot,让它先筛一遍。挑一条和自己创作方向有关、评论里有人讨论具体用法的 X 帖子。原教程选的是一条介绍 HarnessRouter 的帖子。在自己的 Grok Bot 对话里贴上链接,再发指令,规则大意是:只看这条原帖,以及最多 30 条能核对父帖的公开直接回复。剔除有明确自动化标识、或作者明确说明由 AI 自动生成的回复;纯吹捧、广告、复述也剔除,理由记为“无新信息”;有具体自动化嫌疑但证据不足的单列待复核。别凭文风、粉丝数或正文里 @grok 判断作者身份。只保留有具体疑问、可查新线索、带条件的反例或改进建议的回复。返回一个叫 comments.json 的文件:post 写原帖 id、作者、链接、原文;coverage 写实际读到的范围;counts 分别写 reviewed、confirmed_ai、noise、pending、kept 的条数;kept 列表逐条带 id、parent_id、author、url、text 和保留理由。ID 用字符串,原话不改写。不要拿页面显示的回复总数充当已读数,不要替你起标题。
原教程实测的原始计数是:让 Grok 复核了 12 条直接回复,保留 3 条,5 条没有新信息,4 条待复核,能确认是 AI 生成的有 0 条。其中一条问计费方式的回复,因为账号粉丝少、简介提到 Agent,被放进了待复核;问题明明很具体,所以原教程后来在指令里补上了上面“别凭文风、粉丝数或正文里 @grok 判断作者身份”那句话。
第二步:把 Grok 的文件交给小插件。手动下载 Grok 发回的 comments.json;给这条帖子单独建一个文件夹,把文件放进去;回到 Harness,把这个文件夹选为工作区,新开普通会话,选好模型。输入 /comment-pitch,选中这条命令,再发一句:分析当前工作区的 comments.json,把值得写的问题和评论依据写进选题卡,不要改原文件,完成后告诉我文件名和首选题。
第三步:打开结果,回到原话验一次。这次小插件用官方 deepseek-flash 实测,执行记录显示它依次加载技能、读文件、写文件,用时约 77 秒,跑的是同版本 Harness 的命令行模式。打开工作区,能找到“选题判断-2113954302901256597.md”;换自己的帖子,文件名末尾也会换成对应的原帖 ID。
实测的首选题很有意思。卡片把一位读者的追问排在第一,他问“what’s the advantage here?”;往后读才知道,他已经在 Grok Bot 的机器上跑 Claude Code CLI,也在浏览器里用 Claude 做研究。原帖告诉他“现在能接哪些工具”,他想知道的却是“我的办法已经能用,换了能省哪一步”。原教程据此定的写作题目是:《已经能跑 Claude Code,还要不要接 HarnessRouter?》;做法是拿同一个小任务各做一次,对照多配了什么、省了什么,再下结论。另一条评论建议让重试事件带上审批 ID,那只说明有人想这样排障;没有查过实际记录,还不能把标题写成“这个工具的审批会丢”。
最后做一次反向检查:另建一个工作区,放入同格式的文件,让保留列表为空、各项计数都为 0,并注明“本次未读到回复”;同一条命令应该告诉你材料不足。原教程实测时它确实没有硬编选题。下次换一条热帖,重复本节三步就好。
给朋友用:做成一个面板
自己用,一条斜杠命令就够了;换成给朋友用,最有用的改动是把两个动作摆到眼前:先看 Grok 留下了什么,再决定要不要让模型分析。同一套流程做成“评论选题台”之后:在侧栏打开选题台,导入自己的 comments.json;上面是筛选计数,下面是入选原话;导入只做核对;点右上角“分析选题”,才会调用模型。这次从面板发起的分析约 24 秒,左边出现 1 个“优先写”和 2 个“先核实”;点另一张卡,右侧的理由、验证办法和原评论跟着换;点“导出选题卡”就能把这批判断带走。
写之前先知道的三件事
第一,版本跑得很快,固定住你测过的那一个。原教程写的时候是 0.2.2-rc.1,到 11 月 19 日 latest 和 next 都已经到了 0.2.2-rc.5,中间还经过 rc.2、rc.3。没有稳定版可以回退,唯一可靠的办法是把版本号写下来、按版本号装。README 的不兼容改动警告不是客套话,最近三周已经真实发生过。
第二,文件在本机,内容仍会发给模型。工作区文件夹在你电脑上,但分析要走在线模型,参与分析的那部分内容会发给模型服务。别拿客户名单、真实简历、公司机密练手,第一次先用公开素材。
第三,插件生态还在早期,但已经能用。第三方插件约 3.5 万个,官方插件市场还在承诺阶段,现阶段发现插件主要靠 GitHub 的 dsh-plugin 话题。装插件之前先看作者的安装说明和支持版本,不兼容就别硬装;要求安装本地代码的,先读文件清单,拒绝索要 Token 或密码的示例。
从读一份原稿开始,到筛出第一个值得写的选题,这条线跑通之后,Harness 对你来说就不再是一个“又一个编码助手”,而是一套能按你的标准重复干活的流程。换一条热帖,重复第 6 节的三步就行。
来源
- 版本核验(2026-11-19):npm registry @deepseek-ai/dsh,latest 与 next 均为 0.2.2-rc.5
- 项目背景与价格核验:IADecider《DeepSeek Harness Review 2026》,https://iadecider.com/articles/deepseek-harness-review;ComputingForGeeks《Install DeepSeek Harness (dsh) on Ubuntu & Linux》,https://computingforgeeks.com/deepseek-harness-dsh-getting-started/
- DeepSeek Harness 官方文档:https://deepseek-harness.github.io/





















-Featured-Image-300x200-1.jpg)
-Featured-Image-300x200-1.jpg)



暂无评论内容