前言¶

DSH 的插件化思路是「一切皆插件」。如果你在日常使用或调试 DeepSeek Harness（DSH）时，希望直接看到今日 token 总量，并进一步查看近 7 天、近 30 天用量、近 30 天模型堆叠图、模型排行和会话统计，可以用 zhangzheng25/dsh-token-monitor。

下面介绍它的定位、核心功能、安装与使用方式。

这是什么¶

zhangzheng25/dsh-token-monitor 是一个 DeepSeek Harness 插件，由 zhangzheng25 维护，使用 MIT 许可证。

它会在 DSH 侧边栏底部（设置图标旁）放一张「今日用量」卡片，显示今日 token 总量。点击卡片后弹出统计窗口，展示今日 / 近 7 天 / 近 30 天 token 用量、近 30 天按模型的堆叠用量图、按模型使用排行，以及会话统计。

核心功能¶

• 侧边栏「今日用量」卡片实时显示今日 token 总量，点击弹出完整统计窗口。
• 统计今日 / 近 7 天 / 近 30 天 token 总量。
• 展示近 30 天按模型的堆叠用量图。
• 展示按模型使用排行，窗口固定为 30 天。
• 统计今日 / 近 7 天 / 近 30 天顶层对话数，副文字显示对应时段的模型请求次数。
• 每 30 秒自动轮询刷新，支持幂等重扫，也可手动点击「刷新」与「回填历史」。
• 数据持久化到 $DSH_HOME/plugins/token-monitor/data.json，按天按模型分桶，保留 181 天。
• 通过会话日志幂等回填历史用量，可以统计插件安装之前的用量，重复运行不会重复计数。

安装与启用¶

插件要求 Node.js >=20。安装前，建议先查看 GitHub 仓库源码、许可证和 AI 辅助生成声明。

从仓库安装：

dsh plugin --profile web add github:zhangzheng25/dsh-token-monitor

从本地目录安装。下面命令使用 README 中的示例路径，实际路径需替换：

dsh plugin --profile web add E:\path\to\dsh-token-monitor

安装完成后，需要重启 DSH。启动后，侧边栏底部（设置图标旁）会出现「今日用量」卡片。

典型用法¶

安装并重启 DSH 后：

1、查看侧边栏底部（设置图标旁）的「今日用量」卡片。

2、点击卡片，打开统计窗口。

3、在窗口内查看今日、近 7 天、近 30 天 token 用量，近 30 天模型堆叠图，模型使用排行和会话统计。

4、如果数据未更新，可点击「刷新」。

5、如果需要把插件安装之前的用量统计进来，可点击「回填历史」。

统计窗口支持 Esc、✕、点击遮罩关闭，并在打开时锁定背景滚动。

如果你只是做语法检查，可以运行：

node --check src/index.js && node --check client/bundle.js

数据与限制¶

• 会话日志是唯一数据源。
• sessionQuery 为 live-preferred，可读取内存活跃会话和落盘日志。
• 会话数只计入顶层会话，即 delegationDepth === 0，不含子代理内部会话。
• 数据持久化到 $DSH_HOME/plugins/token-monitor/data.json。
• 数据按天按模型分桶，保留 181 天。
• 回填历史是幂等重扫，重复运行不会重复计数，旧桶脏数据会自动自愈。
• 页面每 30 秒轮询刷新。

适用场景与注意¶

适合需要查看 DSH 日常 token 用量、近 30 天模型分布和会话统计的使用者。也适合在本地检查 DSH 插件行为时查看插件提供的统计窗口。

使用注意：

• 插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。
• 项目许可证为 MIT。
• 项目 README 声明：本项目由 AI 辅助生成，仅供学习与技术交流使用，不构成任何形式的商业保证或支持承诺。
• 安装后需重启 DSH。
• client/bundle.js 为手工编写的 web bundle，无需构建步骤。

参考¶

• GitHub：https://github.com/zhangzheng25/dsh-token-monitor
• 目录页线索（未在本次已核实资料中确认）：https://www.skillhub.cn/plugins/zhangzheng25/dsh-token-monitor