前言¶
DeepSeek Harness (DSH) 是本地智能體測試工具。原生 Web 界面缺少對 Token 消耗和成本的直觀展示。dsh-token-usage 插件爲 DSH 的 Web 配置面板新增了“使用統計”頁面，通過將原始 Token 消耗轉換爲官方的高峯/非高峯費率，幫助開發者量化實際支出。
插件介紹¶
dsh-token-usage 是一個用於 DeepSeek Harness 的插件。它不修改智能體運行邏輯，僅作爲觀察者讀取持久化的會話日誌，在本地計算並展示 Token 使用情況和估算成本。
核心功能¶
該插件提供以下核心能力：
- 摘要卡片：展示總 Token 數、日均、緩存命中率、估算支出。支持按“今天/本週/本月”切換。
- 熱力圖：提供 3 個月的 GitHub 風格水平熱力圖。懸停任意日期單元格可查看該日的詳細 Token 統計和支出（CNY/USD）。
- 真實成本估算：使用官方的高峯/非高峯費率計算真實成本，並自動轉換爲 CNY 和 USD。
- 價格表管理：支持按模型編輯價格表，包含 CNY/USD 以及高峯/非高峯兩個時段的價格配置。
- 精確計費：根據事件時間戳計費。北京高峯時段（09:00–12:00, 14:00–18:00）使用高峯費率，其餘時段使用非高峯費率。
- 純觀察者模式：不修改 Agent 循環，不上傳數據到外部服務，數據完全存儲在本地。
安裝與啓用¶
插件安裝到 DSH 的內置 Web 配置文件中。
使用 npm 安裝（推薦）¶
dsh plugin --profile web add dsh-token-usage
使用本地路徑安裝¶
如果直接使用本地源碼安裝，需先構建：
pnpm build
dsh plugin --profile web add /path/to/dsh-token-usage
啓動¶
安裝後，從 DeepSeek Harness 檢出目錄運行即可：
pnpm dsh web
配置與使用¶
數據來源於持久化會話日誌中的 usage 字段。
價格配置¶
插件支持通過 Web 配置文件或 --patch 覆蓋層修改價格表。配置文件路徑通常爲 $DSH_HOME/profiles/web/cordis.patch.yml。
在配置中定義模型的價格，包含貨幣類型、高峯/非高峯費率以及輸入/輸出/緩存讀寫等各項指標。未配置的模型將使用內置的默認值。
索引位置¶
插件使用增量索引存儲數據，索引文件位於 $DSH_HOME/dsh-token-usage/index.。系統會定期進行磁盤同步，確保重啓後能快速恢復統計數據。
