DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

gurio-wine /

gurio-wine/dsh-fold-it-up

Verified

DeepSeek Harness Web 插件:强制折叠每一轮的工作过程,答案照常显示,历史轮次与上下文注入行一并折叠。

★ 0 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: master@57184a85

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"——它们不属于任何分组。所以它们不是被「排除」在折叠之外,而是从来没有进入过任何一次判定。

两个事实叠加才让它一直看得见:

  1. 官方那份「与过程无关的 kind」清单里没有 context(system-prompt / user / steering / turn-process / turn-error / turn-max-tokens / turn-tail 才有)——也就是说官方几何本来就会在范围里隐藏它们;
  2. 但官方给行打过程标记的那一刻,需要 processWindowReady,而那个开关要求 !historyIncomplete。长会话里它恒为假,于是这些行连标记都拿不到。

于是本插件的做法是:按座位在 DOM 里的位置,把无轮次的 context 行归给紧跟在它下面的那一轮(也就是它被注入进去的那一轮);尾部没有后续轮次时归给上面那一轮。然后

  • 有官方标记时:这些行按成员对待,和同一轮的其它过程行一起折;
  • 官方标记缺席时:退回序列区间判定,context 行不以序列号参与,而是以「它被归给了这一轮」参与。

归给哪一轮是可读的:pass 会给每一行写 data-folditup-turn,上下文行的归属就写在它自己的 DOM 上。这也让「这一行到底属于谁」可以被外部断言,而不必重新推导一遍规则。

顺带一个边界:一行只在它位于该轮答案之前时才会被隐藏,所以「上一轮答案之后、下一轮用户消息之前」的注入行跟着上一轮折(它属于上一轮),而不会被算进下一轮。

正在思考的那一轮会把自己折起来

第四个 bug 是用户报的「处于思考时,过程就会被折叠,直到进入到下一步」。

根因是「已定稿答案」这个判据在轮次运行中并不成立。 官方 latestAnswer(turn-process.ts)只接受最后一步的 assistant 节点、且该节点已带 finalNode;但运行中「最后一步」正是正在流式输出的那一步,它还没定稿,于是官方投影仍然把上一步的定稿回答当作边界发布出去——answerAnchorSeq 指向的是一条在模型正在写的那一行之上的行。于是:

  1. 过程标记非空、answerFor 能解析、区间比较全部成立 → 折叠条件成立;
  2. 折叠行出现,把过程折掉,而仍在增长的那一行被当成答案留在外面;
  3. 那一步定稿、下一步开始时投影重算,折叠又消失 → 用户看到的「折一下再弹开」。

第二个放大器: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 的那一行

几个刻意的选择:

  1. 影子注册。priority: -1 拿下这个 keyed 单元(官方是 0,同一格优先级最低者渲染)。包级 boot-graph 插件不过 runner 的 guard,所以这里的 -1 是真实语义,不是自动分配的。
  2. 复用产品自己的折叠行。真实那一行是运行时从页面已经下载的 source map(sourcesContent)里取出 TurnProcessNodeView.tsx 源码、只改两处 import 后编译出来的。文案走 chat 命名空间既有词条(中英文跟随界面),样式、图标、间距全部一致,不需要跟着产品改版同步维护。取不到源码时退回内置等价实现。
  3. 隐藏用官方同一套机制。给同一批 wrapper 元素挂 hidden="until-found"——这正是 ChatNodeSeat 自己用的属性,因此「隐藏的行不占列间距」的节奏和 find-on-page 都保持不变。
  4. 展开状态从行元素上读回。折叠行自己会写 data-open;pass 读它来决定这一轮要不要展开。这一点踩过坑:data-open 写在行上,而索引里拿到的是外面的座位包装元素,读错对象会让每一次点击都变成空操作。
  5. 一个稳定的锚点元素。组件在「还不知道该不该折」和「已经折好」两种状态下都渲染同一个容器元素,控制器从它解析当前的 transcript 列。它必须一直存在:折好之后那一行本身就不渲染了。
  6. 监听 DOM,而不只是监听 store。列上挂 MutationObserver——一页被提交进来时,负责渲染那一轮行的那次 React 提交不会通知这个插件,但会改动 DOM。
  7. 无构建步骤的构建。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

—/ 5

No ratings yet

Verified DSH bundle

Commit 57184a85353d

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout