前言¶
DeepSeek Harness 採用“一切皆插件”的架構，隨着開發和使用，系統中往往堆積了大量工具和技能插件。開發者很難直觀判斷哪些插件是活躍的，哪些已經淪爲“死插件”。dsh-plugin-prune 插件通過純觀察模式，收集每個插件工具和技能的真實調用數據、錯誤率、延遲以及跨會話使用情況，結合你的主觀評分，標記出可以安全移除的插件。
這是什麼¶
dsh-plugin-prune 是一個純觀察者插件，不註冊模型工具，也不修改業務狀態。它由 Octo-o-o-o 維護，開源協議爲 MIT。其核心價值在於提供客觀的量化指標，輔助決策哪些插件應當保留或卸載。
核心功能¶
該插件主要提供以下能力：
- 統計數據彙總：聚合工具和技能的調用次數、錯誤數、平均/總耗時、輸出大小、活躍會話數，以及每日調用次數（90天滾動窗口）。
- 插件健康視圖：在 Settings → Plugins 中新增 Plugin Health（插件體檢） 標籤頁。提供概覽表格，展示已安裝插件的狀態（正常/禁用/失敗）、貢獻的工具數及真實調用統計，自動標記從未使用、失敗或被標記爲無用的插件。
- 評分機制：在詳情表格中，支持對每個插件進行“有用”、“中立”、“無用”的一鍵評分。
- 數據持久化：統計數據以 JSON 文件形式保存在
$DSH_HOME/dsh-plugin-prune.json，支持跨重啓累計。
安裝與啓用¶
插件安裝後需要重啓 DeepSeek Harness 的 Web 進程才能生效。
dsh plugin --profile web add dsh-plugin-prune
安裝完成後，重啓 dsh web，進入 Settings → Plugins，找到 Plugin Health 標籤頁即可查看數據。
典型用法¶
- 進入 Settings → Plugins → Plugin Health 查看概覽和詳情表格。
- 在詳情表格中，檢查工具的 calls（調用次數）。如果某工具從未被調用，表格會提示“never called（從未調用）”，建議移除。
- 查看錯誤率或平均延遲。高錯誤率或異常延遲的工具可能存在問題。
- 針對不確定的插件，點擊該行的評分按鈕，標記爲“Useful”、“Neutral”或“Useless”。
適用場景與注意¶
- 統計範圍：統計數據僅在插件安裝並運行期間收集，卸載插件後無法恢復歷史數據。
- 來源信息：DeepSeek Harness 暴露沒有第一類工具 -> 插件來源的映射。詳情表中的“source plugin（來源插件）”列是盡力而爲的：對於官方工具是靜態目錄，對於運行時註冊的工具是棧幀追蹤，對於第三方工具是知名列表，其他情況顯示“未知來源”。工具層面的統計數據本身是準確的。
- UI 插件限制：僅用於 UI 樣式或佈局的插件不產生工具調用，無法通過此插件自動測量其價值，需手動判斷。
- 隱私與安全：所有統計數據僅存儲在本地機器的 JSON 文件中，不會上傳到任何服務器。
- 依賴要求：需要
dsh >= 0.1.0-rc.5版本，以及 Node.js^22.19 || >=24環境。
總結¶
dsh-plugin-prune 解決了插件管理中的“盲人摸象”問題。通過將隱性的使用行爲轉化爲顯性的統計指標，它幫助開發者保持插件列表的整潔，避免冗餘代碼和配置的干擾。在使用前，請務必檢查源碼（GitHub 鏈接）並確認版本兼容性。
- GitHub 倉庫：https://github.com/Octo-o-o-o/dsh-plugin-prune
- 社區目錄：https://www.skillhub.cn/plugins/Octo-o-o-o/dsh-plugin-prune
