feicaiclub/deepseek-harness-whitepaper

README excerpt

DeepSeek Harness 白皮书 一切皆插件：从装上它，到看懂它，到自己扩展它 131 页 · 七部三十八章 · 全部结论回源码核对 这是什么 2026 年 8 月 13 日，DeepSeek 用 MIT 协议开源了自己的 agent harness —— dsh 。 它和市面上的同类产品最本质的差别，不在功能多少，而在一个架构主张： 整个产品没有特权核心，包括主循环在内的每一个部件，都是可以被替换或关掉的插件。 这份白皮书把它拆开讲清楚。131 页，从「harness 到底是什么」讲到「你自己写的插件怎么装进去」。 它不是官方文档的翻译，也不是 README 的扩写。 全书所有关于代码行为的判断，都以仓库源码为准；文档与代码冲突的地方，文中注明冲突并采信代码 —— 这样的地方我们找到了不止一处。 为什么值得你花时间 敢讲代价 每讲一个优点就算一次账。遥测默认端点硬编码指向哪台服务器、Web 服务端没有任何鉴权、插件与主程序同进程零隔离 —— 这些官方 README 里写了但没人翻译过来的东西，都在书里 数字全部实测 219 个包、26 条能力接缝、52 个内置工具、44 种会话事件、541 篇决策笔记 —— 每一个都能在仓库里复算，不转述二手资料 能照着做 装、配模型、用界面、接 CI、写第一个插件、打包发布 —— 命令和代码都是可执行的，不是示意 分层可读 正文写给不一定写代码的人；代码、文件路径、源码证据放在左侧页边栏。想深挖的顺着路径回仓库核对，不想看的整栏跳过 立即阅读 - 下载 PDF —— 131 页 A4，文字可搜可选，适合通读和打印 - 在线阅读网页版 —— 单文件、字体已内嵌，另存后断网也能看 想在本地起个服务： 怎么读 这本书按 读者依次会产生的问题 排，不按代码仓库的目录排。不必从头读到尾： 你是哪一种 只读这些就够 篇幅 只想用它 01 → 04 → 06–10 → 38 约 32 页 要写插件 03 → 04 → 11 → 13 → 26–35 约 36 页 要做选型 一页摘要 → 05 → 第五部代价页 → 36–38 约 23 页 时间只够读两部，就读第一部和第七部：一头告诉你它是什么，一头告诉你要不要碰。 里面有什么 部 这一部回答的问题 章 一 · 认识它 这东西到底是什么，值不值得我花时间 01–05 二 · 装上它，用起来 怎么在我自己的机器上跑起来、配上模型 06–10 三 · 它由什么组成 我看到的这两百多个包，是按什么分的 11–14 四 · 走完它的全程 我说一句话之后，里面究竟发生了什么 15–20 五 · 它的五个特点 它跟别的 harness 的差别落在哪几处 21–25 六 · 插件 我要自己扩展它，从哪一行开始写 26–35 七 · 判断 这一轮我到底该不该用它 36–38 外加四个附录：术语…

Category