2. 注册插件(往 patch 文件里追加配置)

cat >> ~/.dsh/profiles/web/cordis.patch.yml <<'EOF'

• insert:
  • id: dsh-cost-tracker name: dsh-cost-tracker EOF

使用说明

设置页「花费统计」

• 时间范围:右上角可切换近 7 天 / 近 30 天 / 全部;
• 消费金额图:支持「按峰谷」「按模型」两种分段方式,鼠标悬停查看当日明细;
• 配色切换:「按模型」视图下,消费金额标题旁有三套装色款条(橙→黄 / 蓝→紫 / 蓝→浅蓝)可切换;模型按总消费降序排名取色(第 1 名最深夜底、逐级变浅,不循环不撞色),选择保存在浏览器本地;
• 分模型区块:每个模型一张请求次数图 + 一张 Tokens 构成图(输入/缓存写入/输出/缓存命中);
• Token 用量统计热力图:类 Codex 的 26 周每日用量方格,颜色深浅按当日 token 相对最大值分档;悬停任一格看该日明细(输入 / 缓存 / 输出 / 费用),今天高亮描边;
• 导出 CSV:导出明细记录(近 180 天)+ 日汇总行(purpose=rollup)。

对话中的 Agent 工具

工具	作用	你可以这样问
cost_stats	查询花费与用量统计	"我今天花了多少钱?"
cost_prices	查看内置单价表与峰谷规则	"现在 deepseek-v4-flash 什么价?"
cost_peak	查询当前峰谷档位与下次切换倒计时	"现在是不是高峰时段?"
cost_recompute	按计费时代重算已入库记录的费用(一次性补账),默认只试算	"把价格调整前的记录按新价重算一下"
cost_reset	清空全部统计数据(不可恢复)	"把花费统计清零"

HTTP API(供其他工具调用)

全部为 POST + JSON,监听本机地址:

POST /api/cost-tracker/summary      概览(含本会话按模型拆分 / 订阅)
POST /api/cost-tracker/dashboard    仪表盘数据
POST /api/cost-tracker/usage        用量热力图(全时段累计 + 按天 token 聚合)
POST /api/cost-tracker/peak         峰谷相位快照(当前档位/下次切换/配置)
POST /api/cost-tracker/peak-config  保存峰谷计价提示配置
POST /api/cost-tracker/kimi-usage   Kimi 订阅配额
POST /api/cost-tracker/balance      账户余额
POST /api/cost-tracker/prices       单价表(按计费时代分版)
POST /api/cost-tracker/recompute    按计费时代重算已入库记录(默认只试算,传 {"apply":true} 落盘)
POST /api/cost-tracker/export       导出 CSV

示例:curl -X POST http://127.0.0.1:3080/api/cost-tracker/summary -d '{}'

---