拆解DeepSeek Harness:一个命令如何生成五种产品

DSH用分层配置让一条命令衍生五种产品,四种模式只是web层内的预设。
文章从B站教程所称的“四种模式”与官方“五个Profile”的差异切入,指出二者并非矛盾,而是分属不同层级。DSH与Claude Code、Codex同属模型之外的Harness层,负责读文件、跑命令、记忆对话,甚至能通过组合包把子任务派发给后两者。五个Profile在源码中只是五个配置列表:web、headless、acp、sdk均先叠加97个条目的base底座,再叠各自一层;sdk minimal则不带base、独立成层。教程所说的标准、极简、创造、ptc四种模式位于web层内部,是管理单个会话工具与提示词的预设,与决定产品形态的Profile不在同一层。文章还通过dumpconfig和headless实测加以验证,并揭示共享底座的代价与ACP方案被否决的缘由。
DeepSeek Harness(DSH)在B站教程中常被描述为“四种模式”,但官方帮助信息却提到“五个Profile”。这并非笔误,而是理解其架构的关键切口。本文基于B站UP主的拆解视频,从代码层面还原DSH如何通过分层配置,用同一条命令衍生出五种形态的产品,并厘清模式与Profile的本质区别。
一个命令,五种产品:DSH与Claude Code、Codex同类
DSH与Claude Code、Codex是否属于同一类工具?从代码中的一处旁证可以确认:DSH有一类按需安装的官方组合包,组合包就是一层打包好、能单独安装的配置清单。清单里就包含Claude Code和Codex——装上之后,DSH能把一个子任务交给一个全新的Claude Code或Codex会话去做,运行时跟着组合包一起安装登录和设置。研究文件用本机的,能把另外两个接进来派活,至少说明它们干的是同一类活:在模型之外,负责读文件、跑命令、记住聊过什么。
上一集停在安装命令npx上,第一条命令就是它,只是不带版本号,装到的是当时的最新版。按下回车,终端打出一个本机地址,接着打开浏览器就是DSH的Web界面。

随附的五个Profile里没有终端界面,命令行的说明文档里倒有一行TUI终端界面的例子,后面注明“假设你已经装好这个Profile”。能在终端里直接用的是一个跑完就退出的headless,后面会用到它。
ACP(Agent Client Protocol) 是一种面向程序间调用的协议,用于让宿主程序(如编辑器、IDE 或自动化工作流)以标准化的方式启动 agent 会话、传递任务并接收结果。它不定义界面,只定义消息与生命周期,因此适合被其他软件“调用”而非给人直接操作。在 DSH 中,ACP Profile 仅由 5 个条目组成、配置文件 23 行,正是这种轻量协议层定位的体现。原文提到 7 月曾考虑让 ACP 兼任编辑器界面,最终否决,原因是一旦同时承担界面与自动化两种角色,就会产生两套并行演进的交互约定,维护成本翻倍。
一个命令怎么变成五种产品:Profile的叠加逻辑
帮助信息第一句说,DSH启动的是一个Profile,也就是按顺序叠起来的一层层配置,最上面压着你自己的改动,自顶向下、分而治之。拆开看,五个Profile在源码里只是五个列表,每个列表写着它叠哪几层:web、headless、sdk、acp都先叠DSH base,再叠自己那一层;只有sdk minimal不带base,自己就是一层。
以下条目数按npm上的0.2.2-rc来数,读代码时锁定的是另一个提交,比rc晚811个,个别数字两边对不上。一个条目就是配置里带id的一项,通常是一个插件。base是底座,97个条目;叠上web层,这一层自己就有119个条目,就是浏览器里那个界面。

把web抽走,换上headless的8个条目,它就变成一个跑完就退出的命令行工具;换成acp(Agent Client Protocol)的5个条目,它就变成给别的程序调用的协议服务——整个acp层的配置文件只有23行;换成sdk的18个条目,你自己的程序就能通过标准输入输出来调用它;sdk minimal单独一层,37个条目,下面不垫base,默认只有3个工具。4个Profile共用一个底座,叠不同的一层就是不同的产品,sdk minimal另起一套。
四种模式在哪:预设与Profile不在同一层
那教程里说的“四种模式”在哪?在web这一层里面。往下拆一层,web层另外带4个预设:标准、ptc、极简、创造。每个预设管的是这一个会话里agent手里拿什么工具、用什么提示词。在web层里新建会话时选模式,列出的就是这4个:标准模式写着适合大多数任务,极简模式写着适合测试和对比agent的基础表现。
回到上一层,Profile决定这一次启动的是哪种产品,预设只管一个会话,两者不在同一层。所以教程里的4种模式都在web这一层里,4种模式是预设,5个Profile是产品。开箱这种是“猫最拿手”——盖子一掀,装着什么全看得见。

