前言¶

DeepSeek Harness（DSH）採用插件化架構。開發者在 Web 端使用時，往往需要直觀瞭解 API 消費、賬戶餘額以及 Token 的具體構成。現有的方式可能需要切換到官方控制台或查看本地日誌，不夠直觀。dsh-plugin-usage 插件通過讀取本地會話日誌全量重建數據，按 DeepSeek 官方峯谷價估算費用，直接在 DSH 界面上提供看板。

插件定位¶

這是一個由 1998moye 維護的客戶端插件，遵循 MIT 協議。它集成在 DSH 輸入框工具條中，不做懸浮窗，不會覆蓋對話內容。

安裝與啓用¶

安裝前請確保環境滿足要求：
* Node.js 20+
* DSH 0.1.5 及以上版本

執行以下命令進行安裝：

git clone https://github.com/1998moye/dsh-plugin-usage.git
dsh plugin --profile web add /path/to/dsh-plugin-usage

安裝後需要重啓 dsh web 進程，並在瀏覽器中強制刷新（Ctrl+F5 / Cmd+Shift+R）以加載插件。

核心功能¶

插件提供以下核心能力：

• 全量歷史重建：啓動時掃描 $DSH_HOME/sessions/**/session.jsonl.zstd，重建包含插件安裝之前的用量歷史。
• 賬戶餘額查詢：直連 DeepSeek 官方接口查詢餘額，區分充值餘額與贈送餘額。
• 峯谷分時計價：根據北京時間計算高峯/空閒時段，按不同模型和計費項（輸入/輸出/緩存）應用不同單價。
• 請求與 Token 統計：統計 API 請求次數，並按“未命中緩存”、“命中緩存”、“輸出”拆分 Token 明細。
• 趨勢圖表：提供近 7 天或近 30 天的消費趨勢圖。
• 分組明細：支持按模型或 API Key（provider）分組查看明細。

使用方法¶

插件按鈕集成在輸入框工具條右側，與“完全權限”、“模型選擇”等控件在同一行。當有活躍會話時，按鈕會顯示今日消費金額。
點擊按鈕即可彈出看板。看板包含以下操作：

• 時間維度切換：今日 / 本週 / 本月 / 全部（本週從週一算起，本月從 1 號算起，均爲北京時間）。
• 指標查看：消費金額、API 請求次數、Token 消耗。
• 頁籤切換：
  • Token 頁籤：查看未命中、命中、輸出的佔比。
  • 餘額頁籤：查看充值與贈送餘額。

數據來源與計費邏輯¶

插件數據完全來源於本地日誌。日誌落盤於 $DSH_HOME/storages/用量看板.json，只記錄數值型 Token 和費用，不含對話內容。
餘額查詢由宿主進程發起，API 密鑰取自 DSH 憑據，不會下發到瀏覽器。
費用計算基於官方定價估算，包含峯谷分時邏輯。緩存命中價格通常遠低於未命中價格。

注意事項¶

• 日誌依賴：可統計範圍取決於本地日誌，日誌被清理的時段無法補出。若官方面板顯示區間大於本地日誌覆蓋範圍，兩者對不上是正常的。
• 計費差異：費用爲按 token 與官方單價估算，與賬單實際扣費可能因官方調價、贈送餘額抵扣順序而略有差異。
• 數據緩存：餘額查詢結果緩存 30 秒。
• 維度說明：明細裏的“API Key”維度實際是 provider。DSH 會話日誌中只有 provider 字段，無法區分同一 provider 下的不同 Key。
• 按鈕顯示：插件按鈕只在有會話時顯示，歡迎頁沒有輸入工具條，因此按鈕不會顯示。

總結¶

該插件通過本地日誌重建和官方定價估算，爲 DSH Web 用戶提供了透明的用量與費用監控能力，適合需要精細控制 API 消費成本的智能體開發者。項目源碼位於 GitHub。