DeepSeek Harness 插件：subagent_effort 按次选择推理强度

前言¶

DeepSeek Harness（DSH）支持通过插件扩展子代理行为，但默认的 subagent / subagent_fork 工具会让子代理继承会话的 reasoningEffort 设置。当需要为单次调用指定不同的推理强度时，需要在会话级别切换配置，不够灵活。tietoumiao/dsh-subagent-effort 插件提供 subagent_effort 工具，在单次调用时为子代理设置 low / high / max 三档推理强度。

插件定位¶

这是一个 DeepSeek Harness 插件，作者为 tietoumiao。它通过注册一个实现 prepareContinuable 接口的 provider，让子代理在每次调用时可以单独指定推理强度，而无需改变父会话的配置。

核心功能¶

插件实现了一个名为 subagent_effort 的工具，接收以下参数：

prompt：必填，子代理要执行的自包含任务，不会看到父对话
effort：必填，推理强度，取值 low / high / max，会被模型的能力限制校验
model：选填，子代理使用的模型 ID，省略则继承当前会话的模型
cwd：选填，子代理的绝对工作目录，省略则继承会话的工作目录

调用是前台同步的，等待子代理完成并返回最终文本。

工作原理¶

DSH 的子代理接口通过 SubagentStartRequest.agentOptions 传递推理强度等选项。插件注册了一个 provider，实现 0.2.1 版本的本地激活契约（prepareContinuable），并声明 agentOptions: true。工具通过 ctx.subagents.startActivation 启动子代理，设置 delivery: 'caller' 让结果只通过工具返回，而不是推送到父会话的收件箱。maxDepth 设置为 parentDepth + 1，限制子代理不再进一步委托。

插件会在调用前通过 llm 服务校验模型与推理强度的组合，不支持的组合会提前报错，避免子代理启动失败。

安装与启用¶

从 DSH 配置目录（桌面应用为 %USERPROFILE%\.dsh\profiles\desktop）执行以下步骤：

在 package.json 中添加依赖：

"dependencies": {
  "dsh-subagent-effort": "file:C:/path/to/dsh-subagent-effort"
}

也可以使用 npm 或 git URL 指定发布包或远程仓库。

在 dsh.profile 配置中添加插件到 bundles 列表：

"dsh": { "profile": { "bundles": [ "...", "dsh-subagent-effort" ] } }

安装依赖并重启应用：

pnpm install

插件在应用启动时加载，安装或更新后必须重启才能生效。如果直接修改源码，file: 依赖会被复制到 node_modules，需要重新运行 pnpm install。

配置¶

插件从 bundle 行读取配置（均为可选）：

providerName：在 ctx.subagents 上注册的 provider 名称，默认 subagent-effort
toolName：模型侧可见的工具名称，默认 subagent_effort

配置示例：

- id: dsh-subagent-effort
  name: dsh-subagent-effort
  config:
    toolName: subagent_effort

使用示例¶

机械性的、确定性工作适合 low 推理强度：

subagent_effort(prompt="List the files under src/", effort="low")

需要判断但推理链不长的任务适合 high：

subagent_effort(prompt="Refactor this module and explain the risks", effort="high")

跨文件推理、源码级诊断或设计权衡适合 max：

subagent_effort(prompt="Identify architectural issues across the whole project", effort="max")

适用场景与注意事项¶

需要 DSH 0.2.1 或更高版本（激活 API ctx.subagents.startActivation 是必需的）
需要 Node.js 22+（用于类型检查）
目标模型必须声明支持的推理强度列表，DeepSeek 账户提供商的 deepseek-flash 支持 low / high / max
工具仅支持前台同步调用，不支持后台/任务模式，需要后台委托请使用 DSH 的后台代理功能
已在 Windows 桌面版 DSH 0.2.1-rc.1 / 0.2.1-rc.2 上验证
插件以当前 DSH 进程权限运行，安装前应检查源码与许可证

总结¶

tietoumiao/dsh-subagent-effort 为 DSH 提供了按次选择子代理推理强度的能力，使开发者可以针对不同任务类型灵活调整计算开销。插件结构清晰，对现有 DSH 子代理生态兼容良好，适合需要在单次调用中精细控制推理强度的场景。