多智能体编排台 niuyiming87-pixel/dsh-agent-orchestra

🎼 DSH Agent Orchestra — 用 DeepSeek Harness 编排免费模型的完整实践

核心命题：云端的聪明脑子（配额内）当指挥官，免费/本地模型当打工人——一套“问面板/委托”机制，让多个 agent 协同完成真实任务。
本仓库是全过程实录：设计、实现、实测、踩坑、合规边界。

🏗️ 架构

你（人类总指挥） │ ┌──────────────┴───────────────┐ │ DSH 桌面版 = 参谋长/指挥官 │ 云端 qwen3.8-flash xhigh（决策/验收） └──────────────┬───────────────┘ ┌───────────┼───────────────┬──────────────┐ headless DSH OpenCode CLI headless DSH 人肉成员 +DS 免费模型 +国产免费旗舰 +本地 9B (WorkBuddy/
(配额内) (0成本,agent级) (0成本,隐私) Qoder GUI)

两种协作模式：

| 模式 | 说明 | 触发方式 |
| 全自动 | 指挥官并行调用 headless/OpenCode 工人，自动验收汇总 | “委托 OpenCode：任务” / “用 DeepSeek 工人：任务” |
| 人在环 | GUI-only 应用（无 CLI）由人复制问题卡、粘回回答，指挥官负责聚合分析 | “问面板：问题”（自动生成标准问题卡） |

🧩 核心组件

1. agent-panel 技能（DSH Skill）一个 SKILL.md 定义的多脑会诊协议，包含：
- 会诊模式：同一问题并行发多个成员 → 输出 共识🤝 / 独有🔵 / 矛盾⚠️ / 裁判总结 报告
- 委托模式：任务书四要素（目标/范围/验收标准/输出要求）→ 派给工人 → 指挥官亲自读改动验收（不轻信工人自我汇报）
- 隐私闸门：涉敏任务自动剔除云端成员，只走本地
- 问题卡模板：让 GUI-only 应用也能以标准格式入伙

2. headless DSH 工人（DSH 原生能力） $env:DSH_HOME = "D:\dsh-worker" # 独立门户（关键！见踩坑） $env:DEEPSEEK_API_KEY = (Get-Content key文件)
dsh --profile headless --patch worker.patch.yml "任务书"
一个补丁文件 = 一个“廉价大脑插槽”，换模型/换推理强度都是一行配置。
支持 off/minimal/low/medium/high/xhigh/max 七档思考强度按需调节（白天 medium 省配额，夜间折扣时段 xhigh 拉满）。

3. OpenCode 工人 opencode-cli run --auto -m "任务书" 完整 coding agent（自带读写/终端工具），实测修 bug 任务满分（含隐藏 bug）。

📊 实测案例

任务：给 STM32 写 parse_line(key=value) 缓冲区安全解析函数，三脑同题：

| 成员 | 结果 |
| DeepSeek v4.1 flash | ✅ 正确，边界 >32（需33字节缓冲），一次 memcpy 带走 \0 |
| 免费国产旗舰 | ✅ 正确，边界 >=32（32字节缓冲刚好），更实用 |
| 指挥官加时意见 | ⚠️ 两家都漏了 UART 的 CRLF 剥离——双盲评审也需第三只眼 |

成本：两个工人 0 元（免费模型），指挥官吃自带配额，全程 <2 分钟。

🕳️ 踩坑实录

1. profile 劫持：~/.dsh/settings.yaml 的全局默认模型会压过 headless 的补丁配置 → 解法：给工人独立 DSH_HOME
2. 无密钥本地端点：DSH 的 provider 路由强制要求 key → 占位 key（local）即可，反正本地服务不校验
3. GUI-only 不可编排：没有 CLI 的应用（多数国产 agent 应用）无法被指挥，人肉传令是唯一合规路径——别用 UI 自动化去模拟点击，免费额度条款普遍禁止自动化调用，封号风险不值当
4. 并发红线：包月套餐普遍限制并发 agent 数（如 2-3 个）与“仅交互式使用”，编排前先读条款

📁 目录

scripts/
├── dsh-worker-dsv4.ps1 # headless 工人启动器（带 -Effort 档位参数） └── dsv4-worker.cordis.patch.yml.example # 工人模型路由补丁模板 docs/ └── agent-panel.SKILL.md.example # 会诊面板技能全文

💡 设计原则总结

1. 判断给强模型，粗活给免费模型，隐私给本地模型——成本模型驱动的路由
2. 验收永远不能外包：工人的自我汇报必须被指挥官复核（本项目里这条救过一次场）
3. 免费模型的“限时”是常态：把模型 ID 做成配置而非硬编码，降级链写进技能
4. 人在环不是失败，是架构的一部分——承认工具边界，比硬凑全自动更稳

License

MIT