前言¶
DeepSeek Harness（DSH）採用“一切皆插件”的架構，允許開發者通過安裝各種插件擴展功能。然而，插件生態中的不穩定因素可能引發連鎖反應：一個插件的不良配置可能導致整個工具層崩潰，或者干擾其他插件的正常工作。在部署或維護 DSH 環境時，識別這些潛在風險至關重要。
dsh-stability-audit 是爲此設計的審計工具。它通過靜態分析掃描已安裝的插件，評估其穩定性風險（包括鉤子面、啓動任務、預檢健康度及依賴關係），並提供修復建議。這避免了在插件真正破壞 Harness 前進行被動排查。
什麼是 dsh-stability-audit¶
dsh-stability-audit 是一個運行在 DSH 環境中的審計插件，由社區開發者 chunfenxiazhi-collab 維護。它通過靜態代碼分析和可選的隔離安裝驗證，對插件進行穩定性分級（🔴/🟡/🟢），並給出具體的修復建議。該工具旨在幫助開發者在安裝新插件或升級現有插件前，評估其可能帶來的風險。
核心功能¶
該插件提供以下核心能力：
- 靜態穩定性分析：掃描插件的鉤子面、啓動任務、預檢（preflight）以及依賴項，識別潛在的結構性問題。
- 可選的隔離安裝驗證：在隔離環境中測試插件，驗證其能否獨立安裝並正常啓動。
- 風險分級與修復建議：根據分析結果給出 🔴（高風險）、🟡（中風險）或 🟢（低風險）的評級，並提供具體的修復命令或操作指引。
- 遠程預審能力：支持對在線倉庫（如
owner/repo）的插件進行遠程預審，無需本地安裝即可評估風險。 - 批量測試支持：支持對多個在線插件進行批量穩定性測試。
- 機器可讀輸出：提供 JSON 格式的輸出，便於其他 Agent 或腳本直接調用和處理。
- 零副作用：以只讀模式運行，絕不執行被審計的插件代碼，確保環境安全。
安裝與啓用¶
在終端中執行以下命令安裝該插件：
dsh plugin --profile web add dsh-stability-audit
安裝完成後，需要重啓 DSH Web 服務。重啓後，Agent 可以通過自然語言指令“run the plugin stability audit”來調用該工具進行審計。
典型用法¶
除了通過 Web 界面指令調用外，該工具也提供了命令行接口（CLI），支持不同的審計模式。
本地掃描¶
掃描當前 Web Profile 中已安裝插件的穩定性：
node cli.mjs
機器可讀輸出¶
獲取結構化的 JSON 數據，便於自動化腳本處理：
node cli.mjs --
遠程預審（完整流程）¶
克隆遠程倉庫並進行靜態分析及隔離安裝測試：
node cli.mjs --remote owner/repo --dynamic
遠程預審（JSON 輸出）¶
僅對遠程插件進行靜態分析並輸出 JSON：
node cli.mjs --remote owner/repo --
適用場景與注意¶
適用場景¶
- 插件引入前評估：在安裝未知來源的社區插件前，先進行遠程預審。
- 現有環境排查：定期掃描已安裝的插件，發現潛在的不穩定性隱患。
- 批量維護：在更新多個插件時，使用批量測試功能快速篩選出有問題的包。
注意事項¶
- 靜態分析的侷限性：靜態分析無法完全模擬運行時行爲（如某些 Hook 在特定上下文下的拋出）。🔴 級別通常表示“需要人工介入檢查”，而非絕對確定插件已損壞。
- 隔離環境的限制：隔離測試使用的是無頭（headless）Profile。如果插件依賴於 Web 獨佔服務（如
storageDomain），在隔離環境下可能會顯示假陰性（❌），但這僅作爲環境依賴的提示。 - 運行時探測：目前尚不支持事件循環延遲等運行時性能探測，相關功能在 v2 路線圖中。
- 修復建議性質：工具提供的修復建議僅爲提示，並非自動應用。由於環境差異，建議在執行修復前由人工確認。
- 只讀模式：該工具全程以只讀模式運行，不會執行被審計的插件代碼，不會對 DSH 環境產生副作用。
總結¶
dsh-stability-audit 是一個務實的安全審計工具，它通過靜態規則和隔離測試，將插件生態中的潛在風險顯性化。開發者可以利用它建立插件准入機制，減少因插件故障導致的 Harness 崩潰。
目錄頁：chunfenxiazhi-collab/dsh-stability-audit
源碼倉庫：chunfenxiazhi-collab/dsh-stability-audit
