前言¶

在 DeepSeek Harness（dsh）里跑长回复时，默认 Web UI 的流式呈现往往不够顺滑：文字逐段跳出、Markdown 结构在生成过程中抖动，内容变高时滚动也容易顿挫，视线很难稳定贴在正在输出的位置。若你主要用 Harness 的 Web 界面做对话与工具调试，这类体验问题会直接影响阅读节奏。

下面介绍社区插件 dsh-smooth-stream。它面向 dsh Web UI，接管回复与工具行的渲染与跟随逻辑，让文字、Markdown、代码块、表格和工具结果随输出自然呈现，并在内容逐步增长时保持平稳滚动。

这是什么¶

dsh-smooth-stream 是由维护者 Laplace-bit 发布的 DeepSeek Harness 客户端插件，采用 MIT 许可证，与 DeepSeek 无从属关系。项目在 GitHub 上约有 51 stars、5 forks。

一句话定位：为 DeepSeek Harness Web UI 提供流畅流式渲染与丝滑滚动。npm 包名同为 dsh-smooth-stream，当前版本 0.3.4；项目主页见 https://laplace-bit.github.io/dsh-smooth-stream/。

核心功能¶

README 与项目文档中列出的能力如下，均可核对：

• 流畅渲染：文字边到边呈现，Markdown 结构持续更新；标题、列表、代码块和表格在流式过程中保持可读状态。
• 丝滑滚动：内容变高时，页面沿连续轨迹平稳跟随，视线贴着正在生成的内容。
• 统一过渡：换行、代码块、表格和工具结果使用一致的过渡方式，正文、思考过程与工具输出衔接自然。
• 自适应节奏：渲染速度随输出速度与待显示内容调整；慢速输出从容呈现，快速输出及时跟上。
• 可配置预设：组合包默认 preset: balanced，可在 realtime、balanced、silky 之间切换手感。
• 用户级设置：Web 界面 设置 → 插件 → 插件配置 中可开关丝滑渲染、控制思考块自动展开，以及打开渲染调试面板。
• 无障碍与降级：支持 prefers-reduced-motion；系统开启减少动态效果时直接显示完整文本；帧率低于 30 fps 且回复在屏外时，揭示自动暂停、恢复后再补上。

安装与启用¶

插件通过 Harness 内置命令安装，npm 包带预构建的 lib/，无需额外构建授权。在 DeepSeek Harness 源码仓库里执行：

pnpm dsh plugin --profile web add dsh-smooth-stream

若 PATH 上已有 dsh 命令，也可直接：

dsh plugin --profile web add dsh-smooth-stream

安装后启动 Web 界面：

pnpm dsh web

Host 日志里应出现 [dsh-smooth-stream] plugin loaded!，表示插件已加载。

卸载：

pnpm dsh plugin --profile web remove dsh-smooth-stream

（或对应地使用 dsh plugin --profile web remove dsh-smooth-stream。）

典型用法¶

调整渲染预设¶

组合包默认 preset: balanced。若要换节拍，在 profile 的 cordis.patch.yml 里修改：

旧版字段 mode、revealCharsPerSec、scrollSpeedPxPerSec、maxScrollSpeedPxPerSec 仍可被加载以兼容已有 profile；当前自适应引擎仅通过 preset 调整节拍。

Web 界面用户设置¶

打开 设置 → 插件 → 插件配置，找到 丝滑流式（Smooth stream） 卡片：

1. 启用丝滑流式渲染（默认开启）：由本插件接管回复和工具行的渲染与跟随；关闭后恢复 Harness 内置渲染。
2. 自动展开思考：控制思考块在流式期间是否自动展开；主开关关闭时此选项不生效。
3. 显示渲染调试面板（默认关闭）：在聊天页右侧显示实时渲染、帧率和滚动跟随数据，可调流式揭示与滚动弹簧参数。

上述设置为用户级持久化偏好，改完即生效，无需重启。调试面板支持实时调参、保存组合、恢复默认，关闭调试开关后引擎立即恢复正式默认参数。

更新插件¶

Web 界面卡片会显示 Host 当前加载的版本；仅当 profile 明确把 dsh-smooth-stream 声明为 npm 依赖时，更新按钮才会执行包更新并提示重启。命令行也可：

dsh plugin --profile web update dsh-smooth-stream

查看是否有新版本：

dsh plugin --profile web outdated

适用场景与注意¶

适合谁

• 日常通过 dsh Web UI 阅读长回复、Markdown、代码块和工具结果，希望流式过程更连贯的开发者。
• 需要在 Harness 对话界面里调试思考块、工具输出呈现效果的智能体开发者。

使用前注意

• 这是社区独立维护的客户端插件，不是 DeepSeek 官方插件；安装前建议查看 GitHub 仓库 源码与 MIT 许可证。
• 插件随当前 dsh 进程在客户端侧运行，安装与配置会写入你的 Harness profile 与用户设置；link: 或 file: 本地开发安装会显示为开发版本，更新按钮保持禁用。
• Node 引擎要求为 ^22.19.0 || >=24.0.0（见 package.json）。
• DeepSeek Harness 生态遵循「一切皆插件」；社区目录 SkillHub 为独立站点，与 DeepSeek / 幻方无官方从属关系。

结尾¶

若默认 Web UI 的流式跳动和滚动顿挫影响你的阅读，dsh-smooth-stream 提供了一条可落地的改进路径：一条安装命令、可选预设与用户级开关，即可在 Harness Web 界面里获得更连贯的流式体验。

• 目录页：https://www.skillhub.cn/plugins/Laplace-bit/dsh-smooth-stream
• GitHub：https://github.com/Laplace-bit/dsh-smooth-stream
• 项目主页：https://laplace-bit.github.io/dsh-smooth-stream/