前言¶
在 DSH Web 里長時間跑對話時，錢包餘額和 token 消耗往往要切到別處查看；社區裏較早的 Balance Whale 小部件以中文界面爲主，對默認使用英文界面的開發者不夠友好。下面介紹 Balance Whale Intl（dsh-balance-whale-intl）：在保留「看板娘 + 實時餘額 + 會話用量 + 輪次費用提示」的前提下，默認英文，並可在設置裏切回簡體中文。
這是什麼¶
Balance Whale Intl 是面向 DSH Web UI 的客戶端插件，維護者爲 Biggy1606，在 DSH 插件目錄 中歸類爲客戶端。它 fork 自 DeepSeek Balance Whale Widget（上游以中文爲主），獨立維護，與上游作者無隸屬或背書關係。
插件在瀏覽器裏展示可拖拽的角色與錢包卡片；餘額查詢在 DSH 宿主進程完成，用量來自 DSH 會話日誌中的真實 token 計數，費用爲按 DeepSeek 標價估算，不含折扣與匯率差異。
核心功能¶
語言與界面¶
- 默認 English，完整 簡體中文 可在 Settings → Appearance → Language 切換（標籤、提示、日期、餘額錯誤文案等一併切換）。
- 錢包卡片可拖標題欄移動，雙擊標題欄重新居中；位置會記住。
- 角色可拖動、貼邊吸附，靠左時會自動鏡像。
餘額與用量¶
- 實時錢包：若同時存在 CNY 與 USD 錢包，分別展示。
- 用量統計：今日、當前對話、上一輪、上一條消息，基於 DSH session logs 的 input / cached / output token。
- 費用估算：可按 Auto、CNY 或 USD 顯示標價估算；錢包餘額展示本身保持自動模式。
- 餘額不可用（未配置密鑰或未登錄）時，用量統計仍可用。
交互與外觀¶
- 可選輪次費用氣泡、提問/審批提示音、角色旁等待提示。
- 音效預設：Duck、FX1、Minecraft orb、Task-end A、Cost，可調音量與預覽。
- 外觀項包括角色、尺寸、動畫、光暈、次要貨幣顯示、自動關閉等。
- 偏好保存在本機瀏覽器，不上傳。
安裝與啓用¶
前置條件¶
- 已安裝支持第三方 bundle 的 DSH Web（
dsh web）。 - 若要查餘額：在 DSH 憑據服務中配置
DEEPSEEK_API_KEY，或登錄 DeepSeek 賬號。
安裝命令¶
從 GitHub 安裝：
dsh plugin --profile web add github:Biggy1606/dsh-balance-whale-intl
需要固定版本時，可 pin release 標籤（資料中示例爲 v1.8.1）：
dsh plugin --profile web add github:Biggy1606/dsh-balance-whale-intl#v1.8.1
npm 包發佈後也可：
dsh plugin --profile web add dsh-balance-whale-intl
安裝後¶
- 重啓
dsh web。 - 瀏覽器硬刷新（
Ctrl+Shift+R）。 - 若仍看不到小部件，在 Settings → Plugins 中確認 Balance Whale Intl 已啓用。
更新或移除示例：
dsh plugin --profile web remove dsh-balance-whale-intl
dsh plugin --profile web add github:Biggy1606/dsh-balance-whale-intl
典型用法¶
- 角色默認在 DSH 窗口右下角；點擊打開或關閉錢包卡片。
- 拖動角色移動，靠近邊緣鬆手可吸附。
- 拖動卡片標題欄移動卡片；雙擊標題欄居中。
- 在 Settings → Appearance → Language 切換 English / 簡體中文。
- 用 ×、Esc 或再次點擊角色關閉卡片。
數字怎麼理解¶
- Token 爲真實值，來自 DSH 會話日誌。
- 費用爲估算，按 DeepSeek 標價計算，可能與賬單因混合 CNY/USD、匯率、促銷等不一致。
- 雙幣種展示時，同一輪 token 用量會分別按 CNY 與 USD 計價，並非扣兩次。
- 觀察到的錢包支出來自插件運行期間餘額下降推斷，非 retroactive，雙幣種混在一輪時無法精確歸因到某一錢包。
- 餘額查詢優先使用
DEEPSEEK_API_KEY，否則使用已登錄的 DeepSeek 賬號。
數據與隱私（簡要）¶
- API Key 留在 DSH 憑據服務，不進入小部件前端代碼；餘額解析在宿主進程執行。
- 無遙測、分析或遠程日誌。
- 本地賬本
$DSH_HOME/.balance-whale.json存 accounting keys、token、費用、模型/輪次名等，不存 prompt、回覆、憑據或 API Key。 /balance-whale/state.json與/balance-whale/wait.json只讀，並拒絕跨站請求。
適用場景與注意¶
適合：在 DSH Web 上日常對話、希望邊聊邊看餘額與 token、且偏好英文 UI（或需要中英切換）的開發者。
注意：
- 插件以當前 DSH 進程權限運行，並會訪問 DeepSeek 餘額 API（經宿主）與本地
/balance-whale/*路由；安裝前建議閱讀 GitHub 倉庫 源碼與 MIT 許可證；角色圖、圖標、音效來自上游 as-is 再分發，並非全部由 MIT 覆蓋，詳見倉庫內ASSET_PROVENANCE.md與NOTICE。 - DSH 生態是「一切皆插件」；skillhub.cn 插件目錄 爲社區站點，與 DeepSeek / 幻方無官方從屬關係。
- 兼容性：
package.json聲明dsh.bundle.patch與dsh.client（web）；dsh.so 上標註爲 Declared，需以你本地 DSH Web 實測爲準。
常見問題（無聲音、餘額不可用、費用與賬單不符、恢復默認佈局等）見倉庫 README 的 Troubleshooting 小節。
結尾¶
Balance Whale Intl 把上游 Balance Whale 的能力保留下來，並把默認語言改成英文，同時保留完整簡體中文設置，適合在 DSH Web 裏做「看得見」的錢包與 token companion。目錄頁：https://www.skillhub.cn/plugins/Biggy1606/dsh-balance-whale-intl；源碼與安裝說明：https://github.com/Biggy1606/dsh-balance-whale-intl。
