前言¶
在 DSH（DeepSeek Harness）里跑智能体或对话时，模型调用分散在多次会话里。想回答「今天用了多少 token、成本大概多少、缓存命中如何」，往往只能翻日志或靠估。社区插件 Token 用量（仓库 Mercer08572/dsh-plugin-token-usage）把本机会话日志汇总进一块看板：总量、趋势、热力图和可筛选的请求日志，数据落在本机 SQLite，不依赖额外配置项。SkillHub 上归类为 admin-security，维护者为 Mercer08572。
这是什么¶
Token 用量是 DSH 的 bundle 插件（npm 包名 dsh-client-ui-token-usage，当前资料中的版本为 0.6.1，许可证 MIT）。Host 侧订阅会话事件、写入 SQLite；客户端在侧边栏底部增加「用量」入口，打开后为完整统计页。历史会话在首次启动时自动回填，无需手动开始记录。
数据来源仅为本机 DSH 会话日志；除文档说明的公开汇率与节假日补全外，不上报用量。
核心功能¶
下面按 README 中已列能力说明界面与统计口径。
总量与范围¶
四张卡片分别展示总成本、请求数、token 消耗、缓存命中率，并带今日增量；失败与取消次数在悬浮提示中。卡片统计范围可切换 7 天 / 30 天 / 全部。
趋势与热力图¶
每日趋势图为未命中输入、缓存读取、输出三段堆叠柱，叠加请求数折线，可切 7 / 30 / 90 天。热力图覆盖近 53 周，按当天 token 量分 5 档。
请求日志与模型别名¶
日志列包含时间、模型、输入、输出、缓存命中、命中率、速度、首字、成本等，支持按模型筛选与分页。日志中的模型写法可通过「模型别名」映射到 pricing.json 里已定价的模型；目标模型只能从价格表选择。界面为中文时使用 ¥，其他语言使用 $。
统计口径（使用前宜知晓）¶
- 仅统计成功调用；失败与取消单独计数，不计入 token 与成本。
- 首字：请求发出到第一个 token 的耗时；速度：输出 token ÷ 解码时长。
- 成本在每次请求结束时按当时价格固化，标注为仅供参考；调价只影响新请求。无定价的模型成本留空，不以 0 代替「未计价」。
安装与启用¶
官方说明为本地目录安装，不要手写 profile 的 cordis.patch.yml。资料未给出 dsh plugin add github:... 一类命令，以下步骤摘自 README：
- 将插件仓库放到本机任意目录（通过你惯用的方式获取源码，例如下载发行包或自有镜像；本文不展开获取方式）。
- 打开 DSH，在插件管理器中选择该目录进行安装。
- 重启 DSH。
首次启动会在后台回填历史会话，大约十几秒；面板显示「正在回填历史会话…」并自动刷新，完成后数字齐全。
典型用法¶
安装并重启后：
- 在 DSH 侧边栏底部点击 用量。
- 在标题栏下方切换四张卡片的 7 天 / 30 天 / 全部。
- 在趋势区切换 7 / 30 / 90 天查看消耗结构。
- 在请求日志区按模型筛选、翻页核对单次调用。
- 需要修正计价模型时，用右上角标签打开 模型别名（价格仍只来自插件自带的
pricing.json）。
本地数据路径：
~/.dsh/token-usage/usage.db
清空：删除 ~/.dsh/token-usage/ 目录；迁移：拷贝上述 SQLite 文件即可。
适用场景与注意¶
适合：在本机 DSH 上长期开发或调试，需要按日、按模型查看 token 与参考成本，并关心缓存命中率与请求明细的开发者。
注意：
- 插件以当前 DSH 进程权限运行，安装前请阅读仓库源码与 MIT 许可证，自行评估是否符合安全与合规要求。
- 成本依赖
pricing.json与模型别名映射，无价格模型不会显示成本数字。 - SkillHub 社区目录与 DeepSeek / 幻方无官方从属关系；星标等元数据以目录页为准（资料中 GitHub 星标为 0）。
仓库提供离线自检（无需启动 DSH），便于贡献者或自行校验：
node tools/check.mjs # 语法 / manifest / 组件注册 / 价格文件校验
node tools/selftest.mjs # Host 全链路自测（临时目录）
node tools/replay.mjs # 会话日志回放对账
node tools/render-smoke.mjs # 客户端组件冒烟渲染
结尾¶
Token 用量把「读日志、算 token、对照价格表」收进 DSH 侧边栏一块面板，强调本机存储与不改配置即可用。进一步了解可看 SkillHub 目录页 与 GitHub 仓库。
