DSH Cost Tracker · 花费统计
一个为 DeepSeek Harness 打造的 LLM 花费统计插件:自动记录每一次 API 调用的 Token 用量与费用(人民币),原生支持 DeepSeek 官方峰值价格计费(高峰 / 闲时半价自动区分)与 Kimi Coding Plan 订阅套餐的用量及等效费用统计。设置页可视化仪表盘、图表悬停明细、对话内 Agent 查询、账户余额与订阅配额监控,数据全部本地持久化——重启不丢、卸载无痕。
An LLM cost-tracking plugin for DeepSeek Harness: records token usage and cost (CNY) for every API call, with native support for DeepSeek's official peak/off-peak pricing and Kimi Coding Plan subscription usage & equivalent-cost statistics. Visual settings dashboard with hover tooltips, in-chat agent queries, balance & quota monitoring — all persisted locally.
它能做什么?
| 功能 | 说明 | |
|---|---|---|
| 💰 | 花费统计 | 每一次 API 调用自动记账:输入 / 输出 / 缓存命中 / 缓存写入 Tokens 与费用,按天、按模型聚合 |
| ⏰ | 峰谷定价 | 内置单价表,高峰时段(北京时间 9:00–12:00、14:00–18:00)与闲时半价自动区分,本地模型(ollama 等)计 0 |
| 📊 | 可视化仪表盘 | 设置页新增「花费统计」:概览卡片、消费柱状图(按峰谷/按模型)、分模型的请求次数与 Tokens 图表,全部支持鼠标悬停查看明细 |
| 📈 | 订阅配额监控 | Kimi Coding Plan 等订阅套餐:本周配额、5 小时滚动窗口限额、等效按量费用参考 |
| 💳 | 余额查询 | 一键查询 DeepSeek 官方账户余额(总余额 / 充值 / 赠送 / 状态) |
| 🤖 | Agent 工具 | 直接在对话里问:"我现在花了多少钱?"——Agent 会调用 cost_stats / cost_prices 等工具回答 |
| 🔻 | 状态栏 | 聊天输入框下方实时显示:本会话花费、累计花费、当前峰/闲时价 |
| 💾 | 本地持久化 | 数据存本机 ~/.dsh/storages/cost-tracker-records.json,重启不丢、不上传 |
| 📤 | CSV 导出 | 一键导出全部记录,方便用 Excel / Numbers 做进一步分析 |
界面展示
在对话中直接查询——Agent 自带花费/余额/单价工具,边聊边查:
订阅套餐与账户余额——配额进度条、重置倒计时、余额一目了然:
分模型明细——每个模型的请求趋势、Token 构成,悬停显示每日明细:
安装(二选一)
前提:你已经在用
dsh web(DSH 的 Web 模式)。~/.dsh即 DSH 的数据目录(如设置了DSH_HOME环境变量则指向该目录)。
方式一:让 DSH 帮你装(推荐,不懂命令行也能用)
打开 DSH 的任意会话,把下面这段话原样粘贴发送给 Agent 即可:
请帮我安装 DSH 插件 dsh-cost-tracker:
1. git clone https://github.com/Angelyeye/dsh-cost-tracker.git 到 ~/.dsh/profiles/node_modules/dsh-cost-tracker(目录名必须叫 dsh-cost-tracker)
2. 在 ~/.dsh/profiles/web/cordis.patch.yml 顶层数组追加一行:
- insert:
- id: cost-tracker
name: dsh-cost-tracker
3. 完成后告诉我,我自己重启 dsh web
看到提示后,在终端按 Ctrl+C 停掉 dsh web,再重新运行 dsh web,刷新浏览器即可。
方式二:手动安装(3 条命令)
# 1. 下载插件(目录名必须与包名一致)
mkdir -p ~/.dsh/profiles/node_modules
git clone https://github.com/Angelyeye/dsh-cost-tracker.git ~/.dsh/profiles/node_modules/dsh-cost-tracker
# 2. 注册插件(往 patch 文件里追加配置)
cat >> ~/.dsh/profiles/web/cordis.patch.yml <<'EOF'
- insert:
- id: cost-tracker
name: dsh-cost-tracker
EOF
# 3. 重启 DSH(先 Ctrl+C 停掉当前 dsh web,再执行)
dsh web
验证安装成功
- 浏览器打开 DSH Web GUI → 左下角 设置 → 侧边栏出现 「花费统计」;
- 聊天输入框下方出现一行花费状态条;
- 对 Agent 说一句"查一下我现在的花费",能正常回答即全部就绪。
⚠️ 如果
~/.dsh/profiles/web/cordis.patch.yml里已有其他内容,请保留原有行,只追加上面那段;该文件顶层必须是 YAML 数组(每行以-开头)。
使用说明
设置页「花费统计」
- 时间范围:右上角可切换近 7 天 / 近 30 天 / 全部;
- 消费金额图:支持「按峰谷」「按模型」两种分段方式,鼠标悬停查看当日明细;
- 分模型区块:每个模型一张请求次数图 + 一张 Tokens 构成图(输入/缓存写入/输出/缓存命中);
- 导出 CSV:导出当前时间范围内的全部记录。
对话中的 Agent 工具
| 工具 | 作用 | 你可以这样问 |
|---|---|---|
cost_stats |
查询花费与用量统计 | "我今天花了多少钱?" |
cost_prices |
查看内置单价表与峰谷规则 | "现在 deepseek-v4-flash 什么价?" |
cost_reset |
清空全部统计数据(不可恢复) | "把花费统计清零" |
HTTP API(供其他工具调用)
全部为 POST + JSON,监听本机地址:
POST /api/cost-tracker/summary 概览
POST /api/cost-tracker/dashboard 仪表盘数据
POST /api/cost-tracker/kimi-usage Kimi 订阅配额
POST /api/cost-tracker/balance 账户余额
POST /api/cost-tracker/prices 单价表
POST /api/cost-tracker/export 导出 CSV
示例:curl -X POST http://127.0.0.1:3080/api/cost-tracker/summary -d '{}'
常见问题
Q:数据存在哪里?安全吗?
全部数据只存在你本机的 ~/.dsh/storages/cost-tracker-records.json,不会上传到任何服务器。API 只监听本机回环地址,但无鉴权——不要把 DSH 端口暴露到公网。
Q:重启 DSH 数据会丢吗?
不会。记录会防抖写入磁盘(原子写入,上限 5000 条),重启后自动恢复;文件损坏时自动备份为 .corrupt-<时间戳> 并从头开始。
Q:订阅套餐(kimi-coding)的"等效费用"是什么意思? 订阅制不按量扣费。插件按内置单价估算出"如果这些调用走按量计费会花多少钱",仅供你评估订阅是否划算,不是真实扣费。
Q:金额和官方账单对不上? 插件在本地按内置单价表估算,可能与官方实际计费存在细微差异(如官方价格调整、阶梯定价)。精确金额请以官方账单为准。余额以「余额查询」实时拉取的官方数据为准。
Q:如何卸载?
- 打开
~/.dsh/profiles/web/cordis.patch.yml,删除cost-tracker那段- insert:(共 4 行),或直接让 DSH Agent 帮你删; - 重启
dsh web; - 可选:删除插件目录
~/.dsh/profiles/node_modules/dsh-cost-tracker和数据文件~/.dsh/storages/cost-tracker-records.json。
Q:如何更新插件?
进入插件目录执行 git pull,然后:只改了界面(client.js)的话硬刷新浏览器(Cmd/Ctrl+Shift+R)即可;改了 index.js 则需要重启 dsh web。
仓库结构
├── index.js Host 半端:用量采集、聚合、持久化、HTTP API、Agent 工具
├── client.js Client 半端:设置页仪表盘与状态栏 UI
├── package.json 插件清单(含 dsh.client 声明)
└── docs/ README 截图
License
MIT · 欢迎 Issue 与 PR
还没有评论，来写第一条。