全部课程 / L5 架构层
L5-01 Harness 解剖学
学时 6h(4 次) 前置 L3-05、L3-06 性质 研究课
为什么学这门
你要做统一编排层,第一步不是设计,是看清现有 harness 里到底有哪些零件。
这门课的方法:把一个你熟悉的 harness(DSH)拆到组件级,再拿别的 harness 做对照,找出「哪些是本质组件,哪些是实现选择」。
说明:本模块是研究性质,不是知识传授性质。结论要靠你自己拆出来。下面的框架是拆解的工具,不是答案。
课时拆解
第 1 次(2h)五层拆解法
任何 harness 都可以按这五层拆:
5. 交互层 用户界面、会话管理、多轮状态
4. 编排层 任务分解、子任务调度、多 agent 协作
3. 能力层 工具集、技能、知识接入
2. 上下文层 历史管理、压缩、缓存、记忆
1. 模型层 模型选择、路由、参数、重试
拆解时对每一层问:
- 这一层的接口是什么?(上游怎么调它)
- 这一层的状态存在哪?
- 这一层的失败长什么样?怎么恢复?
动手:按五层拆 DSH,每层列出至少 3 个具体组件。
第 2 次(2h)对照拆解
选 2 个不同的 harness 做同样的拆解:
- 一个 IDE 型(如 Cursor / Copilot 类)
- 一个 CLI/agent 型(如 Claude Code 类)
关注差异点:
- 同一层,它们的选择有何不同?
- 差异是因为场景不同,还是设计偏好?
动手:三列对照表(DSH / IDE 型 / CLI 型)× 五层。
第 3 次(1.5h)本质组件 vs 实现选择
这是本课最重要的一步。把三列对照表里的每一项分类:
| 类别 | 判据 | 例子(需你自己判定) |
|---|---|---|
| 本质组件 | 去掉它,harness 就不成立 | 上下文管理、工具调用循环 |
| 实现选择 | 换个做法也能成立 | 具体的压缩算法、具体的 UI |
| 场景适配 | 只在特定场景需要 | 图形界面、代码索引 |
动手:给对照表每一项打上这三类标签。
第 4 次(0.5h)抽象出通用模型
把「本质组件」抽成一个不依赖具体实现的模型——这就是你未来架构的骨架。
动手:画一张「通用 harness 组件图」,只用本质组件,不写任何具体产品名。
核心概念清单
- 五层拆解法的每层职责
- 每层的接口、状态、失败模式
- 本质组件与实现选择的区分标准
- 不同 harness 的差异来自场景还是偏好
- 通用 harness 的最小组件集
材料
- 你自己对 DSH 的使用经验(最好的材料)
dsh-docskill(查 DSH 的实际机制)- 各 harness 的公开文档
- 不要依赖评测文章,要自己拆
验收作业
- DSH 五层拆解:每层 ≥3 个组件,含接口/状态/失败模式。
- 三方对照表:3 harness × 5 层。
- 分类表:每一项标注本质/实现/场景。
- 通用组件图:不依赖具体产品的架构图。
- 最小集论证:如果只能保留 5 个组件做一个 harness,你保留哪 5 个?为什么?
第 5 题是 L5-02 的起点。
常见卡点
| 卡点 | 真相 |
|---|---|
| 「拆不出层次」 | 从「一次用户请求经过哪些步骤」开始画时序图,层次自然浮现 |
| 「分不清本质和实现」 | 问:换一种做法,功能还在吗?在就是实现选择 |
| 「对照表太表面」 | 要拆到「它怎么做的」,不是「它有什么功能」 |