@local/retro-dock
DeepSeek Harness composer 的实时速度仪表：通过真实指针表盘显示 tokens/sec、上下文压力和缓存命中率，空闲时保留上一轮的平均值。提供 Classic、VU、chart 和 Swiss 外观。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:usermbzlj/dsh-retro-dock#bc76befc6743b9d441b3a4c91e15004091e8a6f4Retro Dock 以 @local/retro-dock 发布，当前版本为 1.7.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
给 DeepSeek Harness 的输入框装一块实时速度表：模型在写的时候，指针告诉你它有多快；停下来之后，数字留住上一轮的平均速度。旁边的小表盘显示上下文占用和缓存命中。
≈ 表示估算。! 一起变色。| 样式 | 机构 | 适合 |
|---|---|---|
| 经典 | 240° 双表盘、锥形针、配重尾 | 默认；三个读数一眼看全 |
| 广播 VU | 象牙表盘、宽扇区、超量程红区 | 长时间陪伴 |
| 记录纸 | 20 秒走纸 | 余光看走势和掉速 |
| 瑞士尺 | 数字、发丝尺、方块游标 | 最安静 |
四种外观读同一组数据与校准，在「设置 → Retro Dock → 样式」里切换，选中立即生效。经典和 VU 还可以把速度换成里程表式鼓轮，并在 CTX 旁加绿/黄/红三灯。
Enter / Space 也可以。!。样式、空闲读数（保留上一轮均速）、鼓轮读数、上下文信号灯、位置、密度、满量程（120 / 180 / 240 / 300 tok/s）、上下文警戒线（70 / 80 / 90%）、附加读数开关、语言。设置页右侧是按当前设置渲染的真实预览。
另有「测量」区：最近一轮的首字延迟 / 平均速度 / 输出量、校准状态与重置、测量日志导出（只含时间戳和 token 计数，不含对话内容）。
先确认 profile：dsh web 使用 web profile，桌面应用使用 desktop profile。
DSH Web
npx @deepseek-ai/dsh plugin --profile web add github:usermbzlj/dsh-retro-dock
桌面应用
cd ~/.dsh/profiles/desktop
pnpm add github:usermbzlj/dsh-retro-dock
安装后确认 ~/.dsh/profiles/<profile>/package.json 的 dsh.profile.bundles 包含 @local/retro-dock；若 CLI 没自动写入，手动加进数组，再重启 DSH。
本地打包
npm pack # local-retro-dock-1.7.0.tgz
优先级从高到低：
contextPressure、tokenUsage、sessionStats。useChat(s => s.legacy.partial)，只统计模型输出字段。速度是估算 + 校准，不是服务端逐 chunk token 计数：1.2 秒滑动窗口，流式内容增量计数，用宿主 sessionStats 的 token 增量校准，倍率限幅 0.4–2.5。本轮均速去掉超过 1.5 秒的间隔（工具等待等）。完整公式与失效条件见 MEASUREMENT.md。
隐私：不发网络请求、不读凭据；只持久化一个偏好 key（dsh-retro-dock:prefs:v3，旧的 v2 与 rg-gauge-placement 会自动迁移）。window.__retroDock 是调试镜像。
性能：空闲时停 rAF；有聊天流时不挂 DOM observer；流式计数 O(delta)；密度用 ResizeObserver；只有记录纸在选中时以 4Hz 记录 20 秒轨迹，页面隐藏时暂停。
dsh >= 0.2.0-rc.1 < 0.3.0；当前在 0.2.1-rc.3 上验证。sessionStats 缺失时无法校准；页面文本回退不如宿主投影可信。npm install
npm run build # 把 src/ 打包成 client.js
npm test # 71 项测试
npm run preview # 生成 docs/gallery.html（样张与设置页）
npm run shots # 需要 Chromium：npx playwright install chromium
node review/states-shoot.mjs # 四种外观 × 两个位置 × 全部状态的验收截图
client.js 是构建产物，不要手改。源码结构：
src/measure.js 纯测量函数
src/stream.js 增量流式计数
src/rate.js 1.2s 窗口、平滑、校准
src/engine.js 进程级引擎（含最近一轮统计）
src/prefs.js 偏好存储与迁移
src/themes.js 样式、密度、量程等偏好校验
src/i18n.js 中英文字符串
src/ui/classic.js 经典双表盘
src/ui/design-gauge.js VU / 记录纸 / 瑞士尺共用的外壳
src/ui/designs/ 三套机构 + 共用零件（鼓轮、信号灯、最小读数行）
src/ui/gauge.js 槽位组件与状态接线
src/ui/settings.js 宿主设置页
src/styles/ 对应 CSS
scripts/ build / gallery / shots
%，HIT 标签作图例；信号灯改实心灯罩；设置页灰掉不适用的开关；README 与样张更新为四种外观。MIT