前言¶
DeepSeek Harness（DSH）採用“一切皆插件”的架構，Web GUI 同樣可以通過插件擴展功能。在開發或使用過程中，需要隨時查看已配置服務商的餘額與配額。dsh-plan-spend 是一個 Web GUI 彈窗插件，它將原本分散的餘額查詢與配額監控集中在一個側邊欄入口中，直接展示 DeepSeek 官方餘額和 OpenCode Go 的使用情況。
功能概覽¶
該插件主要解決以下問題：
* 集中展示：在 DSH Web GUI 的側邊欄導航中提供統一的入口，展示已配置服務商的套餐花銷。
* DeepSeek 官方餘額：查詢賬戶充值餘額、贈金、峯谷時段狀態及充值來源。插件故意繞過了直接訪問 platform.deepseek.com 的邏輯，以規避 WAF 返回的 429 錯誤。
* OpenCode Go 配額：展示 5 小時/7 天/月的配額使用百分比、進度條及重置倒計時。注意該接口僅返回百分比與重置時刻，不提供具體金額。
* 智能峯谷判斷：客戶端自動計算北京時間下的峯谷時段，並根據中國節假日表判斷是否爲節假日（需手動維護節假日表）。
* 雙路查詢支持：支持通過 API Key 查詢，也支持通過 DeepSeek 賬戶登錄態進行查詢。未配置的提供商會自動跳過並提示。
安裝與啓用¶
安裝命令如下：
dsh plugin --profile <profile> add github:Chi-hong22/dsh-plan-spend
安裝後，在 DSH Web GUI 的側邊欄導航欄中，找到 “Usage” 對應的行，點擊即可打開插件面板。
驗證插件是否正確掛載：
dsh --profile <profile> --dump-config | grep dsh-plan-spend
關於 desktop profile¶
desktop profile 由 Electron 應用獨佔管理，CLI 命令拒絕在此 profile 下安裝插件。如需在桌面端使用，請通過 GUI 插件頁面進行安裝。
使用方法¶
安裝完成後，無需額外配置。插件會自動檢測已配置的服務商：
1. 打開 DSH Web GUI。
2. 在左側導航欄點擊 “Usage”。
3. 彈出面板將顯示已配置的卡片：
* DeepSeek 官方卡片：顯示餘額、贈金、峯谷狀態。如果登錄失效，會提示“登錄狀態失效”；如果查詢請求失敗，會提示“查詢失敗”。
* OpenCode Go 卡片：顯示進度條和倒計時。
實現細節與注意事項¶
- 節假日表維護：插件內部使用
UM_CHINA_PUBLIC_HOLIDAYS_UTC表來判斷節假日。該表需手動維護，以覆蓋當年及未來的中國法定節假日。如果當前年份未在表中，插件將明確提示“節假日表不覆蓋該年份”，而不是默認計算。 - DeepSeek 查詢機制：DeepSeek 卡片優先使用賬戶登錄態（通過
ctx.deepseekAccount.resolveToken獲取授權 Token），僅在登錄態失效時纔回退到 API Key 模式。 - OpenCode Go 限制：由於接口限制，OpenCode Go 卡片無法顯示具體金額，僅提供進度百分比和重置時間。
總結¶
dsh-plan-spend 爲 DSH 用戶提供了一個輕量級的 Web GUI 餘額監控工具。它解決了 DeepSeek 官方餘額查詢被 WAF 阻斷的問題，並提供了直觀的峯谷與配額可視化。
- 項目地址：https://github.com/Chi-hong22/dsh-plan-spend
- 許可證：MIT
