dsh-streamfold · 流式折叠
一个更好的会话窗口：运行时自动展开最新的思考小窗，旧小窗自动折叠，跑完自动将思考过程与工具调用折起，并且可以保留穿插的正文不折叠，全程水流般的动效。
为什么有这个项目：官方「紧凑」在会话还有未加载历史时会折叠失效；本插件的折叠按自己的规则走，不受历史是否加载完影响。
- 顺便「视奸」dsh 现在在想什么。 运行中自动展开最新的思考小窗——它此刻在想什么你看得见，界面又保持整洁。
- 动效。 我们要的是一个看着就很舒服的界面：小窗高度、折叠与滚动跟随都按帧推进，水流一样，不跳不顿。右下角那颗「回到底部」外观仍是官方的，但何时出现由本插件决定——跟随中的正常落后不会再让它一闪一闪，点它是平滑滑回底部。
- 小窗火花。 运行中思考小窗底部往上冒火星——像滚筒碾过金属：小窗滚得越快，火星越亮也越密（亮度跟着滚动速度走，慢输出暗、快输出烫），停住就不磨了；底边左右两端更密，火星朝窗口内迸。颜色与密度可调，关掉即完全不运行。
- 正文锻打。 正文流式输出时，每写一段就从写头（最后一行末尾）向四周飘出一扇火星，像溅出来的一小团火。写了才有，停笔就不发，火星烧完自动收手。颜色、密度、速度、寿命都可调。
- 跑完回到提问处。 一轮结束，视图平滑滑回你这轮那句话的位置——不用自己往上翻找回"我当初问的是什么"（你已经自己上滚过就不动你；可关，默认开）。
- 置顶显示提问。 读到哪一轮，那一轮的提问就钉在会话顶端（一行，超出省略）；它自己在屏幕上时自动让位，点它一下平滑滑回那句发言（可关，默认开）。
它轻在哪
- 不另开视图。 直接在官方对话流上做 DOM 增强（靠语义属性定位行），不自己实现会话壳、不接管渲染管线、不依赖内部渲染器契约——升级面小。
- 零依赖、零构建。 手写
lib/，没有构建步骤、没有运行时依赖，也不读写任何文件：宿主半区只是一个占位条目（客户端清单据它把浏览器半区交给页面），设置存在浏览器 localStorage。
- 不碰官方源码，卸载即净。
安装
# 两种等价写法
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.7-alpha.1（官方「对话显示」档位改由 configForms 服务托管；0.1.5 及更早请用 0.4.x）。
0.4 → 0.5 的变化：设置不再写宿主文件（~/.dsh/streamfold.json 与 /streamfold/api/settings 路由已移除），改为只存浏览器 localStorage——你在页面上已经调好的值不受影响；0.1.7 把「对话显示」换成四档（简洁/标准/详细/完全展开），本插件把「折叠」作为第五项接在官方下拉里，选它时官方自动停在「完全展开」，两层折叠不会打架。
卸载：
dsh plugin --profile web remove dsh-streamfold
重启 profile 即恢复官方行为。
用法
设置 → 通用设置 → 工作步骤展示：官方那四档原样保留（简洁 / 标准 / 详细 / 完全展开），末尾多一项「折叠」——本插件接管的那一档：
| 选项 | 行为 |
|---|
| 简洁 / 标准 / 详细 / 完全展开 | 官方原本的四档，文案与行为都跟官方一致 |
| 折叠 | 本插件：运行中的一轮只留一个窗，其余过程收成一行 |
选「折叠」时，官方那一档会被自动停在 完全展开（等价于 0.1.5 时代的「标准」语义）——官方自己不折、不分组，折叠只由本插件做，避免两层折叠打架；档位名与官方设置页同源（取自官方词典），官方改了文案这边跟着变。
专属设置页：设置 → 流式折叠（下面所有开关都在这里，改动即时生效）。
运行中只会自动展开最新那一个思考窗；你自己点开的窗不会被自动收起，被取代的旧窗按「旧窗折叠宽限」（默认 2 秒）折回一行摘要；上滚即停跟，离底时出现回底按钮（箭头图标；小窗与主窗口是同一个按钮）。
设置
| 设置项 | 默认 | 说明 |
|---|
| 折叠历史轮次 | 开 | 关掉后：加载页面不再自动折叠历史轮次（只在跑动时折前面的） |
| 保留穿插正文 | 关 | 折叠时保留带正文的行，并给它套一个限高小窗（正式回答本身不套窗） |
| 窗口高度 | 260 | 单个思考/穿插正文小窗的最大高度（px） |
| 运行中自动展开思考 | 开 | 只自动展开本轮最新的那一个；被取代的旧窗按「旧窗折叠宽限」折回一行摘要 |
| 旧窗折叠宽限 | 2 秒 | 新的思考窗出现后，旧窗再等多久才自动折回（0~60，支持小数） |
| 运行中自动展开工具 | 关 | 开：运行中最新的工具卡自动展开（用官方卡片自己的折叠/内滚，不套限高小窗） |
| 触底自动跟随 | 开 | 内容增长时自动贴底；你上滚即停跟 |
| 平滑系数 | 0.15 | 跟随时每帧吃掉多少差距，越小越柔（0.05~0.9） |
| 平滑最小步长 | 1 | 每 16ms 至少推进多少像素（与屏幕刷新率无关） |
| 离底显示「回到底部」 | 开 | 离开底部时出现回底按钮（跟随中的轻微落后不显示，避免闪烁） |
| 跑完回到提问处 | 开 | 一轮结束后平滑移到本轮你那句话的位置；你已经自己上滚过就不动你（动效关掉时直接到位） |
| 置顶显示提问 | 开 | 把「你正在看的那一轮」的提问钉在会话顶端：往上滚会跟着换成那一轮，超过一行只显示一行；它自己在视口里时自动让位，点它滑回那句话 |
| 动效过渡 | 开 | 关掉则折叠/展开/回底全部瞬时 |
| 小窗火花 | 开 | 运行中思考小窗底部的火星（独立模块：关掉后不建画布、不排帧） |
| 火花颜色 | #4fa8ff | 火星颜色；核心自动提亮成白热 |
| 火花密度 | 1 | 火星数量倍率（0.2~3），越高越密、绘制开销越大（两种火花共用） |
| 正文锻打火花 | 开 | 正文流式写头砸出的火星；写头不动就不砸，跑完自动收手 |
设置存在浏览器 localStorage（按 DSH 页面源站隔离）。
诊断
浏览器控制台：
__dshStreamfold.stats() // 窗口 / 折叠 / 折叠条计数（含动效状态）
__dshStreamfold.probe() // 行状态、还看得见的思考行、小窗动画、回底按钮状态、火星开销（probe().sparks）
__dshStreamfold.state() // 当前设置 + 官方「对话显示」取值快照
__dshStreamfold.set({ smoothGrow: 0.1, supersedeDelay: 3 })
报问题时附上 probe() 的输出与 DSH 版本，定位会快很多。
安全边界
- 纯客户端展示增强：只读对话 DOM，不发网络请求、不接触凭据、不改官方源码。
- 宿主半区不读写文件、不注册路由：设置只落浏览器 localStorage；对官方「对话显示」档位的读写走 DSH 自己的设置服务（
configForms）。
- 卸载即净：设置行、小窗标记与注入的样式全部撤掉。
开发
- 手写、无构建：
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.7-rc.1 验证。
License
MIT
