中文 | English summary
插件化 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 前沿）
DeepSeek Harness Blue Book: Architecture, Extension, and Engineering Practice of a Plugin-Based Agent Runtime (Chinese edition, 48 pages) — an engineering-focused companion to DeepSeek's open-source agent harness (released Aug 13, 2026). Where most coverage answers "what happens when I install it," this book answers "how do I build on it": the runtime spine, capability seams, preset/plugin layering, sandbox boundaries, nine plugin-development pitfalls, and a fully open-source desktop-shell case study (dsh-buddy). Every number carries its retrieval command and snapshot date; every claim is labeled by evidence grade (official contract / community sample / author observation); every forecast ships with falsification criteria and a public re-review date (Sep 22 / Nov 22, 2026). Chinese only for now; the full Markdown is agent-context friendly.
本作品基于 CC BY-NC-SA 4.0 协议发布。在保留署名的前提下，可自由分享和改编（非商用）。