Anna-la/dsh-token-stat0

token-stat

DSH Token 用量统计插件:按模型和日期统计累计用量,提供设置页看板与手写 SVG 可视化图表。

AI 分析

核心用途是本地历史会话的 Token 消耗深度分析。适合需要清晰了解各模型使用频次、缓存命中率及每日消耗趋势的用户,零外部依赖。

包名
token-stat
版本
1.0.0
许可证
MIT
最近更新
2026年8月27日

安装

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:Anna-la/dsh-token-stat

使用

  1. 设置页查看(推荐):打开「设置 → 插件 → 可配置」,找到 Token 用量统计卡片,点击展开即显示:
    • 累计总量(输入 / 缓存读取 / 缓存写入 / 输出 / 总计,含占比)
    • 按模型明细表(请求数、各类 token)
    • 按日期(近 14 天)
    • 数据目录、扫描时间等元信息,并可点「重新扫描」。 卡片数据由插件自带的桥 /api/token-stat/stats 提供(仅回环地址可访问, 外部请求一律 403),每 15 秒自动刷新。
    • 「可视化」:点击弹出窗口内浮层面板(非全屏),3 张手写 SVG 图表 (零第三方依赖,主题与设置页一致,悬停显示精确数值): ① 模型用量占比环形图(/sessions磁盘会话日志** (不依赖会话服务就绪),覆盖**所有项目——包括已关闭、已删除但日志仍在磁盘的 项目**;此后实时监听session/event 增量累计(含子 agent 会话)。 每个会话的用量会写入「归档账本」(archive.json`,随报告目录存储), 即使之后某个会话的文件被彻底删除,其最后已知用量也仍然计入总数。
  2. 随时查询:在对话框里问"查一下 token 用量统计",模型会调用本插件的 token_usage_stats 工具并返回报告文本。
  3. 报告文件:默认写入 ~/.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       # 详细日志