建议学习路径
第 0–3 章：先把 Agent/Harness/Cordis 彻底弄懂。第 4–15 章：顺着真实执行链读源码。第 16–17 章：写 DSH-Lite 并补齐 parity。第 18–20 章：按调用链精读与验收。
00. 从零理解 Agent 与 Harness
概念与心智模型
01. 先看全局：DSH 的顶层架构
概念与心智模型
02. 仓库地图：你应该按什么顺序读源码
概念与心智模型
03. Cordis：一切皆插件的运行时基础
概念与心智模型
04. 启动系统：Profile、Bundle、Patch 与插件树
架构与源码
05. 核心服务地图：ctx 上到底挂了什么
架构与源码
06. Session：append-only 事件日志为什么是事实源
架构与源码
07. Agent：接口、注册表、作用域与生命周期
架构与源码
08. Agent Loop：Turn / Step / Inbox 的完整执行链
架构与源码
09. System Prompt：提示词、变量与工具 schema 如何组装
架构与源码
10. Tools：注册、过滤、调度、拦截与执行流水线
架构与源码
11. LLM Seam：模型适配器、流式协议与 DeepSeek Adapter
架构与源码
12. Capability Seam：Definition / Provider / Consumer 三角色
架构与源码
13. 持久化、沙箱、文件系统、终端与可观测性
架构与源码
14. Web / Headless / CLI：同一 Harness 的不同外壳
架构与源码
15. 构建、测试、调试与源码修改方法
架构与源码
16. 实战一：从零写出可运行的 DSH-Lite
复刻实战与验收
17. 实战二：把 DSH-Lite 补到 DSH 等价架构
复刻实战与验收
18. 源码精读路线：按调用链吃透每一个细节
复刻实战与验收
19. 练习、验收标准与“真的学会了”的判据
复刻实战与验收
20. 附录：术语表、事件图与源码索引
复刻实战与验收
三份实现参考页
复刻实施蓝图
从空目录到架构等价 DSH 的 package、接口、阶段与验收。
事件与生命周期参考
Turn/Step/Tool/取消的 durable 与 live 事件边界。
源码精读 Checklist
每个 package 固定读法与关键搜索断点。
配套代码
压缩包内 dsh-lite/ 是教学实现；它不是官方 DSH 的复制品，而是帮助你亲手重建核心设计的最小骨架。先跑通，再逐项补齐作用域、持久化、真实 DeepSeek adapter、profile loader 等。