预填充速度统计 stefanohe/dsh-prefill-speed-stats

dsh-prefill-speed-stats

作者 Stefano's AI Lab

dsh-prefill-speed-stats：直接在状态栏中显示预填充速度。【适用于：deepseek-harness-v0.2.0-rc.2】

英文界面中的预填充统计信息

它在自带的会话统计条左侧添加一个单元格，显示会话平均预填充速度，并打开一个两行对话框，其中包含会话平均值和最近 N 步的窗口值。

安装

两种安装方式。两者最终都需要相同的两个步骤：完全重启应用——浏览器包在启动图组合时就被快照了，因此仅刷新页面是不够的——然后在左侧的插件面板中开启新插件。

推荐使用 pnpm 11.7.0。 如果尚未安装 pnpm：

npm install -g pnpm@11.7.0

A. 从 npm 安装——无需克隆任何内容：

1. 将包添加到你的 DSH 配置文件中——其目录为 /profiles/，此插件面向 desktop 配置文件——或使用插件管理器（Settings → Plugins，或 plugin_manager 智能体工具）：

pnpm add dsh-prefill-speed-stats

若 DeepSeek Harness 位于默认位置：

cd "$env:USERPROFILE\.dsh\profiles\desktop" ; pnpm add dsh-prefill-speed-stats # Windows
cd ~/.dsh/profiles/desktop ; pnpm add dsh-prefill-speed-stats # macOS / Linux

2. 检查该配置文件的 package.json 中 dsh.profile.bundles 是否列出了该包名（通过插件管理器安装会自动完成此操作）。
3. 重启应用。
4. 打开左侧的插件面板并开启新插件：

在插件面板中开启插件

B. 从本仓库安装——适用于源码、离线或 npm 未提供的版本：

pwsh -File .\install.ps1 # Windows
sh ./install.sh # macOS / Linux
pwsh -File .\install.ps1 -From npm # …或改为安装已发布的包

该脚本会为你执行步骤 1–2，备份它所编辑的清单文件，并打印剩余需要完成的操作。

显示内容

| 行 | 值 |
| 停靠单元格 | 会话平均预填充速度，单位为 tok/s |
| Prefill speed (session average) | 整个日志范围内的 Σ 未缓存提示词 token ÷ Σ 预填充窗口 |
| Prefill speed (last N steps) | 最近（最多 10 个）已测量步骤的相同比率——标签会标明它实际平均的步数 |
uncached tokens 就是 usage.inputTokens：即提供方必须计算的那部分提示词，其中前缀缓存命中不产生任何开销。prefill window 是 step/start → 第一个可见 token。从未产生可见 token 的步骤没有窗口，因此它们被排除在两行之外，并改为报告为 session.unmeasuredInputTokens。

读数偏低通常意味着没有多少新内容需要计算，而不是模型慢。 一个热步骤读取的未缓存 token 很少，而固定的每请求延迟（排队、往返、KV 缓存读取）保持不变，因此其数值会趋近于零；会话平均值会摊销那部分固定开销，而最近 N 步窗口则不会。该数值统计窗口内的所有内容，因此它是真实 prefill 吞吐量的下界。

文件

| 文件 | 作用 |
| index.js | Host 部分：注册 sessionSpeed 投影 |
| lib/projection.js | 折叠、其 schema，以及两个读数的操作数 |
| lib/stream.js | 首个可见 token 的计时 |
| client.js | 浏览器部分：dock 单元格、其对话框、样式和文案 |
| cordis.patch.yml | 插入浏览器部分所附加到的 Host 行 |
| test/ | 投影测试 —— node --test test/projection.test.cjs |
| install.ps1 / install.sh | 安装到 DSH profile —— 链接此检出，或使用 -From npm 获取已发布的包 |

说明

* 运行在 DeepSeek Harness 内。
* 位于随附的会话统计条左侧；同类的 dsh-show-balance 单元格在安装后位于其左侧。
* 读数会随会话增长而更新；无需配置。
* 未知事件和格式错误的日志记录会被忽略，而不是导致致命错误，因此未来的 harness 事件只会影响准确性，绝不会影响会话。
* 非官方插件；它仅使用公开接口（sessionSpeed Host 投影和 conversation.composer.dock 槽位）。

