token-stat
DSH Token 用量统计插件:按模型和日期统计累计用量,提供设置页看板与手写 SVG 可视化图表。
AI 分析
核心用途是本地历史会话的 Token 消耗深度分析。适合需要清晰了解各模型使用频次、缓存命中率及每日消耗趋势的用户,零外部依赖。
安装
$
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:Anna-la/dsh-token-stat说明文档
阅读完整 README ↗使用
- 设置页查看(推荐):打开「设置 → 插件 → 可配置」,找到
Token 用量统计卡片,点击展开即显示:
- 累计总量(输入 / 缓存读取 / 缓存写入 / 输出 / 总计,含占比)
- 按模型明细表(请求数、各类 token)
- 按日期(近 14 天)
- 数据目录、扫描时间等元信息,并可点「重新扫描」。
卡片数据由插件自带的桥
/api/token-stat/stats提供(仅回环地址可访问, 外部请求一律 403),每 15 秒自动刷新。 - 「可视化」:点击弹出窗口内浮层面板(非全屏),3 张手写 SVG 图表
(零第三方依赖,主题与设置页一致,悬停显示精确数值):
① 模型用量占比环形图(/sessions
磁盘会话日志** (不依赖会话服务就绪),覆盖**所有项目——包括已关闭、已删除但日志仍在磁盘的 项目**;此后实时监听session/event增量累计(含子 agent 会话)。 每个会话的用量会写入「归档账本」(archive.json`,随报告目录存储), 即使之后某个会话的文件被彻底删除,其最后已知用量也仍然计入总数。
- 随时查询:在对话框里问"查一下 token 用量统计",模型会调用本插件的
token_usage_stats工具并返回报告文本。 - 报告文件:默认写入
~/.dsh-token-stat\下的report.md+report.json+archive.json(可在设置页卡片里随时改目录, 三个文件会一起迁移)。
配置(可选,均为默认值)
- insert:
- id: token-stat
name: token-stat
config:
enabled: true # 总开关
reportDir: '' # 报告目录,默认 ~/.dsh-token-stat(DSH_HOME 之外)
writeMd: true # 写 Markdown 报告 report.md
writeJson: true # 写 JSON 快照 report.json
debounceMs: 2000 # 实时事件落盘最小间隔
verbose: false # 详细日志