轮次折叠增强 UNscientific-9/dsh-turnfold

dsh-turnfold

License: MIT DSH Release TypeScript

DSH Web 0.1.5 内置官方轮次折叠条的增强插件——以相同的外观与行为接管官方 turn-process 渲染，纯前端叠加五项官方没有的增强

效果展示

43 次工具调用 · 15 条消息 为官方计数，灰色「· 用时 30分49秒」为本插件注入；点击开合，刷新后自动恢复之前的展开状态。

五项增强

| 增强 | 说明 |
| 用时 + 思考段数 | 折叠条追加 · 用时 X · M 段思考（tertiary 色弱化显示），数据来自插件自有的轮次状态机 |
| 展开决策持久化 | 官方折叠条的展开状态是内存态（刷新即失）；插件把你的展开选择写 localStorage，刷新/重开后恢复 |
| completed 白名单（可选，默认关） | 官方对轮次终结一律折叠（不区分原因）；开启后中断/报错/超限的轮保持展开且不渲染折叠条 |
| 自动加载更早历史 | 滚动到会话顶部附近时自动调用官方 loadOlder()，长会话历史边加载边折叠 |
| 独立折叠条 | 官方判定「无定稿回答」时（中断、报错，停在工具调用上的轮）根本不渲染折叠条、整轮平铺；插件为这类已关闭的轮次补一条自有条——默认展开、可收起、决策同样持久化 |

纯前端插件：不改 DSH 后端、不改会话存储，卸载后服务端零残留。
锁定 DSH 0.1.5-rc.2（官方 turn-process 折叠、keyed slot conversation.chat.node、useTurnData 注入面）。

工作方式

flowchart TB
OFF["官方 ui-chat 折叠条（turn-process）"]
FOLD["FoldBarView本插件 shadow renderer"]
DEF["turn-activity definition每轮状态机"]
OFF -->|"shadow 接管渲染"| FOLD
FOLD -->|"官方计数段 ＋ 增强段useTurnData('turn-activity')"| DEF
DEF -.->|"turn/end 发布"| DATA["{ durationMs, thinkingSteps,reasonKind }"]

接管方式：ctx.slots.register({ key: 'turn-process', priority: -1 })，同 key 注册中 lowest priority 优先生效。展开走 CSS 高度过渡（不测量，靠 interpolate-size），收起走 Web Animations API 高度过渡并把官方伴生几何纳入同一批——两者动画中都可反向，prefers-reduced-motion 下跳过。官方判定「无定稿回答」而根本不渲染条时，插件为这类已关闭的轮次补上自己的独立折叠条。

安装（4 步）

1. 拿到 UNscientific-9-dsh-turnfold-0.5.0.tgz（见 Releases），放到一个固定目录（路径不要带空格）。
2. 编辑 DSH web profile 的依赖文件 %USERPROFILE%\.dsh\profiles\web\package.json，在 dependencies 里加一行（路径改成实际位置）：

{
"dependencies": {
"@UNscientific-9/dsh-turnfold": "file:D:/path/to/UNscientific-9-dsh-turnfold-0.5.0.tgz"
}
}

3. 在 profile 目录执行 pnpm install，重启 DSH web，浏览器硬刷新（Ctrl+Shift+R）。
4. 浏览器控制台出现 [dsh.turnfold] v0.5.0 loaded，已完成回答前出现官方样式折叠条，计数后带灰色 · 用时 X · M 段思考。

需要 DSH web 0.1.5-rc.2（官方折叠条自 0.1.2 线引入；本版本锁定 0.1.5 宿主 API）。

配置（localStorage）

| Key | 默认 | 作用 |
| dsh.turn-collapse.completedOnly | 未设 | 设为 '1' 后中断/报错/超限的轮不再折叠；删除该键恢复默认（尊重官方） |
| dsh.turn-collapse.autoLoad | '1' | 设为 '0' 关闭"滚动近顶自动加载更早" |

卸载 / 回滚

从 profile 的 package.json 删除 @UNscientific-9/dsh-turnfold 依赖行，执行 pnpm install，重启 DSH web 并硬刷新。插件全部影响都在浏览器侧（三个 localStorage 键 + 一个 标签），移除后刷新即回到纯官方折叠条，服务端无残留。

文档

完整使用指南 · 架构说明 · 手工验证清单

许可

MIT