前言¶
DeepSeek Harness (DSH) 依賴插件擴展功能。在日常開發或使用中，需要直觀地掌握當天的 Token 消耗、緩存命中率以及賬戶餘額情況。dsh-plugin-duwg 插件通過在輸入框下方掛載一個小部件，聚合當日所有會話的 Token 消耗，並提供緩存命中率與餘額的可視化展示。
是什麼¶
該插件由開發者 Yolotd 維護，屬於客戶端插件。它解決的核心問題是：在 DSH 使用過程中，無法快速看到當天精確的 Token 統計與餘額狀態。插件通過讀取本地會話日誌和網關透傳數據，實現數據的聚合與展示。
核心功能¶
該插件提供以下功能：
- 今日總消耗：彙總當天所有會話的 input（輸入）、output（輸出）、cache-read（緩存讀取）和 cache-write（緩存寫入）的 Token 總數。
- 會話日誌校準：插件啓動時，會掃描
$DSH_HOME/sessions目錄下的.l.zstd文件進行校準，確保數據在進程重啓或崩潰後不丟失。 - 萬/億簡化顯示：大數字會自動轉換爲“萬”或“億”的簡寫形式，鼠標懸停可查看精確數值。
- 緩存命中率：實時顯示緩存讀取佔總量的比例，以綠色數字呈現。
- 餘額血條：顯示 DeepSeek 賬戶當前餘額與當天最高餘額。餘額較低時會變紅提示。
- 預計消耗：基於網關透傳的
usage.cost字段進行累計計算。 - 持久化：數據被寫入
$DSH_HOME/storages/duwg/usage.json文件，支持跨進程保留與跨天自動重置。
安裝與啓用¶
安裝前請確保已安裝 DSH。通過以下命令安裝插件：
dsh plugin --profile web add dsh-plugin-duwg
或者從本地倉庫/源碼安裝：
dsh plugin --profile web add <本倉庫路徑或 git URL>
安裝完成後，重啓 dsh web，小部件會自動出現在輸入框下方。
安全與隱私¶
該插件對隱私和安全性有明確的設計原則：
- API Key 安全：API Key 僅存在於 host 端，絕不進入瀏覽器環境。
- 網絡請求：餘額查詢僅調用 DeepSeek 官方接口，並帶有 60s 緩存以降低調用頻率。無任何第三方網絡請求或遙測行爲。
- 本地掃描：會話日誌掃描僅讀取本地
$DSH_HOME/sessions下的文件，用於校準用量，不對外發送數據。
適用場景¶
該插件適合需要在 DSH 界面中實時監控 Token 成本與緩存效率的開發者或用戶。由於數據基於本地文件和官方接口計算，無需擔心雲端數據泄露問題。
結語¶
dsh-plugin-duwg 通過輕量級的 UI 組件，將分散的 Token 消耗與餘額信息聚合展示。對於關注成本控制或緩存優化的人員，該插件提供了直觀的參考數據。
- 目錄頁: https://www.skillhub.cn/plugins/Yolotd/dsh-plugin-duwg
- GitHub: https://github.com/Yolotd/dsh-plugin-duwg
