dsh 术语表

提炼自上游 docs/glossary.md（每词在上游有权威定义）。按主题分组。

组合与插件

seam（capability-seam） — 可替换能力，含 Service Definition / Provider / Consumer 三角色；seam 指完整能力而非单一角色。见 architecture。
Service Definition — 拥有 ctx.<key> 与词汇类型的 Cordis Service（抽象类或具体 registry，不用 TS interface）。
profile — 存于 Harness home 的具名插件组合，列出所叠 bundle 与用户 patch。
bundle — Cordis 配置行与其 mount 代码的发行格式，插入内容保持可被上层 patch。
effect — 可逆注册；unload 时自动 unwind。“Registrations are reversible effects”。见 cordis。
fiber — 一个已加载插件实例的运行时句柄（生命周期状态 + 验证过的 config + 已注册 effects）。

scope — per-agent 注册的单位；只有两级（global / scoped），扁平，不向 subagent 继承。
scope key — scope 的不透明标识（按对象身份比较）；约定：live agent 是自身 scope 的 key。
agent context（agent.ctx） — agent 的 scoped context；经它注册同时具备 scope-visible 与 scope-lifetime。
scoped dispatch — 关于某 agent 活动的事件用该 agent 的 carrier 分发；registry-subject 事件不过滤。
shadowing — 最具体者优先：scoped 的 tool/section/variable 仅在该 scope 内替换同名 global 项（per-agent persona 机制）。
restriction — tools.restrict 按交集过滤 global 工具集；被过滤的工具从 prompt 消失且拒绝执行，与不存在无法区分。
setup window — 创建期组合 agent scoped 世界的窗口（CreateAgentOptions.setup）：只注册，不驱动。
lineage — 以数据携带的 parent/child 事实（parentSession、delegationDepth），永远不影响可见性。

turn — 一次被接纳输入在 session 中的排空；模型与工具停止或终止策略介入后结束。
step — 一次 model request 加其响应引发的工具执行；turn 含零或多个 step。
round — 包含一个 turn 的外层策略迭代（goal round、Ralph attempt），计数器属于该策略。
waterfall 事件 — listener 必须调用 next() 才能委派的链式事件；不调即 veto。
session event — append-only log 中的持久事实；“model-visible means logged”。见 session-model。
human command — 斜杠前缀指令，经 ctx.commands 由人类侧适配器执行，不成为 model message。
command plane — 命令的发现/解析/分发/取消/渲染，属 UI 适配器与命令插件。

goal — 附着于既有 session 的持久完成目标，带 active/paused/blocked/complete 修订状态与 round 上限；是状态而非调度器，session log 是唯一真相源。
goal round — 当前 goal 被接纳的一次 continuation 循环，物化为一个 goal-sourced turn；无关人类 turn 不消耗上限。
goal activation — 进程本地的许可（armed/disarmed），刻意不进持久 replay——resume/fork 后需人工授权才能继续自动工作。
Ralph loop — 面向不可变目标的前台 fresh-agent workflow run，组合自 workflow 与 subagent 原语。
Ralph round — 一个全新 child session，不继承父/前轮对话种子，靠共享 workspace 与 handoff 传状态。
Ralph handoff — 轮间传递的规范化有界结构化报告（status/summary/evidence/next steps/blocker），补充而非取代 workspace 权威。

typert — 跨 host/client 的类型图机制（generator/loader/registry/protocol），支撑 Web 前端类型安全 RPC。见 engineering。
Activation — continuable subagent 的进程内驻留期（重建的子 Agent）。见 orchestration。
surface — session log 中产生 LLM message 的有序事件序列（仅 user/message、assistant/message、tool/result）。见 session-model。
spill — 超大工具结果的落盘引用机制（branded locator + retrievalHint）。见 context-management。