DSH 设置内的本地 Token 用量热图:GitHub 风格周/月/季度/年视图、每日小时级展开、模型与供应商 Top 5,历史持久化,删除会话不丢数据。零联网、零计费。
安装
# npm 包(预构建)
dsh plugin --profile web add dsh-token-pulse
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:Hou-DL/dsh-token-pulse
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
English: README.en.md
本地 Token 用量热图插件,GitHub 风格日历视图,内置于 DSH Web 设置页。
环境要求
- Node.js ≥ 23.8(内置
node:zlib的 zstd 解码,无需额外安装);更早版本会回退到外部zstdCLI(sudo apt install zstd/brew install zstd)。 - DSH Web profile(
dsh web已运行)。
安装
# 从 npm(推荐,最短)
dsh plugin --profile web add dsh-token-pulse
# 或从 GitHub
dsh plugin --profile web add github:Hou-DL/dsh-token-pulse
# 或从 Gitee(国内访问更快)
dsh plugin --profile web add "git+https://gitee.com/HouDL/dsh-token-pulse.git"
重启后打开 设置 → Token Pulse 即可。
- 零网络、零计费:只读本地会话日志,不触碰任何计费 / 余额接口
- 持久化:历史落盘,删除会话不丢数据
- 多视图:周(按小时展开)/ 月(日历)/ 季度(近 90 天)/ 年(整年双行)
- 统计:今日 / 本周 / 本月 / 累计 + 按模型与供应商的 Top 5
截图
功能
| 模块 | 说明 |
|---|---|
| 视图切换 | 周 / 月 / 季度 / 年,颜色按视图内 25% / 50% / 75% / 100% 四档分档 |
| 周视图 | 每天 24 个小时柱,看高峰时段;可点击行查看当日 Top 5 |
| 月视图 | 日历格显示日期与当日用量 |
| 季度 / 年度 | GitHub 风格栅格,季度放大便于观察,年度双行排布 |
| 顶部统计 | 今日 / 本周 / 本月 / 累计,M / k 缩写 |
| 模型 Top 5 | 按模型或供应商查看,随视图窗口 / 点击日期动态切换 |
| 刷新 | 手动刷新 + 自动刷新(5 / 10 / 30 / 60 分钟,可关闭) |
| 语言 | 中 / 英文切换 |
常见问题
- 显示 0? 确认
$DSH_HOME/sessions下有含usage字段的会话日志。 - 会联网吗? 不会,纯本地统计。
- 时区? 固定北京时区,周一为周起始。
- 如何重置? 设置页右上角 ⋯ → 「重置历史」。
开发
pnpm install && npx tsdown # 构建
node --test src/ # 运行测试
License
MIT
链接
同类插件
bowenliang123/dsh-context★ 1999
DSH 上下文洞察面板:Context 仪表盘 + /context命令 + Context 浏览器,查看 Context的分类组成、内容详情、演进趋势、压缩/注入事件、统计等一站式 Context 全生命周期管理。
Han-1413141/dsh-cost-meter★ 391
会话与当日 API 费用统计、预算图框(已用%)、官方余额、历史看板,支持峰谷计价与官方价格一键同步。
wssfk12138/dsh-damage-pulse★ 258
在 DSH Web 界面追踪 DeepSeek Token 用量、单次与会话费用及账户余额,并显示缓存感知的扣费动画。
zh667/TokenLedger★ 202
侧边栏用量面板:把 Token 归属到实际服务该请求的中转站,站点从已有的 provider 配置中读出,无需额外配置;含今日/本月/累计三窗口、按站点与模型下钻、一年活跃度热力图,以及 New API / Sub2API / DeepSeek 余额。
Ychris12138/dsh-usage-stats★ 171
多供应商用量看板:按供应商/模型统计 Token 与日期下钻,统一展示账户余额,并追踪 OpenCode Go / Z.ai 订阅额度。
PolinniZhong/dsh-personal-center★ 118
DeepSeek Harness 个人中心:跨会话用量统计、按模型成本估算、全局自定义指令、外观全局字号、数据驱动的桌面宠物(位图/矢量皮肤)与会话状态概览,纯本地离线运行。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。