前言¶
DeepSeek Harness 本身不保留跨會話的用量視圖，會話一刪歷史消耗就查不到。dsh-usage-stats 是一個本地用量統計插件，將每次模型調用的四類 token 記入 SQLite 賬本，按 天 × 服務商 × 模型 分桶。它只統計用量，不做費用計算，適合需要區分主對話與內部調用（壓縮、摘要等）的開發者。
核心功能¶
- 本地 SQLite 賬本：數據存儲在
$DSH_HOME/storages/usage-stats/。 - 分桶統計：按 天 × 服務商 × 模型 分桶，統計輸入、輸出、緩存命中、緩存讀寫。
- 調用區分：區分 主對話 與 DSH 內部調用（壓縮、摘要等）。
- 歷史回溯：支持回溯插件安裝前的歷史會話數據。
- 權限控制：僅本地 loopback 訪問，無憑據/會話內容訪問權限。
安裝與啓用¶
插件僅支持 Web GUI profile (dsh web)，安裝後需重啓服務。
- 安裝
dsh plugin --profile web add @lengduan/dsh-usage-stats
- 升級
dsh plugin --profile web update @lengduan/dsh-usage-stats
- 禁用（保留賬本）
在dsh web的cordis.patch.yml中覆蓋：
- id: usage-stats
disabled: true
- 移除（保留賬本）
dsh plugin --profile web remove @lengduan/dsh-usage-stats
使用方法¶
- 安裝並重啓
dsh web。 - 打開任意一個已有對話的會話。
- 在會話視圖頂部切換到「用量統計」tab。
- 默認顯示「今日 · 全部口徑」的數據。
- 通過時間範圍（今日/本週等）和口徑（全部/對話/內部）篩選數據。
- 點擊服務商行可摺疊查看其下的模型明細。
- 點擊「刷新」重新取數。
適用場景與注意¶
- 適用場景：需要按天或按模型覈對 token 消耗，並且需要把「主對話」與「DSH 內部調用」分開看的人。
- 不支持：TUI / headless 環境（沒有 Web 的 slot 可掛），需要算錢（這裏只有 token，不乘單價），跨機器彙總（賬本是單機文件）。
- 遠程訪問：遠程訪問依賴
@linxin666/dsh-remote-web-ui的配對門控通道。若未安裝該插件或未配對，局域網直連/usage/api會返回403錯誤。 - 卸載行爲：卸載不會刪除本地賬本，要清空歷史需手動刪除
$DSH_HOME/storages/usage-stats/目錄。
