DeepSeek Harness 用量看板插件

DeepSeek Harness（DSH）採用插件化架構，開發者在使用過程中需要實時監控賬戶餘額、今日消費及 Token 使用情況。rickyfu0625-cell/dsh-billing-dashboard 是一款爲此需求設計的插件，提供右下角懸浮膠囊和完整面板，用於展示餘額、消費趨勢及充值入口。

核心功能¶

1. 賬戶餘額監控¶

插件讀取 DeepSeek 官方 /user/balance 接口數據，顯示總餘額、充值金額與贈送金額的拆分。當餘額低於 ¥5 時，餘額顯示會標紅提示。

2. 今日消費與 Token 統計¶

消費統計：支持兩種模式。
- 官方優先：如果配置了 DEEPSEEK_PLATFORM_TOKEN，優先調用官方用量接口獲取今日消費。Token 失效時標籤會標紅。
- 本地估算：未配置 Token 或接口失敗時，插件會回放 $DSH_HOME 下的持久化會話日誌，聚合 assistant/message 事件的 Token 並按官方價格折算。
- 在面板內可以手動切換“數據來源”並持久化設置。
Token 細分：統計今日輸入 Token、輸出 Token、緩存命中、緩存寫入及推理拆分的具體數量。

3. 趨勢圖與充值¶

7 日消費趨勢：提供折線圖展示近 7 日的逐日消費，並附帶數據標籤。
一鍵充值：面板內提供“一鍵充值”按鈕，點擊直接跳轉至 platform.deepseek.com/top_up。

4. 界面與交互¶

懸浮膠囊：右下角提供可拖拽的懸浮膠囊。收起狀態下顯示“今日消費”和“當前餘額”摘要及刷新按鈕。展開狀態下顯示完整面板，點擊外部區域可收起。
位置持久化：膠囊位置會在窗口縮放或刷新後自動適配視口。
官方 Token 更新：提供“更新官方 token”按鈕，支持粘貼新 Token 並在驗證有效後寫入配置。
主題適配：僅使用 --dsw-* 主題變量，跟隨 DeepSeek Harness 的亮/暗色主題。
雙語支持：界面語言跟隨 DSH 的語言設置。

安裝與啓用¶

通過命令行安裝插件：

dsh plugin --profile web add github:rickyfu0625-cell/dsh-billing-dashboard

安裝完成後，需要重啓 dsh web 進程並刷新瀏覽器頁面，新的 bundle 會在啓動時組合生效。

數據邏輯與適用範圍¶

運行環境依賴¶

該插件僅適配 DeepSeek Harness（DSH） 環境，不能在 Claude Code 或 Codex 等 Harness 中運行。它依賴 DSH 的 webServer、sessionPersistence、credentials、slots 和 locale 服務。

模型與價格¶

模型識別：僅統計 DeepSeek 官方模型的消費。通過檢測 provider 是否爲 deepseek-official，或模型 ID 是否以 deepseek- 開頭（如 deepseek-flash）來識別。非 DeepSeek 模型不計入消費。
價格同步：插件每天首次請求時會抓取官方定價頁，解析當前價格並持久化。若與生效價不一致，後續消息將按新價折算。

注意事項¶

餘額讀取：需要已配置 DEEPSEEK_API_KEY（在 DSH 設置 → 模型中填寫），密鑰僅用於讀取，不會離開 Host。
官方數據：獲取官方消費數據需要配置 DEEPSEEK_PLATFORM_TOKEN（可通過瀏覽器 DevTools 獲取）。若不配置，將自動回退到本地估算模式。