《DeepSeek Harness白皮书》：从0到1拆解一切皆插件的Agent底座

一份地图，不是答案

2025 年是模型能力竞赛，比谁能写出更好的代码；2026 年进入了 Agent 工程竞赛，比谁能更好地组织模型干活。DeepSeek 在 2026 年 8 月 13 日开源了 DeepSeek Harness（简称 dsh），一份 128 页、14 章加附录的《新手百科全书》同步放出。它把"如何组织 Agent 干活"做成了开放生态，战略意图类似当年 Android 开源对手机行业的冲击。这份白皮书最大的价值，是让中文开发者第一次有了从零到一的系统性教程，此前这类内容几乎为零。

01 一切皆插件

dsh 的官方定义很干脆：一个基于 Cordis 插件容器的 Agent 运行时，核心一句话是everything is a plugin。模型接入、文件读写、终端、搜索、会话、UI 全部是插件，你按需要自由拼装。一个 profile 就是$DSH_HOME/profiles/<name>/目录，用 package.json 声明依赖、cordis.patch.yml 打补丁，启动时按"内置 bundle profile 补丁 全局补丁"顺序合成。官方原则叫Plugins, not loop changes：改行为优先挂官方钩子，别去 fork 核心。插件还有"两副面孔"的设计：host 半跑在 Node 进程里干工具和服务，client 半跑在浏览器里做 UI，一个 npm 包能同时带两半，这也是自定义界面的根基。

02 和主流 Agent 比什么

白皮书拉了一张六家能力矩阵：dsh、Claude Code、OpenAI Codex、OpenCode、Gemini CLI、Kimi CLI。dsh 的差异化很清晰：MIT 开源、模型无关（官方适配 DeepSeek V4 系）、60+ 官方插件包、支持自定义 UI（client 半）、能跑 headless 做 CI。Claude Code 和 Codex 是闭源"整车"，开箱即用；dsh 是底座加积木，定制面完全不同。白皮书还顺手点评了一圈同类：Cursor、Windsurf 深度绑定 IDE，Amp 是轻量终端形态，Devin 托管在云端，Aider 专注改代码加 git。对想深度定制、玩生态、跑自动化的开发者，dsh 是目前最开放的选择。

03 时间到底花在哪

第 6 章的实测有个反直觉结论：模型思考占约 90% 的时间，工具执行不到 1%，网络渲染约 10%。所以最该调的是推理档位，而不是工具本身。官方三档 low / high / max 对应简单批量、日常、复杂推理，Web UI 底部那行"LLM Xs / 工具 Ys"就是最快的瓶颈定位手段。多仓库场景下定位成本会反超思考，实验里曾出现 LLM 4 分钟、工具 29 分钟的情况，指明范围后一分钟就能解决。这一章还列了八个真实踩坑：rc.1 依赖断裂、插件缺 main、next() 忘 await、端口占用等，基本覆盖了新手会撞的墙。

04 MCP、子代理与工作流

第 9 章讲扩展的三条路：接外部工具走 MCP（官方有 mcp 包），并行任务用子代理，确定性流程用工作流。这三类都通过插件机制接入，和"一切皆插件"一脉相承，意味着你想接什么、怎么编排，都能在不碰核心代码的前提下完成。

05 成本工程才是真功夫

白皮书最硬核的是第 14 章成本模型：总成本约等于输出 token 乘输出价，加输入未命中乘未命中价，加输入命中乘命中价。Agent 负载输入占比高，缓存命中率是账单第一变量。实测 50 步工具链、2.4M 输入 token，97% 命中约 0.032 美元，全价约 0.53 美元，差 16 倍。把长跑任务挪到谷时（北京晚上），账单还能再减半，和命中率是乘法关系。另一个被验证的方向是"前缀瘦身"：少挂从不调用的工具，单次任务就能把前缀成本从占整场账单的 46% 压下来，因为那段前缀每次都要按未命中价付。

写在最后

dsh 现在还是 rc.6，官方明示会有破坏性变更，教程里也列了八个真实踩坑。但模型无关加一切皆插件的组合，给想自己搭 Agent 系统的人留了一块真正能改的地基。白皮书配了3 天从零到能开发插件的学习路径，动手跑一遍比看十篇软文都实在。

DeepSeek Harness白皮书.pdf