前言¶
在使用 DeepSeek Harness (DSH) 進行智能體開發時，追蹤跨會話的 Token 消耗、請求頻率以及對應的成本是成本控制和性能優化的基礎。現有的 DSH 官方界面通常側重於實時對話，缺乏長期的用量彙總視圖。
插件介紹¶
dsh-token-usage-stats 是一個 DSH Web 插件，用於統計跨會話的 Token 用量、請求次數與可選成本。該插件提供了獨立的儀表盤頁面以及側邊欄底部的入口，方便開發者查看詳細的用量數據。
- 維護者：jkStars
- 許可證：MIT
- 定位：聯網工具 / 統計分析
核心功能¶
該插件具備以下核心能力：
- 跨會話統計：記錄並統計所有會話的 Token 用量與請求次數。
- 獨立儀表盤：提供獨立的 Web 頁面展示統計結果。
- 數據源接口：提供 JSON 數據源 API (
/api/token-usage-stats) 供外部調用。 - 視圖切換：支持按小時（今天）和按天（近 3 天、近 7 天、近 30 天、全部）的視圖切換。
- 智能計價：支持自定義模型定價，並內置了基於北京時間的“高峯/閒時”兩檔計價邏輯（週末按閒時）。
- 自動刷新：儀表盤數據每 10 秒自動刷新一次。
- 側邊欄集成：在側邊欄底部提供入口，點擊後以模態框形式打開儀表盤。
安裝與啓用¶
使用官方提供的安裝命令將插件添加到 Web Profile 中。
dsh plugin --profile web add dsh-token-usage-stats@0.3.14
安裝後，插件會自動注入到 cordis.patch.yml 配置中，並嘗試通過 dsh.client 清單自動加載瀏覽器端資源。安裝完成後，重啓宿主或刷新 GUI 界面即可生效。
配置¶
插件支持通過 cordis.patch.yml 配置貨幣類型和模型定價。只有配置了定價，儀表盤纔會顯示具體的成本金額。
默認配置包含 CNY 貨幣以及 deepseek-flash 和 deepseek-v4-pro 的官方高峯/閒時定價。
在你的 Profile 配置文件中覆蓋示例配置：
- patch:
- id: token-usage-stats
config:
currency: USD
pricing:
deepseek-flash:
peak:
uncachedInputPerMillion: 2.0
cacheReadPerMillion: 0.04
cacheWritePerMillion: 0
outputPerMillion: 8.0
offpeak:
uncachedInputPerMillion: 1.0
cacheReadPerMillion: 0.02
cacheWritePerMillion: 0
outputPerMillion: 4.0
計價邏輯說明：
* 高峯時段：北京時間 09:00-12:00，14:00-18:00。
* 閒時時段：除高峯時段外的其他時間，且週末全天按閒時計算。
* 對於支持四檔定價的模型，系統會根據使用時間取對應檔位價格；對於只使用 peak/offpeak 兩檔的模型，任意時段按對應檔位計算。
典型用法¶
安裝並配置完成後，可以通過以下方式訪問儀表盤：
- 側邊欄入口：點擊側邊欄底部的「用量統計」按鈕，儀表盤會以模態框形式彈出。
- 直接訪問：在瀏覽器中訪問
http://<host>:<port>/token-usage-stats。
進入儀表盤後，默認顯示「今天」的按小時視圖。你可以通過頂部的下拉菜單切換時間範圍（今天、近 3 天、近 7 天、近 30 天、全部）。對於跨度較長的「全部」範圍，圖表會自動按自然周或自然月摺疊展示，以保持清晰度。
注意事項¶
在使用該插件時，請注意以下事實：
- 統計範圍：目前僅統計 DeepSeek 官方 API 的費用。基於本地 Harness 會話日誌進行回放計算，不包含其它提供商或渠道的 API 費用。
- 成本顯示：只有當你在配置中設置了模型定價時，儀表盤纔會顯示成本金額。
- 數據來源：數據來源於本地歷史會話日誌，並非實時的 API 費用查詢。
- 權限與安全：該插件以插件形式運行，請確保安裝來源可信，並在使用前檢查源代碼與許可證。
結語¶
dsh-token-usage-stats 是一個輕量級的統計工具，通過儀表盤和側邊欄入口，幫助開發者直觀地掌握 Token 消耗趨勢。配合自定義定價功能，可以精確計算不同時段的成本，適合需要精細化成本控制的 DSH 用戶。
