dsh-subagent-pro

使用

监控面板

插件装载后，会话输入区左侧出现 HUD 风格图标按钮：

• 静态显示：线性 SVG 子代理树状图标；
• 有 running 子代理时右上角显示橙色角标（数量）；
• 点击打开 / 关闭浮层面板（默认桌面自动开，手机端 ≤ 768px 默认关）；
• 面板可拖动、可调高、可收起 / 关闭 / 隐藏行 / 清空已完成 / 打开子会话。

角色委派（settings 角色）

在 DSH 设置面板的 Subagent Pro 分组下：

1. 填写 defaultProvider / defaultModel（可选），所有未显式指定的子代理应用该模型；
2. 点击「+ 新增角色」增加自定义角色，填写 displayName / description / persona / provider / model / tools；
3. 主代理会自动看到角色清单（系统提示注入），并委派：

subagent_role({ role: "code-reviewer", prompt: "审查 src/foo.ts" })
subagent_role({ role: "code-reviewer", model: "deepseek-chat", prompt: "..." })

角色委派（agent md 角色）

在 ~/.dsh/agents/ 或 /.dsh/agents/ 写一个 md 文件（详见下一节）；主代理会自动加载并把 persona 注入到子代理的 system prompt。

查询可用模型（subagent_providers）

主代理可随时调用 subagent_providers 查询当前 host llm 服务暴露的 provider / model / reasoning-effort 列表，无需重启或查看配置文件：

subagent_providers({ action: "list_providers" })
// -> { kind: "providers", providers: [{ id: "minimax-cn", name: "minimax-cn" }, ...] }

subagent_providers({ action: "list_models", provider: "opencode-go" })
// -> { kind: "models", provider: "opencode-go", models: [{ id: "deepseek-v4-flash", ... }] }

subagent_providers({ action: "list_reasoning_efforts", provider: "opencode-go", model: "deepseek-v4-flash" })
// -> { kind: "reasoning", efforts: [...], defaultEffort: "low" }

数据源与设置面板的下拉（/api/dsh-subagent-pro/llm/*）完全一致。如果 llm 服务不可用，工具返回空数组而不是抛错。