DSH-Maestro5

---

这是什么

DSH Maestro5 是一个 DeepSeek Harness（DSH）Web 插件。装上之后，新任务里会多出一个 「团队主控」 模式：

• 你说一句任务，主控先拆解，再决定「哪些自己做、哪些交给子智能体、交给哪一档」；
• 有 L1–L5 五档难度子智能体，越往上模型越强、越慢、越贵；
• 五档的工具集相同（文件、bash、联网、Office 技能），差异在模型 / 思考强度 / 人设，所以任何任务都能交给任何档；
• 每一档用哪个 Provider、哪个模型、什么思考强度，都能在 设置 → 团队模式 里单独配置，模型列表直接来自你当前 DSH 的模型目录；
• 安装插件即自动注册模式、五个档位 preset 和配置页——不需要手动改任何配置文件。

为什么值得装

---

截图

---

快速开始

环境要求

• DeepSeek Harness 0.2.1-rc.2 或同系列 0.2.x（插件声明了 engines.dsh: >=0.2.1-rc.2 <0.3.0）
• Web / Desktop profile：本插件依赖 agent preset 注册表与 Web 设置界面，因此仅在 web / desktop profile 生效；headless / TUI profile 不适用
• 至少配置一个可用的模型 provider（设置 → 模型），否则子智能体没有可用的模型路由

安装

三种方式任选一种，装完都得到同一个 bundle。

方式 A：Web 界面（最直观）

1. 侧栏 插件（Plugins） → 右上角 添加插件 ▾ → 安装第三方插件；
2. 输入本地目录绝对路径，确认安装；
3. 刷新页面（Cmd+R / Ctrl+R）加载浏览器端配置页；
4. 新建任务，模式选择器里应出现 「团队主控」。

方式 B：从 GitHub 安装

# 源码安装（跟随 main 分支）
dsh plugin --profile desktop add github:bigbigtooth/DSH-Maestro5

# 或从 Releases 的打包文件安装（固定版本、可离线分发）
dsh plugin --profile desktop add https://github.com/bigbigtooth/DSH-Maestro5/releases/latest/download/dsh-maestro5-0.1.0.tgz

桌面版如果提示找不到 dsh 命令，可在菜单栏用 Manage dsh command 把它装进 PATH（不同版本入口可能略有差异）。 安装完成后重启 DSH（bundle 层在启动时组装）；至少刷新页面以加载客户端半。

方式 C：本地目录（开发态）

dsh plugin --profile desktop add /path/to/DSH-Maestro5

本地目录是 link: 安装：源目录就是安装物，改代码 / 改配置后重启 DSH 即生效，无需重装。

安装后验证清单

• 新任务 → 模式选择器出现 「团队主控」（旁边还有 团队·L1 … 团队·L5 五个档位卡，它们只供子智能体使用，不建议直接选作会话模式）
• 设置 → 团队模式 能打开，五个档位的 Provider / 模型 / 思考强度都能下拉选择
• 插件 → 已安装插件 里出现 DSH Maestro5，点开后能看到 maestro-levels 行与 6 个 preset 行
• 发一句「用 delegate_l1 计算 1+1」，能看到主控派出子智能体并汇总结果

设为默认模式（推荐）

设置 → Agent 预设 → 团队主控 → 设为新任务默认。

⚠️ 不要通过编辑 profile 的 cordis.patch.yml 去改 agent-preset-registry 的默认值：那会让 preset 注册表重启，运行中的会话会丢失 preset 工具。请只用设置界面。

---

使用

选中「团队主控」后，直接描述任务即可。主控会自己判断要不要派、派给谁、派几个。也可以直接指定档位：

用 L1 把这份 CSV 转成 xlsx，保持表头不变。

先让 L2 整理这些素材，再让 L5 写终稿并做一次事实核查。

这件事拆成三份并行：L2 查资料、L3 做表、L4 写结论；最后你汇总并给我一页摘要。

主控怎么工作

1. 拆解：把任务拆成独立、边界清晰的子任务；简单问答 / 单步操作自己做；
2. 选档：机械可复核 → L1/L2；推理链长、错误代价高 → L4/L5；默认从最低可行档开始；
3. 分派：每个子智能体拿到一份自包含的任务说明（背景、输入路径、方法、输出格式、落盘路径、验收标准）——它们看不到你的对话；
4. 并行：互相独立的子任务在同一轮同时派出，而不是串行等待；
5. 复核：结果回来后对照验收标准检查；关键交付再派 L4/L5 独立复核；
6. 交付：汇总成结论 + 可直接使用的产物，并说明用了哪几档、产出在哪个文件。

五档难度

表格是出厂默认值。你可以在设置页把任意一档换上你配置的任何 provider / 模型（例如 MiniMax、9router 里的模型）。

成本控制建议

• 默认让主控「能用 L2 就不上 L4」；
• 大批量同类任务用 L1/L2 并行，比单个高价模型串行更划算；
• 只有错误代价高的交付才用 L4/L5，并且只让 L5 做终审而不是全程主力。

---

配置每档模型

入口：设置（Settings）→ 团队模式（与插件页 插件 → DSH Maestro5 → 行 maestro-levels → Configure 是同一份配置）。

每一档一行，三个字段：

交互细节：

• 切换 Provider 会自动选中该 provider 的第一个模型并清空思考强度；
• 切换模型会重置思考强度（不同模型支持的档位不同）；
• 「默认」表示不显式指定，由模型自己的默认思考强度决定。

生效方式（重要）

