附录 A：术语与跨项目翻译表
| 术语 | 本书使用的含义 | 容易误解的地方 |
|---|---|---|
| Harness | 围绕模型的输入、上下文、工具、状态和执行环境 | 不只是 system prompt |
| Agent | 结合模型与工具推进任务的程序对象或过程 | 不一定是独立 OS 进程 |
| Session / Thread | 可延续的工作与历史单元 | Thread 不一定指操作系统线程 |
| Turn / Step | 框架定义的轮次和步骤边界 | 四个项目不保证同名同义 |
| Message | 一项有角色与内容类型的协议数据 | 不等于屏幕的一段文字 |
| Tool Call | 有身份、名称与参数的动作请求 | 不是动作已经完成 |
| Tool Result | 与调用关联的已知结算信息 | 不证明外部状态以后不变 |
| Projection | 从事件或条目计算出的视图 | 投影不是原始事实全集 |
| Surface | DeepSeek Session 中参与有效视图的结构 | 不宜直接翻成 UI 表面 |
| Compaction | 缩短后续模型需要的历史表示 | 不等于删除所有旧日志 |
| Spill / Artifact | 把完整大结果保存为附件并返回引用 | 预览不是完整证据 |
| Approval | 对具体动作和范围的同意或决策 | 不等于操作系统限制 |
| Sandbox | 执行端实际实施的资源限制 | 路径检查不等于沙箱 |
| Capability | 在确定条件下提供的能力及其契约 | 名称存在不代表可用 |
| Hook | 在固定节点观察或干预的回调 | async 不代表一定被等待 |
| Provider | 实现某项抽象能力的提供方 | 模型和执行提供方是两条轴 |
| Idempotency | 重复执行产生与一次相同的目标效果 | 不是所有读取以外操作都天然具备 |
| Unknown Outcome | 已开始但缺少可确认结算的结果 | 不应直接当失败后重试 |
| Cancellation | 请求在合作边界停止并收尾 | 不会自动回滚已发生副作用 |
| Acceptance | 独立判断目标与约束是否满足 | 不是复述模型的成功宣言 |
一张跨项目阅读提示卡
在 Claude Code 快照中看到 QueryEngine，先问它管理哪个会话生命周期；看到 queryLoop，关注一次循环交付哪些事件。DeepSeek 中看到 Session，先找日志与 surface；看到 AgentEventDispatch，先看通知、串行还是包围执行。Pi 中看到 Agent，先区分底层运行与 coding-agent 应用；看到 convertToLlm，先问哪些应用条目被转换或忽略。Codex 中看到 TurnContext 与 StepContext，先找生命周期与快照；看到 ToolOrchestrator，先追踪审批和实际执行。
学习这些词不是为了统一所有项目的名字，而是为了在不同实现之间保持问题一致。遇到新的框架，也可以沿同样的方法建立映射。