前言¶
DSH 的輸入框底欄已經顯示上下文用量和 token 速度，但不看計費頁面就不知道當前賬號還剩多少錢。想確認餘額，只能切到充值頁面或者另開一個網頁。h2fe1/dsh-deepseek-account-balance 就是針對這個動作的插件：把當前登錄 DeepSeek 賬號的餘額，作爲一枚很小的標籤放在輸入框下方、上下文用量的右邊。插件不註冊路由，不讀取密鑰，不發起推理請求，屬於客戶端插件。
這是什麼¶
插件由 h2fe1 維護，倉庫地址 h2fe1/dsh-deepseek-account-balance，許可爲 MIT，版本 0.1.1。解決的問題是：在會話界面裏用最小代價看到餘額，而不必離開當前對話。
效果是一行底欄的末尾多出一段：
[1 輪 114 步 · 216 tok/s] [12M tok · 緩存命中 99%] ◔ 19% 餘額 ¥61.48
實現思路¶
插件不自己拿 token，也不請求第三方接口。它直接走 DSH 的 deepseek-account 服務已經暴露的客戶端只讀方法：
| 方法 | 用途 |
|---|---|
account.getState() |
判斷是否已登錄（credential-stored / signed-out） |
account.getBalance(client) |
取 normal_wallets（充值餘額）與 bonus_wallets（贈送餘額） |
請求由 Host 攜帶登錄憑證發往 Platform，頁面拿不到 token，也沒有新增任何 Host 路由。整個過程只讀：不發起推理請求，不改動賬號、額度或訂閱。
安裝與啓用¶
在 DSH Web GUI 裏打開 Plugins → 添加插件 → 安裝第三方插件，填倉庫地址：
https://github.com/h2fe1/dsh-deepseek-account-balance
或者用 Agent 或 CLI 安裝：
dsh plugin --profile <你的 profile> add github:h2fe1/dsh-deepseek-account-balance
裝好後進入任意會話，輸入框下方上下文用量的右側就會出現餘額標籤。頁面可見時每 60 秒自動刷新一次，切回頁面也會刷新。需要 Node ^22.19.0 || >=24.0.0，DSH >=0.2.0-rc.2。
本地開發¶
git clone https://github.com/h2fe1/dsh-deepseek-account-balance.git
dsh plugin --profile <你的 profile> add link:$PWD/dsh-deepseek-account-balance
源碼結構比較直白：
index.js是宿主半，只保留 Loader 行，不註冊路由。client.js是瀏覽器半，負責在conversation.composer.dock裏渲染餘額標籤、讀取賬號 Remote 和格式化顯示。locale/*.json是插件列表裏的標題和描述。
顯示規則與刷新¶
- 已登錄：顯示
餘額 ¥61.48；有贈送額度時只在懸停提示裏顯示贈送 ¥x.xx。 - 未登錄：顯示
餘額 —，懸停提示引導去「設置 → 賬號」登錄。 - 查詢失敗：保留上一次金額並標紅，懸停看具體錯誤，點擊標籤重試。
- 點擊整枚標籤立即刷新。賬號切換或退出登錄會在下一次刷新時反映。
- 金額按 Platform 的兩小數規則顯示；不足一分錢顯示
<¥0.01（負數顯示-¥0.01），多幣種用+連接。 - 字號、顏色與該行其他項一致（12px、tertiary、正常字重）。
- 語言跟隨 DSH 的界面語言（中文 / English）。
- 只在有會話、顯示上下文用量時出現；歡迎頁不佔用空間。
配置與適用場景¶
插件沒有配置項，不讀取任何密鑰，也不要求填寫賬號信息。它依賴 DSH 裏已經登錄的 DeepSeek 賬號，所以適合日常使用 DSH 對話、希望順手看到餘額的用戶；對需要多賬號切換或精確計費的場景，仍然要去計費頁面覈對。
插件以當前 dsh 進程的權限運行，安裝前建議先讀一遍源碼並確認許可證。倉庫提供 CI（test workflow），本地也可用以下命令自檢：
node --test test/*.test.mjs
node --check index.js && node --check client.js
結尾¶
這個插件的價值在於把「看餘額」從一次跳轉變成底欄上的餘光，侵入性低，更新邏輯也簡單。它屬於社區插件目錄裏的客戶端分類，與 DeepSeek / 幻方沒有官方從屬關係。
目錄頁：https://www.skillhub.cn/plugins/h2fe1/dsh-deepseek-account-balance
GitHub：https://github.com/h2fe1/dsh-deepseek-account-balance
