前言¶
用 DeepSeek Harness 跑智能體時，一個常見問題是「餘額用到哪了」。切到網頁後臺看剩下的錢，來回切換打斷思路；只看 API key 的賬，又不能反映 OAuth 登錄賬戶裏的實際餘額。dsh-account-balance（npm 包名 dsh-balance-ball）把這個問題搬到了 DSH 界面裏：一個常駐的可拖動懸浮球，顯示 DeepSeek 賬戶餘額，點開還能看到實時價格、今日價格走勢和 token 消耗估算區間。
下面介紹這個插件的定位、安裝和用法。
這是什麼¶
dsh-account-balance 是 DeepSeek Harness 的插件，由 StarRob1n 維護，MIT 協議，npm 包版本 0.1.4。它解決的是一件事：在不離開 DSH 的情況下，隨時知道賬戶餘額還剩多少、還能用多久。
數據來源需要注意：它讀的是 deepseek-account（平臺 OAuth 登錄）的賬戶餘額，包含充值錢包和贈送錢包，不是 API key 餘額。如果你只配了 API key、沒有賬號登錄，餘額會顯示不可用。
核心功能¶
懸浮球本身是圓形、可拖動、可固定的，顏色隨餘額狀態變化：綠色代表充足，黃色代表餘額少於 10 元，紅色代表耗盡。這樣掃一眼顏色就知道要不要充值，不需要點開面板。
點擊懸浮球展開詳情面板，包含四部分：
1、賬戶餘額：充值錢包 + 贈送錢包（OAuth 登錄專用）。
2、實時價格：從 DeepSeek 官方定價頁（api-docs.deepseek.com）抓取 Flash / Pro 的輸入輸出單價。
3、今日價格走勢：折線圖展示一天內高峯/空閒時段的價格變化，並標註當前所處時段。
4、消耗估算區間：按緩存命中與否給出「還能用多少 token」的樂觀~悲觀區間。
價格每 6 小時自動刷新一次，面板內有「刷新」按鈕可以手動更新。抓取失敗時會回退到內置的兜底參考價，並在面板上明確標註，不會靜默顯示錯誤數字。
安裝與啓用¶
官方提供兩種安裝方式。
方式一，從 npm 安裝：
dsh plugin add dsh-balance-ball
方式二，從 GitHub 安裝：
dsh plugin add github:StarRob1n/dsh-account-balance
如果你的 DSH profile 不叫默認名字，加上 --profile <名字> 指定。profile 名字就是 ~/.dsh/profiles/ 下的目錄名。
安裝完成後重啓 DSH，右下角會出現懸浮球。
典型用法¶
安裝並重啓後，插件自動出現在界面右下角，沒有額外的配置文件需要寫。日常使用分兩種情況：
1、查看餘額：看一眼懸浮球顏色，或點擊展開面板，看充值錢包和贈送錢包的具體金額。
2、判斷還能用多久：展開面板，參考消耗估算區間。這個估算假設輸入:輸出 ≈ 3:1，給出「全緩存命中 ~ 全未命中」的區間，實際消耗介於兩者之間，因此只能當作量級參考，不能當作精確賬單。
適用場景與注意事項¶
適合同時滿足兩個條件的開發者：一是用 DSH 作爲日常智能體界面，希望在寫代碼或調試時順手看到餘額；二是有 DeepSeek 平臺賬號登錄（OAuth），而不是隻用 API key。
還有幾點需要提前知道：
- 插件以當前 DSH 進程的權限運行，安裝前應檢查源碼與許可證（MIT），確認來源倉庫後再裝入 profile。
- 兼容性要求 DSH >= 0.2.0、Node >= 20，node 版本不夠時安裝會失敗。
- 腳本讀取的是平臺登錄賬戶餘額，與 API key 的計費是兩套體系，不要把兩者混在一起判斷「還剩多少錢」。
小結¶
dsh-account-balance 的定位很窄：一個常駐的餘額指示器，附帶價格抓取和粗粒度的消耗估算。它不替代賬單系統，也不能用於精確預算，但勝在不打斷工作流。如果你已經在用 DSH 且有 OAuth 登錄，裝一個試一次就能看出是否有用。
目錄頁：https://www.skillhub.cn/plugins/StarRob1n/dsh-account-balance
GitHub：https://github.com/StarRob1n/dsh-account-balance
npm：https://www.npmjs.com/package/dsh-balance-ball
