前言¶
DeepSeek Harness (DSH) 的核心設計理念是「一切皆插件」。在構建多智能體協作系統時，開發者常面臨任務分解混亂、專家委派無門禁、交付質量不可控等問題。傳統的單智能體或簡單鏈式調用難以應對複雜項目。
dsh-expert-orchestrator 插件提供了一個「專家編排」會話模式。它引入了 PM 先行規劃、依賴 DAG 任務板和分級交付門禁機制，將控制權交給編排層，確保實現過程始終由專家委派完成，而非智能體自我實現。
核心功能¶
- 每輪分診與錨點機制：每個用戶消息重新進入分診循環，在執行任何動作前，運行包含五個錨點的自檢（審閱、收斂、防漂移、協作、資源），防止跨輪次的任務漂移。
- PM 先行規劃：複雜任務優先交給項目管理專家進行分解、依賴梳理和驗收標準定義，然後再進行委派。
- 專家委派與合併名冊：實現始終委派。系統維護一個合併專家名冊（包含核心專家和啓用的源專家），通過
summon_expert或summon_experts調用。遞歸保護通過 6 項黑名單限制子智能體行爲。 - 依賴 DAG 任務板與消息總線：使用
taskboard.py工具管理依賴關係圖，通過消息總線實現並行專家的磁盤落盤與摘要回復。 - 分級交付門禁：交付前需經過獨立評審（評審者 ≠ 實現者，最多 2 輪返工）和 PM 檢查點，最後才能提交/交付。
- 經驗池與提示精簡：每任務捕獲 ≤3 條可複用經驗注入未來任務。支持專家級提示精簡（
method前置）和按需深度閱讀指針。 - 安全與容錯：v2.8 引入委派安全門禁（源鏈標記、工件所有權註冊、寫鎖）；v2.7 實現基於事件溯源的崩潰安全編排狀態。
安裝與啓用¶
插件以目錄形式集成。將 dsh-expert-orchestrator 目錄放置於 DSH 的插件加載路徑下，或通過 DSH 插件管理器添加。確保 DSH 版本滿足 engines.dsh 要求（>=0.1.7-alpha.2 <0.2.0-0 || >=0.2.0-rc.1 <0.3.0-0 || >=0.2.1-0 <0.3.0-0）。
典型用法¶
插件提供以下交互模式：
- 瀏覽專家名冊
list_experts
支持緊湊和展開模式，列出合併名冊中的專家，標記跨源衝突和被陰影覆蓋的條目。
- 單次專家召喚
summon_expert
適用於單篇白皮書或單一領域專家的召喚。任務限制 8K 字符，自動注入淨化後的角色人設。
- 批量專家召喚
summon_experts
支持批量召喚，數量 ≤8，併發數 4。具備部分成功語義。
- 任務板與增量讀取
taskboard.py -- (structured envelopes)
taskboard.py --since-seq
使用依賴 DAG 任務板處理結構化信封，支持自上次序列號的增量讀取。
- 配置與開關
啓用工具預算和空閒邊緣自動回收（建議同時開啓）：
export DSH_EXPERT_TOOL_BUDGET=1 # 啓用工具調用硬預算
export DSH_EXPERT_IDLE_RECLAIM=1 # 啓用空閒邊緣自動回收
適用場景與注意¶
此插件適用於需要嚴格流程管理、多角色協作和交付質量控制的複雜開發場景。
注意事項：
- 權限與安全：插件以當前 DSH 進程權限運行，請確保安裝源可信（許可證爲 MIT）。
- 遞歸保護：子智能體工具過濾器包含 6 項黑名單，防止無限嵌套。
- UI 待定：設置面板中的「清除已刪除」按鈕 UI 尚未實現（RPC 協議已就位）。
- 空閒循環：空閒邊緣自動回收是零令牌操作，但會在事件流中可見，不會消耗模型額度。
總結¶
dsh-expert-orchestrator 通過將規劃、委派和交付環節解耦並標準化，爲 DSH 提供了一套多智能體編排方案。它不直接實現代碼，而是通過 PM 規劃和專家委派，配合事件溯源的任務板和門禁機制，確保任務交付的可靠性與質量。
