花费 · @local/dsh-token-spend
每一笔 token 都算清楚。 在设置里加一页「花费」：直接读本机已提交的会话日志，把每日全部用量做成热力图、构成图、14 天趋势和当天明细——不联网、不读账单、不另建数据库。
它做什么
- 全部用量：输入 + 缓存读取 + 缓存写入 + 输出（等于服务商的
totalTokens，不是只看 input+output）。 - 今日 / 昨日：顶部给出今日用量与环比。
- 用量构成：四类 token 的占比条。
- 14 天趋势 + 每日热力图：按本地日历日分桶，点色块看当天明细。
- 当天明细：当天每个会话、每个模型各花了多少，以及缓存命中率。
- 预算条：日预算。没配
budgetTokens时按历史最忙一天 ×1.25 取整推出来，只作参照。 - 已删除会话仍计入：删掉会话不会让历史花费凭空缩水，页面会单列这部分占比。
两条计数规则
- 一次调用只记一次。 seed / fork / 子智能体会把继承的事件前缀复制进自己的日志，同一个
message.id可能出现在多个文件里；用量按该 id 计数一次。 - 缓存读不算输入。 服务商的
inputTokens不含缓存读取，而缓存读在真实日志里约为新鲜输入的 16 倍；只用 input+output 会把用量低估约 94%。
折叠结果按会话的 snapshot.revision 缓存，刷新时只重读真正变过的日志。
已删除会话的账本
永久删除会整目录删掉会话日志，纯日志派生的总量会「改写历史」。所以插件把见过的用量按天、按会话、按模型记在：
/storages/token-spend/ledger.json
只有计数器——没有标题、没有路径、没有消息内容。写入是「临时文件 + rename」的原子替换，写坏了也不会抹掉已记录的量。retainDeleted: false 可关掉保留。
接口
| 方法 | 路径 | 说明 |
|---|---|---|
GET |
/token-spend/summary |
聚合结果；?refresh=1 跳过 30 秒缓存 |
返回 totals / days / sessions / models / today / budget / cacheHitRate / retainedDeleted。
文件
| 文件 | 作用 |
|---|---|
index.js |
Host 半：注册 /token-spend/summary，折叠会话日志、维护日账本。 |
client.js |
Web 半：设置页、样式、侧栏图标。 |
cordis.patch.yml |
插入 token-spend Loader 行。 |
locale/en.json、locale/zh.json |
插件管理器和设置页显示的元数据。 |
icon.svg |
原始线条图标。 |
配置
| 键 | 默认 | 说明 |
|---|---|---|
budgetTokens |
0 |
日预算；0 表示按峰值自动推 |
cacheTtlMs |
30000 |
内存缓存时长 |
retainDeleted |
true |
保留已删除会话的用量 |
ledgerPath |
/storages/token-spend/ledger.json |
账本路径 |
安装
通过 Plugin Manager（install_bundle）安装包目录或发布包，或把它加进 profile 的 bundle 列表。宿主代码改动需要重启应用；客户端代码随页面重新加载。
发布包
npm pack # → dsh-token-spend-1.0.0.tgz（package/ 为根）
包内即 files 列表 + README.md + LICENSE。
许可
MIT © 2026 xiaobaga281
