前言¶
DeepSeek Harness (DSH) 生態強調“一切皆插件”。在開發過程中,用戶往往需要安裝多個插件來擴展功能。當插件數量增加,依賴關係變得複雜,且資源消耗(Token、緩存)不透明時,管理難度會顯著上升。本文介紹一款側邊欄展開面板插件,用於在 Web Profile 界面中直接查看已裝插件的關係圖譜、技能目錄及 Token 緩存成本分析。
簡介¶
該插件由 EaveBounty 維護,開源協議爲 MIT。它爲 DSH Web Profile 提供了一個側邊欄展開面板,無需跳轉頁面即可展示插件網絡結構、技能統計和成本數據。主要解決“插件依賴不明”、“資源消耗不透明”以及“缺乏成本監控”的問題。
核心功能¶
插件面板包含三個主要視圖:
1. 插件關係圖譜
* 視圖交互:支持節點彈性炸開、拖拽、平移和縮放。
* 節點可視化:球體大小代表調用頻次(基於會話日誌縮放),顏色代表插件類型(皮膚/主題、用量統計、插件市場、架構繪圖、技能、核心等),亮暗代表啓用狀態(啓用且非依賴爲亮,核心/依賴或已裝未啓用爲暗)。
* 連線邏輯:實線表示依賴,點線表示對等依賴,虛點線表示同類,長虛線表示同項目。
* 詳情查看:點擊節點可查看狀態、版本、來源、分類、頻次、下載量、描述及鄰居節點。
2. 技能目錄視圖
列出技能目錄(.dsh/skills)下所有技能的統計信息,包括加載次數、會話數、重複加載會話數、累計讀取量(tokens)、平均耗時及是否已收錄。
3. 緩存分析視圖
* 數據範圍:包含當前進行中會話的實時投影與歷史日誌掃描。
* 統計維度:輸入/緩存命中/命中率/節省佔比/估算成本(¥)/節省(¥)。
* 週期統計:支持按今日/本週/本月(北京時間)統計。
* 成本模型:基於 DeepSeek v4 官方價,按高峯(北京時間 09-12/14-18)與空閒時段分時估算。
安裝與啓用¶
- 安裝命令:使用以下命令安裝插件。
dsh plugin --profile web add EaveBounty/dsh-plugin-graph
- 啓動服務:安裝完成後,重啓
dsh web命令。
典型用法¶
- 重啓 Web 端後,在側邊欄底部找到「插件圖譜」按鈕並點擊,展開浮動面板。
- 在圖譜視圖中,使用鼠標拖拽節點、滾輪縮放,點擊節點查看詳情(狀態、版本、來源、頻次等)。
- 在技能視圖中查看各技能的調用統計。
- 在緩存分析視圖中查看當前及歷史會話的 Token 使用和成本情況。
注意事項¶
- 環境依賴:該插件依賴 DeepSeek Harness 的 Web Profile 以及 Node.js 環境(要求 >= 22.2)。
- 數據近似:插件的“使用頻次”近似爲會話日誌中插件 ID 的命中次數,並非精確計數。
- 分類規則:分類與項目分組基於內置規則表,非完全自動分類。
- 權限安全:插件以當前 DSH 進程權限運行,安裝前請檢查源碼與許可證。
結尾¶
該插件通過可視化手段梳理了 DSH 的插件生態與資源消耗,適合需要精細化管理和監控 DeepSeek Harness 使用的開發者。更多細節與源碼,請訪問 GitHub。