前言¶
在 DeepSeek Harness（DSH）里長時間跑對話或智能體任務時，輸入框下方會有一行官方用量信息：輪次與步數、Token 用量、上下文佔用等。賬戶裏還剩多少可用額度，通常要另開網頁或進官方 API 頁面才能確認。維護者 dxxo77 的 dsh-plugin-quota-balance（倉庫 dxxo77/DSH_plugin）把當前登錄賬戶的餘額（¥）嵌在同一行最左側，字號、字色與官方用量數字一致；點開可在原地查看普通餘額與贈送額度分項，並跳轉充值。插件分類爲客戶端，在 GitHub 上當前爲 1 star；社區目錄頁見 skillhub.cn。
這是什麼¶
dsh-plugin-quota-balance（npm 包名 dsh-plugin-quota-balance，版本 2.0.0）是 DSH 的 Host + Client 雙端插件：Host 通過宿主 deepseekAccount 服務讀餘額並暴露本地 HTTP 接口；Client 在 conversation.composer.dock 註冊最左側單元格，把合併後的餘額顯示在用量行上。未登錄或讀取失敗時整塊隱藏，不佔位。許可證爲 MIT © 2026 dxxo77。
核心功能¶
用量行餘額徽標¶
啓用前，用量行只有官方三組信息。啓用後，最左側多出一項賬戶餘額（例如 ¥8.84），與官方數字同一行、同一字號（12px）、同一灰度變量 --dsw-alias-label-tertiary，不額外佔位。
點擊展開明細¶
點一下徽標會在原地彈出小卡片（不直接跳轉網頁），內容包括：總餘額、錢包分項、更新時間、「刷新」與「去充值」。Host 返回 normal / bonus 後，界面會分成「普通餘額 / 贈送額度」兩行。同一幣種多個錢包合併求和顯示；多幣種時用 · 連接。Esc、點擊卡片外部或再點一次徽標可收起。卡片底邊對齊徽標上方 6px，窗口縮放時會重新貼靠。
與壁紙引擎共存¶
若同時安裝 dsh-plugin-wallpaper-engine，README 說明：本插件徽標與浮層只讀取宿主暴露的表面 CSS token，會隨壁紙引擎的玻璃參數、明暗主題和壁紙切換變化；未安裝壁紙引擎時爲普通深色浮層。壁紙背景不是本插件繪製。
Host 接口與刷新策略¶
Host 註冊 GET /plugin/quota-balance/status，通過 deepseekAccount.getBalance() 讀取餘額，成功時約 30s 緩存，失敗時約 5s 緩存。Client 每 60s 以及窗口重新可見時刷新。餘額僅在本地迴環地址暴露，響應不帶 CORS 頭，網頁無法跨源讀取。
成功響應示例結構：
{"ok":true,"wallets":[{"currency":"CNY","balance":"5.40"}],"normal":[...],"bonus":[...],"links":{"usageUrl":"...","topUpUrl":"..."},"fetchedAt":1793627086526}
失敗時：{"ok":false,"reason":"unavailable"|"signed-out"|"failed"}。
安裝與啓用¶
需要 DSH 桌面版（Host 側要有 deepseekAccount 服務）並已登錄 DeepSeek 賬號。
- 將倉庫克隆或下載到本地任意目錄；
- 在 DSH 的插件管理裏安裝該目錄，install_bundle 指向該倉庫路徑；
- 安裝後即時生效，用量行最左側會出現餘額；點它展開明細。
卸載：在插件管理裏移除 dsh-plugin-quota-balance 即可。
收錄到 DSH 插件市場（dshmarket）的列表來自 awesome-dsh-plugin；本插件條目爲 data/plugins/dxxo77__DSH_plugin.yml，分類 usage（Usage & Billing）。市場詳情頁截圖來自倉庫 screenshots.json，引用 docs/ 下實拍圖。
典型用法¶
日常無需配置：登錄 DeepSeek 後，在輸入框下方用量行左側看合併餘額；需要分項或充值時，點擊徽標，在卡片裏點「刷新」拉最新數據，或點「去充值」使用 Host 返回的 topUpUrl。若需打開官方用量相關頁面，可使用響應裏的 usageUrl（由 Host 在 status 中一併返回）。
開發調試時，改 client.js 保存後頁面熱更新即可；改 index.js 後在插件管理裏禁用再啓用本插件以重載 Host 模塊，再點卡片「刷新」取新數據。
適用場景與注意¶
適合已在 DSH 桌面版長期使用、希望在不離開對話界面的前提下掃一眼餘額、必要時查看普通/贈送分項的用戶。與官方用量行視覺對齊，並可選配合壁紙引擎插件。
安裝前請自行閱讀倉庫源碼與 MIT 許可證。插件以當前 DSH 進程權限運行，Host 會調用賬戶相關服務；只應從可信來源獲取倉庫並覈對 index.js / client.js 行爲。DSH 社區插件目錄（如 skillhub.cn）與 DeepSeek / 幻方無官方從屬關係，並非官方應用商店。
結尾¶
dsh-plugin-quota-balance 把 DeepSeek 賬戶餘額接到 composer 用量行左側，點開可看分項與充值入口，並與壁紙引擎共用宿主 token。目錄頁：https://www.skillhub.cn/plugins/dxxo77/DSH_plugin；源碼與 README：https://github.com/dxxo77/DSH_plugin。
