前言¶
跑过一段时间 DSH（DeepSeek Harness）的开发者，多半会有一个疑问：Token 到底花在哪了？是某个长会话吃掉的，还是某个插件、某个 Skill 在持续消耗？DSH 内置的 token-meter 有数据，但界面上没有一个地方能把整个实例的消耗汇总起来直接看。
dsh-token-usage 解决的就是这个问题：在 DSH Web 界面里加一个 Token 用量统计面板，把当前运行实例全部会话的 Token 消耗汇总展示。界面仿 Codex 个人用量页风格，用过 Codex 的开发者几乎零学习成本。
这是什么¶
dsh-token-usage 是 jiamuAi 开发的 DSH 插件，当前版本 0.1.0，状态为 beta，许可证 MIT。一句话定位：DSH Token 用量统计面板（Codex 风格）——全实例 Token 消耗汇总 + 活动热力图。
插件依赖 DSH 内置包（@deepseek-ai/*），放进 DSH 仓库即可自动解析，无需额外安装。仓库里已提交构建产物 lib/，装了就能跑。
核心功能¶
- 5 大指标：累计 / 单会话峰值 Token、最长聊天时长、当前 / 最长连续天数
- Token 活动热力图：每日（GitHub 贡献图风格）/ 每周（柱状）/ 累计（折线）三视图，悬浮看数值
- 活动洞察 + Top5：含最常用模型的活动洞察，以及插件 / Skill Top5
- 两个原生入口：侧边栏底部「Token 统计」按钮（应用级常驻）；会话头部实时用量胶囊，每 5 秒自动刷新
- 深空紫双主题（深色 / 浅色），跟随系统或手动切换
- 数据每 5 秒刷新，历史会话自动回填，重启不丢
数据口径与 DSH 内置 token-meter 一致：累计 Token = input + output + cacheRead + cacheWrite，不重复计数。
安装与启用¶
有两种安装方式。
方式一：让 Agent 一句话装好（推荐）¶
把这句话发给你的 DSH Agent，它会自己读仓库说明并完成安装：
你看一下这个仓库：https://github.com/jiamuAi/dsh-token-usage ，然后帮我把 dsh-token-usage 安装到我的 DSH 上。
方式二：手动安装¶
先克隆仓库并复制到 DSH 源码的插件目录，再在 DSH 仓库根目录执行安装和构建：
git clone https://github.com/jiamuAi/dsh-token-usage.git
cp -R dsh-token-usage <你的deepseek-harness路径>/packages/extensions/
cd <你的deepseek-harness路径> && pnpm install && pnpm run build:lib
<你的deepseek-harness路径> 指 DSH 源码在你机器上的位置。不知道在哪，终端执行：
readlink -f $(which dsh)
可以看到 dsh 的真实路径，往上找 deepseek-harness 目录就是。
复制完成后，编辑 ~/.dsh/profiles/web/package.json，在 dsh.profile.bundles 里加上 "dsh-token-usage"，然后重启 dsh web 并刷新页面。
两点说明：
1、lib/ 是已提交的构建产物，一般使用者无需构建。想改代码的话，需要把 src/ 放进 DSH 仓库的 packages/extensions/dsh-token-usage/ 下，用 DSH 仓库的编译工具（tsc + tsdown + Typert 生成器）构建，产物同步回仓库提交。
2、插件依赖 DSH 内置包（@deepseek-ai/*），放进 DSH 仓库后自动解析，不需要额外安装依赖。
典型用法¶
安装启用后，按下面步骤使用：
1、重启 dsh web 后，左侧栏底部出现「Token 统计」入口。
2、打开任意会话，标题旁出现实时用量胶囊，例如 ⚡ 2.61亿，每 5 秒自动刷新。
3、点击任一入口打开面板，右上角可以切换主题、关闭面板。
4、热力图支持三视图切换，悬浮可查看单日 / 单周 / 累计数值。
数据每 5 秒刷新，历史会话自动回填，重启后不丢。
适用场景与注意¶
适合这些人：
- 长期使用 DSH、想知道 Token 具体去向的个人开发者
- 熟悉 Codex 用量页、希望 DSH 有同类视图的用户
- 需要排查哪个插件或 Skill 消耗最多的使用者
使用前注意两点：
1、插件当前为 beta（0.1.0），功能和数据口径可能随版本调整。
2、插件以当前 dsh 进程权限运行，安装前建议先查看仓库源码与许可证（MIT），确认无误再装。
结尾¶
dsh-token-usage 做的事情很单一：把 DSH 已经记录的 Token 数据变成一个能直接看的面板，累计、峰值、热力图、插件 Top5 一屏呈现。如果你在关心「Token 花哪去了」，可以装上试试。
- GitHub 仓库：https://github.com/jiamuAi/dsh-token-usage
- 社区目录页：https://www.skillhub.cn/plugins/jiamuAi/dsh-token-usage
需要说明的是，skillhub.cn 是独立的社区插件目录站点，与 DeepSeek / 幻方无官方从属关系，仅作为插件索引使用。
