前言¶
DeepSeek Harness (DSH) 的設計理念是“一切皆插件”。在本地開發和調試過程中，準確追蹤 Token 消耗是評估成本和優化模型調用的關鍵。現有的 DSH 會話記錄通常僅在當前進程運行時有效，重啓後即丟失。dsh-token-usage-sidebar 插件解決了這個問題，它從 DSH 的提供商運行時獲取使用記錄，並將這些數據持久化存儲在本地 SQLite 數據庫中，提供側邊欄摘要和原生設置頁面兩種查看方式。
核心功能¶
該插件提供了以下具體功能：
- 側邊欄摘要：在 DSH 界面側邊欄顯示今日、昨日和生命週期的總計 Token 使用情況。
- 原生設置頁面：在 DSH 設置菜單中提供“Token Usage”頁面，支持詳細的指標展示。
- 詳細指標卡片：支持 Compact 模式展示 Total（總計）、Input（輸入）、Output（輸出）、Cache（緩存）、Reasoning（推理）和 Calls（調用次數）。
- 時間範圍選擇：支持 Today（今日）、Yesterday（昨日）、7D（最近 7 天）和 All time（全部時間）的選擇。
- 動態過濾：提供商和模型列表直接從 DSH 實際數據中提取，不依賴硬編碼的預設列表。
- 本地持久化：使用 SQLite 日記賬進行存儲，支持 WAL 日誌，確保寫入延遲穩定。
- 關機安全：在 DSH 關閉前會刷新未保存的數據，防止意外丟失。
- 歷史恢復與去重：從 DSH 會話記錄中恢復歷史數據，並執行去重處理，確保每個調用只被計算一次。
安裝與啓用¶
通過 DSH CLI 安裝到 web 配置文件：
dsh plugin --profile web add @y2zyyr/dsh-token-usage-sidebar
安裝後需要重啓 dsh web 服務以加載插件。
使用說明¶
- 查看統計：在 DSH 界面左側側邊欄即可看到今日、昨日和總量的概覽。
- 查看詳情：進入 DSH 設置菜單，在“Token Usage”頁面查看更詳細的指標卡片。
- 篩選數據：在詳情頁面選擇時間範圍（如 7D），下方的指標卡片和表格會根據該範圍內的實際數據動態篩選對應的提供商和模型。
注意事項¶
- 這是一個社區插件，並非 DeepSeek 官方插件。
- 插件使用提供商/運行時報告的數據進行統計，而非基於分詞器的估算。
- 卸載插件不會清除本地已持久化的 SQLite 記賬數據。
- 歷史報告是誠實的，會明確顯示源掃描狀態和歷史覆蓋率。
總結¶
該插件通過 SQLite 日記賬實現了穩定的本地統計，適合需要長期追蹤 Token 消耗的開發者。更多細節可查閱項目主頁或 GitHub 倉庫。