• 点 保存 → 配置写入当前 profile 的 cordis.patch.yml（- id: maestro-levels 的 override），重启后保留；
• 保存后需要重启 DSH Desktop，且只对新建的会话生效——DSH 的 preset 在会话创建时固定，已运行的会话保持原配置；
• 想恢复出厂默认：把五档改回上表的值保存 + 重启即可。

---

工作原理

┌──────────────────────────── dsh-maestro5（bundle） ───────────────────────────┐
│ cordis.patch.yml                                                             │
│   ├── 根层设置行 maestro-levels（Config.levels 是 volatile，设置页可写）        │
│   ├── preset team        主控 Lead（人设 + 全部工具 + 5 个 delegate 工具）      │
│   └── preset team-l1…l5  五个档位（人设 + 全套执行工具）                       │
│                                                                              │
│ index.js   Host 半：注册 maestroLevels 服务（读 volatile 配置）                │
│ client.js  Client 半：注册「设置 → 团队模式」页 + 插件行配置页                 │
└──────────────────────────────────────────────────────────────────────────────┘
          │ 安装时自动注册
          ▼
   新会话可选「团队主控」
          │
          ▼
   主控 Lead ──选档──► delegate_l1 … delegate_l5
          │                    │ agentOptions = !!js maestroLevels.agentOptionsFor('lN')
          │                    ▼
          │            team-lN preset 子智能体（独立上下文）
          │                    │ 完成通知（不轮询）
          ▼                    ▼
        汇总 / 复核 / 交付 ◄────┘

关键机制：

• 安装即注册：DSH 安装 bundle 时读取 dsh.bundle.patch，把设置行与 6 个 preset 插入 profile 层栈；
• 配置可持久化：maestro-levels 行的 levels 字段标了 .volatile()，因此能被设置表单编辑、由 config-editor 写回 profile 的 patch 层；
• 模型注入 preset：主控的 5 个 delegate-* 委派工具通过 !!js ctx.get('maestroLevels').agentOptionsFor('l1') 在挂载时读取当前配置，把模型写进子智能体；
• 浏览器半手写：client.js 是 window.__ModuleLoader__ 工厂包，注册到 settings.section 与 plugins.row.config 两个槽位，不需要打包器。

---

自定义与开发

目录结构

DSH-Maestro5/
├── package.json          # bundle 清单：dsh.bundle.patch + dsh.client（浏览器半）+ engines.dsh
├── cordis.patch.yml      # 设置行 maestro-levels + 主控 preset + 5 个档位 preset
├── index.js              # Host 半：maestroLevels 服务
├── client.js             # Client 半：设置页 / 插件行配置页
├── locale/{zh,en}.json   # 插件显示名与描述
├── icon.svg              # 插件图标
├── docs/screenshots/     # README 截图
├── README.md / README.en.md
└── LICENSE

本地开发

# 把本地目录装进 profile（link，改完重启即生效）
dsh plugin --profile desktop add /path/to/DSH-Maestro5
dsh --profile desktop --dump-config   # 可选：只看组装结果，不启动服务

• 没有构建步骤：Host/Client 两半都是手写 JS，DSH 直接加载源目录；
• 改 index.js / client.js / cordis.patch.yml 后重启 DSH（Host 半）并刷新页面（Client 半）；
• 校验：

node --input-type=module --check < index.js
node --check client.js
node -e "require('js-yaml').load(require('fs').readFileSync('cordis.patch.yml','utf8'))"  # 若本机有 js-yaml

修改说明

---

兼容性

已知限制

• 保存配置后需要重启 DSH，且只影响之后新建的会话（preset 在会话创建时固定）；
• 主控自身的模型不固定，跟随会话的模型选择器；
• 五个档位 preset 也会出现在模式选择器里（DSH 对所有健康 preset 一视同仁，没有隐藏开关），描述里已注明「不建议直接选作会话模式」；
• delegate_* 创建的子智能体不是 Agent Team 成员：不会出现在 list_agents，也不能用 send_message 追加指令，完成后以通知形式回到主控；
• 子智能体使用哪个模型取决于你的模型目录；本地 provider（如 9router）需要对应服务在运行。

故障排查

卸载

dsh plugin --profile desktop remove dsh-maestro5   # 或 --profile web

Web 界面：插件 → DSH Maestro5 → 卸载。卸载会同时移除它注册的 6 个 preset 与设置行；重启后「团队主控」从模式选择器消失。

发布新版本（维护者）

本插件不发布到 npm，只通过 GitHub Release 分发打包文件：

1. 更新 README / CHANGELOG.md 与 package.json 的 version；
2. 生成 bundle 打包文件（npm pack 或 pnpm pack），得到 dsh-maestro5-<version>.tgz；
3. 创建 GitHub Release 并上传该文件：

gh release create v<version> dsh-maestro5-<version>.tgz \
  --title "DSH Maestro5 v<version>" --notes-file RELEASE_NOTES.md

发布前检查：package.json 的 files 已包含 index.js、client.js、cordis.patch.yml、locale/*.json、icon.svg；engines.dsh 与目标 DSH 版本匹配。

仓库也欢迎提交到 awesome-dsh-plugin 等收录列表。

社区与收录

• GitHub topic：dsh-plugin（加在仓库 Settings → Topics，便于被发现）
• 欢迎提交到 awesome-dsh-plugin 与各类 DSH 插件市场
• 问题与建议：请开 GitHub Issue
• 贡献指南：CONTRIBUTING.md · 变更记录：CHANGELOG.md

License

MIT