预设(preset) 与 Profile 虽然都表现为“一组配置”,但作用域完全不同。Profile 在进程启动时决定加载哪些层、最终组装出哪种产品形态(Web、headless、ACP、SDK 等),一次启动只对应一个 Profile;预设则在 Web 层内部、新建会话时选择,只影响该会话中 agent 可用的工具集合与系统提示词,切换预设不需要重启进程。DSH 的四个预设——标准、ptc、极简、创造——分别面向常规任务、特定工具组合、基础能力测试与对比、以及更开放的创作场景。把两者混为一谈,就会误以为“四种模式”是四种独立产品,实际上它们只是同一产品内不同会话的配置差异。
终端验证:从Web切到Headless
回到终端,停掉web,还是同一个npx命令,后面加上profile web和dumpconfig两个参数,它什么都不启动,只把组合好的整份配置打印出来然后退出。web这一套1243行,每一段前面有一行注释标明它从哪一层来:这一段来自dsh base,那一段是被web层改过的base,往下翻到第398行是agent loop一个条目。
换一层试试:同一个dsh换成headless,给它一个任务。用官方API时,会话日志默认跟着请求上传,录这几段之前我们关掉这项上传——怎么关、为什么值得关心,第八集细讲。在一个只有5个文件的事例仓库里,让它列出顶层目录并说明用途,8秒半答案打到标准输出,思考过程打到标准错误,退出码是0。headless不读你在web设置里存的密钥,API密钥只认启动时的环境变量和.env文件。

它还能接管到把git diff的统计喂给它,让它总结改动,9秒,退出码还是0。这种用法适合脚本和CI。
三张底牌:否决、代价与自验证
第一张底牌是一个被否决的方案。7月时ACP还在给编辑器当界面,7月23号的设计笔记写着一个考虑过的做法:在web达到同等能力之前,继续把ACP当编辑器界面用。结论是不予采用,理由是这会留下两套需要演进的交互约定。从那以后,ACP只做自动化协议。
第二张底牌是共享底座的代价。headless自己只有8个条目,可组合起来base的97个条目全都带在里面,连关着的7个也在。随附的Profile里想不带base,只有另起一套的sdk minimal。
第三张底牌是你自己验证。在仓库根目录数一数headless那一层配置文件里的条目,是8个,rc和锁定的那个提交这个数一样。再看一眼打印出来的第一行:DSH Base。5个月前这个仓库才有第1个提交,名字已经叫DeepSeek广告 Harness,列出的唯一产品却叫DeepSeek Code。这个底座从哪来?下一集从这个提交讲起。没有什么复杂度是拆一层降不下来的,如果有,就再拆一层。
dumpconfig 是 DSH 提供的一个诊断参数:加上它之后命令不再启动任何服务,而是把按 Profile 顺序叠加后的完整配置逐段打印出来并退出,每段前附注释标明来源层(如来自 dsh base、被 web 层覆盖等)。它的价值在于把“分层叠加”这一抽象机制变成可肉眼核对的文本——条目数量、覆盖关系、最终生效值都一目了然。原文中 web 一套打印出 1243 行、第 398 行是 agent loop 条目,正是借助 dumpconfig 验证的。对使用者而言,这是确认某个配置究竟来自底座还是被上层改写的最直接手段,也是“自己验证”这张底牌的具体抓手。
背景补充
headless 模式指不启动任何图形或交互界面、以一次性任务为单位运行并退出的执行方式:给它一个任务,结果写入标准输出、日志与思考过程写入标准错误,进程以退出码表明成败。这种形态天然适合脚本、CI 流水线和定时任务,因为它没有会话状态、不需要人工点击,退出码即可被上层程序判断。DSH 的 headless Profile 自带 8 个条目,但仍继承 base 底座的全部 97 个条目,因此能力完整而交互为零。需要注意,headless 不读取 Web 设置中保存的密钥,API 密钥只从启动时的环境变量和 .env 文件读取,这是为了在无界面环境下保证凭据来源可复现、可审计。
相关推荐

Claude Mythos 5.2 与 Fable 5.2 错误率异常升高
Claude Mythos 5.2 和 Claude Fable 5.2 出现请求错误率异常升高,官方状态页已标记为调查中。本文梳理事件概况、对开发者的实际影响及应对建议。

ReAct运行时上下文裁剪:Claude Code为何70%就动手
深入解析ReAct运行时的上下文裁剪机制:为什么Claude Code在上下文使用约70%时就触发压缩,工具调用为何占用最多、为何必须成组丢弃,以及代码库为何不需要RAG。基于B站小福哥《分币不掏,学习AI Agent开发》第17节整理。

AI Agent vs LLM:Cursor和Claude Code如何真正工作
深入解析AI Agent与LLM的本质区别:LLM生成代码建议,Agent则通过工具调用修改文件、运行测试。以Spring Boot Bug修复为例,拆解Cursor和Claude Code的工作流、权限控制与验证机制。