← 返回列表
⚠ 装前注意
DSH Token 用量统计面板Codex 风格：全实例 Token 消耗汇总 + 活动热力图。
基本兼容但装前注意：npm 同名包「dsh-token-usage」归属 tastelessor/dsh-usage-stats，装到的可能不是本插件 · 最近上游提交 2026/8/16 · 已提供中文文档
DSH Token 用量统计面板（Codex 风格）：全实例 Token 消耗汇总 + 活动热力图。
综合分
32.8
GitHub 分
32.8
用户评分
—
★ Stars
3
周下载量
—
安装插件（需先安装 dsh CLI 引擎：npm install -g @deepseek-ai/dsh）
dsh plugin --profile web add jiamuAi/dsh-token-usagenpm 同名包「dsh-token-usage」归属 tastelessor/dsh-usage-stats，装到的可能不是本插件，改用 GitHub 源安装
数据截至 2026/9/19（元数据每日更新 · 实装验证按队列轮转，单条结论的验证时间见上方）
安装兼容性检查⚠ 装前注意
以下结论由程序自动检查 npm 包、engines 声明与入口文件得出，未做人工实机验证——能装不等于用着没问题。
✓npm 包dsh-token-usage @ 2.2.0
✓Node 引擎未声明 engines.node
✓dsh CLI 依赖未声明 dsh 版本约束
✓入口文件main/exports/bin 已声明
npm 同名包「dsh-token-usage」归属 tastelessor/dsh-usage-stats，装到的可能不是本插件
验证方式：npm registry 存在性 + package.json 静态校验 · 最后验证 2026/9/20 02:16:15
依赖的 DSH / Cordis 模块
@deepseek-ai/cordis@deepseek-ai/dsh-client-connection@deepseek-ai/dsh-client-runtime@deepseek-ai/dsh-invariants@deepseek-ai/dsh-session@deepseek-ai/dsh-session-persistence@deepseek-ai/dsh-typert-protocol用户评分
还没有人投票，来当第一个
订阅周报，不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动
README
dsh-token-usage
中文 · English
DSH 的 Token 用量统计面板 —— 仿 Codex 个人用量页风格，把整个 DSH 实例的 Token 消耗一目了然地展示出来：累计 / 单会话峰值、活动热力图、插件 Top5。
License
DSH Plugin
Status
这是什么
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 /packages/extensions/
cd && pnpm install && pnpm run build:lib
= 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扫码进群