HackSing/deepseek-harness-blue-book

DeepSeek Harness 蓝皮书

插件化 Agent 运行时的架构、扩展与工程实践 · 艾维尔 著 · v260823（2026 年 8 月 23 日）

DeepSeek 在 2026 年 8 月 13 日开源了 agent harness「dsh」，官方给它的定义只有一句：Everything is a Plugin。市面上的解读大多在回答"我装上它会发生什么"。这本蓝皮书回答另一个问题：我要在它上面建东西，该怎么办。

48 页 A4，从运行时主干、capability seam、preset/plugin 分层，到沙箱边界、插件开发九坑、一个完整开源的桌面端工程案例——每个数字带取数命令与快照时间，每个判断标注证据等级，每个预测配好证伪条件和公开复核日期。

下载

| 格式 | 文件 | 大小 |
|------|------|------|
| PDF（A4 版式） | DeepSeek-Harness-Blue-Book-zh-v260823.pdf | 12MB |
| HTML（单文件，图片内联，适合手机连续阅读） | DeepSeek-Harness-Blue-Book-zh-v260823.html | 9.3MB |
| Markdown（全文，适合直接喂给你的 Agent 当上下文） | book/blue-book.md | 74KB |

💡 PDF 建议下载后阅读，GitHub 在线预览可能无法完整渲染。Markdown 版可以直接把 raw 链接丢给任何 Agent。

这本书有什么别处没有的

- 三级证据分级贯穿全书：官方契约 / 社区样本 / 作者观察，逐条标注核验 RC，不把社区数据包装成官方结论
- 附录 A 数字来源表：18 个数字，每个带取数命令、快照时间和适用限制
- 附录 B 分章版本矩阵：官方 tag 与社区样本 HEAD 分开锚定，正文结论落在哪个快照上一查便知
- 五项可证伪观察（5.4）：每项写明观察信号、证伪条件和公开复核日期——2026-09-22 与 2026-11-22 到期按日期重核并发布修订版，条件触发就改判断，不替旧结论找理由
- 插件开发九坑（3.6）：官方契约 / 逆向摸索 / 工程纪律三类来源逐条标注
- 官方 4 篇事故复盘的架构化解读：178 个测试全绿、100% 覆盖率，编辑器一连上就崩——"全绿之后，系统仍然可能是错的"
- 完整开源的桌面端工程案例（Part 4）：样本仓库 dsh-buddy 固定 HEAD 可复现，Electron 宿主边界、随包资产升级、投影缓存故障、插件热更新通道全部来自真实工程

本书结构

| 部分 | 内容 |
|------|------|
| 序 | 版本基准 · 你可以怎么读 |
| Part 1 dsh 是什么 | Agent Harness 的定义 · "开源版 Claude Code"类比的作用与失真 |
| Part 2 dsh 怎么运行 | 一轮请求的运行链路 · 会话为什么只追加 · 第一次运行与容易被忽略的 token/缓存成本 |
| Part 3 一切皆插件 | Preset 与 Plugin 分层 · Capability seam · 沙箱边界 · 两个真实案例 · 开发九坑 |
| Part 4 搭建自己的桌面端 | Electron 宿主边界 · 随包资产升级 · 投影缓存 · 插件热更新 · 钉版纪律 |
| Part 5 未来发展 | 三段 RC 的工程重心 · 官方事故复盘 · 五项可证伪观察 |
| 附录 A—D | 数字来源表 · 分章版本矩阵 · 术语对照 · 命令速查 |

适合谁读

- 插件 / preset 开发者：Part 3 是主菜，九坑每条都对应真实故障源
- 想搭桌面端或集成 dsh 的构建者：Part 4 整章是一个可复现的开源工程样本
- 评估 dsh 架构的工程决策者：Part 1/2/5 + 附录版本矩阵，判断都可以按日期重核

关于时效：这是一本"活书"

全书动态数字（star/fork、提交数、版本统计）均为 2026-08-22 快照，正文与附录 A 逐条标注取数时间。dsh 还在密集发版，本书不假装自己不会过时——5.4 的五项观察各自带公开复核日期：

- 2026-09-22：重核事件日志真源与安全声明两项观察，动态数字重取，发布修订版
- 2026-11-22：重核 seam 后端替换、真实交付路径、契约沉淀三项观察，发布修订版

条件被触发，就修改判断。修订历史见 CHANGELOG.md。

友情链接

| 项目 | 简介 | 链接 |
|------|------|------|
| dsh-buddy | 本书 Part 4 的工程样本：为 dsh 做的开源桌面端，随包运行时、资产升级与插件热更新全部开源可查 | GitHub |

关于作者

艾维尔 · dsh-buddy 作者 · 蓝皮书系列 · 只写一手实测与可复核的工程判断

- GitHub：@HackSing
- X / Twitter：@WareAi996
- 微信公众号：Agent 艾维尔
- 小红书：艾维尔（AI 前沿）

English summary
DeepSeek Harness 蓝皮书：插件式 Agent 运行时的架构、扩展与工程实践（中文版，48 页）——DeepSeek 开源 agent harness（2026 年 8 月 13 日发布）的工程向配套读物。多数报道回答的是“安装后会发生什么”，而本书回答的是“如何在其上构建”：运行时主干、能力接缝、预设/插件分层、沙箱边界、九个插件开发陷阱，以及一个完全开源的桌面外壳案例研究（dsh-buddy）。每个数字都附带其检索命令和快照日期；每项论断都按证据等级标注（官方契约 / 社区样本 / 作者观察）；每个预测都附带证伪标准和公开复审日期（2026 年 9 月 22 日 / 11 月 22 日）。目前仅提供中文；完整 Markdown 对 agent 上下文友好。

协议

本作品基于 CC BY-NC-SA 4.0 协议发布。在保留署名的前提下，可自由分享和改编（非商用）。