DSH Token 用量统计
在 DSH 设置中查看真实 Token 消耗、缓存命中、活动热力图和模型分布。仅显示用量，不估算费用。
dsh plugin --profile web add github:xgxx666/dsh-clear-usage
适用于 DSH 0.2.0-rc.2 及更高兼容版本的 Web profile。
使用位置
- 输入框下方完全使用 DSH 原版状态栏及详情弹窗，插件不再替换这部分界面。
- 设置 → 用量统计：查看今天、本月、全部的用量，紧凑热力图和按模型分组的列表。
- 自定义：选择开始和结束日期后点击「查询」，包含首尾两天。
- 热力图跟随顶部时间筛选；悬停显示日期和简写 token 数量的两行深色提示。模型用量以居中的圆环图显示，圆心展示总 token，下方颜色图例显示各模型的用量、类型和占比。
- 在页面底部展开「模型类型」，点击分段按钮把连接标为本地或 API，自动保存，仅影响筛选。删除按钮只移出管理列表，不删除 DSH 模型配置或会话日志；可在「已删除的模型」里恢复，历史 token 统计保持不变。
- 本地和 API 模型都只显示 token，不显示金额，不需要填写单价。
数据口径
token 来自已结算调用的真实 usage。重试单独累计；同一次调用的更新覆盖旧样本；思考 token 已含在输出内，不重复加总。历史统计排除会话分支的继承前缀，防止重复计算。缓存未报告或记录不完整时明确提示。
插件只注册设置页。输入框用量、速度和点击详情均由 DSH 原版提供。
缓存命中率采用官方口径：缓存读取 ÷（未缓存输入 + 缓存读取 + 缓存写入）。官方未提供缓存读取时按原生零值处理；插件不根据推理引擎的 KV 内存复用猜测缓存 token。
首次进入页面或点击刷新时读取一次按日期/连接聚合的快照。之后切换模型类型、时间范围或日期时在界面内立即筛选，不再重复扫描历史。新产生的历史用量可通过刷新获取。
当前页面不显示金额，也不需要维护供应商单价。
开发检查
在本目录运行：
npm test
npm run check
本地安装
DSH 桌面版的插件页也可以选择本项目目录进行本地安装。本包不包含依赖安装脚本，不需要 API 密钥。
模型分类保存在 $DSH_HOME/dsh-clear-usage/models.json。已有配置的旧字段保留以兼容历史版本，但页面不再提供单价输入或金额显示。不读取密钥、不发送消息正文、不访问供应商接口。
隐私与数据
用量从 DSH 本地会话记录读取，消息正文不会离开 DSH。插件不读取凭据、不调用供应商 API，也不上传统计数据。模型分类设置保存在 $DSH_HOME/dsh-clear-usage/models.json。
从零认识这个项目
package.json：插件的名字、版本和安装声明。cordis.patch.yml：告诉 DSH 加载这个插件。index.js 与 lib/usage.js：读取、核对和统计用量。client.js：设置页界面。
本地安装采用目录链接。保留本项目目录；移动或删除目录会影响 DSH 加载。修改界面后通常可以热更新，修改宿主统计代码后需要正常重启 DSH。
