dsh-clear-usage
简洁的 DSH 用量统计：在设置内查看 token、缓存命中、热力图及模型用量。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:xgxx666/dsh-clear-usage#1f738aebb058bb8e15a29fc59081df15aba76bfdClear Usage 以 dsh-clear-usage 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
在 DSH 设置中查看真实 Token 消耗、缓存命中、活动热力图和模型分布。仅显示用量，不估算费用。
dsh plugin --profile web add github:xgxx666/dsh-clear-usage
适用于 DSH 0.2.0-rc.2 及更高兼容版本的 Web profile。
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。