前言¶

在 DSH Web 中使用模型時，餘額和本地 Token 用量分散在不同來源。dsh-usage-lite 爲 DeepSeek Harness Web 界面提供一個側邊欄面板，用於集中查看 DeepSeek 餘額、供應商賬戶和近半年本地用量。下面介紹它的能力、安裝方式和邊界。

這是什麼¶

dsh-usage-lite 是 ericw0315 維護的 DSH 客戶端插件，許可證爲 MIT。它面向 DeepSeek Harness Web 界面，把 DeepSeek 餘額查詢與本地 Token 用量聚合放在同一個入口中。

核心功能¶

• 在側邊欄快速查看餘額。
• 展開後查看供應商賬戶與近半年用量。
• 自動發現 DSH 已配置的模型供應商，並逐行展示。
• 查詢 DeepSeek 當前餘額、贈送額度和充值額度。
• 支持刷新、隱藏餘額，以及選擇摺疊態默認賬戶。
• 彙總輸入、輸出、緩存讀取和緩存寫入 Token。
• 按供應商與模型展示 Token 和估算開銷。
• 展示最近 27 周的每日用量熱力圖。
• 點擊日期查看當日 Token 與估算開銷。
• 跟隨 DSH Web 的中英文界面。

安裝與啓用¶

需要已安裝並能夠運行 dsh web 的 DeepSeek Harness 環境。

dsh plugin --profile web add dsh-usage-lite

先執行上面的安裝命令，再重啓正在運行的 dsh web，最後在瀏覽器中硬刷新。

更新插件：

dsh plugin --profile web update dsh-usage-lite

卸載插件：

dsh plugin --profile web remove dsh-usage-lite

配置與常見狀態¶

插件會自動發現 DSH 已配置的模型供應商，並用於餘額和用量展示。若要讓 DeepSeek 餘額可用，可以在 DSH 憑據文件中配置：

# ~/.dsh/.credentials.yaml
DEEPSEEK_API_KEY: sk-your-key-here

確認 llm-deepseek 的 apiKeyEnv 與 ~/.dsh/.credentials.yaml 中的鍵一致，然後重啓 dsh web。

使用中需要注意：

• 當前僅 DeepSeek 支持餘額查詢；其他供應商暫不支持額度查詢，但仍可出現在用量聚合中。
• 用量依賴 DSH 會話事件中的 data.usage 和模型來源字段；沒有相應事件時，對應明細可能爲空。
• 開銷由內置價格表估算，未知模型當前按 deepseek-chat 價格估算；應以供應商實際賬單爲準。
• 不要將真實 API Key 提交到 Git、公開 Issue 或日誌中。

隱私與運行邊界¶

• API Key 通過 DSH credentials 在服務端解析，不會發送到插件客戶端。
• 插件服務端接口只接受本機迴環地址發起的 GET 請求。
• 項目不包含遙測、用戶跟蹤或遠程分析服務。
• 插件以當前 dsh 進程權限運行；安裝前建議檢查源碼與 MIT 許可證。

適用場景¶

dsh-usage-lite 適合已經使用 dsh web 的開發者，尤其是需要在瀏覽器側邊欄集中查看 DeepSeek 餘額、供應商 Token 用量和近半年趨勢的場景。如果需求是跨供應商餘額統一查詢，它目前只覆蓋 DeepSeek 的餘額查詢，其他供應商仍主要依賴 DSH 自身的用量事件聚合。

鏈接¶

• 目錄頁：https://www.skillhub.cn/plugins/ericw0315/dsh-usage-lite
• GitHub：https://github.com/ericw0315/dsh-usage-lite