zhangzheng25/dsh-token-monitor
41最近提交 2026年8月15日
dsh-token-monitor DSH 插件
此插件在 DSH 设置页添加“Token 用量”板块，显示今日/近7天/近30天总量、30天按模型堆叠柱状图、模型使用排行（固定30天窗口）以及会话数统计。每30秒自动刷新，数据持久化到磁盘，重启不丢失。
如何安装 dsh-token-monitor DSH 插件
dsh plugin --profile web add github:zhangzheng25/dsh-token-monitor复制不会执行命令。安装 dsh-token-monitor DSH 插件前请核对仓库和版本。
dsh-token-monitor DSH 插件数据来源
dsh-token-monitor DSH 插件快照日期：2026年8月16日
discovered
dsh-token-monitor DSH 插件能做什么
- 展示今日、近7天、近30天的 Token 总量指标卡，单位万/亿
- 显示30天堆叠柱状图，按模型分色，带灰色点阵网格背景，悬停弹出明细卡片
- 提供2×2的模型使用排行卡片，展示前4名模型信息
- 统计今日、近7天、近30天开启的顶层对话数（不含子代理内部会话）
- 每30秒自动轮询刷新，附带手动“刷新”和“回填历史”按钮
- 数据持久化至 $DSH_HOME/plugins/token-monitor/data.json，按天桶保留181天
- 启动时、点击“回填历史”或30秒轮询时，从会话日志幂等全量重建数据，不会重复计数
- 跟随 DSH 原生主题，使用 --dsw-alias-* 变量，支持亮色/深色模式
dsh-token-monitor DSH 插件适合哪些场景
- 监控个人在不同模型上的 token 消耗，帮助管理成本
- 识别近30天使用频率最高的模型
- 追踪对话活动趋势，评估使用模式
- 确保重启后数据持续可用，实现连续监控
- 回填安装插件之前的历史数据，获得完整统计
dsh-token-monitor DSH 插件适合谁
- 需要追踪 LLM token 用量的 DSH 用户
- 需要监控 DSH 中模型使用模式的开发人员或研究人员
dsh-token-monitor DSH 插件的限制
- 需要 DSH 已安装并以 web profile 运行
- 数据源仅限于会话日志；没有 usage 字段的消息不会被统计
- 仅支持 web 客户端（client/bundle.js），不支持终端或其他模式
- 数据保留期固定为181天，更早的数据会自动丢弃
- 插件由 AI 生成，仅供学习/技术交流，无商业保证
dsh-token-monitor DSH 插件的仓库 README 摘录
以下文字摘自 dsh-token-monitor DSH 插件的上游仓库 zhangzheng25/dsh-token-monitor 的 README，版权归原作者，仅作引用。
> 🤖 **AI 生成声明**：本项目由 AI 辅助生成，仅供学习与技术交流使用，不构成任何形式的商业保证或支持承诺。 一个 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 插件：在 **设置 → Token 用量** 页面上原生展示你的 **token 用量与对话统计**——今日 / 近 7 天 / 近 30 天总量、近 30 天**按模型**的堆叠用量图、按模型的使用排行（固定 30 天窗口）、以及会话数统计。  ## 功能特性 - 📊 **指标卡** — 今日 / 近 7 天 / 近 30 天的 Tokens 总量（万 / 亿单位），只显示大数字，保持清爽。 - 📊 **近 30 天模型使用情况** — 30 天堆叠柱状图：每根柱子按模型分色堆叠（当天用量最高的模型在柱底，颜色按 30 天排名固定）；图表区域铺满**灰色点阵网格背景**（每列约两列点、从上到下铺满，参考 `temp/model-usage.png`），有调用的柱子叠在点阵之上；横轴只显示**每周一**的基准日期；悬浮/点击某天弹出明细卡片（日期 / 总计 / 各模型色块行，样式参考 `temp/tooltip.png`），无任何高亮/变灰/柱上标签效果。 - 🏆 **模型使用排行** — 固定 30 天窗口：前 4 名 **2×2** 卡片（序号一行 / 模型名 + token 总数 / 提供商 + 占比右对齐，无增长与单位标签），悬停轻微放大。 - 💬 **会话统计** — 今日 / 近 7 天 / 近 30 天开启的顶层对话数（不含子代理内部会话），副文字显示对应时段的模型请求次数。 - 🔄 **自动刷新** — 页面每 30 秒轮询（带幂等重扫，数字自动修正），另有手动「刷新」与「回填历史」按钮。 - 💾 **持久化** — 数据写入 `$DSH_HOME/plugins/token-monitor/data.json`，重启不丢（按天桶保留 181 天；每个桶内按模型细分）。 - 🕘 **历史回填** — 会话日志是唯一数据源：启动 / 点击「回填历史」/ 30 秒轮询都会把窗口内全部会话用量**幂等重扫**进新桶（原子替换），把插件安装**之前**的用量也统计进来；重复运行不会重复计数，旧桶脏数据自动自愈，30 天堆叠图与模型排行立即可用。 - 🎨 **DSH 原生风格** — 亮色主题、1px 细边框卡片、8–10px 圆角、无阴影；颜色走 `--dsw-alias-*` 主题变量，跟随 DSH 深色主题。 ## 安装 从本仓库安装： ```bash dsh plugin --profile we
阅读完整 README仓库许可: MIT
dsh-token-monitor DSH 插件常见问题
如何安装 dsh-token-monitor 插件？
在终端中运行命令 `dsh plugin --profile web add github:zhangzheng25/dsh-token-monitor`。安装完成后重启 DSH，打开设置 → Token 用量即可看到页面。你也可以从本地目录安装：`dsh plugin --profile web add E:\path\to\dsh-token-monitor`。
插件会自动刷新数据吗？
是的，插件每30秒轮询一次，刷新 token 用量和对话统计。刷新是幂等的，不会重复计数。页面上还提供了手动“刷新”和“回填历史”按钮。
重启 DSH 后数据会丢失吗？
不会。所有数据都持久化到 `$DSH_HOME/plugins/token-monitor/data.json` 文件中，重启后仍然存在。插件保留181天的按天桶数据，超过期限的旧数据会自动丢弃。
能否查看安装插件之前的 token 用量？
可以。插件能够从已有的会话日志中回填历史数据。在启动时、点击“回填历史”按钮或每30秒轮询时，会自动从会话日志中幂等地重建所有数据，包括安装之前的用量。
插件使用哪些数据源来计算 token 用量？
插件使用会话日志作为唯一数据源。它读取会话日志中 `assistant/message` 事件的 `usage` 字段，模型归属取自 `message.source` 中的 provider/model。会话数统计则读取顶层对话（delegationDepth === 0）的会话头部信息。