dsh-fold-it-up
强制的整轮折叠:一轮工作结束(或已经结束过的旧轮次)之后,它的工作过程收成一行,答案照常显示;点这一行即可展开、再点收起。回答结束的那一刻,视图会自动落到这一轮的提问上——长回答不再需要自己往上翻。
装进 DSH 的 Web 界面后,打开任意会话——包括你在这个插件存在之前就聊完的历史会话,以及点「加载更早」取回来的那些页——每一轮都已经折好了。
▸ 10 次工具调用 · 3 条消息
已上传工坊,发布版本 1.0.8。
...
(那一行就是 DSH 自己的折叠行,文案、字体、主题色、间距全部来自产品本身。)
为什么需要它
DSH 自带「轮次过程折叠」,但它只在一整套前置条件同时成立时才折叠。用户能撞上的那一条是长会话:
processWindowReady = 会话是紧凑视图
&& 该轮已有定稿答案
&& 该轮已关闭
&& !historyIncomplete ← 这一条
historyIncomplete 来自会话窗口是否还有更早的历史(界面上的「加载更早」)。DSH 首屏只取 50 条消息(PAGE_MESSAGES),所以只要一次会话超过两三个来回,这个条件就永久为真:该折叠的一轮也不折,历史轮次也不折,界面上看就是「折叠功能时灵时不灵」。
本插件接管了那一格的渲染(conversation.chat.node 的 turn-process),自己判断折叠:
折 ⟺ 该轮已关闭 且 这一轮有过程行
没有历史完整性开关,也没有「模型是否给出了总结」这一层判断。
判定读的是渲染结果,不是 store
这是本插件最要紧的一条设计,也是它修掉的第二个 bug。
Chat store 的快照和屏幕上真实渲染的行会不一致。 点「加载更早」时,React 把新的一页分几批提交进 DOM,于是有一小段时间:DOM 里已经有这些行,而当前 store 快照还没有描述它们。如果折叠范围是按 store 算、再往 DOM 上贴,那么「store 不认识的行」就会被算成不该隐藏,结果是——
实测:某一轮的过程行在一次 pass 之后从 94 行涨到 116 行,那次 pass 只折了 18 行,剩下 102 行留在屏幕上。
所以现在:
- 行集合与顺序来自座位元素本身(
ChatNodeSeat给每个渲染节点写的data-chat-turn/data-chat-flow-kind/data-chat-anchor-key); - 哪些行属于过程范围,用座位自己写的
data-turn-process-member——那是官方投影的产物,不需要重新推导,也不可能和屏幕上的东西矛盾; - 官方标记缺席时(座位因自己的原因拒绝了折叠,例如该轮还在跑),退回读折叠行上发布的
processStartSeq/answerAnchorSeq序列区间; - store 只提供每个 key 的内容(文本块、step),行集合和顺序一概不听它的。
判定和写入在同一次 pass 里完成,每次都是重新读一遍当前的列。
上下文注入行:它们不属于任何一轮
第三个 bug 是用户报的「上下文注入类还留在外面不被折叠」。
注入的上下文(上下文注入 @deepseek-ai/dsh-system-prompt、上下文注入 skill-catalog、graph-memory 的回忆块……)在自己的座位上是没有轮次号的。 它们的 user/message 事件没有 turn 字段,于是 Location 是 unresolved,座位渲染出 data-chat-turn="null"——它们不属于任何分组。所以它们不是被「排除」在折叠之外,而是从来没有进入过任何一次判定。
两个事实叠加才让它一直看得见:
- 官方那份「与过程无关的 kind」清单里没有
context(system-prompt/user/steering/turn-process/turn-error/turn-max-tokens/turn-tail才有)——也就是说官方几何本来就会在范围里隐藏它们; - 但官方给行打过程标记的那一刻,需要
processWindowReady,而那个开关要求!historyIncomplete。长会话里它恒为假,于是这些行连标记都拿不到。
于是本插件的做法是:按座位在 DOM 里的位置,把无轮次的 context 行归给紧跟在它下面的那一轮(也就是它被注入进去的那一轮);尾部没有后续轮次时归给上面那一轮。然后
- 有官方标记时:这些行按成员对待,和同一轮的其它过程行一起折;
- 官方标记缺席时:退回序列区间判定,
context行不以序列号参与,而是以「它被归给了这一轮」参与。
归给哪一轮是可读的:pass 会给每一行写 data-folditup-turn,上下文行的归属就写在它自己的 DOM 上。这也让「这一行到底属于谁」可以被外部断言,而不必重新推导一遍规则。
顺带一个边界:一行只在它位于该轮答案之前时才会被隐藏,所以「上一轮答案之后、下一轮用户消息之前」的注入行跟着上一轮折(它属于上一轮),而不会被算进下一轮。
正在思考的那一轮会把自己折起来
第四个 bug 是用户报的「处于思考时,过程就会被折叠,直到进入到下一步」。
根因是「已定稿答案」这个判据在轮次运行中并不成立。 官方 latestAnswer(turn-process.ts)只接受最后一步的 assistant 节点、且该节点已带 finalNode;但运行中「最后一步」正是正在流式输出的那一步,它还没定稿,于是官方投影仍然把上一步的定稿回答当作边界发布出去——answerAnchorSeq 指向的是一条在模型正在写的那一行之上的行。于是:
- 过程标记非空、
answerFor能解析、区间比较全部成立 → 折叠条件成立; - 折叠行出现,把过程折掉,而仍在增长的那一行被当成答案留在外面;
- 那一步定稿、下一步开始时投影重算,折叠又消失 → 用户看到的「折一下再弹开」。
第二个放大器:textLen 原本把 reasoning 也算进回答正文。纯思考的一步因此能通过 isAnswerRow,折叠行甚至会显示成「运行中 · 思考」。官方的 hasAssistantReplyContent 恰好把 reasoning 排除在外。
修法是补上官方那道关闭门,并且让 textLen 只数正文:
textLen只累计text块,reasoning 是过程材料;- 一轮的「已关闭」由它自己的行说明:
turn-tail在turn/end时发布(不论什么原因),turn-error/turn-max-tokens与它同时发布。分组里出现这三种 kind 之一,就是 DOM 自己对turnClosed的陈述; foldTurn第一件事就是这道门:没有关闭 → 一行都不折,foldable为 false,折叠行不渲染。
关闭门必须排在其它判据之前,因为它是唯一无法从别处补救的事实:运行中的一轮发布的边界已经移动过了,后面所有区间比较都建立在过期前提上。
回答结束时回到提问的开头
第五个功能是用户提的「每次回答完后自动滚动到这条的顶部」。触发点直接复用上面那道关闭门:某一轮从「未关闭」变成「关闭」时滚一次,不另起一套判据。
落点是把提问行贴到滚动口顶边(scrollTop + (提问行.top − 滚动口.top))。实测那一轮结束时的状态:
| 测量 | 结果 |
|---|---|
| 滚动容器 | div.QFBU2W_scrollBody,带 data-conversation-scroll——正是 ChatView 自己解析的那个元素 |
| 一轮结束后 | scrollTop = 1993 = floor(停在底部),提问行在滚动口上方 −1937px |
| 落点 | scrollTop = 56,提问行在顶边 0px,1.2 秒后仍在 56 |
只有真的会滚的时候才滚:没有溢出(短回答)或提问已经在顶边时不写。这两条让「短回答无感」和「重复触发安全」都成了自然结果,而不是额外规则。
另外三条护栏,每条都对应一个真实的坏结果:
- 你刚动过滚动就不滚:
wheel/touchstart/pointerdown/keydown一秒半内,这一轮的滚动作废(这正是「你正在往回翻时被拽走」的来源); - 只认「刚刚关闭」这一个瞬间,所以打开历史会话、切会话、点「加载更早」都不会自己滚;
- 写入是瞬时的,并在下一帧核对一次:这是踩出来的。动画版本(
scroll-behavior: smooth)在这里赢不了——一轮结束时产品自己也在往底部跟,两条滚动动画同时活着,实测出现过「插件记录了from 1993 to 56、而视图留在底部」,且连续两次运行一次成功一次失败。改成赋值就没有动画可以输;下一帧再量一次,只有真的没到位才补写,而这段时间里你一旦动手,补写就取消。
会话身份用「签名」,不用那个列元素
这里还有一个更隐蔽的坑,值得单独记:折叠控制器每帧都从锚点重新解析「当前的列」,而那个元素会因为一次普通重渲染就被换掉。早先的版本把「列元素变了」当成「换了一份历史」,于是把 baseline 重置了——结果是关闭事件本身被吃掉:实测六次里有两三次,插件连「这一轮关闭了」都没记录到(__FOLDITUP__ 里只有 pass,没有 noticed)。
现在用文字签名判断身份:最小轮次号 | 第一个渲染行的 key。会话切换一定会动这两个值之一;重渲染不会。窗口增长(新轮次、加载更早)也只是让签名变了下界而已——那时重置 baseline 恰好是想要的(那不是「刚刚关闭」)。
关掉它:localStorage['dsh-fold-it-up.autoScroll'] = 'off'(默认开)。
行为细节
| 场景 | 行为 |
|---|---|
| 一轮正常结束 | 折叠,末条回答保持可见,视图自动落到这一轮的提问顶部 |
| 正在思考 / 正在跑工具的那一轮 | 完全不折(没有 turn-tail),过程照常实时显示;也不会滚 |
| 回答很短、页面本来就没得滚 | 不滚(写入是空操作,插件干脆不写) |
| 回答结束后你正在自己往回翻 | 不滚(一秒半内的滚动手势会否掉这一次) |
| 点「加载更早」取回旧页 | 那批旧轮次立刻折好,视图不动 |
| 打开历史会话 | 已结束的轮次全都折好,视图停在原来的位置 |
| 被中断、没有回答的轮次 | 不折(没有正文回答可留) |
| 上下文注入行 | 与该轮的过程一起折叠;展开时原样回来 |
| 轮次报错 / 触顶 | 错误行与提示行永不隐藏 |
| 首条人类消息 | 永不隐藏 |
| 刷新页面 / 切换会话 | 重新折起(展开状态不持久化,这是刻意的),且不会自动滚动 |
| Ctrl+F 搜索 | 折叠的行仍能被浏览器找到并自动展开(hidden="until-found") |
安装
把仓库放到本地任意目录(本插件没有任何依赖,也没有安装步骤:client.js / index.js / cordis.patch.yml 都是入库的生成物,不需要构建工具链):
git clone https://github.com/gurio-wine/dsh-fold-it-up.git
然后把它装进 Web profile(profile 名按你的实际配置来,默认是 web):
dsh plugin --profile web add <刚 clone 下来的目录>
最后按 Ctrl+R 刷新页面 —— 客户端插件随页面加载,不需要重启 App。
卸载:
dsh plugin --profile web remove dsh-fold-it-up
再刷新页面即可;会话记录不受影响。
实现
| 文件 | 作用 |
|---|---|
src/logic.js |
全部决策 + 整列 pass:分组、范围、答案、隐藏 |
src/browser.js |
浏览器半边(作者态 ESM):影子渲染器、控制器、DOM 读写原语 |
client.js |
生成物:按模块系统的 bundle 协议包装好的浏览器半边 |
index.js |
生成物:宿主半边(刻意什么也不做) |
cordis.patch.yml |
生成物:把包挂进 profile 的那一行 |
几个刻意的选择:
- 影子注册。
priority: -1拿下这个 keyed 单元(官方是0,同一格优先级最低者渲染)。包级 boot-graph 插件不过 runner 的 guard,所以这里的-1是真实语义,不是自动分配的。 - 复用产品自己的折叠行。真实那一行是运行时从页面已经下载的 source map(
sourcesContent)里取出TurnProcessNodeView.tsx源码、只改两处 import 后编译出来的。文案走chat命名空间既有词条(中英文跟随界面),样式、图标、间距全部一致,不需要跟着产品改版同步维护。取不到源码时退回内置等价实现。 - 隐藏用官方同一套机制。给同一批 wrapper 元素挂
hidden="until-found"——这正是ChatNodeSeat自己用的属性,因此「隐藏的行不占列间距」的节奏和 find-on-page 都保持不变。 - 展开状态从行元素上读回。折叠行自己会写
data-open;pass 读它来决定这一轮要不要展开。这一点踩过坑:data-open写在行上,而索引里拿到的是外面的座位包装元素,读错对象会让每一次点击都变成空操作。 - 一个稳定的锚点元素。组件在「还不知道该不该折」和「已经折好」两种状态下都渲染同一个容器元素,控制器从它解析当前的 transcript 列。它必须一直存在:折好之后那一行本身就不渲染了。
- 监听 DOM,而不只是监听 store。列上挂
MutationObserver——一页被提交进来时,负责渲染那一轮行的那次 React 提交不会通知这个插件,但会改动 DOM。 - 无构建步骤的构建。
tools/build.mjs是一个字面量的 ESM→bundle 转换器(本包自己写的四种语法形式),把src/*.js内联进client.js,平台模块(react、@deepseek-ai/dsh-client-store)留给 boot 模块表。生成物入库,装插件不需要任何工具链。
诊断:页面里 globalThis.__FOLDITUP__ 保存最近 200 条生命周期记录(注册是否拿到格子、每次 pass 读到的列规模与分组数)。每一行上还有两个由 pass 写下的属性:data-folditup-seq(该行在 store 里的排序位置,取不到就没有)与 data-folditup-turn(管这一行的轮次——注入上下文行的归属只写在这里)。
验证
node --test tools/*.test.mjs # 纯逻辑 + 生成物契约
node tools/build.mjs --check # 生成物是否为最新
node tools/verify-live.mjs --url <带 token 的启动 URL> --session <id> --toggle
node tools/verify-load-older.mjs --url <带 token 的启动 URL> --session <id> --rounds 3
node tools/probe-stream.mjs --url <带 token 的启动 URL> --text "<提示词>" # 边跑边采样
node tools/verify-autoscroll.mjs --url <URL> [--session <id>] [--mode instant|smooth] # 量滚动的算术
node tools/verify-autoscroll-live.mjs --url <URL> --reload # 端到端:真的发一轮
tools/verify-live.mjs 用独立无头 Edge(独立 profile、独立调试端口,不碰你在用的窗口)打开真实会话,直接读真实 DOM:
- 每个已关闭轮次:恰好 1 行可见的 assistant(答案)、控制器未被隐藏、答案行已标记、没有漏出来的过程行;
- 该轮的注入上下文行如果还看得见,就是失败(这一条以前漏掉了,因为断言把
context当成了「本来就该可见」的 kind); - 每一行隐藏都必须是
hidden="until-found"; --toggle:点开 → 隐藏数归零、过程行与注入行重新可见;再点 → 恢复原样;--expect builtin跑同一套断言的反面(基线:过程行全部可见);- 任何
console.error/ 未捕获异常都会打印出来。
tools/verify-load-older.mjs 专测上一个回归:每一轮都重新加载页面、点一次「加载更早」、等新页提交,然后断言
- 没有任何一轮「有折叠控件却还露着过程行」,也没有任何一轮「渲染了过程行却完全没有折叠控件」;
- 每个折好的轮次恰好 1 行可见 assistant、且注入上下文行为 0——否则一个空转录也会「零失败」通过。
tools/probe-stream.mjs 专测「运行中不许折」:用浏览器自己的输入管线真的发一轮,从发出前到关闭后每 60ms 采样一次 DOM,把采样压成状态段后断言
- 关闭之前不存在任何折叠控件、也不存在任何被隐藏的行(
premature必须为空); - 关闭之后折叠行才出现,且恰好 1 行 assistant 可见、且它是答案行。
静态检查只看已结束的轮次,所以「折一下再弹开」这种运行中的抖动在它们眼里是隐形的——这个探针就是补这一块。
tools/verify-autoscroll.mjs 量的是滚动的算术:把提问行贴到顶边需要写什么、写下去会不会被界面抢回去、已经对齐时再写是不是空操作;--mode smooth 可以复现「动画版本为什么不行」。
tools/verify-autoscroll-live.mjs 量的是这个功能本身:用浏览器自己的输入管线真的发一轮长回答,然后只观察不干预——先断言它确实溢出了、关轮时确实停在底部、提问确实在屏幕外(否则这一轮什么都证明不了),再断言关轮后视图落在顶边、且插件只记录了一次写入、没有被追着补第二次。--reload 追加反向的一半:刷新后同一份转录重新折好,而插件记录的滚动次数必须是 0(新页面里没有任何一轮「刚刚关闭」)。它同时用页面的出生时间戳证明刷新真的发生了——否则「页面恰好很安静」会冒充这条断言通过。
实测(web profile,长回答):
关轮瞬间 top=1993 floor=1993 questionTop=-1937 ← 停在底部,提问在屏幕外 1937px
关轮后 top=56 floor=1993 questionTop=0 ← 提问落在顶边,连续 6 次采样不变
插件记录 {"kind":"scroll","from":1993,"to":56,"landed":56} ← 恰好一次,无补写
刷新后重新打开 rows=8 controllers=1 hidden=3 scrollEvents=0 ← 折好了,且一次都没滚
短回答(无溢出) 写入落地为 0,等于空操作
实测(web profile):
真实 DOM 上刚刚跑完的一轮 7 行:system-prompt / user / 折叠行 / 2 × context / 答案 / 尾部
2 行 context 均为 hidden="until-found"
展开 → 2 行 context 回来;收起 → 又都藏好
大历史会话(有「加载更早」) 4 turn(s) inspected; 0 failure(s)
turn 22/23/24 各带 4/6/5 行 context,全部折好,0 泄漏
展开 → hidden 0 / 11 行 assistant 可见;收起 → hidden 20 / 1 行
点「加载更早」2 轮 页面从 90 行长到 201 行,5 个轮次全部折好(隐形轮 99 行),0 failure
同一会话 4 轮(关闭门修复后) 4 turn(s) inspected; 0 failure(s)
点开 → hidden 0 / 11 行 assistant 可见;收起 → hidden 20 / 1 行
边跑边采样(关闭门修复前) premature 1 段:t+11.8s–13.0s 折叠控件已出现、3 行已隐藏,
而该轮尚无尾部;被当作「答案」留在外面的是「运行中 思考 I」
边跑边采样(关闭门修复后) premature 0 段;关闭前 controllers=0 / hidden=0,关闭后才折
同一会话在未装插件的实例上过程行全部可见——也就是用户报的那个「就是不折叠」。
其余工具:
tools/scan-context.mjs <session.v3.jsonl.zstd>:从会话日志里把注入的上下文事件与每一轮的过程范围[turn/start, 答案)对出来,回答「这些行到底在不在范围里」;tools/pick-session.mjs:按「无轮次上下文行数 / 轮次数」挑选值得实测的会话;tools/analyze-turns.mjs <session.v3.jsonl.zstd>:从会话日志重建每一轮,按官方判定打印哪些轮「本该折但没折」及原因;tools/probe-rows.mjs --url <URL> [--session <id>]:把一页的每一行按轮次打印出来(kind / 轮次 / 归属 / 成员标记 / 是否隐藏 / 文案),排查时先看它;tools/probe-ask.mjs --url <URL> --text "...":用浏览器自己的输入管线在实例里真的发一轮,然后打印折叠结果——没有可用的历史会话时用这个造一个;tools/probe-stream.mjs --url <URL> --text "...":同上,但在整轮进行中每 60ms 采样一次 DOM,输出压成状态段并列出「关闭前就折叠」的段——运行中抖动只能用它看见;tools/probe-scroll.mjs --url <URL> --text "...":打印滚动容器是谁、一轮结束前后滚动位置怎么变、以及一次写入能不能挪动它——自动滚动那几个约束都是它先量出来的;tools/probe-routes.mjs --url <URL>:Web 端没有会话级 URL,这个探针把这件事查清楚(页面地址、localStorage 键、侧栏会话行长什么样),顺带说明「打开指定会话」只能靠侧栏或用dsh.sessions.current预置;tools/session-log.mjs:多帧 zstd 会话日志的解码(DSH 的.zstd是上千个拼接帧,Node 的zstdDecompressSync只解第一帧)。
已知边界
- 只对 Web 界面生效;TUI / headless 没有这个话题。
- 展开状态不跨刷新保留(刻意:装上、刷新、切会话都应该看到折叠)。
- 自动滚动只在轮次关闭的那一刻发生。所以中途插话(steering)、打断、报错这些不会把视图拽走;你在它滚动之前一秒半内自己动过滚动,它也不动。
- 折叠行是 DSH 自己的行,所以它的文案是「工具调用 / 消息 / 已思考」;工作时长显示在轮次尾部的用量面板里,本插件不去改那一行。
- 「加载更早」还没点的时候,更早的轮次根本不在 DOM 里,无从折叠;把那些行取回来之后它们会立刻折好。
- 注入上下文的归属是「它下面的那一轮」。这符合几何(一行只在它位于该轮答案之前时才会被隐藏),但如果将来 DSH 改成把注入行渲染在别的位置,这条规则需要跟着改——
data-folditup-turn就是为了一眼看出归属而存在的。 - 滚动的落点是「提问行的顶边对齐滚动口顶边」,所以顶部那条空白(滚动口自身的上内边距,实测 56px)会保留;没有做成「贴到 0」是因为那个数字属于产品的样式,抄进来就会随它改版而错位。
- 与另一个同类第三方插件(抢同一格)不能共存;同一格里优先级最低者胜出,本插件是
-1。
许可证
MIT © 2026 Gurio
No comments yet. Be the first to write one.