前言¶
DeepSeek Harness（DSH）採用插件化架構，旨在將複雜的開發流程標準化。在實際工作中，從代碼審計、自動修復、驗證、QA 到最終複覈與報告生成的流程往往容易中斷，且難以復現或恢復。dev-harness-dsh 插件通過編排這些環節，將其轉化爲可恢復運行的 Run，從而解決流程中斷與狀態管理的問題。
這是什麼¶
dev-harness-dsh 是由 Dev-Wiki 維護的 DSH 插件。它將 Audit、Auto Fix、驗證、QA、最終複覈與統一報告整合爲可恢復運行的流程。目前，該插件已完成 V0、K1、K2、K3、K4、S1、S2、S3、S4 的 MVP 基線開發。
核心功能¶
- 可恢復運行編排：將開發流程中的各個階段（審計、修復、驗證等）編排爲可恢復的 Run。
- MVP 基線完成：V0 至 S4 的核心基線功能已實現。
- 語言支持：支持 JavaScript 與 TypeScript。
- 構建系統：基於 npm 或 pnpm。
安裝與啓用¶
安裝前請確保本地已安裝所需版本的 DSH 及其依賴。
- 安裝依賴
pnpm install --frozen-lockfile --ignore-scripts
- 構建插件
npm run harness:build
- 安裝插件
具體的安裝步驟請參考項目文檔中的 安裝指南。
注意：安裝前請檢查源碼與許可證。
典型用法¶
運行流程¶
在 DSH Session 中，可以使用以下命令啓動或管理 Run：
- 新建可恢復 Run
/harness-run fix-only
該命令會返回當前 Run 的權威視圖（JSON），包含 runId、revision、phase（如 AUDIT）和狀態。
- 查看狀態
/harness-status [run-id]
- 恢復 Run
/harness-resume <run-id>
此命令會校驗工作區與快照一致後恢復 Run。工作區的任何變更都會導致恢復失敗。
- 取消 Run
/harness-cancel [run-id]
本地發佈包構建¶
如需構建本地發佈包：
python3 release.py
該腳本會先執行 npm run harness:full（包含 68 個自動化用例），成功後使用禁用生命週期腳本的 npm pack 在臨時目錄構建並校驗包，最後將包放入 dist/。該腳本僅構建本地 .tgz，不上傳至 registry。
完整驗證¶
npm run harness:full
此命令包含類型檢查、Lint、68 個自動化測試、構建和打包 dry-run 驗證。
適用場景與注意¶
- 版本鎖定：dev-harness-dsh 版本 0.1.0 與 DeepSeek Harness 0.1.0-rc.8 精確鎖定，不聲明跨 rc 兼容。
- 運行權限：插件以當前 DSH 進程的權限運行，請確保安裝前已審查源碼。
- 環境要求：Node.js 版本需滿足
^22.19.0 || >=24.0.0。 - 許可證：插件未在資料中聲明許可證，使用前請自行確認合規性。
總結¶
dev-harness-dsh 爲 DSH 用戶提供了結構化的開發流程編排能力，通過可恢復的 Run 管理代碼審計與修復流程，適合需要自動化與標準化開發鏈路的團隊。更多細節與源碼，請訪問 GitHub 倉庫。
