发布日期:2026-10-29

subagent_oar 是 DeepSeek AI 在 2026 年 10 月 28 日发布的 DeepSeek Harness v0.2.2-alpha.2 中新增的实验性外部子 Agent 工具。它把 Codex 与 Claude CLI 放到同一个模型可见入口下,由每次调用的 runtime 参数选择运行时;但任务仍是独立、单次执行,不继承父会话,也不能追问或恢复。本机原生 CLI 继续负责安装、认证、模型与权限,Harness 负责任务委派和结果回传。


10 月 28 日发布了什么

DeepSeek Harness v0.2.2-alpha.2 的 subagent_oar,本质上是一个可按调用选择外部运行时的任务路由器,而不是新的模型或可续接的 Agent 会话。

GitHub Release 显示,该版本于北京时间 2026 年 10 月 28 日 10:50 发布,并被标记为 prerelease。官方中文 README 同时把整个项目定义为“开发者预览”,明确未来可能出现破坏兼容性的变更。

这次新增了两个配套包:一个 OAR provider 负责启动原生运行时,一个 subagent_oar 工具负责把模型给出的别名映射到 provider。OAR 库已经内嵌,用户不必另外安装 OAR CLI,但 Codex 与 Claude Code 的原生 CLI 仍要在本机完成安装和认证。

官方文档列出的固定 OAR 注册表包含 7 个运行时 id:antigravity、claude、codex、grok、kimi、opencode 和 pi。截至 2026 年 10 月 29 日,DeepSeek Harness 的原生端到端覆盖只有 Codex 与 Claude,其余运行时不能写成同等验证完成。

一次委派是怎样走完的

一次 subagent_oar 调用会经历“提交任务、选择别名、启动原生会话、独立执行、回传结果”五个环节。

  1. 父 Agent 调用 subagent_oar,提交 runtime、description 和 prompt;cwd 为可选项。

  2. 工具把 runtime 别名解析为 Profile 中预先配置的 provider,调用时不能临时更换模型或权限参数。

  3. provider 检查本机 CLI 是否可用,再以解析后的工作目录启动一个原生会话;相对 cwd 从父 Agent 当前目录解析。

  4. 工具先返回一个外部子任务 id,任务完成后再把答复或失败通知送回父 Agent。

  5. 父会话只接收选中的根助手文本或安全失败信息,原生推理、工具事件和完整转录不会复制进来。

工具参数可以写成下面这种自包含任务。关键不是字数,而是把目标、范围、约束和交付格式一次说完整。

{
  "runtime": "codex",
  "description": "检查登录模块",
  "prompt": "检查当前仓库登录模块的错误处理,只修改测试文件,运行相关测试,并在最终答复中列出改动文件和测试结果。",
  "cwd": "./apps/web"
}

child id 只是这次外部任务的标识,不是可恢复的 DeepSeek Harness 子 Session。官方工具描述明确写明:外部 child 不接受 follow-up,后续不能用这个 id 继续对话。

和 rc.8 子代理相比,变化在入口

v0.2.2-alpha.2 改变的是 provider 的选择方式与 CLI 所有权,并没有把 one-shot 子代理升级成多轮协作会话。

维度

2026 年 8 月 rc.8

2026 年 10 月 v0.2.2-alpha.2

模型可见入口

Codex、Claude Code 各自绑定独立工具名

一个 subagent_oar,调用时选择运行时别名

CLI 来源

Profile Bundle 携带并锁定兼容版本

使用本机已安装的原生 CLI、认证与设置

工作目录

使用父会话工作区

默认继承当前目录,也可通过 cwd 指定子目录

上下文

自包含文本任务、独立上下文

仍是自包含文本任务、独立上下文

完成方式

前台结果或后台 Job

先返回子任务 id,稍后发送完成通知

续接能力

不支持恢复或续接

同样不支持追问、恢复或续接

因此,“统一调度”准确指向一个工具入口可以选择多个预配置运行时,而不是 Codex 与 Claude 共享上下文、共享账号或互相接管会话。v0.2.2-alpha.2 Release 未将 rc.8 旧 provider 标记为弃用,现阶段更适合称为“新增的实验性入口”。

想试用,先完成四项检查

截至 2026 年 10 月 29 日,npm 的 alpha 标签指向 0.2.2-alpha.2,但默认 latest 仍是 0.2.1-rc.2,next 是 0.2.1-rc.4。直接运行不带标签的安装命令,并不会自动得到这项 alpha 能力。

