dsh-quorum：DeepSeek Harness 機制強制的紀律層

前言¶

DeepSeek Harness (DSH) 的 Agent Teams 在協作中常遇到四個典型問題：權限失控、討論邊界模糊、成本事後可見、報告缺乏證據。現有的解決方案（如 firstmate）只能“禮貌請求”模型遵守紀律，因爲終端 Harness 沒有其他鉤子。dsh-quorum 在機制層面強制執行這四項紀律。一個只讀審覈者不會“選擇”不編輯文件；它無法編輯。

本質¶

這是一個插件包，不是運行時。DSH 的會話、模型請求、工具、Agent 循環、名冊、郵箱、任務板和 Web UI 仍由 DSH 擁有。此插件包僅在頂層添加策略，並讀取 DSH 已記錄的持久化事實。

安裝與前置條件¶

安裝前需確認 DSH 版本在 >=0.2.0-rc.2 <0.3.0 範圍內。該插件依賴 DSH 的 Agent Teams 服務，因此必須按順序安裝三個包：Web 應用、Agent Teams 配置文件，最後是 dsh-quorum。

dsh plugin --profile <name> add -w @deepseek-ai/dsh-web-app@0.2.0-rc.2
dsh plugin --profile <name> add -w @deepseek-ai/dsh-experimental-agent-team-profile@0.2.0-rc.2
dsh plugin --profile <name> add -w dsh-quorum@0.3.3

版本說明¶

0.3.3：當前發佈版本，也是第一個通過 CI 發佈並帶有簽名證明的版本。
0.3.2：從未發佈到 npm（發佈失敗），已安裝該版本的用戶代碼相同，無需遷移。
0.3.1：由維護者機器發佈，不包含簽名證明。
0.0.0-stage：npm 發佈流程中的佔位符，如果在 npm view 中看到此版本，說明處於發佈窗口期，應重試。

安裝速度¶

第一次安裝命令較慢，主要因爲 @deepseek-ai/dsh-web-app 需要拉取約 300 個包。實測在冷配置下安裝 dsh-quorum 約需 24.5 秒，從 0.3.1 升級到 0.3.3 約需 36 秒。

使用與配置¶

版本鎖定：如果關心實際運行的代碼，必須鎖定版本。上游建議鎖定 Git 修訂版，因爲默認分支的後續推送會更改安裝時的代碼。
工作區標誌：必須傳遞 -w 標誌，因爲 profile 是 pnpm workspace，不加該標誌會報錯。
依賴檢查：必須先安裝 Agent Teams 包，否則插件會靜默失敗，僅輸出一條警告。

# 鎖定版本安裝
dsh plugin --profile <name> add -w 'github:141w/dsh-quorum#v0.3.3'

覆蓋配置¶

插件行來自插件包層，用戶層通過 cordis.patch.yml 進行覆蓋。用戶層不支持手動創建全新的插件行，只能針對已存在的行進行 id 定向覆蓋。

- id: quorum
  name: dsh-quorum
  config: { ... }

注意事項¶

升級風險：從 0.1.0 到 0.3.1 升級可能會損壞會話。因爲在這些版本中注入的 quorum_wait 消息缺少 id 和 role，導致會話無法再次打開。
靜默失敗：如果缺少 Agent Teams 包，插件不會崩潰，只會輸出一條警告並保持待激活狀態。
許可證：該插件採用 MIT 許可證，允許在 DSH 進程權限範圍內運行。

結語¶

dsh-quorum 通過機制強制紀律，解決了 Agent Teams 開發中的核心協作痛點。如需查看完整文檔或源碼，請訪問：GitHub 或社區目錄。