聊天滚动节奏 TheGoodMorty/chat-pace

chat-pace

为 DeepSeek Harness Web UI 提供可配置的聊天自动滚动——智能体输出永远不会快到让你读不过来。

新增五种滚动模式、屏幕控件、全局热键、完整设置页面，以及按会话记忆阅读位置。它与内置的跟随逻辑协同工作而非取而代之，因此任何模式都可以安全地保持开启。

安装

dsh plugin add TheGoodMorty/chat-pace

然后重启 DSH 服务器（组合配置在启动时读取）并刷新页面。控件会出现在输入框工具栏、输入框停靠区、会话标题栏，以及 设置 → Chat Pace 下。

模式

| 模式 | 行为 |
| Follow | 内置默认：立即跳转到最新输出。 |
| Smooth | 让最新输出保持在视野内，以可配置的 px/s 速度滑动。 |
| Paced | 逐段阅读：滑动到每个已稳定的文本段，暂停 sectionHeight / screenHeight × seconds-per-screen 的时长，然后继续。较高的段落会在暂停期间缓缓穿过自身。在文本段之间，视图会继续实时跟随工具输出；而当某个文本段正在写入时，视图会保持不动，让文本在折叠线下方未被阅读地到达。稳定时已完全可见的段落会被跳过——它们是在你眼前流式呈现的。 |
| Step | 不自动滚动；每次按键（按钮或热键）前进一段，可选动画。 |
| Hold | 视图被固定；新输出永远不会移动它。 |

“输出段”指每条已稳定的助手消息（状态为 settled/interrupted 的 assistant-step）；工具结果和命令行可以选择加入。

Paced 阅读暂停被限制在可配置的最小值和最大值之间（最高 80 秒），因此单个超大段落永远不会让视图冻结数分钟，而较高的段落会以阅读速度缓缓穿过其文本，而不是静止不动。

控件

- 输入框工具栏 — 暂停/继续、下一段，以及模式菜单（始终可见）
- 输入框停靠区 — 实时状态行和阅读暂停进度条
- 会话标题栏 — 模式菜单按钮
- 设置 → Chat Pace — 所有选项：模式、滑动速度、每屏阅读秒数、暂停限制、段落类型、行为开关、会话打开位置，以及带冲突检测的热键录制器
- 全局热键（默认）：F9 暂停/继续，Ctrl+ArrowDown 下一段，Ctrl+ArrowUp 上一段，Ctrl+End 跳转到最新

用户的滚轮/触摸输入会立即从任何自动滚动模式手中夺回控制权；一个可选开关会在你滚回底部时自动恢复。

设置持久化在 localStorage（dsh-chat-pace-settings-v1）中。

会话打开位置

“当会话打开时”（设置 → Chat Pace）决定当你打开或切换到某个对话时它落在哪里：顶部、底部，或我上次离开的位置。每个会话的最后阅读位置会按会话记忆在 localStorage（dsh-chat-pace-scrollpos-v1）中，无论此设置如何——都作为行锚点加偏移量保存，因此它能经受内容增长和窗口缩放——所以之后启用“Where I left it”时，仍能恢复你在开启它之前离开的会话。恢复通过定时器运行（而非 requestAnimationFrame），如果你在恢复过程中触碰视图，它会立即让出，并在 UI 自身的布局恢复期间保持其位置长达 12 秒。

它如何与已发布的跟随逻辑共存

已发布的 ChatView 在读者位于底部时，会在内容增长时贴靠到底部，并在滚动事件显示读者移动时脱离。chat-pace 能识别这些贴靠（与底部相邻的跳转，伴随 scrollHeight 增长且近期没有用户输入），并恢复读者的锚点行；对已发布的处理器来说，这次恢复读起来像是读者移动，因此它会自行脱离。平滑/有节奏的运动以引擎编写的 scrollTop 值逐帧写入——对已发布代码来说就是普通读者滚动——所以两者永远不会在同一帧上冲突。读者意图通过滚动视口上的 wheel/touch/pointer/scroll-key 监听器来跟踪。

支持

一个最小的只读诊断句柄以 window.__chatPaceDebug 暴露在页面控制台中：引擎状态、实时设置（通过 getSettings()），以及一个有界的近期引擎决策环形缓冲区（scrollLog）。如果出现问题，该日志是定位问题最快的方式。

许可证

MIT