DSH（DeepSeek Harness）是智能體開發框架，Web 界面是其主要交互入口。在調試或長時間運行任務時，開發者需要實時掌握賬戶餘額與 Token 消耗情況。手動查詢 API 或查看日誌會打斷工作流。dsh-usage-panel 插件通過集成監控功能，將這些數據直接展示在會話頭部。
dsh-usage-panel 是一個客戶端插件，由 Mysterious Mark 維護。它爲 DSH Web 界面提供 DeepSeek 賬戶餘額與當前會話 Token 用量的實時監控面板，數據以彩色膠囊形式顯示在會話頭部右側。
核心功能¶
- 餘額顯示：調用官方
GET /user/balance接口，顯示總額、充值金額與贈送金額。 - Token 用量：讀取宿主
tokenUsage投影，展示未緩存輸入、緩存命中、緩存寫入、輸出、合計以及緩存命中率。 - 三級餘額預警：支持自定義閾值，根據餘額充足/警告/不足狀態改變膠囊顏色。
- 充值入口：提供去充值、用量明細、登錄平臺、複製鏈接入口，支持在新標籤頁、當前標籤頁或複製鏈接打開。
- 查詢效率優化：僅在頁面可見時進行輪詢，頁面隱藏時暫停；支持失敗指數退避、宿主端 30s 緩存與單飛窗口、手動刷新。
- 跨端兼容策略：
- 宿主端優先使用
ctx.connection.fetch並回退ctx.webServer。 - 瀏覽器端優先使用
conversation.session.header.utilities，其次conversation.session.header.corner。 - 純 JavaScript 實現，無平臺相關代碼。
安裝與啓用¶
在終端執行以下命令將插件安裝到 Web profile：
dsh plugin --profile web add dsh-usage-panel
安裝完成後，重啓 dsh web（或等待熱重載）並刷新頁面即可看到效果。
典型用法與配置¶
安裝後，面板會自動顯示在會話頭部右側。如需調整參數，可在 patch 中配置以下字段：
| 字段 | 默認值 | 說明 |
|---|---|---|
routePath |
/api/usage-panel/balance |
宿主端用於接收餘額請求的路由 |
cacheMs |
30000 |
上游緩存時間與單飛窗口（毫秒） |
apiKeyEnv |
DEEPSEEK_API_KEY |
用於解析密鑰的環境變量名 |
baseUrl |
https://api.deepseek.com |
服務商 API 地址 |
baseUrlEnv |
DEEPSEEK_BASE_URL |
用於覆蓋 baseUrl 的環境變量名 |
適用場景與注意¶
- 宿主端：需要 Node.js 18 及以上版本。插件以當前 dsh 進程的權限運行，安裝前請檢查源碼與許可證。
- 瀏覽器端：依賴內置 React 與 slots 服務。
- 容錯：若宿主端缺少
useProjection投影，餘額信息仍可正常顯示。
該插件通過可視化面板解決了餘額監控與用量追蹤的痛點，適合需要在 Web 界面持續監控成本的 DSH 用戶。
