前言¶
同時接了多家模型之後，很難回答一個具體問題：這個小時、這個模型、這個 provider 燒了多少 token。登各家控制台只能看到總額，接 Langfuse / Helicone 一類平臺要改代碼、請求要出網，自己寫腳本解析日誌又沒有界面、下鑽困難。下面介紹的 dsh-api-usage-dashboard 走另一條路：插件直接讀 Harness 自己的會話記錄，裝完在左側邊欄出用量面板，不配接口、不貼 key、不出網。它由 LENS-Views 維護，在社區插件目錄中歸爲客戶端分類。
這是什麼¶
dsh-api-usage-dashboard 是 DeepSeek Harness（DSH）插件。裝完後側邊欄多一個柱狀圖圖標，點開是模型 API 用量儀表盤：每個 provider、每個模型、每小時的調用次數與 token 數。數據來源是 Harness 的會話日誌，之後新接的 provider 在第一次調用時會自動出現在圖裏，不需要額外登記。
包名就是 dsh-api-usage-dashboard，截至成稿時版本爲 1.0.2，MIT 許可，零運行時依賴，要求 Node >= 20。作者署名包括 LENS-Views 與 DSH Agent（deepseek-flash），後者以純文本方式署名。
核心功能¶
以下能力均來自 README 已實現項：
- 24 小時柱狀圖：固定 00:00–23:00 全刻度，沒有調用的小時保留空槽，圖形不會因”一天只有幾小時”而失真。
- 按天鑽取：日期選擇器加最近 7 天快捷標籤。
- 懸停顯示虛線定位線與氣泡（時間段 / tokens / 請求數），點擊可釘住柱子對照。
- Tokens / 請求次數一鍵切換，Y 軸自動取整（1/2/5×10ⁿ）並帶網格線。
- 每個 provider、每個模型各有固定顏色，顏色貫穿卡片、迷你圖和明細表；tokens 用藍，請求用琥珀。
- 每個模型一張 24 小時迷你柱圖，便於看哪個在燒 token。
- 明細表：provider 彙總加模型明細，含調用、輸入、緩存、輸出、合計、佔比。
- 跟隨宿主主題、中英雙語、60 秒自動刷新。
安裝與啓用¶
README 給出的安裝方式是在 DSH 的插件管理器裏走 install_bundle，不是命令行直接拼包名：
# 在 DeepSeek Harness 的插件管理器裏選擇 install_bundle
dsh-api-usage-dashboard
1、打開 DSH 插件管理器，選 install_bundle
2、輸入包名 dsh-api-usage-dashboard（已發佈到 npm），也可以指向本地目錄
3、側邊欄點柱狀圖圖標，完成
首次打開會掃一遍全部會話日誌。README 給的參考是 23 個會話約 1–2 秒，之後走緩存，基本秒開。
不用 npm 時，README 另外給了兩個入口：把倉庫拷到本地用目錄路徑安裝，或直接在 install_bundle 裏填 github:LENS-Views/dsh-api-usage-dashboard。倉庫是 public 的，沒有構建步驟。
配置¶
cordis.patch.yml 的 config 三項全部有默認值，不改也能用：
- insert:
- id: api-usage-dashboard
name: 'dsh-api-usage-dashboard'
config:
cacheTtlMs: 20000 # 掃描結果緩存（毫秒），0 = 每次重掃
maxSessions: 0 # 只掃最近 N 個會話，0 = 全部
scanConcurrency: 4 # 併發讀取會話數（1–8）
改宿主代碼後，用插件管理器把 api-usage-dashboard 這一行關一次再開即可熱重載；改瀏覽器代碼刷新頁面。
統計口徑¶
| 指標 | 含義 |
|---|---|
| 調用次數 | 會話裏記錄的模型調用條數，含壓縮摘要等非對話調用 |
| 輸入 tokens | 未命中緩存的輸入（inputTokens） |
| 緩存 tokens | 命中提示緩存的輸入（cacheReadTokens） |
| 輸出 tokens | 模型生成（outputTokens） |
| 合計 tokens | totalTokens = 輸入 + 緩存 + 輸出 |
同一 provider 下按模型分行；不同 provider 即使模型同名也分開統計。
隱私邊界¶
- 只讀本機
~/.dsh/sessions下的會話日誌 - 不讀取、不轉發任何 API key
- 不向任何外部服務發請求
- 只註冊一個
127.0.0.1路由，非本機請求直接 403
適用場景與注意¶
適合已經在 DSH 裏跑了多家模型、想按 provider 和模型看小時級用量的人。它統計的是 Harness 實際發出的調用，繞過 Harness 的請求不會出現在圖裏；這也是它”不會算錯”的前提。
兩點要注意。第一，插件以當前 DSH 進程身份運行，可以讀取整個 ~/.dsh/sessions，安裝前應先覈對源碼與許可證，確認這個數據範圍符合預期。第二，README 明確說明還沒有金額（¥）字段，需要每個 provider 的單價才能補上；而自建網關通常不公開牌價，所以目前沒有這一列。
小結¶
它的價值在於零配置：直接讀現有會話日誌做聚合，而不是維護並行計數器，避免與宿主漂移。目錄頁與源碼：
- 目錄頁：https://www.skillhub.cn/plugins/LENS-Views/dsh-api-usage-dashboard
- GitHub：https://github.com/LENS-Views/dsh-api-usage-dashboard
