前言¶
在 DSH 的插件化擴展裏，側邊欄、設置頁和數據源展示都可以通過插件補充。實際使用時，一個常見問題是：額度信息分散在不同服務商的控制檯裏，DeepSeek 餘額、OpenCode Go 的月 / 周 / 5h 額度、國家超算中心 scnet 的 Credits 需要分別查看。
dsh-plugin-quota-monitor 解決的就是這個問題：把額度與餘額狀態放到 DSH 側邊欄底部，並在設置頁裏提供完整配置。
這是什麼¶
dsh-plugin-quota-monitor 是一個 DSH（DeepSeek Harness）側邊欄底部的額度與餘額監控插件，由 DoggyHU 維護，許可證爲 MIT。
它的定位比較明確：在 DSH 側邊欄底部顯示一條怒氣條和各服務商狀態條，並在“設置 → 插件管理 → 餘額監控”裏提供完整配置頁。
適合在 DSH 中使用 DeepSeek、OpenCode Go 或國家超算中心 scnet，並希望減少切換到外部控制檯查看餘額的人。
核心功能¶
DeepSeek 餘額¶
DeepSeek 怒氣條 Rage 爲金色，始終顯示。
它讀取 DeepSeek 官方接口的即時餘額：
api.deepseek.com/user/balance
界面上顯示 ¥ 剩餘金額。
OpenCode Go 額度¶
數據源標識爲 opencode-go。
它讀取 OpenCode Go 官方用量接口，把三個窗口映射爲 RPG 風格的狀態條：
月額度 = HP
周額度 = MP
5h 額度 = SP
界面上顯示剩餘 $ 與細條。
國家超算中心 scnet Credits¶
scnet 展示的是 Token Plan Credits 剩餘。
scnet 沒有公開的用量 / 餘額查詢接口，用量只能從網頁控制檯查看。插件改爲基於 DSH 本地會話日誌估算本月 scnet 消耗，再按 scnet 官方費率表折算成 Credits。
這部分估算只覆蓋 DSH 實際記錄的 token 消耗，不包含只在 DSH 之外使用的 scnet 用量。
側邊欄行爲¶
- 60 秒輪詢一次。
- 切回頁面時即時刷新。
- 窄側欄下摺疊爲圓形小徽標。
數據源選擇¶
數據源默認是 auto。
自動識別會從 DSH 的 settings.yaml 中讀取：
agent-default-model.provider
可選值包括 opencode-go 和 scnet。也可以在設置頁手動指定數據源。
設置頁¶
進入路徑：
設置 → 插件管理 → 餘額監控
可配置項包括：
1、數據源切換：自動、OpenCode Go、國家超算中心。
2、OpenCode 顯示的條：
月額度 HP
周額度 MP
5h 額度 SP
可以分別開關。
3、國家超算 Credits：
- 月度額度，默認 60,000（基礎版）。
- 每月重置日，範圍爲 1-28。
- 模型費率表，JSON 可編輯。
4、DeepSeek 怒氣條始終顯示。
資料中提到模型費率表包含 DeepSeek-V4-Flash-0731、GLM-5、Kimi-K3、MiniMax-M3、Qwen3.8-Max 等官方費率；完整清單未列全。
配置保存在：
$DSH_HOME/storages/quota-monitor-config.json
安裝與啓用¶
安裝¶
從 npm 安裝：
dsh plugin --profile web add dsh-plugin-quota-monitor
也可以使用本地 tarball：
dsh plugin --profile web add dsh-plugin-quota-monitor-<version>.tgz
示例命令裏的 <version> 是本地 tarball 的版本佔位符。資料中 package.json 的版本字段爲 0.3.5。
重啓¶
安裝後需要重啓 dsh web 進程。
client bundle 與 host 都需要重啓進程，僅刷新頁面不夠。
密鑰¶
視數據源而定：
DEEPSEEK_API_KEY
OPENCODE_GO_API_KEY
密鑰可以從環境變量或 ~/.dsh/.credentials.yaml 讀取，環境變量優先。
scnet Credits 走本地會話日誌估算，無需密鑰。
典型用法¶
1、先安裝插件：
dsh plugin --profile web add dsh-plugin-quota-monitor
2、重啓 dsh web 進程。
3、打開：
設置 → 插件管理 → 餘額監控
4、選擇數據源。如果 DSH 默認模型 provider 已經是 opencode-go 或 scnet，可以先用 auto。
5、如果使用 OpenCode Go，勾選需要顯示的額度條：
HP / MP / SP
6、如果使用 scnet，填寫月度額度和每月重置日，並按需編輯模型費率表。
7、回到 DSH 側邊欄底部查看狀態。
本地構建替換¶
開發或替換本地構建時，可以這樣做：
npm pack
dsh plugin --profile web remove dsh-plugin-quota-monitor
dsh plugin --profile web add ./dsh-plugin-quota-monitor-<version>.tgz
重新啓用後，仍需重啓 dsh web 進程。
適用場景與注意¶
適合：
- 在 DSH 中使用 DeepSeek，希望直接在側邊欄看 ¥ 餘額。
- 使用 OpenCode Go，希望查看月 / 周 / 5h 三個額度窗口。
- 使用國家超算中心 scnet，並希望根據 DSH 會話日誌估算本月 Credits。
- 希望在一個設置頁裏管理數據源、條目開關、月度額度和模型費率表。
注意：
- scnet 沒有公開的用量 / 餘額查詢 API，插件只能基於 DSH 本地會話日誌估算。
- 只在 DSH 之外使用的 scnet 用量不包含在估算結果裏。
- Token Plan 按計費週期重置，不一定每月 1 號。需要填寫控制檯顯示的額度重置日，範圍爲 1-28。插件按“上次重置日到今天”統計。
- 表外模型如果沒有官方公開費率，會用默認費率近似；可以在設置頁補充費率或調整默認值。
- 插件會讀取本機配置、密鑰和會話日誌，並通過
dsh插件機制在dsh web進程中啓用。建議把它當作使用當前 dsh 進程權限運行的代碼，安裝前檢查源碼與許可證。 - 項目許可證爲 MIT。資料說明本項目由
jelly-000/dsh-balance-monitor大幅擴展而來，原項目許可證也爲 MIT。
結尾¶
dsh-plugin-quota-monitor 的價值比較直接：把 DeepSeek 餘額、OpenCode Go 額度窗口和 scnet Credits 放進 DSH 側邊欄，並提供一個設置頁管理數據源、條目開關、月度額度和模型費率表。
GitHub 倉庫：
https://github.com/DoggyHU/dsh-plugin-quota-monitor
社區目錄頁地址未包含在已覈實資料中，無法給出可靠鏈接；查找插件目錄時，請以項目說明或目錄站點給出的地址爲準。
