dsh-streamfold

dsh-streamfold · 流式折叠

一个更好的会话窗口：运行时自动展开最新的思考小窗，旧小窗自动折叠，跑完自动将思考过程与工具调用折起，并且可以保留穿插的正文不折叠，全程水流般的动效。

为什么有这个项目：官方「紧凑」在会话还有未加载历史时会折叠失效；本插件的折叠按自己的规则走，不受历史是否加载完影响。

• 顺便「视奸」dsh 现在在想什么。 运行中自动展开最新的思考小窗——它此刻在想什么你看得见，界面又保持整洁。
• 动效。 我们要的是一个看着就很舒服的界面：小窗高度、折叠与滚动跟随都按帧推进，水流一样，不跳不顿。
• 小窗火花。 运行中思考小窗底部往上冒火星——像滚筒碾过金属：小窗滚得越快溅得越密，停住就不磨了；底边左右两端更密，火星朝窗口内迸。颜色与密度可调，关掉即完全不运行。
• 正文锻打。 正文流式输出时，每写一段就从写头（最后一行末尾）向四周飘出一扇火星，像溅出来的一小团火。写了才有，停笔就不发，火星烧完自动收手。颜色、密度、速度、寿命都可调。

它轻在哪

• 不另开视图。 直接在官方对话流上做 DOM 增强（靠语义属性定位行），不自己实现会话壳、不接管渲染管线、不依赖内部渲染器契约——升级面小。
• 零依赖、零构建。 手写 lib/，没有构建步骤与运行时依赖；宿主半区只做一件事：把设置写进 ~/.dsh/streamfold.json。
• 不碰官方源码，卸载即净。

安装

# 两种等价写法
dsh plugin --profile web add github:rezon-aki/dsh-streamfold
dsh plugin --profile web add https://github.com/rezon-aki/dsh-streamfold

装完重启 profile，然后刷新浏览器页面（客户端代码在页面加载时注入）。

要求 DSH >= 0.1.5-rc.2（依赖该版本的对话流 DOM 契约）。

卸载：

dsh plugin --profile web remove dsh-streamfold

重启 profile 即恢复官方行为。

用法

设置 → 通用设置 → 对话显示 → 选「折叠」（第三项，取代官方那一行）：

专属设置页：设置 → 流式折叠（下面所有开关都在这里，改动即时生效）。

运行中只会自动展开最新那一个思考窗；你自己点开的窗不会被自动收起，被取代的旧窗按「旧窗折叠宽限」（默认 2 秒）折回一行摘要；上滚即停跟，离底时出现「↓ 回到底部」。

设置

设置同时存在浏览器 localStorage 与宿主文件 ~/.dsh/streamfold.json（路由 /streamfold/api/settings），远程 Web UI 也能写。

诊断

浏览器控制台：

__dshStreamfold.stats()          // 窗口 / 折叠 / 折叠条计数（含动效状态）
__dshStreamfold.probe()          // 行状态、还看得见的思考行、小窗动画、回底按钮状态、火星开销（probe().sparks）
__dshStreamfold.state()          // 当前设置 + 官方「对话显示」取值快照
__dshStreamfold.set({ smoothGrow: 0.1, supersedeDelay: 3 })

报问题时附上 probe() 的输出与 DSH 版本，定位会快很多。

安全边界

• 纯客户端展示增强：只读对话 DOM，不发网络请求、不接触凭据、不改官方源码。
• 宿主半区只提供设置持久化：写 ~/.dsh/streamfold.json，暴露同源路由 /streamfold/api/settings（跨站请求返回 403）。
• 卸载即净：设置行、小窗标记与注入的样式全部撤掉。

开发

• 手写、无构建：lib/client.js（浏览器半区，包在 window.__ModuleLoader__ 里）、lib/index.js（宿主半区）。
• 改完 lib/*.js 重载插件并刷新页面。
• 行锚点全部用官方语义属性：[data-chat-flow]、[data-chat-flow-kind]、[data-chat-turn]、[data-disclosure-row][aria-expanded]、[data-variant=think]、[data-tool]、[data-sample=bash]、[class*=_thinkBody]、[class*=_bodyWrap]、[data-context-injection-body]——不用 CSS module 哈希。
• 已在 DSH 0.1.5-rc.2 验证。

License

MIT