dsh-subagent-response-promoter：DeepSeek Harness 子代理响应提升插件

前言¶

DeepSeek Harness (DSH) 采用插件化架构，其核心依赖 Cordis。在智能体开发中，当子 Agent 的步骤激活 settled 后，它会唤醒父级。然而，如果父级当前正忙，运行时通常会将父级编写的 subagent-settled 响应放入下一个安全的 Agent 步骤中。

这会导致父级在处理普通上下文之前，先处理子代理的回调。dsh-subagent-response-promoter 插件旨在稳定地将这些响应提升到该步骤的普通上下文之前，确保父级优先处理子代理回调，而无需轮询或打断正在进行的模型或工具调用。

是什么¶

dsh-subagent-response-promoter 是一个 Host-side Cordis 插件。它由 JachinShen 维护。其核心作用是在 DeepSeek Harness 的 Agent 步骤边界，安全地提升子代理响应，并处理协调器中继的迁移。

核心功能¶

提升子代理响应：在 Agent 步骤中，将子代理响应放在普通上下文之前，确保父级优先响应子代理。
协调器中继迁移：内置 send_message 工具提交协调器中继。该插件将该中继从 next-turn 移至子代理的 next-step 收件箱，同时保留原始唤醒信号。
不中断调用：中继的 relocation 不会取消活跃的模型请求或工具调用。它仅在 Agent 到达安全步骤边界时可见。

安装与启用¶

在 DSH 配置文件中添加依赖项并捆绑插件。

{
  "dependencies": {
    "dsh-subagent-response-promoter": "github:JachinShen/dsh-subagent-response-promoter#v0.2.0"
  },
  "dsh": {
    "profile": {
      "bundles": [
        "@deepseek-ai/dsh-base",
        "dsh-subagent-response-promoter"
      ]
    }
  }
}

添加上述配置后，重新安装配置文件并重启 DSH 进程。插件的 cordis.patch.yml 会自动插入 Host 插件。

典型用法¶

插件会对 Agent 步骤进行重排。

假设一个提议的 Agent 步骤包含：

ordinary A, child response A, ordinary B, child response B

插件处理后，模型接收到的内容变为：

child response A, child response B, ordinary A, ordinary B

对于插入到 next-turn 的协调器中继，插件会将其持久化并重新插入到 next-step 中。这种迁移不会取消活跃的请求或工具调用，而是等待 Agent 到达安全的步骤边界后再生效。

适用场景与注意¶

此插件适合需要在复杂 Agent 流程中确保子代理响应优先级，且不希望打断正在进行的模型推理或工具调用的场景。

注意：
* 这是一个 Host-side Cordis 插件。
* 插件内置了 send_message 工具来提交协调器中继。
* 安装前建议检查源码与许可证（MIT）。

结尾¶

该插件通过调整响应顺序和中继路由，解决了子代理在父级忙碌时的处理延迟问题。更多实现细节与源码，请参考 GitHub 仓库。