前言¶
在機器學習項目的開發與迭代中，模型或 Agent 經常會聲稱“已完成數據處理”或“模型已收斂”，但往往缺乏切分檢查、泄漏驗證、指標文件或驗證腳本留下的客觀證據。這種依賴口頭陳述的狀態管理容易導致返工或質量失控。
DeepSeek Harness 的機器學習階段閘門插件通過將 ML 項目拆分爲 M0–M8 階段，將狀態管理從“模型自述”轉變爲“證據驅動”。插件讀取項目當前聲明的階段，執行項目提供的驗證腳本，並根據檢查結果和工件狀態計算真實階段、差距與下一齣口，最終在 DSH 界面中直觀展示。
這是什麼¶
這是一個爲 DeepSeek Harness (DSH) 設計的機器學習階段閘門插件，由開發者 lerqian883-alt 維護。
插件的核心價值在於提供一套可驗證的流程管理機制。它不替用戶編寫 ML 代碼，也不憑空判斷階段完成，而是依賴用戶提供的驗證腳本和工件。通過讀取項目狀態、執行檢查並計算證據，它讓“做到哪一步”有據可查。
插件遵循 MIT 許可證。
核心功能¶
- 階段管理：將 ML 項目拆分爲 M0–M8 階段進行管理。
- 狀態讀取：讀取項目當前聲明的階段。
- 驗證執行：執行項目提供的驗證腳本和檢查腳本。
- 證據計算：根據證據計算真實階段、差距和下一齣口。
- 界面展示：在 DSH 界面顯示階段軌道和審計信息。
- 命令行工具：提供
ml_phase_status、ml_phase_phases、ml_phase_advance、ml_phase_defer等命令。 - 項目引導：支持通過
bootstrap創建標準化的項目結構。 - 跨平臺支持：支持
verify.cmd、verify.ps1、verify.mjs、verify.sh作爲驗證入口。
安裝與啓用¶
安裝前需確保環境已安裝 Node.js 20 或更高版本。
使用 DSH 的 profile（例如 web）將插件鏈接到本地目錄：
dsh plugin --profile web add link:"$PWD"
安裝完成後，可通過以下命令確認插件已註冊：
dsh --profile web --dump-config
典型用法¶
- 初始化項目結構
在項目目錄下執行引導腳本，生成標準的.dsh-ml-phase、work和outputs目錄：
node scripts/bootstrap-project.mjs --root <path> --template standard
- 啓動 DSH
進入項目目錄並啓動 DSH：
dsh --profile web
- 查看當前狀態
在 DSH 中使用命令查看當前聲明的階段、證據證明的階段、差距以及下一階段：
ml_phase_status
- 查看階段定義
查看階段定義和證據判定結果：
ml_phase_phases
- 推進階段
當所有檢查和工件通過後，使用命令推進階段：
ml_phase_advance
- 記錄延期
需要人工延期時，記錄原因：
ml_phase_defer reason="等待外部數據確認"
適用場景與注意¶
該插件適用於需要嚴格階段管理和證據追蹤的機器學習工作流。
- 依賴用戶腳本：插件不會編寫 ML 代碼，必須由用戶提供符合約定的驗證腳本。
- 退出碼約定：驗證腳本的退出碼約定爲 0=pass, 1=fail, 2=skip，其他值爲 error。
- 配置默認值：默認配置
watchAutoRun爲 false，文件變化不會自動執行腳本，需手動觸發。 - 安裝兼容性：不同版本的 DSH 可能存在安裝語法差異，請以當前版本幫助爲準。
- 運行權限：插件以當前 DSH 進程的權限運行，請確保安裝前已檢查源碼與許可證。
結尾¶
通過將階段閘門從主觀描述轉變爲客觀檢查，該插件爲 DeepSeek Harness 下的機器學習項目提供了一種更嚴謹的開發流程保障。更多實現細節與文檔可參考項目源碼。
