AI 简明手册
DeepSeek Harness 源码解读 · 编排与子 Agent子 Agent 为什么要做成可替换接缝

专题篇章 · 编排与子 Agent源码解读

子 Agent 为什么要做成可替换接缝

先看全局

DSH 子 Agent 是 provider 注册表，各实现同一接口。能力不匹配在启动前抛 UNSUPPORTED_CAPABILITY，绝不接受后静默降级。

沿地图找代码

请求带 prompt、父 Agent、取消信号及可选项

请求带 prompt、父 Agent、取消信号及可选项。启动前查静态能力表，缺项即抛错。输出统一为工具结果。fork 用已完成轮次的平衡前缀做种子，进行中轮次必须排除。

[repo]

一次性 run 等结果即结束

一次性 run 等结果即结束；可继续 Activation 是持久会话，至多一个驻留实例。后台结算时无条件投 subagent-settled 通知。codex 与 claude-code 默认 disabled，复制 preset 可开放。

[repo]

建议阅读顺序

  • Claude Code 委派时带 outputSchema 会发生什么： 能力门闩检查静态表，缺项当场抛 UNSUPPORTED_CAPABILITY，CLI 不启动。

  • 为什么选择启动前报错而非忽略 schema： 静默忽略会让父 Agent 拿非结构化结果继续处理，错误延后。启动前报错锚定发起时刻。

这张地图没覆盖什么

  • 本页结论对应 revision 0a53fb55bea101816fa226bb964ae2bed71c343b。文件位置、命名和默认行为可能随版本变化，引用实现细节时应同时记录 commit。

来源与核验

  1. [repo] DeepSeek Harness 官方源码（固定 revision）
  2. [official] DeepSeek Harness 官方介绍

Revision：0a53fb55bea101816fa226bb964ae2bed71c343b · 核验日期：2026-08-31