前言¶
DeepSeek Harness（DSH）採用插件化架構，允許開發者擴展功能。在 DSH 設置面板中直接查看 DeepSeek 平臺的餘額與用量，或管理 OpenCode Go 配額，通常需要打開瀏覽器或編寫腳本。dsh-account-usage 插件在 DSH 的設置面板新增了「賬戶」頁，提供一站式查看 DeepSeek 平臺餘額/用量與 OpenCode Go 配額的能力。該插件由 Ycet 維護，採用 MIT 許可證。
功能特性¶
- DeepSeek 平臺概覽：展示充值餘額、贈送餘額、累計消費金額、本月消費金額及本月 Tokens。
- 每日柱狀圖：提供消費金額與 Token 消耗的雙圖表，支持 SVG 渲染與鼠標懸停查看每日明細。
- 時間維度切換：支持今天、近 7 天、近 30 天、近 90 天、本月、上月，以及自定義時間區間。
- 按模型明細表：展示所選區間內各模型的請求次數、輸入/緩存/輸出 Tokens 與費用。
- OpenCode Go 配額：展示 5 小時滾動、每週、每月三個窗口的用量百分比、下次重置時間及限額參考。
- 自動刷新：頁面掛載期間每 60 秒自動輪詢最新數據。
- 雙語言界面：支持完整的中英文切換。
安裝與啓用¶
安裝前請確保已安裝 DSH CLI。
- 執行以下命令安裝插件：
dsh plugin --profile web add github:Ycet/dsh-account-usage
- 安裝完成後，重啓網頁應用：
dsh web
- 打開設置面板，刷新頁面，即可看到新增的「賬戶」頁。
配置說明¶
DeepSeek 平臺令牌¶
DeepSeek 平臺用量接口爲未公開的私有接口，需要你的平臺登錄令牌：
- 登錄 https://platform.deepseek.com。
- 打開瀏覽器 DevTools → Console，執行：
JSON.parse(localStorage.getItem('userToken')).value
- 在插件「賬戶」頁的令牌輸入框粘貼並保存。令牌僅寫入本機憑據庫（
~/.dsh/.credentials.yaml的DEEPSEEK_PLATFORM_TOKEN字段），不發送至任何外部位置。
OpenCode Go Key¶
通常無需手動配置，插件會按以下順序自動查找：
- DSH 憑據
OPENCODE_GO_API_KEY（通常在「設置 → 模型」中配置）。 - OpenCode 自身的
~/.local/share/opencode/auth.json（opencode-go條目，type 爲api）。
使用說明¶
- 在設置面板「賬戶」頁頂部切換 deepseek 或 opencode go 標籤查看對應數據。
- DeepSeek 頁：點擊時間維度（今天、近 7 天等）或選擇「自定義區間」後點擊「應用」。柱狀圖支持鼠標懸停查看每日明細；模型明細表展示請求次數、Tokens 與費用。
- OpenCode Go 頁：展示三個配額窗口的用量進度條、重置時間與限額參考。頁面掛載期間每 60 秒自動刷新。點擊「跳轉」按鈕可前往 opencode.ai，點擊「刷新」按鈕可手動更新數據。
- 點擊「打開配置文件」按鈕可直接定位本機 DSH 憑據文件。
注意事項¶
- 接口穩定性：DeepSeek 平臺用量接口爲私有接口，字段可能隨平臺升級變化。插件對響應做防禦式解析，字段缺失時顯示「—」而非報錯。
- 字段估算：公開文檔未包含「累計消費金額」和「API 請求次數」。插件通過命名啓發式在概要響應中搜索累計消費（找不到顯示「—」），並讀取模型條目上的
count/requests/request_count/req_count/calls字段獲取請求次數。 - 限額參考：OpenCode Go 的限額（\(12/\)30/$60）爲套餐參考值，端點未返回限額。套餐調整時以 opencode.ai 頁面爲準。
- 網絡訪問：服務綁定
0.0.0.0時本插件路由對局域網可達（與 DSH 其他本地插件相同的既有限制，默認127.0.0.1無此問題）。 - 本地安全：令牌僅存儲在本機憑據庫，瀏覽器與網絡請求均不攜帶它往返上游以外的任何位置。