第一项是确认版本和 Node.js。v0.2.2-alpha.2 已把最低 Node.js 版本提高到 24.9,可以先检查当前环境:

node --version
npm view @deepseek-ai/dsh dist-tags --json

第二项是分别安装并认证原生 Codex 与 Claude Code CLI,并确保启动 DeepSeek Harness 的 Host 能在自己的执行环境中找到它们。provider 不负责安装、登录或升级原生 Agent。

如果子进程依赖 API Key 环境变量,provider 会先清理具有凭据特征的变量,必须在 provider 的 env 中显式提供;原生账户文件仍可由对应运行时读取。

第三项是在已经初始化的 alpha Profile 中声明 provider 与工具包。dsh plugin 会把后续参数转交给 Profile 的包管理器:

npx @deepseek-ai/dsh@alpha plugin --profile <name> add \
  @deepseek-ai/dsh-experimental-subagent-oar@0.2.2-alpha.2 \
  @deepseek-ai/dsh-experimental-tool-subagent-oar@0.2.2-alpha.2

第四项是在该 Profile 的 cordis.patch.yml 中加入官方示例配置。下面的权限参数来自 v0.2.2-alpha.2 tag 文档:

- insert:
    - id: experimental-subagent-oar-codex
      name: '@deepseek-ai/dsh-experimental-subagent-oar'
      config:
        runtime: codex
        providerName: oar-codex
        launchArgs:
          - -c
          - sandbox_mode="workspace-write"
    - id: experimental-subagent-oar-claude
      name: '@deepseek-ai/dsh-experimental-subagent-oar'
      config:
        runtime: claude
        providerName: oar-claude
        launchArgs:
          - --permission-mode
          - dontAsk
          - --permission-prompts
          - none
    - id: tool-subagent-oar
      name: '@deepseek-ai/dsh-experimental-tool-subagent-oar'
      config:
        providers:
          codex: oar-codex
          claude: oar-claude

启动前可用 --dump-config 检查最终组合树。这个配置属于开发者级 Profile 组合,并不是默认 Web Profile 中已经开启的一键开关。

npx @deepseek-ai/dsh@alpha --profile <name> --dump-config
npx @deepseek-ai/dsh@alpha --profile <name>

哪些任务适合交给 subagent_oar

subagent_oar 适合边界清楚、提示词可以自包含、一次执行即可交付的任务。

  • 在指定目录检查一组测试失败,并返回原因和修复建议。

  • 把两个互不依赖的实现方案分别交给 Codex 与 Claude,再由父 Agent 汇总。

  • 对单个模块做代码审查、补测试或整理迁移清单。

  • 需要使用原生 CLI 已有模型、工具和项目设置的独立任务。

它不适合需要连续追问、实时进度、结构化输出、人工审批桥接或副作用回滚的流程。需要持续协作时,应使用支持继续输入的 DSH 子 Agent 或 Agent Teams,而不是把一次性 child id 当成会话句柄。

alpha 阶段必须看清的安全边界

subagent_oar 的权限来自 provider 的固定配置和原生 CLI,而不是每次调用临时选择。官方文档明确说明,两条原生路径都不会把审批请求转发到 DeepSeek Harness 交互界面。

Claude 需要支持 --permission-prompts none 的 CLI 版本;如果运行时仍等待输入,任务可能挂起,只能取消或依赖 timeoutMs。Codex 路径由 OAR 设为 never 审批策略,示例同时限制在 workspace-write 沙箱。

取消也不等于回滚。官方限制清单写明,取消前原生 CLI 已完成的文件改动会保留;原生运行时还可能保存自己的转录记录。敏感仓库应使用最小权限、专用环境和可恢复的版本控制状态。

DeepSeek Harness 的安全说明进一步指出,该项目尚未接受安全审计,不得视为安全或可用于生产环境的软件。对 v0.2.2-alpha.2,更合理的定位是开发环境验证,而不是直接替换现有生产流程。

这次更新的实际意义

subagent_oar 把“每个 provider 一个静态工具”收敛成“一个工具按任务选择运行时”,让父 Agent 更容易把独立工作分给 Codex 或 Claude。它统一的是委派入口,不是上下文、认证和权限体系。

据 DeepSeek Harness v0.2.2-alpha.2 Release 与两个 OAR 包文档,这项能力仍处于 prerelease 和 experimental 阶段。本文数据截至 2026 年 10 月 29 日;后续如果工具进入 rc 或 stable,安装方式、运行时覆盖与安全边界都应重新核对。

参考资料

相关文章

七牛云产品