子代理思考强度 tietoumiao/dsh-subagent-effort

dsh-subagent-effort

一个 DeepSeek Harness 插件，让你在每次调用时单独控制子代理的思考强度。

内置的 subagent / subagent_fork 工具会让子代理继承会话的 reasoningEffort。这个插件新增一个工具 —— subagent_effort(prompt, effort, cwd?, model?) —— 只对本次调用生效，用 effort = low | high | max 跑一个一次性子代理。除此之外，子代理照常接入你的预设：同一套人格、提示词分段、技能目录和工具。

subagent_effort(prompt="List the files under src/", effort="low") # mechanical work, cheap
subagent_effort(prompt="Refactor this module and explain the risks", effort="max")

为什么能这样

reasoningEffort 是子代理接缝上的按请求字段，属于一等公民，不是配置档或预设里的设置：

- SubagentStartRequest.agentOptions 声明了 provider / model / reasoning-effort / output-token 的覆盖能力，并要求服务商具备 agentOptions 能力。
- 宿主的 resolveChildAgentOptions(parent, requested, depth) 把请求的选项铺到父级路由上；显式指定的 effort 在继承和切换模型两种情况下都能保留。
- LLM 层会在发请求之前，拿模型声明的 reasoning.efforts 校验 effort，不支持的值直接拒绝（UNSUPPORTED_REASONING_EFFORT）—— 不做截断，也不静默回退。

因此插件只注册一个小服务商，实现 0.2.1 的本地激活契约（prepareContinuable），并声明 agentOptions: true。宿主负责实例化子代理、挂载父级的预设组合、应用请求的 effort。插件还会通过 llm 服务预先检查模型与 effort 的组合，组合不合法时给出可读的报错，而不是让子代理抛一个看不懂的错误。

要求

- DeepSeek Harness 0.2.1 或更新版本（激活 API ctx.subagents.startActivation 为必需项）。
- Node.js 22+（宿主自带运行时，这里只是为了跑 node --check）。
- 一个声明了 reasoning efforts 的模型。用 DeepSeek 账号服务商时，deepseek-flash 声明了 low / high / max。

安装

在你的 DSH 配置档目录下操作（桌面版是 %USERPROFILE%\.dsh\profiles\desktop）：

1. 把依赖加进 package.json：

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

发布过的 tarball 或 git URL 也一样能用（npm: / git+https: 说明符）。

2. 追加 bundle，让插件随配置档一起挂载：

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

3. 安装并重启应用：

pnpm install

插件在宿主启动时加载，安装或更新后需要重启。如果你就地修改插件源码，注意 file: 依赖会被复制进 node_modules，所以重启前要重新执行 pnpm install（或手动复制文件）。

配置

插件从 bundle 行读取设置（全部可选）：

| 选项 | 默认值 | 含义 |
| providerName | subagent-effort | 注册到 ctx.subagents 的服务商名称 |
| toolName | subagent_effort | 面向模型的工具名 |

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

工具

| 参数 | 必填 | 说明 |
| prompt | 是 | 交给子代理的独立任务。子代理看不到当前对话。 |
| effort | 是 | low \| high \| max，按模型声明的 effort 校验。 |
| model | 否 | 子代理使用的模型 id（与本会话同一服务商）。省略则继承。 |
| cwd | 否 | 子代理的绝对工作目录。省略则继承会话的目录。 |

调用是前台的：等待子代理结束，返回它的最终文本。机械、确定性的工作（执行命令、读文件、套模板）用 low；需要判断但不需要长推理链的用 high；跨文件推理、源码级诊断、设计取舍用 max。

工作原理（实现说明）

- apply() 注册一个服务商，实现 prepareContinuable，也就是宿主的本地后端。插件本身不创建子智能体；宿主负责实例化，并应用 request.agentOptions。
- 工具构造 { provider, label, signal, delivery: 'caller', request: { maxDepth, parent, prompt, agentOptions, cwd? } }，然后等待 ctx.subagents.startActivation(spec)。
- delivery: 'caller' 让宿主不往父级收件箱推送结算通知——一次性调用只有工具结果这一个投递通道。
- maxDepth 取 parentDepth + 1，所以嵌套调用方还在工作时，子代理不能再往下委派。
- 先取结果，再释放：在结果结算前就分离子代理，会取消这一轮。

已验证与未验证

在 DSH 0.2.1-rc.1 / 0.2.1-rc.2 上验证过（Windows 桌面端，2026-10-17/18）：

- 工具注册成功，并出现在工具列表中；
- subagent_effort(effort="low") 返回 completed，并带回子代理的文本；
- 子会话记录 config.reasoningEffort: "low"（effort="max" 同理）；id 分别是 48d6d4fe-…（low）和 02d17f6e-…（max）；
- 不支持的 effort 或未知模型会在委派前失败，并给出支持列表。

未验证：

- high 没有单独记录到子会话日志里（该值会被接受，走同一条校验路径）。
- 只跑过 Windows 桌面端宿主；其他 shell/宿主未测试。
- 工具只有前台模式，没有后台/任务模式（需要后台委派请用宿主自带的能力）。

许可证

MIT © 2026 tietoumiao