dsh-plugin-smooth-stream
UI & ExperienceSpookySandwich/dsh-plugin-smooth-stream
Streaming rendering plugin for DeepSeek Harness: paragraph-batched reveals, 8 entrance animations, smooth scroll-follow, and a settings panel.
- ai-chat
- animation
- chat-ui
- cordis-plugin
- deepseek
- deepseek-harness
- dsh
- dsh-plugin
- llm
- markdown
- react
- smooth-scrolling
- streaming
- streaming-text
- text-animation
- typewriter-effect
- ux
- web-ui
Verification and compatibility
This section shows evidence collected by the catalog. Undeclared information is labeled as unknown.
- Current-version compatibility
- Verified on the catalog Harness version
- Declared Harness range
- Not declared
- Declared platforms
- Not declared
- Profiles
- web
- Build approval
- Unknown
- Permissions
- Not declared
- External services
- Not declared
- Telemetry
- Unknown
This is not a security endorsement. Review source, permissions, and configuration before installing.
View evidence and scope
Verification covers only the named source, version, and Harness environment. It does not guarantee future compatibility.
dsh-plugin-smooth-stream@1.1.1- The manifest and static structure passed checks; a runtime load check has not completed.
README
dsh-plugin-smooth-stream
简体中文 | English
把逐字抖动的流式输出，换成按段落分批、淡入呈现的阅读体验。流式期间平滑跟随滚动，思考块显示实时单行摘要。
左：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 |
|---|---|
 |  |
| 浮现 Dissolve | 拂过 Wipe |
 |  |
| 聚焦 Focus | 映亮 Glow |
 |  |
| 晕开 Iris | 洇染 Soak |
 |  |
兼容性
版本 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；官方 dsh 0.2.0-rc.2 满足该范围。旧版 DSH 请保留上一插件版本。验证记录。
可从 GitHub Release 下载发布包，然后执行 dsh plugin --profile desktop add ./dsh-plugin-smooth-stream-1.3.0.tgz。
本次兼容目标为 DSH 0.2.0-rc.2。运行 npm ci、npm test 和 npm run check:package 可验证构建及发布包。更新后请重启 DSH。
- 使用宿主的客户端服务、Markdown 和图片接口；自动化测试覆盖加载与组件渲染。
- 本插件接管对话视图的 assistant 消息渲染（
conversation.chat.node的assistant-step槽位），与其他同样接管该渲染的插件互斥——同装时只有一个生效。 - 遵循
prefers-reduced-motion：系统开启减少动态效果时，所有动画与平滑滚动自动关闭。 - 渲染出错时自动降级为纯文本显示，不影响会话其余部分。
