62 lines
3.3 KiB
Markdown
62 lines
3.3 KiB
Markdown
# @deepseek-ai/dsh-subagent-fork
|
|
|
|
[English](README.md) | 中文
|
|
|
|
fork 提供方会创建一个进程内子 agent（智能体），并以父 agent 已完成的对话轮次作为初始内容。它与 spawn 共用全部运行机制；唯一的行为差异是会话初始内容。
|
|
|
|
## 初始内容边界
|
|
|
|
subagent 启动时，父 agent 当前的工具调用轮次仍未结束：其日志包含 assistant 工具调用，但尚无匹配的工具结果或 `turn/end`。直接复制这份原始日志会给子 agent 一个无效且不平衡的会话。
|
|
|
|
因此，fork 会计算截至最后一个 `turn/end` 的连续前缀。子 agent 能看到父 agent 所有已完成轮次，但看不到进行中的轮次。如果父 agent 尚未完成任何轮次，初始内容为空，子 agent 的行为与全新 spawn 相同。
|
|
|
|
初始内容只传递对话历史。子 agent 仍会获得全新的扁平注册作用域；它不继承父 agent 的工具限制或权限。
|
|
|
|
## 启动与能力
|
|
|
|
`start(request)` 将已完成轮次的初始内容传给 [`startInProcessRun`](../subagent-inprocess/README.md)，并等待子 agent 发布。共享驱动器负责取消、深度、定制、结果读取和 dispose（资源释放）。
|
|
|
|
fork 声明 `{ outputSchema: true, depthLimit: true, toolFilter: true, persona: true }`，与 spawn 相同。
|
|
|
|
## 配置
|
|
|
|
| 键 | 含义 |
|
|
|---|---|
|
|
| `providerName` | `ctx.subagents` 上的注册表名称（默认 `fork`）。 |
|
|
运行生命周期、模型继承与深度跟踪均为共享行为，见 [`dsh-subagent-spawn`](../subagent-spawn/README.md)。
|
|
|
|
## 模型体验
|
|
|
|
### 子 agent 历史与包络
|
|
|
|
#### 模型看到的内容
|
|
|
|
子 agent 先接收父 agent 平衡的已完成轮次界面前缀，再逐字接收新的任务内容。配置的 persona 会在子 agent 的全新作用域中遮蔽提示词文本；工具限制会过滤其全局协议 schema、可执行工具查找和 Code Mode SDK 绑定，但不影响独立注册的指导内容。父 agent 的工具视图与权限不会被继承。可选的结构化输出请求会添加仅属于子 agent 的契约。父 agent 当前进行中的轮次会被排除。
|
|
|
|
#### Token 影响
|
|
|
|
fork 会把保留的已完成历史复制到独立的子 agent 请求中；随后子 agent 独立累积自己的 token。persona 会改变重复提示词的成本，过滤会改变 schema 或生成 SDK 的成本，而首轮 fork 没有继承历史。
|
|
|
|
#### KV Cache 影响
|
|
|
|
在提供方和模型相同的前提下，子 agent 可以复用继承的逐字节相同前缀。persona、工具过滤、生成 SDK 或路由变化可能在继承历史之前使复用失效；后续子 agent 历史仅追加。
|
|
|
|
### 父 agent 工具结果（间接）
|
|
|
|
#### 模型看到的内容
|
|
|
|
父 agent 只通过 `dsh-tool-subagent` 接收子 agent 自身的最终输出，不接收继承的前缀或中间工作。
|
|
|
|
#### Token 影响
|
|
|
|
父 agent 输入增加一个依赖数据的最终结果，并保留到上下文压缩（compaction）为止。
|
|
|
|
#### KV Cache 影响
|
|
|
|
仅追加；新增可见内容位于可复用请求前缀之后，不会使现有 KV-cache 条目失效。
|
|
|
|
## 已知限制与延期工作
|
|
|
|
- **运行不公开 `sendMessage`/`resume`**：进程内运行不具备这些可选运行时能力。
|
|
- **初始内容是一次性快照**：子 agent 只能看到 fork 时父 agent 已完成的轮次，看不到父 agent 此后记录的任何内容；不会实时共享上下文。
|