AI 学位·
全部课程 / 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-doc skill(查 DSH 的实际机制)
  • 各 harness 的公开文档
  • 不要依赖评测文章,要自己拆

验收作业

  1. DSH 五层拆解:每层 ≥3 个组件,含接口/状态/失败模式。
  2. 三方对照表:3 harness × 5 层。
  3. 分类表:每一项标注本质/实现/场景。
  4. 通用组件图:不依赖具体产品的架构图。
  5. 最小集论证:如果只能保留 5 个组件做一个 harness,你保留哪 5 个?为什么?

第 5 题是 L5-02 的起点。


常见卡点

卡点 真相
「拆不出层次」 从「一次用户请求经过哪些步骤」开始画时序图,层次自然浮现
「分不清本质和实现」 问:换一种做法,功能还在吗?在就是实现选择
「对照表太表面」 要拆到「它怎么做的」,不是「它有什么功能」