前言¶

在 DeepSeek Harness（DSH）裏跑會話時，充值餘額和贈金往往要切到官方賬號頁才能確認。側邊欄底部本來就有設置和賬號入口，但那裏不會直接給出 Platform 錢包合計。若你希望在寫代碼、調智能體的同一界面裏一眼看到「還能用多少」，又不想額外開頁面或接第三方統計，社區客戶端插件 dsh-quota-usage（維護者 lbqcgza）針對的就是這個缺口：把總餘額（含贈金拆分）固定在用戶名正上方，並支持點擊刷新與會話用量估算。

這是什麼¶

dsh-quota-usage 是 DSH 的 Web 客戶端插件（分類：客戶端）。它掛在 sidebar.footer.action 槽位，在側邊欄底部、用戶名 / 頭像那一行的上方 顯示一行「額度」，必要時下方再跟一行「本會話」用量副標題。餘額數據來自官方 Remote 接口 remote.account.getBalance，與「設置 → 賬號」頁同源；插件自述 零遙測（不落盤上報、不接觸 token，除一個本地顯示偏好鍵外不寫瀏覽器存儲）。

倉庫：https://github.com/lbqcgza/dsh-quota-usage
目錄頁：https://www.skillhub.cn/plugins/lbqcgza/dsh-quota-usage
許可證：MIT（見倉庫 package.json）。

核心功能¶

下面介紹 README 中已說明、且與實現描述一致的能力。

額度主行¶

• 總餘額：Platform 的充值餘額（normal_wallets）與贈金餘額（bonus_wallets）在當前幣種下的合計；括號內爲贈金部分。贈金不足 1 分（含爲 0）時，括號與對應展示一併不渲染，避免 <0.01 等噪聲。
• 狀態文案：讀取中、讀取失敗、未連接、未登錄均有明確提示，組件不會靜默空白。
• 點擊刷新：點整行立即重讀；讀取期間金額右側出現轉圈，後臺輪詢與窗口焦點變化觸發的刷新不會閃轉圈。
• 自動刷新：掛載時讀一次；在 remote.account 就緒前每 5 秒重試，就緒後改爲每 60 秒；頁面可見、獲焦、連接重置、賬號登錄/登出（account.watch）也會觸發重讀；併發刷新會去重爲單次 Remote 調用。

本會話用量副標題（可選）¶

有打開的會話時，額度下方可顯示當前會話的 token 用量 與 估算金額區間（如 約¥1.20–2.40）。金額由官方價目表推算，日誌無金額字段，且無法還原歷史請求是否處於高峯時段，故顯示區間；token 數在懸停提示中給出，口徑與 DSH tokenUsage 投影一致。

可在 設置 → 通用 → 本會話用量顯示 關閉；開關狀態存於 localStorage 鍵 dsh-quota-usage:show-usage（插件唯一寫入的本地鍵）。僅覆蓋當前會話，不做全工作區彙總。

佈局與語言¶

展開側邊欄時爲兩行列表式佈局（標籤左對齊、金額貼右）；收起爲 56px 軌道時變爲 36px 圓形按鈕（軌道態不顯示用量副標題）。界面文案隨 DSH 語言在中英之間切換。

環境與限制¶

• 需要 DSH 0.2.0-rc.2 或更新的 Web 版（桌面 App 或 dsh web）。依賴 sidebar.footer.action 與 remote.account；headless / SDK / ACP 等無 Web 客戶端的 profile 不適用。
• 只讀展示，不提供充值或跳轉官方賬號 overlay 的替代入口。
• 多幣種時優先 CNY，否則取第一個錢包幣種。
• 用量金額爲估算，不是賬單；價格變動需更新插件內價目常量（見倉庫說明）。

安裝與啓用¶

在 DSH 內通過 plugin_manager 安裝（Creator 模式或設置裏的插件頁）。安裝命令以倉庫 README 爲準：

plugin_manager install_bundle  target = github:lbqcgza/dsh-quota-usage

若使用本地倉庫路徑：

plugin_manager install_bundle  target = <本倉庫絕對路徑>

桌面 App 裝完後需重啓一次：客戶端模塊啓動圖只在宿主進程啓動時生成，僅刷新頁面拿不到新插件；dsh web 瀏覽器模式刷新頁面即可。裝好後側邊欄底部、設置與用戶名行上面會出現「額度」一行。

插件以當前 DSH 進程權限運行；安裝前請自行查閱源碼與 MIT 許可證，確認符合你的安全與合規要求。

典型用法¶

1. 完成安裝並按環境重啓或刷新（見上節）。
2. 登錄 DeepSeek 賬號後，展開側邊欄，在用戶名上方查看 額度 與右側金額；懸停可看充值/贈金拆分、更新時間、自動刷新間隔及本會話 token 與估算區間。
3. 需要即時更新時，點擊額度整行觸發手動刷新。
4. 若不需要會話用量行，在 設置 → 通用 → 本會話用量顯示 關閉即可。

側邊欄展開時的示意（來自 README）：

  額度                     ¥13.34（贈¥1.00）
  本會話                 約¥1.20–2.40
  ⚙ 設置
  (頭像) 張三

開發者在改 lib/client.js 後，可在插件頁 停用再啓用 該插件以重新加載頁面模塊，無需重啓 App（與「首次新裝客戶端插件」不同）。

隱私與安全（摘要）¶

• 不持有憑據；僅調用 remote.account.getBalance，請求元數據爲 version、locale、timezoneOffsetSeconds，與官方賬號頁一致。
• Host 半側爲空 apply，不註冊 HTTP 路由，不執行命令、不讀文件。
• 無 fetch / XHR / WebSocket 等遙測出口；安全問題可通過 GitHub 私密漏洞報告渠道提交（見倉庫 SECURITY.md）。

結尾¶

dsh-quota-usage 把 Platform 錢包合計和可選的本會話用量估算放進側邊欄固定位置，適合長期在 DSH Web 客戶端裏工作、又不想頻繁切賬號頁的用戶。社區插件目錄與 DeepSeek / 幻方無官方從屬關係，安裝與使用以你本地 DSH 版本與倉庫說明爲準。

• 目錄頁：https://www.skillhub.cn/plugins/lbqcgza/dsh-quota-usage
• GitHub：https://github.com/lbqcgza/dsh-quota-usage