前言¶
在 DeepSeek Harness（DSH）的 Web GUI（dsh web）中，开发者经常需要查看两类信息：当前会话消耗了多少 token、上下文占用处于什么水平；近 30 天每日消耗和按模型消耗如何分布。
DSH 的插件机制遵循“一切皆插件”的思路。dsh-token-usage 是其中一个 Token 用量展示插件，由 AFAP 维护；社区目录是独立站点，与 DeepSeek / 幻方没有官方从属关系。
下面介绍它的功能、安装方式和注意点。
这是什么¶
dsh-token-usage 是一个用于 dsh web 的 Token 用量展示插件。它不要求配置，也不修改文件，面向需要查看会话级与全局 token 消耗的使用者。插件许可证为 MIT。
核心功能¶
单会话胶囊¶
在会话头部右侧显示当前会话的输入、输出和上下文占用。点击胶囊后，会弹出四组明细：提供方用量、上下文构成、上下文压力、会话统计。
全局消耗面板¶
在侧边栏底部提供“Token 统计”按钮。打开全局面板后，可展示近 30 天每日消耗、按模型分解、按日明细。数据来自会话日志，实时扫描聚合；面板打开时每 60 秒自动刷新。
数据与运行约束¶
- 无需任何配置。
- 不修改任何文件；全局面板只读扫描
$DSH_HOME\sessions下的会话日志，不写入、不删除、不改动日志。 - 宿主半部零外部依赖，仅使用 Node 内置能力和
./stats.js。 DSH_HOME从环境变量解析：$DSH_HOME→~/.dsh。- 日志格式为多帧 zstd 容器；宿主半部使用 Node 22.22+ 内置
zstdDecompressSync，并跳过崩溃残留的不完整尾帧。 /api/token-stats以 exact 路由注册，并带浏览器信任围栏（loopback / trustedHosts + same-origin 检查），用于拒绝 DNS 重绑定与跨站请求。- 语言跟随界面，内置简体中文和 English 词典。
- 已聚合数据带本地缓存，反复打开或重启
dsh后无需重新统计。
安装与启用¶
先执行安装命令，然后重启 dsh web 生效。
dsh plugin --profile web add github:AFAP/dsh-token-usage
安装完成后，插件位于：
$DSH_HOME\profiles\web\node_modules\dsh-token-usage
该位置与源码仓库位置无关。
如果需要从本地源码目录安装：
dsh plugin --profile web add "D:\path\to\dsh-token-usage"
升级和卸载命令如下：
dsh plugin --profile web update dsh-token-usage
dsh plugin --profile web remove dsh-token-usage
典型用法¶
1、验证是否加载成功：打开任意会话，查看头部右侧是否出现 token 胶囊，以及侧边栏底部是否出现“Token 统计”按钮。
2、打开全局面板：点击侧边栏底部的“Token 统计”。面板打开后每 60 秒自动刷新，也可手动刷新。
3、查看单日分布：点击某天柱子，可展开该日 24 小时用量分布。
4、关闭面板：按 Esc 或点击遮罩关闭。
适用场景与注意¶
适合在 dsh web 中运行会话，并希望查看当前会话 token 占用、上下文压力、近 30 天消耗和按模型分布的使用者。
插件会以当前 dsh 进程权限运行。安装前应先检查源码、接口行为和许可证；本插件许可证为 MIT。
全局面板依赖 $DSH_HOME\sessions 下的会话日志，统计结果以可扫描的会话日志为准。
链接¶
目录页（独立社区站点，不代表 DeepSeek 或幻方官方从属关系）：
https://www.skillhub.cn/plugins/AFAP/dsh-token-usage
