前言¶
用 DeepSeek Harness（DSH）跑 web 會話時，模型調用會消耗 API 額度，本機還會累積 token 統計。若要到控制台或單獨查接口才能知道「還剩多少錢、這次用了多少」，會打斷調試節奏。社區插件 dsh-balance（維護者 liudiw）把餘額與本機 / 平臺用量嵌進聊天窗口右上角，並可在界面內配置憑據，無需爲這一項單獨開終端。
這是什麼¶
dsh-balance 是 DeepSeek Harness 的 bundle 插件：在 web profile 下向 UI 注入緊湊徽章，展示 DeepSeek 賬戶餘額與會話 / 本機 token 用量；展開後可看詳情，並在下拉底部保存 API Key 與平臺 userToken。密鑰寫入 DSH 憑據庫（~/.dsh/.credentials.yaml，權限 0600），服務端接口不回讀明文。當前發佈版本見倉庫 package.json（資料中爲 0.2.0），許可證 MIT。
目錄頁：skillhub.cn/plugins/liudiw/dsh-balance
源碼：github.com/liudiw/dsh-balance
環境要求¶
- 已安裝 DeepSeek Harness，且有一個 web profile（標準
@deepseek-ai/dsh-web-app組合即可，README 寫明不依賴 dsh-worktable）。 - Node.js ≥ 20，與 DSH 運行時一致。
核心功能¶
餘額與用量徽章
聊天窗口右上角顯示緊湊信息：賬戶餘額（人民幣）以及本會話 / 本機累計 token 用量（README 中的展示形式含貨幣與 token 摘要）。
詳情下拉
點擊徽章可查看賬戶餘額、可用狀態、本次會話與本機 tokens，以及（在配置平臺憑據後）平臺賬戶本月與歷史累計用量。
界面內配置
下拉底部提供憑據表單：DeepSeek API Key、平臺 userToken。保存後約 10 秒內可刷新平臺側數據；寫接口經 DSH credentials seam 落盤，每輪請求重新解析，一般無需重啓 dsh web。
刷新與緩存
本機數據約 5 秒刷新；平臺數據 60 秒節流；歷史累計用量有 12 小時磁盤緩存。
數據來源（摘要）
| 數據 | 來源 |
|---|---|
| 賬戶餘額 | api.deepseek.com/user/balance（DEEPSEEK_API_KEY） |
| 本機 token | DSH 會話日誌中 assistant/message 的 usage |
| 平臺本月用量 | platform.deepseek.com/api/v0/usage/amount（需 DEEPSEEK_USER_TOKEN） |
| 平臺累計 | 自 2024-01 起逐月求和，帶 12h 緩存 |
未配置 DEEPSEEK_USER_TOKEN 時，插件仍顯示餘額與本機用量；下拉中保留「去配置」入口。
安裝與啓用¶
目標機已有 web profile 即可。官方 README 給出三種方式，下面以推薦的一條命令爲例。
先做安裝：在目標機執行（命令來自 README，勿自行改成 github:owner/repo 形式）：
dsh plugin --profile web add https://github.com/liudiw/dsh-balance/releases/latest/download/dsh-balance.tgz
再做生效：裝完後重啓 dsh web。若重啓後界面看不到徽章，確認 profile 的 dsh.profile.bundles 已包含 dsh-balance（部分版本的 dsh plugin add 只裝依賴、不自動登記 bundle）；缺失則手動加入後再重啓。仍無顯示時，對瀏覽器做一次硬刷新（Ctrl/Cmd+Shift+R）再判斷。
手動改 profile、本地 link: 開發安裝等步驟見 GitHub README「方式 B / 方式 C」。若 pnpm install 出現 ERR_PNPM_MISSING_TARBALL_INTEGRITY，README 說明可刪 lock、改用 file:./dsh-balance.tgz 再安裝。
典型用法：首次配置憑據¶
憑據建議在 GUI 完成，無需命令行寫密鑰。
- 點擊聊天窗口右上角餘額徽章，打開下拉，進入底部 配置憑據。
- DeepSeek API Key：若 DSH 已用於跑 LLM，通常已有配置，可留空；若爲空，粘貼
sk-...。 - 平臺 userToken：登錄 platform.deepseek.com，在瀏覽器開發者工具 Console 執行
copy(localStorage.getItem('userToken'))，將返回 JSON 的value字段粘貼到表單。 - 點擊「保存配置」。保存後密鑰寫入
~/.dsh/.credentials.yaml；約 10 秒內徽章可顯示平臺本月 / 累計用量。
插件暴露的 HTTP 接口包括 GET /api/balance（快照）、GET/POST /api/balance/config（配置狀態與寫入）。POST 須帶請求頭 x-dsh-balance-config: 1，用於降低跨源僞造風險。若 API Key 來自只讀來源（如環境變量），界面會提示 writable: false 且拒絕改寫。
適用場景與注意¶
適合誰
長期在 DSH web 裏對話、調智能體，希望隨時對照餘額與本機 / 平臺 token，又不想頻繁切到 DeepSeek 控制台的用戶。
運行與信任邊界
插件與當前 dsh web 進程同權限運行，會調用 DeepSeek 官方與平臺接口並讀寫本機憑據文件。安裝前應在 GitHub 閱讀 lib/index.js、lib/client.js 與許可證；社區目錄 skillhub.cn 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。
常見問題（摘自 README）
徽章不出現：硬刷新 → 確認 bundle 與重啓。平臺用量顯示「—」：檢查 userToken 是否過期並在下拉里重填。整個 dsh web 起不來：排查 profile 中 dsh-balance 依賴是否可解析（例如 link: 目錄被移動）。改了 profile 不生效：確認編輯的是運行中的 DSH_HOME 下 profile（默認 ~/.dsh，也可能是 ~/.config/dsh）。
結尾¶
經過上面的步驟，dsh-balance 把「還剩多少錢、用了多少 token」收進聊天界面一角，並把憑據配置留在同一下拉里。需要安裝包與接口細節時，以倉庫 README 爲準。
- 目錄頁：https://www.skillhub.cn/plugins/liudiw/dsh-balance
- GitHub：https://github.com/liudiw/dsh-balance
