前言¶
DeepSeek Harness（DSH）採用插件化架構，將功能模塊化以適應不同的使用場景。在本地部署或使用 DSH 進行對話時，追蹤 Token 消耗、估算費用以及管理多平臺餘額是基礎且高頻的需求。現有的做法往往分散在不同渠道，缺乏統一的視圖。本插件旨在將這些數據聚合，提供可視化的儀表盤與實時讀數。
插件簡介¶
nigel211/dsh-token-usage 是 DSH 的一個 Token 用量與費用統計插件。它不依賴第三方服務，數據完全派生自 DSH 的持久化會話日誌。安裝並重啓服務後，插件會自動回填歷史數據，支持按模型、會話、時間範圍進行聚合統計，並提供了費用估算與多平臺餘額查詢功能。
核心功能¶
用量統計¶
插件從 DSH 日誌中提取數據，支持統計輸入、輸出及緩存命中 tokens。用戶可以按模型、按會話或按時間範圍（今天、近7天、近14天、近30天）進行聚合查看。
費用估算¶
內置 DeepSeek 官方人民幣價目表。計價邏輯基於生效日期分段：
* 8-17 前舊價：統一按舊價估算。
* 8-17 起峯谷價：按北京時間分段計費，9:00–12:00 與 14:00–18:00 爲高峯時段，其餘時間爲谷段（半價）。
價目表支持增刪改並持久化。對於未知模型，用戶可手動添加價格，系統將立即按此計算費用。
賬戶餘額¶
支持自動枚舉已配置的模型路由（如 DeepSeek 官方、pi-ai 等）。通過模板化查詢，支持 DeepSeek、OpenRouter、SiliconFlow、New-API 等平臺。餘額查詢帶有 60 秒緩存，支持 keep-last-good 策略與瞬時/確定性錯誤分類。DeepSeek 官方行界面中包含“充值”按鈕，可直接跳轉開放平臺。
圖表與界面¶
- 圖表展示：包含趨勢圖（單圖四曲線 + 雙軸費用）、當月日曆活躍熱力圖（藍色深淺代表 tokens）以及模型佔比環圖（支持懸停聯動）。
- 儀表盤：位於設置頁面的「Token 用量」區塊，展示費用 Hero 指標、賬戶餘額卡片、使用趨勢、活躍熱力圖等。
- 常駐讀數：在對話輸入框下方常駐顯示本會話 tokens / 費用、今日費用。
安裝與啓用¶
本插件僅發佈在 GitHub，npm registry 上存在同名衝突包，切勿使用裸包名安裝。
使用 GitHub 語法安裝：
dsh plugin --profile web add github:Nigel211/dsh-token-usage
（若需指定版本，可追加 #v0.1.15）
安裝完成後，必須重啓 dsh web 服務，插件功能纔會生效。
典型用法¶
- 查看用量：重啓服務後，進入「設置 → Token 用量」，儀表盤會自動加載當前範圍的數據。
- 調整價格：若使用非官方模型，可在儀表盤的「價目表」區域手動添加價格，費用計算將立即更新。
- 查詢餘額：打開設置頁時，插件會自動查詢各路由余額。DeepSeek 官方行可點擊充值按鈕。
- 查看趨勢：在「使用趨勢」圖表中切換時間範圍（如近7天），觀察輸入/輸出/緩存命中與費用的變化曲線。
注意事項¶
- 歷史數據回填：歷史回填僅統計
assistant/message中攜帶usage字段的調用，未上報 usage 的調用不計入。 - API Key 安全：餘額查詢時，API Key 通過 DSH 憑證服務解析，僅傳給對應平臺接口，絕不寫入日誌。
- 價格限制：8-17 之前的歷史調價未分段，統一按舊價估算。
- 權限要求：餘額查詢依賴
curl（Windows 10+ 自帶）或 PowerShell，需確保網絡可達對應平臺接口。
結語¶
該插件通過複用 DSH 日誌數據，實現了從用量統計到費用估算、再到餘額管理的閉環。對於需要精細控制成本或管理多平臺 API Key 的用戶，它提供了一個簡潔、現代的集中化視圖。相關代碼與目錄可訪問 GitHub 倉庫 查看。
