前言¶

在 DSH（DeepSeek Harness）里，子 Agent 派发通常不只是“发一个 prompt”。如果不同子任务需要不同模型、不同推理强度、不同工具范围，还要能复查这次派发实际生效了什么、是否通过安全检查、成本估算如何，就需要一个能显式管理派发策略的插件。

muzyLink/dsh-subagent-profile 是 DeepSeek Harness 子 Agent 派发插件：按任务为子代理选择模型、推理强度与工具范围，将常用组合保存为命名 profile 并随时复用，同时提供安全检查、成本估算与节省分析，以及完整决策台账。

这是什么¶

dsh-subagent-profile 由 muzyLink 维护，许可证为 MIT。

它围绕一个核心目标：让每次子 Agent 派发都有可复用的 profile、可检查的安全约束、可阅读的成本估算，以及可追踪的决策记录。具体来说，它把“用哪个模型、用多高推理强度、给哪些工具、是否后台运行、成本如何估算、结果如何落账”放到同一套插件能力里。

核心功能¶

下面介绍它明确提供的能力：

• 按任务为子代理选择模型、推理强度与工具范围。
• 将常用组合保存为命名 profile 并随时复用。
• 提供 dispatch 工具派发子 Agent。
• 内置 whitelist、cost、intersection、approval、budget 安全检查并记录。
• 提供成本估算与节省比较。
• 记录 request vs. effective、gates、execution、settlement 的决策台账。
• 提供 settings page 和 per-session ledger tab。
• 自安装 orchestrator agent preset。
• 工具集取 profile 与 parent 交集，并始终移除 run_code。
• 支持后台派发、实时状态、提醒中心、派发建议和子代理 header badge。

安装与启用¶

先安装插件：

dsh plugin --profile web add dsh-subagent-profile

安装后重启 dsh web，并在新会话 preset picker 中选择自安装的 orchestrator 预设。

环境要求如下：

• Node：^22.19.0 || >=24
• peerDependencies：@deepseek-ai/dsh-agent、@deepseek-ai/dsh-llm、@deepseek-ai/dsh-subagent、@deepseek-ai/dsh-tools，版本范围为 >=0.1.0-rc.6 <0.2.0，且均标记为 optional。

卸载插件会移除相关数据文件和自安装的 orchestrator preset 目录；重装或重启会重新同步 preset 并生成数据文件。

典型用法¶

1. 在 settings page 管理 profile¶

Profile 在 settings page 管理。每个 profile 包含：

• preset
• model
• reasoning effort
• tool scope
• 可选 persona

内置两个 profile：swap-standard 与 researcher。

Profile 文件位于：

~/.dsh/subagent-profiles.json

从 settings page 编辑后，配置立即生效。

2. 使用 dispatch 工具派发子 Agent¶

示例：

dispatch(
  profile: "researcher",
  prompt: "Survey the DSH plugin ecosystem and compare direct competitors",
  run_in_background: true
)

这里指定使用 researcher profile 作为派发时的模型、推理强度与工具范围组合，并把任务放到后台执行。

3. 在 per-session ledger tab 查看决策¶

每个会话都有 per-session ledger tab。它记录派发决策：

• request vs. effective
• gates
• execution
• settlement

用于复查这次子 Agent 派发实际生效的配置、执行过程与成本结算。

安全检查与限制¶

插件的默认约束如下：

• 工具集取 profile 与 parent 的交集，并始终移除 run_code。
• Delegation 不豁免 host approval；需要审批的操作会被自动拒绝。
• 非官方 preset 可以按 preset 开启，但默认关闭，每次允许都会被审计。

成本方面需要注意：

• 成本数字是估算，基于每个 model 的平均 per-dispatch 价格，而不是细粒度 per-token 计价。
• 成本估算与节省分析用于比较，不应直接当作精确计费结果。

后台派发有依赖：

• 需要 @deepseek-ai/dsh-jobs 和 @deepseek-ai/dsh-tool-jobs 已加载。
• 否则会失败，提示：dispatch: 后台派发不可用：缺少 jobs 服务。

运行模式也有差异：

• 在 Continuable mode 下，preset swap 与 reasoningEffort 会被忽略，子代理继承父会话 preset，并使用默认推理强度。
• 在 One-shot 模式下，最终工具集由 dsh 决定，插件无法读取最终受限结果。

适用场景与注意事项¶

适合这些情况：

• 你已经在 DSH 中派发子 Agent，但希望不同任务使用不同模型和推理强度。
• 你希望工具范围按任务收窄，并保留 run_code 始终被移除的默认约束。
• 你需要查看每次派发的 request、effective、gates、execution、settlement 记录。
• 你希望用 profile 管理常用组合，而不是每次手写完整配置。

安装前请注意：

• 插件以当前 dsh 进程权限运行，建议先检查源码、依赖与许可证。
• 本项目许可证为 MIT。
• 如果依赖后台派发，先确认 @deepseek-ai/dsh-jobs 与 @deepseek-ai/dsh-tool-jobs 已加载。
• 如果依赖 One-shot 或 Continuable 的最终行为，注意插件在部分模式下不能读取或覆盖最终结果。

结尾¶

dsh-subagent-profile 的价值在于把子 Agent 派发中的模型选择、推理强度、工具范围、安全检查、成本估算与决策台账放在同一套 profile 和 ledger 里管理。

GitHub 仓库

项目目录页（来自插件线索，未完全证实）