dsh-smooth-stream

dsh-smooth-stream 让 AI 的长篇生成如提词器般温润流淌。 为 DeepSeek Harness（dsh）打造的物理流式渲染与合成层补偿跟随引擎。

English · 项目主页 · 工作原理与基准 · npm 极致丝滑的阅读手感

无论是阅读数百行的长篇推演，还是紧盯高速吐字的代码生成，dsh-smooth-stream 带来的是一种沉浸、连贯且零视觉负担的阅读质感： 如水流般自然铺展：告别大段文本突然“砸”在屏幕上的视觉压迫，字句如打字机般富有呼吸感地逐字涌现； 视线无需追赶跳动：视口如同搭载了高精度阻尼滑轨，随文字增长平稳匀速推移，彻底终结换行时的突发踢移； 呼吸感与实时性的平衡：慢速输出时从容优雅，高并发爆发时平稳追赶，无论模型吐字多快，画面始终从容自若。 为什么需要它？

大模型输出是通过网络分块到达的。一个数据包可能在几毫秒内送达数百字符，下一个分块却需要数十毫秒。

如果直接将 DOM 渲染和视口滚动绑定在离散的到达事件上，通常会引发两个阅读体验问题： 1. 视觉跳跃与撕裂：段落、代码块和表格整段突发呈现，视线被迫频繁重新寻焦； 2. 滚动抖动与重排风暴：依靠 scrollTop = scrollHeight 进行瞬时硬跳；即使用 CSS scroll-behavior: smooth，高频写入也会不断重置缓动曲线，导致动画永远无法收敛，高速流下伴随剧烈的主线程重排。

dsh-smooth-stream 将内容呈现与视口运动拆分为两个独立的物理状态机，在每一帧动画回调（rAF）中连续积分，彻底消除跳跃感。 核心机理与架构

1. 动态自适应的揭示引擎（Reveal Engine） 分数级字符积分：根据积压队列深度自适应调节速度（$v = 90 + \text{backlog}^{1.25} \times P$），低负载时从容自然，高积压时平稳追赶，绝不倾泻整段文本。 折行平滑：正文预测跟随使用速度、加速度受限的连续轨迹吸收折行；其他高度增长由弹簧跟随。8px 是约 60Hz 下变换衰减的常规预算，并非所有场景的单帧位移上限；补偿真实高度变化时可超过此值。 尾部平稳收束：回合结束标记到达后，残余缓冲区以恒定速率释放，正文、思考链与工具调用之间自然衔接。 2. 合成层补偿的跟随引擎（Follow Engine） 二阶阻尼物理系统：采用 $k=130, c=24, m=1$ 的亚步进物理弹簧，将内容高度的变化转化为平滑连续的速度与位移轨迹。 变换位移补偿：接管滚动时，真实滚动容器锚定在底部，安全范围内的视觉滞后由外层 DOM 的 transform: translate3d 吸收。引擎仍需读取高度和矩形，并调整临时边距、填充及滚动位置，因此不保证零重排；关闭接管后由内核负责贴底。 闭环背压控制（Closed-Loop Backpressure）：当跟随滞后接近预留空间时，反向向揭示引擎施加阻尼（最低降至 0.55 倍速），防止文本增长超出视口弹簧范围。 掉帧自愈与跨刷新率一致：主线程卡顿（Stall）时自动钳位物理时间（$\le 32\text{ms}$），避免画面恢复后的突进瞬移；在 60Hz 与 120Hz（ProMotion）屏幕下拥有近乎一致的物理收敛时间。 3. 按阶段配置折叠（Turn Fold Policy） 思考块可分别配置生成中、结束后的开合状态及展开高度。 整个回合结束后的开合默认跟随内核，也可选择保持展开或收起；适用条件见下方「用户偏好设置」。 效果对比

左：默认 Web UI。右：dsh-smooth-stream。 性能与基准

平滑度与稳定性基于本地自动化审计台架验证： Host ESM 与浏览器 bundle 分别构建，当前体积以 pnpm build 输出为准。机制说明见工作原理与基准。 安装与使用

在 DeepSeek Harness 源码根目录运行：

如果系统 PATH 中已有 dsh：

启动界面：