dsh-plugin-smooth-stream

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

dsh-plugin-smooth-stream

简体中文 | [English](README.en.md)







把逐字抖动的流式输出，换成按段落分批、淡入呈现的阅读体验。流式期间平滑跟随滚动，思考块显示实时单行摘要。

左：DSH 原生渲染 · 右：Smooth Stream —— 同一个问题，同时开始：

安装

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

打开任意会话即可生效。设置入口：设置面板 → Smooth Stream。

它改变了什么

• 按段落呈现 — 回复不再一个字一个字地蹦，而是攒满一段，整段淡入。断句时自动避开没写完的代码块和表格，Markdown 不会渲染到一半。
• 平滑滚动 — 流式输出时页面匀速滑向底部，长回复也不会猛地一跳；往上滚就交还给你，滚回底部自动继续跟随。
• 思考摘要 — 模型思考时，折叠行里实时滚动最新一句，两端渐隐过渡；回合结束时下划线缓缓收起，示意"想完了"。
• Markdown 与公式 — 正文走 DSH 自带的渲染器：代码高亮、复制按钮、表格、KaTeX 公式都和原生一模一样。

设置

设置面板中的 Smooth Stream 分区，改动即时生效并持久保存：

设置项 · 默认 · 说明

启用 Smooth Stream · 开 · 关闭后即时恢复 DSH 内置渲染，方便对比

入场动画 · 淡入 · 淡入 / 上升 / 浮现 / 拂过 / 聚焦 / 映亮 / 晕开 / 洇染

动画时长 · 520 ms · 入场动画时长（120–1200 ms）

分批大小 · 500 字符 · 攒多少文字呈现一批；越小越"实时"，越大越安静

平滑滚动跟随 · 开 · 流式期间的平滑滚动跟随

带实时预览，可一键恢复默认。设置界面跟随 DSH 的显示语言。

动画风格

八种入场动画，默认节奏各自按风格调校；下面全部用同一段回复录制，便于直接对比。

淡入 Fade · 上升 Rise

!fade · !rise

浮现 Dissolve · 拂过 Wipe

!dissolve · !wipe

聚焦 Focus · 映亮 Glow

!focus · !glow

晕开 Iris · 洇染 Soak

!iris · !soak

兼容性

版本 1.6.0：适配官方 dsh 0.2.2-rc.1（同时保留 0.2.0-rc.2、0.2.1-rc.2 与 0.2.1-rc.5 兼容）。在宿主助手节点入口绑定 chatFileMentions.forClosing 以保留回合末尾可操作的文件链接渲染；补全原生 Quote（引用）与右键上下文菜单交互：在已完成的助手回复及展开的思考块中保留文本交互标识，支持选中文字直接引用至输入框；文件链接右键菜单完整传递延迟路径解析与会话上下文。

版本 1.5.0：适配官方 dsh 0.2.1-rc.5（同时保留 0.2.0-rc.2 与 0.2.1-rc.2 支持）。在思考摘要与历史视图中适配官方 rc.5 的思考签名格式：去除前导签名信封与尾部换行、流式期间隐藏未完成的信封前缀，并跳过纯签名块的显示，同时保持宿主底层消息块数据完整；修复 prefers-reduced-motion（减少动态效果）的 CSS 优先级覆盖，确保动画关闭与即时滚动在全部入场动画风格中均稳定生效。

版本 1.4.0：适配官方 dsh 0.2.1-rc.2（同时保留 0.2.0-rc.2 支持）。按宿主 groupPart（reasoning / response）分席过滤助手消息块、中断标记与降级纯文本，避免思考块与正文重复显示；助手消息图片在 0.2.1-rc.2 下回退为普通 <img> 显示（无原生画廊/灯箱）。

版本 1.3.0：可在官方 dsh 0.2.0-rc.2 上加载。渲染仍注册在 conversation.chat.node 与 settings.section。

版本 1.2.0：更新客户端渲染服务依赖与已验证的 DSH 版本范围；现有渲染行为通过新版宿主验证。

声明兼容范围为 >=0.2.0-rc.2 <0.3.0-0 || 0.2.1-rc.2 || 0.2.1-rc.5 || 0.2.2-rc.1；官方 dsh 0.2.0-rc.2、0.2.1-rc.2、0.2.1-rc.5 与 0.2.2-rc.1 满足该范围。旧版 DSH 请保留上一插件版本。[验证记录](.github/reviews/dsh-0.2.2-rc.1.md)。

可从 GitHub Release 下载发布包，然后执行 dsh plugin --profile desktop add ./dsh-plugin-smooth-stream-1.6.0.tgz。

本次兼容目标为 DSH 0.2.2-rc.1。运行 npm ci、npm test 和 npm run check:package 可验证构建及发布包。更新后请重启 DSH。

• 使用宿主的客户端服务、Markdown 和图片接口；自动化测试覆盖加载与组件渲染。
• 本插件接管对话视图的 assistant 消息渲染（conversation.chat.node 的 assistant-step 槽位），与其他同样接管该渲染的插件互斥——同装时只有一个生效。
• 遵循 prefers-reduced-motion：系统开启减少动态效果时，所有动画与平滑滚动自动关闭。
• 渲染出错时自动降级为纯文本显示，不影响会话其余部分。

License

[MIT](LICENSE)