前言¶
在 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。
