在使用 DeepSeek Harness 進行模型推理或開發時，按月追蹤 API key 的 token 消耗是常見需求。現有方式要麼依賴雲端統計，要麼統計維度單一。下面介紹一款專注於本地數據的側邊欄月度 Token 統計插件。
是什麼¶
這是一款 DeepSeek Harness 插件，用於在側邊欄顯示指定 API key 在日曆月度的 token 使用量。該插件由 greyhackintoch-dev 維護，採用 MIT 許可證，僅讀取本地數據，並在每月 1 日 00:00 自動重置計數。
核心功能¶
該插件主要解決“本地化月度統計”的需求，具體能力如下：
- 側邊欄展示：在設置上方顯示日曆月度的 API key token 使用量。點擊該行可查看明細，包括各來源（DSH home、opencode、Pen、WorkBuddy）的貢獻。
- 多數據源統計：支持統計此 DSH home、opencode、Pen 和 WorkBuddy 的使用情況。
- 本地化與重置：僅讀取本地數據，不發送網絡請求。計數器在每月 1 日 00:00 重置。
- 跨設備彙總：支持通過
trackKeys配置，將同一密鑰在不同機器上的使用量彙總爲單數。
安裝與啓用¶
需通過命令行安裝該插件。安裝後必須重啓 dsh web 才能生效。
dsh plugin --profile web add github:greyhackintoch-dev/dsh-month-tokens
典型用法¶
安裝完成後，側邊欄會出現 Token 統計行。若希望將“機器計數”變爲“密鑰計數”，即彙總同一密鑰在多臺設備上的用量，需配置 trackKeys。配置後，同一密鑰在不同設備上的使用量將基於密鑰指紋合併顯示。
適用場景與注意¶
- 僅支持 Web Profile：該插件僅支持
web瀏覽器外殼，不支持官方的 DSH Desktop app。第三方封裝了 Web profile 的桌面客戶端可以正常使用。 - 不統計 web-search：web-search 路徑直接向提供商發送請求且不記錄，因此該插件無法統計該路徑的用量。
- 計數爲 floor（下限）：由於依賴本地記錄，插件統計的是能讀取到的部分，即“下限”而非“總數”。對於未在本地留下記錄的調用（如腳本或未記錄的 IDE），不計入統計。
- 依賴重啓：安裝命令執行後，插件會寫入配置文件，但需手動重啓
dsh web界面才能看到效果。
總結¶
該插件爲本地化月度統計提供了可落地的方案，能夠清晰展示各組件的使用情況。若需瞭解詳情或獲取源碼，可查閱相關目錄頁或 GitHub 倉庫。
