前言¶

在 DSH（DeepSeek Harness）裏同時接 DeepSeek 官方賬號和若干第三方模型提供方時，額度分散在各家的控制台或 usage 接口裏，側邊欄賬號行本身不會彙總「還剩多少」。要判斷 5 小時 / 7 天訂閱額度是否夠用，往往得切頁面或記各家規則。下面介紹社區插件 dsh-sidebar-quota-widget（維護者 lakii2982，分類：客戶端）：在 Web GUI 側邊欄賬號行展示 DeepSeek 官方餘額，並在其上方用圓環展示本機已接入的其他提供方的 5 小時與 7 天剩餘比例；Host 讀真實接口，Client 只做 CSS 渲染，不引入額外依賴。

這是什麼¶

dsh-sidebar-quota-widget 是 DSH Web GUI 的輕量 UI 插件：官方餘額以類似 ¥12.34 的數字顯示在用戶菜單那一行的右端；每個已註冊且排除 DeepSeek 官方路由的第三方提供方對應一個圓環，圓心爲提供方 LOGO，內圈表示 7 天剩餘、外圈表示 5 小時剩餘，弧長對應剩餘比例。提供方列表來自 DSH 的 LLM 註冊表；沒有額度適配器的 provider 會顯示灰色空環並提示「暫無額度接口」。項目版本 1.0.0，許可證 MIT，Node >=20。

目錄頁：https://www.skillhub.cn/plugins/lakii2982/dsh-sidebar-quota-widget
源碼：https://github.com/lakii2982/dsh-sidebar-quota-widget

核心功能¶

官方餘額與圓環¶

• 餘額數字疊在賬號行右側，懸浮層 pointer-events: none，不擋住點擊，點該行仍是原生用戶菜單。
• 每個第三方提供方一個圓環；顏色語義：剩餘 ≥70% 綠色，40–70% 綠→琥珀漸變，15–40% 琥珀→紅，<15% 紅色。
• 懸停或鍵盤聚焦時彈出與 DSH 原生菜單質感一致的卡片（使用 --dsw-specific-menu 等 token），展示 5 小時與 7 天剩餘、重置倒計時與失敗原因。

佈局與刷新¶

• 一行最多 5 個圓環，超出自動換行；亮/暗主題、側邊欄摺疊、中/英多語言跟隨 DSH。
• Host 端 45 秒緩存，前端 60 秒輪詢；側邊欄摺疊爲 56px 窄欄時插件隱藏且不輪詢。

當前支持的額度接口¶

Host 在進程內請求下列接口（認證經 DSH 憑據解析，Key 不進前端）：

憑據引用順序（回退鏈，無需寫進插件配置）：

opencode-go   → OPENCODE_GO_API_KEY → OPENCODE_API_KEY
kimi-coding   → KIMI_CODING_API_KEY → KIMI_API_KEY
zai-coding-cn → ZAI_CODING_CN_API_KEY → ZAI_API_KEY

在 設置 → 模型 裏接入對應 provider 並填好 Key 即可；插件不保存任何密鑰。

安裝與啓用¶

前提：已安裝 DSH Desktop / Web（含 Web GUI 與 Plugin Manager），且至少接入一個第三方模型提供方並在 DSH 憑據中配置對應 API Key。

1. 將倉庫克隆到本機任意目錄：

git clone https://github.com/lakii2982/dsh-sidebar-quota-widget.git

2. 以本地 bundle 安裝（二選一）：
   - 在 DSH 的 Plugin Manager / 設置裏選擇「安裝本地 bundle」，指向克隆下來的目錄；
   - 或讓 DSH 裏的 Agent 調用 plugin_manager 的 install_bundle，target 傳該目錄的絕對路徑。

3. 安裝成功後插件會熱更新進當前頁面；若未出現，刷新一次頁面。

插件以當前 DSH 進程權限運行；安裝前建議閱讀倉庫源碼與 MIT 許可證。社區目錄 skillhub.cn 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。

典型用法¶

安裝並完成憑據配置後，無需單獨配置文件：打開 Web GUI 側邊欄（非 56px 摺疊態），即可在賬號行看到官方餘額與各已接入提供方的圓環。懸停圓環查看 5h/7d 明細與重置時間。

若需擴展新的提供方，維護者在 README 中給出的步驟爲：

1. 在 providers.mjs 實現 adapter（用 credential 請求 usage 接口，歸一爲 remainingPct / resetsAt；remainingPct 須爲剩餘百分比 0–100）。
2. 在 PROVIDER_CREDENTIAL_CANDIDATES、PROVIDER_PRESENTATION、ADAPTERS 中登記。
3. 新品牌可在 client.js 的 PROVIDER_LOGOS 增加單色 SVG 輪廓（currentColor）。

本地語法檢查：

npm run check

適用場景與注意¶

適合：經常在 DSH 側邊欄切換賬號、同時依賴 OpenCode Go、Kimi Coding、智譜 Z.AI 等已適配提供方，希望在同一視圖裏看 DeepSeek 餘額與訂閱額度剩餘比例的用戶。

安全與隱私（據 README）：Key 僅在 Host 進程內經 ctx.credentials 解析；插件 HTTP 路由僅接受本機迴環或與 DSH 配對的設備請求，跨站返回 403；響應僅含餘額與百分比。

已知限制：

• 三個 usage 接口屬各家控制台用途、未公開文檔化，上游改動可能導致某路失敗；失敗僅使對應圓環變灰並提示，不影響 DSH 本身。
• 只覆蓋 DSH 的 LLM provider；Claude Code / Codex 等子智能體不在此列。
• 餘額定位基於當前 DSH 賬號行 44px 行高；大版本升級後若有偏移，可調整 client.js 裏 .qw-balance-overlay 的 top / height。

結尾¶

dsh-sidebar-quota-widget 把 DeepSeek 官方餘額與本地已接第三方提供方的 5 小時 / 7 天額度收進側邊欄，Host 拉真實數據、Client 用圓環與原生質感 tooltip 展示，輪詢與摺疊行爲都按低打擾設計。進一步瞭解可在社區目錄頁查看條目，或在 GitHub 閱讀 CONTRACT.md、RESEARCH-providers.md 與 VERIFICATION.md。

• 目錄頁：https://www.skillhub.cn/plugins/lakii2982/dsh-sidebar-quota-widget
• GitHub：https://github.com/lakii2982/dsh-sidebar-quota-widget