许可证

MIT —— 参见 LICENSE。

dsh-prefill-speed-stats：直接在状态栏显示 prefill 速度。【适用于：deepseek-harness-v0.2.0-rc.2】

中文界面下的输入统计

位置在内置「会话统计」左边；点开可看会话平均与最近 N 步两个读数。

安装

两种方式，最后两步一样：完全重启应用——浏览器 bundle 在启动组合时快照，刷新页面不够——重启后在左侧的插件面板里把新装的插件打开。

建议使用 pnpm 11.7.0。 如果还没安装 pnpm：

npm install -g pnpm@11.7.0

A. 从 npm 安装 —— 不用 clone：

1. 安装到 DSH profile —— profile 目录是 /profiles/，本插件面向 desktop profile ——或用插件管理器（设置 → 插件，或 agent 的 plugin_manager 工具）：

pnpm add dsh-prefill-speed-stats

DeepSeek Harness 装在默认位置时：

cd "$env:USERPROFILE\.dsh\profiles\desktop" ; pnpm add dsh-prefill-speed-stats # Windows
cd ~/.dsh/profiles/desktop ; pnpm add dsh-prefill-speed-stats # macOS / Linux

2. 确认该 profile package.json 的 dsh.profile.bundles 里有这个包名（用插件管理器装的话它会替你写）。
3. 重启应用。
4. 在左侧的插件面板里把新装的插件打开：

在插件面板里打开新装的插件

B. 从本仓库安装 —— 源码 / 离线 / npm 上没有的版本：

pwsh -File .\install.ps1 # Windows：链接当前克隆 sh ./install.sh # macOS / Linux pwsh -File .\install.ps1 -From npm # 也可以直接装 npm 上的已发布版本

脚本会替你做完第 1–2 步（并备份它改过的 manifest），然后提示剩下的步骤。

显示内容

| 行 | 值 |
| 状态栏上的格子 | 会话平均输入速度，单位 tok/s |
| 输入速度（会话平均） | 整个会话的 Σ 未命中缓存 token ÷ Σ 预填充窗口 |
| 输入速度（最近 N 步） | 同一算法，只统计最近（最多 10）个已测量步；标题会写出它真正平均了几步 |

未命中缓存 token 就是 usage.inputTokens：提供方真正需要计算的那部分提示词，命中前缀缓存的部分不计。预填充窗口 是 step/start → 首个可见 token。始终没产出可见 token 的步没有窗口，因此两个读数都不统计它，其 token 记在 session.unmeasuredInputTokens 里。

读数低通常意味着「这次几乎没新东西要读」，而不是模型慢。 缓存命中的步未命中 token 很少，而每次请求的固定开销（排队、往返、读 KV 缓存）不变，数字自然被压向零；会话平均把这些固定开销摊薄了，最近 N 步没有。由于窗口里的一切都计入分母，这个数字是真实预填充吞吐的下界。

文件

| 文件 | 作用 |
| index.js | 宿主半边：注册 sessionSpeed 投影 |
| lib/projection.js | 折叠逻辑、schema 与两个读数的算子 |
| lib/stream.js | 首个可见 token 的计时 |
| client.js | 浏览器半边：格子、面板、样式与文案 |
| cordis.patch.yml | 插入宿主行（浏览器半边挂在它上） |
| test/ | 投影测试 —— node --test test/projection.test.cjs |
| install.ps1 / install.sh | 装进 DSH profile（默认链接本地克隆，-From npm 装已发布版） |

说明

* 运行在 DeepSeek Harness 里。
* 位置在内置「会话统计」左边；装了 dsh-show-balance 时它在更左边。
* 读数随会话增长自动更新，没有任何需要配置的项。
* 未知事件与畸形日志记录一律忽略而不致命，未来的 harness 事件最多损失精度，不会损坏会话。
* 非官方插件，只使用公开接口（sessionSpeed 宿主投影与 conversation.composer.dock 槽位）。

许可

MIT，见 LICENSE。