LaplaceYoung/dsh-book-deepseek-harness

《深入理解 DeepSeek Harness：一切皆插件的 Agent 架构》

一本科普向的源码级架构拆解书：把 DeepSeek Harness（dsh）这台"一切皆插件"的机器，用咖啡馆聊天的方式讲清楚。目标读者是对 AI 编程工具有好奇心的开发者、产品经理、技术爱好者——不要求写过 agent 代码，不要求懂 TypeScript。

Topics: deepseek-harness · dsh-book · deepseek · agent-architecture

book chapters words

这本书讲什么

dsh 与其他 AI 编程工具最大的不同：一切皆插件（Cordis）、事件溯源 Session Log、可重构性（模型可见 ⟺ 已记录）、自我指涉工具、Code Mode。全书沿着这五条主线逐层拆解系统，并每章与 Claude Code 做对比，让熟悉主流工具的读者快速建立参照。

目录

全书 37 个文件：前言 + 33 章 + 3 附录，约 15.6 万中文字符，33 张图。

| 部分 | 内容 |
|---|---|
| 一 全景与基础 | 为什么"让 AI 干活"这么难、一条消息的旅程、仓库地图 |
| 二 插件基石：Cordis | 一切皆插件、事件、作用域与生命周期、配置与 profile |
| 三 核心引擎 | 事件溯源会话、agent 主循环、LLM 适配层、系统提示词 |
| 四 能力系统 | 能力缝隙、文件系统、命令执行与终端、工具管线、技能/搜索 |
| 五 安全与治理 | 沙箱、审批、设置与密钥 |
| 六 状态与持久化 | 持久化、查询/续聊/分身、上下文压缩 |
| 七 多 Agent 编排 | 子智能体、工作流、目标与接力循环 |
| 八 接口与前端 | 多前端、Python SDK、Code Mode |
| 九 工程实践 | 测试与自检、agent notes 文化、亲手写插件 |
| 十 思想与展望 | 设计哲学、与其他工具对比 |
| 附录 | 术语表、零件清单、笔记索引 |

完整目录见 SUMMARY.md。

仓库内容

dsh-boook-deepseek-harness/
├── book/                      # 全部 37 个章节源文件（Markdown）
├── 《深入理解 DeepSeek Harness》.pdf   # 成书 PDF（Chrome 排版输出）
├── outline.md                 # 完整大纲（10 部分 · 33 章 · 3 附录）
├── SUMMARY.md                 # 目录索引
├── WRITING-STYLE-v4.md        # 写作规范（科普版）
├── assets/mermaid/            # 书内插图（PNG）
└── scripts/                   # 骨架生成与引用校验脚本

事实基准

书中一切 dsh 机制描述来自官方仓库 deepseek-ai/deepseek-harness（写作基准提交 71c89e3e）。dsh 在写作期间处于封闭内测，书中涉及现状的表述均为时点表述；外部工具（Claude Code、Codex 等）只描述公开可见功能。

构建 PDF

node build/build-pdf.mjs
管线：Markdown → HTML（Mermaid 渲染）→ Chrome 打印 PDF
产出：《深入理解 DeepSeek Harness》.pdf

许可

书籍内容与代码 BSD-3-Clause；书中引用的外部工具信息仅作事实性引用。