中文 | English
dsh-speed-gauge
给 DSH 加一个生成速度仪表盘。装在标题栏，点一下展开，实时看当前会话输出有多快。
60 帧丝滑监测 token 输出：逐 chunk 计数，每帧刷新表盘与曲线，主线程卡顿也不掉帧。
面板
主要功能
- 实时速度：0–500 tok/s 半圆表盘，指针平滑跟随
- 30 秒曲线：60 帧连续左移，能看清速度的起伏
- 平均 / 峰值：都按最近 30 秒统计，峰值滑出窗口自动回落
- 总输出：优先用官方 usage 的 outputTokens
- 按会话隔离：切到别的会话或子代理，面板跟着切
- 不占地方：面板浮在会话内容列顶部，宽度跟随内容列；标题栏按钮可随时收起
- 配色跟随宿主：深色界面浅字，浅色界面深字
安装
插件市场
暂未上架，等上架后可以直接在市场里搜 dsh-speed-gauge。现在请用下面的方式安装。
方式一：从 Release 直接安装（推荐）
一条命令，不用先下载：
dsh plugin --profile desktop add https://github.com/MoreanP2003/dsh-speed-gauge/releases/download/v1.0.2/dsh-speed-gauge-1.0.2.tgz
也可以先到 Releases 下载 dsh-speed-gauge-1.0.2.tgz，再装本地文件：
dsh plugin --profile desktop add ./dsh-speed-gauge-1.0.2.tgz
方式二：克隆仓库后安装
git clone https://github.com/MoreanP2003/dsh-speed-gauge.git
dsh plugin --profile desktop add ./dsh-speed-gauge
方式三：npm 包（发布到 npm 后可用）
dsh plugin --profile desktop add dsh-speed-gauge
dsh plugin --profile web add dsh-speed-gauge
桌面端注意
桌面应用请用它自带的 CLI，普通 dsh 命令管不了 desktop profile：
"<安装目录>\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add <包或目录>
macOS 上是同一个 CLI，路径不同：
"/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" plugin --profile desktop add <包或目录>
Linux 同样找应用目录下的 resources/runtime/cli/bin/dsh。
安装完在应用里重载一次（或重启）即可看到标题栏按钮。
更新 / 卸载
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- 开头，只操作自己创建的节点，可与其它插件共存
网页版 / 远程访问
开关按钮在网页版会自动寻找 composer 里的模式胶囊当锚点；找不到时落在会话内容列顶部。
自定义路由默认只接受回环地址。走网页版或反向代理时，在启动 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
