前言¶
DeepSeek Harness (DSH) 的核心理念是「一切皆插件」。在智能體開發或長期運行的服務中，開發者往往會遇到 Token 消耗過快但難以定位來源的情況：是哪個模型在消耗？哪個項目最貴？是緩存未命中還是推理成本過高？dsh-token-use 插件將實時 Token 用量統計與消費金額估算整合進 DSH 的設置面板，通過可視化的方式解決「看不見的成本」問題。
插件簡介¶
dsh-token-use 是一個實時 Token 用量儀表盤，旨在爲 DSH 提供可視化的用量監控與成本分析能力。
- 定位：Admin / Security 類插件。
- 維護者：huangyuheng。
- 許可：MIT。
核心功能¶
該插件通過設置頁面的四個標籤頁提供全方位的數據支持：
-
概覽
- 卡片展示：顯示估算金額、總量（輸入+輸出+緩存）、輸入、輸出、緩存讀寫、推理與調用次數。
- 趨勢圖：基於 ECharts 繪製。支持堆疊面積圖（緩存/輸入/輸出構成）、金額柱狀圖（右軸）以及顯著的日均參考線。支持 7 / 30 / 90 天切換。
- 使用熱力圖：展示近 12 個月的用量，一格代表一天。支持按「總計」或「金額」着色，懸停即可查看當天的詳細數據。
- 篩選：支持按天/月/年/時間段/全部查詢，以及按模型篩選。
-
模型統計
- 展示所有模型的用量與金額明細表。支持按天、月、年或自定義時間段查詢。
-
項目統計
- 展示所有項目的用量與金額明細表，同樣支持多維度的範圍查詢。
-
配置信息
- 版本與環境：對比各組件（dsh-service、dsh、本插件）的版本與通道（rc/alpha/stable），顯示運行環境參數（平臺、Node 版本、PID、端口、運行時長等）。
- 健康檢查：檢查接口響應、客戶端 bundle 加載情況以及 Harness 自檢（profile 完整性、依賴解析等）。
- 系統操作：支持一鍵重啓與關機操作（均帶二次確認）。
金額估算¶
- 計算邏輯：金額基於 DeepSeek 官方定價 × 本地用量 × 高峯/空閒時段倍率計算。
- 計費範圍：僅統計模型名中包含
deepseek的模型，其他模型（如 claude、gpt）不計金額。 - 數據來源：插件每天抓取一次官方定價頁並緩存，聯網失敗時會使用內置快照兜底。
- 注意：金額爲估算值，受官方調價、緩存計費口徑與統計延時影響，請以官網結算金額爲準。
安裝與啓用¶
安裝後，插件會在 DSH 設置側邊欄中生成一級入口「Token 用量」。
# 通過 npm 包安裝
dsh plugin --profile web add dsh-token-use
# 或從 GitHub 源碼安裝
dsh plugin --profile web add github:huangyuheng/dsh-token-use
# 或從本地解壓目錄安裝
dsh plugin --profile web add /解壓路徑/dsh-token-use
典型用法¶
安裝並重啓 dsh web 後，在設置頁面即可查看數據。插件通過 session/event 事件總線增量累加數據，無需宿主側輪詢。
API 接口示例：
# 獲取概覽數據
curl 'http://127.0.0.1:3080/dsh-token-use?day=2026-09-10'
# 查詢指定月份
curl 'http://127.0.0.1:3080/dsh-token-use?month=2026-09'
# 查詢指定模型
curl 'http://127.0.0.1:3080/dsh-token-use?model=deepseek-v4-flash'
# 獲取版本與運行環境
curl http://127.0.0.1:3080/dsh-token-use/config
# 執行健康檢查
curl http://127.0.0.1:3080/dsh-token-use/health
# 一鍵重啓服務
curl -X POST http://127.0.0.1:3080/dsh-token-use/restart
# 關機
curl -X POST http://127.0.0.1:3080/dsh-token-use/shutdown
注意事項¶
- 運行環境：需要
dsh web版本 ≥ 0.1.0-rc.6。 - 數據依賴：插件需要聯網獲取最新定價，失敗時使用內置快照。
- 統計口徑：金額爲估算值，且僅統計 DeepSeek 模型。輔助調用（如聯網搜索、會話標題）不計金額。
- 性能設計：宿主側不寫盤、不加定時器，完全基於事件總線增量更新，避免資源浪費。
