dsh-subagent-effort
DeepSeek Harness 插件：通过 subagent_effort 工具，为每次调用选择子代理的推理强度（low | high | max）。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:tietoumiao/dsh-subagent-effort#3dbe57ab220bbab94f57e89db0d67a23360f3ef2Subagent Effort 以 dsh-subagent-effort 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
A DeepSeek Harness plugin that gives you per-call control over a subagent's thinking intensity.
The stock subagent / subagent_fork tools make the child inherit the session's reasoningEffort. This plugin adds one tool — subagent_effort(prompt, effort, cwd?, model?) — that runs a one-shot child with effort = low | high | max for that call only. The child otherwise joins your preset like a stock subagent: same persona, prompt sections, skill catalog and tools.
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 is a first-class per-request field of the subagent seam, not a profile or preset setting:
SubagentStartRequest.agentOptions documents provider / model / reasoning-effort / output-token overrides and requires the provider's agentOptions capability.resolveChildAgentOptions(parent, requested, depth) spreads the requested options over the parent's route; an explicit effort survives both inheritance and a model switch.reasoning.efforts before any request and rejects unsupported values (UNSUPPORTED_REASONING_EFFORT) — no clamping, no silent fallback.The plugin therefore registers one small provider implementing the 0.2.1 local activation contract (prepareContinuable) and advertises agentOptions: true. The host materializes the child, mounts the parent's preset composition and applies the requested effort. The plugin also pre-checks the model/effort pair through the llm service so a bad combination fails with a readable message instead of an opaque child error.
ctx.subagents.startActivation is mandatory).node --check).deepseek-flash advertises low / high / max.From your DSH profile directory (for the desktop app: %USERPROFILE%\.dsh\profiles\desktop):
Add the dependency to package.json:
"dependencies": {
"dsh-subagent-effort": "file:C:/path/to/dsh-subagent-effort"
}
A published tarball or git URL works the same way (npm: / git+https: specifier).
Append the bundle so the plugin is mounted with the profile:
"dsh": { "profile": { "bundles": [ "...", "dsh-subagent-effort" ] } }
Install and restart the app:
pnpm install
Plugins are loaded at host startup — a restart is required after installing or updating. If you edit the plugin source in place, remember that a
file:dependency is copied intonode_modules, so re-runpnpm install(or copy the files) before restarting.
The plugin reads its settings from the bundle row (all optional):
| option | default | meaning |
|---|---|---|
providerName | subagent-effort | provider name registered on ctx.subagents |
toolName | subagent_effort | name of the model-facing tool |
- id: dsh-subagent-effort
name: dsh-subagent-effort
config:
toolName: subagent_effort
| parameter | required | description |
|---|---|---|
prompt | yes | Self-contained task for the child. It does not see this conversation. |
effort | yes | low | high | max, validated against the model's advertised efforts. |
model | no | Model id for the child (same provider as this session). Omit to inherit. |
cwd | no | Absolute working directory for the child. Omit to inherit the session's. |
The call is foreground: it waits for the child and returns its final text. Use low for mechanical, deterministic work (run a command, read files, apply a template), high for judgment without long reasoning chains, and max for cross-file reasoning, source-level diagnosis or design trade-offs.
apply() registers a provider implementing prepareContinuable — the host's local backend. No child agent is created by the plugin; the host materializes it and applies request.agentOptions.{ provider, label, signal, delivery: 'caller', request: { maxDepth, parent, prompt, agentOptions, cwd? } } and awaits ctx.subagents.startActivation(spec).delivery: 'caller' keeps the host from pushing a settlement notice into the parent's inbox — the tool result is the only delivery channel for a one-shot call.maxDepth is parentDepth + 1, so the child may not delegate further while a nested caller still works.Verified on DSH 0.2.1-rc.1 / 0.2.1-rc.2 (Windows desktop, 2026-10-17/18):
subagent_effort(effort="low") returns completed with the child's text;config.reasoningEffort: "low" (effort="max" likewise); the ids are 48d6d4fe-… (low) and 02d17f6e-… (max);Not verified:
high was not separately recorded in a child session log (the value is accepted and goes through the same validation path).MIT © 2026 tietoumiao