DeepSeek Harness 用量日報插件

前言¶

在使用 DeepSeek Harness (DSH) 進行開發或日常對話時，掌握當日 token 消耗和費用是剛需。手動統計效率低，且容易遺漏。該插件通過讀取 DSH 自身的會話日誌，在 Web 界面右下角提供實時彙總。

插件定位¶

這是一個給 DSH Web 界面用的用量日報掛件。常駐右下角，自動統計當天各會話的 token 消耗、消息數、輪數，並用 DeepSeek 價格估算費用。插件由 HaoR325 維護，開源協議爲 MIT。

核心功能¶

• 今日用量彙總：展示輸入/輸出/緩存 token、消息數、輪數以及估算費用。
• 自動刷新與緩存：支持 60s 自動刷新，服務端緩存機制確保不刷屏，不額外壓榨 API。
• 費用估算：按 DeepSeek 默認價格計算，支持通過環境變量覆蓋單價。
• 浮窗 UI：在右下角顯示半透明卡片，具備 NaN 安全處理，刷新即用。
• HTTP 接口：提供 GET /api/dsh-usage-daily/report 接口，返回當日聚合 JSON，方便二次開發。

安裝與啓用¶

使用本地鏈接方式安裝，避免依賴網絡倉庫。

dsh plugin --profile web add link:<本倉庫絕對路徑>

安裝完成後，重啓 dsh web，在瀏覽器中按 F5 刷新，右下角即可看到用量日報浮窗。

環境變量配置¶

插件默認按 DeepSeek 官方價格計算費用。如需調整，可通過環境變量覆蓋，單位爲 USD / 百萬 token。

接口說明¶

插件通過 webServer 註冊了 HTTP 接口，用於獲取數據。

接口地址：

GET /api/dsh-usage-daily/report

返回示例：

{
  "ok": true,
  "date": "2026-01-01",
  "sessions": 3,
  "messages": 41,
  "turns": 12,
  "totals": { "input": 12345, "output": 6789, "cacheRead": 0, "cacheWrite": 0 },
  "totalTokens": 19134,
  "costUsd": 0.0087,
  "perSession": [
    { "id": "session-1", "messages": 20, "turns": 8, "tokens": 12345 }
  ]
}

技術細節¶

• 數據來源：數據直接來自 DSH 自身的會話日誌（sessionQuery.readSession），無需任何令牌或調用平臺費用接口。
• 技術棧：純 Node ESM，無外部依賴。
• 實現方式：通過 tapIndex 注入右下角浮窗腳本，並使用 sessionQuery.listSessions / readSession 聚合當日事件。

總結¶

該插件通過服務端緩存和本地日誌讀取，實現了對 DSH 每日消耗的精準監控，適合需要控制成本的智能體開發者使用。更多細節可查閱生態目錄或GitHub 倉庫。