前言¶
DeepSeek Harness（DSH）採用插件化架構，將功能擴展視爲獨立的契約。在工程開發場景中，當 Agent 需要修改代碼或執行發佈驗證時，如果沒有受治理的流程，這些操作往往是不可審計的。dsh-engineering-control-plane 插件通過將一次實現、修復或驗證請求固定爲一個可追蹤的 Mission，提供了受治理的工程任務執行能力。
是什麼¶
該插件是 DeepSeek Harness 的工程任務編排與發佈門禁插件，由 bailong-Hakuryu 維護。它負責把 Agent 的工程目標轉化爲明確的 Mission，並控制其單向階段推進。通過綁定 Evidence（證據）和 Quality Gate（質量門禁），它確保了從“誰改的”到“爲什麼放行”的完整鏈路可追溯。
核心功能¶
插件提供以下核心能力：
* 任務編排與發佈門禁：管理工程任務的執行流程與發佈准入。
* 狀態跟蹤：提供任務路由、計劃執行、驗證和狀態跟蹤。
* 單向階段推進：Mission 按固定順序推進，不可逆。
* Evidence（證據）綁定：將角色輸出、驗證結果等摘要綁定，作爲審覈依據。
* Quality Gate（質量門禁）：基於確定性規則判斷任務是否通過。
* 持久化與恢復：使用 SQLite 持久化數據，支持從 BLOCKED 或 REWORK_REQUIRED 狀態恢復。
* 只讀完整性檢查：提供 doctor 命令驗證 SQLite 數據與 Schema。
* 路由支持：支持被動路由（自然語言指令）和主動指令（/mission）。
安裝與啓用¶
安裝前請確保已安裝 DeepSeek Harness CLI，且運行環境滿足 Node.js 版本要求（^22.19.0 || >=24.0.0）。
- 下載對應版本的 Release tarball（當前爲 v0.2.2）。
- 使用官方命令安裝插件。
dsh plugin --profile web add D:\Downloads\dsh-engineering-control-plane-0.2.2.tgz
- 檢查最終配置組合。
dsh --profile web --dump-config
- 在目標 Git 倉庫目錄啓動 Harness Web。
dsh web
默認配置下，插件會綁定當前工作目錄爲 current-workspace，並讀取倉庫的 package.json 來運行 test（必需）、typecheck 和 build 腳本。驗證過程中不會觸發 postinstall 等安裝鉤子，依賴需提前安裝好。
典型用法¶
插件支持兩種調用方式：
被動調用（推薦）
直接描述工程目標，模型會將請求路由到 Mission 工具。
請爲當前倉庫實現這個功能，並在完成後運行完整驗證。
請修復這個問題，所有修改必須經過 Mission 發佈門禁。
主動調用
在 Harness Web 或 CLI 中直接輸入指令。
/mission 爲當前倉庫執行一次發佈前驗證，要求測試、類型檢查和構建全部通過
如果明確不需要治理流程，可以指定“直接模式，不創建 Mission”。
使用說明與注意¶
在使用該插件時，請注意以下事實：
- 驗證命令來源：驗證命令來自宿主配置，不由模型臨時編造。
- 門禁邏輯：只有確定性 Quality Gate 可以產生
APPROVED狀態。 - 證據完整性：缺失、損壞、截斷或不確定的證據會導致任務
fail closed。 - 併發限制：一個工作區同時只允許一個非終態 Mission。
- 依賴處理：驗證時絕不先安裝依賴，因此不會觸發倉庫的
postinstall等鉤子。 - 職責邊界：該插件負責工程治理，不等同於漏洞掃描器；安全評估由可選的 Security Assurance 插件負責。
總結¶
dsh-engineering-control-plane 通過引入 Mission、Evidence 和 Quality Gate，將 Agent 的代碼修改行爲轉化爲受控、可審計的工程流程。它適合需要嚴格治理流程的團隊，通過單向階段推進和 SQLite 持久化，保證了執行過程的完整性與可恢復性。更多細節可查閱 GitHub 倉庫。
