前言¶
DeepSeek Harness（DSH）在处理智能体长文本输出时，默认的跟随滚动逻辑有时会过快，导致内容来不及阅读。chat-pace 插件针对这一痛点，提供了多种可配置的滚动模式和精细控制，让用户重新掌握阅读节奏，避免内容“飞过”屏幕。
插件定位¶
这是一个为 DeepSeek Harness Web UI 设计的插件，由 TheGoodMorty 维护。它解决了智能体输出速度过快的问题，通过提供 5 种滚动模式、全局热键和会话位置记忆功能，实现了与 DSH 内置跟随逻辑的协同工作。
安装与启用¶
在终端中执行以下命令安装插件：
dsh plugin add TheGoodMorty/chat-pace
安装完成后，必须重启 DSH 服务器并刷新页面，插件配置才会生效。控件会出现在工具行、停靠栏、会话头部以及设置页面中。
核心功能¶
滚动模式¶
插件提供 5 种滚动模式：
- Follow：DSH 默认行为，跳转到最新输出。
- Smooth：保持最新输出可见，以可配置的像素/秒速度平滑滚动。
- Paced：分段阅读。滚动到 settled（已 settled）的文本段落，暂停一段时间（计算公式为
sectionHeight / screenHeight × seconds-per-screen），然后继续。暂停时间被限制在可配置的最小值和最大值之间（最高 80 秒）。 - Step：手动滚动，每次按一次（按钮或热键）滚动一个段落。
- Hold：锁定视图，新输出不会移动视图。
控件与热键¶
- 界面控件：位于工具行、停靠栏、会话头部和设置页。
- 全局热键：
F9：暂停/恢复Ctrl+ArrowDown：下一节Ctrl+ArrowUp：上一节Ctrl+End：跳转最新
会话记忆¶
- 设置页面：可配置会话打开位置（顶部、底部或上次停留处）。
- 位置存储：会话的阅读位置记忆存储在
localStorage的dsh-chat-pace-scrollpos-v1中，独立于会话打开位置设置。 - 恢复逻辑：如果选择“上次停留处”，系统会尝试恢复该位置。恢复过程会持续约 12 秒，若在此期间用户触摸视图，恢复会立即中断并锁定当前位置。
持久化设置¶
所有配置选项保存在 localStorage 的 dsh-chat-pace-settings-v1 中，刷新页面后依然生效。
协同工作原理¶
插件与 DSH 内置的跟随逻辑协同工作，而非替换它。
- 当内置逻辑尝试强制跳转到底部时，插件会识别这些跳转，并恢复用户的阅读锚点。
- 插件的滚动行为通过 scrollTop 值实现，不会与内置逻辑在同一帧内冲突。
- 插件通过监听滚轮、触摸和按键事件来追踪用户意图，一旦检测到用户手动滚动，自动滚动模式会立即让出控制权。
调试与维护¶
在浏览器控制台中，可以通过 window.__chatPaceDebug 获取调试信息，包括引擎状态、实时设置（通过 getSettings()）和最近的滚动决策日志（scrollLog），用于排查插件异常行为。
适用场景与注意¶
此插件适用于需要精细控制阅读节奏的开发者和用户。由于插件直接运行在浏览器端，建议在安装前检查源码与许可证（MIT）。
