前言¶
DeepSeek Harness (DSH) 的 Web 界面在本地處理交互，但通常缺乏詳細的 Token 消耗追蹤和賬戶餘額監控。dsh-cost-meter 插件通過在底部狀態欄直接展示 DeepSeek 會話成本估算和賬戶餘額，解決了這一痛點。
插件介紹¶
由 AnakinCao 維護的 Web GUI 插件。它不參與模型推理，而是讀取本地會話日誌和官方定價接口，將成本估算和餘額信息實時反饋給用戶。
核心功能¶
1. 實時模型價格
插件通過 session.models RPC 獲取當前選中的模型，並顯示其實時價格（單位：CNY/1M tokens）。價格順序爲：緩存命中 / 緩存未命中 / 輸出。插件支持自動切換高峯與非高峯定價（北京時區，工作日 9-12, 14-18 爲高峯，週末全天爲非高峯），模型切換後約 2.5 秒內更新。
2. 成本聚合與去重
插件掃描 ~/.dsh/sessions 目錄下的會話文件，按會話聚合今日成本。
* 會話合併：通過 parentSession 自動將子會話（Subagent）合併到根會話中。
* 去重機制：DSH 子會話文件包含父會話的完整事件，插件通過（時間、輪次、步驟、計數）指紋進行全局去重，防止重複計費（此前可能導致成本虛高約 5 倍）。
* 工作區顯示：Tooltip 中顯示會話的工作區目錄名稱。
3. 今日與會話成本
成本數據從官方定價頁實時抓取（緩存 1 小時），並依據生效日期（2026-08-17 生效）和時間段自動選擇價格。若抓取失敗，則回退到內置常量。
4. 餘額監控
插件每 60 秒查詢官方 GET https://api.deepseek.com/user/balance 接口。當餘額低於默認閾值（BALANCE_WARN_CNY，默認 50 CNY）時，狀態欄整行變紅。
5. Token 類型統計
Tooltip 中展示了歷史會話按內容類型分類的 Token 消耗分佈（如代碼、推理、工具輸出等），幫助進行 Token 優化。
安裝與啓用¶
使用官方 CLI 安裝：
dsh plugin --profile web add https://github.com/AnakinCao/dsh-cost-meter.git
# restart dsh web
配置¶
插件需要 API Key 才能查詢餘額。解析順序如下：
1. 插件配置 config.apiKey
2. 環境變量 DEEPSEEK_API_KEY
3. ~/.dsh/.credentials.yaml 中的 DEEPSEEK_API_KEY
若未配置 Key，狀態欄僅顯示“balance fetch failed”，但成本估算仍正常顯示。
典型用法¶
在底部狀態欄，你會看到類似以下信息：
stats row · TPS Flash off-peak 0.05/1.5/4.5 · Today ¥11.52 (5 sessions) · Session ¥0.08 · Balance ¥365.36
鼠標懸停在狀態欄上可查看詳細的會話成本分解和價格來源。
注意事項¶
- 成本估算：顯示的是估算值（官方單價 × 使用量），權威賬單以 DeepSeek 平臺爲準。
- 安全性：餘額和定價查詢在主機進程運行，API Key 從不離開瀏覽器。
- 資源佔用：插件不消耗 Token，僅讀取日誌；餘額查詢有 1 小時緩存。
- 卸載：刪除插件目錄
node_modules/dsh-cost-meter並移除配置文件中的 patch 插入項。
