前言¶
在 DeepSeek Harness（DSH）里跑长对话或工具链时，模型是否在稳定输出、上下文是否逼近上限、缓存是否命中，往往只能凭体感或事后看统计。Retro Dock 把这三类信息做成输入框附近的仪表：流式生成时指针反映实时 tok/s，停下后保留上一轮均速；外环显示上下文占用，内环显示缓存命中。下面介绍插件定位、能力、安装与使用注意。
这是什么¶
Retro Dock（GitHub：usermbzlj/dsh-retro-dock）由维护者 usermbzlj 发布，面向 DSH 的 Web 对话界面（Composer）。它在输入框区域挂载一块「速度表」式 UI：读数来自宿主投影、聊天 store 或页面文本回退（优先级见下文），速度经 1.2 秒滑动窗口估算并用宿主 sessionStats 校准，不是服务端逐 chunk 的精确计数。
社区目录 SkillHub 插件页 将其归类为模型推理相关能力；仓库 package.json 中 dshhub 标签含 Web UI、观测。许可为 MIT，当前资料中的版本为 1.7.0。
一眼能读到的信息¶
经过上面的定位，核心读数如下（与 README 一致）：
- 速度：实时 tok/s，指针 + 数字；与 DeepSeek 用量统计校准，估算时带
≈。 - 本轮均速：表盘外圈小三角标出滚动均速；停下后数字保留上一轮均速（单位显示为「均速」），指针归零。
- 上下文（CTX）：外环占比；默认在 80% 警戒前为中性色，越线后弧段、数字与
!变色（警戒线可在设置中选 70 / 80 / 90%）。 - 缓存命中（HIT）：内环，青色图例。
- 可信度角标：无宿主统计、改按页面文字估算时显示「估」；数据中断时显示虚线「停」。
四种外观与交互¶
四种样式读同一组数据，在 设置 → Retro Dock → 样式 切换，选中即生效：
| 样式 | 说明 |
|---|---|
| 经典 | 240° 双表盘，默认 |
| 广播 VU | 象牙表盘、宽扇区 |
| 记录纸 | 20 秒走纸，看走势 |
| 瑞士尺 | 数字 + 发丝尺，最安静 |
经典与 VU 可选里程表式鼓轮读数，并在 CTX 旁加绿/黄/红三灯。
交互要点：
- 点击仪表：在「输入框上方」与「底部统计条」之间切换；Tab 聚焦后
Enter/Space同样有效。 - 悬停：tooltip 含速度、上下文、缓存命中、最近一轮（首字延迟、均速、输出量）、满量程、校准倍率与数据源。
- 密度：随宽度自动完整 / 紧凑 / 最小；最小模式折成一行，CTX 告警仍变色并带
!。 - 主题：经典与瑞士尺跟随宿主明暗；VU 为固定暖色亮表；记录纸在深色下用深色纸。
偏好集中在宿主 设置 → Retro Dock（样式、空闲保留均速、鼓轮、信号灯、位置、密度、满量程 120/180/240/300 tok/s、警戒线、附加读数、语言）。设置页右侧为按当前选项渲染的预览。另有「测量」区：最近一轮指标、校准状态与重置、测量日志导出（仅时间戳与 token 计数，不含对话内容）。
安装与启用¶
先确认 profile：dsh web 用 web，桌面应用用 desktop。
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。
典型用法¶
- 按上一节命令安装并重启 DSH，在 Web（Chromium 内核）中打开对话界面。
- 发起一次流式回复，观察速度针与 CTX/HIT 环；需要细节时悬停看 tooltip。
- 若仪表挡视线，点击仪表切到输入框上方或底部统计条。
- 在 设置 → Retro Dock 调整满量程、警戒线或切换四种外观；需要核对校准时使用测量区导出日志（无对话正文）。
调试时可查看 window.__retroDock 镜像；持久化偏好 key 为 dsh-retro-dock:prefs:v3（旧版 v2 与 rg-gauge-placement 会自动迁移）。
数据从哪来、测什么¶
优先级（高到低）：
- 宿主投影：
contextPressure、tokenUsage、sessionStats。 - 聊天 store：
useChat(s => s.legacy.partial)，仅统计模型输出字段。 - 页面文本回退：投影缺失时读宿主可见文本，仪表标「估」。
速度为估算 + 校准：1.2 秒窗口、流式增量计数、sessionStats token 增量校准，倍率限幅 0.4–2.5；本轮均速会去掉超过 1.5 秒的间隔（如工具等待）。完整公式见仓库 MEASUREMENT.md。
隐私与性能（README 说明）：不发网络请求、不读凭据；空闲停 rAF；有聊天流时不挂 DOM observer；仅记录纸选中时以 4Hz 记 20 秒轨迹，页面隐藏时暂停。
适用场景与注意¶
适合需要在 Composer 边写边看 tok/s、上下文压力、缓存命中 的 DSH 用户，尤其是长上下文或多轮工具调用时想提前看到 CTX 越线。
务必注意：
- 插件在 当前 DSH 进程权限 下运行；安装前请自行审阅 源码与许可证。
- 兼容：宿主
dsh >= 0.2.0-rc.1 < 0.3.0，资料写明在0.2.1-rc.3验证；平台为 web（Chromium）。 - 限制：
sessionStats缺失时无法校准；页面文本回退不如宿主投影可信。
DSH 生态强调「一切皆插件」；SkillHub 目录 为社区站点，与 DeepSeek / 幻方无官方从属关系。
结尾¶
Retro Dock 把 Composer 上的输出节奏和上下文、缓存状态做成可扫一眼的仪表，并可在设置里换四种外观与量程。需要安装命令与测量契约时，以仓库 README 为准。
- 目录页：https://www.skillhub.cn/plugins/usermbzlj/dsh-retro-dock
- GitHub：https://github.com/usermbzlj/dsh-retro-dock
