在 DeepSeek Harness 的 Composer 統計行中，用戶通常需要跳轉到其他頁面查看當前的計費時段和賬戶餘額。dsh-billing-badge 插件直接在統計行中增加了原生的膠囊控件，用於顯示計費時段狀態和倒計時，並支持點擊展開面板查看詳細餘額信息。
插件定位¶
該插件由開發者 devacc8 維護，採用 MIT 許可證。它作爲 DeepSeek Harness Web GUI 的客戶端擴展，不包含成本或 Token 的具體計費統計，僅展示官方接口返回的餘額數據。
核心功能¶
1. 統計行膠囊顯示¶
插件在 Composer 統計行中，緊接在“Cache hit”統計數據之後，渲染一個膠囊控件。
- 計費時段與顏色點：顯示當前所處的計費季節（峯/谷）。峯時段顯示琥珀色圓點，其餘爲半價時段（綠色圓點）。
- 倒計時：顯示距離季節切換的剩餘時間。
2. 餘額與狀態面板¶
點擊膠囊可打開面板，展示以下信息：
- 季節與時間：當前季節、下一次切換的時間（北京時間）。
- 賬戶餘額：顯示賬戶總餘額及貨幣單位（由 API 響應決定，不強制使用 CNY）。
- 餘額構成：當賬戶餘額包含贈送和充值時，面板會拆分爲“Granted（贈送）”和“Topped up（充值）”兩行顯示。
- 可用性警告：如果餘額不足以支持 API 調用，面板會顯示警告行。
3. 數據與安全¶
- 接口調用：使用官方
GET /user/balance接口獲取數據。 - 密鑰處理：通過 DSH 的 credentials seam 解析 API Key，不將其發送到瀏覽器端。
- 路由限制：單路由需要請求頭
x-dsh-billing-badge: 1，並拒絕跨域 Origin 訪問。
時段規則¶
計費時段的切換邏輯基於北京時間：
* 峯時段：工作日 09:00-12:00 和 14:00-18:00。
* 其餘時段：週六日全天及工作日其他時段爲半價。
安裝與啓用¶
使用官方插件安裝命令添加該插件：
dsh plugin --profile web add dsh-billing-badge
安裝後需重啓 dsh web 進程使更改生效。
典型用法¶
在 Composer 統計行中，用戶將看到類似以下的文本：
2288M tok · Cache hit 99.8% · ● Off-peak · 2h13m
點擊 ● 圓點，即可在彈出的面板中查看完整的餘額構成和倒計時。
注意事項¶
- 版本兼容性：僅支持 DeepSeek Harness 0.1.5 和 0.1.6。
- 功能範圍：不涉及成本覈算或 Token 數量統計，僅顯示賬戶餘額。
