实时速度卡片 TINGOD2006/dsh-tps

dsh-tps

当前会话的实时 tokens/s 读数卡片。既可以停靠到左侧栏，也可以作为悬浮卡片拖动——用卡片右上角的两个按钮切换。

显示什么

- 实时 t/s：流式输出速度，来自真实的 agent/assistant-stream 增量（滑动窗口，带分母下限，分片突发时读数不会爆表）。
- 平均 t/s：从第一个 token 起的整场平均；卡片头部的分段按钮切换「实时 / 平均」。
- 波形：最近 40 个采样点。
- 当前任务名：在速度数字上方靠左显示，跟随卡片所选会话，折叠后仍保留。
长名称以省略号截断，悬停可查看完整名称；尚无标题时显示会话短 ID。
- 会话列表：每个有读数的会话，标题后面用括号写出它所在的工作区，例如
dsh-tps (dsh-tps)；点击某一行即可把读数切到那个会话，不影响当前页面。

固定左侧 / 悬浮

卡片右上角两个按钮决定形态：

- 左侧：停靠进侧栏底部。卡片跟随侧栏——座位消失时（窄窗口、收起侧栏）临时退回悬浮位，而不是直接消失。
- 悬浮：固定在右下角浮动，可整张卡片拖动。

选择记在 localStorage，悬浮位置、折叠状态、实时/平均模式一并记住。

拖动

悬浮态下整张卡都能拖：标题行、数字、波形、空白处都行。只有按钮、分段切换和会话行不参与拖动（它们是点击目标）。拖动事件挂在 document 上，指针滑出卡片也继续跟手；刚拖完不会误触发点击。

安装

dsh plugin add TINGOD2006/dsh-tps

然后重启 harness 服务，卡片会出现在侧栏里。无需构建，无运行时依赖。

工作方式

- lib/tracker.js：按会话维护滑动窗口，数据来自 agent/assistant-stream 与 session/event（回合边界、缓存命中用量）。
- lib/index.js：订阅上述事件，提供 GET /dsh-tps/state.json 与 GET /dsh-tps/widget.js，并用两条注入路径把卡片塞进页面：结构化的 webserver/index-inject 注入行（Electron 桌面壳）与 ctx.webServer.tapIndex() （Host 自己渲染 index.html 的部署，如 dsh web）。
- lib/widget.js：每次请求都从磁盘读取，改完刷新页面即可生效，不用重启；页面还在跑旧版时会显示 ⟳ 提示。

同一毫秒到达的分片合并为一个采样点，保留突发输出的完整 token 数。即使没有打开卡片，事件流也会最多每分钟清理一次过期会话。状态与更新检查请求均设有 5 秒超时，覆盖响应正文读取；超时后继续重试，连续失败三次则将轮询间隔放慢至 5 秒。

测试

npm test

覆盖窗口分母下限、静默衰减、本步生成中读数、block-end 兜底、缓存命中累计、分片合并与会话回收。前端测试在轻量 DOM 与虚拟时钟中运行完整注入脚本，验证超时恢复、失败退避、页面可见性切换与版本检查，无需真实等待、网络或外部依赖。

许可证

MIT