前言¶
在 DeepSeek Harness（DSH）裏跑長會話時，算力與贈送額度會隨調用消耗。若只在設置頁的賬戶面板裏偶爾查看餘額，容易在任務進行中才發現額度不足。本插件把餘額做成標題欄旁的一枚小芯片，主數字與贈送額度並排顯示，並定期自動刷新，減少來回切頁面的次數。
這是什麼¶
dsh-plugin-balance-chip 是由維護者 boy1141 發佈的 DSH 客戶端插件。它在 Web GUI 的會話標題欄、與其他標題欄操作並排，展示剩餘賬戶餘額、尚未用完的贈送額度，以及最近一次讀取餘額的時間（懸停可見）。數據每 20 秒刷新一次。
插件在 SkillHub 社區目錄中的分類爲客戶端；倉庫當前星標爲 0。DSH 生態主張「一切皆插件」；SkillHub 等爲社區獨立站點，與 DeepSeek / 幻方無官方從屬關係。
核心功能¶
下面介紹插件在 README 中明確說明的行爲。
數據來源與安全邊界¶
插件通過 Host 側調用 ctx.remote.account.getBalance() 讀取餘額，與 Settings → Account 面板使用的是同一套平臺查詢。瀏覽器端不持有賬戶 token。
刷新策略¶
- 頁面可見時每 20 秒自動刷新。
- 窗口重新獲得焦點或標籤頁再次可見時立即刷新。
- 點擊芯片可立刻手動刷新。
展示與異常¶
- 主數字爲賬戶餘額，
+後爲未用完的贈送額度。 - 未登錄時隱藏芯片。
- 讀取失敗時顯示紅點與 “balance unavailable”，點擊可重試。
- 界面語言跟隨 DSH（zh / en），樣式跟隨主題的 CSS 變量。
包結構（便於對照源碼）¶
| 文件 | 作用 |
|---|---|
lib/index.js |
Host 側：空 mount，供 Loader 登記啓用項 |
lib/client.js |
瀏覽器側：插槽註冊、輪詢 store、芯片組件 |
cordis.patch.yml |
Loader 插入行，id: balance-chip |
當前發佈包版本爲 1.0.0，許可證爲 MIT（見倉庫 package.json）。
安裝與啓用¶
先從 GitHub 安裝，命令如下（與倉庫 README 一致）：
dsh plugin add github:boy1141/dsh-plugin-balance-chip
也可從 最新 Release 下載 dsh-plugin-balance-chip.tgz 後安裝該壓縮包。若條目已出現在插件市場，亦可在 Settings → Plugins 中搜索安裝。
安裝前建議通讀倉庫源碼與 LICENSE。插件在當前 DSH 進程權限下運行，安裝第三方插件前應自行評估風險。
典型用法¶
安裝並啓用後無需額外配置項（README 未列出專用配置字段）。在已登錄 DSH Web 界面打開任意會話，標題欄旁應出現餘額芯片：
- 查看主數字與
+後的贈送額度。 - 將指針懸停在芯片上，查看上次更新時間。
- 需要即時數據時單擊芯片刷新。
若已登出，芯片不顯示；若請求失敗，按界面提示點擊重試。
適用場景與注意¶
適合： 經常在 DSH Web GUI 中長時間使用模型、希望在不離開會話的前提下盯餘額與贈送額度的開發者或運維者。
注意：
- 餘額展示依賴 Host 側賬戶接口；網絡或平臺側異常時會進入不可用狀態，屬插件設計行爲而非本地緩存。
- 自動刷新僅在頁面可見時進行，切換標籤或最小化窗口後再回來會觸發立即刷新。
- 文檔未描述除安裝外的 CLI 子命令；開發與冒煙測試在貢獻者工作區通過
tools/smoke-client.mjs完成，普通用戶以安裝使用爲主。
結尾¶
dsh-plugin-balance-chip 把 Settings → Account 同源餘額查詢搬到會話標題欄，並以 20 秒輪詢與焦點/點擊刷新降低打斷感。進一步瞭解可訪問社區目錄頁與 GitHub 倉庫：
- 目錄頁：https://www.skillhub.cn/plugins/boy1141/dsh-plugin-balance-chip
- GitHub：https://github.com/boy1141/dsh-plugin-balance-chip
