前言¶
用 DeepSeek Harness（DSH）跑智能体或长对话时，Token 消耗会分散在多轮请求和不同模型调用里。若只靠翻本地日志或事后统计，很难快速判断「今天用了多少」「缓存是否起作用」「各模型各占多少」。社区插件 dsh-token-usage（维护者 orange-v-soda）针对这类需求：在本机读取会话相关数据，在 Web 侧边栏展示当日用量与缓存比例，并可展开面板查看近期趋势与模型占比。数据不上传、不写入会话，适配 DSH >= 0.2.1-rc.2。
这是什么¶
dsh-token-usage 是 DSH 生态中的一款展示型插件，npm 包名为 @orange-v-soda/dsh-token-usage，当前发布版本 0.1.0，开源协议 MIT。它不承担计费或与云端对齐，只做「简单、美观」的本地 Token 用量与缓存命中展示，适合想轻量盯盘、又不愿引入额外联网服务的开发者。
核心功能¶
依据项目 README 与 package.json 说明，已核实能力包括：
- 侧边栏摘要：展示「今日」Token 用量与缓存率（cache hit rate）。
- 展开面板：近期用量统计；README 效果图说明包含近 30 日用量、6 周热力图，以及按模型的占比 breakdown。
- 纯本地：只读本机会话日志，不联网、不上传，不向会话数据写入内容。
- 客户端形态：
dsh.client配置为platform: web，且immediately: true，安装后可在 Web 界面侧栏直接看到入口。
更细的数据来源、聚合算法、增量缓存策略与接口契约见仓库内 docs/technical.md，适合交给 Agent 通读后再做二次开发。
安装与启用¶
在 DSH 插件管理器的安装目标里填写以下任意一种（须与官方 README 一致，勿自行拼接其他命令）：
@orange-v-soda/dsh-token-usage # npm
github:orange-v-soda/dsh-token-usage # GitHub
npm 包页面：https://www.npmjs.com/package/@orange-v-soda/dsh-token-usage
仓库：https://github.com/orange-v-soda/dsh-token-usage
安装前请确认本机 DSH 版本满足 >= 0.2.1-rc.2。插件与当前 dsh 进程同级运行，安装前应浏览源码与 MIT 许可证，确认符合你对本地日志读取范围的预期。
典型用法与界面预期¶
README 将插件适配场景概括为：
- 希望简单、美观的每日 Token 用量统计与缓存比例；
- 想看到近期的用量与各模型占比。
安装并启用后，侧边栏会出现今日用量与缓存率；点击可进入面板查看更长时间跨度的图表（具体布局以仓库 docs/sidebar.png、docs/panel.png 为准）。无需额外配置项出现在已抓取资料中；若后续版本增加配置，以仓库文档为准。
适用场景与注意¶
适合谁：日常在 DSH Web 端调试智能体、需要快速对照「今天花了多少 Token、缓存是否有效、模型分布如何」的开发者。
使用时注意：
- 统计口径与 DSH 本地会话日志一致，不等同于厂商控制台账单。
- 插件不联网，无法在多台机器间汇总；每台安装 DSH 的环境各自展示本机数据。
- DSH 社区目录（如 SkillHub）为独立站点，与 DeepSeek / 幻方无官方从属关系；本文安装方式以 GitHub README 为准。
结尾¶
dsh-token-usage 把 Token 用量和缓存率收进侧边栏与面板，本地可读、界面简洁，适合作为 DSH 日常开发的盯盘辅助。目录页：https://www.skillhub.cn/plugins/orange-v-soda/dsh-token-usage；源码与说明：https://github.com/orange-v-soda/dsh-token-usage。
