メインコンテンツへスキップ
S

dsh-plugin-smooth-stream

spookysandwich/dsh-plugin-smooth-stream

DeepSeek Harness 向けの、より滑らかなストリーミングテキストアニメーション。

インストール

dsh plugin --profile web add github:spookysandwich/dsh-plugin-smooth-stream

README

dsh-plugin-smooth-stream

简体中文 | English

npm CI license dsh deepseek1024 stars

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

左: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
faderise
浮现 Dissolve拂过 Wipe
dissolvewipe
聚焦 Focus映亮 Glow
focusglow
晕开 Iris洇染 Soak
irissoak

兼容性

待发布:显式支持官方 dsh 0.2.2-rc.4,保留已有兼容范围,渲染代码无需变更。已在 rc.4 Web 宿主上通过本地模拟服务、使用宿主的 DeepSeek 适配器验证流式输出后的拒绝:部分正文与思考会被清除,轮询、动画与滚动跟随停止;重载、重新连接与重启后均不会重新显示被拒绝的内容,后续回复仍正常流式呈现。

版本 1.6.2:适配官方 dsh 0.2.2-rc.3(同时保留 0.2.0-rc.2、0.2.1-rc.2、0.2.1-rc.5 与 0.2.2-rc.1 兼容)。验证导入会话历史(含思考过程、网页结果、图片、缺失字节的附件卡片与错误中断回合)在首次打开与继续对话时的渲染与滚动跟随表现。

版本 1.6.1:恢复 Smooth Stream 接管助手消息节点时的 conversation.chat.reasoning.body 与 conversation.chat.message.images 宿主子插槽,恢复思考过程翻译工具栏与原生图片画廊;首行摘要完成前即可展开思考。

版本 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 || 0.2.2-rc.3 || 0.2.2-rc.4;官方 dsh 0.2.0-rc.2、0.2.1-rc.2、0.2.1-rc.5、0.2.2-rc.1、0.2.2-rc.3 与 0.2.2-rc.4 满足该范围。旧版 DSH 请保留上一插件版本。验证记录。

可从 GitHub 最新 Release 下载 .tgz 发布包,然后执行 dsh plugin --profile desktop add <下载的发布包路径.tgz>(将占位符替换为实际路径)。

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

  • 使用宿主的客户端服务、Markdown 和图片接口;自动化测试覆盖加载与组件渲染。
  • 展开的思考正文与图片组通过宿主子插槽渲染,保留思考翻译控件及原生图片画廊。思考正文由插槽提供者控制,因此 Smooth Stream 的正文分批淡入仅保留在旧宿主的降级渲染中。首行摘要完成前即可展开思考;摘要文本尚未就绪时,行内仅显示标题与图标。摘要滚动、淡入及结束下划线仍然保留。
  • 本插件接管对话视图的 assistant 消息渲染(conversation.chat.node 的 assistant-step 槽位),与其他同样接管该渲染的插件互斥——同装时只有一个生效。
  • 遵循 prefers-reduced-motion:系统开启减少动态效果时,所有动画与平滑滚动自动关闭。
  • 渲染出错时自动降级为纯文本显示,不影响会话其余部分。

License

MIT

関連プラグイン