速度仪表盘 MoreanP2003/dsh-speed-gauge

dsh-speed-gauge

给 DSH 加一个生成速度仪表盘。装在标题栏，点一下展开，实时看当前会话输出有多快。

每秒 50 次获取 tok/s：逐 chunk 计数，测量更细更精准；主线程卡顿也不掉帧。

面板

主要功能

- 实时速度：0–500 tok/s 半圆表盘，指针平滑跟随
- 30 秒曲线：连续左移的流动趋势图，能看清速度的起伏
- 平均 / 峰值：都按最近 30 秒统计，峰值滑出窗口自动回落
- 总输出：优先用官方 usage 的 outputTokens
- 按会话隔离：切到别的会话或子代理，面板跟着切
- 不占地方：面板浮在会话内容列顶部，宽度跟随内容列；标题栏按钮可随时收起
- 配色跟随宿主：深色界面浅字，浅色界面深字

安装

插件市场

暂未上架，等上架后可以直接在市场里搜 dsh-speed-gauge。现在请用下面的方式安装。

方式一：GitHub Releases 下载安装包（推荐）

到 Releases 下载 dsh-speed-gauge-1.0.0.tgz，然后：

dsh plugin --profile desktop add ./dsh-speed-gauge-1.0.0.tgz

方式二：克隆仓库后安装

git clone https://github.com/MoreanP2003/dsh-speed-gauge.git
dsh plugin --profile desktop add ./dsh-speed-gauge

方式三：npm（一条命令）

dsh plugin --profile desktop add dsh-speed-gauge
dsh plugin --profile web add dsh-speed-gauge

包页面：https://www.npmjs.com/package/dsh-speed-gauge

桌面端注意

桌面应用请用它自带的命令行，普通 dsh 命令管不了 desktop 配置档：

"<安装目录>\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add <包或目录>

安装完在应用里重载一次（或重启）即可看到标题栏按钮。

更新 / 卸载

dsh plugin --profile desktop add <包或目录>
dsh plugin --profile desktop remove dsh-speed-gauge

使用

装好后标题栏会多出一个「速度仪表盘」按钮，点它就展开面板，再点收起（状态会记住）。

点这里打开面板

面板右侧的「归零」清空当前会话的累计值与峰值。

| 浅色 | 深色 |
| 浅色 | 深色 |

数据口径

- 字符数来自 llm/stream 的增量：正文、思考正文、工具调用参数；
- 实时速度 = 字符率 ÷ 每 token 字符数，比例系数用官方 usage.outputTokens 在线标定；
- 总输出以官方 usage 累加为准，没有 usage 的流按字符数估算；
- 曲线、平均、峰值都用 30 秒窗口。

兼容性

- DSH >= 0.2.1（在 0.2.1-rc.2 上开发与验证），需要宿主提供 webServer 服务与 llm/stream 钩子
- Node.js >= 20
- React 18，由宿主提供，不重复打包
- 面板用 Worker + OffscreenCanvas 绘制；页面 CSP 不允许 Blob Worker 时自动退回一行文字
- 所有 DOM 类名以 dsg- 开头，只操作自己创建的节点，可与其它插件共存

网页版 / 远程访问

自定义路由默认只接受回环地址。走网页版或反向代理时，在启动 DSH 的环境里设置：

DSH_SPEED_GAUGE_ALLOW_REMOTE=1

调试

采样日志默认关闭。需要时设 DSH_SPEED_GAUGE_LOG=1，日志写到系统临时目录。

开发

node --test test/sampler.test.mjs test/host.test.mjs

| 文件 | 作用 |
| host.js | 监听 llm/stream，提供 SSE 与快照接口 |
| sampler.js | 采样与统计，纯逻辑、可单测 |
| client.js | 标题栏按钮 + 面板容器 |
| panel-worker.js | 面板绘制（Worker + OffscreenCanvas） |

许可证

MIT