DSH Web UI 里，大模型的长篇输出本来是按网络分块「砸」到屏幕上的：一个数据包可能几毫秒送来数百字符，下一个分块却要等数十毫秒。dsh-smooth-stream 把这套离散的到达事件换成了两个每帧连续积分的物理状态机——揭示节奏引擎逐帧喂字，弹簧跟随引擎把视口推平，作者的概括是「让 AI 的长篇生成如提词器般温润流淌」。
这篇只讲怎么装、怎么确认它真的在跑。当前 npm 包为dsh-smooth-stream @ 0.6.1，MIT 许可，Star 74、周下载量 1,233，本站实装验证器已于 2026/9/28 真实安装成功（L4）；但它的用户评分是「—」，0 人投票，所以每一步我都尽量给出你能自己复现的判据。
它改的是渲染与滚动，不是模型能力
先划边界：这是dsh 原生插件 · ui，属于 DSH Web UI 插件，只管流式渲染与滚动，不碰模型、提示词和工具调用逻辑。
它针对两个真实问题：视觉跳跃与撕裂——段落、代码块、表格整段突发呈现，视线被迫反复重新寻焦；滚动抖动与重排风暴——靠scrollTop = scrollHeight瞬时硬跳，即便改用CSS scroll-behavior: smooth，高频写入也会不断重置缓动曲线，动画永远无法收敛。
解法是两个独立引擎：揭示引擎按积压深度自适应调速（v = 90 + backlog^1.25 × P），换行时把单帧位移限制在 8px 内，将 24~28px 的跳跃摊到数帧；跟随引擎用k=130, c=24, m=1的二阶阻尼弹簧做零重排位移补偿，滚动容器锚定底部，剩余滞后交给外层transform: translate3d吸收，期间不读写任何触发 Layout 的属性（Gzip 后核心产物约 4.7 kB）。
想先横向比一比同类 UI 插件值不值得装，可参考这份 完整插件清单与汉化避坑指南，它按分类和信任档位做了梳理。确认要装，再往下走。
前置一：Node 版本必须落在 ^22.19.0 || >=24.0.0
package.json 的 engines 声明很死：^22.19.0 || >=24.0.0。低于 22.19 会在安装阶段卡在 engines 校验上。
落在 22.19 以下就用 nvm 或 fnm 切一个 LTS，基线 Node 22.19 本身即满足，这一步没有绕过的必要。
前置二：先有 dsh CLI 引擎，插件命令才存在
插件是 dsh 的扩展，自身不提供可执行入口。机器上从没装过引擎时，直接敲插件命令只会得到command not found: dsh。
另外注意，详情页并未声明 dsh 版本约束，引擎装哪个版本要自己心里有数——后文兼容表会让你看到为什么这件事重要。
安装、启动，以及必须盯住的那行日志
在 DeepSeek Harness 源码根目录：
PATH 里已有全局dsh时可省掉前缀：
两条命令等价，区别只是从哪个入口调引擎。启动界面：
启动后别只看界面出没出来，去 Host 日志里找这一行：
出现它才叫加载成功。界面打开了却没有这行，说明插件根本没被加载进去——请对照「实战避坑」的排查路径，而不是反复重装。想确认它在社区里的维护状态与安全扫描结论，这份 完整插件清单与汉化避坑指南 里每个插件都附了实装验证等级与风险提示。
装完该动哪几个开关
设置 → 插件 → 插件配置里的「丝滑流式（Smooth stream）」卡片共五项：启用丝滑流式渲染（默认开启，关掉即恢复内置渲染）、自动展开思考、对数淡入（默认开启，尾部从 24 扩展到最多 160 个字素，240ms 内按反向对数曲线变实，并遵循动效偏好、跳过代码与公式）、完成后自动折叠（默认开启）、显示渲染调试面板（默认关闭，界面右侧实时 HUD）。
手感预设默认preset: balanced，它不在设置页里，而在对应 profile 的cordis.patch.yml：realtime紧跟分块到达节奏、缓冲更小；balanced兼顾流畅度与延迟，是推荐值；silky增大缓冲区、追赶更平缓柔和。另外，本站对这类插件有风险提示——它可能需要额外运行时依赖，建议先读 README 前置要求，装完确认服务能正常启动。
本地复现预览：必须走 HTTP 服务
在仓库根目录：
再打开http://127.0.0.1:8765/repro/index.html?demo=fade。该页含暂停、停止、深浅主题、高速分片和代码/公式保护样例，复用真实输出引擎。直接双击repro/index.html用 file:// 打开会白屏或 404，且pnpm build:repro必须在起服务之前跑完。
验证对数淡入：Chrome 与 ffmpeg 两个前提
脚本会验证并录制预览，前提是机器上有 Chrome 且装过 ffmpeg：
Chrome 不在默认路径时用CHROME_BIN指定，产物落在未跟踪的repro/artifacts/logarithmic-fade/。另外，对数淡入在部分浏览器上「开了没效果」不算故障——它依赖文字范围着色能力，不支持的浏览器会自动沿用原有输出效果，且不报错。
卸载与内核兼容速查
卸载后再看 Host 日志，plugin loaded!应消失，界面回到内置渲染。兼容性上：0.1.0-rc.5 ～ 0.1.0-rc.7 与 0.1.1-rc.2 为全部版本可用；0.1.2-alpha.1 ～ 0.1.2-alpha.3 自 0.4.3 起可用（0.4.2 及更早会在 0.1.2 上加载失败）。若你正跑在 0.1.2-alpha.x，请务必装 0.4.3 及以后。
总结
整条流程其实只有四步：装引擎、加插件、启动看日志、按需调设置，真正容易绊住人的是 Node 版本、dsh命令不存在、以及「装了但没生效」这三类环境问题。想一次看懂它值不值得留在工作流里，可以先翻一遍 完整插件清单与汉化避坑指南 再决定。
适合与不适合
适合：长时间盯着 AI 生成长文的深度使用者；经常读大段代码输出、被换行踢移打断思路的开发者；在意滚动抖动与主线程重排、想要零重排跟随的前端同学；喜欢逐字打字机质感、愿意花两分钟调设置的人。
不适合：只用 TUI 或桌面客户端、不开 DSH Web UI 的用户（这是 DSH Web UI 插件，对它无效）；Node 长期停在 22.19 以下又不方便升级的机器；只看重社区口碑、需要真实用户评价才敢动手的人——该插件评分为 0，没有任何投票可参考。
标签：dsh-smooth-stream、DeepSeek Harness、插件安装教程、流式渲染、DSH Web UI
本文由 DeepSeek Harness Hub 自动整理，数据来源于插件详情页。
