前言¶
在 DeepSeek Harness (DSH) 的 Web 模式下，記錄每次模型推理的 Token 用量與費用是常見需求。dsh-cost-tracker 插件用於此目的。它自動記錄每次 API 調用的 Token 用量與費用（CNY），支持峯谷定價，並提供 Agent 工具以供查詢。
核心功能¶
- 花費統計：自動記錄每次 API 調用的 Token 用量與費用（CNY），包括輸入、輸出和緩存命中。
- 峯谷定價：內置單價表。高峯時段（週一至週五 9:00–12:00、14:00–18:00，不含法定節假日）與閒時半價自動區分。週末與法定節假日全天計爲閒時。本地模型計 0。
- 可視化儀表盤：設置頁提供概覽卡片、消費柱狀圖和用量熱力圖。支持懸停查看明細。
- Agent 工具：在對話中詢問“我現在花了多少錢？”等，Agent 會調用
cost_stats/cost_prices等工具回答。 - 多機彙總：支持多機彙總（雲端同步），需對接自建雲端服務。
- 訂閱配額監控：支持 Kimi Coding Plan、火山方舟 Coding Plan 等訂閱套餐的配額監控與等效費用統計。
- 其他功能：餘額查詢、CSV 導出、歷史導入（v1.9.0）、官方價格同步（v1.9.0）、多廠商價格目錄（v1.9.0）、Plan 與按量雙軌（v1.9.0）、憑據零落盤（v1.9.0）。
安裝與啓用¶
在終端執行以下命令安裝插件：
dsh plugin --profile web add @angelyeye/dsh-cost-tracker
安裝完成後，重啓 dsh web 並刷新瀏覽器。在 DSH Web GUI 的設置頁面中應出現“花費統計”側邊欄，聊天輸入框下方應顯示花費狀態條。
典型用法¶
在對話中直接詢問花費情況。例如輸入：“我現在花了多少錢？”，Agent 將調用相關工具返回統計結果。
注意事項¶
- 本地持久化：數據存儲在本地，重啓不丟失、不上傳。
- 版本缺陷：v1.7.0 存在客戶端註冊缺陷，任何安裝方式裝出來的都無法加載。請使用 v1.7.1 或更高版本。
- 升級清理：v1.9.1 升級時，不要僅“再裝一次新版”，必須先清掉舊文件，否則會導致重複加載。
- 設置位置：v1.9.0 起，設置集中在“設置 → 花費統計 → 右上角齒輪”。
生態背景¶
DSH 理念是“一切皆插件”。此插件由社區開發者 Angelyeye 維護，開源協議爲 MIT。
