托盘用量计数器 NutshellLee/dsh-token-counter

大模型 token 用量计数器（DSH）

DeepSeek Harness 里能看到当前会话的用量，但看不到今天一共用掉多少、昨天又是多少。
这个小工具把它变成 Windows 托盘上的一个数字。

版本 1.0 ｜ MIT 许可（见 LICENSE）｜ 个人自用工具，不保证适配你的环境

它长什么样

- 图标：偏绿的小圆圈，里面是今天的总用量。图标里那个数字单位是「万」，最多显示到 9999（也就是九千九百九十九万），再大就停在 9999。
- 鼠标悬停会弹出三行：第一行是标题，第二行是今天的用量，第三行是昨天的。
数字会自动换单位，小的时候用「万」，大了用「亿」。
- 右键菜单：

| 菜单项 | 作用 |
| 明细 | 打开窗口，列出今天和昨天的 输入 / 输出 / 缓存读取 / 缓存写入 / 合计 |
| 立即刷新 | 马上重新读一次（不弹窗） |
| 打开所在文件夹 | 打开本工具所在的文件夹 |
| 退出 | 结束程序 |

托盘图标左键单击没有反应，功能都在右键菜单里。

装之前需要什么

- Windows 10 或 11（自带 PowerShell 5.1 和 .NET Framework，所以不用装运行库）
- 已经装过 DeepSeek Harness（DSH），并且至少用过一次。它读的是 DSH 在本机存的用量数据
- 不需要管理员权限，不需要改 PowerShell 执行策略，不需要联网

没装 DSH 会怎样：图标照样会出现，但数字一直是 0。

怎么装

1. 先解压、再解锁，这一步别跳。
- 不要在压缩包窗口里直接双击运行，那样会解到临时目录，路径全乱。先把整个文件夹解压到硬盘上。
- 从网上下载来的文件，Windows 会标记来源，不解锁的话双击会弹「Windows 已保护你的电脑」。
做法：进到文件夹，全选所有文件 → 右键 → 属性 → 底下如果有「解除锁定」，勾上、确定。
所有文件都做一遍，不用管哪个是 .vbs 哪个是 .ps1。
- 如果没有「解除锁定」这一项却仍然被拦：弹窗里点「更多信息」，再点「仍要运行」。
- Win11 默认不显示扩展名，文件夹里看到的是 start-token-counter 而不是 start-token-counter.vbs。想看清扩展名：资源管理器 → 查看 → 显示 → 文件扩展名。

2. 把整个 dsh-token-counter 文件夹放到一个固定位置，比如 D:\tools\dsh-token-counter。
路径不敏感，中文和空格都行。

位置尽量定下来。挪动之后程序本身还能跑，但第 5 步的自启快捷方式会失效（症状是下次开机图标不出现），把启动文件夹里那个快捷方式删掉重建即可。

3. 双击启动器（start-token-counter）。托盘出现图标就算装好，首次启动等一两秒。

4. 图标没出现或者找不到：
- 先点任务栏右下角那个向上的小箭头（∧），那是「隐藏的图标」面板，多半在里面。
- 想让它常驻：设置 → 个性化 → 任务栏 → 其他系统托盘图标，把开关打开。
- 注意：Windows 是按程序来记托盘项的，这两个工具都是 PowerShell 跑的，所以在那个列表里它显示成「Windows PowerShell」，不叫「大模型用量计数器」。
认它要靠外观：偏绿的小圆圈里面是数字。

5. 开机自动跑，两种办法任选一种：

办法 A：右键启动器 → 发送到 → 桌面快捷方式；按 Win + R 输入 shell:startup 回车，打开「启动」文件夹；把桌面那个快捷方式剪贴进去。

办法 B：在「启动」文件夹里右键 → 新建 → 快捷方式，位置填下面这行（路径换成你实际的，引号要留着，路径有空格时尤其需要）：

wscript.exe "D:\tools\dsh-token-counter\start-token-counter.vbs"

建议设上自启，原因见下面「已知限制」。

怎么用

- 平时不用管，它每分钟自己读一次。
- 想看细节就右键图标点「明细」。
- 同一时间只会跑一个：重复双击，多出来的那个会自己退出。
- 占内存大约 100 到 150 兆。

数字是什么口径

- 合计 = 未缓存输入 + 输出 + 缓存读取。 图标上那个数，就等于明细里那一行的「合计」。
- 明细里五项分别是什么：

| 项 | 含义 |
| 输入 | 这次对话真正发给模型的、没被缓存命中的部分 |
| 输出 | 模型生成的 |
| 缓存读取 | 命中了缓存的输入，数量大但单价便宜得多 |
| 缓存写入 | 写入缓存的部分，DeepSeek 这边一直是 0，所以不计入合计 |
| 合计 | 前三项相加 |

