前言¶
DSH (DeepSeek Harness) 插件化系統允許通過插件擴展功能。常規的用量統計插件通常基於本機會話日誌，無法覆蓋網頁端、手機 App 或其他客戶端產生的調用。dsh-usage 插件通過直接調用 DeepSeek 平臺官方接口，在 DSH Web GUI 中展示賬戶的全量餘額與 Token 用量。
核心功能¶
- 餘額：自動讀取 DSH 憑證，調用
api.deepseek.com/user/balance接口，顯示總額、充值及贈送餘額。 - Token 用量（賬戶全量）：調用平臺官方
api/v0/usage/by_api_key/{amount,cost}接口，顯示緩存命中/未命中/輸出 Token 及對應費用。 - 時間範圍：支持 24 小時、7 天、30 天、90 天切換，提供堆疊柱狀圖與明細表。
- 模型工具：註冊
deepseek_usage_query模型工具，大模型可直接查詢餘額與用量。 - 令牌持久化：令牌保存至
~/.dsh/dsh-usage-token，重啓 DSH 後自動讀取，無需重複配置。
安裝與啓用¶
在終端執行以下命令完成安裝：
dsh plugin --profile web add "github:Huasecc/dsh-usage#main"
安裝完成後，重啓 Web 配置生效。
首次配置：獲取平臺令牌¶
插件需獲取 DeepSeek 平臺會話令牌才能訪問數據。首次使用時需按以下步驟操作：
1. 瀏覽器登錄 https://platform.deepseek.com/usage。
2. 按 F12 打開控制台，執行以下代碼獲取令牌：
JSON.parse(localStorage.getItem('userToken')).value
- 將輸出的令牌粘貼到插件的設置頁「平臺用量訪問令牌」中並保存。
工作原理與注意事項¶
- 數據來源：數據來源於 DeepSeek 平臺官方接口，包含賬戶全量數據（網頁、手機、其他客戶端），不限於本機會話。
- 令牌類型：需要的是網頁控制台會話令牌（
localStorage的userToken），而非 API Key。 - 依賴環境：由於
platform.deepseek.com部署了 WAF，請求需攜帶瀏覽器頭（UA/Accept/Origin/Referer）以繞過攔截。 - 安全說明：插件僅讀取你自己的 DSH 憑證和平臺令牌，分發包內不含任何密鑰。
總結¶
該插件解決了 DSH 環境下查看全量賬戶用量的問題，適合需要統一監控所有渠道消耗的用戶。如需查看賬戶真實花費，建議安裝使用。
