术语表

按英文首字母排序。括号内为官方文档或本教程中的中文译法。

A–C

术语	解释
Agent（智能体）	能"感知 → 思考 → 行动"循环的运行时实体：持有模型、工具与持续记忆。dsh 中 agent 与 session 共享同一个 id。
agent preset（智能体预设）	往某个 agent 的 isolate 作用域里安装的插件清单，决定该会话的能力集。
append-only（追加式）	日志只增不改；修正以新事件表达，而非改写历史。
bail	分发模式/语义：监听器返回非 null/false/undefined 值即"拍板"，链条停止。serial 是它的异步版。
BlockAssembler	把增量 StreamChunk 组装成消息的算法（dsh 中唯一的规范组装算法）。
bundle	声明了 `dsh.bundle.patch` 的 npm 包，即"可安装的一层 patch"。
Context（上下文）	服务容器与插件宿主：`ctx.<key>` 取服务、`ctx.on` 挂监听、`ctx.effect` 记副作用。
capability seam（能力接缝）	可替换能力的三位一体：Service Definition + Provider + Consumer。

D–F

术语	解释
deriveMessages	从会话日志投影模型历史（纯函数）。
disposer	effect 返回的清理函数；插件卸载时按逆序执行。
dispatch mode（分发模式）	事件的派发语义：emit / parallel / serial / bail / waterfall。
effect（可逆副作用）	带清理函数的注册：监听器、服务、定时器都是 effect。
emit	同步广播模式，不等待监听者、忽略返回值。
fiber（纤维）	Cordis 中一个插件实例的生命周期载体：持有它的全部 effect 与状态。
fork	从父会话日志的平衡前缀派生子会话（subagent 的基础）。
followup	向 agent 提交一条普通消息（开新 turn）。

G–P

术语	解释
guard	工具单调守卫：任何插件都能最终拒绝，且不可被放松。
HMR（热重载）	插件卸载（逆序撤销 effect）→ 用新代码重载；patch 文件变更即触发。
inbox（收件箱）	agent 的待处理消息队列，分 next-turn 与 next-step 两个目标。
inject（依赖注入）	插件声明所需服务；服务就绪才启动，提供者卸载则级联卸载。
isolate	为某个服务创建独立作用域（agent 局部世界的机制）。
invariant（运行时断言）	守护日志自洽性的校验（如 turn/step 成对、seq 递增）。
LlmAdapter	模型提供方适配器：把 wire 协议翻译成统一词汇表。
overlay	`--patch` 传入的临时覆盖层，优先级最高。
patch	对插件行的覆盖：按 id 整行替换或 insert 新行。
persona	部署级系统提示词片段（order 0）。
profile	命名的产品组合：有序 bundle 列表 + 用户 patch 层。
provider（提供方）	模型提供方路由键（如 `deepseek-official`、`mock`），选择适配器。

S–W

术语	解释
Service（服务）	挂在 Context 上的命名能力（`ctx.llm`、`ctx.tools`…），每个服务唯一提供者。
seam	见 capability seam。
session log（会话日志）	追加式事件流，模型可见内容的唯一事实源。
steer	向最近的 step 插入 steering（中途引导）。
step（步）	一次模型请求 + 它发起的工具执行。
StreamChunk	流式增量协议：block-start / text-delta / tool-call-delta / block-end / usage / finish。
surface（有序表面）	日志中能上"对话表面"的三类事件（user/assistant/tool-result）的有序投影。
turn（轮次）	从唤醒到无待办的完整周期，含零到多个 step。
waterfall	环绕式中间件分发：调 `next()` 委托、不调即否决。
wake（唤醒）	输入到达驱动 driver 的过程。
`!!js`	patch 配置里的运行时表达式标记（挂载时求值）。