dsh-startup-check：DeepSeek Harness 插件樹啓動前檢查工具

在 DeepSeek Harness 的插件開發流程中，安裝插件後直接重啓往往伴隨着“開箱即廢”的風險。一旦 harness 無法打開，排查代碼錯誤變得非常困難，因爲此時負責讀取代碼的智能體可能已經失效。dsh-startup-check 將錯誤發現的時間點提前到重啓之前。它通過靜態檢查和可選的隔離真機啓動及瀏覽器冒煙測試，在插件真正生效前發現並修復問題，避免因插件錯誤導致 harness 啓動失敗。

工具定位¶

這是一個爲 DeepSeek Harness profile 插件樹提供啓動前檢查的工具。它包含靜態檢查以及可選的隔離真機啓動和 headless 瀏覽器冒煙測試，支持實例關閉確認和殘留實例審計。它提供 plugin_check 命令行工具，並捆綁了 plugin-fault-diagnosis 診斷技能。

核心功能¶

工具覆蓋了插件開發中的多個關鍵環節：

靜態檢查：包括語法檢查、包結構檢查、補丁引用檢查和配置樹組裝。
真機啓動冒煙測試：啓動一個隔離的實例驗證插件樹是否能正常加載。
頁面側冒煙測試：通過 CDP 連接瀏覽器，檢查頁面是否報錯或渲染異常。
實例管理：確認隔離實例是否正常關閉，以及審計殘留實例。
診斷技能：捆綁 plugin-fault-diagnosis 技能，能夠根據檢查結果定位文件並分類錯誤。

安裝與啓用¶

安裝插件需要使用 DeepSeek Harness 的 CLI，安裝後需重啓 harness 以使插件生效。

dsh plugin --profile web add @cningan/dsh-startup-check

典型用法¶

安裝完成後，可以使用 plugin_check 命令進行不同級別的檢查。如果不指定參數，默認執行靜態檢查。

plugin_check                          # 靜態檢查
plugin_check { live: true }           # 包含真機啓動冒煙測試
plugin_check { page: true }           # 包含頁面側冒煙測試（需安裝瀏覽器）
plugin_check { sweep: true }          # 包含殘留實例審計
plugin_check { live: true, killStray: true }   # 啓動檢查並清理本次殘留實例

適用場景與限制¶

運行環境：插件僅支持 Windows 平臺，使用 PowerShell 和 WMI 進行實例審計。運行環境需要 Node.js >= 22。
瀏覽器要求：如果需要進行頁面側檢查，需要安裝 Edge 或 Chrome 瀏覽器。
Profile 支持：當前固定到 web profile，其他 profile 爲開放工作。
安全性：設計爲只讀模式，不會重啓或觸碰正在使用的 harness。

總結¶

通過在重啓前進行全面的檢查和修復，dsh-startup-check 能夠幫助開發者避免因插件語法錯誤或結構問題導致 harness 無法啓動的情況。更多技術細節、源碼及文檔請參考：GitHub。