DeepSeek Harness (DSH) 採用了插件化架構，允許開發者通過擴展功能來增強工作流。在長期使用 DSH 進行開發或調試時，追蹤 Token 消耗、估算費用以及分析模型性能是常見需求。dsh-token-usage 插件旨在解決這一問題，它通過監聽 DSH 的會話日誌，爲用戶構建了一個可視化的統計面板。
核心功能¶
該插件主要提供以下統計維度：
- 實時與歷史回放：實時監聽所有會話的事件流，並在啓動時回放全部歷史會話日誌。這意味着統計包含安裝插件前的歷史用量，且重啓服務不丟失數據。
- 概覽面板：展示今日、本週、本月的 Token 總量及費用估算，並細分爲輸入、輸出、緩存命中等類別。
- 任務統計：分析本週任務，包括思考時長（通過
reasoning-delta片段計算）、總任務時長、任務數及步驟數。 - 排行榜：
- 任務 Top 3：本週 Token 消耗最高的任務。
- 模型排行：本週各模型的 Token 消耗佔比、進度條及費用。
- 項目統計：按工作區（會話 cwd）分組的用量，支持切換本週/全部視圖。
- 圖表展示：近 14 天的堆疊柱狀圖，鼠標懸停可查看當日明細。
- 價格設置：支持 DeepSeek 官網的峯谷計價規則（高峯時段價格翻倍），並支持一鍵從官網獲取最新定價。
安裝與啓用¶
在安裝前，請確保已安裝 DeepSeek Harness (DSH)、git 與 pnpm。
一鍵安裝¶
使用官方提供的安裝腳本：
bash -c "$(curl -fsSL https://raw.githubusercontent.com/KeFan-J/dsh-token-usage/main/install.sh)"
腳本會自動克隆倉庫、安裝依賴並將插件掛載到 DSH web profile。安裝完成後，執行以下步驟啓用插件：
- 重啓 DSH 服務：
npx @deepseek-ai/dsh web
- 在瀏覽器中強制刷新頁面（
Cmd+Shift+R）。 - 打開設置（齒輪圖標），在設置列表中找到並點擊「Token 用量」。
手動安裝¶
如果需要自定義安裝路徑，可使用以下命令：
git clone https://github.com/KeFan-J/dsh-token-usage.git
cd dsh-token-usage
pnpm install
dsh plugin --profile web add "link:$(pwd)"
# 重啓 DSH + 強制刷新瀏覽器
實現原理¶
- Host 端：監聽全局
session/event事件流，啓動時回放日誌。通過sessionId:seq去重以防止重複計算。根據生效的定價規則（含峯谷）計算費用，並提供 JSON API 路由。 - 瀏覽器端：在 DSH 的設置槽位中註冊頁面，樣式使用
--dsw-*主題變量以適配亮/暗模式。 - 掛載方式：通過
cordis.patch.yml以裸插件行掛載到 DSH profile 的 bundle 層，無需修改 DSH 源碼。
數據與隱私¶
- 本地存儲：所有數據僅存本地，用量來源於 DSH 自身的持久化會話日誌，費用在本地計算，不上傳任何遙測數據。
- 對外請求：插件唯一的對外請求是「從官網獲取最新價格」按鈕，該操作僅讀取 DeepSeek 公開定價頁面的內容。
許可證¶
MIT
