📄 一句话概括
全书三段走：先跑起来（第 2 章）、再拆开看（第 3~7 章）、最后自己动手（第 8 章收口）；95 篇里前 26 篇建模型，后 56 篇动手改。
📝 本节和前面几节的关系
导读的最后一节，交代路线图。读完它你会知道哪些章【看懂就行】、哪些章【必须打开电脑跟着做】——这决定了你要花多少时间。
一、第一段：先跑起来
第 2 章。这一章只有一个目标：让你的电脑上真的跑起一个 DSH 会话。
它会带你做四件事：准备环境、选一个工作区、配一个模型、从四套预设里挑一套。 其中【选工作区】这一步最容易出事——Agent 只能操作你选中的那个目录， 所以工作区选错，它就会对着错误的文件夹干活。
这一段别跳。新手卡在环境上的概率，远比卡在概念上高。
二、第二段：再拆开看
第 3 到第 7 章。这五章是全书的主体，从【一切皆插件】一路拆到【Agent 一轮工作】。
- 第 3 章：插件意味着什么，两个平面怎么分工。
- 第 4 章：三个扩展层次——Skill、Tool、Hook。
- 第 5 章：Cordis 怎么管插件的加载与卸载。
- 第 6 章：一轮工作里到底发生了几件事。
- 第 7 章：从 Tool Call 走到 Agent Runtime。
这一段的特点是概念和动手交替——每讲完一段结构，就跟一个能亲手改的实验。
三、第三段：最后自己动手
第 8 章收口。它的最终项目是：写出你自己的第五套 Preset。
书里给的路线是五步：先列任务与权限清单，再写配置； 把共享能力和会话级能力分开；只向模型暴露真正需要的工具； 规定输出的格式；最后用失败路径验证，而不只测正常情况。
这一章是前面所有知识的验收——做不出来，说明前面有地方只是【看过】，没有【懂】。
四、怎么读这本书
三条建议，按重要性排：
- 准备一块可以随便删的目录当工作区。DSH 是预览版，而且 Agent 真的会执行命令——不要拿正式项目给它练手。
- 概念章别跳。动手实验会大量引用【两个平面】【生命周期】【统一执行管线】这些词，跳过去会看不懂实验在验证什么。
- 每章读完做一次动手实验，哪怕只是跑一遍。这本书的知识密度不小，光读会滑过去；跑过一遍才会留下印象。
最后提醒一句：这本书讲的是一套还在快速变化的系统。 看到和书上不一样的地方，先查官方文档的当前版本，再判断。
五、动手 Demo：把全书 95 篇的分布算一遍
按目录统计每一部分的篇数，看看【建模型】和【动手改】各占多少：
plan = [("导读", 3), ("第1章", 5), ("第2章", 8), ("第3章", 10),
("第4章", 11), ("第5章", 11), ("第6章", 14), ("第7章", 16),
("第8章", 15), ("附录", 2)]
total = sum(n for _, n in plan)
build = sum(n for k, n in plan if k in ("导读", "第1章", "第2章", "第3章"))
print("全书共 %d 篇" % total)
print("先建立模型：%d 篇，占 %.0f%%" % (build, build / total * 100))
print("再动手使用：%d 篇，占 %.0f%%" % (total - build, (total - build) / total * 100))
实跑输出：
--------------------------------------------------------------------
这本书的学习路径
--------------------------------------------------------------------
本书的路径是三段：先跑起来、再拆开看、最后自己动手。
对应到章节，是这样一条线：
部分 讲什么 读完你会
--------------------------------------------------------------------------
导读 为什么现在需要 Harness 知道这本书要解决什么问题
第 1 章 Harness 的定位 分清产品和 Runtime
第 2 章 从零开始运行 DSH 把它跑起来，看到四套 Preset
第 3 章 一切皆插件意味着什么 看懂两个平面怎么分工
第 4 章 从 Skill、Tool 到 Hook 亲手改一次 Harness
第 5 章 Cordis 让插件动态组合 理解生命周期与热更新
第 6 章 Agent 一轮工作的全过程 知道一轮里有哪几步
第 7 章 从 Tool Call 到 Agent Runtime 看懂 PTC、Subagent、沙箱
第 8 章 设计自己的 Harness 写出自己的第五套 Preset
--------------------------------------------------------------------------
全书按【逐小节一篇】拆下来，是一张这样的分布：
章 篇数 位置
---------------------------------------------------
导读 3 0.1 ~ 0.3
第 1 章 5 1.1 ~ 1.5
第 2 章 8 2.1 ~ 2.6（含 2.4 下三级）
第 3 章 10 3.1 ~ 3.9（含 3.2 下三级）
第 4 章 11 4.1 ~ 4.8（三处含三级）
第 5 章 11 5.1 ~ 5.10（5.5 含三级）
第 6 章 14 6.1 ~ 6.9（6.6、6.8 含三级）
第 7 章 16 7.1 ~ 7.10（7.3、7.4 含三级）
第 8 章 15 8.1 ~ 8.9（8.2、8.3 含三级）
附录 2 术语、快速演进中的 DSH
合计 95 —
---------------------------------------------------
小算例：95 篇里，动手实验集中在第 4、5、7、8 章——
也就是【真的要在 DSH 里改点东西】的章节。
前四章（导读到第 3 章）是把模型建立起来，占 26 篇；
后四章是把它用起来，占 56 篇。
动手部分占了六成（56 篇对 39 篇），这是这本书和一般概念书最大的不同。 所以读它的节奏应该是：读一小段概念，就停下来跑一下。 如果按每天 3 篇的节奏，全书大约一个月能走完一轮。
30 秒实验
- 照着第 2 章的路径先想好：你要用哪个模型（官方密钥，还是兼容的本地模型）。
- 在硬盘上建一个空目录，名字就叫【dsh-练手】，专门留给这本书的实验用。
- 翻一下第 4、5、7、8 章的动手实验标题，挑出你最想先做的那一个。
常见误区
- 错误：先把八章读完，再统一动手。——纠正：书本身就是【先跑起来】开头的，卡在环境上比卡在概念上常见得多，早跑早发现问题。
- 错误：概念章（第 3、6 章）可以先跳过。——纠正：动手实验大量引用概念章里的词，跳过会看不懂实验在验证什么。
- 错误：拿公司正式项目当练习场。——纠正：预览版 + Agent 能执行命令，第一个工作区一定要是能随便删的空目录。
自测三问（点开对答案）
1. 全书的三段路径是什么？ —— 先跑起来（第 2 章）→ 再拆开看（第 3~7 章）→ 最后自己动手（第 8 章写出自己的 Preset）。 2. 动手实验集中在哪几章？ —— 第 4、5、7、8 章：第 4 章改 Harness，第 5 章验生命周期，第 7 章比 PTC，第 8 章写自己的 Preset。 3. 第一个工作区该用什么目录？ —— **一块可以随便删的空目录。**不要让预览版 Agent 直接面对重要项目。- ☐ 下一节（1.1 先把【产品】和【Runtime】区分开）
相关笔记
- 为什么 DSH 值得单独写一本书 —— 上一篇讲为什么学，这一篇讲怎么学
- 先把【产品】和【Runtime】区分开 —— 下一篇正式开始第 1 章
- 认识树莓派 —— 另一门【先跑起来再拆开看】的动手课
- 🐳 DeepSeek Harness · 索引