一、最顶上的一对

• Model：只会生成 Token 的东西。
• Harness：把 Token 接成活儿的那一层。
• Agent：两者合起来的产物。

等式是 Model + Harness = Agent——三者不是同义词。

二、平面与作用域

• Host Plane（宿主平面）：进程一份（注册表／沙箱／模型路由／持久化）。
• Agent Plane（会话平面）：每会话一份（工具／人格／提示段）。
• Scope Context：能力挂在哪一级作用域上。
• isolate：把一组件圈成组内可见的格子。

判断只有一句：它该活多久。

三、装配三个词

• Preset：一套装配清单（会话平面）。
• Composition：照清单装完之后的样子。
• Patch：往树上加的一层覆盖（id 定位、可禁用、可插入）。

常见误解：把 Preset 当权限系统——它只管装配（8.4）。

四、能力与实现

• 能力：配置里的 id（ptc-runtime）。
• Provider：提供实现的那一方（包 dsh-ptc-runtime-node）。
• 使用方：装配它的组合。

三个角色分开，【换实现不换契约】才成立（1.3、8.2.1）。

五、一轮工作里的词

• Turn：用户消息到最终回复的一整轮。
• Step：一次模型推进——1 个 Turn 含 N 个 Step。
• Tool / Skill / Hook：写代码的能力／不写代码的能力／改规矩的机制。
• Pipeline（执行管线）：审批→沙箱→超时→留痕，唯一入口。

六、生命周期与证据

• Effect / Coeffect：我给出去什么／我需要什么（方向相反）。
• Fiber：一个插件实例的生命周期账本。
• Session：会话的事件事实库，不是消息数组。
• Projection：从事实派生的视图（坏了可以重算）。

最后还要分一对：回放＝同样输入重放；复现＝同样输出——回放不等于复现。

七、动手 Demo：术语速查（附录 A）

把全书最容易混的几对摆在一起：

terms = ["Model/Harness/Agent", "Host/Agent 平面",
         "Preset/Composition", "能力/Provider",
         "Turn/Step", "Effect/Coeffect",
         "Session/Projection", "回放/复现"]
for i, t in enumerate(terms, 1):
    print("  %2d. %s" % (i, t))
print("  查术语先问属于哪一层, 再看它跟谁配对")

实跑输出：

--------------------------------------------------------------------
术语速查（附录 A）
--------------------------------------------------------------------
  把全书最容易混的几对摆在一起：

  术语                        一句话                        别和谁混
  ---------------------------------------------------------------------------------
  Model / Harness / Agent     模型 + Harness = Agent        三者不是同义词
  Host 平面 / Agent 平面      进程一份 / 会话一份           平面≠权限
  Preset / Composition        一套装配清单 / 装完的样子     预设不是权限
  能力 / Provider             id 与它的实现                 换实现不换能力名
  Turn / Step                 一整轮 / 一次模型推进         1 个 Turn 含 N 个 Step
  Effect / Coeffect           我给什么 / 我要什么           方向相反
  Session / Projection        事实库 / 派生视图             视图坏了能重算
  回放 / 复现                 同样输入 / 同样输出           回放≠复现
  ---------------------------------------------------------------------------------

  查术语的正确姿势：**先问它属于哪一层**，再看它跟谁配对。

术语总是成对或成组出现的——单独背一个词，用起来一定错。 查术语的正确姿势：先问它属于哪一层，再看它跟谁配对。 最常被混的一对是 回放／复现——输入一样不等于输出一样。

30 秒实验

1. 合上书，默写【宿主／会话】两个平面各放什么。
2. 给 Preset、Composition、Patch 各写一句自己的话。
3. 找一对你以前混着用的术语，写清它们的区别。

常见误区

1. 错误：术语是背的。——纠正：术语是分层的——先问它在哪一层，再看它跟谁配对，比死记快得多。
2. 错误：Preset 和权限是一回事。——纠正：一个管装配、一个管范围（8.4）——这是本课最容易翻车的一对。
3. 错误：回放成功就说明复现成功。——纠正：回放是同样输入，复现是同样输出——采样有随机、模型在更新，重放十次可能有十种输出（6.8.2）。

• ☐ 下一节（附录 B 快速演进中的DSH——版本更新、视觉模型与插件生态）

相关笔记

• 快速演进中的DSH——版本更新、视觉模型与插件生态 —— 术语之后，交代【它还在变】
• Scope Context：会话级能力从哪里来 —— 两个平面的出处
• 能回放，不等于结果一定能复现 —— 回放与复现的分野
• 🐳 DeepSeek Harness · 索引