- 缓存读取这一项通常比其它几项大得多，但它的单价便宜得多，所以别只看总数。
- 数值四舍五入：以「万」显示保留一位小数，以「亿」显示保留两位。
- 「今天」按你本机的零点切换。
- 这是本机 DSH 的用量，不等于 DeepSeek 后台的账单：后台还有错峰优惠，价目也会变，你在别的客户端用同一个账号的消耗也不在这里。所以这里只报 token，不折算成钱。
适合拿它看趋势和相对量，不要当对账单用。
- 数据来源是 DSH 在本机存的会话用量缓存，只读，不改动 DSH 的任何东西。
想自己核实：打开用户目录下的 .dsh\storages\session_projcache\sessions 这个文件夹，里面每个 json 就是一路用量。这个目录不存在，就说明 DSH 没装好或者没跑过。

第一次装完会看到什么

今天从零开始数，「昨日」要等第二天才会有数，刚装上时数字很小或者为 0。

怎么判断到底有没有读到 DSH 的数据：打开「明细」，看着那一分钟里「缓存读取」有没有往上涨。
你在用 DSH 的时候它应该涨；钉住不动就是没读到，先去确认上面那个 .dsh 目录在不在。

已知限制

- 按天记账是从这个程序开始运行那一刻算起的。程序没运行的那段时间，用量会漏记。
所以建议设开机自启（第 5 步）：它跟着开机起来就不会漏。
手动打开也能用，但从开机到你打开之间的用量会记不到。
- 只统计本机的 DSH。多账号切换、其他客户端、网页版都不在这里面。
- 电脑休眠期间不会读数，但 DSH 那时候通常也没在跑，所以影响不大。

重置

右键退出，删掉 state.json，再重新启动。
注意：重开之后它会以当时的累计值为新起点，也就是从那一刻重新开始记，之前的天数全部清零。

常见故障对照

图标不见了 先点任务栏的 ∧ 看隐藏面板；再检查 设置 → 个性化 → 任务栏 → 其他系统托盘图标（里面显示成 Windows PowerShell）。

数字一直是 0，或者不动 先确认 DSH 装了、用过了（看上面那个 .dsh\storages\session_projcache\sessions 在不在）。
再看明细里「缓存读取」有没有涨。都不动就看日志。

开机后图标不出现，以前是好的 多半是挪过文件夹，自启快捷方式失效了，删掉重建。

双击启动器没反应 先按第 1 步做解除锁定；再看杀毒软件是不是拦了 .vbs。
手动跑一次：开始菜单搜 PowerShell 打开，粘贴下面这行回车，看有没有红字（执行策略要显式带上，直接右键「使用 PowerShell 运行」会因为策略被拦）：

powershell -NoProfile -ExecutionPolicy Bypass -File "D:\tools\dsh-token-counter\token-counter.ps1" -Once

日志怎么看

token-counter.log 在工具文件夹里，双击就用记事本打开了。
它很小（几十 KB 以内），删了会自动重建，跑一会儿才会出现。

正常运行时里面基本只有几行 tray started；出现别的字样就把日志留着给我看。
日志是空的又确实有问题，就走上面的常见故障对照。

怎么删干净

1. 右键托盘图标 → 退出。
这一步别省。实测不退也能把文件夹删掉，但那个进程还在后台跑，而且每隔几秒就找不到文件报一次错，你还得再去任务管理器结束它。先退出省事。
2. 确认真的退干净：按 Ctrl+Shift+Esc 打开任务管理器，切到「详细信息」标签，右键列标题 → 选择列 → 勾上「命令行」，找 powershell.exe，看命令行里还有没有 token-counter.ps1。没有就算干净。
如果文件夹已经删了但进程还在：在任务管理器里结束那个 powershell.exe，或者重启一次电脑。
3. 删掉整个 dsh-token-counter 文件夹。你的用量数据 state.json 也在里面，一起没了。
4. 删掉「启动」文件夹里那个快捷方式（如果你设过自启）。Win + R 输入 shell:startup 回车就能打开。
5. 如果你在「其他系统托盘图标」里动过开关，那里会留一条记录（记的是 PowerShell 这个程序，不是本工具），不用特意清，不影响什么。

除此之外没改过系统别的东西：没有系统服务，没有安装程序，注册表里也只有上面第 5 条那个托盘开关记录。
DSH 本身的数据一点没动。

怎么更新

这个文件夹就是全部，没有自动更新。你自己留着新版本的话：先右键托盘图标退出，用新版本覆盖整个文件夹，再双击启动器。state.json 留着，历史数据不会丢。

版本号在 README 第一行标题下面，也在 token-counter.ps1 开头的注释里（看注释要用记事本打开，直接双击 .ps1 会运行它）。

如果你要把这个文件夹传到公开仓库

state.json 里是本机的大模型用量明细，token-counter.log 里有运行记录，两个都已经在 .gitignore 里排除。其余文件不含任何个人信息，可以放心公开。

文件都是干什么的

| 文件 | 说明 |
| token-counter.ps1 | 主程序 |
| start-token-counter.vbs | 启动器，双击这个 |
| README.md | 就是本文件 |
| AGENTS.md | 给改代码的 AI 看的，普通使用可以不管 |
| LICENSE | 许可 |
| state.json / *.log | 运行后自动生成，可以随手删 |

想改代码、或者想知道这些数是从哪儿读的、为什么不能换个读法，看 AGENTS.md。