前言¶

在 DeepSeek Harness（DSH）裏查餘額，默認路徑是打開 設置 → 賬號與餘額。寫 agent、調模型或長時間掛着會話時，如果只想確認錢包還剩多少，每次進設置頁會打斷當前操作。社區插件 dsh-show-balance 把餘額嵌進對話區底部 dock：一格數字常駐狀態欄，點開可看充值、贈金與合計，數據來源與官方賬號頁一致。

下面介紹插件定位、顯示邏輯、安裝啓用方式，以及使用時需要注意的權限與版本前提。

這是什麼¶

dsh-show-balance 由 stefanohe（Stefano’s AI Lab）維護，npm 包名同爲 dsh-show-balance，在 SkillHub 目錄中歸類爲客戶端插件。README 標明適用於 deepseek-harness-v0.2.0-rc.2；當前發佈版本爲 0.2.0-rc.2（MIT 許可證）。

一句話：在瀏覽器 UI 的 conversation.composer.dock 插槽增加一個格子，展示已登錄賬號的錢包餘額；未登錄或讀數失敗時不渲染任何內容，避免展示過期或憑空數字。

核心功能¶

狀態欄格子¶

• 位置：內置「會話統計」條目的左側；若已安裝輸入統計類插件（README 中的 prefill-speed cell），則顯示在該格子的左側。
• 內容：錢包餘額，保留兩位小數（不展示 Platform 的完整精度）。
• 交互：單擊格子在上方彈出面板（portal 掛到 body）；Escape、點擊面板外或再次單擊格子可關閉。

彈出面板中的行¶

多幣種賬號：按幣種分別彙總，用 + 連接（例如 10.00 CNY + 1.00 USD），不做匯率換算。沒有贈金錢包時，面板只顯示充值一行；贈金爲 0.00 仍會顯示（與出貨賬號頁隱藏零贈金的行爲不同）。

單位隨 UI 語言變化：CNY 在英文界面爲 CNY，中文爲 元；其他幣種保留 ISO 代碼。切換界面語言後即時生效，無需重裝。

數據從哪來¶

與 設置 → 賬號與餘額 相同鏈路：ctx.get('remote.account') → getBalance(metadata)。瀏覽器不發送憑據，由 Host 附上已保存的授權；餘額約 每 30 秒 重新讀取。未登錄或讀取失敗時返回 null，格子不顯示內容。

安裝與啓用¶

插件面向 DSH 的 desktop profile，目錄爲 <DSH 主目錄>/profiles/desktop。README 建議使用 pnpm 11.7.0。

若尚未安裝 pnpm：

npm install -g pnpm@11.7.0

方式 A：從 npm 安裝¶

在對應 profile 目錄執行（或通過 設置 → 插件 / agent 的 plugin_manager 工具安裝）：

pnpm add dsh-show-balance

DeepSeek Harness 使用默認主目錄時：

cd "$env:USERPROFILE\.dsh\profiles\desktop" ; pnpm add dsh-show-balance     # Windows
cd ~/.dsh/profiles/desktop ; pnpm add dsh-show-balance                      # macOS / Linux

確認該 profile 的 package.json 裏 dsh.profile.bundles 已包含包名（經插件管理器安裝時會自動寫入）。

方式 B：從倉庫腳本安裝¶

適用於源碼、離線或 npm 未提供的版本。在倉庫根目錄執行：

pwsh -File .\install.ps1               # Windows
sh ./install.sh                        # macOS / Linux
pwsh -File .\install.ps1 -From npm     # 安裝 npm 已發佈包

腳本會完成依賴與 manifest 寫入（並備份所改文件），並提示後續步驟。

啓用（兩種方式共通）¶

1. 完全重啓 DSH 應用——瀏覽器 bundle 在啓動組合時快照，僅刷新頁面不夠。
2. 在左側插件面板中將 dsh-show-balance 開關打開。

典型用法¶

安裝並啓用後，登錄 DeepSeek 賬號即可在對話區底部 dock 看到餘額格。需要區分充值與贈金時，單擊格子查看三行明細（有贈金時）或僅充值一行（無贈金時）。長時間開着 Harness 時，數字會按約 30 秒間隔自動刷新，無需手動進設置頁。

未登錄狀態下格子爲空，屬預期行爲。

適用場景與注意¶

適合誰：經常在 DSH 桌面端寫 prompt、跑 agent，希望在 composer 旁一眼看到餘額、且要與官方賬號頁數字一致的用戶。

實現邊界（README Notes）：

• 非官方插件，僅使用公開接口（account Remote 與 dock 插槽）。
• 贈金不計入狀態欄 headline，與出貨賬號頁的「充值 / 贈金」拆分一致。
• 插件以當前 DSH 進程權限運行；安裝前請自行查看 GitHub 源碼 與 MIT 許可證，確認可接受後再啓用。

包結構參考：index.js（Host Loader 行）、client.js（瀏覽器側格子與取數）、cordis.patch.yml（宿主 patch）。

結尾¶

dsh-show-balance 把賬號餘額搬進狀態欄，讀數路徑與官方賬號頁相同，並區分充值、贈金與合計。若你已在用 DSH v0.2.0-rc.2 系桌面 profile，可按上文 pnpm 或安裝腳本接入，重啓後在插件面板打開即可。

• 目錄頁：https://www.skillhub.cn/plugins/stefanohe/dsh-show-balance
• 倉庫：https://github.com/stefanohe/dsh-show-balance