dsh-token-usage

中文 · English

DSH 的 Token 用量统计面板 —— 仿 Codex 个人用量页风格，把整个 DSH 实例的 Token 消耗一目了然地展示出来：累计 / 单会话峰值、活动热力图、插件 Top5。

这是什么

DSH 刚发布，大家最关心的就是：我的 Token 到底花哪去了？

这个插件在 DSH Web 界面里加一个 Token 用量统计面板，把当前运行实例全部会话的 token 消耗汇总，点击入口即弹出居中面板（深色 / 浅色主题）：

特性

• 5 大指标：累计 / 单会话峰值 Token、最长聊天时长、当前 / 最长连续天数
• Token 活动热力图：每日（GitHub 贡献图）/ 每周（柱状）/ 累计（折线）三视图，悬浮看数值
• 活动洞察（含最常用模型）+ 插件 / Skill Top5：谁在消耗最多，一目了然
• 两个原生入口，与 DSH UI 融为一体：
  • 侧边栏底部「Token 统计」按钮（应用级常驻）
  • 会话头部实时用量胶囊：⚡ 2.61亿（每 5 秒自动刷新）
• 深空紫双主题，跟随系统 / 手动切换

为什么值得装

• 一眼看清 Token 去向：累计、单会话峰值、每日热力图，不用再猜
• Codex 用户零学习成本：熟悉的用量页风格，界面一看就懂
• 天然的传播素材：大家都喜欢晒"我今天用了多少 token"，截一张图发出去，就是最好的宣传

安装

插件依赖 DSH 内置包（@deepseek-ai/*），放进 DSH 仓库即可自动解析，无需额外安装。

方式一：让 Agent 一句话装好（推荐）

把下面这句话发给你的 DSH Agent，它会自己读这个仓库的说明并完成安装：

你看一下这个仓库：https://github.com/jiamuAi/dsh-token-usage ，然后帮我把 dsh-token-usage 安装到我的 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. 重启后，左侧栏底部出现「Token 统计」入口
2. 打开任意会话，标题旁出现实时用量胶囊 ⚡ 2.61亿
3. 点击任一入口打开面板；右上角可切主题、关闭
4. 热力图支持三视图切换 + 悬浮看单日 / 单周 / 累计数值

数据每 5 秒刷新；历史会话自动回填，重启不丢。

数据口径

与 DSH 内置 token-meter 一致：

• 每 step 一条 usage 记录：assistant/chunk {type:'usage'} 为持久记录；assistant/message.usage 覆盖同一步的 chunk 记录（不重复计数）
• 累计 Token = input + output + cacheRead + cacheWrite
• thinking 等级由 reasoningTokens 近似；Skill 统计从 skill 工具调用参数解析

架构

┌─ Host（DSH 进程内）──────────────────────────────┐
│ TokenUsageService (TypertRemoteService)          │
│  ├─ 启动时回填全部历史 session                    │
│  ├─ session/event 实时折叠                        │
│  └─ @Remote('getStats') → /api/tokenUsage/getStats│
└──────────────┬───────────────────────────────────┘
               │ connection.rpc（通用通道，无需改 DSH）
┌─ Browser ────▼───────────────────────────────────┐
│  ├─ sidebar.footer.action        侧栏入口        │
│  ├─ conversation.session.header.actions ⚡ 胶囊   │
│  └─ shell.overlay                面板模态框       │
└──────────────────────────────────────────────────┘

文件	作用
src/index.ts	Host 半边：聚合逻辑 + Typert Remote
src/client/index.ts	浏览器半边：面板 UI + 两个入口 + 5s 轮询
src/types.ts	跨平面 wire 类型
cordis.patch.yml	bundle patch：插入插件行
lib/	已提交的构建产物（装了就能跑，无需构建）

开发

lib/ 里是现成构建产物，一般使用者无需构建。要改代码的话，构建链路依赖 DSH 仓库的编译工具（tsc + tsdown + Typert 生成器），把 src/ 放进 DSH 仓库的 packages/extensions/dsh-token-usage/ 下构建，构建产物 lib/ 同步回本仓库提交即可。

License

MIT

---

Made for the DSH community · 欢迎 Star / Issue / PR