dsh-plugin-token-stats

DeepSeek Harness 的 token 用量看板：右下角一个可拖动的胶囊，点开是分时段、分模型的消耗图表。

安装

DeepSeek Harness 桌面端——侧栏打开插件，添加插件，填 dsh-plugin-token-stats，点安装，装好后点 立即启用。

就这样。右下角随即出现胶囊，随便拖到哪，位置会记住。

其他安装方式

让 agent 装——对桌面端里的 agent 说：

用 plugin_manager 把 dsh-plugin-token-stats 装进当前 profile

离线安装——把 .tgz 或本地目录的绝对路径填进「添加插件」，例如 D:\plugins\dsh-plugin-token-stats。填目录时 pnpm 建的是 junction，改源码即时生效。

非桌面 profile：

dsh plugin --profile web add dsh-plugin-token-stats

（dsh plugin --profile desktop 由桌面端独占，CLI 会直接拒绝。）

胶囊显示全部会话的累计总量与今日用量。点开面板：

时间范围：今天 · 指定日（任选某一天）· 本周 · 近 30 天 · 近 12 周 · 近 12 月
选某一天：日期选择器、‹ / › 逐日翻、今天/昨天/前天/7 天前快捷按钮；也可以在 30 天/12 周/12 月图上点任意一根柱子，直接钻取到那天
模型筛选：全部模型或任一模型，图表与数字随之切换
六个指标：区间总计 / 输入 / 输出 / 缓存读取 / 计费合计 / 请求数
柱状图分色：实心＝计费（输入+输出），浅色＝缓存读取
用量排行：按会话或按模型，跟随所选范围

可拖动、记住位置：按住胶囊，或按住面板标题栏空白处拖动。位置以比例记住——刷新、重开浏览器、重启 dsh 都还在原处，窗口放大缩小时相对位置也不变。

读 $DSH_HOME/sessions/**/session.v3.jsonl.zstd，聚合每个 assistant/message 事件的 data.usage（provider 上报的真实用量）。

读的是持久日志而不是实时计数器，所以历史会话——包括更早进程创建的——都在统计范围内。

插件页里卸载即可。官方当前不支持插件自动更新，升级要卸载后重装新版。

只计 assistant/message 的用量。session/title-llm-request 这类后台小请求也可能计费但没算进去，所以数字略低于真实账单。
缓存桶的字段名做了兼容猜测（cacheReadTokens 或 cachedInputTokens）。若 provider 改名，缓存会记 0，但输入/输出/总计仍准确。
「按会话」在「指定日」下是该日数据，在其它范围下是所选模型的全部时间 数据；「按模型」始终跟随所选范围（选项卡右侧标注了各自范围）。
「指定日」最早只能选到日志里最早的一天，更早的日期显示 0 与空状态。
「按会话」排行最多显示 8 条，不是分页列表。
全量扫描是同步 IO，会话很多时首次加载偏慢（结果缓存 5 秒）。
拖动只在胶囊和面板标题栏空白处生效。标题栏上的按钮、模型下拉、日期输入有自己的手势，不会被拖动抢走。
桌面版和 dsh web 端口不同，是两个源，所以浮窗位置各记各的。

扩展点、cordis 约束、拖动实现、测试与发布流程见 docs/DEVELOPMENT.md （仓库内，不随 npm 包分发）。

MIT