本书正文中代码、类型名、文件路径、专有名词一律保留英文（AgentMessage 不写成「智能体消息」）。此表给出中文解释与首次出现的章节。「首见」列由脚本扫描章节文件推导，非手写。
| 术语 | 中文解释 | 首见 |
|---|---|---|
agent loop | 「调模型 → 跑工具 → 再调模型」的循环。pi 的实现是双层 while：内层收工具与 steering，外层等 follow-up。 | 02 |
AgentMessage | pi 会话内部的消息类型，比 LLM 认的三种 role 多出 bashExecution / custom / branchSummary / compactionSummary。 | 02 |
steering | 「插话」。在 agent 跑动过程中注入的消息，在每个 turn 结束后被轮询，下一个 turn 生效。 | 03 |
follow-up | 「追加」。只在 agent 本该停下时才被轮询的消息队列；有的话就再跑一轮。 | 03 |
terminate | 工具结果上的标志，提示循环可以提前收工。判定是「全票通过」——一批里全部标了才生效。 | 03 |
convertToLlm | 把 AgentMessage[] 映射成 LLM 认的 Message[] 的必填函数。四种自定义 role 全被压成 user。 | 05 |
transformContext | 每次 LLM 调用前改写上下文的可选钩子。在 coding-agent 里等于「扩展说了算」。 | 05 |
| 术语 | 中文解释 | 首见 |
|---|---|---|
entry | 会话日志里的一条记录，带 id / seq / parentId / timestamp。树结构由 parentId 隐式构成。 | 06 |
record | v4 新增的执行痕迹（operation_started 等 9 种），供崩溃恢复用。v3 会话里没有。 | 07 |
lane | harness-v2 概念：会话树上的一个具名位置，每个 lane 同时最多跑一个操作。锚点时执行层尚未实现；v1.0.0 随 harness 一起删除。 | 03 |
session v3 / v4 | 锚点时 CLI 写 v3，新 harness 栈写 v4（含 record）；v4 能读 v3，但只能恢复到 idle。v4 栈已于 v1.0.0 删除。 | 07 |
fork | 复制会话。scope: "branch" 只复制到某 entry 的路径，scope: "tree" 复制整棵树。 | 07 |
| 术语 | 中文解释 | 首见 |
|---|---|---|
differential rendering | 只重画变化的行，而不是整屏重绘。配合终端的 synchronized output 做到无闪烁。 | 11 |