在 DeepSeek Harness (DSH) 的插件生態中，處理複雜工程任務時，單模型往往受限於視角單一、架構盲點或幻覺問題。dsh-moa 引入了 Mixture of Agents (MoA) 架構，通過多模型並行協作與評審機制，提升代碼生成的可靠性與質量。
插件概述¶
該插件由 GooDAnDReaREADY 維護，是一個爲 DSH 提供多智能體協作能力的插件。它通過 /moa 斜槓命令提供文件工作區支持，並與 Live Canvas 進行集成。插件旨在解決單一模型在模糊或複雜指令下表現不佳的問題。
核心功能¶
1. 斜槓命令與自動補全¶
插件集成了 /moa 斜槓命令，支持自動補全。用戶可以直接在聊天輸入框中觸發該命令，或通過 --preset 參數指定預設配置。
2. 自適應問卷門控¶
針對模糊或未充分定義的提示詞，插件會自動觸發“自適應問卷門控”。Advisor 模型會生成 2 到 4 個結構化問題，在生成代碼前向用戶確認關鍵細節（如 UI 風格、後端選擇等）。
3. 並行分發與心跳¶
系統會並行調用多個智能體進行提案。每個智能體的處理狀態通過實時心跳（如 ⏳ [3s] Processing...）展示，同時會自動過濾掉冗餘的系統提示詞和工具 Schema，避免 Token 浪費。
4. 磁盤級候選隔離與提升¶
不同於純 Chat 場景，插件將候選方案的文件寫入隔離的磁盤工作區（如 .moa/candidate-N/），防止方案間互相污染。最終由評審模型選出勝者，並將文件直接提升至項目根目錄，自動清理臨時目錄。
5. 原生設置卡片與預設¶
插件提供原生的設置卡片，允許配置 Proposer 模型、Judge（評審）模型以及命名預設（如 default, fast, deep-reasoning）。支持自定義評判標準和溫度參數。
6. 候選差異查看器¶
提供可視化的差異對比工具，方便開發者逐行查看不同智能體提案之間的代碼差異。
7. 優化模式（增量編輯）¶
在優化模式下，插件會自動檢測現有代碼庫上下文，生成精確的增量修改而非破壞性的全文件重寫。
8. 快速模式與自定義評判標準¶
支持“快速模式”用於處理簡單任務，並允許自定義 Judge 的評判標準，靈活性較高。
9. 運行歷史與勝率排行榜¶
插件會持久化記錄每次運行的類型（合成、快速模式、問卷等），並提供勝率排行榜，方便追蹤模型性能。
10. Live Canvas 1-Click 預覽（可選）¶
如果安裝了 @goodandready/dsh-live-canvas 插件，Promoted 的 HTML 會被推送到 Canvas 沙箱，並提供一鍵預覽鏈接。
11. Token 節省的聊天摘要¶
在聊天中，插件會將大量的代碼輸出替換爲簡潔的文件列表和架構摘要，降低 Token 消耗。
12. 一次會話模型恢復¶
插件作爲一次會話修飾器運行，完成後會自動恢復至用戶的主會話模型，保證上下文的連續性。
安裝與啓用¶
當前未提供特定的安裝命令。該插件通過 npm 包分發，安裝時需注意以下依賴要求：
- Node.js: 需要 Node.js 20 及以上版本。
- Peer Dependencies: 安裝時需滿足以下依賴項：
{
"@deepseek-ai/cordis": "^4.0.1",
"@deepseek-ai/dsh-credentials": "^0.1.0-rc.6",
"@deepseek-ai/dsh-host-webserver": "^0.1.0-rc.6",
"@deepseek-ai/dsh-settings": "^0.1.0-rc.6",
"@deepseek-ai/dsh-tools": "^0.1.0-rc.6",
"@deepseek-ai/schemastery": "^3.18.1"
}
典型用法¶
插件通過 /moa 命令啓動，支持多種參數組合：
/moa build a real-time reactive dashboard with charts and websocket updates
/moa code-review audit the auth middleware and security boundaries
/moa --preset=deep-reasoning solve this math problem step by step
注意事項與限制¶
- Live Canvas 集成要求: 如需使用 Live Canvas 1-Click 預覽功能，需在同一個 Profile 中安裝
@goodandready/dsh-live-canvas插件。 - 目錄權限: 插件會在工作區生成
.moa目錄和緩存文件。 - 外部依賴: 插件使用 OpenRouter 的公共目錄（模型定價與分類），該數據會被緩存在
~/.dsh/storages/dsh-moa-catalog.中。
總結¶
dsh-moa 是一個專注於多模型協作與代碼評審的工具，通過磁盤隔離、並行提案和增量編輯等機制，幫助開發者解決複雜工程任務中的單模型侷限性。
