上游仓库在 docs/glossary.md 中对每个概念保留一个规范术语。本附录压缩并改编这套词表以适配本站，为每个词条加上本站使用页面的交叉链接，并补充本站依赖但上游未定义的一小部分术语。权威出处仍是 docs/glossary.md。
能力接缝
capability-seam（能力接缝）
接缝（seam） 是一个可替换的能力（capability），含三个角色：服务定义（Service Definition）（拥有 ctx.<key> 及其词表类型的 Cordis Service——如 ShellExecutor 之类的抽象类，绝非 TypeScript interface）、一个或多个服务提供者（Service Provider），以及一个或多个注入该服务的消费者（Consumer）。packages/shell 是典型示例：dsh-shell（定义）、dsh-bash-local / dsh-bash-sandbox（提供者），以及 dsh-tool-bash（消费者）。角色通常各占独立包，但当它们属于同一关注点时一个包可持有多个角色。来源： docs/glossary.md、docs/architecture.md；另见 能力接缝。
seam roles（接缝三角色）
能力接缝的三个命名角色——服务定义、服务提供者、消费者。单独一个角色不构成接缝；新增一项能力意味着要同时设计三者。来源： 取自 docs/architecture.md；另见 能力接缝。
capability-seams.md
生成的文档（docs/capability-seams.md）用单一图页列出每个接缝与核心服务。作为三角色模式的参考索引使用。来源： docs/capability-seams.md。
Agent 作用域
agent-scope（Agent 作用域）
作用域（scope） 是逐智能体注册的单位：一项贡献（工具、提示小节、变量、限制、监听器）要么全局（对所有智能体可见），要么作用域化（恰好归属一个作用域键）。层级是扁平的：作用域注册不向下继承到子智能体；子树行为用血统（lineage）数据表达，而非作用域结构。来源： docs/glossary.md；另见 作用域。
scope key（作用域键）
作用域以其为键的不透明身份，按对象身份比较。Harness 约定：一个活跃的 Agent 即其自身作用域的键。来源： docs/glossary.md。
agent context（Agent 上下文）
agent.ctx —— 智能体的作用域化上下文。经由它的注册既作用域可见又作用域生命周期（由同一个事实驱动），其上监听器参与该智能体的按作用域过滤分发。来源： docs/glossary.md。
scope carrier（作用域载体）
按作用域过滤的分发所携带的 thisArg（由 scopeTarget 构建）；其过滤器放行未打标签的监听器再加上主题自身的监听器。无键的无主题载体只放行未打标签的监听器。来源： docs/glossary.md；另见 作用域。
scoped dispatch（作用域分发）
这条规则：关于某个智能体活动的事件以该智能体的载体分发。关于注册表本身的事件（如添加了一个工具）是注册表主题，保持不过滤。来源： docs/glossary.md；另见 作用域。
shadowing（遮蔽）
最特异者胜出的名称解析：一个作用域化的工具/小节/变量会在该作用域内单独替换其同名的全局孪生。这是 persona 与逐智能体工具变体的机制。来源： docs/glossary.md；另见 作用域。
restriction（限制）
一条作用域本地限制（tools.restrict），为单个作用域过滤全局工具集（按交集组合）；作用域本地的注册在该过滤器之后合并。被过滤掉的全局工具既不出现在提示中也拒绝执行，与一个从未存在的工具毫无区别。来源： docs/glossary.md。
setup window（设置窗口）
创建者组合智能体作用域世界的创建槽位（CreateAgentOptions.setup）——发生于作用域与 Agent 对象都已存在、但 Agent 或会话尚未发布、agent/session-start 尚未触发、或首个提示尚未组装之时。Setup 只注册；它从不驱动智能体。来源： docs/glossary.md。
lineage（血统）
作为数据承载的父子事实——parentSession、持久的 delegationDepth、运行时的 subagentDepth。血统从不影响可见性。来源： docs/glossary.md；另见 子智能体。
目标（Goal）
goal（目标）
附着于现有会话的一个持久完成目标，带修订过的 active / paused / blocked / complete 阶段与目标回合上限；blocked 保留一个策略代码与说明。目标是状态——不是调度器或独立会话；会话日志始终是其真实来源。来源： docs/glossary.md；另见 目标。
goal round（目标回合）
为当前目标接纳的一个继续循环周期。同会话驱动器把一个目标回合物化为一个目标来源的回合（turn），后者可含零个或多个步骤；同会话中无关的人类回合不消耗目标回合上限。来源： docs/glossary.md；另见 目标。
goal activation（目标激活）
继续消费者接纳另一个目标回合的进程本地权限。激活要么 armed 要么 disarmed；它刻意不进入持久回放，因此恢复与 fork 需要后续经 /goal 或模型工具的人类授权恢复变更后才可进行自动工作。来源： docs/glossary.md。
human command（人类命令）
带斜杠前缀的指令，由面向人类的适配器经 ctx.commands 解释并执行，不会成为模型消息。它区别于面向模型的工具，也区别于经 ctx.shell 的 shell 命令执行。来源： docs/glossary.md；另见 命令。
command plane（命令面）
由 UI 适配器与命令插件拥有的发现、解析、分发、取消与结果渲染。除非处理函数另行变更持久领域，命令输出是 UI 状态。来源： docs/glossary.md；另见 命令。
goal command（目标命令）
由 dsh-command-goal 贡献的 /goal 人类命令；它直接观测或变更当前目标，而目标领域拥有每个持久的、模型可见的记录。来源： docs/glossary.md；另见 目标。
循环层级
turn（回合）
会话中一次接纳输入的处理，在模型及其工具停止或终止性策略介入后结束。来源： docs/glossary.md；另见 会话 Agent 循环。
step（步骤）
一次模型请求加上其响应引起的工具执行；一个回合可含零个或多个步骤。来源： docs/glossary.md；另见 会话 Agent 循环。
round（轮）
包含一个回合的外层策略迭代，如一个目标回合或一次 fresh-agent Ralph 尝试。轮计数器属于该策略，不统计会话中的每个回合。来源： docs/glossary.md；另见 目标、工作流。
Ralph
ralph loop（Ralph 循环）
一次面向不可变目标的前台 fresh-agent 工作流运行——由工作流与子智能体原语组合而成的面向模型工具策略，不是同会话目标、agent-loop 模式、调度器或通用工作流脚本特性。来源： docs/glossary.md；另见 工作流。
ralph round（Ralph 轮）
Ralph 循环中的一次全新子会话。子会话不接收父或先前子会话的对话种子；共享工作区与一个有界的 Ralph 交接（handoff）承载跨轮状态。来源： docs/glossary.md。
ralph handoff（Ralph 交接）
从一轮继续的 Ralph 传递到下一轮的归一化有界结构化报告——状态、摘要、证据、下一步、阻塞文本。它是对共享工作区的补充而非替代其权威地位。来源： docs/glossary.md。
组合与打包（本站补充）
以下术语贯穿本站，但上游术语表未定义；定义取自 docs/architecture.md 与 packages/boot/app-boot/README.md。
profile
profile 是存储在 Harness home（$DSH_HOME/profiles/<名称>）中的具名组合：它列出所叠加的 bundle（dsh.profile.bundles）、持有其安装的树外插件，并保存用户自己的 cordis.patch.yml。web 与 headless 随附为模板。来源： docs/architecture.md、packages/boot/app-boot/README.md（Profiles）；另见 bundle。
bundle
bundle 是 Cordis 配置行及其所挂载代码的发行格式（dsh.bundle → cordis.patch.yml），因此它插入的任何内容都仍可被其上层补丁。dsh-base、dsh-web-app 与 dsh-headless 是随附的 bundle。来源： docs/architecture.md；另见 bundle。
patch（补丁）
补丁按 id 定位一行并替换其整个配置，或插入新行（按 id 的替换不做深合并——须重述未变更字段）。补丁层按序应用于空条目列表：每个 bundle，然后是 profile 的 cordis.patch.yml，再到 home 级文件，最后是任一 --patch 叠加层。来源： docs/architecture.md、packages/boot/app-boot/README.md；另见 bundle。
harness home（Harness 主目录）
存储 profile、home 级补丁、.env 与凭据的机器本地根目录；经 resolveDshHome 解析（$DSH_HOME，否则 ~/.dsh）。来源： packages/boot/app-boot/README.md、packages/util/home-paths/README.md。
developer preview（开发者预览）
DeepSeek Harness 的当前状态：产品处于开发者预览阶段、迭代迅速，预期会有破坏兼容性的变更。请以固定修订版本为权威，而非假定任何 API 稳定性。来源： README.md（Developer preview）。