# 领域词汇表

## 子 Agent 定义（Subagent Definition）

用户创建并可重复使用的专业子 Agent 描述。它拥有稳定的隐藏身份，以及用户可见的名称、用途描述、系统 Prompt、模型选择、上下文来源、工具令牌、可用模式和启用状态。它是配置，不是正在运行的 Agent。

## 子 Agent 实例（Subagent Instance）

父 Agent 针对一次具体委派任务，依据某个子 Agent 定义创建出来的子 Agent。它拥有自己的 DSH Session 和生命周期。编辑或删除来源定义不会改变已经创建的实例。

## 定义目录（Definition Catalog）

保存的全部子 Agent 定义的集合，可供新的或已经存在的父 Session 使用。父 Agent 根据目录中的名称和用途描述选择专业角色。禁用定义仍留在目录和设置页中，但不进入 `delegate_agent` 的可用目录。

## 委派（Delegation）

父 Agent 选择一个子 Agent 定义，创建对应实例，并向其交付具体任务的一次请求。

## 上下文来源（Context Source）

子 Agent 实例使用全新对话，或继承父 Agent 已完成轮次的选择。父 Agent 当前尚未结束的轮次永远不会被继承。

## 工具令牌（Tool Token）

定义上存储、并在编辑器自定义网格中勾选的原始 DSH 工具名。当前词汇表为：`read`、`glob`、`grep`、`write`、`edit`、`shell`、`web_search`、`skill`。`shell` 是平台自适应项，委派时在 Host 上解析为 `bash`（Linux/macOS）或 `pwsh`（Windows）。

自定义网格不包含子 Agent 创建与控制工具。令牌解析是限制性的全有或全无：解析出的原始工具必须全部存在于父会话可见面，否则该定义对该会话不可用；绝不授予父会话没有的工具。

旧能力词汇在加载时确定展开为上述令牌（例如「搜索文件」→ `glob`、`grep`）。`create_subagents` 与已退役的 `agent_control` 令牌在解码时丢弃，不写入定义。

## 工具继承（Tool Inheritance）

定义可选择继承父 Agent 当前可见的常规工具，或改用自定义令牌集合。两种模式互斥。继承时排除创建与控制类工具（`subagent`、`subagent_fork`、`list_agents`、`send_message`、`interrupt_agent`、`delegate_agent`）。

## 嵌套委派策略（Nested Delegation Policy）

列表页上独立于任何单个定义的全局开关「禁止嵌套委派」。开启后，深度大于 0 的子 Agent 不得调用创建类工具（`subagent`、`subagent_fork`），无论由自定义委派还是原生工具创建；根 Agent 不受影响。这是套娃治理的唯一产品控制点，不按定义单独授权。控制类工具（`list_agents`、`send_message`、`interrupt_agent`）不在拦截范围内。

## 父模型（Parent Model）

发起委派的父 Agent 当前使用的模型路由。选择“使用父模型”的子 Agent 定义会在创建实例时继承该路由。

## 预置子 Agent（Preset Subagent）

插件内置、首次启动自动播种的子 Agent 定义，当前仅 Explorer（只读探索，`read`/`glob`/`grep`）。定义携带持久化标记 `presetId`，只承认已知值。预置可编辑、可停用、可复制，但不可删除：Host 目录 replace 是权威防线（现存预置缺失即拒绝），客户端隐藏删除入口。播种幂等且只追加：已存在的预置（含用户改动与停用状态）不覆盖，与用户定义同名时让位；预置内容升级不推送。

## DSH 未文档化接缝依赖（0.1.1-rc.2）

本插件依赖 `@deepseek-ai/dsh-subagent` 与 `@deepseek-ai/dsh-agent` 中部分未进入
稳定文档面的导出。rc 版本升级时逐项核对，任一签名变化都会在委派路径上立即暴露：

- `delegationDepthOf(agent)`（dsh-subagent/depth）：读取 session header
  `delegationDepth` 与运行时 `AgentOptions.subagentDepth` 的较大值；运行时字段
  非负安全整数校验失败会抛 TypeError。Host 统一嵌套策略的资格判定依赖它。
- `childSessionMeta`、`resolveChildAgentOptions`、`resolveChildDepth`：
  `mode-provider.js` 组装子会话元数据与深度时使用，是 custom provider 与原生
  spawn/fork 行为对齐的关键。
- `captureDelegatedPolicyOverrides` / `appendDelegatedPolicyOverrides`：
  自定义 provider 透传父会话委派策略覆盖的未文档化接缝。
- `assertSubagentMaxDepth`、`finalAssistantOutput`、`foldConsumedWork`：
  深度预算校验与前台结果折叠，属内部 helper。
- `agent/created` / `agent/disposed` 事件载荷 `{ agent }` 与 root 监听器的
  全局可见性语义（dsh-agent 注册表）。
- `tools.restrict()` 的"仅过滤继承工具"语义与 `tools.guard()` 的首个拒绝
  单调组合（dsh-tools）：delegate 可见性/守卫实现依赖这两条。