前言¶
在 DeepSeek Harness（DSH）里長時間對話或跑任務時，賬戶裏的充值餘額和贈送餘額會隨調用消耗。若要在網頁裏覈對，往往需要切到賬戶設置頁，和當前 composer 的工作流是分開的。
dsh-token-balance 由社區維護者 feiniao1933 發佈，歸類爲聯網工具類插件。它在消息輸入框下方的狀態行（與上下文佔用指示同一行）增加一枚餘額膠囊，通過已登錄賬戶的 Host Remote 拉取餘額並定時刷新，無需自行配置 API Key。
這是什麼¶
dsh-token-balance 是一個 DSH bundle 插件：Client 側在 conversation.composer.dock 插槽渲染 UI；Host 側僅通過 webserver/index-inject 下發刷新間隔配置。餘額數據來自 ctx.get('remote.account').getBalance(...)，不讀取、不保存、不外發 API Key。
當前 npm 包尚未發佈，需從 GitHub 倉庫安裝。包版本爲 1.0.1，許可證爲 MIT。社區目錄頁：https://www.skillhub.cn/plugins/feiniao1933/dsh-token-balance；源碼與說明：https://github.com/feiniao1933/dsh-token-balance。
核心功能¶
下面介紹插件在界面上提供的能力，均對應 README 中的說明。
- 顯示賬戶可用總額（充值餘額 + 贈送餘額），並保持更新。
- 鼠標懸停可看明細：總額、充值餘額、贈送餘額、最後更新時間，以及刷新提示。
- 點擊膠囊可立即刷新。
- 自動刷新時機：掛載時、默認每 30 秒、標籤頁重新可見或獲得焦點時、當前會話一輪結束時。
- 未登錄時顯示「未登錄」；讀取失敗顯示「餘額不可用」，並自動重試最多 3 次。
- 使用宿主主題變量，跟隨明暗主題；內置中英文文案。
金額展示規則與賬戶設置頁一致：截斷到分，正的不足一分顯示爲 <¥0.01，多幣種錢包用 + 連接。膠囊上是合計，懸停 tooltip 裏分開列出。
安裝與啓用¶
npm 正式包尚未發佈。先在終端用你的 profile 名稱（下文示例爲 web）從公開 Git 倉庫安裝：
dsh plugin --profile web add github:feiniao1933/dsh-token-balance
若希望安裝結果可復現，可固定到某一提交：
dsh plugin --profile web add git+https://github.com/feiniao1933/dsh-token-balance.git#<commit>
將 <commit> 換成目標提交的 SHA。按宿主要求重啓 DSH 或刷新頁面後，在已登錄 DeepSeek 賬戶的 Web 客戶端 composer 下方應能看到餘額膠囊。將來 npm 發佈後，README 稱也可使用：
dsh plugin --profile web add dsh-token-balance
包內聲明瞭 dsh.bundle.patch，與 dsh plugin add 安裝流程兼容。package.json 中 engines.dsh 要求 >=0.2.2-rc.1；README 記載在 macOS 上對 DSH 0.2.2-rc.1 做過測試。
配置¶
默認刷新間隔爲 30 秒。若需調整，在對應 profile 的 cordis.patch.yml 中覆蓋 token-balance 行：
- id: token-balance
config:
refreshIntervalMs: 30000 # 5000–3600000
refreshIntervalMs 取值範圍爲 5000–3600000 毫秒。修改後按你的部署方式重新加載配置或重啓相關進程。
典型用法¶
安裝並登錄 DeepSeek 賬戶後，無需額外命令行操作：
- 在 composer 下方狀態行查看總額膠囊。
- 懸停查看充值、贈送分項與更新時間。
- 需要即時數據時點擊膠囊觸發刷新。
插件不暴露獨立的 HTTP 路由，也不增加運行時依賴；餘額查詢完全走 Host 已有的 account/getBalance Remote。
適用場景與注意¶
適合經常在 DSH Web 界面裏對話、希望在同屏留意賬戶餘額是否充足的開發者。不適合未使用 DSH、或不在 Web client 上使用 composer dock 的環境。
安裝前建議通讀倉庫源碼與 MIT 許可證。插件在當前 DSH 進程與已登錄會話的權限下運行，會通過 Host Remote 訪問賬戶餘額接口；請確認這符合你對本機或部署環境的信任邊界。社區插件目錄（SkillHub）爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。
結尾¶
dsh-token-balance 把 DeepSeek 賬戶餘額收進 composer 狀態行，減少切頁覈對的開銷。安裝與配置項以 README 爲準；遇到問題可在 GitHub Issues 反饋。
