Skip to content

armgit / cindy

Public Imported from GitHub
0

Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。

fix(desktop): 按视窗挂载消息正文并稳定滚动定位 (#5454)

DavidShenXDa5467dc0c166
diff --git a/apps/desktop/scripts/ax5406/BLACKBOX-VALIDATION.md b/apps/desktop/scripts/ax5406/BLACKBOX-VALIDATION.md
new file mode 100644
index 0000000000..89f8627992
--- /dev/null
+++ b/apps/desktop/scripts/ax5406/BLACKBOX-VALIDATION.md
@@ -0,0 +1,86 @@
+# #5406 黑盒复测:部分通过,不能整体验收
+
+> 后续修复更新见文末:回底入口缺失已完成因果对照及修复复测;下文保留首次失败记录。
+
+2026-10-04,Windows,当前 worktree 未提交代码;隔离 dev PID 23804,CDP 9546。
+根包装启动返回 `DESKTOP_DEV_VERDICT=ready`。
+
+本轮使用真实界面的侧栏、查找框、输入框、鼠标滚轮和可点击按钮;Playwright 通过 CDP
+发送输入并只读 DOM/选区采样。未直接写数据库、调用业务 IPC、改 React/store 状态、
+注入消息或写 scrollTop。复用之前的 100/500 条隔离测试任务;流式回复由 UI 实际发送。
+
+## 通过
+
+- 深色长历史:Ctrl+F 查到视口外 `Question 481`,当前逻辑窗口 96 行保持不变;关闭后恢复占位。
+- 点击正文、焦点为 BODY 时 Ctrl+A 的原生选区包含当前 96 条消息全部标签,共 44,681 字符。
+ 输入框 Ctrl+A 只选择输入框文字,不改变消息挂载;没有覆盖系统剪贴板。
+- 深色 500 条任务 100 次滚轮操作、浅色 100 条任务 60 次滚轮操作,160 次采样均无可见占位空白。
+ 浅色任务查找最早已加载的 `Question 61:` 不扩页,手动上滚成功加载 `boundary-0`,回底成功。
+- 真实 Codex/OpenAI GPT-6-Luna 输出 191–240 共 50 个标题,完整结束标记存在;显示文字 15,719 字符。
+ 118 次采样无可见占位空白或 renderer pageerror。上滚 1,200px 后保持阅读位置,
+ 内容继续增长 690px;点击实际可见的“查看新消息”后恢复跟随,最终距底部 0px。
+- 关键截图目检未发现正文重叠或排版破坏;本轮不是逐合成帧录屏,不能声明每帧都没有闪烁。
+
+## 未通过:长历史窗口回底入口消失
+
+500 条任务中可重复观察到:阅读较早历史、加载更多,再向下滚动时,
+“跳到底部”和“查看新消息”两个入口都保持透明且不接收点击。
+深色距当前滚动窗口底部 6,476px 时复现;切换浅色、通过侧栏重开同一任务,
+向上 500px 后连续向下 120px × 3,距底部仍有 3,096px,也能复现。
+正文显示正常;浅色 100 条任务的相同步骤没有出现问题。
+
+深色 100 次操作的具体顺序:45 次 -950px,35 次 +1100px,20 次 ±2600px 交替,
+随后 +180px。历史从 `qa5406-394` 扩到 `qa5406-260`,尾行仍为 `qa5406-493`,
+此时不处于整个任务的最新尾窗。
+补充小步探测 -200px、+120px × 5,scrollTop 按输入变化,但两入口一直不可点击。
+DOM 中的“新消息”数量同时为 110/120;本轮未向该静态测试任务发送新消息,
+该计数是否与历史扩展混淆,以及入口隐藏的因果关系,尚待定位。
+
+这是实际产品交互未通过,不是强制点击后的伪通过。尚未对基线版本做 A/B,
+不能断言由本次虚拟化改动引入。下一步应检查历史锚定窗口下的跟随状态、未读计数和回底入口显隐,
+补回归用例后再验收。
+
+## 测试驱动问题与证据
+
+初次查找断言使用了不存在的 `role=status`,改为实际查找栏 `aria-live` 计数。
+初次流式驱动误点隐藏的“跳到底部”,被正常显示的“查看新消息”挡住;该轮不能算完整验收。
+该轮 141–190 输出仍正常完成,没有重新提交同一个请求。随后另一轮 191–240
+使用真实命中检测选择可见入口,完整执行并通过。上述驱动修正没有修改产品代码。
+长历史场景修正驱动后两个入口仍不可点击,因此单独列为未通过项。
+
+证据目录:`C:/Users/User/AppData/Local/Temp/cindy-5406-blackbox-bdNmiU/`。
+`text-scroll.json`、`jump-probe.json`、`long-history-light.json` 保留失败场景,
+`light.json`、`stream.json` 保留通过场景;`acceptance.html` 是自包含截图报告。
+原生整窗截图经 Host 媒体入库提供给用户;入库成功不代表已验证手机实际下载。
+
+本轮没有修改产品代码,未重复执行之前已通过的 228 项单测和 typecheck。
+测试未出现闪退,但原 issue 现场转储仍缺失,不能据此声明原闪退已被最终证实修复。
+验收后通过窗口关闭按钮退出,确认 PID 23804 及本 worktree 的启动链进程已结束,
+CDP HTTP 端点不可访问;保留隔离测试数据与验收证据。
+
+## 后续定位与修复(2026-10-04)
+
+根因是恢复历史位置时状态初始化失步:`isNearBottomRef` 从恢复快照初始化为 false,
+而驱动按钮显隐的 `isNearBottom` state 固定初始化为 true。上滚意图及 scroll 回调
+看到 ref 已经是 false,跳过相同状态更新,导致 UI 一直认为已在底部,两个入口均隐藏。
+基线 HEAD 也存在这处写法。改为 state 与 ref 使用同一初始值;分页、逻辑窗口及未读计数语义不变。
+
+新增 `restoredScrollIndicator.test.tsx` 执行生产初始化语句与用户意图回调:修复前历史恢复
+用例失败,修复后恢复历史/正常尾部两种情况均通过。11 个定向测试文件共 241 项通过,
+Desktop typecheck、`git diff --check` 通过。
+
+在同一隔离客户端,仅切换这一行做因果对照:
+
+- 修复代码:上滚、切换任务再返回,原阅读锚点及像素位置保持;距底部 3,034px 时入口可点击。
+- 换回旧初始化:同样流程,距底部 3,353px 时两入口均隐藏,无法点击。
+- 恢复修复:浅色距底部 3,186px、深色距底部 2,960px,入口均可点击,最终距最新消息底部 0px。
+- 重跑查找、全选与 100 次连续滚轮:96 行逻辑窗口全文选择完整、无可见占位空白、回底成功。
+ 首次脚本在恢复尚未稳定时记录了窗口基线而失败;等候恢复完成后保留原断言完整重跑通过。
+- 追加真实 GPT-6-Luna 流式 241–270 共 30 节,9,621 字符,结束标记完整;76 次采样
+ 无可见占位空白或 renderer 错误,上滚阅读与恢复跟随通过,最终距底部 0px。
+
+对照 JSON、脚本与自包含截图报告:
+`C:/Users/User/AppData/Local/Temp/cindy-5406-return-fix-CxupfJ/`。
+`old.json` 保留旧行为;`fixed-light-final.json`、`fixed-dark.json` 为修复结果。
+未读数字属于既有首批历史 assistant 计数行为,本次未把它改为另一种未读定义;它不是入口隐藏的原因。
+修复验收后正常关闭 dev PID 14312,启动链进程已退出,CDP HTTP 端点不可访问。
diff --git a/apps/desktop/scripts/ax5406/CHANGED-FILES-VALIDATION.md b/apps/desktop/scripts/ax5406/CHANGED-FILES-VALIDATION.md
new file mode 100644
index 0000000000..bdc2dd304c
--- /dev/null
+++ b/apps/desktop/scripts/ax5406/CHANGED-FILES-VALIDATION.md
@@ -0,0 +1,52 @@
+# 变更文件卡片补测
+
+2026-10-04,Windows 隔离 dev,main 基线 `253888469`。
+
+## 先前遗漏与本轮发现
+
+此前普通消息、滚动和流式验收没有覆盖真实变更文件卡片;之前「验收通过」的表述
+不能包含此项。保留复杂条目挂载的实现不等于已经完成完整界面回归。
+
+本轮在临时 Git 仓库中建立 5 个文本文件,通过隔离客户端的真实 Codex/OpenAI
+GPT-6-Luna 修改每个文件的第 2 行。后台返回完整变更记录(5 文件、+5/-5),但聊天
+没有卡片,切换任务也不恢复。排除测试初始化问题后,确认 `MessageStream` 的
+`renderHistoryView.build` 分支漏传 `turnChangeSets`。普通渲染分支已传,历史分支未传;
+该遗漏在当前 main 中也存在,不是本轮视口挂载改动新增的。
+
+Git 追溯:历史分支最早来自 `edbd2e267`;本地任务启用历史视图的变更见 #5073
+(`96dcfad995`)。不把该显示问题直接等同于原 issue 的 Blink 闪退。
+
+## 修复与因果验证
+
+只补传既有 `turnChangeSets`,沿用原有按 user anchor 归属的卡片构建、分组、分页、
+权限和持久化路径。没有改数据库、协议、卡片样式或回滚操作。
+
+`historyTurnChangesProjection.test.ts` 执行生产历史视图 build 回调及真实构建器:
+修复前缺卡断言失败,修复后通过。另验证已完成卡片处在后续流式消息之前、不会重复,
+以及未加载轮次的卡片不会被带入当前页。热更新后真实卡片恢复,完整刷新后仍然显示。
+
+## 实机通过项
+
+- 卡片默认显示 3 文件,点击「再显示 2 个文件」后显示全部 5 文件。
+- 下一轮真实输出期间,卡片离屏(顶部 -7143.875px)仍保持同一 DOM 节点和 5 文件展开状态。
+- 手动上滚回卡片后,流式继续输出,9 次阅读采样的卡片顶部均为 356.125px,无漂移。
+- 点击回底恢复跟随,输出 31–45 共 15 节并完整结束;53 次采样无可见占位空白或
+ renderer pageerror,最终距底不超过 2px。再次上滚回卡片仍展开 5 文件。
+- 点击 `note-5.txt`,真实差异面板显示第 2 行的旧文本与新文本,整轮统计 +5/-5。
+- 刷新客户端后卡片仍存在;浅色与深色均检查展开卡片和差异面板。
+- 8 个定向测试文件共 202 项通过,Desktop typecheck、`git diff --check` 通过。
+
+前两次流式脚本未完成预定路径,没有计为通过:第一次模型只回复结束标记;第二次
+测试脚本打开差异面板后停留在卡片阅读位置,没有执行离屏和回底步骤。最终记录来自
+独立完成全部断言的第三次脚本 `card-test3.cjs`。
+
+## 证据与边界
+
+证据目录:`C:/Users/User/AppData/Local/Temp/cindy-5406-card-ADLsvO/`。
+`card-results.json` 保存完整采样;`card3.mp4` 是 39.85 秒、20 fps 的真实单窗口连续录像;
+`card-acceptance.html` 为自包含视频与截图报告。图片和视频不进入工程目录。
+
+未测试撤销/重做(本轮目标为显示、滚动与状态保持);未覆盖 macOS、正式安装包或原始
+崩溃现场。临时任务只修改本轮创建的 fixture 文件,未修改真实项目数据。
+补测后通过窗口关闭按钮退出,确认本轮 PID 28104 和该 worktree 启动链结束,CDP
+不可访问。没有提交或推送代码。
diff --git a/apps/desktop/scripts/ax5406/COMPONENT-REPRO.md b/apps/desktop/scripts/ax5406/COMPONENT-REPRO.md
new file mode 100644
index 0000000000..aad4ceae25
--- /dev/null
+++ b/apps/desktop/scripts/ax5406/COMPONENT-REPRO.md
@@ -0,0 +1,101 @@
+# #5406:真实 MessageStream 的正常 AX 路径复现
+
+2026-10-03,源码基线 `d656b0fc1ec3e04548cd018654cbd6486f6cf839`。
+
+本文记录修复前的组件复现;后续生产 CSS 改动及验证见 [修复报告](FIX-VALIDATION.md)。
+
+## 已确认
+
+当前源码中的 **MessageStream 及其真实消息子组件,可以在不调用 CDP、不启动 UIA 查询的条件下,
+经正常页面帧更新触发与历史现场相同的 Blink 断言**。这已超出早先只复现相同 RVA 的合成 DOM 实验。
+但仍不代表拿到了 #5406 的 0.1.96 原件,不能倒推该次原现场一定显示这个组件。
+
+独立 Electron `41.10.3` / Chromium `146.0.7680.216`,Windows x64;
+直接 import 未修改的 MessageStream、UserMessage、AssistantMessage、MarkdownRenderer 依赖图,
+使用仓库 Tailwind 配置、globals.css、默认字号、内置 Cindy Light 主题及相同字体包。
+截图与计算样式验证了真实消息布局:80 行、flex、14px gap、695px 高滚动容器、overflow-y:auto。
+
+外壳只提供 MemoryRouter、ConfirmDialogProvider、Tooltip.Provider、英文翻译资源,
+以及无特权的 `electronAPI.platform/logToMain` 测试值。没有真实 sessionId、账号、数据库或网络访问。
+不是完整 Cindy 客户端黑盒验收;复现阶段没有修改生产代码或提出已修复结论。
+
+## 实验矩阵
+
+所有表内实验复用同一份完整字体、主题、样式的构建 `FHpmfo`,数据均为合成文本。
+默认 80 条消息交替 user/assistant;每帧随机改 8 条文本,包含 Markdown 行内元素,周期改变滚动位置。
+这是压力负载,**不是原现场的用户动作回放,也不等同于正常单条回复只追加 token**。
+
+| 实验 | 条件 | 结果 | 末次采样文本更新 | 产物目录后缀 |
+|---|---|---|---|---|
+| A | seed5406,AX 开,containment 开,原生 UIA worker | 6,148ms,同签名 | 680 | FHpmfo |
+| B | seed5407,AX 开,containment 开,**无 UIA / CDP 查询** | 16,202ms,同签名 | 2,560 | Q7FiAj |
+| C | 与 B 同 seed/负载,仅取消 containment | 120,187ms,未崩溃 | 13,896 | H5wOJ0 |
+| D | seed5407,只改助手回复,每帧 1 条,不滚动,无查询 | 60,175ms,未崩溃 | 3,340 | MIcc2x |
+| E | seed5407,只改助手回复,每帧 8 条并滚动,无查询 | 6,831ms,同签名 | 632 | 6UuUhq |
+| F | 与 E 同 seed/负载,仅取消 containment | 120,149ms,未崩溃 | 10,040 | 33haP5 |
+
+更新计数为主进程最后一次采样值,不是 dump 中的准确崩溃瞬间计数。
+A 的 UIA 计数尚未回传就已崩溃;不能声称它已完成了某次 UIA 文本查询。
+B 未启动 UIA 进程、未 attach debugger,因而排除了“必须调用查询工具”这一条件。
+C 将 `content-visibility` 改为 `visible`、`contain-intrinsic-size` 改为 `none`,没有改消息组件。
+该受控对照支持消息行 containment 参与触发;有限时长未崩溃不等于生产修复验收。
+E 表明无需修改用户消息,助手回复正文更新已足以触发;D 同时降低了更新量并停止滚动,
+因此不能用 D 单独推断“滚动是必要条件”。E 的 dump 也已独立确认正常 AX 帧更新路径。
+F 则对 E 做了单因素 containment 对照。两组对照 C/F 都完整运行 120 秒。
+
+## 与现场完整栈的对照
+
+A/B 都保留独立 dump,异常码 `0x80000003`、RVA `0xA332D17`、
+PDB `D4DDA3CA101D876E4C4C44205044422E1` 三项完全一致。
+DbgEng 展开并用相同 PDB 身份的官方 Breakpad 符号解析,A/B 各有 35 个物理帧,
+包括 33 个 Electron 帧和两个系统帧;没有优化内联帧或 JS 栈恢复。
+
+```text
+RendererMain / RunLoop
+cc::ProxyMain::BeginMainFrame
+WebFrameWidgetImpl::DidBeginMainFrame
+LocalFrameView::RunPostLifecycleSteps
+LocalFrameView::RunAccessibilitySteps
+AXObjectCacheImpl::SerializeAXUpdatesIfNeeded
+SerializeUpdatesAndEvents / GetUpdatesAndEventsForSerialization
+AXTreeSerializer::SerializeChanges / SerializeChangedNodes
+AXObject::Serialize / SerializeInlineTextBox / SerializeLineAttributes
+AXInlineTextBox::NeighboringOnLineWithAXBlockFlowIterator
+AXBlockFlowIterator::NextOnLineAsIndex
+AXBlockFlowData::ComputeNeighborOnLine [ax_block_flow_iterator.cc:183]
+```
+
+与 [历史现场](FIELD-COMPARISON.md) A 的关键路径和 Next 分支相同。
+差异包括更深一层 SerializeChangedNodes 递归及栈底系统帧数量;不宣称逐地址完全相同。
+两份组件复现都没有 InspectorAccessibilityAgent / getFullAXTree 帧。
+
+**定位层次**:引擎故障在 Blink 的 AX 行内文本邻接计算;已证实可触发它的产品组件范围是
+MessageStream 的消息行子树及其 `.msg-stream-items > *` containment 规则。
+尚未从 native dump 反解具体 DOM 节点,因此不能指定某一个 Markdown span 或用户消息节点为唯一故障点。
+
+## 复核命令及限制
+
+```powershell
+node apps/desktop/scripts/ax5406/run.mjs --scenario=component --seconds=60 --query=none --rows=80 --batch=8 --seed=5407
+# 上一条会打印 AX5406_ARTIFACTS。后续将 <build-root> 换成该目录,复用相同构建:
+node apps/desktop/scripts/ax5406/run.mjs --scenario=component --component-build=<build-root> --seconds=120 --query=none --rows=80 --batch=8 --seed=5407 --containment=off
+```
+
+构建、profile、截图和 dump 都在独立系统临时目录。原始生产 dump 不复制进仓库。
+首次构建记录 renderer 源文件 SHA-256;每轮记录参数、脚本 SHA、实际布局、错误、更新数与签名。
+采样包含计算样式、scrollHeight 等布局读取,且会保存一张组件截图;这些是实验的一部分,
+尚未证明全部诊断读取都不是必要条件。
+
+早期挂载失败(缺 Provider / Router)和缺 Tailwind 类的运行均排除在矩阵外。
+中间完整 Tailwind、但尚未补齐主题/字体启动的实验也曾同签名崩溃,仅保留为辅助材料。
+上述实验不验证账号链路、模型流式传输、深色模式视觉效果或完整客户端恢复行为。
+
+本机实验根目录:`C:/Users/User/AppData/Local/Temp/cindy-ax5406-<表中后缀>/`。
+其中 `report.json` 为每轮原始计数及签名,`component.png` 是真实组件截图;
+A/B/E 另有 `stack.txt` 和 `symbolized-stack.json` 保存完整已展开栈。
+`component-sources.json` 中 MessageStream、AssistantMessage、UserMessage、MarkdownRenderer、
+globals.css 的 SHA-256 已与复现时源码逐一对上,未使用这些组件的替身;后续修复会改变 CSS。
+
+验证:真实 renderer 构建通过;签名解析器正反例测试通过;脚本语法检查通过;
+`pnpm --filter desktop run --if-present typecheck` 通过。矩阵 A–F 均没有记录 JS/renderer 错误,
+各轮独立 profile 已自动清理,本次 Electron/UIA 测试进程已全部退出;诊断产物有意保留。
diff --git a/apps/desktop/scripts/ax5406/DEV-SANDBOX-VALIDATION.md b/apps/desktop/scripts/ax5406/DEV-SANDBOX-VALIDATION.md
new file mode 100644
index 0000000000..8f6d51da2f
--- /dev/null
+++ b/apps/desktop/scripts/ax5406/DEV-SANDBOX-VALIDATION.md
@@ -0,0 +1,82 @@
+# #5406 完整 Desktop dev 沙盒验收
+
+2026-10-03,Windows,当前 worktree 的未提交代码。
+
+通过根入口启动:
+
+```powershell
+$env:XDT_CDP_PORT='9546'
+pnpm restart:desktop:remote --region=global --isolated=@worktree --passive
+```
+
+返回 `DESKTOP_DEV_VERDICT=ready`,实例 PID 3588,隔离名称
+`witty-feynman-6e38a1`。正式 Cindy 未被重启或替换。测试使用客户端提供的
+“跳过登录”本地模式;OpenAI 模型由 dev 既有只读登录复用机制提供,没有复制凭证。
+`desktop:whoami` 把 Windows `/prefetch:4` 误拼进 userData 而报告 mismatch;
+实际启动状态文件、进程路径、窗口版本信息均指向本 worktree 的 `d656b0f` 基线。
+渲染器通过 Vite 加载本 worktree 的未提交修改。
+
+## 发现并修复的遗漏
+
+真实长回复上滑时,“上一条提问”入口消失。DOM 中用户消息已变成高度占位行,
+而 `usePrevUserMessageInView` 和跳转回调依赖 `data-user-msg-id`,原占位行缺少该标记。
+
+只给普通 user 消息的占位行保留此导航标记;仍然 `aria-hidden`,不挂载正文,
+不为 assistant 或 synthetic trigger 建立提问目标。复测按钮恢复,点击后正文挂载,
+目标顶边为 46px,与滚动区顶边一致。新增 `previousQuestionPlaceholder.test.tsx`
+执行生产占位 JSX 和真实导航 hook,覆盖普通提问、assistant、synthetic trigger。
+
+## 完整客户端滚动
+
+通过既有 `localDb.sessions.create/messages.create` IPC 在隔离库写入 500 条合成消息,
+再由完整客户端正常读取。消息含不同长度 Markdown、列表、代码块、链接。
+未替换 MessageStream,也未直接改 SQLite 或 renderer store。
+
+| 模式 | 视口 | 采样数 | 可见占位空白 | 重叠 | 同时挂载正文 |
+|---|---|---:|---:|---:|---:|
+| Light | 1280×800 | 73 | 0 | 0 | 5–11 |
+| Light | 960×640 | 73 | 0 | 0 | 3–9 |
+| Light | 1100×1000 | 73 | 0 | 0 | 7–11 |
+| Dark | 1280×800 | 73 | 0 | 0 | 6–11 |
+| Dark | 960×640 | 73 | 0 | 0 | 3–9 |
+| Dark | 1100×1000 | 73 | 0 | 0 | 7–11 |
+
+每组 65 次滚轮输入、8 次大幅 scrollTop 跳转;合计 438 次采样、390 次滚轮输入、
+48 次程序跳转。覆盖自动扩展/加载历史,最多实际载入 500 行逻辑历史。
+6 次上一提问跳转均落入目标,6 次回到底部最终距离均为 0。
+尺寸通过 CDP 视口模拟调整,未声称覆盖原生拖动窗口边框。
+深色模式通过设置页切换,219 次采样同时读取完整 Chromium AX 树,无崩溃。
+
+## 真实模型流式输出
+
+使用 OpenAI 来源 GPT-6-Luna,通过正常输入框发送,不使用 XD/Cindy AI 来源。
+两轮回复分别输出 1–80 和 81–140 章节;持久化结果核对为完整有序的 80/60 个标题,
+内容分别为 27,076 / 22,771 字符,末尾结束标记存在。
+
+修复后的第二轮:1,847 次几何采样,0 可见占位空白,0 renderer pageerror。
+上滑阅读期间内容高度继续增长 1,448px,选定阅读锚点偏移范围为 0px。
+向下滚动显示回底按钮后点击,恢复跟随;结束后离底距离为 0。
+同时执行 16 次完整 AX 树读取,节点数 8,727–9,753,无原生崩溃。
+
+原始几何采样保留了绘制前瞬间的离底读数,不能据此声称每一帧都贴底;
+绘制前中间态的对照定位见 STREAM-VALIDATION.md。此次完整客户端以稳定位置、
+阅读锚点、消息完整性及各关键步骤的真实截图验收,没有替代前述逐帧组件测试。
+
+第一次流式采样脚本曾在按钮因停留自动隐藏后尝试点击而超时;这不算验收通过。
+改为模拟真实向下滚动、显示按钮后点击,第二轮完整执行并通过,没有强制点击隐藏按钮。
+
+## 产物与检查
+
+本机原始采样/脚本/截图目录:
+`C:/Users/User/AppData/Local/Temp/cindy-5406-dev-fovqas/`。
+
+- `scroll.json` / `dark-scroll.json`:六组滚动采样。
+- `stream-final.json` / `stream-ax.json`:真实流式与 AX 采样。
+- `acceptance.html`:自包含真实截图报告;截图不提交仓库。
+- 23 项定向测试通过;Desktop typecheck 通过;`git diff --check` 通过。
+- Light/Dark 均目检;全窗原生截图也确认 CDP 截图侧栏黑底属于透明背景捕获差异。
+- 验收后通过窗口的“退出 Cindy”正常退出,确认 PID 3588、启动链进程及 CDP 9546
+ 均已结束;隔离 profile 保留,正式实例未动。
+
+本次只覆盖 Windows dev 客户端和这些测试负载,不等于原 issue 现场转储已核对,
+也不等于 macOS、手机端、生产安装包或长期压力验收。原现场转储仍缺失。
diff --git a/apps/desktop/scripts/ax5406/FIELD-COMPARISON.md b/apps/desktop/scripts/ax5406/FIELD-COMPARISON.md
new file mode 100644
index 0000000000..37068a9b96
--- /dev/null
+++ b/apps/desktop/scripts/ax5406/FIELD-COMPARISON.md
@@ -0,0 +1,141 @@
+# #5406:本机历史现场与合成复现的调用栈对照
+
+分析日期:2026-10-03。现场对照阶段仅本地读取、符号化;未上传转储或发表评论。
+
+同日后续:[真实组件实验](COMPONENT-REPRO.md) 已在当前 MessageStream 中触发正常 AX 序列化路径,
+并完成取消 containment 的对照。下文仍保留历史转储自身的证据边界,不能用实验倒推原件窗口身份。
+
+## 结论与材料身份
+
+**确认了历史同签名现场的引擎触发链;尚未确认 #5406 的 0.1.96 原现场或具体 React 组件。**
+
+从本机默认 `Cindy/Crashpad/reports` 找到两份相同异常码、RVA 和 PDB 身份的转储。
+不能因日期早就排除同源故障,但也不能把它们当作 Issue 所说的两份原件:
+
+| 材料 | 转储内时间(北京时间) | Cindy 版本 | Windows build | 故障 renderer PID |
+|---|---|---|---|---|
+| A:a641a046-d6f9-451b-bd21-64a3c612675a.dmp | 2026-08-25 15:11:59 | 0.1.60 | 26200 | 41424 |
+| B:e8c15294-12d4-4d9b-af05-0ea831a17d58.dmp | 2026-09-08 20:33:39 | 0.1.75 | 26200 | 38212 |
+| #5406 描述 | 本轮没有原件可独立核对 | 0.1.96 | 26100 | 未知 |
+
+A/B 的模块版本与 Crashpad `_version` 相互印证;时间取自 dump header,不依赖文件修改时间。
+两者都标记 `process_type=renderer`、`renderer_foreground=true`、Electron `41.10.3`。
+`ax_mode` 原始字段是 `kNativeAPIs | kWebContents | kInlineTextBoxes | kExtendedPropert`;
+字段尾部已截断,不能由此还原完整模式或判断是哪个程序开启 AX。
+
+三项共同签名:`0x80000003` / `Cindy.exe+0xA332D17` /
+`electron.exe.pdb D4DDA3CA101D876E4C4C44205044422E1`。
+A/B 均在 `AXBlockFlowData::ComputeNeighborOnLine` 的 `ax_block_flow_iterator.cc:183`
+命中 `INT3`,寄存器 `r14=1`,断言分支要求的类型是 `2`。
+
+## 触发链差异
+
+两份历史现场共用以下调用方到故障点的路径:
+
+```text
+RendererMain / RunLoop
+cc::ProxyMain::BeginMainFrame
+WebFrameWidgetImpl::DidBeginMainFrame
+LocalFrameView::RunPostLifecycleSteps / RunAccessibilitySteps
+AXObjectCacheImpl::SerializeAXUpdatesIfNeeded
+SerializeUpdatesAndEvents / GetUpdatesAndEventsForSerialization
+AXTreeSerializer::SerializeChanges / SerializeChangedNodes
+AXObject::Serialize / SerializeInlineTextBox / SerializeLineAttributes
+AXInlineTextBox::NeighboringOnLineWithAXBlockFlowIterator
+AXBlockFlowIterator::NextOnLineAsIndex [A]
+AXBlockFlowIterator::PreviousOnLineAsIndex [B]
+AXBlockFlowData::ComputeNeighborOnLine → CHECK / INT3
+```
+
+合成用例则从 `DevToolsSession → InspectorAccessibilityAgent::getFullAXTree →
+BuildProtocolAXNodeForAXObject → AXObject::Serialize` 进入共同末段,沿 Previous 分支崩溃。
+因此现有用例证明了**同一引擎断言可稳定触发**,没有复现完整历史入口。
+历史栈内没有 Inspector/CDP 帧,不能认定当时是 `getFullAXTree` 工具调用导致;
+也不能仅凭栈排除此前工具或系统辅助功能曾开启 AX。
+
+## 9 月 8 日日志时间线
+
+本地 `main-2026-09-08.log` 与 B 的秒级时间、转储文件名、版本相互对应:
+
+| 北京时间 | 事件 | 原日志行 |
+|---|---|---|
+| 20:33:39(dump header) | renderer 38212 触发上述断言 | dump |
+| 20:33:39.911 | 主进程记录 `render-process-gone: reason=crashed exitCode=-2147483645`,开始 shutdown | 451889–451890 |
+| 20:33:40.684 | `runQuitDisposers completed` | 452238 |
+| 20:33:40.696 | `Object has been destroyed`,BrowserWindow 清理回调异常 | 452240–452255 |
+| 20:33:47.960 | 重启诊断确认前进程 31852,版本 0.1.75,exitCode=1,reason=render-process-gone:crashed;并列出 B | 452267–452268 |
+
+`Object has been destroyed` 是 renderer 已崩溃后清理阶段的次生异常,不是此 native 崩溃的起点。
+8 月 25 日同期日志不在现有保留范围,未作同等关联验证。
+
+## 具体组件能确认到哪里
+
+- **已确认的原生组件**:Blink accessibility 的 `AXInlineTextBox` / `AXBlockFlowIterator`,
+ 在正常帧更新后序列化行内文本的相邻关系时触发引擎断言。
+- **窗口范围有限推断**:B 进入了 0.1.75 lifecycle 的全局退出分支。
+ 对照 `v0.1.75-beta` 源码,当时已隔离 webview guest、右侧栏、插件面板等已注册窗口;
+ 日志没有 webContents ID、renderer PID 到窗口的映射,不能进一步坐实主窗口身份。
+- **产品组件仍是候选**:`MessageStream` 的 `.msg-stream-items > *` 在 0.1.60、
+ 0.1.75 及当前源码中都有 `content-visibility: auto` 与 `contain-intrinsic-size: auto 240px`,
+ 与合成复现条件相符。但是 dump 没有提供可直接对应 DOM/React 的 crash annotation,
+ 本轮没有取得故障节点到该组件的映射,不能把候选写成根因。
+
+仍需取得 #5406 两份 **0.1.96 原始转储及对应日志**,复核其版本、签名和入口是否一致。
+若原件也没有组件身份,下一步需在隔离环境载入真实 MessageStream,补上节点/窗口映射,
+并通过正常 AX 帧序列化路径触发后再做 containment 对照;仅新增日志或数次未崩溃都不构成修复证据。
+
+## 栈展开方法及限制
+
+使用 Windows DbgEng 从 `.ecxr` 展开 x64 原生物理帧,再以 Electron 官方
+[v41.10.3 符号包](https://github.com/electron/electron/releases/download/v41.10.3/electron-v41.10.3-win32-x64-symbols.zip)
+的相同 PDB 身份 Breakpad FUNC/行号表解析。调用者用返回地址减一查源行。
+A/B 各解析 32 个 Cindy/Electron 物理帧,末尾为未加载 Windows 私有符号的 `KERNEL32+0x2ccb7`。
+未展开优化内联帧、未恢复 JavaScript 栈或 DOM 堆对象。DbgEng 的 export 猜测名称均不采信。
+原输出存在映像 checksum、系统 DLL timestamp 及扩展 DLL 不可用警告;未以这些猜测定位函数,
+源码归属依据单独校验的 PDB 身份和 RVA。此报告不把有限 minidump 称作完整内存快照。
+
+Crashpad 元数据布局依据官方 [minidump_extensions.h](https://github.com/chromium/crashpad/blob/main/minidump/minidump_extensions.h)。
+只提取版本、进程、AX 模式等允许字段,未输出任意内存字符串或用户内容。
+
+原始 dump 留在原位置;本地符号化 JSON、DbgEng 输出及 SHA-256 在仓库外诊断目录保留。
+下表中的长模板名缩写为 `<...>`,完整函数签名保留在本地 JSON。
+
+## 全部已展开物理帧对照
+
+顺序为故障点 → 调用方;RVA 为异常 PC 或原始返回地址,非调用指令起点。
+
+| 帧 | A 函数 | A RVA | B 函数(相同记 =) | B RVA |
+|---|---|---|---|---|
+| 0 | blink::AXBlockFlowData::ComputeNeighborOnLine | 0xa332d17 | = | 0xa332d17 |
+| 1 | blink::AXBlockFlowIterator::NextOnLineAsIndex | 0xa333561 | blink::AXBlockFlowIterator::PreviousOnLineAsIndex | 0xa333591 |
+| 2 | blink::AXInlineTextBox::NeighboringOnLineWithAXBlockFlowIterator | 0xa33067e | = | 0xa3306a6 |
+| 3 | blink::AXObject::SerializeLineAttributes | 0xa302cf9 | = | 0xa302d62 |
+| 4 | blink::AXObject::SerializeInlineTextBox | 0xa2ff841 | = | 0xa2ff841 |
+| 5 | blink::AXObject::Serialize | 0xa2fe5a4 | = | 0xa2fe5a4 |
+| 6 | ui::AXTreeSerializer<...>::SerializeChangedNodes | 0x3adf174 | = | 0x3adf174 |
+| 7 | ui::AXTreeSerializer<...>::SerializeChangedNodes | 0x3ade47a | = | 0x3ade47a |
+| 8 | ui::AXTreeSerializer<...>::SerializeChangedNodes | 0x3ade47a | = | 0x3ade47a |
+| 9 | ui::AXTreeSerializer<...>::SerializeChanges | 0xa2ef632 | = | 0xa2ef632 |
+| 10 | blink::AXObjectCacheImpl::GetUpdatesAndEventsForSerialization | 0xa2ebbda | = | 0xa2ebbda |
+| 11 | blink::AXObjectCacheImpl::SerializeUpdatesAndEvents | 0xa2eaa73 | = | 0xa2eaa73 |
+| 12 | blink::AXObjectCacheImpl::SerializeAXUpdatesIfNeeded | 0xa2ea651 | = | 0xa2ea651 |
+| 13 | blink::LocalFrameView::ForAllNonThrottledLocalFrameViews | 0x53c863d | = | 0x53c863d |
+| 14 | blink::LocalFrameView::RunAccessibilitySteps | 0x363de6b | = | 0x363de6b |
+| 15 | blink::LocalFrameView::RunPostLifecycleSteps | 0x363dbb6 | = | 0x363dbb6 |
+| 16 | blink::WebFrameWidgetImpl::DidBeginMainFrame | 0x361143c | = | 0x361143c |
+| 17 | cc::LayerTreeHost::DidBeginMainFrame | 0x2ea3483 | = | 0x2ea3483 |
+| 18 | cc::ProxyMain::BeginMainFrame | 0x2e9cc97 | = | 0x2e9c244 |
+| 19 | base::internal::Invoker<...>::RunOnce | 0xa34d11 | = | 0xa34d11 |
+| 20 | base::TaskAnnotator::RunTaskImpl | 0x4f6149d | = | 0x4f6149d |
+| 21 | base::sequence_manager::internal::ThreadControllerWithMessagePumpImpl::DoWork | 0x4f5c01d | = | 0x4f5c01d |
+| 22 | base::MessagePumpDefault::Run | 0x4f7bb6a | = | 0x4f7bb6a |
+| 23 | base::sequence_manager::internal::ThreadControllerWithMessagePumpImpl::Run | 0x23e4935 | = | 0x23e4935 |
+| 24 | base::RunLoop::Run | 0x23fb4bc | = | 0x23fb4bc |
+| 25 | content::RendererMain | 0x3297446 | = | 0x3297446 |
+| 26 | content::RunOtherNamedProcessTypeMain | 0x95bafa | = | 0x95bafa |
+| 27 | content::ContentMainRunnerImpl::Run | 0x95c811 | = | 0x95c811 |
+| 28 | content::RunContentProcess | 0x95aefd | = | 0x95aefd |
+| 29 | content::ContentMain | 0x95b153 | = | 0x95b153 |
+| 30 | wWinMain | 0x20a360 | = | 0x20a360 |
+| 31 | __scrt_common_main_seh | 0x5618fe2 | = | 0x5618fe2 |
+| 32 | KERNEL32+0x2ccb7 | 系统模块 | = | 系统模块 |
diff --git a/apps/desktop/scripts/ax5406/FILE-LISTS-ACCEPTANCE.md b/apps/desktop/scripts/ax5406/FILE-LISTS-ACCEPTANCE.md
new file mode 100644
index 0000000000..7ded926d71
--- /dev/null
+++ b/apps/desktop/scripts/ax5406/FILE-LISTS-ACCEPTANCE.md
@@ -0,0 +1,17 @@
+# #5406 文件清单补充验收(2026-10-04)
+
+基线与 P1-ACCEPTANCE.md 相同;本次不修改产品代码。Windows 隔离 dev,OpenAI GPT-6-Luna 真实工具输出。
+证据目录:`C:/Users/User/AppData/Local/Temp/cindy-5406-files-_bszklqs/`。
+
+| 范围 | 结果 |
+|---|---|
+| 定向自动化 | GeneratedFilesCard / projection / generatedFiles / remote:4 文件 76 项通过;Review fileTree / lastTurnFilter / reviewSource:3 文件 26 项通过,共 102 项 |
+| 流式清单到变更卡片 | 工作目录内真实创建 7 个文件;生成过程中展示独立清单,完成后由同轮变更卡片去重承接,7 项齐全且物理文件存在。360 次采样无可见占位空白,`transition.json` |
+| 独立文件清单 | 在临时工作目录外、独立临时目录真实创建 7 个文件,无对应变更卡片;完成后清单保留。100 次采样无可见占位空白,`standalone.json` |
+| 文件清单滚动 | Light/Dark × 1280×800、960×640、1600×900;6→7 展开、离屏仍挂载、返回保留展开、无横向溢出;96 次定向滚动采样无可见占位空白。切换任务、刷新后唯一清单及 7 项内容正确,`list-ui.json` |
+| 文件预览 | Markdown / TXT 弹层内容与文件标记一致;HTML 在真实侧栏 WebContents 打开并目检标题,`preview.log` 与 `preview-*.png` |
+| 本轮已修改文件树 | 7 项完整、筛选单项和无结果后恢复、逐项选择;Light/Dark × 三种窗口尺寸;历史轮 5 个 note 文件与新一轮 7 个 file-list 文件各自独立,切换任务后范围正确,`sidebar.json` / `sidebar-regression.json` |
+
+测试脚本修正:首次等待错误地要求生成完成后仍保留重复清单;根据既有去重行为修正为验证最终卡片的完整性,没有重复发送创建请求。另修正脚本的展开按钮文案、末尾位置阈值、历史轮次先滚动加载、日志 UTF-16 解码。HTML 内嵌 WebContents 在重新连接 CDP 后不作为普通 page 枚举,故其标题以真实截图目检记录。未修改或放宽产品测试断言。
+
+本次未发现文件列表相关回归。截图与 HTML 报告留在临时证据目录,不纳入工程。本结论仅限上述 Windows dev 场景,窗口变化通过 CDP 设置视口;未验证远端手机文件取回、macOS 或正式安装包。原始崩溃转储仍缺失,先前 50k 性能波动也不因本次补测而变为全绿。
diff --git a/apps/desktop/scripts/ax5406/FINAL-DEV-SMOKE.md b/apps/desktop/scripts/ax5406/FINAL-DEV-SMOKE.md
new file mode 100644
index 0000000000..e9163d5fa8
--- /dev/null
+++ b/apps/desktop/scripts/ax5406/FINAL-DEV-SMOKE.md
@@ -0,0 +1,45 @@
+# #5406 最终版本完整 dev 冒烟与原生窗口缩放
+
+后续 rebase 至 `09de4092` 的完整测试与 dev 重跑结果见 [FINAL-REBASE-VALIDATION.md](FINAL-REBASE-VALIDATION.md)。本文保留为此前基线的记录。
+
+2026-10-04,Windows / Electron 41.10.3,基线 `25388846915a9640341c4de5feb804b3a948c8f2` 加当前工作区修改(含首帧负进度修复)。
+
+**结论:本轮完整 dev 关键路径和 Windows 原生接口连续缩放通过,未发现新的显示回归。鼠标拖动窗口边框未验收:Windows 锁屏拦截了输入,不能把工具返回“已发送”算作实际拖动成功。**
+
+## 环境与版本
+
+- 两次均由 `pnpm restart:desktop:remote --region=global --isolated=@worktree --passive` 启动,取得 `DESKTOP_DEV_VERDICT=ready`,沙盒 `witty-feynman-6e38a1`。未启动正式版或共享正式数据。
+- 本轮没有修改产品代码。7,482 个源码文件的测试前后 SHA-256 一致;实际 dev 提供的 `animateFocusScroll.ts` 包含 `[0,1]` 进度钳制。
+- 所有尺寸调整均作用于真实 Win32 窗口,清除了 CDP 视口覆盖;通过窗口客户区尺寸与 renderer `innerWidth/innerHeight` 双重校验。主要测试尺寸 1280×800、960×640、1100×1000;文件列表另含 1600×900。
+- 原生界面检查工具中途触发了 Electron 无障碍状态。相应结果单独保存为 `ax-*`;随后重新启动隔离 dev,明确断言普通模式 `accessibilitySupport=false` 且存在离屏占位,再补测缩放、定位、流式、卡片及文件树。
+
+## 本轮结果
+
+| 项目 | 结果 |
+|---|---|
+| 浅深主题 × 三种真实窗口尺寸 | 480 次慢滚、快滚、反向滚动采样,无可见占位空白或重叠;六次提问导航及回底通过,回底距离均 0 |
+| 查找、全选与位置恢复 | 双主题查找命中、输入框全选、正文全选、关闭后恢复按视口挂载;查找前后逻辑消息 key 不变;切换任务恢复同一消息,偏移不超过 2px |
+| 普通模式连续原生缩放 | 1280×800→960×640→1100×1000→1600×900→1280×800,120 次 resize、1,046 帧几何采样;全程 AX 状态 false,离屏占位 50–54 行,0 可见占位、0 重叠;逻辑 key 不变,恢复原尺寸后阅读锚点偏移 0px |
+| 无障碍模式补充缩放 | 119 次 resize、5,616 帧(包含较长空闲期);无可见占位或重叠,恢复尺寸后阅读锚点偏移 0px。该结果不替代普通虚拟化模式的上一行 |
+| 最终定位动画在完整 dev 中运行 | 三尺寸、六次远距离定位,目标正确且稳定,无可见占位。通过生产 `requestChatTaskFocus` 通道调用完整客户端的加载与定位路径;属于集成测试,不冒充鼠标点击搜索结果的黑盒测试 |
+| 真实模型流式输出 | 既有 OpenAI GPT-6-Luna 测试任务续写 421–450 共 30 节,结束标记完整;75 次采样无可见空白,15 次 CDP AX 读取;稳定回看期正文增长 576px、锚点漂移 0px,回底后恢复跟随,结束距离 0 |
+| 大表格查找 | 双主题,横向滚动 319px 后命中完整可见,逐片段命中测试确认未被覆盖;逻辑消息 key 未改变 |
+| 变更卡片 | 普通模式、双主题,两轮分别由 3 文件展开为 5 / 7 文件;离屏保持同一 DOM,返回保持展开,48 次滚动采样无可见空白。此次没有重复执行撤销/重做文件操作 |
+| 独立文件列表 | 普通模式、双主题 × 三尺寸,6→7 文件展开、96 次离屏滚动采样、返回状态、无横向溢出、切换任务和刷新后唯一清单及内容完整 |
+| 本轮修改文件树 | 双主题 × 三尺寸,历史轮仅 5 个 note 文件、新一轮仅 7 个 file-list 文件;逐项选择和切换任务后范围正确。本轮未重复文件筛选和预览业务操作 |
+| 分享选择 | 进入时补齐当前逻辑窗口正文,全选、滚动后选择保持、取消通过;未执行图片导出或剪贴板操作 |
+| 清理与源码一致性 | 本轮所有测试脚本结束,dev 正常退出;PID 49296 / 32260 均不存在、9546 端口不再监听;源码一致性和 `git diff --check` 通过 |
+
+定位时间来自本轮 dev 的 rAF 几何采样:已加载数据的五次跳转稳定时间约 726–865ms;首次跳到较远历史,目标约 1,931ms 可见、约 1,941ms 稳定,包含加载与构建消息窗口的时间。不能套用组件夹具中的 480–515ms 首次出现数据。
+
+## 测试条件修正与限制
+
+- Electron 不提供本次尝试的 `Browser.getWindowForTarget` 调试方法,改用 Win32 `SetWindowPos`。这是真实窗口重排测试,但没有覆盖系统拖拽期间的模态 sizing loop。
+- CUA 背景拖动被阻止;前景两次报告输入已发送,但尺寸没有改变。通过 `WindowFromPoint` 与前景句柄确认输入命中了 Windows 锁屏。没有解锁、修改系统设置或绕过锁屏。
+- 定位脚本最初依赖已满的 resource timing 缓冲区寻找模块,改为使用 dev 实际导入 URL。首次无障碍全挂载模式下固定 2.2 秒等待未等到目标,原失败日志保留;最终使用 5 秒有界观察,保留真实首次出现和稳定时间,目标可见及稳定的断言没有移除。
+- CDP 截图的透明侧栏可能显为黑底;本轮 UI 目检使用 `PrintWindow` 原生截图,浅深色文件列表、卡片及文件树均检查。rAF 几何采样和关键截图不能证明物理显示器每个刷新帧都无闪动。
+- 本轮是完整 dev 冒烟,不是再次执行所有业务操作或全量单测;沿用最终进度修复后的 49 项定向单测、300 次 Electron 探针与类型检查记录。旧版全量测试的版本边界见 `FOCUS-SCROLL-FIX.md`。
+- 仍未覆盖 macOS、正式安装包、真实 NVDA/VoiceOver 长期使用;50k 性能波动未重测;原始 #5406 现场转储仍缺失,不能据此宣称所有闪退原因已消除。
+
+原始脚本、JSON、日志、真实截图与手机适配的自包含 `REPORT.html` 位于:
+`C:/Users/User/AppData/Local/Temp/cindy-5406-final-smoke-PI3X4n/`。
diff --git a/apps/desktop/scripts/ax5406/FINAL-REBASE-VALIDATION.md b/apps/desktop/scripts/ax5406/FINAL-REBASE-VALIDATION.md
new file mode 100644
index 0000000000..a5b659d765
--- /dev/null
+++ b/apps/desktop/scripts/ax5406/FINAL-REBASE-VALIDATION.md
@@ -0,0 +1,87 @@
+# #5406 最终 rebase 与完整复测
+
+2026-10-04,Windows,分支 `cindy/witty-feynman`。
+
+**阶段结论:rebase 完成,dev 关键路径复测通过。下文保留当时的原始结果;其中 40 项失败及随后发现的 7 项原生集成失败已在后续修复,提交前状态见下面的补充记录。**
+
+## 提交前补充验证(2026-10-04)
+
+- 原 40 项失败逐项复测通过。修正 Windows 链接与路径写法、数据库测试夹具及过期源码断言,未删除或放宽产品行为断言。
+- Desktop unit:47,465 通过、148 既有跳过、0 失败;Desktop DB:1,896 通过、6 既有跳过、0 失败;maker-core unit:5,169 通过、37 既有跳过、0 失败。另有 guard 与行为定向回归 323 项通过。
+- 原生集成的 7 项失败全部通过:Claude 测试等待子进程实际关闭后再恢复或清理目录;Pi 旧版 API 路径遇到子任务缺少 settings.json 时使用默认设置,仅捕获 ENOENT,仍上抛权限错误与损坏配置。
+- 六个原生集成测试文件共 86 通过、11 既有跳过、0 失败(真实原生程序与本地模拟上游);Pi bridge 相关回归 671 通过、4 既有跳过、0 失败。Desktop 和 maker-core 类型检查通过。
+- 这些是对受影响测试范围的后续复测,并非在最后一处修复后重新执行整仓默认矩阵。下文 dev 视觉验收对应消息渲染实现;后续产品代码仅修改 Pi bridge 的缺失配置处理。
+- 本机详细证据:`C:/Users/User/AppData/Local/Temp/cindy-baseline-test-fixes-P0fAwt/REPORT.html` 与 `C:/Users/User/AppData/Local/Temp/cindy-native-integration-b59e2a55/REPORT.html`;这些临时路径仅供本机核查,不是仓库附件。
+
+## 版本与改动保护
+
+- 从 `25388846915a9640341c4de5feb804b3a948c8f2` rebase 到本轮 fetch 的 `origin/main`:`09de409253734af65e63e0d77b7402b9c7071e19`,新增 6 个主干提交,无冲突。
+- 原有 86 个已修改/未跟踪文件先复制备份并记录哈希,再 stash、rebase、apply。保留备份 stash `98894031d45a523ff1fbfc3d3bcf79bf79120981`。
+- 自动合并的 preload 和类型声明已复核;main 新增接口与本地无障碍接口均保留。
+- 主干包含 #5445 历史分页读取优化;其 `historyViewReader` 41 项测试全部通过。
+- 本轮新增修正仅涉及验证接入:重新生成设计库存以纳入新增聊天文件;将转储解析测试接入 Vitest 并更新运行命令,原断言保留。没有修改产品实现。
+
+## 完整测试矩阵
+
+实际执行 `pnpm test:all`。首次根级测试被过期设计库存阻断;修正后执行 `pnpm test:runner` 和原入口后半段 `node scripts/test-workspaces.mjs --all`,完整覆盖同一默认矩阵。另行执行 Desktop DB 层和真实 dev 冒烟。
+
+| 检查 | 本轮结果 |
+|---|---|
+| 根级 runner | 562 通过,10 跳过,0 失败 |
+| Desktop typecheck | 通过 |
+| Desktop unit | 47,457 通过,148 跳过;6 项链接测试失败与 main 一致。另有转储测试最初未被 Vitest 收集,修正接口后该项单独通过 |
+| Desktop guard | 33 通过,6 失败,与 main 一致 |
+| maker-core unit | 5,167 通过,37 跳过,2 失败,与 main 一致 |
+| maker-remote-ssh unit | 首次因找不到 Bash 失败 11 项;仅为测试进程补充本机 Git Bash 的 PATH 后,整包 238 通过、3 跳过、0 失败 |
+| 其余默认矩阵 | 全部通过,包含 Mobile、device-link、共享包与设计 token 等。默认矩阵共 30 个执行目标;首次 26 通过、4 失败;SSH 环境修正后剩余 3 个目标仍含 main 已有失败 |
+| Desktop DB | 130 文件:122 通过、8 失败;1,869 测试通过、26 失败、6 跳过。8 个失败文件在 main 对照得到完全相同的 26 项失败 |
+| 源码与差异检查 | dev 验收期间 7,483 个源码文件哈希未变化;`git diff --check` 通过 |
+
+DB 层原命令触及 Windows `cmd.exe` 参数长度限制。使用临时适配脚本保留同一 manifest、前置检查、测试文件与排除项,直接由 Node 启动 Vitest,实际跑完全部 130 文件;没有删减测试。初始失败日志和完整参数保留。
+
+### main 对照失败
+
+对照 worktree 为 `D:/projects/cindy/.ab-worktrees/witty-feynman-main-5406`,detached HEAD 同为 `09de4092`。复跑失败文件并比较测试名称,不以“未改到这些文件”替代对照证据。
+
+- **6 项 Desktop unit**:`mobilePageAssets`、`skillSlot`、`botWorkbenchHandover` 的链接创建报 `EPERM`。已核对仓内使用 Windows junction 的跨平台测试写法;当前失败用例的目录链接未采用该写法,文件链接也不能直接替换为 junction。未扩大本修复范围去改插件/交接测试。
+- **2 项 maker-core**:`bot-own-skills-mount` 的技能枚举受本机已安装技能影响,实际列表超出测试预期;main 同样失败。
+- **6 项 guard**:`makerSendToSessionOrdering` 按源码字符串检查旧实现,与 main 当前实现不匹配;main 同样失败。
+- **26 项 DB**:测试夹具缺少 `list_preview` / `codex_plan_json` 等字段、路径分隔符及导入预期问题。失败文件见原始 `db-baseline-files.json`;逐项名称对照为一致。
+
+这 40 项仍应按既有故障处理,不能记成通过;本轮没有新增 skip 或弱化断言。
+
+## rebase 后真实 dev 复测
+
+使用 `pnpm restart:desktop:remote --region=global --isolated=@worktree --passive`,收到 `DESKTOP_DEV_VERDICT=ready`,沙盒 `witty-feynman-6e38a1`,测试 PID `46128`。正式版未重启,未使用正式 profile。测试期间普通模式无障碍开关为 false。
+
+| 关键路径 | 结果 |
+|---|---|
+| 浅/深主题 × 1280×800、960×640、1100×1000 | 480 次慢滚、快滚、反向滚动采样,0 可见占位空白、0 重叠;回底距离均为 0 |
+| 查找、全选、恢复 | 查找命中、正文全选、输入框全选、退出后恢复按视口挂载通过;逻辑消息 key 保持;切换任务后阅读锚点偏差不超过 2px |
+| 连续原生窗口缩放 | Win32 `SetWindowPos` 作用于真实客户区,120 次 resize、387 帧;AX 始终 false,离屏占位 50–54 行,0 可见占位、0 重叠;恢复尺寸后锚点偏移 0px |
+| 跨历史窗口定位 | 三尺寸共 6 次 qa5406-100 / qa5406-470 定位,加 6 次补充定位;目标正确,5 秒观察期末稳定,无可见占位。生产 `requestChatTaskFocus` 通道集成测试 |
+| 已加载范围内定位动画 | 从 store 验证目标已加载后,三尺寸双向共 6 次、每次超过 1,000px;实际观察到多个动画位置,稳定约 178–367ms;可见轨迹反向位移 0px,0 可见占位 |
+| 真实 OpenAI GPT-6-Luna 流式输出 | 451–480 共 30 节、9,517 字符、结束标记完整;73 次采样、15 次 AX 树读取;稳定回看 11 次采样期间锚点漂移 0px,回看总期间内容增长 732px;回底后继续跟随,结束距离 0 |
+| 变更文件卡片 | 双主题、两轮 5/7 文件,展开、离屏返回保留同一 DOM 与状态,48 次滚动采样无空白 |
+| 独立“本条消息生成的文件”列表 | 双主题 × 三尺寸,7 文件完整、无横向溢出;96 次离屏采样、展开状态、切换任务、刷新后唯一清单均通过 |
+| 本轮修改文件树 | 双主题 × 三尺寸,旧轮仅 5 个 note 文件、新轮仅 7 个 file-list 文件;逐项选中、切换任务后的范围正确 |
+| 大表格查找 | 双主题,横向滚动后命中可见且未被覆盖,逻辑窗口保持 |
+| 分享选择 | 当前逻辑窗口正文补齐,全选、滚动保持选择、取消通过 |
+
+跨历史窗口跳转的可见/稳定时间约 66–405ms,但新 main 的分页边界会使目标成为窗口首行,不能拿这组数据宣称动画或一般冷启动性能提升。上表单独记录了确认真实动画推进的已加载范围补测;没有做新的 main 性能 A/B。
+
+检查真实 `PrintWindow` 截图,浅色卡片、浅色文件列表和深色文件树未见内容缺失、重叠或截断。几何采样与关键截图不能证明物理屏幕每一刷新帧都没有闪动。
+
+## 边界与证据
+
+- 本轮完整测试指仓库 `test:all` 默认矩阵,加 DB 和上述 dev 关键路径;没有执行所有 manifest 中标为 manual 的 Git 集成、migration replay、真实 Codex 二进制 E2E 或 DB 性能层。
+- 原生窗口尺寸调整通过,但本轮没有重试鼠标拖动边框;上一轮 Windows 锁屏限制仍未解除,未覆盖系统拖拽 sizing loop。
+- 没有重新执行文件撤销/重做、分享图片导出/剪贴板、macOS、正式安装包、真实屏幕阅读器长期使用、50k 压力性能。
+- 原 #5406 现场转储仍缺失,因此不能宣称已证明并消除全部原始闪退原因。
+- 本轮测试 dev 已请求正常退出;最终进程/端口清理结果见产物 `cleanup.json`。
+
+全部原始日志、main 对照、JSON 轨迹、真实截图、备份与自包含手机报告:
+
+`C:/Users/User/AppData/Local/Temp/cindy-5406-rebase-final-eU1oig/REPORT.html`
+
+目录内 `SUMMARY.json`、`workspace-outcomes.json`、`db-baseline-comparison.json`、`unit-baseline-comparison.json` 对应上述结论。之前基线的报告保留,不能替代本轮证据。
diff --git a/apps/desktop/scripts/ax5406/FIX-VALIDATION.md b/apps/desktop/scripts/ax5406/FIX-VALIDATION.md
new file mode 100644
index 0000000000..17ec8bc471
--- /dev/null
+++ b/apps/desktop/scripts/ax5406/FIX-VALIDATION.md
@@ -0,0 +1,78 @@
+# #5406 修复与验证
+
+> 本文记录第一阶段“全部挂载、停用 auto”的方案。当前实现及验收以
+> [视口挂载验收](VIEWPORT-VALIDATION.md) 为准,下面的 236ms 不代表当前方案。
+
+2026-10-03,基线 `d656b0fc1ec3e04548cd018654cbd6486f6cf839`。
+
+## 改动
+
+`globals.css` 的 `.msg-stream-items > *` 改为 `content-visibility: visible` 和
+`contain-intrinsic-size: none`。MessageStream 所有已挂载的消息行都参与真实布局,
+移除已经实验证明参与 Blink AX 崩溃的跳过布局条件。
+
+没有关闭无障碍、修改 Electron 版本或改变崩溃退出策略。默认尾窗首帧最多挂载 80 个条目,
+锚点恢复另有首帧预算,滚动时按需扩窗;滚动锚点、尺寸缓存、分享与菜单的布局保护保留。
+改动无颜色/主题分支,对 Light/Dark 同样生效。Windows 的组件验收使用 Light,
+未做完整客户端、Dark 或 macOS 实机验收。
+
+历史定位:消息行 `content-visibility: auto` 来自 `902fe3cb6`
+(2026-08-09,`perf(chat): 视口外消息条目跳过布局绘制(content-visibility)`)。
+这说明优化的引入点,不把它单独当作 #5406 原现场引入版本的证明。
+
+## 原因链验证
+
+复用 [真实组件复现](COMPONENT-REPRO.md) 的同一入口、seed5407、80 条合成消息、
+每帧随机更新 8 条助手回复并滚动,AX 开启,不启用 UIA/CDP 查询:
+
+| 版本 | 实际行样式 | 运行结果 | 末次采样更新数 | 产物后缀 |
+|---|---|---|---|---|
+| 原版冻结构建 FHpmfo | auto | 52,042ms 再次命中三项签名 | 6,816 | h28Noq |
+| 当前修复源码构建 | visible | 120,332ms 正常结束,无 dump、无 JS 错误 | 10,008 | BwfjZy |
+| 当前修复构建,seed5406,全部消息更新,UIA + CDP | visible | 121,028ms 正常结束,无 dump、无 JS 错误 | 12,176 | q0hXxU |
+
+最后一轮额外覆盖原生 UIA 与 CDP:109 次完整 AX 树查询、最多观察到 10,197 个
+InlineTextBox、368 次原生文本范围查询,查询错误为 0。两轮修复实验累计 22,184 次文本更新。
+
+修复构建未使用 `--containment=off` 的实验注入覆盖;配置保持默认 `on`,
+实际 `visible` 来自生产 CSS,源码 SHA-256 与构建记录相符。
+旧版阳性对照确认故障依然可触发,避免把环境变化当作修复;崩溃时间受调度影响,
+不要求同 seed 每次在同一毫秒出现。此轮旧版运行期间还有类型检查,耗时不用于性能比较。
+
+旧版/新版两种构建均保留真实 MessageStream、AssistantMessage、UserMessage 和 MarkdownRenderer。
+完整 native 栈证据和实验限制见组件报告。120 秒有界压力验证不等于所有负载下永不崩溃。
+
+## 自动检查
+
+- Desktop 类型检查通过:`pnpm --filter desktop run --if-present typecheck`。
+- 定向单测 49 项通过,1 项既有 focused-only 50k 压测默认不运行:
+ `shareSelectionContainment`、`messageViewportCompensation`、`messageItemHeightCacheIntegration`、
+ `messageStreamRenderWindowIntegration`。
+- CSS 契约测试将旧的“保留 auto 优化”要求更新为新修复契约,并检查所有更具体的消息行选择器
+ 都不得恢复跳过布局;原有分享状态及嵌套 Bot 消息保护断言保留。
+- dump 三项签名解析器正反例测试、脚本语法检查及 `git diff --check` 通过。
+
+## 性能测量方法
+
+`benchmark-component.mjs` 交替运行冻结旧版/修复版,各三轮:200 条合成消息,
+实际挂载尾窗 80 条;每帧更新末条回复,不手动滚动;每轮 15 秒,AX 在两边均关闭,
+以免旧版在基准测试中崩溃。类型检查和单测已结束,六轮顺序运行。
+
+记录页面 `first-contentful-paint` 与 React 提交次数。前者包含独立 fixture 的模块、
+字体加载及首次挂载,**不是生产应用内的任务切换延迟**;后者只是该负载的更新吞吐,
+不能代替完整输入延迟或卡顿分位数。关闭跳过布局会增加已挂载的视口外内容布局工作量,
+有限窗口保留不等于零性能代价。
+
+| 指标 | 旧版三轮 | 修复后三轮 | 中位数变化 |
+|---|---|---|---|
+| fixture 首次内容绘制(ms) | 768 / 776 / 740 | 1004 / 1016 / 996 | 768 → 1004,增加 236ms |
+| 15 秒内 React 提交数 | 798 / 798 / 798 | 783 / 786 / 785 | 798 → 785,减少约 1.6% |
+| 实际挂载行数 | 80 / 80 / 80 | 80 / 80 / 80 | 有限窗口仍有效 |
+
+这项止崩修复有明确的首帧代价,不能写成“性能无影响”。本轮优先移除已证实的崩溃条件;
+后续若需要恢复首帧收益,应通过渲染窗口预算或经引擎修复验证的方案实现,不能直接恢复 auto。
+基准原始结果保存在系统临时目录 `cindy-ax5406-benchmark-ftjE7H/results.json`,
+各轮 profile 已清理,截图和计数有意保留。
+
+本次 Electron / UIA 实验进程全部退出。生产改动尚未提交、推送或发布;
+当前正在运行的已安装客户端不会因 worktree 源码修改自动获得此修复。
diff --git a/apps/desktop/scripts/ax5406/FOCUS-SCROLL-FIX.md b/apps/desktop/scripts/ax5406/FOCUS-SCROLL-FIX.md
new file mode 100644
index 0000000000..5430aba3cd
--- /dev/null
+++ b/apps/desktop/scripts/ax5406/FOCUS-SCROLL-FIX.md
@@ -0,0 +1,37 @@
+# 远距离消息定位回跳:修复与复测
+
+最终完整 dev 冒烟及真实窗口尺寸变化的追加结果见 [FINAL-DEV-SMOKE.md](FINAL-DEV-SMOKE.md),含鼠标拖边受锁屏影响而未验收的限制。
+
+2026-10-04,Windows / Electron 41.10.3。修复当前工作区的远距离定位结束时 272~416px 回跳;不据此宣称原始 #5406 AX 崩溃已全部修复。
+
+## 触发链
+
+原版 620×1000 追踪:`scrollIntoView({behavior:'smooth',block:'center'})` 发起时目标绝对顶部 14,370px。前序行由占位变为真实内容,目标位置依次增加 166、90、70、90px,共 416px;目标自身高度始终 330px。原生动画仍停在旧终点 `scrollTop=13,995`,目标顶部 791px。`scrollend` 后 `settleFocusJump` 瞬时居中至 `scrollTop=14,411`,目标顶部变为 375px,形成可见回跳。
+
+## 修复
+
+`animateFocusScroll` 按平滑曲线推进目标的视窗位置,每帧读取实际目标位置,并在同步挂载后的同一绘制前校准。保留 scroll-margin / scroll-padding 居中、减少动态效果、取消和目标删除后的既有补偿;动画期间的逐帧 scrollend 不提前触发收尾。数据加载与逻辑窗口数量不变。
+
+## 复测
+
+- 500 条合成消息,1280×800、960×640、620×1000 × 浅/深主题。完整截图轮 60 次操作、3,528 帧;轻量复测 60 次、3,487 帧。原复现路径六组均无有效轨迹反向跳变,首次出现 480~515ms,稳定落位 742~782ms。
+- 截图离线检查正文、占位、目标身份;无空白、丢失或重叠。最小正文对比像素 10,759;负对照检测正常。
+- 滚动交互:5,024 次几何采样、15 次定位,含滚轮、键盘、滚动条拖动、手动接管和异步内容/图片,0 项失败。
+- 流式输出:3 组、1,200 分块完整有序,517 个跟随绘制帧均包含尾部标记;离底阅读、恢复跟随正常。
+- 渲染层、preload 与相关 IPC 单测:1,408 文件、16,896 项通过,1 项跳过;Desktop 类型检查与 diff 检查通过。
+- 构建 393 个源文件哈希与实测源码一致;本次测试进程已退出。
+
+## 检测校准与范围
+
+### 后续 review 修复:首帧负进度
+
+首帧 rAF 时间戳可能早于 `performance.now()` 起点。进度现限制在 `[0, 1]`,避免向目标反方向起步。新增上下两个方向、0.2ms / 8ms 负时间差共 4 个用例:旧代码全部失败,修复后通过;定位动画、收尾、窗口和视窗渲染相关测试共 49 项通过。Electron 41.10.3 同一探针修复前 300 次中反向写入 7 次(4~11px),修复后 300 次中 0 次,且仍实际捕获 6 次负时间差。
+
+本项复测产物:`C:/Users/User/AppData/Local/Temp/cindy-5406-raf-fix-a7mllS/`。前述完整截图/全量单测是负进度修复前一版的记录;本项采用确定性回归及真实 Electron 定向复测。
+
+高亮圆角会遮住靠边色条,部分旧 6~8px 告警并非消息位移;扫描列已移出圆角。窗口边界被裁切且被文字遮住的色带端点,也不是实际行边缘;轨迹检测用暴露边缘判定,仍保留 4px 阈值。同一判据仍检出旧版 416px 回跳。完整截图的原始 audit 保留一条边界误报,`trajectory.json` 记录复核;修正后的独立轻量轮直接 60/60 通过。
+
+实际 MessageStream 构建与 Electron 原生绘制,不是完整 dev / 网络数据加载验收。回调约 30fps,不能保证覆盖物理显示器每次刷新;未重测 macOS。
+
+本机完整报告、原始帧、追踪、单测日志及手机适配单文件 HTML:
+`C:/Users/User/AppData/Local/Temp/cindy-5406-focus-fix-2dSS3x/REPORT.html`。
diff --git a/apps/desktop/scripts/ax5406/FULL-ACCEPTANCE.md b/apps/desktop/scripts/ax5406/FULL-ACCEPTANCE.md
new file mode 100644
index 0000000000..338ef96cc8
--- /dev/null
+++ b/apps/desktop/scripts/ax5406/FULL-ACCEPTANCE.md
@@ -0,0 +1,87 @@
+# #5406 全量回归验收(2026-10-04)
+
+> 后续两项 P1 修复与重新验收见 [P1-ACCEPTANCE.md](./P1-ACCEPTANCE.md),本文件保留前一轮证据。
+
+基线 `25388846915a9640341c4de5feb804b3a948c8f2`,Windows Electron 41.10.3,
+当前 worktree 的未提交代码。本文汇总本轮重新执行的结果,不复用旧轮次数字作为新证据。
+
+**结论:下列功能验收项通过;额外开启的 50k 本机性能基线测试不稳定,不能声称所有检查全绿。**
+原 issue 的 0.1.96 原始转储仍缺失,不能以有界测试证明其所有闪退原因都已排除。
+
+## 为什么会涉及变更卡片
+
+普通消息和变更卡片共用 `MessageStream` 的 render-item 构建、历史窗口、滚动定位及高度补偿。
+正文按视口挂载虽保留复杂卡片,但不能因此省略卡片回归。
+实际发现的卡片消失是历史分支 `renderHistoryView.build` 漏传 `turnChangeSets`;普通分支已传。
+此遗漏在当前 main 也存在,不是 `content-visibility` 变更直接造成。
+已有修复仅补传数据,沿用既有卡片归属、分页和操作逻辑;本轮重新验证该修复。
+
+## 本轮执行清单
+
+| 验收项 | 层次与结果 |
+|---|---|
+| 慢滚、快滚、反向滚动 | 完整 dev,Light/Dark × 1280×800、960×640、1100×1000,480 次采样,0 可见占位、0 重叠 |
+| 加载历史与渲染分离 | 完整 dev,500 条逻辑历史可载入;双主题新建 100 条夹具,搜索前后均 40 行,手动上滚首行从 boundary-60 到 boundary-0 |
+| 上一条提问与回底 | 六组均命中可见提问;回底距离均 0 |
+| 切换任务恢复阅读位置 | 双主题,恢复同一消息且偏移不超过 2px;恢复后的可见回底按钮可用 |
+| 页内查找与关闭 | 双主题,尾窗 80 行及分页边界 40 行,查找 1/1,逻辑 key 不变,关闭恢复占位,无可见空白 |
+| 输入框及正文全选 | 输入框 Ctrl+A 不扩大挂载;BODY Ctrl+A 补齐 80 行,36,804 字符,所有消息标签存在 |
+| 分享选择 | 完整 dev,进入时补齐正文,全选、滚动后保留选中、取消通过;不操作系统剪贴板或导出 |
+| 真实模型普通输出 | Codex/OpenAI GPT-6-Luna,361–390 共 30 节完整,105 次采样无可见空白,21 次 AX 读取,结束距底 0 |
+| 真实模型输出时回看卡片 | 46–60 共 15 节完整;52 次采样无可见空白;阅读期高度增长 523px,9 次卡片顶部均 415.125px,回底后继续跟随 |
+| 变更卡片显示与状态 | 双主题,默认 3 文件→展开 5 文件;离屏保留同一 DOM 与展开状态,重载后仍有且只有一张卡片 |
+| 差异面板 | 双主题,note-5.txt 旧/新第 2 行可见,整轮 +5/-5 |
+| 撤销 / 重新应用 | 只操作先前创建的临时 Git fixture;5 文件撤销后恢复旧文,重新应用后逐文件与操作前完全一致 |
+| 键盘、滚动条、程序化跳转 | 真实组件 Electron,1000 条,三尺寸,4,699 次逐帧采样,0 空占位、0 重叠;15 次搜索命中,接管/回底/拖动检查通过 |
+| 异步增高、图片、长消息展开 | 真实组件 Electron,图片实际解码、阅读位置、离屏展开状态、重挂载、追加消息、双主题宽窄切换全部通过 |
+| 合成流式逐帧绘制 | 真实组件,三尺寸,共 1,200 有序分片,2,709 次几何采样,0 空占位/重叠;587 个跟随绘制帧标记均存在,178 次补偿后检查无离底;29 帧离底反例有效 |
+| 原生 AX 压力 | 121 秒、15,832 次文本更新、223 次 CDP、1,212 次原生查询,无崩溃/dump;动态节点上 39 次模式不可用保留为限制 |
+| Renderer 全量自动测试 | 最终 1,398 文件、16,838 项通过,1 项默认跳过的 50k 压测另跑,见下文 |
+| 类型及其他门禁 | Desktop typecheck、dump 签名解析器、文档合同 10 项、git diff --check 通过 |
+
+普通模型输出那轮阅读阶段没有观察到内容增高,不能单独证明“持续输出时保持阅读位置”;
+该条件由同轮的真实卡片流式测试(523px 增高)及合成逐帧流式测试覆盖。
+
+## 全量重跑暴露的测试问题
+
+1. Renderer 初跑 1 项失败:`historyViewportCompensation.test.ts` 执行生产滚动回调时缺少
+ 新增的 `focusJumpRef` 绑定。补入空闲引用后 10 项定向断言通过,再完整重跑 Renderer 全部通过。
+ 没有删除断言或修改生产行为。
+2. 旧 `visual.cjs` 两轮报异步图片锚点变化和搜索未命中。脚本在固定 450ms 后即继续操作,
+ 实际仍在平滑导航:新记录显示搜索目标约 1074ms 才进入视口、1830ms 完成稳定检查。
+ 图片插入也与导航重叠。改为与增强滚动测试一致的 3 秒有界落点检查,记录每 50ms 的
+ 位置并要求连续稳定;图片高度/阅读锚点、目标可见等原断言保留。最终全部通过。
+3. 完整客户端初轮窄窗导航前,鼠标仍在底部按钮区域,滚轮未进入消息列表,缺少上一提问入口。
+ 修正操作目标后,六组完整重跑通过;初轮中断不计通过。
+
+## 50k 性能告警
+
+原用例阈值为旧本机基线 13ms × 1.2 = 15.6ms,本轮显式开启,初跑 18.55ms、复跑 19.68ms 失败。
+追加同机交替对照,main 使用 Vite 插件只读载入 `git show HEAD:.../MessageStream.tsx`,
+没有覆盖工作区、调整阈值或删除断言:
+
+| 版本 | 三轮中位耗时(ms) | 三轮的中位数 |
+|---|---|---:|
+| 当前代码 | 17.76(失败)/ 13.54 / 14.13 | 14.13 |
+| 未修改 main | 16.79(失败)/ 14.35 / 18.61(失败) | 16.79 |
+
+两版均有超线,当前证据不能归因为本次改动的性能回归;也不能把有失败的性能项写成稳定通过。
+默认 100–5000 条性能断言已包含在全量 Renderer 通过结果中。这不是整机启动性能的新基准。
+
+## 证据与边界
+
+完整客户端脚本、JSON、原始日志、截图与视频:
+`C:/Users/User/AppData/Local/Temp/cindy-5406-full-vcptfx/`。
+`acceptance.html` 自包含报告;`card-full.mp4` 为本轮真实窗口连续录像,41.3 秒、20fps,非截图拼接。
+
+本轮组件产物(同为当前生产源码,关键源文件哈希核对一致):
+
+- `cindy-ax5406-1I3ulv`:增强滚动;
+- `cindy-ax5406-wSkOfi`:流式绘制;
+- `cindy-ax5406-t1bv63`:完整视觉;旧失败保留在 `bCA5pZ` / `lqrpfG`;
+- `cindy-ax5406-RgXeBZ`:AX 压力。
+
+未覆盖 macOS、Mobile、正式安装包、长时间真实读屏使用、所有复杂工具卡的业务操作,
+以及缺失的原 issue 现场转储。窗口尺寸是 CDP 视口模拟,不是原生窗口边框拖动。
+分享测试覆盖选择/挂载与取消,未把图片导出或跨设备分享列为已验收。
+验收仅动隔离 profile 和临时 fixture;无提交、推送或发布。
diff --git a/apps/desktop/scripts/ax5406/JUMP-PAINT-VALIDATION.md b/apps/desktop/scripts/ax5406/JUMP-PAINT-VALIDATION.md
new file mode 100644
index 0000000000..f921dae3bb
--- /dev/null
+++ b/apps/desktop/scripts/ax5406/JUMP-PAINT-VALIDATION.md
@@ -0,0 +1,59 @@
+# 跳转延迟与实际绘制补测:未全部通过
+
+> 后续:272~416px 回跳已定位并修复,见 [FOCUS-SCROLL-FIX.md](./FOCUS-SCROLL-FIX.md)。本文件保留发现问题时的记录;其中部分 6~8px 告警已证明是检测色条受圆角/裁切遮挡造成的误报。
+
+2026-10-04,Windows / Electron 41.10.3。仅新增验收脚本,没有修改产品代码。
+
+## 结论
+
+直接跳转的目标出现及位置稳定时间中位数 39ms、P95 66ms、最大 118ms。未捕获到空白占位、整片空白或目标到达后消失,最终落点均正确;但远距离消息定位会先滚过最终位置,再反向校正 272~416px。这是用户可见的位置跳变,不能判定全部验收通过。
+
+此前“最终位置正确”的检查不足以证明跳转过程中没有跳变,本次增加实际绘制轨迹检查后发现了这个遗漏。
+
+## 轻量探针数据
+
+每组 500 条合成消息,1280×800、960×640、620×1000,各浅/深主题;共 60 次跳转。每个场景等待 1 秒(直接跳转)或 2.6 秒(定位/回到底部),保留后续稳定观察。
+
+| 场景 | 次数 | 目标首次进入画面,中位数 / P95 / 最大 | 最终位置稳定,中位数 / P95 / 最大 |
+|---|---:|---|---|
+| 直接跨屏跳转 | 24 | 39 / 66 / 118ms | 39 / 66 / 118ms |
+| 消息定位,含平滑滚动 | 18 | 390 / 1,016 / 1,016ms | 390 / 1,880 / 1,880ms |
+| 回到底部,含平滑滚动 | 18 | 284 / 1,106 / 1,106ms | 284 / 1,543 / 1,543ms |
+
+首次进入画面不等于整条消息全部可见,长消息可能超过视窗;这里验证视窗内实际绘制的正文及正确目标。稳定时间回溯到最后一次位置变化后的首个绘制帧,不把额外稳定观察时间算进延迟。时间包括触发、挂载、布局、绘制回调交付和平滑动画,与之前 18ms 的平均 CPU 工作时间不是同一指标。
+
+## 新发现:远距离定位结束时反向跳变
+
+复现路径:在 500 条已加载消息中直接跨屏浏览,定位 synthetic-430,回到底部,定位逻辑窗口外的 synthetic-100,再回到底部,最后定位 synthetic-470。
+
+最后一次定位在六种尺寸/主题组合全部重现:1280×800、960×640 回调约 272px,620×1000 回调约 416px。完整截图与不保存截图的轻量探针均重现。另在三组回到底部中观察到 6~8px 的微小反向修正,也如实保留,不混为全部无漂移。
+
+真实相邻帧例子:620×1000 浅色中,synthetic-470 的可见色带顶端从约 797px 突然跳到约 381px,间隔约一帧。报告 HTML 内嵌了原始帧浏览器。
+
+源码核对发现 MessageStream 的 settleFocusJump 在 smooth 结束后调用不带 smooth 的 scrollIntoView({block:'center'}),并在后续 rAF 再次校正。该路径与观察到的末尾回跳吻合;尚未追加调用栈/高度变化追踪,不能据此声称已经完整证明根因。下一步应核对挂载期间的高度变化为何使动画目的位置失准,以及落定校正如何避免可见回跳。
+
+## 绘制证据与范围
+
+- 完整截图轮:60 次操作,3,531 个原生绘制回调交付帧全部保存,没有按“有趣程度”抽帧;离线解码检查色带、占位及正文像素,最低正文对比像素 10,830,未见空白或目标消失。
+- 轻量轮:另外 60 次相同操作,3,487 帧;不做 PNG 编码/落盘,仅读取两列色带,重现相同大幅回跳。最大相邻回调间隔仍有 311ms,因此不能把所有间隔都归因保存截图,也不能把原生回调间隔直接等同物理屏幕停帧。
+- 负对照主动显示占位色、隐藏整片消息,两个检测均成功。色带由 CSS 背景图实现,不改变尺寸、不启用 content-visibility、不修改产品逻辑。
+- 实际接收帧约 30fps,包含更长间隔。这覆盖回调交付帧,不保证覆盖显示器每次刷新;不能声称绝无未捕获的单帧闪动。
+- 跳转后最终目标/尾部正确,观察期内最终位置稳定。但“最终正确”不抵消中间回跳的验收失败。
+- 使用真实 MessageStream 的已核验构建与合成数据,含数据已加载的跨逻辑窗口定位;没有模拟数据库/网络加载等待,没有启动完整 dev,没有重测原始 AX 崩溃或 macOS。
+
+## 探针校准与保存记录
+
+初版标记使用背景色,触发了行背景色过渡:正文已出现仍残留标记。改用不可插值的背景图后消除仪器误报。初始相近颜色也会被文字抗锯齿误识别,改为通道间隔 28 的离散色表及固定两列读取。
+
+完整截图轮原始 audit 有两例“目标未出现”的仪器判定:目标仅在顶部露出 4px,像素数量小于原门限。保留原始 audit,使用同一组 PNG 重算,识别实际存在的边缘色带;没有改写像素或产品行为。随后轻量轮直接使用修正后的判据。进一步轨迹检查发现真实回跳,最终 RESULT.json 按未通过记录;不能使用原始只检查最终位置的 passed 字段宣称整体通过。
+
+## 产物
+
+- 根目录:C:/Users/User/AppData/Local/Temp/cindy-5406-jump-paint-j5S666。
+- RESULT.json:最终判定、轻量耗时及每例轨迹异常。
+- verified/audit.json、verified/analysis.json、frame-*.png:完整原生帧与离线分析。
+- light/audit.json:轻量绘制数据。
+- 脚本:apps/desktop/scripts/ax5406/jump-paint.cjs,已加入反向跳变断言。
+- 被测构建:C:/Users/User/AppData/Local/Temp/cindy-5406-index-rU5lEn/current;392 份 renderer 源文件已核对一致。
+
+产品修复尚未进行,未提交、未推送。测试 Electron 实例已退出。
diff --git a/apps/desktop/scripts/ax5406/MAIN-COMPARISON.md b/apps/desktop/scripts/ax5406/MAIN-COMPARISON.md
new file mode 100644
index 0000000000..79bc7e1f3b
--- /dev/null
+++ b/apps/desktop/scripts/ax5406/MAIN-COMPARISON.md
@@ -0,0 +1,86 @@
+# #5406:当前改动与 main 的性能、显示和稳定性对比
+
+日期:2026-10-04。Windows / Electron 41.10.3 / Chromium 146.0.7680.216。
+
+## 结论
+
+当前方案减少了消息正文挂载量,改善进入任务的速度与内存占用,已测滚动、流式输出和窗口尺寸下没有新增显示缺损;代价是滚动到未挂载正文时需要重新构建组件,滚动主线程开销高于 main。它是稳定性、进入速度和内存方面的改进,不是所有操作都更快。
+
+## 稳定性对照
+
+另起独立 Electron,启用原生 AX 和正文完整挂载,80 条相同消息、seed5407、每帧随机更新 8 条并周期滚动,目标各 120 秒;两版都没有调用 CDP / UIA 文本查询。这是压力负载,不是日常模型 token 输出。
+
+| 版本 | 结果 | 最后采样的正文更新数 |
+|---|---|---:|
+| main | 13,433ms 后渲染器崩溃,转储匹配此前记录的 #5406 签名 | 2,352 |
+| 当前版 | 完成 120,211ms,无崩溃、无转储、无组件 JS 错误 | 14,912 |
+
+main 转储:`0x80000003`,`electron.exe+0xA332D17`,PDB `D4DDA3CA101D876E4C4C44205044422E1`;报告判定 `matched-5406`。本次仅重新核对异常码、模块 RVA、PDB 签名,未重新展开完整原生栈。此前完整栈分析见 `COMPONENT-REPRO.md`。
+
+main 证据:`C:/Users/User/AppData/Local/Temp/cindy-ax5406-QyadzP/report.json`;当前版证据:`C:/Users/User/AppData/Local/Temp/cindy-ax5406-j9xSvf/report.json`。当前版末次仍完整挂载 80 条,证明未靠关闭 AX 或隐藏读屏文本来通过本组压力测试。
+
+**判断:本机已复现的触发链在当前方案下未再触发。** 原 #5406 的 0.1.96 原始现场转储仍缺失,120 秒对照不能证明所有生产闪退原因都已排除。
+
+## 改了什么
+
+1. **用正文按视窗挂载替代消息行 `content-visibility: auto`。** 正常布局避开已复现的 Blink 无障碍文本序列化断言;视窗上下预留 600px,离屏正文用缓存高度占位,未测量时估高 240px。默认逻辑尾窗仍是 80 个渲染条目,数据库分页规则未改。
+2. **补齐滚动协调。** 尺寸变化、异步增高、历史恢复、流式跟随、回到底部、上一条提问及搜索跳转统一保留阅读锚点;程序滚动及时挂载目标,避免先画出空白占位。历史分页投影保留变更卡片信息。
+3. **保留交互内容。** 变更卡片、文件清单等非普通消息条目,以及正在操作的正文保持挂载;分享、选择、键盘遍历和查找需要时补齐当前逻辑窗口正文,不以此额外加载历史。
+4. **修复 review 的两个 P1。** 查找命中先展开消息内横向/纵向滚动容器,再交给外层消息导航;增加 main → preload 的只读无障碍状态桥,初始开启及运行中开启读屏时恢复完整正文挂载,保持阅读位置。主窗口和独立侧栏均覆盖。
+
+本轮只增加对照测试与报告,没有继续修改产品源码,没有提交或推送。
+
+## 对照环境
+
+- 当前:`D:/projects/cindy/.cindy-worktrees/witty-feynman`,HEAD `25388846915a9640341c4de5feb804b3a948c8f2` + 工作区改动。
+- main:`D:/projects/cindy/.ab-worktrees/witty-feynman-main-5406`,从刚 fetch 的 `origin/main` 创建 detached worktree,commit 同上。main 已在其他工作区检出,故使用固定提交快照,未移动其分支。
+- 独立安装依赖;两版生产源码分别构建,没有把修复文件覆盖到 main。main 只加入相同的未跟踪测试脚本。构建输入哈希确认差异仅为本次消息渲染相关文件。
+- 完整客户端通过规定启动入口运行,两个全新隔离 profile,各写入相同的 500 条合成消息;未复制正式账户、数据库或凭证。两份 dev 都获得 `DESKTOP_DEV_VERDICT=ready`。
+
+## 性能结果
+
+组件基准:真实 MessageStream 及依赖图,合成消息,未压缩独立构建;500 条相同输入、初始逻辑尾窗 80 条;三种视窗尺寸,每版每尺寸 3 次,交替顺序 main→当前 / 当前→main,共 18 次独立 Electron 运行。性能组关闭 AX,两版条件一致;稳定性组另外启用 AX。以下均为对应三次的中位数。
+
+| 指标(1280×800) | main | 当前版 | 变化 |
+|---|---:|---:|---:|
+| 消息区就绪 | 533.9ms | 440.4ms | 减少 17.5% |
+| 初始正文挂载 | 80 | 5 | 减少 93.8% |
+| 消息区后代 DOM 节点 | 1,789 | 292 | 减少 83.7% |
+| GC 后 renderer JS 堆 | 29.26MiB | 24.58MiB | 减少 16.0% |
+| 180 次流式追加的主线程累计任务耗时 | 1,494ms | 1,389ms | 减少 7.1% |
+| 100 次大幅跳滚的主线程累计任务耗时 | 824ms | 1,878ms | 增加 127.9% |
+| 跳滚循环 P95(每次主动等待两帧) | 33.9ms | 33.6ms | 此负载下接近 |
+
+三尺寸就绪时间 main→当前:960×640 为 545.6→414.3ms;1280×800 为 533.9→440.4ms;1600×900 为 548.1→446.5ms。三尺寸 JS 堆均下降约 16%–18%;大幅跳滚主线程开销均增加。
+
+完整 dev 客户端:1280×800,先首次打开,再重复六次在空任务与 500 条消息任务之间切换。两版对应轮次逻辑条目完全一致,依次为 40、60、80、100、120、140、160;当前版均只挂载 5 条正文。这种重开扩窗行为两版一致,不是本次修改引入。
+
+| 实际客户端操作 | main | 当前版 |
+|---|---:|---:|
+| 首次打开(单次) | 1,195ms | 526ms |
+| 后续六次切换中位数 | 801.5ms | 304.2ms |
+| 每组 40 次普通滚轮输入的主线程累计耗时,中位数 | 2,374ms | 3,105ms |
+
+完整 dev 的切换中位数减少约 62%,普通滚轮主线程耗时增加约 31%。两版分别顺序运行,未做多次交替重启;因此这组是本机实测观察,证据强度低于上面的交替组件基准。普通滚轮的历史窗口在两组窄窗口场景有不同扩展过程,不能将 31% 全部归因于虚拟化;固定输入的组件跳滚基准仍明确显示额外 CPU 成本。
+
+**口径:**“就绪”指目标正文可用后再等待两次 rAF,不是 FCP,不是应用冷启动,也不含模型响应时间。JS 堆不是整个应用 RSS。主线程累计任务时间不是单次操作延迟;两帧测试循环不是实际 FPS,不能据此保证低配置设备没有掉帧。
+
+## 显示与内容完整性
+
+- 组件组 18 次运行,共 5,040 次几何采样,无可见占位空白或重叠;每次 180 个流式标记均完整、有序,完成后距底 0;搜索目标跳转可见。
+- 完整 dev:Light / Dark × 960×640、1280×800、1600×900 × 两版,共 12 组、480 次滚动输入及采样,无可见占位空白或重叠、无 pageerror。
+- 同一内容区域截图对比:五组 RGB 通道差异 >8 的像素数为 0;浅色 1280 组为 70 / 542,300(约 0.013%)。区域坐标、原图及统计保留。目检浅色 1280 与深色 960 的两版真实客户端截图,未见内容缺失或布局错位。这不是所有瞬间画面的逐帧等价证明。
+- 此前同一源码的变更卡片、回复末尾文件清单、右侧“已修改文件”、预览、流式阅读、查找/选择和读屏桥接回归结果仍有效,见 `P1-ACCEPTANCE.md`、`FILE-LISTS-ACCEPTANCE.md`;这些专项不冒充本轮重新执行的 A/B 项目。
+
+## 风险与建议
+
+保留当前方案:它避开可复现的原生崩溃触发条件,改善进入速度及正文资源占用,已测显示行为没有回归。下一步性能优化应聚焦滚动时重新挂载和同步测量的成本,并保留现有空白、锚点与流式跟随验证;不建议为省这部分 CPU 恢复已能复现崩溃的 `auto`。
+
+启用读屏、查找/选择等完整正文模式时,资源收益会缩小或消失,这是文本可访问性所需的回退。未测试 macOS、正式安装包、真实 NVDA/VoiceOver 长期使用和低配置设备。窗口变化通过 CDP 设置视口。本次没有重新执行 50k 边界性能测试;此前两版都有门槛波动的记录仍有效,不能称所有性能门禁全绿。
+
+测试准备曾遇到调试接口过早启用导致等待、首次协议确认导致数据库尚未就绪;修正测试脚本后重新采集,相关无效尝试未纳入正式数字。性能组三轮全部完成,未删除慢样本。
+
+证据根目录:`C:/Users/User/AppData/Local/Temp/cindy-5406-ab-tn4zig7u/`。关键文件:`perf-all.json`、`perf-summary.json`、`dev-main.json`、`dev-current.json`、`dev-summary.json`、`source-inventory.json`、`build-differences.json`、`pixel-comparison.json`。截图仅保存在临时证据目录。
+
+
+本轮启动的两份 dev 与独立 Electron 测试进程均已退出;main 对照 worktree 保留供复核。
diff --git a/apps/desktop/scripts/ax5406/NAVIGATION-VALIDATION.md b/apps/desktop/scripts/ax5406/NAVIGATION-VALIDATION.md
new file mode 100644
index 0000000000..8949a7878a
--- /dev/null
+++ b/apps/desktop/scripts/ax5406/NAVIGATION-VALIDATION.md
@@ -0,0 +1,144 @@
+# #5406:搜索与程序化滚动的继续定位
+
+2026-10-03,Windows,Electron 41.10.3;延续 `SCROLL-VALIDATION.md`。
+测试仍是实际 MessageStream 组件图、实际样式、合成消息、独立 Electron/profile,
+不是整个已安装客户端,也没有原 issue 的现场转储。
+
+## 取得的证据
+
+诊断脚本在隔离窗口中记录 scrollTop、scrollTo、scrollIntoView 的参数、调用栈、
+时间、目标几何,以及 scrollend。记录原样保存在每轮 `scroll-audit.json.writes`。
+生产代码没有安装这些诊断用浏览器方法包装器;下文新增的 scrollTop 观察器只作用于
+当前消息容器实例,不记录日志,也不修改全局 DOM 原型。
+
+1. 搜索滚到逻辑窗口顶部时,`handleScroll` 原先只为 chip 导航抑制扩窗,
+ 不为 focus 搜索抑制。扩窗的历史位置恢复会改写搜索位置和滚动代次。
+ `XvcJwm`、`sxTmId` 和 `zZvOSR` 的第一条搜索记录可见该链。
+2. 搜索重建的窗口恰好覆盖消息末尾时,coverage effect 可把窗口被动钳制到底部
+ 当成恢复跟随,随后 layout effect / ResizeObserver 执行 pinToBottom。
+ `M1qO5e` 在 760px 窗高、目标 490 上记录了紧跟搜索调用的 pinToBottom 写入。
+3. 搜索的 scrollend 与通用 scrollend 收尾共享一个滚动代次;后者原先只检查 chip,
+ 会提前结束仍由 focus 拥有的代次。延后搜索校准的对照 `WolJVa` 因此没有实际执行校准。
+4. 一次校准还不能保证最终位置。`B8zTdv` 的目标 420 在校准后又被浏览器推进;
+ `jOqT4X` 的同类记录明确显示:34,846 → 90,552(校准)→ 93,395(无 JS 写入的晚到位移)
+ → 90,552(稳定期再次校准),目标回到视口内 222px。
+5. 回底仍有独立闪空路径。`egergR` 记录 layout pin → hook 旧阅读锚点还原 →
+ smooth 回底 → ResizeObserver 再次 pin;最后一跳没有同步挂载目标正文。
+ `jOqT4X/paint-620x1000-dark-jump-button-1.png` 是该问题实际绘制出的空白帧。
+
+这些是滚动验收发现的问题,不能把它们称作原生 AX 崩溃的根因。
+
+## 保留的修正
+
+- 搜索在重建窗口之前解除自动跟随;搜索过程中不因到达顶部自动加载更早历史。
+- 正在程序化导航时,不因历史窗口覆盖末尾而恢复自动跟随。
+- 通用 scrollend 不抢先结束搜索拥有的滚动代次。
+- 等待待处理布局后校准搜索,并在短暂稳定期内继续核对位置;连续三帧无需调整后结束,
+ 最多八次核对。每帧检查原搜索是否仍持有控制权;用户接管、新搜索、卸载会中止旧校准。
+- 程序化回底、搜索校准和摇杆滚动主动同步挂载目标区域,不只等待异步 scroll 事件。
+- 旧阅读锚点不能覆盖新发生的贴底意图。layout 内的 pin 使用 React 的同步 layout 更新;
+ observer / 输入回调内的 pin 显式完成正文提交,避免先滚位置后补正文。
+
+没有停用生产代码的 `overflow-anchor`,没有修改浏览器线程滚动开关。
+
+## 没有作为修复依据的实验
+
+- 全程停用 anchoring 的 `EuBsgZ` 搜索通过,但它也改变了之前滚动的窗口和起点,
+ 不足以单独证明 anchoring 是根因。
+- 仅搜索期间停用的 `sxTmId` / `zZvOSR` 仍失败,且暴露更多顶部扩窗冲突;该改动已撤回。
+- 把落定 scrollIntoView 换成 scrollTo 的 `M1qO5e` 仍失败。
+- 关闭 threaded scrolling 的 `MAv6xI` 仍有搜索失败;没有采用此浏览器开关。
+- `scroll-race.cjs` 的纯 DOM 简化页没有复现晚到偏移。引擎内部产生那次位移的具体路径
+ 尚未确定;当前修正针对已证实的应用控制权冲突和可测量的最终落点。
+
+## 验证边界
+
+增强脚本包含三种窗口尺寸、Light / Dark、慢滚、快滚、反向滚、真实滚动条拖动、
+Home / End / PageUp / PageDown、五次搜索、搜索中途滚轮接管、回底、正文增长、图片及追加消息。
+高速和回底阶段保存真实 Electron 绘制帧;稳定搜索落点另有原图截图。
+
+上一阶段每帧直接绕过组件写 scrollTop 的强制跳跃仍保留为独立失败项。它可以在浏览器下一次
+scroll 事件之前绘制占位。组件自身新增了同步挂载入口,不等于任意外部 DOM 写入都受保护。
+当时未删除该断言,也未将完整矩阵标为全部通过。继续定位与修正见文末。
+
+## 上一阶段源码复测结果(逐帧强制跳转尚未修正)
+
+三轮均使用冻结构建 `vBFkIc`,三个生产文件的 SHA-256 与该阶段工作区逐项一致。
+所有轮次均保留默认 anchoring、默认 threaded scrolling、默认 settlement,未开启诊断改写。
+
+| 产物 | 消息数 | 总采样 | 非强制脚本采样 | 空占位 / 重叠 | 搜索命中 | 强制脚本空帧 |
+|---|---:|---:|---:|---|---|---:|
+| `vBFkIc` | 500 | 5227 | 4867 | 0 / 0 | 15 / 15 | 177 |
+| `qghd2o` | 500,重复 | 4937 | 4577 | 0 / 0 | 15 / 15 | 177 |
+| `mWqmDd` | 1000,seed5408 | 4450 | 4089 | 0 / 0 | 15 / 15 | 177 |
+
+合计 14,614 次采样,其中非强制脚本 13,533 次,未检测到空占位或重叠;45 次搜索均命中。
+三轮的回底、搜索中途滚轮接管、静止阅读和滚动条实际位移检查均通过,没有 JS 错误或原生崩溃。
+实际绘制帧目检包含搜索前后对照、回底第一帧和快滚/拖动。此证据不等于完整安装版验收,
+也不保证所有硬件/负载下绝无闪动;强制脚本的 531 次空帧仍使三轮均返回 `visual-failed`。
+
+定向测试 10 文件、190 项通过;Desktop 类型检查及 `git diff --check` 通过。
+本轮启动的隔离 Electron 均已退出,测试 profile 已回收。源码没有提交、推送或发布。
+
+单文件图集:`C:/Users/User/AppData/Local/Temp/cindy-ax5406-mWqmDd/navigation-report.html`。
+图集嵌入未经编辑的真实测试窗口截图,包含修正前的错误落点/实际空白帧和修正后的对应画面。
+
+## 继续定位:rAF 直接写位置的空白与回弹
+
+直接在 rAF 内写 scrollTop 时,浏览器可能先绘制新位置,下一轮才派发 scroll 事件。
+仅靠 scroll 监听无法保证目标正文在这一帧存在。新增的 `observeProgrammaticScroll`
+观察当前容器实例的赋值,在当前调用栈结束后的微任务中同步提交正文。
+原生 setter 仍执行(包括未改变数值的赋值,以保留取消 smooth 的语义),同一调用栈
+多次写入合并一次通知;卸载取消待处理通知并还原属性描述符。
+
+提前提交还暴露了协调问题,不能仅凭“没有空白”验收:
+
+- `Kmgv08` / `KOMo0q` / `K74klR` 的旧断言返回通过,但跳转阶段位置几乎不变。
+ 因此这三轮不算修复证据。
+- 增加实际位移跨度至少 1000px、至少 20 个不同落点的断言后,`fGn8uP` / `D9MwHX`
+ 在三个尺寸均失败,证明新断言能识别“被还原,因此没空白”的假通过。
+- `D9MwHX` 在第一个尺寸记录 22,943 → 0 → 22,943,以及 22,941 → 8,710 → 22,941。
+ 回写栈为 `MutationObserver → compensateMessageHeight → restoreViewportSnapshot`,
+ 在原生 scroll 事件更新阅读位置之前,正文挂载触发的 DOM 变化被按旧快照补偿。
+- 修正为微任务内先调用现有 `handleScroll`,更新滚动控制权及快照保存调度,再提交目标正文。
+ 不制造合成 DOM scroll 事件,不另造第二套跟随规则;后续原生事件仍走原处理路径。
+- hook 的阅读锚点同时记住捕获时是否跟随及是否贴底;旧的跟随标记不能吞掉已经离底的
+ 直接写入,新的回底意图仍可覆盖旧阅读锚点。
+
+单测覆盖直接写入早于 scroll 事件、MutationObserver 旧快照竞争、旧跟随标记和新回底意图,
+以及赋值合并、原生钳制、零位移 setter、卸载恢复和后续属性包装者兼容。
+
+## 当前最终源码复测结果
+
+三轮均使用冻结构建 `3leMEg`,MessageStream、viewport hook、scrollTop 观察器和
+globals.css 四个生产文件的 SHA-256 已与工作区核对一致。
+仍使用默认 anchoring / threaded scrolling / settlement,AX 开启;无诊断行为改写。
+
+| 产物 | 消息数 | 全部采样 | 空占位 / 重叠 | 搜索命中 | 强制跳转采样 | 退出状态 |
+|---|---:|---:|---|---|---:|---|
+| `3leMEg` | 500 | 5206 | 0 / 0 | 15 / 15 | 360 | completed-no-crash |
+| `stKf4b` | 500,重复 | 5277 | 0 / 0 | 15 / 15 | 361 | completed-no-crash |
+| `c2a2j1` | 1000,seed5408 | 4466 | 0 / 0 | 15 / 15 | 361 | completed-no-crash |
+
+合计 14,949 次采样,强制跳转阶段 1,082 次;540 次跳转请求均完成其循环,
+九个跳转阶段都通过位移跨度及不同落点数量检查,45 次搜索均命中。
+所有阶段未发现空占位或重叠;回底、用户接管、静止阅读及实际拖动检查通过。
+挂载正文数量为 2–11 条,未启用全量挂载绕过。没有 renderer console error、JS 错误或原生崩溃。
+
+本次还保存了 772 张真实 Electron 绘制帧,目检了强制跳转、回底第一帧、搜索和滚动条拖动
+的代表截图(含 Light / Dark),未见此前的大面积空白。几何采样与截图目检不能等同于
+每次显示器刷新逐像素验收;仍未做整个安装版客户端或 macOS 验收。
+198 项定向单测通过,Desktop 类型检查通过;改动未提交、推送或发布。
+本轮启动的隔离 Electron 均已退出,其 profile 均已回收。
+
+最新单文件图集:`C:/Users/User/AppData/Local/Temp/cindy-ax5406-c2a2j1/navigation-report.html`,
+内嵌八张未经修改的原图,包含此前失败与当前对应操作的画面对照。
+
+复跑(省略 `--component-build` 会重新构建当前源码):
+
+```powershell
+node apps/desktop/scripts/ax5406/run.mjs --scenario=component --workload=scroll-tests --rows=500 --seed=5406 --ax=on --query=none --seconds=300
+```
+
+这些结果修复并验证了本轮可复现的滚动空白/回弹路径;原 issue 的现场日志和转储仍缺失,
+不能将这一结果扩大为所有原生闪退原因都已排除。
diff --git a/apps/desktop/scripts/ax5406/P1-ACCEPTANCE.md b/apps/desktop/scripts/ax5406/P1-ACCEPTANCE.md
new file mode 100644
index 0000000000..84b8805cac
--- /dev/null
+++ b/apps/desktop/scripts/ax5406/P1-ACCEPTANCE.md
@@ -0,0 +1,71 @@
+# #5406 两项 P1 修复与回归(2026-10-04)
+
+基线 `25388846915a9640341c4de5feb804b3a948c8f2`,Windows / Electron 41.10.3,当前 worktree 未提交代码。
+本轮结果更新此前的 `FULL-ACCEPTANCE.md`。没有提交、推送或修改正式版应用。
+文件清单和右侧本轮文件树的追加复测见 [FILE-LISTS-ACCEPTANCE.md](FILE-LISTS-ACCEPTANCE.md)。
+
+## 修复
+
+1. 页内查找复用同一个滚动辅助函数,先校正消息内部横纵向滚动,再由消息导航协调器定位外层。
+ 横向使用整段 Range 的宽度和容器实际可用宽度,避免换行后较宽字符仍被裁切;外层分页抑制仍保留。
+2. Electron 主进程以只读 IPC 提供本机无障碍支持状态;主窗口和独立侧栏 preload 均提供初始快照与动态订阅。
+ 启用读屏支持时,挂载当前逻辑窗口的完整正文,并保持阅读锚点;普通模式继续按视口挂载。
+ IPC 校验受信应用顶层窗口,未获得初始状态时保守保留正文;没有新增修改系统无障碍状态的产品接口。
+
+这两个修复不改变数据库分页、已加载消息数量或分享选择的数据范围。读屏模式会承担完整逻辑窗口的渲染成本,
+这是保留无障碍文本所需的回退;仍不使用 `content-visibility: auto`。
+
+## 本轮验证
+
+证据目录:`C:/Users/User/AppData/Local/Temp/cindy-5406-p1-wel5nwd4/`。
+
+| 项目 | 结果与证据 |
+|---|---|
+| 完整自动化 | Renderer 全部测试、preload 全部测试和新增 main IPC 测试:1,406 文件、16,879 项通过;默认跳过的 50k 用例另行执行。`unit-final.log` |
+| 类型与门禁 | Desktop typecheck、dump 签名解析器、10 项开发文档合同、`git diff --check` 通过 |
+| 两项 P1 的定向测试 | `text-access.json`:实际生产导航回调在真实浏览器中通过横向及嵌套纵向场景;真实 MessageStream 的读屏模式使 AX 树包含 120–199 共 80 条正文,初始开启及运行中切换均通过,逻辑 key 不变 |
+| 真实 Electron 桥接 | `bridge-integration.json`:直接编译生产 main/preload 与信任校验模块,在独立 Electron 中验证 false→true→false、true→false→true、取消订阅和未登记窗口拒绝;未运行实际 NVDA/VoiceOver |
+| 完整 dev 大表格查找 | `nested-find.json`:浅/深色,横滚 319px 后命中完整可见;逐片段屏幕命中检查确认未被输入框等覆盖,查找前后逻辑 key 不变 |
+| 双主题 / 三尺寸 | `matrix.json`:Light/Dark × 1280×800、960×640、1100×1000;慢滚、快滚、反向滚动、提问导航、回底、查找、输入框及正文全选、恢复阅读位置 |
+| 分页边界 | `boundary.json`:双主题查找前后均为 boundary-60..99 的 40 条;关闭恢复正文虚拟化;手动上滚后才加载 boundary-0 |
+| 分享选择 | `share.json`:进入补齐正文、全选、滚动保留选中及取消通过;未执行系统剪贴板或图片导出 |
+| 变更文件卡片 | `cards.json`:双主题 3→5 文件、离屏仍挂载且保留展开、差异面板、重载后只有一张卡;撤销后 5 文件恢复原文,重新应用后逐文件完全一致 |
+| 真实模型输出 | `stream.json`:OpenAI GPT-6-Luna,391–420 完整输出;145 次采样无空白,阅读期间增高 384px,稳定阅读采样的锚点偏移为 0;回底后继续跟随,完成时距底 0 |
+| 真实输出时阅读卡片 | `card-results.json`:76–90 完整输出;46 次采样无空白,9 次阅读采样中增高 545px,卡片位置漂移 0px;回底继续跟随、卡片保持 5 文件、差异仍可查看 |
+| 连续视频 | `card-final.mp4`:真实窗口 PrintWindow 连续录像,40.2 秒 / 20fps / 804 帧,804 次捕获成功;不是截图拼接 |
+| 真实组件滚动 | `cindy-ax5406-8lMrVw/report.json`:4,700 次逐帧采样,键盘、滚动条、程序写入、搜索跳转、尺寸变化,无空白/重叠;组件源文件哈希与最终源码一致 |
+| 流式绘制 | `cindy-ax5406-i8btHN/report.json`:1,200 有序分片,2,630 次几何采样,无空白/重叠;543 个跟随绘制帧无缺失标记,168 次补偿后检查无离底,29 帧离底反例有效 |
+| 异步高度及视觉 | `cindy-ax5406-fvqqYW/report.json`:24 个阶段,异步图片解码、增高、长消息展开/离屏返回、重挂载、追加消息、双主题及宽窄窗口通过 |
+| 完整挂载 AX 压力 | `cindy-ax5406-zbEwRC/report.json`:123 秒,10,896 次文本更新、96 次 CDP、389 次原生查询,无崩溃/dump;原生查询 0 错误 |
+| 视口挂载 AX 压力 | `cindy-ax5406-kIGiQx/report.json`:124 秒,12,640 次文本更新、141 次 CDP、843 次原生查询,无崩溃/dump;动态节点出现 34 次“模式不支持”,保留为查询覆盖限制 |
+
+组件产物目录均位于 `C:/Users/User/AppData/Local/Temp/`。
+真实 dev 还执行 424 次原生 TextPattern 查询,0 错误;这类查询没有自动打开 Electron 的系统读屏支持状态,
+因此不能把这一步冒充实际读屏软件启用测试。初始状态及切换链路由上表独立 Electron 桥接测试和真实组件 AX 验证覆盖。
+
+## 未全绿:50k 性能基线
+
+门槛保持 15.6ms,没有放宽断言。本轮初跑 17.12ms 失败;追加同机三轮交替对照:
+
+| 版本 | 三轮中位耗时(ms) | 三轮的中位数 |
+|---|---|---|
+| 当前代码 | 14.74 / 15.87(失败)/ 14.63 | 14.74 |
+| 未修改 main | 13.56 / 14.90 / 17.59(失败) | 14.90 |
+
+两版均有失败,目前不能归因为本次改动,也不能称全部检查全绿。原始记录为 `perf.log`、`perf.json`、`perf-*-*.log`。
+对照通过 Vite 只读加载 `git show HEAD` 源码,没有覆盖工作区或回退改动。
+
+## 验收中修正的测试条件
+
+- 初次 dev 启动超过包装器 120 秒时限;通过相同受管入口重试取得 `DESKTOP_DEV_VERDICT=ready`。
+- 大窗口的提问导航条完整覆盖导航时,产品按既有规则隐藏重复的上一提问 chip;测试改为点击当时实际可见的导航入口,仍断言目标及回底。
+- 首轮卡片流式脚本把固定坐标滚轮发到差异侧栏,失败记录保留。最终脚本测量消息区域、验证实际命中目标,并断言卡片阅读时真实增高及锚点稳定。
+- 大表格实测暴露首片段宽度不足导致约 2px 裁切,已修生产辅助函数并重新执行完整自动化与组件测试。
+ 过长多行查询可能高于查找栏与输入框之间的可读区域;额外短查询逐片段命中检查验证实际屏幕可见性,不把仅落在外层容器边界内当作未遮挡证明。
+
+## 边界
+
+本轮覆盖 Windows 隔离 dev 和同版 Electron 组件;没有覆盖 macOS、Mobile、正式安装包、长期 NVDA/VoiceOver 使用,
+以及所有复杂工具卡的业务操作。窗口尺寸是 CDP 视口变化,不是原生边框拖动。
+原 #5406 的 0.1.96 原始现场转储仍缺失,有限压力测试不能证明其所有闪退原因均已排除。
+验证结束后关闭本轮启动的 dev 和独立测试进程。
diff --git a/apps/desktop/scripts/ax5406/README.md b/apps/desktop/scripts/ax5406/README.md
new file mode 100644
index 0000000000..778f6f1897
--- /dev/null
+++ b/apps/desktop/scripts/ax5406/README.md
@@ -0,0 +1,143 @@
+# Issue #5406:Windows 无障碍文本崩溃复现
+
+这是独立 Electron 引擎实验,**不会启动 Cindy 应用或访问正式 profile**。仅载入合成文本,
+无账号、模型、真实消息、插件、网络页面或 OS 输入注入。它不属于默认单测,也不修改应用
+的无障碍设置、Electron pin 或崩溃退出策略。
+
+## 已确认的证据(2026-10-03)
+
+- [流式输出专项验证](STREAM-VALIDATION.md):已对齐绘制时序并与修改前 HEAD 对照,
+ 短暂离底读数是绘制前中间态;最终实际绘制检查通过,保留原始失败证据。
+- 搜索、回底及逐帧直接跳转的继续定位与最新修正见 [导航验证](NAVIGATION-VALIDATION.md)。
+ [增强滚动测试](SCROLL-VALIDATION.md) 保留较早阶段的失败证据,不代表当前最终结果。
+- 最新方案为视口挂载 + 普通布局,画面、交互及性能结果见 [视口挂载验收](VIEWPORT-VALIDATION.md)。
+- 当前源码已停用消息行跳过布局,修复后实跑与性能代价见 [修复验证报告](FIX-VALIDATION.md)。
+ 下文的原版阳性结果对应修复前源码;新构建默认不再应当复现。
+- **新增:真实 MessageStream 已经复现正常 AX 帧更新路径**,无 UIA / CDP 查询也能触发。
+ 同 seed 取消消息行 containment 后运行 120 秒未崩溃;完整栈与历史现场关键链路一致。
+ 详见 [组件复现报告](COMPONENT-REPRO.md)。以下最小 DOM 实验是此前的证据,不能混用入口。
+- 本机 Windows 11 x64,Electron **41.10.3** / Chromium **146.0.7680.216**。
+- 12 个带 `content-visibility: auto` 的段落,每帧改一个段落内 `span.textContent`,
+ 同时通过 CDP 请求完整 AX 树,能产生与 #5406 摘要完全相同的签名。
+- 不需要 React、Markdown 重写、滚动、折叠、自动化输入或 Cindy 任务。
+ 模拟器保留了每两帧一次 `getBoundingClientRect()`;尚未证明该读取是否必要。
+- 三个 seed(5406、5407、5408)分别于 **944、550、638 ms** 崩溃,均有独立 dump。
+- `--containment=off` 保持其他条件,120 秒 / 7,190 次文本更新 / 2,538 次 CDP 查询,未崩溃。
+- `--ax=off`,120 秒 / 7,192 次文本更新,未崩溃(关闭 AX 时也不发送 AX 查询)。
+- `--query=none` 保留无障碍开启,120 秒 / 7,190 次文本更新,未崩溃。
+- 最终脚本再次运行最小用例,971 ms 命中同签名;profile 清理路径已实跑。
+- 原生 Windows UIA 的另外一轮 30 秒实验完成 2,154 次文本/行范围查询,未崩溃;
+ 动态节点上有 13 次模式不可用错误。该路径不能冒充已复现。
+
+匹配规则同时检查以下三项;只有断点异常不算命中:
+
+```text
+ExceptionCode: 0x80000003
+Module RVA: 0xA332D17
+PDB GUID/age: D4DDA3CA101D876E4C4C44205044422E1
+```
+
+### 原生调用栈
+
+复现 dump 用 Windows SDK 的 DbgEng 进行 x64 栈展开,再用 Electron 官方
+`electron-v41.10.3-win32-x64-symbols.zip` 中 **相同 PDB 身份**的 Breakpad FUNC/行号记录
+解析地址。没有把未加载私有符号时出现的 `sqlite3_dbdata_init+巨大偏移` 当成真实函数。
+31 个 Electron 原生帧均解析到函数及源文件/行号,栈底还有两个 Windows 系统帧。
+优化内联帧没有额外展开;这不是完整内存转储,也不是原现场转储。
+
+主要路径(调用方 → 故障点):
+
+```text
+RendererMain / RunLoop / Mojo / DevToolsSession
+Accessibility::DomainDispatcherImpl::getFullAXTree
+InspectorAccessibilityAgent::getFullAXTree
+AddChildren / BuildProtocolAXNodeForAXObject
+BuildProtocolAXNodeForUnignoredAXObject
+AXObject::Serialize
+AXObject::SerializeInlineTextBox
+AXObject::SerializeLineAttributes
+AXInlineTextBox::NeighboringOnLineWithAXBlockFlowIterator
+AXBlockFlowIterator::PreviousOnLineAsIndex
+AXBlockFlowData::ComputeNeighborOnLine
+ ax_block_flow_iterator.cc:183, 函数 RVA 0xA332B30 + 0x1E7
+```
+
+故障寄存器 `r14=1`,对应普通文本类型;分支要求类型为 `2`(生成文本),失败后执行
+`INT3`。这与 Issue 的断言描述一致。
+
+### 结论边界
+
+已经有可重复触发同一引擎断言的合成用例。另外已独立展开本机两份历史现场 dump,
+分别属于 **0.1.60(2026-08-25)** 和 **0.1.75(2026-09-08)**,均命中相同签名。
+两份历史栈都经正常帧生命周期中的 AX 增量序列化到达断言,**没有 CDP 调用帧**;
+前者求下一行内节点,后者求上一行内节点。详见 [现场对照报告](FIELD-COMPARISON.md)。
+这些不是 Issue 所述的 0.1.96 原件,不能代替其独立复核,也未确认具体 DOM/React 组件。
+本实验经 CDP `getFullAXTree` 触发,不能据此认定历史现场或 Issue 原现场也调用了该工具。
+最小 DOM 用例没有载入 Cindy 组件;新增 `--scenario=component` 直接构建当前真实 MessageStream。
+关闭 containment 的结果只是受控对照,不等于生产修复已验收。
+
+验证:签名解析器单测通过(精确匹配、错误码/RVA/GUID/age反例、损坏数据);脚本语法检查
+通过;`pnpm --filter desktop run --if-present typecheck` 通过。仅 Windows 实跑,
+未对 macOS 做结论。没有改生产代码、提交、推送或发表 Issue 评论。
+
+## 运行
+
+先按仓库环境文档在当前 worktree 安装依赖。使用 Windows x64;不使用安装版 Cindy.exe。
+默认解析当前 checkout 的 `electron` 包(不会主动下载或升级引擎)。
+
+```powershell
+node apps/desktop/scripts/ax5406/run.mjs --seconds=15 --scenario=minimal --scroll=off --rows=12 --batch=1
+node apps/desktop/scripts/ax5406/matrix.mjs
+pnpm --filter desktop exec vitest run scripts/ax5406/inspect-dump.test.mjs
+```
+
+每轮会打开一个不抢焦点的实验窗口,结束/崩溃后自动关闭。独立 OS 临时目录打印为
+`AX5406_ARTIFACTS=...`,保存 `config.json`、`report.json`、`electron.log`、`dumps/`;
+新运行记录 fixture SHA-256。生成的 profile 退出后删除,诊断证据有意保留供复核。
+外层有时长 +40 秒 watchdog,只结束本次创建的进程树。
+
+退出码:`0` = 本轮完成且未崩溃;`10` = dump 三项签名全匹配;`2` = 其他崩溃、超时、
+负载/查询未验证等。`0` **不表示已修复**,矩阵会原样记录每一组结果。
+
+常用选项:
+
+| 选项 | 默认 | 含义 |
+|---|---|---|
+| `--scenario` | `stream` | `minimal`、`stream`、`detach`、`visibility`、`inline`、`mixed`、`component` |
+| `--seconds` | `120` | 5–600 秒 |
+| `--seed` | `5406` | 非零 uint32,固定 PRNG 操作序列(帧/CDP调度仍异步) |
+| `--rows` / `--batch` | `80` / `8` | 段落数量 / 每帧修改数量 |
+| `--containment` | `on` | `off` 强制可见布局,不使用 intrinsic 占位 |
+| `--ax` | `on` | `off` 禁用本次实验 renderer 的无障碍,也不执行 AX 查询 |
+| `--query` | `cdp` | `native`、`both`、`none`;native 仅查本次 HWND 并校验其 PID |
+| `--scroll` | `on` | 是否改变容器滚动位置;最小用例使用 `off` |
+| `--rewrite` | `on` | stream 是否重写 inline HTML;minimal 无此操作 |
+| `--component-build` | 无 | component 模式复用已有 AX5406 产物根目录中的同一份构建 |
+| `--target` | `all` | component 文本更新目标:all / assistant / user / tail;不是生产开关 |
+
+## 转储与符号复核
+
+```powershell
+node apps/desktop/scripts/ax5406/inspect-dump.mjs <dump.dmp>
+```
+
+此工具只读异常/模块/PDB元数据,**不会**展开栈或输出任意内存字符串。
+测试防止把不同异常码、相邻 RVA、不同 PDB GUID/age 误判为命中。
+
+有 WinDbg/CDB 时使用 `.ecxr; kv 100; lmv a @rip`。也可在 VS x64 Native Tools shell
+中编译这里的离线 DbgEng 前端,将 exe/obj 放在仓库外临时目录:
+
+```text
+cl /EHsc <repo>\apps\desktop\scripts\ax5406\stack-windows.cpp /link dbgeng.lib
+stack-windows.exe <dump.dmp> <本地符号目录>
+```
+
+保存它的 stdout 为 `stack.txt`,从官方 release 下载匹配的 symbols 包后运行:
+
+```text
+node apps/desktop/scripts/ax5406/symbolize-stack.mjs <dump.dmp> <stack.txt> <electron.exe.sym>
+```
+
+脚本检查 `MODULE` 的 PDB 身份,丢弃 DbgEng 的 Electron export 猜测,按真实异常 PC
+和展开后的返回地址查函数/行号。原始 dump、符号包及用户日志不放进 Git,也不上传。
+若需调试局部变量或展开优化内联帧,另取官方完整 PDB;本轮未下载 3.76 GB 的完整 PDB。
diff --git a/apps/desktop/scripts/ax5406/REBASE-VALIDATION.md b/apps/desktop/scripts/ax5406/REBASE-VALIDATION.md
new file mode 100644
index 0000000000..994abc7460
--- /dev/null
+++ b/apps/desktop/scripts/ax5406/REBASE-VALIDATION.md
@@ -0,0 +1,92 @@
+# #5406 rebase main 后复测
+
+> 后续状态(2026-10-04):下文的贴底漏查问题已定位并修复。原失败记录保留作为对照,
+> 最新因果验证与复测结果见文末「贴底文本展开修复」。
+>
+> 变更文件卡片此前未纳入真实界面验收。2026-10-04 补测发现历史视图漏传变更记录,
+> 已补修并完成独立回归,见 [变更文件卡片补测](CHANGED-FILES-VALIDATION.md)。
+
+2026-10-04。分支 `cindy/witty-feynman` 从 `d656b0fc1` 同步到本轮 fetch 得到的
+`origin/main`:`25388846915a9640341c4de5feb804b3a948c8f2`,跨 400 个提交。
+分支原本没有独立提交,修复均为未提交改动;先 stash(含未跟踪文件),执行 rebase,
+再 apply 恢复,均无文本冲突。保留备份 `7f5300ab30d50e436e7e2d933f17ac995fdcd5b6`。
+核对 48 个未跟踪文件恢复前后内容一致,没有推送或创建提交。
+
+主干修改了 MessageStream 的流式投影、工作组渲染与导航投影,以及查找栏拖拽区域。
+已复核自动合并后的本地差异,并覆盖主干新增模块的测试。
+
+## 通过项
+
+- 17 个定向测试文件:340 项通过;原有 focused-only 50k 压力用例未执行(1 skipped),
+ 没有新增 skip。Desktop typecheck 与 `git diff --check` 通过。
+- 安全包装命令启动隔离 dev,返回 ready,PID 43620,版本基线 `253888469`。
+ 依赖由包装脚本按新锁文件同步,Codex runtime 按主干 pin 更新至 0.159.2。
+- 500 条长历史任务,深色/浅色分别上滚、切换任务再返回:阅读锚点像素位置保持不变,
+ 回底入口可见且可点击,最终距最新消息底部 0px。
+- 明确上滚进入阅读状态后,查找保持当前 96 行逻辑窗口;Ctrl+A 覆盖全部 96 条消息,
+ 输入框全选不受影响。100 次连续滚轮无可见占位空白,历史扩展与回底正常。
+- 真实 Codex/OpenAI GPT-6-Luna 输出 271–300 共 30 个标题,9,475 字符,结束标记完整。
+ 82 次采样无可见占位空白或 renderer 错误;上滚阅读时内容增长 466px、位置偏移 0px,
+ 恢复跟随后最终距底部 0px。17 次完整 AX 树读取成功,未发生闪退。
+
+## 未通过:贴底重开后查找会收缩窗口并漏查
+
+此项不能归类为纯测试驱动问题。首次严格窗口不变断言失败后补做独立 UI 验证,确认了用户影响:
+
+1. 500 条任务上滚进入历史,切换到另一任务再返回。
+2. 点击可见回底入口,确认距底部 0px。
+3. 再切到另一任务并返回,等待 4 秒;此时逻辑行 160 条,首行 `qa5406-340`,距底部 0px。
+4. 仅按 Ctrl+F(尚未输入查询),逻辑窗口收回到 80 条,首行变为 `qa5406-420`。
+5. 搜索原窗口中的 `Question 341:`,显示 `0/0`。
+
+证据 `tail-find.json` 记录 before/open/after 与查询结果;`tail-find.png` 为真实客户端截图。
+在阅读位置中查找的测试仍通过,不能用它替代此贴底重开场景。
+rebase 前的上一轮也出现过 160→80 的窗口断言失败,当时按恢复时序处理;本轮补充证明会漏查。
+尚未完成代码因果定位,不能把它断言为主干引入的回归;本轮仅同步和复测,未修改产品实现。
+
+结论:rebase 完成,已有回底修复及多数复测通过,整体验收仍未通过。
+下一步应定位打开查找触发布局后为什么清除历史窗口锚点,并保证查找期间的逻辑窗口稳定。
+
+## 证据
+
+`C:/Users/User/AppData/Local/Temp/cindy-5406-rebase-zkuaG1/`:
+`rebase-dark.json`、`rebase-light.json`、`text-scroll.json`、`stream.json`、`tail-find.json`,
+以及包含真实截图的自包含 `acceptance.html`。
+本轮覆盖 Windows dev,未覆盖生产安装包、macOS 或逐合成帧录屏;原 issue 转储仍缺失。
+复测后通过窗口关闭按钮正常退出,确认 PID 43620 及该 worktree 启动链已结束,CDP HTTP 端点不可访问。
+
+## 贴底文本展开修复
+
+2026-10-04,同一 main 基线,隔离 dev PID 33240。
+
+临时插桩抓到清窗来自 `handleScroll` 的原生 React scroll 分支:打开查找展开正文后,
+`scrollTop` 变化 -1,605px,距底仍为 0,`isNearBottomRef` 原本就为 true,
+`firstVisibleItemKey` 为 `msg-qa5406-340`。旧分支只判断「当前在底」,因此把布局引起的
+滚动也当作收回默认尾窗的理由;160 行被收回 80 行,`Question 341:` 从查找范围中消失。
+插桩已移除。
+
+修复把收窗放到「未跟随 → 恢复跟随」的状态迁移内,保留手动回底、发送消息以及正常
+历史扩窗行为;已经跟随时的正文挂载/高度修正不再改变逻辑窗口。没有改数据库分页、
+默认 80 个 render item 或每次增加 80 个 render item 的规则,也没有增加查找专用分页。
+
+- 同路径真实 UI 对照:旧代码 `160 → 80`、`Question 341:` 为 `0/0`;
+ 修复后 `160 → 160`,查询为 `1/1`。证据 `before-tail-find.json` 与 `tail-find.json`。
+- 自动补载预算耗尽后,重复重开会合法得到普通 80 行尾窗;严格要求大于 80 的重复用例
+ 因前置条件未满足而中止,没有把它算作扩展窗口验证。普通 80 行路径单独验收,浅/深色
+ 查找前、打开后、关闭后均为 80 行;查到最早一行 `Question 421:`,关闭后目标仍可见。
+- 浅/深色贴底 Ctrl+A 均保留 80 行并选择完整文本(36,804 字符),输入框全选独立验证。
+- 新增 `tailWindowScrollLayout.test.ts` 执行生产 `handleScroll` 回调:旧代码 3 个布局滚动
+ 用例失败,修复后 6 项通过;另覆盖用户向下恢复跟随、近底上滚及中间历史窗口增加 80 行。
+- 18 个定向测试文件共 346 项通过,1 项既有 focused-only 50k 用例未执行;Desktop
+ typecheck 与 `git diff --check` 通过。
+- 深色长历史 100 次连续滚轮采样无可见占位空白,历史扩展、输入框全选与回底正常。
+- Codex/OpenAI GPT-6-Luna 真实输出 301–330 共 30 个标题,9,302 字符,完整结束。
+ 74 次采样无可见占位空白、renderer 错误;上滚阅读后内容继续增长 510px,阅读位置
+ 偏移 0px,点击回底后跟随恢复,最终距底 0px。15 次完整 AX 树读取成功,未闪退。
+- 实际查看修复后的查找高亮截图和深色流式原生窗口截图,未见正文重叠或大面积空白。
+ CDP 截图中的侧栏黑底为透明背景捕获差异,原生窗口截图中侧栏正常。
+
+本轮证据目录:`C:/Users/User/AppData/Local/Temp/cindy-5406-text-window-0IxpeM/`。
+自包含报告为该目录下 `acceptance.html`。验收后通过关闭按钮正常退出,确认 PID 33240
+及该 worktree 启动链已结束,CDP HTTP 端点不可访问。未提交、推送。
+原 issue 缺少现场转储,修复该漏查不等于核对了原始闪退现场。
diff --git a/apps/desktop/scripts/ax5406/SCROLL-OPTIMIZATION.md b/apps/desktop/scripts/ax5406/SCROLL-OPTIMIZATION.md
new file mode 100644
index 0000000000..75af19122c
--- /dev/null
+++ b/apps/desktop/scripts/ax5406/SCROLL-OPTIMIZATION.md
@@ -0,0 +1,69 @@
+# 两项滚动优化:实现与实测
+
+2026-10-04 · Windows · Electron 41.10.3 / Chromium 146.0.7680.216
+
+## 结论
+
+两项优化已落地。原生滚轮主线程耗时中位数下降约 4.7%,小步程序滚动下降约 8.1%;大幅跳滚与流式输出没有测到改善。它们减少重复几何检查,没有消除正文重新挂载的主要成本。
+
+## 本轮改动
+
+1. 缓存本次挂载范围对应的滚动区间。在消息、尺寸和 DOM 未变、滚动仍位于区间内时,跳过逐行 getBoundingClientRect 与挂载集合重建。
+2. 已测量的程序滚动、原生 scroll、React 提交和 ResizeObserver 通知共享检查结果;观察器通知共用一次 rAF。保留程序滚动先通知上层位置协调器的顺序,跨挂载边界仍在绘制前同步补齐正文。
+
+MessageStream 的 viewportEntries 改为 useMemo,避免无关重渲染导致缓存失效。新增 5 个定向测试覆盖重复通知、尺寸增长及总高度不变的行内增减。
+
+没有增加保留正文数量、延迟卸载或修改数据分页;视窗上下 600px 缓冲、默认逻辑尾窗 80 个渲染条目及特殊卡片保留规则沿用原实现。
+
+## 性能数据
+
+基线是本轮优化前的视窗版,**不是 main**。同一台机器、同一份 500 条合成消息、1280×800 窗口、相同 Electron;每版运行 3 次,按 before→after、after→before、before→after 交替。正式计时期间没有同时运行类型检查、单测或 dev 构建。
+
+下表为 CDP Performance.TaskDuration 的增量,单位 ms,取三次中位数。它是该操作序列的渲染器主线程累计工作时间,**不是单帧延迟、总墙钟时间或整机 CPU 百分比**;采样脚本开销也包含在内。
+
+| 场景 | 优化前 | 优化后 | 变化 |
+|---|---:|---:|---:|
+| 原生滚轮,240 次输入 | 1,093 | 1,042 | -4.7% |
+| 程序小步滚动,240 × 48px | 596 | 548 | -8.1% |
+| 大幅跳滚,100 次 | 1,886 | 1,895 | +0.5% |
+| 流式输出,180 段 | 1,390 | 1,404 | +1.0% |
+
+原生滚轮采用 Electron sendInputEvent mouseWheel,240 次 ±48 输入、每 60 次换向;程序小步滚动直接写 scrollTop,每步等待一帧,两者分别计量。大幅跳滚等待两帧后采样。
+
+脚本耗时:原生滚轮 658→616ms(−6.3%);程序小步滚动 370→318ms(−14.1%)。布局耗时基本不变。首屏两版均挂载 5 个正文、292 个正文后代节点,JS 堆约 24.58MiB。
+
+三次原始总耗时(ms,按各版本运行顺序):
+
+| 场景 | 优化前三次 | 优化后三次 |
+|---|---|---|
+| 原生滚轮,240 次输入 | 1,062 / 1,093 / 1,094 | 1,042 / 1,061 / 1,038 |
+| 程序小步滚动,240 × 48px | 615 / 596 / 573 | 548 / 523 / 576 |
+| 大幅跳滚,100 次 | 1,885 / 1,886 / 1,891 | 1,961 / 1,886 / 1,895 |
+| 流式输出,180 段 | 1,399 / 1,379 / 1,390 | 1,476 / 1,397 / 1,404 |
+
+只有 3 次样本,且单次有波动:不能承诺所有设备固定提升这一比例。大幅跳滚 +0.5%、流式 +1.0% 不能写成性能改善。首版尝试的大幅跳滚收益也只有约 0.5%,原始结果保留在本报告目录根下 perf-all.json;最终数据使用 final-perf 与 wheel-perf。
+
+## 回归结果
+
+- renderer / preload / accessibilitySupportIpc:1,406 个文件,16,884 项通过、1 项跳过;Desktop 类型检查通过。类型检查曾有回调返回值被推断为字面量 true 的错误,明确标注 boolean 后重跑通过。
+- 三轮程序滚动/流式对照共 3,120 次采样,原生滚轮对照共 1,440 次采样:未发现可见占位或重叠;每轮 180 段流式文本完整且顺序正确。
+- 加强滚动回归:4,927 次布局采样,包含快慢滚轮、反向、键盘、滚动条拖动、程序跳转、查找接管、回到底部;3 种窗口尺寸、Light/Dark,失败项 0。
+- 流式回归:3 种窗口/主题组合,各 400 段,共 1,200 段完整有序;2,573 次布局采样;520 个跟随阶段实际绘制采样无底部缺失;163 次尺寸补偿后采样无底部空隙。两次绘制前瞬态几何警告分别为 160px / 32px,实际绘制及补偿后检查均通过;不把瞬態 DOM 读数冒充绘制帧。
+- 异步增高、图片、展开、卸载再挂载和窗口缩放:24 步通过。
+- 文本查找:横向/嵌套滚动 2 项通过;无障碍初始关闭/开启及运行时切换 2 组通过,当前逻辑 80 行完整暴露。
+- 完整 dev 隔离沙盒:7 次任务进入/切换、Light/Dark × 960×640 / 1280×800 / 1600×900,共 240 次滚轮后检查,无可见占位、重叠或页面 JS 错误。复用此前隔离沙盒的合成数据,不读取生产任务;这组作为显示回归,不与较早 main 数据混作同批性能对照。
+
+本轮未重跑真实模型联网生成,也未重新跑原生 AX 崩溃压力对照;沿用之前稳定性调查的结论与限制,不扩大到“所有闪退均修复”。本轮没有新增针对变更卡片/文件列表的独立 dev 场景;相关单测已包含在全量 renderer 回归中,卡片保留规则未改。
+
+## 证据
+
+- 最终性能数据:C:/Users/User/AppData/Local/Temp/cindy-5406-opt-tiu4zzbx/final-perf/{summary.json,perf-all.json} 与 wheel-perf/{summary.json,perf-all.json}。
+- 滚动:C:/Users/User/AppData/Local/Temp/cindy-ax5406-lAOHt3/scroll-audit.json。
+- 流式:C:/Users/User/AppData/Local/Temp/cindy-ax5406-0CTIYp/stream-audit.json。
+- 视觉:C:/Users/User/AppData/Local/Temp/cindy-ax5406-hFZplx/visual-steps.json。
+- dev:本报告目录 dev-current.json、dev-current-*.png;文本访问 text-access/text-access.json。
+- 最终构建的 390 个 renderer 源文件 SHA-256 已与工作区核对一致;构建清单 final/component-sources.json。
+
+截图来自真实 dev 客户端的 CDP 捕获;侧栏原生透明背景不包含在截图中,不以这些截图评定原生毛玻璃外观。已目检浅深主题的消息区域。
+
+代码保持在当前 worktree,未提交、未推送。本轮测试 Electron 和 dev 实例已退出。
diff --git a/apps/desktop/scripts/ax5406/SCROLL-VALIDATION.md b/apps/desktop/scripts/ax5406/SCROLL-VALIDATION.md
new file mode 100644
index 0000000000..e914e5834c
--- /dev/null
+++ b/apps/desktop/scripts/ax5406/SCROLL-VALIDATION.md
@@ -0,0 +1,99 @@
+# #5406:增强滚动测试与补修
+
+> 后续继续定位、搜索与回底的补修以及最终三轮复测,见
+> [NAVIGATION-VALIDATION.md](./NAVIGATION-VALIDATION.md)。以下保留此前未通过的阶段记录。
+
+2026-10-03,Windows Electron 41.10.3,真实 MessageStream、真实布局/字体/主题,合成数据,
+独立 profile,无后端与用户数据。没有启动或替换正在运行的正式客户端。
+
+## 本轮实际发现
+
+上一轮“18 张稳定截图正常”不足以说明滚动过程没有瞬时异常。更密集的采样发现:
+
+1. 快速滚轮/滚动条拖动时,初版 hook 将挂载推迟到下一个 rAF,视口可先出现空占位。
+ `6GROaj` 共 3,061 次采样,其中 274 次含占位:96 次发生在快滚/真实拖动,178 次在强制脚本跳跃。
+2. 1,000 条历史从较早的搜索结果返回最新位置时,回底按钮可停在最新消息之前。
+ `bHB0fg` 的三种窗口尺寸均失败。原因是 React 尚未切回尾部窗口,就读取旧窗口的 scrollHeight。
+
+补修:
+
+- 在原生 scroll 事件里用 `flushSync` 完成正文挂载,取消额外一帧延后;ResizeObserver 的合帧
+ 回调也确保该帧更新提交。仍按视口挂载,没有改回常态全量渲染。
+- 回底按钮切换 `firstVisibleItemKey` 后先同步提交,再读取新尾窗高度启动滚动。
+- 仅在偏差超过 1px 时写回 scrollTop,避免无效赋值打断平滑滚动。
+- hook 单测增加“发出 scroll 后、不推进下一 rAF 就必须看到正文”的断言;新增
+ `jumpToLatestLayout.test.tsx` 使用真实回底 callback 和 React commit,校验目标来自切换后的 DOM。
+
+## 负载与方法
+
+`scroll-tests.cjs` 在 1000×420、1000×760、620×1000 三种窗体尺寸运行,覆盖 Light / Dark:
+
+- 每种尺寸 80 次慢上滚、80 次慢下滚、70 次快上滚、70 次快下滚、60 次方向反转。
+- 真实 Electron mouseDown / mouseMove / mouseUp 操作滚动条,每种尺寸 40 次拖动位置改变;
+ 同时验证实际 scrollTop 跨度,不能把没有拖中滑块当作通过。
+- Home / End 和各 12 次 PageDown / PageUp;5 次搜索目标定位;回底按钮;停止后的阅读锚点。
+- 注入正文增长、图片和新增消息,然后继续上/下滚动。
+- 另有每种尺寸 60 次“rAF 中直接写 scrollTop”的独立边界压力项;保留其失败记录。
+
+rAF 后的任务记录每帧视口、挂载数、空占位覆盖、行重叠;高速度阶段用
+`webContents.beginFrameSubscription` 抓取真正绘制帧,不只在 450ms 停稳后截屏。
+DOM 采样不等于每个显示器刷新;两种证据结合,仍不宣称能证明任意环境绝无闪动。
+
+全量挂载对照通过当前组件既有 Tab 可访问性回退恢复所有已加载正文,保持同样正常布局,
+不使用 content-visibility:auto,避免把引擎崩溃与滚动画面混在一起。
+
+## 结果与未通过项
+
+- 全量对照 `zTJtVa`:3,528 次采样,无空占位/重叠,176 张真实绘制帧。
+- 同步挂载后 `QNVzJW`,500 条:4,782 次采样;真实操作和稳定阅读均通过,只有直接脚本跳跃
+ 的 177 次空帧,完整脚本保留 `visual-failed`。
+- 1,000 条 `bHB0fg`:发现回底失败,未将其归为脚本问题;补修后 `NpZdyH` 的三种尺寸回底均通过。
+ `NpZdyH` 总共 4,773 次采样,仅剩直接脚本跳跃的 177 次空帧,其余阶段无空占位/重叠。
+- 所有窗口均无 renderer JS 错误、无原生崩溃;停止后的阅读锚点误差不超过 2px。
+- 未观察到真实用户输入路径上的新空白、重叠或停止后的跳动。但不能据此写成“全压力矩阵通过”。
+
+后续 `n5ZI7K` 的重复运行还有搜索及回底失败,不能凭 `NpZdyH` 一轮正常就认定全部解决。
+检查发现原搜索断言只等待 1 秒,而组件允许 2.5 秒落定;改为等待目标可见且停止滚动,
+最多 3 秒,记录每次耗时。不过 `390dwm` 仍有 2 个目标在 3 秒后不可见,证实不只是计时问题。
+随后实验“搜索定位时完整挂载逻辑窗口”,`BoOG1r` 仍有 2 次目标不可见。
+始终全量挂载的 `DorU2w` 对照也在相同目标(490)失败,且没有空占位。
+因此该额外挂载措施未保留;不能把尚未定位的搜索问题都解释为占位高度误差,
+也不能仅凭这个对照就断言原始版本已存在相同 bug,因为对照仍运行当前组件的其他逻辑。
+当前源码回到 `iyoRWW` 对应实现:同步滚动挂载、避免无效位置重写、先提交尾窗再量高度。
+
+### 最终源码对应的记录
+
+| 数据量 / 产物 | 总采样 | 非强制脚本阶段空占位 / 重叠 | 搜索未通过 | 强制脚本空帧 |
+|---|---:|---|---|---:|
+| 500 / `390dwm` | 5,539 | 0 / 0 | 2 次,目标 420,在 760px 与 1000px 窗高下超出视口 | 177 |
+| 1000,seed5408 / `z1HM0d` | 4,790 | 0 / 0 | 0 | 176 |
+
+两轮合计 10,329 次采样,排除 720 次强制脚本阶段采样后,9,609 次采样没有空占位/重叠;
+这不抵消搜索目标未命中的失败。两轮回底检查均通过;没有崩溃或 JS 错误。
+三个生产文件(MessageStream、useMessageViewport、globals.css)的当前 SHA-256 与冻结构建
+`iyoRWW` 的记录逐项一致。最后一轮结束后确认本次测试 Electron 已退出、临时 profile 已清理。
+单文件图集:`cindy-ax5406-z1HM0d/scroll-report.html`。
+
+相关测试通过:10 文件 106 项通过、1 项原有跳过;随后新增“零偏差不重写 scrollTop”用例,
+该 hook 与回底用例合计 8 项定向复跑通过。Desktop 类型检查与 `git diff --check` 通过。
+
+**验收状态:未全通过。** 普通滚轮/拖动的闪空已补修,但搜索落点问题仍未解决,
+加上下面的直接脚本跳跃空帧,不能将当前候选标为无滚动画面异常或可直接发布。
+
+**仍存在的边界**:直接在动画帧回调内强改 scrollTop,会在浏览器下一次派发 scroll 事件前
+先绘制一个新位置,虚拟正文尚未就绪;真实绘制帧已看到整屏空白,停止后恢复。
+当前测试覆盖的滚轮、真实拖动、键盘、搜索和回底路径没有复现该现象。
+此项不删除、不豁免为绿色,也不代表已经找到了每一种生产程序化滚动的相同时序。
+目前不应承诺“任何程序化跳跃绝无闪空”。
+
+## 复跑
+
+```powershell
+node apps/desktop/scripts/ax5406/run.mjs --scenario=component --workload=scroll-tests --rows=1000 --seed=5408 --ax=on --query=none --seconds=300
+# 复用上述冻结构建,作全量挂载对照:
+node apps/desktop/scripts/ax5406/run.mjs --scenario=component --component-build=<AX5406_ARTIFACTS> --workload=scroll-tests --mounting=full --rows=1000 --ax=on --query=none --seconds=300
+```
+
+测试图片与 JSON 均在 OS 临时目录;单文件 HTML 使用原始图片 data URI。
+代码未提交、推送或发布,仍需完整客户端验收;前一阶段的首帧性能数字未重新测量,
+不能把它们当作同步滚动更新后的精确性能结论。
diff --git a/apps/desktop/scripts/ax5406/SELECTIVE-AUTO-EXPERIMENT.md b/apps/desktop/scripts/ax5406/SELECTIVE-AUTO-EXPERIMENT.md
new file mode 100644
index 0000000000..3039473116
--- /dev/null
+++ b/apps/desktop/scripts/ax5406/SELECTIVE-AUTO-EXPERIMENT.md
@@ -0,0 +1,65 @@
+# #5406:保留历史消息 auto 的方案 2 实验
+
+2026-10-03。用户要求保持消息数量,并先尝试“历史消息 auto、更新中消息 visible”。
+本轮只修改隔离实验,不替换此前的生产 CSS 止崩补丁,不提交或发布。
+
+## 方法和边界
+
+- 同一真实 MessageStream 编译产物 `cindy-ax5406-riCfWK`,Electron 41.10.3,80 条合成消息,
+ 40 条 user / 40 条 assistant,每帧更新 8 次助手文本,每 12 帧随机滚动。
+- `--policy=auto` 给所有行恢复 auto / auto 240px,用作阳性对照。
+- `--policy=active` 在 fixture 中生成 CSS,给 `isStreaming` 消息的既有
+ `data-message-client-id` 外层行设置 visible / none,历史行保持 auto / auto 240px。
+ 样式与消息状态在同一次 React commit 更新;不是在消息更新后异步切换样式。
+- 每次 fixture commit 检查所有行的计算样式,记录 `activeAuto` 和 `maxActiveAuto`。
+ 这会增加诊断读操作,所以阳性对照也执行相同检查。
+- steady 工作负载中所有助手消息始终 streaming;cycle 每 120 帧的后 30 帧将其设为
+ settled 并停止文本更新,恢复 auto,随后再次开始 streaming。滚动始终继续。
+- cycle 同时触发真实 AssistantMessage 的完成态切换;它不是只改 CSS、不改组件状态。
+- 这是压力原型,尚未覆盖生产中的工具卡、思考块、嵌套伙伴消息、图片/图表异步展开等全部变动来源。
+ 用 `isStreaming` 标记更新范围的充分性仍需专项验证。
+
+## 结果
+
+| 策略 / 工作负载 | 查询方式 / seed | 结果 | 文本更新数 | 产物目录后缀 |
+|---|---|---|---:|---|
+| active / steady | 无主动查询 / 5407 | 120,512ms 无崩溃 | 9,960 | riCfWK |
+| active / cycle | 无主动查询 / 5407 | 120,182ms 无崩溃 | 8,696 | IhxbLt |
+| auto / cycle | 无主动查询 / 5407 | 4,626ms 命中原签名 | 256 | YDNdbe |
+| active / cycle | 原生 UIA + CDP / 5406 | 120,241ms 无崩溃 | 7,480 | yyq0k9 |
+
+三轮 active 测试累计 26,136 次文本更新,在更新阶段均为 40 行 auto、40 行 visible,`maxActiveAuto=0`;
+cycle 记录到 360 次 settled commit,覆盖约 12 个完整结束/恢复周期。
+所有正常完成的测试均无 JS 错误、保留 80 行。
+第三轮记录 160 次 CDP 完整树查询、542 次原生 UIA 文本范围查询,查询错误为 0,
+并记录 300 次 settled commit。全部实验进程已退出,临时 profile 已清理。
+
+阳性对照签名为 `0x80000003`、`0xA332D17`、
+PDB `D4DDA3CA101D876E4C4C44205044422E1`。同构建、同诊断读操作依然能复现,
+因此不能把 active 测试不崩仅归因于新实验的测量开销。
+
+此结果支持方案 2 值得继续验证,**不等于完整生产实现已安全**。特别是历史消息内部也会有
+异步布局变化,只按 isStreaming 分类不能预先认定已覆盖这些变化。
+本轮未做性能基准,不能用这些压力实验的 FCP 声称已收回之前的 236ms。
+
+## 官方和社区调查
+
+- [GitHub Copilot 社区报告 #4492](https://github.com/github/copilot-cli/issues/4492)
+ 报告同一个 Blink 函数和普通文本缺失 LayoutObject 的断言。报告者的绕过方式是关闭
+ renderer accessibility,代价是损失辅助功能;关闭 AccessibilityBlockFlowIterator
+ 则转成另一条路径的空指针崩溃。这是第三方报告,不是 Cindy 的实验结果,不能将两者所有触发条件等同。
+- 本轮检索未确认到覆盖当前复现的 Chromium / Electron 官方修复版本。
+ [Chromium 主干源码](https://raw.githubusercontent.com/chromium/chromium/main/third_party/blink/renderer/modules/accessibility/ax_block_flow_iterator.cc)
+ 仍有该 CHECK;断言仍在不等于新版一定可崩,仍需用同一用例验证上游候选版本。
+- 方案 2 是本地候选绕过策略,不是已确认的官方建议。
+
+## 复跑
+
+```powershell
+node apps/desktop/scripts/ax5406/run.mjs --scenario=component --seconds=120 --ax=on --query=none --rows=80 --batch=8 --target=assistant --scroll=on --seed=5407 --policy=active --workload=cycle
+```
+
+阳性对照将 `--policy=active` 改为 `--policy=auto`。
+复用已构建产物可追加 `--component-build=C:/Users/User/AppData/Local/Temp/cindy-ax5406-riCfWK`。
+两个新参数默认值为 `production` 和 `steady`,不改变此前实验的默认策略。
+全部报告、dump、截图及官方符号都保存在系统临时目录,未上传。
diff --git a/apps/desktop/scripts/ax5406/STARTUP-PROFILE.md b/apps/desktop/scripts/ax5406/STARTUP-PROFILE.md
new file mode 100644
index 0000000000..25f7c1e0c8
--- /dev/null
+++ b/apps/desktop/scripts/ax5406/STARTUP-PROFILE.md
@@ -0,0 +1,90 @@
+# #5406 首屏耗时分析
+
+2026-10-03。仅分析隔离的真实 MessageStream 组件 fixture;没有连接后端、使用用户数据,
+也没有修改正在运行的 Cindy。生产修复仍为停用行级 content-visibility:auto。
+
+## 1004ms 的口径
+
+此前三轮修复版首次内容绘制中位数为 1004ms,旧版为 768ms。
+这是从页面导航起计的 FCP,包含独立页面模块加载、初始化、字体、React 首次挂载及排版。
+不包含 Electron 启动的全部时间,也不是正式应用切换任务的延迟。
+fixture 构建关闭压缩;MessageStream JS chunk 约 9.64MB,common chunk 约 1.33MB。
+不能把该冷加载成本直接推广到已加载模块的正式客户端。
+
+纠正先前表述:当前源码默认尾窗立即挂载最多 80 个条目。15 条首帧限制用于锚点恢复等路径,
+不限制默认尾窗。源码明确说明,默认尾窗先挂 15 条再补到 80 条会引起可见滚动补偿。
+
+## 录制轨迹的归因
+
+`run.mjs --trace=on` 仅对独立实例录制 Chromium 轨迹,随后由 `analyze-startup.mjs`
+按 navigationId 和 renderer 主线程筛选首屏前事件。优先归类 GC、样式/布局、绘制,
+再归类包住它们的 JS,避免将同步布局同时计入 JS。各类别是不重叠的时间区间。
+
+**轨迹有额外开销,以下不能当成原始 1004ms 的精确分账,也不能按比例回推。**
+
+| 首屏前区间(ms) | 旧版 auto,wBGzrO | 修复 visible,oU6lwa |
+|---|---:|---:|
+| JS 执行,扣除其触发的下列工作 | 367 | 403 |
+| 样式计算、布局、样式表解析 | 127 | 397 |
+| 主线程绘制准备、绘制、分层和提交 | 15 | 41 |
+| GC | 28 | 29 |
+| 其他主线程工作 | 61 | 90 |
+| 不在所记录主线程任务内的间隔 | 403 | 453 |
+| 轨迹 navigationStart → FCP | 1000 | 1413 |
+
+最后一类包含加载、后台工作、调度等待等,**不能全部叫作字体或磁盘加载**。
+绘制类别也不是所有 GPU / 栅格线程 CPU 时间之和。页面 Performance API 的 FCP
+分别为 1000ms 和 1416ms,与 trace 使用的时间戳存在小幅取整差异。
+
+确认的具体热点:
+
+- 修复版首个 React `performWorkUntilDeadline` 在约 613ms 开始,持续约 617ms;
+ 这是包含样式和布局的总时间,不能与上表再相加。
+- `useUserMessageAutoCollapse` 在 `useLayoutEffect` 中读取 `getComputedStyle(el).lineHeight`
+ 和 `el.scrollHeight`。轨迹中该 `measure` 触发一次约 81ms 样式计算及约 139ms 布局,
+ 后者涉及 14,960 个布局对象。其后还有多次同源样式计算。
+- 80 条长消息的正文、Markdown 和长用户消息测量镜像一起增加了首屏 DOM / 排版工作。
+ 触发布局的读操作是同步结算点;139ms 并不等于“删除这个读操作即可节省 139ms”,
+ 浏览器最终仍需对可见内容排版。
+- 修复前后录制对照中,样式/布局差异最大,与停用布局跳过的机制相符;单组轨迹不构成稳定差值估计。
+
+## 不带轨迹的减量对照
+
+复用同一修复版冻结构建 BwfjZy,AX off、query none、seed5407、每帧更新末条、
+不滚动,各 5 秒,三组交替串行运行。均正常退出,无 JS 错误,profile 已清理。
+
+| 数据量 / 实际挂载 | 三轮 FCP(ms) | 中位数 |
+|---|---|---:|
+| 200 条 / 80 条 | 992 / 1008 / 1008 | 1008ms |
+| 15 条 / 15 条 | 580 / 596 / 580 | 580ms |
+
+差值 428ms,约 42%。这是**减少总输入与挂载量**的敏感性试验,不是保留同一组 200 条
+消息、仅修改窗口后的等价 A/B。具体文本也不同,因此只支持“首屏工作量值得优化”,
+不能承诺正式补丁一定节省 428ms。没有把默认窗口改成 15 条。
+
+## 可落地的后续方向
+
+1. 减少首帧需挂载和排版的条目,按视口与内容预算决定窗口。收益空间最大,但必须保留
+ 滚动锚点、稳定占位与补载行为,验收任务切换、贴底、向上滚动、搜索跳转和无障碍读取。
+ 不应简单将 80 改成 15 后异步补回。
+2. 优化长消息测量,研究集中读取后统一更新、减少重复镜像与非必要同步读。需保持首帧折叠正确,
+ 避免先展开再收起的闪动;不能直接删除测量或改成粗略字符数判断。
+3. 冷启动模块拆分/预热另做真实客户端性能测量。fixture 的未压缩大 chunk 是该实验的成本,
+ 不能仅凭此证明正式产品也加载了同样体积或会取得同样收益。
+
+这些方向尚未实现;本轮只增加诊断开关、轨迹分析脚本及文档,纠正既有注释,未改变生产运行逻辑。
+
+## 本机证据
+
+所有产物位于 `C:/Users/User/AppData/Local/Temp/`:
+
+- `cindy-ax5406-oU6lwa/startup-trace.json`、`startup-analysis.json`:修复版轨迹及互斥归因。
+- `cindy-ax5406-wBGzrO/startup-trace.json`、`startup-analysis.json`:旧版轨迹及归因。
+- `cindy-ax5406-oU6lwa/row-count-comparison.json`:减量对照六轮完整路径与 FCP。
+- 80 条挂载产物:N9mU4e、M2HKy5、61aeuH;15 条:NiRfhC、Gr1R9s、7CkgxO。
+
+可复核命令:
+
+```powershell
+node apps/desktop/scripts/ax5406/analyze-startup.mjs C:/Users/User/AppData/Local/Temp/cindy-ax5406-oU6lwa
+```
diff --git a/apps/desktop/scripts/ax5406/STREAM-VALIDATION.md b/apps/desktop/scripts/ax5406/STREAM-VALIDATION.md
new file mode 100644
index 0000000000..13a307e15d
--- /dev/null
+++ b/apps/desktop/scripts/ax5406/STREAM-VALIDATION.md
@@ -0,0 +1,97 @@
+# 流式输出专项验证(2026-10-03)
+
+> 后续定位已确认本负载的离底读数是绘制前中间态,实际绘制对照未复现离底。
+> 下文先保留最初失败证据,最新结果见文末「绘制时序与修改前对照」。
+
+本轮仅增加测试负载,没有修改生产代码。Windows Electron 41.10.3,AX 开启,
+实际 MessageStream 与样式、合成分片、隔离窗口;没有模型/服务端调用。
+不能代表完整安装版的端到端验证。
+
+每轮三种尺寸:1000×760 Light、620×1000 Dark、1000×420 Light。
+每种尺寸追加 400 个有序标记分片,包含中英文与基础 Markdown。
+先以 30ms 间隔输出,真实滚轮上翻接管后继续输出;End 回底,再以 10ms 间隔输出,
+最后结束流式状态并检查 400 个标记的完整性与顺序。不是复杂代码块/工具卡全组合测试。
+
+| 产物 | 历史条数 | 几何采样 | 空占位/重叠 | 完整有序分片 | 高速阶段短暂离底采样 |
+|---|---:|---:|---|---:|---|
+| `tP0rva` | 500 | 2639 | 0 / 0 | 1200 | 1 次,32px |
+| `v6zVVF` | 500,重复 | 2643 | 0 / 0 | 1200 | 0 次 |
+| `1CpCps` | 1000 | 2719 | 0 / 0 | 1200 | 3 次,32px |
+| `MmNxhv` | 1000,加密截帧 | 2713 | 0 / 0 | 1200 | 4 次,最大 184px |
+
+合计 10,714 次采样、4,800 个分片;所有尺寸的上翻阅读锚点前后偏移均为 0px,
+最终结束后的离底距离均为 0px。没有 JS/renderer console 错误或原生崩溃。
+
+**不能宣称所有画面都正常**:8 次贴底阶段的非零差值均发生在高速恢复输出中,
+距离为 32–184px,下一次采样即回到 0,相邻采样时间约 15–26ms。
+有差值的三轮仍返回 `visual-failed`,未删除或放宽断言。
+最后一轮追加截取恢复输出的首八张真实绘制帧;代表截图目检未见此前的空白正文。
+但 setTimeout 几何采样可能落在 Markdown 节流提交和 ResizeObserver 补偿之间,
+**尚未确认异常几何是否实际绘制到屏幕,也未与修改前源码作同负载对照**。
+因此只能称为待定位的跟随时序疑点,不能认定是本次视口改动引入,也不能排除。
+
+下一步应将逐帧绘制与 DOM 更新/高度补偿时序对齐,复测同负载的修改前对照。
+本轮没有据此直接修改生产滚动逻辑。
+
+产物在 `C:/Users/User/AppData/Local/Temp/cindy-ax5406-<产物>/`。
+完整原始采样为 `stream-audit.json`,原生进程结果为 `report.json`。
+四轮独立 Electron 已退出,各自临时 profile 已回收。
+单文件截图报告:`C:/Users/User/AppData/Local/Temp/cindy-ax5406-MmNxhv/stream-report.html`。
+
+```powershell
+node apps/desktop/scripts/ax5406/run.mjs --scenario=component --workload=stream-tests --rows=500 --seed=5406 --ax=on --query=none --seconds=180
+```
+
+## 绘制时序与修改前对照
+
+进一步通过 `--stream-probe=on` 记录文字 DOM 变化、rAF、scrollTop 写入及组件自己的
+ResizeObserver 之后的状态。只在测试窗口的 content 容器底边添加 12×3px 紫色绝对定位
+标记,不参与布局、不可交互、对 AX 隐藏;直接检查 Electron compositor 输出位图底部
+是否包含该标记,避免把任务队列中的几何读数当成已绘制状态。
+
+记录到的代表链路(`I2O75Z`):
+
+- 2557.7ms,Markdown DOM 更新,离底 40px;
+- 2557.9ms,rAF 读到同样的 40px;
+- 2559.0ms,已有跟随逻辑写入 scrollTop,离底归零;
+- 2559.4ms,组件高度补偿之后的 ResizeObserver 读数仍为零;
+- 实际输出图片的底边标记完整,未画出该离底状态。
+
+根因是测试的 `rAF → setTimeout → measure` 与 Markdown 的异步节流提交交错:
+任务队列可能在新 DOM 提交后、下一次 resize/绘制之前读取几何。
+Markdown 的节流提交见 `MarkdownRenderer.tsx` 中 `useStreamingThrottle`,
+贴底补偿见 `MessageStream.tsx` 的 content ResizeObserver → `pinToBottom`。
+不需要为正常的绘制前过渡状态增加生产滚动补丁。
+
+修改前对照使用 `--source=head`:构建插件只读取得 HEAD
+`d656b0fc1ec3e04548cd018654cbd6486f6cf839` 的 MessageStream 与 globals.css,
+未 checkout/覆盖/回退工作区。两个文件的 SHA-256 已与 git show 核对;
+运行态确认为 80 个已挂载正文、content-visibility:auto。
+
+| 产物 | 版本 | 贴底绘制帧 | 标记缺失帧 | 补偿后离底 | 上翻时标记消失的对照帧 |
+|---|---|---:|---:|---:|---:|
+| `I2O75Z` | 当前代码,定位轮 | 594 | 0 | 0 | 28 |
+| `1kgwKb` | 修改前 HEAD | 635 | 0 | 0 | 28 |
+| `QA86mJ` | 当前代码,修正判据后复测 | 591 | 0 | 0 | 26 |
+
+两版都能读到中间态离底,两版捕获的绘制帧都正常,说明不能据此判为此次视口改动回归。
+上翻时标记确实消失,证明检测器能区分真正离底与贴底;不是永远返回通过。
+上述 1,820 张贴底帧均执行了位图检查,代表 PNG 另有人工目检,含 Light / Dark。
+
+测试现在把中间态记入 `geometryWarnings`,不删除原始样本或历史失败产物。
+仅在开启真实绘制探针时,以绘制标记缺失、补偿后残留离底、任一跟随/恢复/结束阶段
+缺少帧、正反对照无效作为失败条件;空占位、重叠、稳态离底、阅读锚点及分片完整性
+断言继续保留。未启用探针时仍保留原保守失败行为。
+
+最终轮 `QA86mJ`:2,713 次几何采样,1,200 个分片完整有序;0 空占位、0 重叠、
+176 次补偿后检查均贴底,0 renderer 错误、0 原生崩溃,退出 completed-no-crash。
+其四个生产源文件哈希仍与工作区一致。本轮仅修改测试/诊断脚本,没有生产补丁。
+测试进程均已退出,profile 已回收。
+
+最新单文件图集:`C:/Users/User/AppData/Local/Temp/cindy-ax5406-QA86mJ/stream-diagnosis.html`。
+结论只覆盖本次 Windows 实际组件、合成分片负载及所捕获帧,不等同于整包或所有平台验收。
+
+```powershell
+node apps/desktop/scripts/ax5406/run.mjs --scenario=component --workload=stream-tests --rows=1000 --seed=5408 --ax=on --query=none --seconds=180 --stream-probe=on
+# 修改前对照额外传 --source=head;不会回退工作区。
+```
diff --git a/apps/desktop/scripts/ax5406/TEXT-ACCESS-VALIDATION.md b/apps/desktop/scripts/ax5406/TEXT-ACCESS-VALIDATION.md
new file mode 100644
index 0000000000..1497a1ca26
--- /dev/null
+++ b/apps/desktop/scripts/ax5406/TEXT-ACCESS-VALIDATION.md
@@ -0,0 +1,52 @@
+# #5406 查找、全选与分页边界回归验收
+
+2026-10-04,Windows,当前 worktree 未提交代码。完整 Desktop dev 通过
+`pnpm restart:desktop:remote --region=global --isolated=@worktree --passive`
+启动,返回 `DESKTOP_DEV_VERDICT=ready`,CDP 9546。
+
+## 修复范围
+
+- 打开页内查找时挂载当前逻辑窗口的全部正文,关闭后释放;保留阅读锚点。
+- 页面焦点为 BODY 时,Ctrl+A / Meta+A 在浏览器原生全选前补齐正文;输入框不受影响。
+- 查找结果跳转交给 MessageStream 既有滚动协调器,避免跳到历史边界时误触发扩页、让目标漂移。
+- 保留原有 80 个 render item 的逻辑窗口及扩展规则;数据库分页、游标与数据加载未修改。
+ render item 可能组合多条消息,80 不等于数据库每页消息条数。
+- 查找和全选覆盖当前逻辑窗口,不会主动检索尚未加载的全部历史。
+
+## 自动化检查
+
+9 个定向测试文件共 228 项通过,Desktop typecheck 通过,`git diff --check` 通过。
+覆盖查找挂载租约、关闭/卸载释放、阅读锚点、BODY 全选、输入框排除、滚动定位和历史窗口。
+既有 jsdom 测试中的 `Window.scrollBy()` 未实现提示不影响断言结果。
+
+## 完整客户端验收
+
+500 条消息夹具恢复出的逻辑窗口包含 71 行:
+
+- 查找打开前 61 行是占位;打开后全部正文挂载,逻辑行 ID 完全不变。
+- 打开/关闭查找的阅读锚点变化小于 1px,关闭后恢复 61 个占位。
+- 未手动滚到目标即可查到 `Question 451`,显示 1/1,跳转后目标可见。
+- 输入框 Ctrl+A 不会补齐消息正文;点击普通文本后焦点为 BODY,Ctrl+A
+ 选区含全部 71 条消息标签,32,444 字符,没有改写系统剪贴板。
+- 无 renderer pageerror 或 console error。
+
+另建两个各 100 条合成消息的隔离任务,分别验收 Light 1280×800、Dark 960×640:
+
+- 正常首次加载 40 行;查找最早一行 `Question 61:` 显示 1/1。
+- 等待 3.5 秒后目标文字仍可见,查找前后及关闭后的 40 个逻辑行 ID 完全不变。
+- 关闭后 34 行恢复为占位;没有可见占位空白。
+- 真实鼠标滚轮向上仍能加载更早历史,首行从 `boundary-60` 变为 `boundary-0`。
+- 两种模式完整 AX 树读取均成功(各 662 节点),无崩溃或 renderer 错误。
+
+## 证据及边界
+
+脚本、JSON 与真实客户端截图位于本机临时目录:
+`C:/Users/User/AppData/Local/Temp/cindy-5406-text-zEZomP/`。
+`result.json` 是查找/全选结果,`boundary.json` 是两种主题的边界与手动分页结果,
+`acceptance.html` 为内嵌截图的单文件报告。截图不提交仓库。
+CDP 截图侧栏黑底为透明窗口捕获差异,先前已用原生整窗截图核对。
+验收后通过 dev 窗口关闭按钮正常退出;PID 23132 与 CDP 9546 已结束,隔离 profile 保留。
+
+这次新增验收针对两项 review 回归及分页边界;不等同于重新执行之前全部流式压力测试,
+也不能代替缺失的原 issue 现场转储。Ctrl+A/跨行选择沿用正文保持挂载策略,
+选择后当前组件可能继续保留更多正文,避免选区失效。
diff --git a/apps/desktop/scripts/ax5406/VIEWPORT-OPTIMIZATION-RESULTS.md b/apps/desktop/scripts/ax5406/VIEWPORT-OPTIMIZATION-RESULTS.md
new file mode 100644
index 0000000000..8754a57858
--- /dev/null
+++ b/apps/desktop/scripts/ax5406/VIEWPORT-OPTIMIZATION-RESULTS.md
@@ -0,0 +1,85 @@
+# 独立视窗组件与几何索引:实现与测试数据
+
+2026-10-04,Windows,Electron 41.10.3 / Chromium 146.0.7680.216。
+
+## 结论
+
+独立视窗组件与几何索引已落地。与上一版视窗实现相比,原生滚轮累计主线程耗时下降 15.9%,程序小步滚动下降 14.1%,大幅跳滚下降 5.0%。普通滚动已接近本批 main 基线;大幅跳滚仍约为 main 的 2.23 倍,不能说已全面追平。
+
+## 本轮实现
+
+1. 新增 MessageViewport,独立持有挂载集合及视窗状态。挂载范围变化不再重跑整个 MessageStream 的元数据投影和布局 effect;保留原有 DOM 结构、行 key、卡片身份与父级滚动协调。
+2. 新增 MessageViewportGeometry,缓存行高、间距及上下偏移,二分查找可见范围。DOM 变化和逐行 ResizeObserver 标记脏行,只测量变化行及相邻行;结构、宽度等变化保留完整测量兜底。偏移数组重建仍是 O(N),并非全部处理都变为 O(log N)。
+
+保留上下 600px 缓冲、逻辑尾窗 80 项、数据分页、特殊卡片保留及文本访问规则。没有增加保留正文数量,也没有实现第三项尾行快捷更新。
+
+拆分后曾发现重新挂载再追加消息会移动阅读位置:子组件延后的首次布局覆盖了父级恢复位置。已将连接时初始化提前到父级恢复之前,并新增精确偏移保留测试。修复后的 24 步视觉回归通过。
+
+## 对照方法
+
+同机、同一份 500 条合成消息、1280×800、相同 Electron、AX 关闭。每版各 3 次,顺序分别为 main→before→after、before→after→main、after→main→before;程序操作与原生滚轮分开跑。计时期间未并行运行构建、单测、类型检查或 dev 验收。
+
+- main:此前冻结的 main 基线 25388846915a9640341c4de5feb804b3a948c8f2,本轮未重新拉取 main。
+- before:上一轮两项去重优化后的 final 构建;两份核心源码备份 SHA-256 已核对匹配。
+- after:本轮最终源码,392 份 renderer 源文件与构建清单 SHA-256 全部匹配。
+
+指标为 CDP Performance.TaskDuration 增量,三次中位数,单位 ms;代表整段操作的渲染器主线程累计工作时间,包含采样开销,不是单帧延迟、墙钟耗时或整机 CPU 百分比。只有三次样本,不能保证其他设备有同样比例收益。
+
+| 场景 | main | 优化前 | 优化后 | 较优化前 |
+|---|---:|---:|---:|---:|
+| 原生滚轮 240 次 | 891 | 1,030 | 867 | -15.9% |
+| 程序小步滚动 240×48px | 464 | 542 | 466 | -14.1% |
+| 大幅跳滚 100 次 | 809 | 1,897 | 1,802 | -5.0% |
+| 流式输出 180 段 | 1,479 | 1,374 | 1,353 | -1.5% |
+
+流式输出改善幅度很小,不能据此承诺稳定提升。原生滚轮使用 Electron sendInputEvent,±48 输入、每 60 次换向、每次等待 16ms;程序小步滚动直接写 scrollTop 后等一帧;大幅跳滚等待两帧。
+
+| 场景 | main 三次 | 优化前三次 | 优化后三次 |
+|---|---|---|---|
+| 原生滚轮 | 924 / 875 / 891 | 1,030 / 1,042 / 1,030 | 871 / 867 / 860 |
+| 程序小步 | 478 / 458 / 464 | 533 / 542 / 558 | 466 / 433 / 469 |
+| 大幅跳滚 | 809 / 830 / 807 | 1,913 / 1,897 / 1,887 | 1,813 / 1,802 / 1,795 |
+| 流式输出 | 1,479 / 1,479 / 1,493 | 1,374 / 1,456 / 1,372 | 1,353 / 1,348 / 1,365 |
+
+脚本耗时:原生滚轮 606→447ms,程序小步 320→229ms,大幅跳滚 1,237→1,154ms。大幅跳滚布局耗时 252→252ms,main 为 66ms。这支持本轮主要减少 JavaScript 工作、没有消除重新挂载和布局成本的判断;本轮没有 CPU profile 精确分摊各组件成本。
+
+首屏正文数 main/before/after 为 80/5/5,正文后代 DOM 节点为 1,789/292/292;GC 后 JS 堆中位数为 29.26/24.59/24.65MiB。没有通过扩大保留范围换取本轮收益。
+
+## 回归验收
+
+- renderer、preload、accessibilitySupportIpc:1,407 文件,16,888 项通过、1 项跳过;Desktop 类型检查通过,git diff --check 通过。
+- 三版本性能用例共 6,840 次几何采样,未发现可见占位或重叠;9 轮流式基准各 180 段文本完整有序。
+- 最终代码加强滚动:5,138 次采样,三种窗口/主题组合,快慢滚轮、反向、键盘、滚动条拖动、程序跳转、查找、回到底部,失败 0。
+- 24 步视觉回归通过,包括异步正文增高、图片加载、宽度变化、主题切换、重新挂载、追加消息、展开。
+- 文本访问:嵌套/横向定位两项通过,AX 初始关闭/开启及运行时切换两组通过。
+- 流式实际绘制验收:三种窗口/主题组合各 400 段,共 1,200 段完整有序;2,571 次几何采样,521 个实际跟随绘制帧无尾部标记缺失;29 个离底负对照帧,163 次尺寸补偿后检查无底部缺口。
+- 完整 dev 隔离沙盒:复用既有测试任务;7 次进入/切换,Light/Dark×960×640、1280×800、1600×900,240 次滚动检查无可见占位、重叠或页面 JS 错误。
+- 独立生成文件清单:同上双主题三尺寸,6→7 项展开、离屏仍挂载、返回保留展开、无横向溢出;96 次定向滚动检查通过,任务切换/刷新后唯一清单和 7 项内容正确。
+- 本轮修改文件树:历史轮 5 个 note 文件与新轮 7 个 file-list 文件范围正确;双主题三尺寸、筛选单项/无结果/恢复、逐项选择、任务切换均通过。
+
+本轮复用以前真实工具生成的文件与卡片,没有重新调用联网模型生成文件,也没有重新测试媒体预览。
+
+## 失败记录与边界
+
+- 初版拆分引起的阅读位置回归已修复,未放宽断言。
+- 第一次最终流式补测进程提前退出、没有有效场景结果;发生在 dev 启动期间,未证明退出原因。关闭 dev 后单独重跑。
+- 未启用实际绘制探针的重跑捕获一次 32px 瞬态底部距离,保守断言失败,原始记录保留。随后使用此前已有、未修改的 stream-probe=on 验收:记录到一次绘制前 80px 几何偏差,但实际绘制和 ResizeObserver 补偿后检查均通过。不能将“绘制通过”写成“任意时刻 DOM 读数都为零”,也不能把后一轮探针结果当成前一轮同一帧的截图证明。
+- 文本访问脚本首次因输出目录缺失而失败,建立目录后重跑通过。
+- 原始 issue 转储仍缺失;本轮未重跑原生 AX 压力崩溃对照,不能扩大为所有闪退已解决。未验证 macOS 或正式安装包。
+
+## 证据
+
+本轮目录:C:/Users/User/AppData/Local/Temp/cindy-5406-index-rU5lEn。
+
+- summary.json;final-perf/perf-all.json;wheel-perf/perf-all.json:汇总与三版本原始数据。
+- current/component-sources.json、source-verification.json:最终源码校验。
+- unit-final.log、typecheck-final.log、text-access-final/text-access.json。
+- dev/:启动 ready 记录、UI 结果 JSON、真实客户端截图;REPORT.html 为内嵌截图的单文件报告。
+- 滚动:C:/Users/User/AppData/Local/Temp/cindy-ax5406-suuj1Z/scroll-audit.json。
+- 视觉:C:/Users/User/AppData/Local/Temp/cindy-ax5406-nn2QKJ/visual-steps.json。
+- 无绘制探针的保守失败:C:/Users/User/AppData/Local/Temp/cindy-ax5406-5OnFJT/stream-audit.json。
+- 实际绘制验收:C:/Users/User/AppData/Local/Temp/cindy-ax5406-KLGji6/stream-audit.json。
+
+已目检 dev 的浅深主题消息区、文件清单与文件树。CDP 截图没有合成侧栏的原生透明背景,不据此评定毛玻璃外观。截图未加入工程目录。
+
+改动留在当前 worktree,未提交、未推送;本轮测试与 dev 进程已退出。
diff --git a/apps/desktop/scripts/ax5406/VIEWPORT-VALIDATION.md b/apps/desktop/scripts/ax5406/VIEWPORT-VALIDATION.md
new file mode 100644
index 0000000000..aaa3f72c91
--- /dev/null
+++ b/apps/desktop/scripts/ax5406/VIEWPORT-VALIDATION.md
@@ -0,0 +1,112 @@
+# #5406:视口挂载方案与画面验收
+
+> 后续逐帧滚动压力测试发现了稳定截图未覆盖的瞬时闪空,以及长历史回底目标过期问题。
+> 已补修真实滚动/回底路径;直接在 rAF 中改 scrollTop 的诊断负载仍有空帧。
+> 当前结论以 [增强滚动测试](SCROLL-VALIDATION.md) 为准,不应将本文旧结果解读为任意滚动时序无异常。
+
+2026-10-03,基线 `d656b0fc1ec3e04548cd018654cbd6486f6cf839`。
+本报告接续 [首次止崩验证](FIX-VALIDATION.md),后者的 236ms 是上一阶段方案的代价。
+
+## 实现
+
+采用视口挂载与普通布局,根据消息条目和状态生命周期管理正文挂载范围:
+
+- `useMessageViewport` 只挂载视口上下各 600px 范围内的历史普通消息正文;
+ 其他正文使用实测高度占位,未测量时估计 240px。占位保留稳定条目 key 与定位 id。
+- 沿用既有逻辑尾窗、向前扩窗、搜索定位与滚动快照。恢复时读取已有高度缓存;
+ 正文与占位切换时按阅读锚点补偿;贴底时保持尾部位置。
+- 工具/计划等复杂卡片、系统卡、流式消息、搜索目标保持挂载。
+ 点击或获得焦点的消息在本次 MessageStream 生命周期内保留,保护展开、编辑与媒体状态。
+- 分享选择模式挂载当前逻辑窗口的全部正文。Tab、Ctrl/Cmd+A 或非空文本选择也会保留全部
+ 已加载正文,直到组件重挂载,优先保证键盘遍历与选择;因此并非任何操作后都维持低挂载数。
+- 消息行仍使用 `content-visibility: visible` / `contain-intrinsic-size: none`。
+ 没有关闭无障碍、更新 Electron 或缩减存储/加载的消息数量。
+
+复杂卡片保留挂载,已交互消息也不会回收;
+长时间浏览时的挂载数量可以增加。浏览器原生全文查找不能依赖已卸载的正文;
+应用自身基于消息数据的搜索定位继续将目标挂载。
+
+## 画面和交互
+
+`visual.cjs` 驱动真实 Electron 中的正式 MessageStream / UserMessage / AssistantMessage,
+使用真实主题、字体及 CSS,输入 200 条合成消息;没有后端、账号或真实用户消息。
+这属于真实组件集成验收,**不等同于完整已安装客户端的验收**。
+
+运行命令:
+
+```powershell
+node apps/desktop/scripts/ax5406/run.mjs --scenario=component --workload=visual --rows=200 --ax=off --query=none --seconds=120
+node apps/desktop/scripts/ax5406/visual-gallery.mjs <AX5406_ARTIFACTS>
+```
+
+通过的覆盖项:
+
+1. 首次进入贴底、滚动至历史;正文挂载 2–9 条,不计算占位壳。
+2. 连续五次大幅滚动,在每次滚动后的两帧检查视口,没有剩余空白占位。
+3. 异步正文增高、图片实际解码成功;当前阅读条目偏移误差不超过 2px。
+4. 顶部扩窗、搜索目标落入视口、宽窄窗口切换、Light / Dark。
+5. 组件重挂载、阅读时追加消息保持位置;此处重挂载没有模拟完整任务数据恢复。
+6. 长用户消息展开,滚离后仍展开,返回后状态保留。
+7. 点击返回底部、继续追加消息,底部误差不超过 2px。
+8. 键盘全选前恢复逻辑窗口全部正文,保持贴底。
+
+逐阶段验证没有空视口、可见占位、行重叠或 renderer JavaScript 错误,保存原始截图与坐标。
+人工查看浅色正文/图片、深色窄窗、展开长消息与深色尾部,没有发现新增的文字重叠、
+异常裁切或错位。截图中的黄色/棕色背景是既有搜索定位高亮。
+450ms 后的稳定截图不证明任意中间帧都没有闪动;快速滚动另有两帧检查。
+
+初轮增强脚本曾未触发图片/展开操作:增长后的助手正文占满视口、选中的用户正文不够长。
+修正为先定位图片所在消息、显式增长用户正文后点击真实展开按钮,保留失败产物 `KOk7uy`,
+没有删除断言。修正后 `sneAxU`、`D4TDRW`、`rmaKWj` 均通过;最终图集另记录于交付结果。
+
+最终源码重新构建的 `izEs2v` 再次通过全部检查,共 18 张稳定状态截图和五次快速滚动检查。
+`component-sources.json` 中 hook SHA-256 与工作区文件一致:
+`842e124233eb2b95933824b3b4a9594154ec55ff6a3ba669c085740de5f57360`。
+单文件图集位于该产物目录的 `visual-report.html`。
+
+## 原生崩溃压力验证
+
+以下均为修复后的真实组件冻结构建 `KOk7uy`,AX 开启、消息行样式来自生产 CSS。
+相比最终代码,此构建仅缺少“首帧范围已吻合时,首次滚动仍补偿锚点”的边界修正及注释调整;
+该边界另有 hook 回归测试和最终截图复跑。
+
+| 负载 | 时长 | 文本更新 | 查询 | 结果/产物后缀 |
+|---|---:|---:|---|---|
+| 流式/结束循环、随机滚动、UIA + CDP | 121,277ms | 11,760 | 194 次 CDP;1,001 次原生行范围查询 | 未崩溃,无 dump / JS 错误;`Bulsr3` |
+| 持续更新助手正文、随机滚动、无主动查询 | 120,548ms | 10,296 | 正常 AX 生命周期 | 未崩溃,无 dump / JS 错误;`w0DrUP` |
+
+共 22,056 次更新。第一轮 UIA 还记录 47 次“模式不可用”:它先枚举支持 TextPattern 的节点,
+再取模式,期间列表正在动态挂载/卸载。保留这些记录,不能宣称零查询错误或完整读屏功能验收。
+旧版同签名阳性对照见 [组件复现](COMPONENT-REPRO.md) 与 [选择性 auto 实验](SELECTIVE-AUTO-EXPERIMENT.md)。
+有界压力验证不能证明所有负载永不崩溃;原 Issue 0.1.96 现场 dump 仍缺失。
+
+最终源码 `izEs2v` 冻结构建又跑了 60,263ms 的 AX + UIA + CDP 循环压力测试,
+5,728 次更新、105 次 CDP、613 次原生行范围查询,无崩溃、dump 或 JS 错误,产物 `BaJeGL`。
+UIA 模式不可用记录 27 次,限制同上。三轮累计 27,784 次文本更新。
+
+## 首帧对照
+
+`benchmark-component.mjs BwfjZy KOk7uy`,同机交替三轮,AX 均关闭,200 条数据、尾窗 80 条,
+只更新最后一条助手消息,不滚动。此前 fixture 把 40 条历史助手消息都标为 streaming,
+新方案会保留它们;因此该基准的新方案实际仍挂载约 42 条正文,不是正常浏览的 2–9 条。
+旧冻结构建与新版共享消息生成和 steady 负载;新版 fixture 另加入视觉操作分支和深色主题导入,
+属于组件方案对照,不能视为只有 hook 指令不同的微基准。
+
+| 方案 | 三轮首次内容绘制(ms) | 中位数 |
+|---|---|---:|
+| 第一阶段:普通布局、全部 80 条正文挂载 | 1004 / 1072 / 1012 | 1012 |
+| 本阶段:普通布局、按视口挂载并保留 streaming | 848 / 848 / 888 | 848 |
+
+减少 164ms,约 16.2%。这个数包含独立页模块、字体和首次组件加载,**不是客户端任务切换延迟**。
+六轮均正常退出,原始数据在 `cindy-ax5406-benchmark-b0v9PS/results.json`。
+滚动锚点最后的小修正在这组测量之后;未将不同阶段的数字混称最终源码精确性能门禁。
+
+## 自动检查和范围
+
+- 9 个相关测试文件共 105 项通过,1 项原有 focused-only 50k 压测跳过。
+ 新增 hook 用例覆盖挂载范围、占位高度、阅读恢复、首次滚动补偿、交互保留、分享与键盘选择。
+- Desktop 类型检查、dump 签名解析器、脚本语法检查、`git diff --check`。
+- 原始截图/dump/构建产物放在 OS 临时目录,不提交到工程;图集是内嵌截图的单文件 HTML。
+- 未验证完整客户端账号流程、复杂工具卡各自的完整交互、macOS 或移动端原生页面。
+- 本次未提交、推送或发布;正在运行的正式 Cindy 不会因 worktree 改动自动生效。
+- 测试结束后确认本次 AX5406 Electron 进程已全部退出,独立 profile 已清理。
diff --git a/apps/desktop/scripts/ax5406/analyze-startup.mjs b/apps/desktop/scripts/ax5406/analyze-startup.mjs
new file mode 100644
index 0000000000..2e8935641d
--- /dev/null
+++ b/apps/desktop/scripts/ax5406/analyze-startup.mjs
@@ -0,0 +1,45 @@
+// Analyze only the fixture renderer's main thread before its first contentful paint.
+// Buckets are disjoint wall-time intervals, not additive inclusive trace durations.
+import fs from 'node:fs/promises';
+import path from 'node:path';
+const root = process.argv[2];
+if (!root) throw new Error('Expected trace run directory');
+const { traceEvents: events } = JSON.parse(await fs.readFile(path.join(root, 'startup-trace.json'), 'utf8'));
+const nav = events.find(e => e.name === 'navigationStart' && e.args?.data?.documentLoaderURL?.includes('component.html'));
+if (!nav) throw new Error('Fixture navigation missing');
+const paint = events.find(e => e.name === 'firstContentfulPaint' && e.pid === nav.pid &&
+ e.args?.data?.navigationId === nav.args.data.navigationId);
+if (!paint) throw new Error('Matching first contentful paint missing');
+const main = events.filter(e => e.pid === nav.pid && e.tid === nav.tid && e.ph === 'X' &&
+ e.ts < paint.ts && e.ts + e.dur > nav.ts);
+function category(e) {
+ if (['MinorGC', 'MajorGC'].includes(e.name)) return 'gc';
+ if (['Layout', 'UpdateLayoutTree', 'ParseAuthorStyleSheet'].includes(e.name)) return 'style-layout';
+ if (['PrePaint', 'Paint', 'Layerize', 'Commit'].includes(e.name)) return 'paint';
+ if (['FunctionCall', 'EvaluateScript', 'v8.evaluateModule', 'v8.compile', 'v8.compileModule',
+ 'RunMicrotasks', 'FireAnimationFrame', 'TimerFire'].includes(e.name)) return 'js';
+ if (e.name === 'RunTask') return 'other-main';
+ return null;
+}
+const priority = ['gc', 'style-layout', 'paint', 'js', 'other-main'];
+const tagged = main.map(e => ({ start: Math.max(e.ts, nav.ts), end: Math.min(e.ts + e.dur, paint.ts),
+ category: category(e) })).filter(e => e.category);
+const points = [...new Set([nav.ts, paint.ts, ...tagged.flatMap(e => [e.start, e.end])])].sort((a, b) => a - b);
+const buckets = {};
+for (let i = 0; i < points.length - 1; i++) {
+ const start = points[i], end = points[i + 1];
+ const active = new Set(tagged.filter(e => e.start <= start && e.end >= end).map(e => e.category));
+ const key = priority.find(c => active.has(c)) || 'outside-main-tasks';
+ buckets[key] = (buckets[key] || 0) + (end - start) / 1000;
+}
+const result = { trace: path.join(root, 'startup-trace.json'), firstContentfulPaintMs: (paint.ts - nav.ts) / 1000,
+ bucketsMs: buckets,
+ // Inclusive hotspots explain causality; they overlap the buckets and must NOT be added to them.
+ inclusiveHotspots: main.filter(e => ['FunctionCall', 'Layout', 'UpdateLayoutTree', 'v8.evaluateModule'].includes(e.name))
+ .sort((a, b) => b.dur - a.dur).slice(0, 12).map(e => ({ name: e.name, startMs: (e.ts - nav.ts) / 1000,
+ durationMs: e.dur / 1000, args: e.args })),
+ caveats: ['Tracing adds overhead; not a decomposition of earlier untraced median.',
+ 'Outside-main-tasks includes loading, background work and scheduling; it is not all disk or font I/O.',
+ 'Paint bucket covers renderer main thread only, not all GPU/raster CPU time.'] };
+await fs.writeFile(path.join(root, 'startup-analysis.json'), JSON.stringify(result, null, 2));
+console.log(JSON.stringify({ root, firstContentfulPaintMs: result.firstContentfulPaintMs, bucketsMs: buckets }));
diff --git a/apps/desktop/scripts/ax5406/benchmark-component.mjs b/apps/desktop/scripts/ax5406/benchmark-component.mjs
new file mode 100644
index 0000000000..b657e5984c
--- /dev/null
+++ b/apps/desktop/scripts/ax5406/benchmark-component.mjs
@@ -0,0 +1,38 @@
+/** Compare two recorded component builds on one machine, sequentially.
+ * AX is off in BOTH cases so the unfixed control can finish. This measures the
+ * fixture, not production session-switch latency or accessibility performance.
+ * node benchmark-component.mjs <baseline-build-root> <fixed-build-root>
+ */
+import fs from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import { spawn } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+const [baseline, fixed] = process.argv.slice(2);
+if (!baseline || !fixed) throw new Error('Expected baseline and fixed build roots');
+for (const root of [baseline, fixed]) await fs.access(path.join(root, 'component/component.html'));
+const output = await fs.mkdtemp(path.join(os.tmpdir(), 'cindy-ax5406-benchmark-'));
+const results = [];
+for (let iteration = 0; iteration < 3; iteration++) {
+ for (const [label, root] of [['baseline', baseline], ['fixed', fixed]]) {
+ const child = spawn(process.execPath, [fileURLToPath(new URL('./run.mjs', import.meta.url)),
+ '--scenario=component', `--component-build=${root}`, '--seconds=15', '--ax=off', '--query=none',
+ '--rows=200', '--batch=1', '--target=tail', '--scroll=off', '--seed=5407'],
+ { windowsHide: true, stdio: ['ignore', 'pipe', 'inherit'] });
+ let stdout = '';
+ child.stdout.on('data', data => { stdout += data; });
+ const code = await new Promise((resolve, reject) => { child.once('close', resolve); child.once('error', reject); });
+ const runRoot = /^AX5406_ARTIFACTS=(.+)$/m.exec(stdout)?.[1]?.trim();
+ if (!runRoot) throw new Error(`No artifact root for ${label}: ${stdout}`);
+ const report = JSON.parse(await fs.readFile(path.join(runRoot, 'report.json'), 'utf8'));
+ const row = { label, iteration, code, status: report.status, report: path.join(runRoot, 'report.json'),
+ firstContentfulPaintMs: report.performance?.['first-contentful-paint'],
+ commits: report.stats?.commits, mutations: report.stats?.mutations,
+ mountedRows: report.stats?.renderedRows, containment: report.stats?.containment };
+ results.push(row);
+ await fs.writeFile(path.join(output, 'results.json'), JSON.stringify(results, null, 2));
+ console.log(JSON.stringify(row));
+ if (code !== 0 || report.status !== 'completed-no-crash') throw new Error(`Benchmark case failed: ${label}`);
+ }
+}
+console.log(`AX5406_BENCHMARK=${output}`);
diff --git a/apps/desktop/scripts/ax5406/build-component.mjs b/apps/desktop/scripts/ax5406/build-component.mjs
new file mode 100644
index 0000000000..b22bdd522c
--- /dev/null
+++ b/apps/desktop/scripts/ax5406/build-component.mjs
@@ -0,0 +1,38 @@
+import { build } from 'vite';
+import react from '@vitejs/plugin-react';
+import tailwind from 'tailwindcss';
+import loadTailwindConfig from 'tailwindcss/loadConfig.js';
+import autoprefixer from 'autoprefixer';
+import path from 'node:path';
+import fs from 'node:fs/promises';
+import { fileURLToPath } from 'node:url';
+import { createHash } from 'node:crypto';
+import { execFileSync } from 'node:child_process';
+
+export async function buildComponent(output, source = 'worktree') {
+ const root = path.dirname(fileURLToPath(import.meta.url));
+ const desktop = path.resolve(root, '../..');
+ const inputs = {};
+ const overrides = new Map();
+ if (source === 'head') {
+ for (const file of ['src/renderer/components/chat/MessageStream.tsx', 'src/renderer/styles/globals.css']) {
+ overrides.set(path.join(desktop, file).replaceAll('\\', '/'),
+ execFileSync('git', ['show', `HEAD:apps/desktop/${file}`], { cwd: desktop, encoding: 'utf8' }));
+ }
+ }
+ const tailwindConfig = loadTailwindConfig(path.join(desktop, 'tailwind.config.ts'));
+ tailwindConfig.content = [path.join(desktop, 'src/renderer/**/*.{ts,tsx,html}').replaceAll('\\', '/')];
+ await build({ configFile: false, root, base: './', publicDir: false, logLevel: 'warn',
+ plugins: [{ name: 'read-only-head-comparison', enforce: 'pre', load(id) {
+ return overrides.get(id.replaceAll('\\', '/'));
+ } }, react(), { name: 'record-real-source', async transform(code, id) {
+ if (id.replaceAll('\\', '/').includes('/src/renderer/') && !id.includes('?')) inputs[path.relative(desktop, id)] = createHash('sha256').update(overrides.get(id.replaceAll('\\', '/')) ?? await fs.readFile(id)).digest('hex');
+ } }],
+ resolve: { alias: { '@': path.join(desktop, 'src/renderer') } },
+ css: { postcss: { plugins: [tailwind(tailwindConfig), autoprefixer()] } },
+ build: { target: 'chrome146', outDir: path.join(output, 'component'), emptyOutDir: false,
+ minify: false, sourcemap: true, rollupOptions: { input: path.join(root, 'component.html') } },
+ });
+ await fs.writeFile(path.join(output, 'component-sources.json'), JSON.stringify(inputs, null, 2));
+ return path.join(output, 'component/component.html');
+}
diff --git a/apps/desktop/scripts/ax5406/component.html b/apps/desktop/scripts/ax5406/component.html
new file mode 100644
index 0000000000..f671eadb46
--- /dev/null
+++ b/apps/desktop/scripts/ax5406/component.html
@@ -0,0 +1,3 @@
+<!doctype html>
+<html><head><meta charset="UTF-8"><meta http-equiv="Content-Security-Policy" content="default-src 'self' data:; script-src 'self'; style-src 'self' 'unsafe-inline'; connect-src 'none'; img-src 'self' data:; font-src 'self' data:"><title>AX5406 MessageStream experiment</title></head>
+<body><div id="root" style="height:100vh;display:flex;flex-direction:column"></div><script type="module" src="./component.jsx"></script></body></html>
diff --git a/apps/desktop/scripts/ax5406/component.jsx b/apps/desktop/scripts/ax5406/component.jsx
new file mode 100644
index 0000000000..dcbfb69712
--- /dev/null
+++ b/apps/desktop/scripts/ax5406/component.jsx
@@ -0,0 +1,165 @@
+// Real component graph, synthetic props, no preload or live backend.
+import React, { useEffect, useLayoutEffect, useState } from 'react';
+import { createRoot } from 'react-dom/client';
+import { MemoryRouter } from 'react-router-dom';
+import i18n from 'i18next';
+import { initReactI18next } from 'react-i18next';
+import '@fontsource-variable/inter';
+import '@fontsource-variable/jetbrains-mono';
+import 'harmonyos-sans-sc-webfont-splitted';
+import '../../src/renderer/themes/colors';
+import { themeService } from '../../src/renderer/themes/theme-service';
+import { cindyLight } from '../../src/renderer/themes/builtin/cindy-light';
+import { cindyDark } from '../../src/renderer/themes/builtin/cindy-dark';
+import common from '../../src/renderer/i18n/locales/en/common.json';
+import '../../src/renderer/styles/globals.css';
+
+const options = Object.fromEntries(new URLSearchParams(location.search));
+const stats = window.ax5406Stats = { mutations: 0, commits: 0, errors: [], component: 'MessageStream', renderedRows: 0 };
+addEventListener('error', event => stats.errors.push(String(event.error?.stack || event.message)));
+addEventListener('unhandledrejection', event => stats.errors.push(String(event.reason?.stack || event.reason)));
+// No recursive proxy: missing IPC capabilities remain missing, not silently successful.
+let accessibilityEnabled = options.accessibility === 'on';
+const accessibilityListeners = new Set();
+window.ax5406Accessibility = enabled => {
+ accessibilityEnabled = enabled;
+ accessibilityListeners.forEach(callback => callback(enabled));
+};
+window.electronAPI = { platform: 'win32', logToMain() {}, accessibilitySupport: {
+ getSync: () => accessibilityEnabled,
+ onChanged(callback) { accessibilityListeners.add(callback); callback(accessibilityEnabled); return () => accessibilityListeners.delete(callback); },
+} };
+document.documentElement.lang = 'en';
+themeService.applyTheme(cindyLight);
+const { applyFontSettings, getInitialFontSettings } = await import('../../src/renderer/hooks/useFontSettings');
+applyFontSettings(getInitialFontSettings());
+await i18n.use(initReactI18next).init({ lng: 'en', fallbackLng: 'en', defaultNS: 'common', resources: { en: { common } }, interpolation: { escapeValue: false } });
+const { MessageStream } = await import('../../src/renderer/components/chat/MessageStream');
+const { ConfirmDialogProvider } = await import('../../src/renderer/components/ui/confirm-dialog-provider');
+const { Tooltip } = await import('../../src/renderer/components/ui/tooltip');
+if (options.containment === 'off') {
+ const style = document.createElement('style');
+ style.textContent = '.msg-stream-items > * { content-visibility: visible !important; contain-intrinsic-size: none !important; }';
+ document.head.append(style);
+}
+let seed = Number(options.seed) || 5406;
+function random() { seed ^= seed << 13; seed ^= seed >>> 17; seed ^= seed << 5; return (seed >>> 0) / 4294967296; }
+function text(index, step) {
+ return `Synthetic row ${index}, update ${step}.\n\n` +
+ ('Ordinary text with **bold text** and *inline emphasis* for wrapping. 中文无障碍文本布局。 '.repeat(3 + Math.floor(random() * 12))) +
+ '\n\n' + 'Pending streaming text '.repeat(2 + step % 12);
+}
+function Fixture() {
+ const [generation, setGeneration] = useState(0);
+ const [focusId, setFocusId] = useState();
+ const [sessionStreaming, setSessionStreaming] = useState(true);
+ const [messages, setMessages] = useState(() => Array.from({ length: Number(options.rows) || 80 }, (_, i) => ({
+ clientId: `synthetic-${i}`, role: i % 2 ? 'assistant' : 'user', content: text(i, 0),
+ isStreaming: options.workload === 'visual' ? i === Number(options.rows) - 1 : i % 2 === 1,
+ })));
+ useLayoutEffect(() => {
+ stats.commits++;
+ const items = document.querySelector('.msg-stream-items');
+ stats.renderedRows = items?.children.length || 0;
+ stats.mountedBodies = items ? items.querySelectorAll(':scope > :not([data-message-placeholder])').length : 0;
+ stats.containment = items?.firstElementChild ? getComputedStyle(items.firstElementChild).contentVisibility : null;
+ const scroller = document.querySelector('[data-scroll-container]');
+ stats.layout = { display: items ? getComputedStyle(items).display : null,
+ gap: items ? getComputedStyle(items).rowGap : null,
+ overflowY: scroller ? getComputedStyle(scroller).overflowY : null,
+ height: scroller?.clientHeight, scrollHeight: scroller?.scrollHeight,
+ fontFamily: getComputedStyle(document.body).fontFamily };
+ stats.domTextLength = items?.textContent.length || 0;
+ // Verify the experiment's actual computed row styles on every commit, before AX work.
+ // All compared policies run these same reads. This is diagnostic overhead.
+ if (options.policy && options.policy !== 'production') {
+ const activeIds = new Set(messages.filter(m => m.isStreaming).map(m => m.clientId));
+ const counts = { auto: 0, visible: 0, activeAuto: 0 };
+ for (const row of items?.children || []) {
+ const visibility = getComputedStyle(row).contentVisibility;
+ counts[visibility] = (counts[visibility] || 0) + 1;
+ if (visibility === 'auto' && activeIds.has(row.dataset.messageClientId)) counts.activeAuto++;
+ }
+ stats.policy = options.policy;
+ stats.rowStyles = counts;
+ stats.maxActiveAuto = Math.max(stats.maxActiveAuto || 0, counts.activeAuto);
+ stats.activeCommits = (stats.activeCommits || 0) + Number(activeIds.size > 0);
+ stats.settledCommits = (stats.settledCommits || 0) + Number(activeIds.size === 0);
+ }
+ });
+ useEffect(() => {
+ if (options.workload === 'visual') {
+ window.ax5406Visual = {
+ streamStart() {
+ setSessionStreaming(true);
+ setMessages(previous => previous.map((m, i) => i === previous.length - 1
+ ? { ...m, content: '', isStreaming: true } : { ...m, isStreaming: false }));
+ stats.mutations++;
+ },
+ streamChunk(chunk) {
+ setMessages(previous => previous.map((m, i) => i === previous.length - 1
+ ? { ...m, content: m.content + chunk } : m));
+ stats.mutations++;
+ },
+ streamFinish() {
+ setMessages(previous => previous.map(m => ({ ...m, isStreaming: false })));
+ setSessionStreaming(false);
+ stats.mutations++;
+ },
+ theme(dark) { themeService.applyTheme(dark ? cindyDark : cindyLight); },
+ remount() { setGeneration(value => value + 1); },
+ focus(id) { setFocusId(id); },
+ grow(id) { setMessages(previous => previous.map(m => m.clientId === id
+ ? { ...m, content: m.content + '\n\n' + 'Asynchronously added content. '.repeat(150) } : m)); stats.mutations++; },
+ image(id) {
+ const canvas = document.createElement('canvas'); canvas.width = 640; canvas.height = 320;
+ const context = canvas.getContext('2d'); context.fillStyle = '#3b82f6'; context.fillRect(0, 0, 640, 320);
+ context.fillStyle = 'white'; context.font = '32px sans-serif'; context.fillText('Async image fixture', 40, 160);
+ const base64 = canvas.toDataURL('image/png').split(',')[1];
+ setMessages(previous => previous.map(m => m.clientId === id
+ ? { ...m, images: [{ base64, mimeType: 'image/png', originalName: 'fixture.png' }] } : m)); stats.mutations++;
+ },
+ append() { setMessages(previous => [...previous.map(m => ({ ...m, isStreaming: false })),
+ { clientId: `synthetic-${previous.length}`, role: 'user', content: 'A new user message.' },
+ { clientId: `synthetic-${previous.length + 1}`, role: 'assistant', content: 'A new streaming reply.', isStreaming: true }]); stats.mutations++; },
+ };
+ return () => { delete window.ax5406Visual; };
+ }
+ let frame, step = 0;
+ function tick() {
+ step++;
+ setMessages(previous => {
+ const active = options.workload !== 'cycle' || step % 120 < 90;
+ const next = options.workload === 'cycle'
+ ? previous.map(m => ({ ...m, isStreaming: active && m.role === 'assistant' }))
+ : [...previous];
+ for (let n = 0; active && n < Number(options.batch || 1); n++) {
+ let index = Math.floor(random() * next.length);
+ if (options.target === 'tail') index = next.length - 1;
+ else if (options.target === 'assistant') index = Math.min(next.length - 1, index | 1);
+ else if (options.target === 'user') index &= ~1;
+ next[index] = { ...next[index], content: text(index, step) };
+ stats.mutations++;
+ }
+ return next;
+ });
+ if (options.scroll !== 'off' && step % 12 === 0) {
+ const scroller = document.querySelector('[data-scroll-container]');
+ if (scroller) scroller.scrollTop = random() * scroller.scrollHeight;
+ }
+ frame = requestAnimationFrame(tick);
+ }
+ // Allow initial render and native AX tree registration before changing props.
+ const timer = setTimeout(() => { frame = requestAnimationFrame(tick); }, 1200);
+ return () => { clearTimeout(timer); cancelAnimationFrame(frame); };
+ }, []);
+ const base = '.msg-stream-items > * { content-visibility: auto !important; contain-intrinsic-size: auto 240px !important; }';
+ const activeSelectors = messages.filter(m => m.isStreaming).map(m =>
+ `.msg-stream-items > [data-message-client-id="${m.clientId}"]`);
+ const override = options.policy === 'active' && activeSelectors.length
+ ? `${activeSelectors.join(',')} { content-visibility: visible !important; contain-intrinsic-size: none !important; }` : '';
+ return <>{['auto', 'active'].includes(options.policy) && <style>{base + override}</style>}
+ <MessageStream key={generation} workingDir="" messages={messages} historyLoaded hasMoreMessages={false}
+ focusMessageClientId={focusId} isSessionStreaming={sessionStreaming} contentWidth={880} /></>;
+}
+createRoot(document.getElementById('root')).render(<MemoryRouter><ConfirmDialogProvider><Tooltip.Provider><Fixture /></Tooltip.Provider></ConfirmDialogProvider></MemoryRouter>);
diff --git a/apps/desktop/scripts/ax5406/fixture.html b/apps/desktop/scripts/ax5406/fixture.html
new file mode 100644
index 0000000000..ffc7b0c68a
--- /dev/null
+++ b/apps/desktop/scripts/ax5406/fixture.html
@@ -0,0 +1,21 @@
+<!doctype html>
+<meta charset="utf-8">
+<meta http-equiv="Content-Security-Policy" content="default-src 'none'; script-src 'self'; style-src 'unsafe-inline'">
+<title>AX5406 synthetic text fixture</title>
+<style>
+ :root { color-scheme: light dark; }
+ body { font: 16px/1.5 sans-serif; margin: 0; }
+ #viewport { height: 660px; overflow: auto; overflow-anchor: none; }
+ #items { display: flex; flex-direction: column; gap: 14px; }
+ #items > article { content-visibility: auto; contain-intrinsic-size: auto 240px; }
+ body.no-containment #items > article { content-visibility: visible !important; contain-intrinsic-size: none; }
+ article { padding: 12px; }
+ p { white-space: pre-wrap; overflow-wrap: anywhere; }
+ pre { white-space: pre-wrap; }
+ .ellipsis { overflow: hidden; white-space: nowrap; text-overflow: ellipsis; }
+ .clamp { display: -webkit-box; -webkit-box-orient: vertical; -webkit-line-clamp: 2; overflow: hidden; }
+ .first::first-letter { float: left; font-size: 200%; }
+</style>
+<main id="viewport"><div id="items" role="log" aria-live="polite"></div></main>
+<!-- No user content, accounts, network, OS input, or application preload. -->
+<script src="fixture.js"></script>
diff --git a/apps/desktop/scripts/ax5406/fixture.js b/apps/desktop/scripts/ax5406/fixture.js
new file mode 100644
index 0000000000..8ce9090352
--- /dev/null
+++ b/apps/desktop/scripts/ax5406/fixture.js
@@ -0,0 +1,85 @@
+/* Deterministic DOM/layout workload, not an artificial crash injection. */
+(() => {
+ const params = new URLSearchParams(location.search);
+ let random = Number(params.get('seed')) >>> 0;
+ const scenario = params.get('scenario');
+ const items = document.getElementById('items');
+ const viewport = document.getElementById('viewport');
+ document.body.classList.toggle('no-containment', params.get('containment') === 'off');
+ const stats = { frames: 0, mutations: 0, replacements: 0, scrolls: 0, layoutReads: 0 };
+ window.ax5406Stats = stats;
+ const next = () => {
+ random ^= random << 13; random ^= random >>> 17; random ^= random << 5;
+ return random >>> 0;
+ };
+ const text = 'Synthetic alpha beta gamma 中文文本 한글 العربية 👩‍💻 ffi ABC 0123456789. ';
+ function article(index) {
+ const root = document.createElement('article');
+ root.dataset.index = String(index);
+ if (scenario === 'minimal') {
+ root.innerHTML = `<p><span>${text.repeat(3)}</span><b>stable sibling</b><span>tail</span></p>`;
+ return root;
+ }
+ root.innerHTML = `<p><span>${text.repeat(3)}</span><b>strong</b><span> tail</span></p>` +
+ `<details open><summary>Tool ${index}</summary><pre><code>${text.repeat(2)}</code></pre></details>`;
+ return root;
+ }
+ for (let i = 0; i < Number(params.get('rows') || 80); i++) items.append(article(i));
+ function frame() {
+ for (let k = 0; k < Number(params.get('batch') || 8); k++) {
+ const index = next() % items.children.length;
+ const root = items.children[index];
+ const p = root.firstElementChild;
+ if (scenario === 'minimal') {
+ p.firstChild.textContent = text.repeat(1 + next() % 12);
+ stats.mutations++;
+ continue;
+ }
+ const variant = scenario === 'stream' ? 0 : scenario === 'detach' ? 1 :
+ scenario === 'visibility' ? 2 : scenario === 'inline' ? 3 : next() % 6;
+ switch (variant) {
+ case 0:
+ // Stream append, followed by a Markdown-style text -> inline-node replacement.
+ p.firstChild.textContent = text.repeat(1 + next() % 12);
+ if (params.get('rewrite') !== 'off' && next() % 4 === 0) p.innerHTML = `<span>${text}</span><em>${text}</em><code>${next()}</code>`;
+ break;
+ case 1:
+ // Virtual-list row replacement and removal of inline LayoutObjects.
+ if (next() % 2) { root.replaceWith(article(index)); stats.replacements++; }
+ else { p.replaceChildren(document.createTextNode(text), document.createElement('br'), document.createTextNode(text)); }
+ break;
+ case 2:
+ root.style.contentVisibility = ['auto', 'hidden', 'visible'][next() % 3];
+ root.querySelector('details').open = !!(next() % 2);
+ p.textContent = text.repeat(1 + next() % 10);
+ break;
+ case 3:
+ p.className = ['ellipsis', 'clamp', 'first', ''][next() % 4];
+ p.innerHTML = `<span style="display:${next() % 2 ? 'contents' : 'inline'}">${text}</span><ruby>漢<rt>kan</rt></ruby>${text}`;
+ root.style.width = `${200 + next() % 650}px`;
+ break;
+ case 4:
+ root.style.display = ['block', 'none', 'contents'][next() % 3];
+ p.textContent = text.repeat(2);
+ break;
+ case 5:
+ items.prepend(items.lastElementChild);
+ root.querySelector('details').open = !root.querySelector('details').open;
+ break;
+ }
+ stats.mutations++;
+ }
+ if (params.get('scroll') !== 'off' && stats.frames % 3 === 0) {
+ viewport.scrollTop = (next() % 101) / 100 * viewport.scrollHeight;
+ stats.scrolls++;
+ }
+ // Deliberately interleave layout reads with mutations; no Chromium internals/forced crash.
+ if (stats.frames % 2 === 0) {
+ items.children[next() % items.children.length].getBoundingClientRect();
+ stats.layoutReads++;
+ }
+ stats.frames++;
+ requestAnimationFrame(frame);
+ }
+ requestAnimationFrame(frame);
+})();
diff --git a/apps/desktop/scripts/ax5406/inspect-dump.mjs b/apps/desktop/scripts/ax5406/inspect-dump.mjs
new file mode 100644
index 0000000000..7934368c8d
--- /dev/null
+++ b/apps/desktop/scripts/ax5406/inspect-dump.mjs
@@ -0,0 +1,48 @@
+/** Read only minidump exception/module metadata; no memory/string dump or upload.
+ * This checks the reported build+RVA signature. It does NOT unwind/symbolize a stack.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+export function inspectDump(file) {
+ const b = fs.readFileSync(file);
+ if (b.toString('ascii', 0, 4) !== 'MDMP') throw new Error('Not a minidump');
+ const count = b.readUInt32LE(8), directory = b.readUInt32LE(12);
+ const streams = new Map();
+ for (let i = 0; i < count; i++) {
+ const at = directory + i * 12;
+ streams.set(b.readUInt32LE(at), b.readUInt32LE(at + 8));
+ }
+ const exception = streams.get(6), modules = streams.get(4);
+ if (exception === undefined || modules === undefined) throw new Error('Missing exception/module stream');
+ const code = b.readUInt32LE(exception + 8), address = b.readBigUInt64LE(exception + 24);
+ const moduleCount = b.readUInt32LE(modules);
+ let faultModule;
+ for (let i = 0; i < moduleCount; i++) {
+ const at = modules + 4 + i * 108;
+ const base = b.readBigUInt64LE(at), size = b.readUInt32LE(at + 8);
+ if (address < base || address >= base + BigInt(size)) continue;
+ const nameAt = b.readUInt32LE(at + 20);
+ const name = b.toString('utf16le', nameAt + 4, nameAt + 4 + b.readUInt32LE(nameAt));
+ const cv = b.readUInt32LE(at + 80);
+ let pdb;
+ if (b.toString('ascii', cv, cv + 4) === 'RSDS') {
+ const hex = (n, width) => n.toString(16).padStart(width, '0').toUpperCase();
+ const guid = hex(b.readUInt32LE(cv + 4), 8) + hex(b.readUInt16LE(cv + 8), 4) +
+ hex(b.readUInt16LE(cv + 10), 4) + b.subarray(cv + 12, cv + 20).toString('hex').toUpperCase();
+ const age = b.readUInt32LE(cv + 20);
+ pdb = { guid, age, symbolKey: guid + age.toString(16).toUpperCase(),
+ name: path.win32.basename(b.toString('utf8', cv + 24, b.indexOf(0, cv + 24))) };
+ }
+ faultModule = { name: path.win32.basename(name), base: `0x${base.toString(16)}`, size,
+ rva: `0x${(address - base).toString(16).toUpperCase()}`, pdb };
+ break;
+ }
+ return { file: path.resolve(file), threadId: b.readUInt32LE(exception),
+ exceptionCode: `0x${code.toString(16).toUpperCase()}`, faultModule,
+ matchesReported5406: code === 0x80000003 && faultModule?.rva === '0xA332D17' &&
+ faultModule?.pdb?.symbolKey === 'D4DDA3CA101D876E4C4C44205044422E1' };
+}
+if (process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
+ for (const file of process.argv.slice(2)) console.log(JSON.stringify(inspectDump(file), null, 2));
+}
diff --git a/apps/desktop/scripts/ax5406/inspect-dump.test.mjs b/apps/desktop/scripts/ax5406/inspect-dump.test.mjs
new file mode 100644
index 0000000000..7212260608
--- /dev/null
+++ b/apps/desktop/scripts/ax5406/inspect-dump.test.mjs
@@ -0,0 +1,51 @@
+import { test } from 'vitest';
+import assert from 'node:assert/strict';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { inspectDump } from './inspect-dump.mjs';
+
+// A synthetic metadata-only dump. No process memory or user data in fixtures.
+function fixture({ code = 0x80000003, rva = 0xA332D17, age = 1, guidWord = 0xD4DDA3CA } = {}) {
+ const b = Buffer.alloc(512);
+ b.write('MDMP'); b.writeUInt32LE(2, 8); b.writeUInt32LE(32, 12);
+ b.writeUInt32LE(6, 32); b.writeUInt32LE(168, 36); b.writeUInt32LE(56, 40);
+ b.writeUInt32LE(4, 44); b.writeUInt32LE(112, 48); b.writeUInt32LE(224, 52);
+ b.writeUInt32LE(123, 56); b.writeUInt32LE(code, 64);
+ b.writeBigUInt64LE(0x100000000n + BigInt(rva), 80);
+ b.writeUInt32LE(1, 224);
+ const module = 228;
+ b.writeBigUInt64LE(0x100000000n, module); b.writeUInt32LE(0xD6FB000, module + 8);
+ b.writeUInt32LE(350, module + 20); b.writeUInt32LE(400, module + 80);
+ const name = Buffer.from('C:\\synthetic\\Cindy.exe', 'utf16le');
+ b.writeUInt32LE(name.length, 350); name.copy(b, 354);
+ b.write('RSDS', 400); b.writeUInt32LE(guidWord, 404);
+ b.writeUInt16LE(0x101D, 408); b.writeUInt16LE(0x876E, 410);
+ Buffer.from('4C4C44205044422E', 'hex').copy(b, 412); b.writeUInt32LE(age, 420);
+ b.write('electron.exe.pdb\0', 424);
+ return b;
+}
+
+test('only the exact exception + RVA + PDB GUID/age identifies the reported signature', () => {
+ const root = fs.mkdtempSync(path.join(os.tmpdir(), 'ax5406-parser-test-'));
+ const file = path.join(root, 'synthetic.dmp');
+ try {
+ for (const [variation, expected] of [
+ [{}, true], [{ code: 0xC0000005 }, false], [{ rva: 0xA332D27 }, false],
+ [{ age: 2 }, false], [{ guidWord: 0xD4DDA3CB }, false],
+ ]) {
+ fs.writeFileSync(file, fixture(variation));
+ const result = inspectDump(file);
+ assert.equal(result.matchesReported5406, expected);
+ assert.equal(result.threadId, 123);
+ assert.equal(result.faultModule.name, 'Cindy.exe');
+ }
+ fs.writeFileSync(file, Buffer.from('not a dump'));
+ assert.throws(() => inspectDump(file), /Not a minidump/);
+ fs.writeFileSync(file, fixture().subarray(0, 70));
+ assert.throws(() => inspectDump(file));
+ } finally {
+ fs.unlinkSync(file);
+ fs.rmdirSync(root);
+ }
+});
diff --git a/apps/desktop/scripts/ax5406/jump-paint.cjs b/apps/desktop/scripts/ax5406/jump-paint.cjs
new file mode 100644
index 0000000000..0f8663ba44
--- /dev/null
+++ b/apps/desktop/scripts/ax5406/jump-paint.cjs
@@ -0,0 +1,172 @@
+// Real MessageStream build, synthetic props. Native compositor frame acceptance.
+// Run with Electron: jump-paint.cjs <config.json>; all output stays outside the repo.
+const { app, BrowserWindow } = require('electron');
+const fs = require('fs'), path = require('path');
+const cfg = JSON.parse(fs.readFileSync(process.argv[2], 'utf8'));
+app.setPath('userData', path.join(cfg.output, 'profile'));
+app.commandLine.appendSwitch('disable-renderer-accessibility');
+app.commandLine.appendSwitch('disable-background-timer-throttling');
+const report = { cases: [], failures: [], errors: [], controls: [], versions: process.versions };
+const save = () => fs.writeFileSync(path.join(cfg.output, 'audit.json'), JSON.stringify(report, null, 2));
+const wait = ms => new Promise(r => setTimeout(r, ms));
+let win, active = null, frameId = 0, bounds;
+const js = code => win.webContents.executeJavaScript(code);
+function inspect(frame) {
+ const bitmap = frame.toBitmap(), size = frame.getSize(), rows = new Map();
+ const sx = size.width / bounds.windowWidth, sy = size.height / bounds.windowHeight;
+ let blank = 0;
+ for (let y = Math.ceil(bounds.top * sy); y < Math.min(size.height, Math.floor(bounds.bottom * sy)); y++) {
+ for (let x = Math.ceil((cfg.light ? bounds.markerX + 6 : bounds.left) * sx); x < Math.min(size.width, Math.floor((cfg.light ? bounds.markerX + 8 : bounds.right) * sx)); x++) {
+ const n = (y * size.width + x) * 4, b = bitmap[n], g = bitmap[n + 1], r = bitmap[n + 2];
+ if (r === 255 && g === 0 && b === 255) blank++;
+ if (x < Math.ceil((bounds.markerX + 6) * sx) || x >= Math.floor((bounds.markerX + 8) * sx) ||
+ [r,g,b].some(v=>v<32||v>228||(v-32)%28!==0)) continue;
+ const id = (r-32)/28 + ((g-32)/28)*8 + ((b-32)/28)*64;
+ if (id >= 500) continue;
+ let row = rows.get(id);
+ if (!row) { row = { id, top: y / sy, bottom: y / sy, pixels: 0 }; rows.set(id, row); }
+ row.bottom = y / sy; row.pixels++;
+ }
+ }
+ // A legitimate first row may expose only a 2–4px sliver after its height is
+ // measured. Exact palette matches inside the stripe suffice in that case.
+ return { blank, rows: [...rows.values()].filter(r => r.pixels >= 2), size };
+}
+async function install() {
+ bounds = await js(`(() => {
+ const root=document.querySelector('[data-scroll-container]'),r=root.getBoundingClientRect();
+ const s=document.createElement('style');s.id='jump-probe';
+ // Scan away from the rounded corners added by search highlighting. At x=1
+ // the unchanged row appears to shrink 6px at both ends when it is highlighted.
+ s.textContent=Array.from({length:500},(_,i)=>'.msg-stream-items>[data-render-item-key="msg-synthetic-'+i+'"]{background-image:linear-gradient(to right,rgb('+(32+28*(i%8))+','+(32+28*(Math.floor(i/8)%8))+','+(32+28*Math.floor(i/64))+') 0 8px,transparent 8px)!important}').join('')+
+ '.msg-stream-items>[data-message-placeholder]{background-image:linear-gradient(rgb(255,0,255),rgb(255,0,255))!important}';document.head.append(s);
+ const ticker=document.createElement('div');ticker.style.cssText='position:fixed;right:0;top:0;width:6px;height:6px;z-index:2147483647;pointer-events:none';document.body.append(ticker);
+ window.jumpAudit={samples:[],active:false};let n=0;
+ function tick(){ticker.style.background=n++%2?'rgb(1,2,3)':'rgb(4,5,6)';
+ if(window.jumpAudit.active){const rows=[...document.querySelector('.msg-stream-items').children].map(e=>{const b=e.getBoundingClientRect();return{id:e.dataset.messageClientId,top:b.top,bottom:b.bottom,height:b.height,placeholder:e.hasAttribute('data-message-placeholder')}});
+ window.jumpAudit.samples.push({time:Date.now(),top:root.scrollTop,distance:root.scrollHeight-root.clientHeight-root.scrollTop,rows:rows.filter(e=>e.height>0&&e.bottom>r.top+1&&e.top<r.bottom-1),overlaps:rows.slice(1).filter((e,i)=>e.top<rows[i].bottom-1).length});}requestAnimationFrame(tick);}tick();
+ return{left:r.left,right:r.right-16,top:r.top+1,bottom:r.bottom-1,markerX:document.querySelector('.msg-stream-items').getBoundingClientRect().left,windowWidth:innerWidth,windowHeight:innerHeight};
+ })()`);
+ if(cfg.trace) await js(`(()=>{
+ const root=document.querySelector('[data-scroll-container]');window.jumpTrace=[];
+ const sample=(kind,detail)=>{if(!window.jumpAudit.active)return;const e=document.querySelector('[data-message-client-id="synthetic-470"]'),b=e?.getBoundingClientRect();window.jumpTrace.push({at:Date.now(),kind,detail,scrollTop:root.scrollTop,total:root.scrollHeight,targetTop:b?.top,targetHeight:b?.height,targetAbsolute:b?b.top+root.scrollTop:null});};
+ const original=Element.prototype.scrollIntoView;Element.prototype.scrollIntoView=function(...args){sample('intoView-before',{id:this.dataset.messageClientId,args,top:this.getBoundingClientRect().top,height:this.getBoundingClientRect().height,stack:new Error().stack});const value=original.apply(this,args);sample('intoView-after');return value};
+ root.addEventListener('scrollend',()=>sample('scrollend'));
+ const ro=new ResizeObserver(()=>sample('resize'));ro.observe(document.querySelector('.msg-stream-items'));
+ function frame(){sample('rAF');requestAnimationFrame(frame)}frame();
+ })()`);
+}
+function onFrame(frame) {
+ if (!active) return;
+ const at = Date.now(), decoded = inspect(frame), file = `frame-${String(++frameId).padStart(6, '0')}.png`;
+ // Persist every delivered frame: no sampling or dropped "uninteresting" frames.
+ if (!cfg.light) fs.writeFileSync(path.join(cfg.output, file), frame.toPNG());
+ active.frames.push({ at, file, ...decoded });
+}
+async function control(kind) {
+ active = { frames: [] };
+ // Keep both negative controls literal: never interpolate CSS into renderer code.
+ if (kind === 'placeholder') {
+ await js(`(()=>{const s=document.createElement('style');s.id='negative-control';s.textContent='.msg-stream-items>[data-message-client-id="synthetic-499"]{background-image:linear-gradient(rgb(255,0,255),rgb(255,0,255))!important}';document.head.append(s)})()`);
+ } else if (kind === 'empty viewport') {
+ await js(`(()=>{const s=document.createElement('style');s.id='negative-control';s.textContent='.msg-stream-items>*{visibility:hidden!important}';document.head.append(s)})()`);
+ } else {
+ throw Error('Unknown native paint control: ' + kind);
+ }
+ await wait(180);
+ const frames = active.frames;
+ const detected = kind === 'placeholder' ? frames.some(f => f.blank > 16) : frames.some(f => !f.rows.length);
+ report.controls.push({ kind, detected, frames: frames.length });
+ if (!detected) throw Error('Native paint control failed: ' + kind);
+ active = null; await js(`document.getElementById('negative-control').remove()`); await wait(100);
+}
+function sameRows(a, b) {
+ return a.length === b.length && a.every((r, i) => r.id === b[i].id && Math.abs(r.top - b[i].top) <= 2 && Math.abs(r.bottom - b[i].bottom) <= 2);
+}
+async function runCase(label, kind, value) {
+ await js('window.jumpAudit.samples=[];window.jumpAudit.active=true');
+ if(cfg.trace)await js('window.jumpTrace=[]');
+ const c = { label, kind, value, frames: [] }; active = c;
+ const start = await js(`(()=>{const root=document.querySelector('[data-scroll-container]');
+ const started=Date.now();let target=${kind === 'focus' ? value : 499};
+ if(${JSON.stringify(kind)}==='instant'){
+ root.dispatchEvent(new WheelEvent('wheel',{deltaY:-100,bubbles:true}));
+ const top=(root.scrollHeight-root.clientHeight)*${Number(value)};
+ const b=root.getBoundingClientRect();target=Number([...document.querySelector('.msg-stream-items').children].find(e=>{const r=e.getBoundingClientRect();return r.height>0&&r.bottom-b.top+root.scrollTop>top+32})?.dataset.messageClientId?.split('-').at(-1));root.scrollTop=top;
+ }else if(${JSON.stringify(kind)}==='focus')window.ax5406Visual.focus('synthetic-'+target);
+ else {const button=[...document.querySelectorAll('button')].find(e=>/new messages|Jump to bottom/.test(e.textContent));if(!button)throw Error('No jump to bottom button');button.click();}
+ return{started,target};})()`);
+ Object.assign(c, start);
+ await wait(kind === 'instant' ? 1000 : 2600);
+ c.dom = await js('window.jumpAudit.active=false;window.jumpAudit.samples');
+ if(cfg.trace)c.trace=await js('window.jumpTrace');
+ active = null;
+ c.frames = c.frames.filter(f => f.at >= c.started);
+ const ready = f => f.blank <= 16 && f.rows.some(r => r.id === c.target);
+ const first = c.frames.find(ready), last = c.frames.at(-1);
+ c.firstTargetPaintMs = first ? first.at - c.started : null;
+ let stableIndex = c.frames.length - 1;
+ while (stableIndex > 0 && sameRows(c.frames[stableIndex - 1].rows, last.rows) && ready(c.frames[stableIndex - 1])) stableIndex--;
+ c.stablePaintMs = last && ready(last) ? c.frames[stableIndex].at - c.started : null;
+ c.stableObservedMs = last && c.stablePaintMs !== null ? last.at - c.frames[stableIndex].at : 0;
+ c.blankPaints = c.frames.filter(f => f.blank > 16 || !f.rows.length).map(f => f.file);
+ c.targetLostPaints = first ? c.frames.filter(f => f.at > first.at && !f.rows.some(r => r.id === c.target)).map(f => f.file) : [];
+ // A correct final landing can hide an overshoot followed by a visible snap.
+ // Check the actual painted trajectory too, excluding <=4px raster jitter.
+ const targetFrames = c.frames.map(f => ({ ...f, targetRow: f.rows.find(r => r.id === c.target) })).filter(f => f.targetRow);
+ c.reversals = [];
+ if (targetFrames.length) for (const edge of ['top', 'bottom']) {
+ const direction = Math.sign(targetFrames.at(-1).targetRow[edge] - targetFrames[0].targetRow[edge]);
+ for (let i = 1; i < targetFrames.length; i++) {
+ // At the viewport cut, text can cover the last few stripe pixels. That
+ // clipped endpoint is not the row's edge; use its other, exposed edge.
+ // Keep genuine reversals away from the cut (including the 416px repro).
+ const cut = edge === 'top' ? bounds.top : bounds.bottom;
+ if ([targetFrames[i - 1], targetFrames[i]].every(f => Math.abs(f.targetRow[edge] - cut) < 24)) continue;
+ const delta = targetFrames[i].targetRow[edge] - targetFrames[i - 1].targetRow[edge];
+ if (direction ? direction * delta < -4 : Math.abs(delta) > 4) c.reversals.push({
+ edge, delta, before: targetFrames[i - 1].file, after: targetFrames[i].file,
+ atMs: targetFrames[i].at - c.started,
+ });
+ }
+ }
+ const finalDOM = c.dom.at(-1);
+ c.finalTargetVisible = !!finalDOM?.rows.some(r => r.id === 'synthetic-' + c.target && !r.placeholder);
+ c.finalDistance = finalDOM?.distance;
+ c.maxFrameIntervalMs = Math.max(0, ...c.frames.slice(1).map((f, i) => f.at - c.frames[i].at));
+ if (c.firstTargetPaintMs === null || !c.finalTargetVisible || c.stableObservedMs < 200 || c.frames.length < 8) report.failures.push(label + ': target/stability not verified');
+ if (c.blankPaints.length) report.failures.push(label + ': native blank/placeholder paint');
+ if (c.targetLostPaints.length) report.failures.push(label + ': target disappeared after arrival');
+ if (c.reversals.length) report.failures.push(label + ': target reversed direction before settling');
+ if (kind === 'bottom' && c.finalDistance > 2) report.failures.push(label + ': bottom not reached');
+ if (c.dom.some(s => s.overlaps)) report.failures.push(label + ': overlapping DOM rows');
+ report.cases.push(c); save();
+ console.log(JSON.stringify({ label, target: c.target, firstMs: c.firstTargetPaintMs, stableMs: c.stablePaintMs, paints: c.frames.length, blanks: c.blankPaints.length, lost: c.targetLostPaints.length }));
+}
+async function run() {
+ win = new BrowserWindow({ width:1280,height:800,useContentSize:true,show:false,webPreferences:{sandbox:true,contextIsolation:true,nodeIntegration:false,backgroundThrottling:false} });
+ win.webContents.on('render-process-gone', (_e, d) => { report.crash=d; save(); app.exit(2); });
+ win.webContents.on('console-message', (_e,d) => { if(d.level==='error')report.errors.push(d.message); });
+ win.webContents.setWindowOpenHandler(()=>({action:'deny'}));
+ for (const [width,height,dark] of (cfg.matrices || [[1280,800,false],[960,640,false],[620,1000,false],[1280,800,true],[960,640,true],[620,1000,true]])) {
+ win.setContentSize(width,height);
+ await win.loadFile(path.join(cfg.build,'component/component.html'),{query:{rows:'500',seed:'5407',workload:'visual',scroll:'off',accessibility:'off'}});
+ win.showInactive(); await wait(500);
+ await js(`window.ax5406Visual.theme(${dark});window.ax5406Visual.streamFinish()`);await wait(200);
+ await install(); report.bounds ??= []; report.bounds.push(bounds); win.webContents.beginFrameSubscription(false,onFrame);await wait(150);
+ if (!report.controls.length) {
+ await control('placeholder');
+ await control('empty viewport');
+ }
+ const prefix=`${width}x${height}-${dark?'dark':'light'}`;
+ for (const [i,f] of [.15,.8,.3,.9].entries())await runCase(prefix+'-instant-'+i,'instant',f);
+ for (const id of [430,100,470]) {
+ await runCase(prefix+'-focus-'+id,'focus',id);
+ await runCase(prefix+'-bottom-'+id,'bottom',0);
+ }
+ win.webContents.endFrameSubscription();
+ }
+ report.completed=true;report.passed=!report.failures.length&&!report.errors.length;save();win.destroy();app.exit(report.passed?0:3);
+}
+setTimeout(()=>{report.failures.push('harness timeout');save();app.exit(2)},240000);
+app.whenReady().then(run).catch(e=>{report.error=e.stack;save();app.exit(2)});
diff --git a/apps/desktop/scripts/ax5406/main.cjs b/apps/desktop/scripts/ax5406/main.cjs
new file mode 100644
index 0000000000..a539fb84e3
--- /dev/null
+++ b/apps/desktop/scripts/ax5406/main.cjs
@@ -0,0 +1,132 @@
+// Standalone upstream-engine experiment; never imports Cindy bootstrap/lifecycle or profiles.
+const { app, BrowserWindow, crashReporter, contentTracing } = require('electron');
+const fs = require('node:fs');
+const path = require('node:path');
+const { spawn } = require('node:child_process');
+const config = JSON.parse(fs.readFileSync(process.argv[2], 'utf8'));
+app.setPath('userData', path.join(config.output, 'profile'));
+app.setPath('crashDumps', path.join(config.output, 'dumps'));
+app.commandLine.appendSwitch(config.ax === 'on' ? 'force-renderer-accessibility' : 'disable-renderer-accessibility');
+app.commandLine.appendSwitch('disable-background-timer-throttling');
+if(config.threaded === 'off') app.commandLine.appendSwitch('disable-threaded-scrolling');
+const report = { config, versions: process.versions, mainPid: process.pid, startedAt: new Date().toISOString(),
+ status: 'starting', cdpQueries: 0, cdpErrors: 0, native: { queries: 0, ranges: 0, errors: 0 }, stats: null };
+const save = () => fs.writeFileSync(path.join(config.output, 'report.json'), JSON.stringify(report, null, 2));
+let win, native, ending = false, pollTimer;
+async function finish(status) {
+ if (ending) return;
+ ending = true;
+ clearTimeout(pollTimer);
+ report.status = status;
+ report.finishedAt = new Date().toISOString();
+ if (config.trace === 'on') {
+ report.traceFile = await contentTracing.stopRecording(path.join(config.output, 'startup-trace.json'));
+ }
+ if (native && native.exitCode === null) {
+ const closed = new Promise(resolve => native.once('exit', resolve));
+ native.kill();
+ await closed;
+ }
+ save();
+ // Give Crashpad a bounded opportunity to finish the dump before main exits.
+ setTimeout(() => { if (win && !win.isDestroyed()) win.destroy(); app.exit(status === 'completed-no-crash' ? 0 : 2); }, 1200);
+}
+process.on('uncaughtException', err => { report.error = err.stack; void finish('harness-error'); });
+process.on('unhandledRejection', err => { report.error = String(err); void finish('harness-error'); });
+app.whenReady().then(async () => {
+ crashReporter.start({ uploadToServer: false });
+ app.setAccessibilitySupportEnabled(config.ax === 'on');
+ if (config.trace === 'on') await contentTracing.startRecording({
+ recording_mode: 'record-until-full',
+ included_categories: ['devtools.timeline', 'blink.user_timing', 'loading', 'v8',
+ 'disabled-by-default-devtools.timeline', 'disabled-by-default-devtools.timeline.stack'],
+ });
+ report.accessibilityEnabled = app.isAccessibilitySupportEnabled();
+ app.on('accessibility-support-changed', (_event, enabled) => {
+ report.accessibilityEnabled = enabled; save();
+ });
+ win = new BrowserWindow({ width: 1000, height: 760, show: false, title: 'AX5406 isolated fixture',
+ webPreferences: { sandbox: true, contextIsolation: true, nodeIntegration: false,
+ nodeIntegrationInSubFrames: false, nodeIntegrationInWorker: false, webSecurity: true,
+ allowRunningInsecureContent: false, experimentalFeatures: false, plugins: false,
+ navigateOnDragDrop: false, webviewTag: false, backgroundThrottling: false } });
+ win.webContents.setWindowOpenHandler(() => ({ action: 'deny' }));
+ win.webContents.on('will-navigate', event => event.preventDefault());
+ win.webContents.on('console-message', (_event, details) => {
+ if (details.level === 'error') { report.rendererErrors ??= []; report.rendererErrors.push(details.message.slice(0, 2000)); save(); }
+ });
+ win.webContents.session.setPermissionRequestHandler((_wc, _p, callback) => callback(false));
+ win.webContents.session.setPermissionCheckHandler(() => false);
+ win.webContents.on('render-process-gone', (_event, details) => {
+ report.crash = { ...details, rendererPid: report.rendererPid, webContentsId: win.webContents.id };
+ void finish('renderer-gone-unclassified');
+ });
+ win.on('close', () => { if (!ending) void finish('window-closed'); });
+ await win.loadFile(config.componentFile || path.join(__dirname, 'fixture.html'), { query: {
+ seed: String(config.seed), scenario: config.scenario, containment: config.containment,
+ scroll: config.scroll, rows: String(config.rows), batch: String(config.batch), rewrite: config.rewrite, target: config.target,
+ accessibility: config.accessibility || 'off', policy: config.policy, workload: ['scroll-tests', 'stream-tests'].includes(config.workload) ? 'visual' : config.workload } });
+ report.rendererPid = win.webContents.getOSProcessId();
+ report.webContentsId = win.webContents.id;
+ // Native UIA requires a real HWND. showInactive avoids stealing the user's focus.
+ win.showInactive();
+ if (config.ax === 'on' && ['native', 'both'].includes(config.query)) {
+ const handle = win.getNativeWindowHandle();
+ const hwnd = handle.length === 8 ? handle.readBigUInt64LE().toString() : String(handle.readUInt32LE());
+ native = spawn('powershell.exe', ['-NoProfile', '-NonInteractive', '-File', path.join(__dirname, 'uia.ps1'),
+ '-WindowHandle', hwnd, '-ExpectedProcessId', String(process.pid), '-Seconds', String(config.seconds)],
+ { windowsHide: true, stdio: ['ignore', 'pipe', 'pipe'] });
+ report.nativePid = native.pid;
+ let pending = '';
+ native.stdout.on('data', data => {
+ pending += data.toString();
+ const lines = pending.split(/\r?\n/); pending = lines.pop();
+ for (const line of lines) { try { report.native = JSON.parse(line); } catch {} }
+ });
+ native.stderr.on('data', data => { report.nativeError = String(data).slice(0, 2000); });
+ native.on('error', err => { report.nativeError = err.message; });
+ native.on('exit', code => { report.nativeExitCode = code; });
+ }
+ if (['cdp', 'both'].includes(config.query)) win.webContents.debugger.attach('1.3');
+ if (config.ax === 'on' && ['cdp', 'both'].includes(config.query)) await win.webContents.debugger.sendCommand('Accessibility.enable');
+ report.status = 'running'; save();
+ if (['visual', 'scroll-tests', 'scroll-race', 'stream-tests'].includes(config.workload)) {
+ report.visual = await require(config.workload === 'stream-tests' ? './stream-tests.cjs' : config.workload === 'scroll-race' ? './scroll-race.cjs' : config.workload === 'scroll-tests' ? './scroll-tests.cjs' : './visual.cjs')(win, config.output, config);
+ report.stats = await win.webContents.executeJavaScript('({...window.ax5406Stats})');
+ await finish(report.visual.failures.length ? 'visual-failed' : 'completed-no-crash');
+ return;
+ }
+ const until = Date.now() + config.seconds * 1000;
+ async function poll() {
+ if (ending) return;
+ try {
+ report.stats = await win.webContents.executeJavaScript('({...window.ax5406Stats})');
+ if (config.componentFile) report.performance = await win.webContents.executeJavaScript(`(() => {
+ const paints = performance.getEntriesByType('paint');
+ return Object.fromEntries(paints.map(entry => [entry.name, entry.startTime]));
+ })()`);
+ if (config.trace === 'on' && !report.navigation) {
+ report.navigation = await win.webContents.executeJavaScript(`({
+ navigation: performance.getEntriesByType('navigation').map(e => e.toJSON()),
+ resources: performance.getEntriesByType('resource').map(e => e.toJSON())
+ })`);
+ }
+ if (config.componentFile && report.stats?.commits > 10 && !report.screenshot) {
+ const screenshot = await win.webContents.capturePage();
+ fs.writeFileSync(path.join(config.output, 'component.png'), screenshot.toPNG());
+ report.screenshot = 'component.png';
+ }
+ if (config.ax === 'on' && ['cdp', 'both'].includes(config.query)) {
+ const tree = await win.webContents.debugger.sendCommand('Accessibility.getFullAXTree');
+ report.cdpQueries++;
+ report.lastAXNodes = tree.nodes.length;
+ report.maxInlineTextBoxes = Math.max(report.maxInlineTextBoxes || 0,
+ tree.nodes.filter(n => n.role?.value === 'InlineTextBox').length);
+ }
+ } catch (err) { report.cdpErrors++; report.lastQueryError = String(err); }
+ save();
+ if (Date.now() >= until) await finish('completed-no-crash');
+ else if (!ending) pollTimer = setTimeout(poll, 30);
+ }
+ void poll();
+});
diff --git a/apps/desktop/scripts/ax5406/matrix.mjs b/apps/desktop/scripts/ax5406/matrix.mjs
new file mode 100644
index 0000000000..b75b331a36
--- /dev/null
+++ b/apps/desktop/scripts/ax5406/matrix.mjs
@@ -0,0 +1,19 @@
+/** Explicit, bounded integration experiment, excluded from unit CI. No account/profile access. */
+import { spawn } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+const cases = [
+ ['repro-5406', '--seed=5406', '--seconds=15'],
+ ['repro-5407', '--seed=5407', '--seconds=15'],
+ ['repro-5408', '--seed=5408', '--seconds=15'],
+ ['no-containment', '--seed=5406', '--seconds=120', '--containment=off'],
+ ['no-accessibility', '--seed=5406', '--seconds=120', '--ax=off'],
+ ['no-query', '--seed=5406', '--seconds=120', '--query=none'],
+];
+for (const [name, ...args] of cases) {
+ console.log(`AX5406_CASE=${name}`);
+ const child = spawn(process.execPath, [fileURLToPath(new URL('./run.mjs', import.meta.url)),
+ '--scenario=minimal', '--scroll=off', '--rows=12', '--batch=1', ...args], { stdio: 'inherit', windowsHide: true });
+ const code = await new Promise((resolve, reject) => { child.once('exit', resolve); child.once('error', reject); });
+ console.log(`AX5406_CASE_EXIT=${name}:${code}`);
+ if (code !== 0 && code !== 10) process.exitCode = 2;
+}
diff --git a/apps/desktop/scripts/ax5406/navigation-report.mjs b/apps/desktop/scripts/ax5406/navigation-report.mjs
new file mode 100644
index 0000000000..d089870772
--- /dev/null
+++ b/apps/desktop/scripts/ax5406/navigation-report.mjs
@@ -0,0 +1,39 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+const roots=process.argv.slice(2);
+if(roots.length!==6)throw new Error('Expected previous-search, previous-blank, previous-direct-write, candidate-500, repeat-500, candidate-1000 roots');
+const audits=await Promise.all(roots.map(async root=>JSON.parse(await fs.readFile(path.join(root,'scroll-audit.json'),'utf8'))));
+const esc=value=>String(value).replaceAll('&','&amp;').replaceAll('<','&lt;');
+const names=['此前:搜索落点失败','此前:回底绘制空白','此前:逐帧跳转空白','当前:500 条','当前:500 条重复','当前:1000 条'];
+const cards=audits.map((a,i)=>{
+ const normal=a.samples.filter(s=>!s.phase.endsWith('-jumps'));
+ const forced=a.samples.filter(s=>s.phase.endsWith('-jumps'));
+ const other=a.failures.filter(f=>!/-jumps:/.test(f));
+ return `<article><h2>${names[i]}</h2><p>产物:${esc(path.basename(roots[i]))}</p><dl><dt>其他阶段采样</dt><dd>${normal.length}</dd><dt>空占位 / 重叠</dt><dd>${normal.filter(s=>s.blank.length).length} / ${normal.filter(s=>s.overlaps).length}</dd><dt>搜索目标可见</dt><dd>${a.navigation.filter(n=>n.visible).length} / ${a.navigation.length}</dd><dt>强制跳跃空帧</dt><dd>${forced.filter(s=>s.blank.length).length} / ${forced.length}</dd></dl><p>${other.length?esc(other.join(';')):'其他检查未发现异常。'}</p></article>`;
+});
+const figures=[];
+for(const [i,file,title] of [
+ [0,'1000x760-light-search-420.png','修正前:搜索 420,画面停在 429 / 430'],
+ [3,'1000x760-light-search-420.png','修正后:搜索 420,目标正文已在视口内'],
+ [1,'paint-620x1000-dark-jump-button-1.png','修正前:回底时实际绘制的空白帧'],
+ [3,'paint-620x1000-dark-jump-button-1.png','修正后:同类回底操作的第一张绘制帧'],
+ [5,'620x1000-dark-search-420.png','1000 条、窄窗深色:搜索落点'],
+ [5,'paint-1000x760-light-thumb-drag-10.png','1000 条:真实滚动条拖动中的绘制帧'],
+ [2,'paint-620x1000-dark-jumps-4.png','修正前:脚本在 rAF 内改位置,绘制出空占位'],
+ [3,'paint-620x1000-dark-jumps-4.png','修正后:同类逐帧跳转已挂载目标正文'],
+]) {
+ const png=await fs.readFile(path.join(roots[i],file));
+ figures.push(`<figure><figcaption>${esc(title)}</figcaption><img loading="lazy" src="data:image/png;base64,${png.toString('base64')}" alt="${esc(title)}"></figure>`);
+}
+const totals=audits.slice(3).flatMap(a=>a.samples);
+const searches=audits.slice(3).flatMap(a=>a.navigation);
+const failures=audits.slice(3).flatMap(a=>a.failures);
+const html=`<!doctype html><html lang="zh-CN"><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>消息滚动:定位与复测</title><style>body{margin:auto;padding:18px;max-width:920px;background:#f3f4f6;color:#17202a;font:16px/1.65 system-ui,sans-serif}h1{font-size:24px}h2{font-size:18px;margin-top:0}article,figure{background:white;padding:16px;margin:18px 0;border-radius:12px}figure{padding:0;overflow:hidden}figcaption{padding:14px;font-weight:600}img{display:block;width:100%}dl{display:grid;grid-template-columns:1fr 1fr;margin:0}dd{margin:0;text-align:right}aside{padding:14px;background:#fff4d5;border-left:4px solid #aa7100}code{overflow-wrap:anywhere}</style>
+<h1>消息滚动:定位与复测</h1><p>2026-10-03,Windows Electron 41.10.3。实际 MessageStream 组件与样式、合成数据、独立测试窗口;无障碍开启。不是整个安装版客户端验收。</p>
+<p>搜索与历史扩窗、自动跟随及通用滚动收尾之间存在控制权冲突;校准后还会收到晚到位移。回底路径另有旧阅读锚点覆盖新贴底意图、位置更新早于正文挂载的问题。当前已针对这些路径修正,保留浏览器自动锚定。</p>
+<p>这次另外补齐 rAF 直接写 scrollTop 早于 scroll 事件的路径:只观察当前消息容器的赋值,在本轮绘制前的微任务中提交目标正文;保留原生赋值行为,卸载时还原。旧跟随标记不再吞掉主动跳转。未修改全局 DOM 原型。</p>
+<p>当前三轮全部阶段合计 ${totals.length} 次采样,${totals.filter(s=>s.blank.length).length} 次含空占位,${totals.filter(s=>s.overlaps).length} 次行重叠;搜索目标可见 ${searches.filter(n=>n.visible).length} / ${searches.length}。失败检查:${failures.length}${failures.length?'('+esc(failures.join(';'))+')':''}。</p>
+<aside>已增加强制跳转的实际位移和不同落点数量检查,避免“被拉回原处,因此没有空白”的假通过。此处验证的是实际组件的隔离窗口;没有原 issue 的现场转储,也没有在整个安装版客户端上完成验收。不能保证所有硬件/负载下绝无闪动。</aside>
+<p>每轮覆盖三种窗口大小、浅色/深色、慢滚/快滚/反向滚、滚动条拖动、键盘翻页、搜索、搜索中途滚轮接管、回底、正文增长、图片和追加消息。DOM 几何采样配合真实绘制帧截图;并非对显示器每次刷新逐像素验收。</p>${cards.join('')}${figures.join('')}
+<p>所有原图未经编辑,已内嵌在本 HTML。原始 JSON、截图及构建来源哈希保留在对应临时产物目录。代码尚未提交或发布。</p></html>`;
+const out=path.join(roots.at(-1),'navigation-report.html');await fs.writeFile(out,html);console.log(out);
diff --git a/apps/desktop/scripts/ax5406/run.mjs b/apps/desktop/scripts/ax5406/run.mjs
new file mode 100644
index 0000000000..ad5fa08a1f
--- /dev/null
+++ b/apps/desktop/scripts/ax5406/run.mjs
@@ -0,0 +1,114 @@
+/** Explicit Windows-only Chromium stress experiment. Does not start the Cindy application.
+ * node apps/desktop/scripts/ax5406/run.mjs --seconds=120 --seed=5406 --scenario=mixed --ax=on --containment=on
+ * Exit: 0 = completed without crash, 10 = exact reported build/RVA signature, 2 = other/inconclusive.
+ */
+import fs from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import { createRequire } from 'node:module';
+import { fileURLToPath } from 'node:url';
+import { spawn, execFileSync } from 'node:child_process';
+import { createHash } from 'node:crypto';
+import { inspectDump } from './inspect-dump.mjs';
+const require = createRequire(import.meta.url);
+if (process.platform !== 'win32') throw new Error('This native UIA experiment currently requires Windows');
+const opts = Object.fromEntries(process.argv.slice(2).map(arg => {
+ const match = /^--(seconds|seed|scenario|ax|containment|query|scroll|rows|batch|rewrite|component-build|target|trace|policy|workload|mounting|anchoring|settlement|threaded|source|stream-probe|accessibility)=(.+)$/.exec(arg);
+ if (!match) throw new Error(`Unknown option: ${arg}`);
+ return [match[1], match[2]];
+}));
+const config = { seconds: Number(opts.seconds ?? 120), seed: Number(opts.seed ?? 5406),
+ scenario: opts.scenario ?? 'stream', ax: opts.ax ?? 'on', containment: opts.containment ?? 'on',
+ accessibility: opts.accessibility ?? 'off', query: opts.query ?? 'cdp', scroll: opts.scroll ?? 'on', rows: Number(opts.rows ?? 80),
+ batch: Number(opts.batch ?? 8), rewrite: opts.rewrite ?? 'on', target: opts.target ?? 'all', trace: opts.trace ?? 'off',
+ policy: opts.policy ?? 'production', workload: opts.workload ?? 'steady', mounting: opts.mounting ?? 'viewport', anchoring: opts.anchoring ?? 'on', settlement: opts.settlement ?? 'into-view', threaded: opts.threaded ?? 'on', source: opts.source ?? 'worktree', streamProbe: opts['stream-probe'] ?? 'off' };
+if (!['head', 'worktree'].includes(config.source) || !['on','off'].includes(config.streamProbe)) throw new Error('Invalid source/probe');
+if (!['on', 'off'].includes(config.accessibility) || !['on', 'off'].includes(config.threaded) || !['into-view', 'scroll-to', 'two-raf'].includes(config.settlement) || !['on', 'off', 'search'].includes(config.anchoring) || !['viewport', 'full'].includes(config.mounting) || !Number.isInteger(config.seconds) || config.seconds < 5 || config.seconds > 600 ||
+ !Number.isInteger(config.seed) || config.seed <= 0 || config.seed > 0xffffffff ||
+ !['minimal', 'stream', 'detach', 'visibility', 'inline', 'mixed', 'component'].includes(config.scenario) ||
+ !['production', 'auto', 'active'].includes(config.policy) || !['steady', 'cycle', 'visual', 'scroll-tests', 'scroll-race', 'stream-tests'].includes(config.workload) ||
+ !['on', 'off'].includes(config.trace) || !['on', 'off'].includes(config.ax) || !['on', 'off'].includes(config.containment) ||
+ !['cdp', 'native', 'both', 'none'].includes(config.query) || !['on', 'off'].includes(config.scroll) ||
+ !['all', 'assistant', 'user', 'tail'].includes(config.target) ||
+ !['on', 'off'].includes(config.rewrite) || !Number.isInteger(config.rows) || config.rows < 1 || config.rows > 1000 ||
+ !Number.isInteger(config.batch) || config.batch < 1 || config.batch > 32) throw new Error('Invalid experiment configuration');
+const root = await fs.mkdtemp(path.join(os.tmpdir(), 'cindy-ax5406-'));
+config.output = root;
+config.sourceHashes = {};
+for (const name of ['fixture.html', 'fixture.js', 'main.cjs', 'uia.ps1', 'component.jsx', 'component.html', 'build-component.mjs', 'visual.cjs', 'scroll-tests.cjs', 'scroll-race.cjs', 'stream-tests.cjs']) {
+ config.sourceHashes[name] = createHash('sha256').update(await fs.readFile(new URL(name, import.meta.url))).digest('hex');
+}
+await fs.mkdir(path.join(root, 'profile'));
+await fs.mkdir(path.join(root, 'dumps'));
+if (config.scenario === 'component') {
+ if (opts['component-build']) {
+ config.componentFile = path.resolve(opts['component-build'], 'component/component.html');
+ await fs.access(config.componentFile);
+ await fs.copyFile(path.resolve(opts['component-build'], 'component-sources.json'), path.join(root, 'component-sources.json'));
+ const buildConfig = JSON.parse(await fs.readFile(path.resolve(opts['component-build'], 'config.json'), 'utf8'));
+ if ((buildConfig.source ?? 'worktree') !== config.source) throw new Error('Component build source mismatch');
+ config.componentBuildSourceHashes = buildConfig.componentBuildSourceHashes || buildConfig.sourceHashes;
+ } else {
+ const { buildComponent } = await import('./build-component.mjs');
+ config.componentFile = await buildComponent(root, config.source);
+ }
+}
+await fs.writeFile(path.join(root, 'config.json'), JSON.stringify(config));
+console.log(`AX5406_ARTIFACTS=${root}`);
+const runtime = require('electron');
+const env = { ...process.env };
+for (const key of Object.keys(env)) if (/^(ELECTRON_RUN_AS_NODE|NODE_OPTIONS)$/i.test(key)) delete env[key];
+const output = await fs.open(path.join(root, 'electron.log'), 'w');
+const child = spawn(runtime, [fileURLToPath(new URL('./main.cjs', import.meta.url)), path.join(root, 'config.json')],
+ { env, windowsHide: true, stdio: ['ignore', 'pipe', 'pipe'] });
+const done = new Promise((resolve, reject) => { child.once('close', resolve); child.once('error', reject); });
+child.stdout.on('data', data => { void output.write(data); });
+child.stderr.on('data', data => { void output.write(data); });
+let timedOut = false;
+const stop = () => {
+ if (child.exitCode === null && child.signalCode === null && child.pid) {
+ try { execFileSync('taskkill.exe', ['/PID', String(child.pid), '/T', '/F'], { windowsHide: true, stdio: 'ignore' }); } catch {}
+ }
+};
+const timer = setTimeout(() => { timedOut = true; stop(); }, (config.seconds + 40) * 1000);
+process.once('SIGINT', stop);
+let exitCode;
+try {
+ exitCode = await done;
+} finally {
+ clearTimeout(timer);
+ process.removeListener('SIGINT', stop);
+ stop();
+ await output.close();
+}
+const report = JSON.parse(await fs.readFile(path.join(root, 'report.json'), 'utf8').catch(() => '{}'));
+report.processExitCode = exitCode;
+report.timedOut = timedOut;
+report.runtime = runtime;
+if (timedOut) report.status = 'harness-timeout';
+if (!report.crash && !(report.stats?.mutations > 0)) report.status = 'workload-unverified';
+if (config.scenario === 'component') {
+ report.componentVerified = !!(report.stats?.renderedRows > 0 && report.stats?.commits > 1 &&
+ !report.stats?.errors?.length && report.stats?.layout?.display === 'flex' && report.stats?.layout?.overflowY === 'auto');
+ if (!report.crash && !report.componentVerified) report.status = 'component-unverified';
+}
+if (!report.crash && config.ax === 'on' && ['cdp', 'both'].includes(config.query) &&
+ !(report.cdpQueries > 0 && report.maxInlineTextBoxes > 0)) report.status = 'cdp-inline-text-unverified';
+if (config.ax === 'on' && ['native', 'both'].includes(config.query) && !(report.native?.ranges > 0) && !report.crash) report.status = 'native-query-unverified';
+report.dumps = [];
+for (const file of await fs.readdir(path.join(root, 'dumps'), { recursive: true })) {
+ if (file.endsWith('.dmp')) report.dumps.push(inspectDump(path.join(root, 'dumps', file)));
+}
+if (report.crash && report.dumps.some(dump => dump.matchesReported5406)) report.status = 'matched-5406';
+// Only discard this run's generated profile after the owned Electron process has exited.
+const profile = path.resolve(root, 'profile');
+if (path.dirname(profile) !== path.resolve(root)) throw new Error('Unexpected cleanup path');
+try { await fs.rm(profile, { recursive: true, force: true, maxRetries: 3 }); }
+catch (err) { report.profileCleanupError = String(err); }
+await fs.writeFile(path.join(root, 'report.json'), JSON.stringify(report, null, 2));
+// Artifacts intentionally retained for this investigation; no real profile was touched.
+console.log(JSON.stringify({ status: report.status, elapsedMs: Date.parse(report.finishedAt) - Date.parse(report.startedAt),
+ stats: report.stats, cdpQueries: report.cdpQueries, native: report.native,
+ dumpSignatures: report.dumps.map(({ exceptionCode, faultModule, matchesReported5406 }) =>
+ ({ exceptionCode, faultModule, matchesReported5406 })), report: path.join(root, 'report.json') }));
+process.exitCode = report.status === 'completed-no-crash' ? 0 : report.status === 'matched-5406' ? 10 : 2;
diff --git a/apps/desktop/scripts/ax5406/scroll-race.cjs b/apps/desktop/scripts/ax5406/scroll-race.cjs
new file mode 100644
index 0000000000..00911e77b0
--- /dev/null
+++ b/apps/desktop/scripts/ax5406/scroll-race.cjs
@@ -0,0 +1,38 @@
+// Minimal browser-only diagnostic: no React, virtualizer, or application state.
+const fs = require('node:fs');
+const path = require('node:path');
+module.exports = async (win, output) => {
+ const results=[];
+ for(const anchoring of ['auto','none']) for(const settle of ['immediate','raf','two-raf']) {
+ await win.loadURL('data:text/html,'+encodeURIComponent(`<style>body{margin:0}#root{height:600px;overflow:auto;overflow-anchor:${anchoring}}.row{height:300px}</style><div id="root">${Array.from({length:500},(_,i)=>`<div class="row" id="row-${i}">Row ${i}</div>`).join('')}</div>`));
+ const result=await win.webContents.executeJavaScript(`(async()=>{
+ const root=document.querySelector('#root'),target=document.querySelector('#row-420');
+ const samples=[],events=[];let running=true,settled=false;
+ function measure(){samples.push({time:performance.now(),top:root.scrollTop,targetTop:target.getBoundingClientRect().top});if(running)requestAnimationFrame(measure);}measure();
+ root.scrollTop=20000;
+ await new Promise(r=>setTimeout(r,100));
+ root.addEventListener('scrollend',()=>{
+ events.push({kind:'scrollend',time:performance.now(),top:root.scrollTop});
+ if(settled)return;settled=true;
+ const correct=()=>{target.scrollIntoView({block:'center',behavior:'instant'});events.push({kind:'correct',time:performance.now(),top:root.scrollTop});};
+ if('${settle}'==='immediate')correct();
+ else requestAnimationFrame(()=>{if('${settle}'==='raf')correct();else requestAnimationFrame(correct);});
+ });
+ const started=performance.now();let interrupted=false;
+ root.addEventListener('scroll',()=>{
+ if(interrupted||performance.now()-started<330)return;interrupted=true;
+ // Match a virtual row's height correction during the native scroll event.
+ root.getBoundingClientRect();target.getBoundingClientRect();
+ document.querySelector('#row-0').style.height='430px';
+ events.push({kind:'interrupt',time:performance.now(),top:root.scrollTop});root.scrollTop+=130;
+ });
+ target.scrollIntoView({block:'center',behavior:'smooth'});
+ await new Promise(r=>setTimeout(r,1500));running=false;
+ return {events,samples,drift:target.getBoundingClientRect().top-150};
+ })()`);
+ results.push({anchoring,settle,...result});
+ }
+ fs.writeFileSync(path.join(output,'scroll-race.json'),JSON.stringify(results,null,2));
+ await win.webContents.executeJavaScript('window.ax5406Stats={mutations:6,errors:[]}');
+ return {results:results.map(({samples,...r})=>r),failures:results.filter(r=>Math.abs(r.drift)>1).map(r=>r.anchoring+'/'+r.settle+': drift '+r.drift)};
+};
diff --git a/apps/desktop/scripts/ax5406/scroll-report.mjs b/apps/desktop/scripts/ax5406/scroll-report.mjs
new file mode 100644
index 0000000000..a6e95509c1
--- /dev/null
+++ b/apps/desktop/scripts/ax5406/scroll-report.mjs
@@ -0,0 +1,32 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+const roots=process.argv.slice(2);
+if(roots.length!==4)throw new Error('Expected original, full-mount control, fixed-500, fixed-1000 roots');
+const reports=await Promise.all(roots.map(async root=>JSON.parse(await fs.readFile(path.join(root,'scroll-audit.json'),'utf8'))));
+const names=['初版视口挂载:500 条','全量挂载对照:500 条','滚动事件同步挂载:500 条','滚动事件同步挂载:1000 条'];
+const escape=s=>String(s).replaceAll('&','&amp;').replaceAll('<','&lt;');
+const rows=reports.map((report,i)=>{
+ const samples=report.samples.filter(s=>!s.phase.endsWith('-jumps'));
+ const forced=report.samples.filter(s=>s.phase.endsWith('-jumps'));
+ const other=report.failures.filter(s=>!/blank \/|overlapping frame/.test(s));
+ return `<tr><td>${names[i]}</td><td>${samples.length}</td><td>${samples.filter(s=>s.blank.length).length}</td><td>${samples.filter(s=>s.overlaps).length}</td><td>${forced.filter(s=>s.blank.length).length} / ${forced.length}</td><td>${other.length?escape(other.join(';')):'无'}</td></tr>`;
+});
+const figures=[];
+for(const [index,file,title] of [
+ [2,'paint-1000x760-light-fast-up-12.png','修正后:高速滚轮,浅色'],
+ [2,'paint-1000x760-light-thumb-drag-10.png','修正后:真实拖动滚动条'],
+ [3,'620x1000-dark-reading.png','1000 条历史:窄窗深色,停止后阅读'],
+ [2,'paint-620x1000-dark-jumps-12.png','边界压力:绘制回调直接改 scrollTop,仍可能出现一帧空白'],
+ [1,'paint-620x1000-dark-jumps-12.png','全量挂载对照:同类强制位置跳跃'],
+]){
+ const data=await fs.readFile(path.join(roots[index],file));
+ figures.push(`<figure><figcaption>${escape(title)}</figcaption><img src="data:image/png;base64,${data.toString('base64')}" alt="${escape(title)}"></figure>`);
+}
+const html=`<!doctype html><html lang="zh-CN"><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>消息视口挂载:增强滚动验证</title><style>body{font:16px/1.7 system-ui,sans-serif;background:#f3f4f6;color:#17202a;max-width:1000px;margin:auto;padding:20px}h1{font-size:24px}table{border-collapse:collapse;font-size:14px;width:100%;background:white}th,td{padding:10px;border:1px solid #ddd;text-align:left}figure{margin:24px 0;background:white;border-radius:12px;overflow:hidden}figcaption{padding:14px;font-weight:600}img{width:100%;display:block}aside{border-left:4px solid #c67c00;padding:12px;background:#fff4d5}.table{overflow-x:auto}</style>
+<h1>消息视口挂载:增强滚动验证</h1><p>2026-10-03,Windows Electron,真实 MessageStream 与正式样式,合成 500 / 1000 条消息。保持无障碍开启。测试窗口为 1000×420、1000×760、620×1000,覆盖浅色和深色。</p>
+<p>发现并修正了初版快速滚动闪空:滚动事件不再等下一次 requestAnimationFrame 才挂载正文,而是在事件中同步完成挂载。正常缓慢滚动、快速滚动、来回滚动、真实滚动条拖动、键盘翻页、搜索跳转、回底按钮均参与检查。</p>
+<aside>整体结果不是“全部通过”。真实滚轮与拖动闪空已补修,但搜索落点仍有失败;直接在绘制回调中强制改 scrollTop 的诊断负载也仍产生空帧。脚本保留失败退出码与原始记录。当前不能作为完整安装版客户端验收通过的证据。</aside>
+<div class="table"><table><thead><tr><th>版本</th><th>其他阶段采样</th><th>空占位</th><th>行重叠</th><th>直接强制跳跃:空 / 总采样</th><th>其他未通过检查</th></tr></thead><tbody>${rows.join('')}</tbody></table></div>
+<p>采样在 rAF 后的任务中读取几何和占位状态;高速阶段同时使用 Electron beginFrameSubscription 保存实际绘制帧。以下原图未编辑,位置与消息内容受调度影响,不做逐像素黄金图比较。</p>${figures.join('')}
+<p>阅读位置在停止滚动后再次检查,允许 2px 误差。原始 scroll-audit.json、PNG、report.json 和构建来源哈希保留在各产物目录。</p></html>`;
+const out=path.join(roots.at(-1),'scroll-report.html');await fs.writeFile(out,html);console.log(out);
diff --git a/apps/desktop/scripts/ax5406/scroll-tests.cjs b/apps/desktop/scripts/ax5406/scroll-tests.cjs
new file mode 100644
index 0000000000..6d5751ab49
--- /dev/null
+++ b/apps/desktop/scripts/ax5406/scroll-tests.cjs
@@ -0,0 +1,193 @@
+// Extended scrolling checks on real MessageStream; synthetic data, isolated HWND.
+const fs = require('node:fs');
+const path = require('node:path');
+module.exports = async (win, output, config = {}) => {
+ const js = code => win.webContents.executeJavaScript(code);
+ const wait = ms => new Promise(resolve => setTimeout(resolve, ms));
+ const failures = [], cases = [], navigation = [];
+ let capturePhase = 'setup';
+ const paintedFrames = [], paintCounts = {};
+ win.webContents.beginFrameSubscription(false, frame => {
+ if (!/fast-|jumps|thumb-drag|jump-button/.test(capturePhase)) return;
+ const count = paintCounts[capturePhase] = (paintCounts[capturePhase] || 0) + 1;
+ if (count > 32 || (!capturePhase.endsWith('jump-button') && count % 2)) return;
+ const file = `paint-${capturePhase}-${count}.png`;
+ fs.writeFileSync(path.join(output,file),frame.toPNG());
+ paintedFrames.push({phase:capturePhase,count,file});
+ });
+ await wait(500);
+ if(config.anchoring === 'off') await js(`document.querySelector('[data-scroll-container]').style.overflowAnchor='none'`);
+ if(config.mounting === 'full') {
+ // Existing keyboard traversal fallback mounts every logical row. No CSS or
+ // production source override; useful as a full-mount geometry control.
+ await js(`document.querySelector('[data-scroll-container]').dispatchEvent(new KeyboardEvent('keydown',{key:'Tab',bubbles:true}))`);
+ await wait(200);
+ }
+ await js(`(() => {
+ const root=document.querySelector('[data-scroll-container]');
+ window.scrollAudit={samples:[],phase:'setup',running:true,inputs:0};
+ window.scrollAudit.lastScroll=performance.now();
+ root.addEventListener('scroll',()=>{window.scrollAudit.lastScroll=performance.now();});
+ window.scrollAudit.writes=[];
+ const record=(kind,detail)=>{
+ if(!/search|jump-button|jumps/.test(window.scrollAudit.phase))return;
+ const target=document.querySelector('[data-message-client-id="'+window.scrollAudit.target+'"]');
+ window.scrollAudit.writes.push({time:performance.now(),phase:window.scrollAudit.phase,
+ kind,detail,top:root.scrollTop,total:root.scrollHeight,nativeAnchoring:getComputedStyle(root).overflowAnchor,target:window.scrollAudit.target,
+ targetTop:target?.getBoundingClientRect().top-root.getBoundingClientRect().top,
+ stack:kind==='scrollend'?undefined:new Error().stack});
+ };
+ let proto=root, descriptor;
+ while(proto&&!descriptor){descriptor=Object.getOwnPropertyDescriptor(proto,'scrollTop');proto=Object.getPrototypeOf(proto);}
+ Object.defineProperty(root,'scrollTop',{configurable:true,get(){return descriptor.get.call(this);},
+ set(value){record('scrollTop',value);descriptor.set.call(this,value);}});
+ for(const method of ['scrollTo','scrollBy']) {
+ const original=root[method];root[method]=function(...args){record(method,args);return original.apply(this,args);};
+ }
+ const intoView=Element.prototype.scrollIntoView;
+ Element.prototype.scrollIntoView=function(...args){
+ if(root.contains(this))record('scrollIntoView',{id:this.dataset.messageClientId,args});
+ if(${JSON.stringify(config.settlement)}==='two-raf'&&root.contains(this)&&args[0]?.block==='center'&&!args[0]?.behavior){
+ const phase=window.scrollAudit.phase,target=window.scrollAudit.target;
+ requestAnimationFrame(()=>requestAnimationFrame(()=>{
+ if(window.scrollAudit.phase===phase&&window.scrollAudit.target===target){record('late-correct',target);intoView.apply(this,args);}
+ }));
+ }
+ if(${JSON.stringify(config.settlement)}==='scroll-to'&&root.contains(this)&&args[0]?.block==='center'&&!args[0]?.behavior){
+ const b=this.getBoundingClientRect(),r=root.getBoundingClientRect();
+ return root.scrollTo({top:root.scrollTop+b.top-r.top-(root.clientHeight-b.height)/2,behavior:'instant'});
+ }
+ return intoView.apply(this,args);
+ };
+ root.addEventListener('scrollend',()=>record('scrollend'));
+ window.scrollAudit.measure=()=>{
+ const bounds=root.getBoundingClientRect();
+ const rows=[...document.querySelector('.msg-stream-items').children].map(e=>{
+ const r=e.getBoundingClientRect();return {key:e.dataset.renderItemKey,top:r.top-bounds.top,
+ bottom:r.bottom-bounds.top,height:r.height,placeholder:e.hasAttribute('data-message-placeholder')};
+ });
+ const visible=rows.filter(r=>r.bottom>1&&r.top<root.clientHeight-1&&r.height>0);
+ return {time:performance.now(),phase:window.scrollAudit.phase,scrollTop:root.scrollTop,
+ height:root.clientHeight,total:root.scrollHeight,nativeAnchoring:getComputedStyle(root).overflowAnchor,mounted:rows.filter(r=>!r.placeholder).length,
+ count:rows.length,anchor:visible[0],blank:visible.filter(r=>r.placeholder),
+ blankPixels:visible.filter(r=>r.placeholder).reduce((sum,r)=>sum+Math.min(root.clientHeight,r.bottom)-Math.max(0,r.top),0),
+ overlaps:rows.slice(1).filter((r,i)=>r.top<rows[i].bottom-1).length};
+ };
+ function frame(){if(!window.scrollAudit.running)return;
+ // Task after the frame callback: avoids measuring before the hook's rAF.
+ requestAnimationFrame(()=>{setTimeout(()=>{if(window.scrollAudit.running)window.scrollAudit.samples.push(window.scrollAudit.measure());},0);frame();});
+ }frame();
+ })()`);
+ const phase = name => {capturePhase=name;return js(`window.scrollAudit.phase=${JSON.stringify(name)}`);};
+ const snap = async name => {
+ const state = await js('window.scrollAudit.measure()');
+ fs.writeFileSync(path.join(output, `${name}.png`), (await win.webContents.capturePage()).toPNG());
+ if(state.blank.length||state.overlaps)failures.push(`${name}: settled layout anomaly`);
+ return state;
+ };
+ const wheel = async (delta, count, interval=16) => {
+ for(let i=0;i<count;i++) {
+ win.webContents.sendInputEvent({type:'mouseWheel',x:220,y:180,deltaY:delta,deltaX:0});
+ await wait(interval);
+ }
+ };
+ for (const [width,height,dark] of [[1000,420,false],[1000,760,false],[620,1000,true]]) {
+ const label=`${width}x${height}-${dark?'dark':'light'}`;
+ win.setSize(width,height);
+ await js(`window.ax5406Visual.theme(${dark})`); await wait(450);
+ await phase(label+'-slow-up'); await wheel(80,80);
+ await phase(label+'-slow-down'); await wheel(-80,80);
+ await phase(label+'-fast-up'); await wheel(900,70);
+ await phase(label+'-fast-down'); await wheel(-900,70);
+ await phase(label+'-reverse');
+ for(let i=0;i<60;i++)await wheel(i%2? -450:450,1);
+ // Explicit wheel leaves follow mode, then large range changes model scrollbar/page jumps.
+ await wheel(300,2); await wait(100);
+ await phase(label+'-jumps');
+ const jumpPositions=await js(`(async()=>{const r=document.querySelector('[data-scroll-container]'),positions=[];
+ for(let i=0;i<60;i++) {r.scrollTop=(r.scrollHeight-r.clientHeight)*((i*37%97)/100);
+ await new Promise(resolve=>requestAnimationFrame(()=>requestAnimationFrame(resolve)));
+ positions.push(r.scrollTop);}
+ return positions;
+ })()`);
+ // No blanks is insufficient if stale tail-follow simply undoes every jump.
+ if(Math.max(...jumpPositions)-Math.min(...jumpPositions)<1000 || new Set(jumpPositions.map(Math.round)).size<20) {
+ failures.push(`${label}-jumps: requested range changes were undone`);
+ }
+ await phase(label+'-keyboard');
+ await js(`(()=>{const r=document.querySelector('[data-scroll-container]');r.tabIndex=0;r.focus({preventScroll:true});})()`);
+ for(const key of ['HOME',...Array(12).fill('PAGEDOWN'),...Array(12).fill('PAGEUP'),'END']) {
+ win.webContents.sendInputEvent({type:'keyDown',keyCode:key});
+ win.webContents.sendInputEvent({type:'keyUp',keyCode:key});await wait(60);
+ }
+ await wait(450);
+ await phase(label+'-search');
+ if(config.anchoring === 'search')await js(`document.querySelector('[data-scroll-container]').style.overflowAnchor='none'`);
+ for(const id of [420,470,430,490,440]) {
+ await js(`window.scrollAudit.target='synthetic-${id}'`);
+ await js(`window.ax5406Visual.focus('synthetic-${id}')`);
+ const target=await js(`(async()=>{const started=performance.now();let visible=false;
+ do {await new Promise(resolve=>setTimeout(resolve,50));
+ const e=document.querySelector('[data-message-client-id="synthetic-${id}"]'),root=document.querySelector('[data-scroll-container]');
+ const b=e?.getBoundingClientRect(),r=root.getBoundingClientRect();visible=!!b&&!e.hasAttribute('data-message-placeholder')&&b.bottom>r.top&&b.top<r.bottom;
+ if(visible&&performance.now()-started>300&&performance.now()-window.scrollAudit.lastScroll>150)break;
+ }while(performance.now()-started<3000);
+ return {visible,elapsedMs:performance.now()-started};})()`);
+ navigation.push({label,id,...target});
+ if(!target.visible)failures.push(label+': search target not visible after settling '+id);
+ if(id===420)await snap(label+'-search-420');
+ }
+ await phase(label+'-search-takeover');
+ await js(`window.ax5406Visual.focus('synthetic-450')`);await wait(80);
+ await wheel(300,4);await wait(400);
+ const takeover=await js('window.scrollAudit.measure()');await wait(700);
+ const takenOver=await js('window.scrollAudit.measure()');
+ if(takeover.anchor?.key!==takenOver.anchor?.key||Math.abs(takeover.anchor?.top-takenOver.anchor?.top)>2)failures.push(label+': cancelled search moved the reading anchor');
+ await js('window.ax5406Visual.focus(undefined)');
+ if(config.anchoring === 'search')await js(`document.querySelector('[data-scroll-container]').style.removeProperty('overflow-anchor')`);
+ await phase(label+'-jump-button');
+ await js(`(()=>{const e=[...document.querySelectorAll('button')].find(e=>/new messages|Jump to bottom/.test(e.textContent));if(e)e.click();})()`);
+ await wait(1800);
+ const pinned=await js('window.scrollAudit.measure()');
+ if(pinned.total-pinned.scrollTop-pinned.height>2)failures.push(label+': jump-to-bottom failed');
+ await wheel(300,8); await wait(200);
+ await phase(label+'-idle'); await wait(400);
+ const before=await snap(label+'-reading');await wait(700);
+ const after=await js('window.scrollAudit.measure()');
+ if(before.anchor?.key!==after.anchor?.key||Math.abs(before.anchor?.top-after.anchor?.top)>2)failures.push(label+': idle reading drift');
+ // Exercise a genuine scrollbar-thumb drag, not just scrollTop assignment.
+ const drag=await js(`(()=>{const r=document.querySelector('[data-scroll-container]'),b=r.getBoundingClientRect();
+ return {x:Math.floor(b.right-3),top:Math.ceil(b.top)+18,track:r.clientHeight-36,
+ fraction:r.scrollTop/(r.scrollHeight-r.clientHeight),thumb:Math.max(24,(r.clientHeight-36)*r.clientHeight/r.scrollHeight),start:r.scrollTop};})()`);
+ const startY=Math.round(drag.top+(drag.track-drag.thumb)*drag.fraction+drag.thumb/2);
+ await phase(label+'-thumb-drag');
+ win.webContents.sendInputEvent({type:'mouseMove',x:drag.x,y:startY});
+ win.webContents.sendInputEvent({type:'mouseDown',x:drag.x,y:startY,button:'left',clickCount:1});
+ for(let i=0;i<40;i++) {
+ const y=Math.round(drag.top+drag.track*(.1+.8*((i*7%39)/39)));
+ win.webContents.sendInputEvent({type:'mouseMove',x:drag.x,y,movementX:0,movementY:0});await wait(20);
+ }
+ win.webContents.sendInputEvent({type:'mouseUp',x:drag.x,y:Math.round(drag.top+drag.track*.5),button:'left',clickCount:1});
+ await wait(450);const end=await snap(label+'-after-drag');
+ cases.push({label,before,after,dragStart:drag.start,dragEnd:end.scrollTop});
+ if(Math.abs(end.scrollTop-drag.start)<1000)failures.push(label+': scrollbar drag not verified');
+ // Content changes while browsing, followed by another traversal.
+ await phase(label+'-mutate-and-scroll');
+ await js(`window.ax5406Visual.grow('synthetic-497');window.ax5406Visual.image('synthetic-496');window.ax5406Visual.append()`);
+ await wheel(240,35);await wheel(-240,35);
+ }
+ await phase('final-idle');await wait(500);
+ const final=await snap('final');
+ const audit=await js('window.scrollAudit.running=false;({samples:window.scrollAudit.samples,writes:window.scrollAudit.writes,errors:window.ax5406Stats.errors})');
+ const phases={};
+ for(const s of audit.samples) {
+ const p=phases[s.phase]??={frames:0,blankFrames:0,overlaps:0,maxBlankPixels:0,minMounted:Infinity,maxMounted:0};
+ p.frames++;p.blankFrames+=Number(s.blank.length>0);p.overlaps+=Number(s.overlaps>0);
+ p.maxBlankPixels=Math.max(p.maxBlankPixels,s.blankPixels);p.minMounted=Math.min(p.minMounted,s.mounted);p.maxMounted=Math.max(p.maxMounted,s.mounted);
+ }
+ if(audit.errors.length)failures.push('renderer errors');
+ for(const [name,p]of Object.entries(phases))if(p.blankFrames||p.overlaps)failures.push(`${name}: ${p.blankFrames} blank / ${p.overlaps} overlapping frame samples`);
+ win.webContents.endFrameSubscription();
+ fs.writeFileSync(path.join(output,'scroll-audit.json'),JSON.stringify({cases,phases,failures,navigation,final,paintedFrames,...audit},null,2));
+ return {cases,phases,failures,samples:audit.samples.length};
+};
diff --git a/apps/desktop/scripts/ax5406/stack-windows.cpp b/apps/desktop/scripts/ax5406/stack-windows.cpp
new file mode 100644
index 0000000000..8e7fbf98c7
--- /dev/null
+++ b/apps/desktop/scripts/ax5406/stack-windows.cpp
@@ -0,0 +1,41 @@
+// Offline minidump analysis through Microsoft's DbgEng. Never attaches to a live process.
+// Build using the VS x64 tools + Windows SDK: cl /EHsc stack-windows.cpp /link dbgeng.lib
+// Usage: stack-windows.exe dump.dmp "srv*C:\task-cache*https://symbols.electronjs.org;srv*C:\task-cache*https://msdl.microsoft.com/download/symbols"
+#include <windows.h>
+#include <dbgeng.h>
+#include <cstdio>
+
+class DebugOutput final : public IDebugOutputCallbacks {
+ public:
+ STDMETHOD(QueryInterface)(REFIID iid, PVOID* out) override {
+ if (iid == __uuidof(IUnknown) || iid == __uuidof(IDebugOutputCallbacks)) {
+ *out = static_cast<IDebugOutputCallbacks*>(this); return S_OK;
+ }
+ *out = nullptr; return E_NOINTERFACE;
+ }
+ STDMETHOD_(ULONG, AddRef)() override { return 1; }
+ STDMETHOD_(ULONG, Release)() override { return 1; }
+ STDMETHOD(Output)(ULONG, PCSTR text) override { std::fputs(text, stdout); std::fflush(stdout); return S_OK; }
+};
+int wmain(int argc, wchar_t** argv) {
+ if (argc != 3) return 2;
+ IDebugClient4* client = nullptr;
+ IDebugControl* control = nullptr;
+ IDebugSymbols3* symbols = nullptr;
+ HRESULT hr = DebugCreate(__uuidof(IDebugClient4), reinterpret_cast<void**>(&client));
+ if (FAILED(hr)) return 3;
+ DebugOutput output;
+ client->SetOutputCallbacks(&output);
+ client->QueryInterface(__uuidof(IDebugControl), reinterpret_cast<void**>(&control));
+ client->QueryInterface(__uuidof(IDebugSymbols3), reinterpret_cast<void**>(&symbols));
+ if (!control || !symbols) return 4;
+ symbols->SetSymbolPathWide(argv[2]);
+ hr = client->OpenDumpFileWide(argv[1], 0);
+ if (SUCCEEDED(hr)) hr = control->WaitForEvent(0, INFINITE);
+ if (SUCCEEDED(hr)) {
+ control->Execute(DEBUG_OUTCTL_THIS_CLIENT, ".ecxr; kv 100; lmv a @rip; ln @rip; ub @rip L2; u @rip L2", DEBUG_EXECUTE_DEFAULT);
+ } else std::printf("DbgEng failed: 0x%08lx\n", hr);
+ client->EndSession(DEBUG_END_PASSIVE);
+ symbols->Release(); control->Release(); client->SetOutputCallbacks(nullptr); client->Release();
+ return FAILED(hr) ? 5 : 0;
+}
diff --git a/apps/desktop/scripts/ax5406/stream-diagnosis-report.mjs b/apps/desktop/scripts/ax5406/stream-diagnosis-report.mjs
new file mode 100644
index 0000000000..96f30ec3eb
--- /dev/null
+++ b/apps/desktop/scripts/ax5406/stream-diagnosis-report.mjs
@@ -0,0 +1,35 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+const roots=process.argv.slice(2);
+if(roots.length!==3)throw new Error('Expected current-probe, HEAD-probe, final-verification');
+const audits=await Promise.all(roots.map(async root=>JSON.parse(await fs.readFile(path.join(root,'stream-audit.json'),'utf8'))));
+const names=['当前代码:定位轮','修改前 HEAD:对照轮','当前代码:修正判据后复测'];
+const esc=x=>String(x).replaceAll('&','&amp;').replaceAll('<','&lt;');
+const summaries=audits.map(a=>{
+ const frames=a.paintAudit.filter(p=>/-follow$|-resume$|-finish$/.test(p.phase));
+ return {frames:frames.length,missing:frames.filter(p=>!p.markerPixels).length,
+ gaps:a.samples.filter(s=>/-follow$|-resume$|-finish$/.test(s.phase)&&s.distance>2).length,
+ resize:a.timeline.filter(e=>e.kind==='resize-after-owner'&&e.distance>2).length,
+ controls:a.paintAudit.filter(p=>p.phase.endsWith('-reading')&&!p.markerPixels).length};
+});
+const timeline=audits[0].timeline;
+const start=timeline.findIndex(e=>e.kind==='mutation'&&e.distance>2);
+const first=timeline[start];
+const stages=timeline.slice(start,start+4);
+const labels={'mutation':'文字 DOM 更新','rAF-before-layout':'绘制前动画帧回调','scroll-write':'高度补偿写入位置','resize-after-owner':'补偿后的尺寸观察'};
+const figures=[];
+for(const [i,file,title]of [
+ [0,'stream-1000x760-light-resume-2.png','当前代码:浅色恢复输出,底边标记仍在窗口底部'],
+ [0,'stream-620x1000-dark-resume-2.png','当前代码:深色恢复输出,底边标记仍在窗口底部'],
+ [1,'stream-1000x760-light-resume-2.png','修改前代码:同类输出画面'],
+ [2,'620x1000-dark-finish.png','最终复测:输出结束,最后分片完整'],
+])figures.push(`<figure><figcaption>${title}</figcaption><img src="data:image/png;base64,${(await fs.readFile(path.join(roots[i],file))).toString('base64')}" alt="${title}"></figure>`);
+const html=`<!doctype html><html lang="zh-CN"><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>流式输出:离底疑点定位</title><style>body{max-width:960px;margin:auto;padding:18px;background:#f3f4f6;color:#17202a;font:16px/1.7 system-ui}h1{font-size:24px}h2{font-size:18px}section,figure{background:white;margin:18px 0;padding:14px;border-radius:12px;overflow:auto}figure{padding:0}figcaption{padding:14px}img{display:block;width:100%}table{width:100%;border-collapse:collapse;font-size:14px}td,th{text-align:left;padding:8px;border-bottom:1px solid #ddd}aside{padding:14px;background:#e7f3ed}code{overflow-wrap:anywhere}</style>
+<h1>流式输出:离底疑点定位</h1><aside>此次复现的短暂离底读数位于 DOM 更新与绘制前补偿之间。当前版和修改前版都出现该读数,捕获到的实际贴底绘制帧均未出现离底。生产代码无需为这个中间状态新增补丁。</aside>
+<p>2026-10-03,Windows Electron 41.10.3;实际 MessageStream、合成分片、独立窗口,AX 开启。1000 条历史、三种窗口尺寸、Light / Dark,每轮 1200 个有序分片。不是完整安装版或真实模型链路验收。</p>
+<section><h2>真实时序示例</h2><table><tr><th>事件</th><th>相对时间</th><th>离底</th></tr>${stages.map(e=>`<tr><td>${labels[e.kind]||esc(e.kind)}</td><td>+${(e.time-first.time).toFixed(1)}ms</td><td>${e.distance}px</td></tr>`).join('')}</table><p>旧采样器用 rAF 后的 setTimeout 读取几何,可能与另一次 Markdown 异步提交交错。这个读数不代表屏幕已经画出了该状态。</p></section>
+<section><h2>绘制帧与修改前对照</h2><table><tr><th>版本</th><th>中间态采样</th><th>贴底绘制帧</th><th>实际离底帧</th><th>补偿后离底</th></tr>${summaries.map((s,i)=>`<tr><td>${names[i]}<br>${path.basename(roots[i])}</td><td>${s.gaps}</td><td>${s.frames}</td><td>${s.missing}</td><td>${s.resize}</td></tr>`).join('')}</table><p>修改前来源为 HEAD <code>d656b0fc1ec3e04548cd018654cbd6486f6cf839</code> 的 MessageStream 与 CSS,由构建插件只读载入,未回退工作区。源码 SHA-256 已核对;对照版仍挂载 80 条正文并保留 content-visibility:auto。</p></section>
+<p>紫色细线是仅测试窗口中的绝对定位标记,不参与布局,跟随内容底边。检测直接读取 Electron 输出帧的像素。主动上翻时标记移出屏幕,三轮分别捕获 ${summaries.map(s=>s.controls).join('、')} 帧,验证检测器能识别真正的离底。标记不进入生产 UI。</p>
+<p>修正后的检查保留所有中间态读数;新增实际绘制离底、补偿后残留离底、九个阶段缺少绘制证据、正反对照无效的失败门槛。最终轮失败数:${audits[2].failures.length}。没有删除历史失败记录。</p>
+${figures.join('')}<p>图片均为未经编辑的真实测试窗口截帧;只能说明本轮捕获帧与负载,没有证明所有平台、硬件和复杂消息组合绝无异常。未修改生产代码,未提交或发布。</p></html>`;
+const file=path.join(roots.at(-1),'stream-diagnosis.html');await fs.writeFile(file,html);console.log(file);
diff --git a/apps/desktop/scripts/ax5406/stream-report.mjs b/apps/desktop/scripts/ax5406/stream-report.mjs
new file mode 100644
index 0000000000..8ba2c98b96
--- /dev/null
+++ b/apps/desktop/scripts/ax5406/stream-report.mjs
@@ -0,0 +1,26 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+const roots=process.argv.slice(2);
+if(roots.length!==4)throw new Error('Expected four stream-test artifact directories');
+const audits=await Promise.all(roots.map(async root=>JSON.parse(await fs.readFile(path.join(root,'stream-audit.json'),'utf8'))));
+const escape=value=>String(value).replaceAll('&','&amp;').replaceAll('<','&lt;');
+const samples=audits.flatMap(a=>a.samples);
+const gaps=samples.filter(s=>/-follow$|-resume$|-finish$/.test(s.phase)&&s.distance>2);
+const cards=audits.map((a,i)=>`<section><h2>${i>=2?'1000 条历史'+(i===3?',加密截帧':''):'500 条历史'+(i===1?',重复':'')}</h2><p>${escape(path.basename(roots[i]))}:${a.samples.length} 次采样;${a.failures.length?'检查未通过:'+escape(a.failures.join(';')):'本轮所有检查通过'}</p><table><tr><th>窗口</th><th>分片</th><th>阅读偏移</th><th>结束离底</th></tr>${a.cases.map(c=>`<tr><td>${c.label}</td><td>${c.tokenCount}/400</td><td>${c.after.rows.find(r=>r.key===c.before.anchor?.key)?.top-c.before.anchor.top}px</td><td>${c.finished.distance}px</td></tr>`).join('')}</table></section>`).join('');
+const images=[];
+for(const [i,file,title]of [
+ [0,'1000x760-light-follow.png','浅色:持续出字,跟随底部'],
+ [0,'620x1000-dark-reading-before.png','深色:上翻接管后的阅读位置'],
+ [0,'620x1000-dark-reading-after.png','深色:继续输出后仍停在原阅读位置'],
+ [1,'1000x760-light-resume.png','重复测试:回到底部并加速输出'],
+ [2,'620x1000-dark-finish.png','1000 条历史:输出结束后的完整尾段'],
+ [3,'stream-1000x760-light-resume-1.png','恢复输出:原始绘制帧 1'],
+ [3,'stream-1000x760-light-resume-2.png','恢复输出:原始绘制帧 2'],
+])images.push(`<figure><figcaption>${title}</figcaption><img src="data:image/png;base64,${(await fs.readFile(path.join(roots[i],file))).toString('base64')}" alt="${title}"></figure>`);
+const html=`<!doctype html><html lang="zh-CN"><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>流式输出专项测试</title><style>body{max-width:920px;margin:auto;padding:18px;background:#f3f4f6;color:#17202a;font:16px/1.65 system-ui}h1{font-size:24px}h2{font-size:18px}section,figure{background:white;margin:16px 0;padding:14px;border-radius:12px;overflow:auto}figure{padding:0}figcaption{padding:14px}img{display:block;width:100%}table{width:100%;border-collapse:collapse;font-size:14px}td,th{text-align:left;padding:8px;border-bottom:1px solid #ddd}aside{background:#fff4d5;padding:14px}</style><h1>流式输出专项测试</h1>
+<p>2026-10-03,Windows Electron 41.10.3。实际 MessageStream 与样式,合成分片输入,独立测试窗口;没有调用模型或服务端,也不等同于整个安装版客户端验收。</p>
+<p>500 条历史两轮、1000 条两轮(最后一轮加密截取恢复输出的首八张绘制帧);每轮覆盖宽窗、窄窗深色、矮窗。每个尺寸累计 400 个有序分片,包含中英文与基础 Markdown,先每 30ms 追加,再每 10ms 追加。覆盖贴底跟随、输出中滚轮接管、上翻停留、End 回底、继续输出及结束。</p>
+<p>总采样 ${samples.length} 次;含空占位 ${samples.filter(s=>s.blank).length} 次;行重叠 ${samples.filter(s=>s.overlap).length} 次。最终按标记检查 ${audits.flatMap(a=>a.cases).reduce((s,c)=>s+c.tokenCount,0)} 个分片。</p>
+<aside>贴底阶段仍保留 ${gaps.length} 次距离底部超过 2px 的采样,最大 ${Math.max(0,...gaps.map(s=>s.distance))}px。几何读数可能处于 Markdown 异步提交与下一次高度补偿之间;仅凭读数无法断言这一状态已被绘制。失败记录保留,不能宣称所有帧均无异常。</aside>
+${cards}<p>下方为未经编辑的真实组件截图。截图目检和几何采样互补,未逐像素审查每次显示器刷新。</p>${images.join('')}</html>`;
+const file=path.join(roots.at(-1),'stream-report.html');await fs.writeFile(file,html);console.log(file);
diff --git a/apps/desktop/scripts/ax5406/stream-tests.cjs b/apps/desktop/scripts/ax5406/stream-tests.cjs
new file mode 100644
index 0000000000..f79ab93724
--- /dev/null
+++ b/apps/desktop/scripts/ax5406/stream-tests.cjs
@@ -0,0 +1,159 @@
+// Actual MessageStream, incremental synthetic chunks; no model/backend call.
+const fs = require('node:fs');
+const path = require('node:path');
+module.exports = async (win, output, config) => {
+ const js = code => win.webContents.executeJavaScript(code);
+ const wait = ms => new Promise(resolve => setTimeout(resolve, ms));
+ const failures = [], geometryWarnings = [], cases = [], paintedFrames = [], paintAudit = [];
+ let phase = 'setup', paints = 0;
+ win.webContents.beginFrameSubscription(false, frame => {
+ if (phase === 'setup') return;
+ paints++;
+ let markerPixels = null;
+ if (config.streamProbe === 'on') {
+ const bitmap=frame.toBitmap(), size=frame.getSize();
+ markerPixels=0;
+ for(let y=Math.max(0,size.height-12);y<size.height;y++)for(let x=0;x<size.width;x++){
+ const p=(y*size.width+x)*4;
+ if(bitmap[p]===255&&bitmap[p+1]===0&&bitmap[p+2]===255&&bitmap[p+3]===255)markerPixels++;
+ }
+ paintAudit.push({phase,count:paints,time:Date.now(),markerPixels});
+ }
+ const missingMarker=config.streamProbe==='on'&&/-follow$|-resume$|-finish$/.test(phase)&&markerPixels===0;
+ if (!missingMarker && (paints > 120 || (paints % 20 && !(phase.endsWith('-resume') && paints <= 8)))) return;
+ const file = `stream-${phase}-${paints}.png`;
+ fs.writeFileSync(path.join(output, file), frame.toPNG());
+ paintedFrames.push(file);
+ });
+ await wait(600);
+ await js(`(() => {
+ const root=document.querySelector('[data-scroll-container]');
+ window.streamAudit={running:true,samples:[],phase:'setup'};
+ window.streamAudit.measure=()=>{
+ const rect=root.getBoundingClientRect();
+ const rows=[...document.querySelector('.msg-stream-items').children].map(e=>{
+ const b=e.getBoundingClientRect();return {key:e.dataset.renderItemKey,top:b.top-rect.top,
+ bottom:b.bottom-rect.top,placeholder:e.hasAttribute('data-message-placeholder')};
+ });
+ const visible=rows.filter(r=>r.bottom>1&&r.top<root.clientHeight-1);
+ return {phase:window.streamAudit.phase,time:performance.now(),top:root.scrollTop,
+ distance:root.scrollHeight-root.clientHeight-root.scrollTop,anchor:visible[0],rows,
+ blank:visible.filter(r=>r.placeholder).length,
+ overlap:rows.slice(1).filter((r,i)=>r.top<rows[i].bottom-1).length};
+ };
+ function frame(){if(!window.streamAudit.running)return;
+ requestAnimationFrame(()=>{setTimeout(()=>{if(window.streamAudit.running)window.streamAudit.samples.push(window.streamAudit.measure());},0);frame();});
+ }frame();
+ })()`);
+ if (config.streamProbe === 'on') await js(`(() => {
+ const root=document.querySelector('[data-scroll-container]'),content=root.firstElementChild;
+ const marker=document.createElement('span');marker.setAttribute('aria-hidden','true');
+ marker.style.cssText='position:absolute;bottom:0;left:0;width:12px;height:3px;background:rgb(255,0,255);pointer-events:none;overflow-anchor:none;z-index:2147483647';
+ content.append(marker);
+ window.streamAudit.timeline=[];
+ const record=kind=>{
+ if(!/-follow$|-resume$|-finish$/.test(window.streamAudit.phase))return;
+ window.streamAudit.timeline.push({kind,time:performance.now(),wallTime:Date.now(),phase:window.streamAudit.phase,
+ top:root.scrollTop,distance:root.scrollHeight-root.clientHeight-root.scrollTop,
+ markerBottom:marker.getBoundingClientRect().bottom-root.getBoundingClientRect().bottom});
+ };
+ let owner=root,descriptor;while(owner&&!descriptor){descriptor=Object.getOwnPropertyDescriptor(owner,'scrollTop');owner=Object.getPrototypeOf(owner);}
+ Object.defineProperty(root,'scrollTop',{configurable:true,get:descriptor.get,set(value){descriptor.set.call(this,value);record('scroll-write');}});
+ const mo=new MutationObserver(()=>record('mutation'));mo.observe(document.querySelector('.msg-stream-items'),{subtree:true,childList:true,characterData:true});
+ const ro=new ResizeObserver(()=>record('resize-after-owner'));ro.observe(content);
+ function frame(){if(!window.streamAudit.running){mo.disconnect();ro.disconnect();return;}
+ requestAnimationFrame(()=>{record('rAF-before-layout');frame();});}frame();
+ })()`);
+ const setPhase = async value => {phase=value;paints=0;await js(`window.streamAudit.phase=${JSON.stringify(value)}`);};
+ const snap = async name => {
+ const state=await js('window.streamAudit.measure()');
+ fs.writeFileSync(path.join(output,`${name}.png`),(await win.webContents.capturePage()).toPNG());
+ return state;
+ };
+ const chunks = (from, count, interval) => js(`(async()=>{
+ for(let i=${from};i<${from+count};i++){
+ const text='chunk'+String(i).padStart(4,'0')+' '+
+ (i%12===0?'**Incremental bold** and *emphasis*. ':'Streaming output, wrapping and layout. ')+
+ 'Chinese: '+String.fromCharCode(0x4e2d,0x6587,0x8f93,0x51fa)+' '+(i%4===3?'\\n\\n':'');
+ window.ax5406Visual.streamChunk(text);
+ await new Promise(resolve=>setTimeout(resolve,${interval}));
+ }
+ })()`);
+ const endKey = async () => {
+ await js(`(()=>{const r=document.querySelector('[data-scroll-container]');r.tabIndex=0;r.focus({preventScroll:true});})()`);
+ win.webContents.sendInputEvent({type:'keyDown',keyCode:'END'});
+ win.webContents.sendInputEvent({type:'keyUp',keyCode:'END'});
+ await wait(700);
+ };
+ for(const [width,height,dark] of [[1000,760,false],[620,1000,true],[1000,420,false]]){
+ const label=`${width}x${height}-${dark?'dark':'light'}`;
+ await setPhase('setup');win.setSize(width,height);
+ await js(`window.ax5406Visual.theme(${dark});window.ax5406Visual.streamStart()`);
+ await wait(600);await endKey();
+ await setPhase(label+'-follow');
+ await chunks(0,120,30);await wait(250);
+ const followed=await snap(label+'-follow');
+ if(followed.distance>2)failures.push(label+': streaming lost tail follow');
+ // Continue generating while a real wheel input takes over.
+ await setPhase(label+'-takeover');
+ const streaming=chunks(120,160,30);
+ await wait(250);
+ for(let i=0;i<8;i++){
+ win.webContents.sendInputEvent({type:'mouseWheel',x:220,y:160,deltaY:240,deltaX:0});await wait(40);
+ }
+ await wait(400);
+ const before=await snap(label+'-reading-before');
+ await setPhase(label+'-reading');
+ await streaming;await wait(300);
+ const after=await snap(label+'-reading-after');
+ const anchor=after.rows.find(r=>r.key===before.anchor?.key);
+ if(before.distance<500)failures.push(label+': wheel takeover did not leave tail');
+ if(!anchor||Math.abs(anchor.top-before.anchor.top)>2)failures.push(label+': streaming moved reading anchor');
+ await endKey();
+ await setPhase(label+'-resume');await chunks(280,120,10);await wait(300);
+ const resumed=await snap(label+'-resume');
+ if(resumed.distance>2)failures.push(label+': resumed follow lost tail');
+ await setPhase(label+'-finish');
+ await js('window.ax5406Visual.streamFinish()');await wait(650);
+ const finished=await snap(label+'-finish');
+ const tokens=await js(`(()=>{const e=document.querySelector('[data-message-client-id="synthetic-${config.rows-1}"]');
+ return [...(e?.textContent||'').matchAll(/chunk(\\d{4})/g)].map(m=>Number(m[1]));})()`);
+ if(tokens.length!==400||tokens.some((v,i)=>v!==i))failures.push(label+': streamed chunks lost or reordered');
+ if(finished.distance>2)failures.push(label+': completion moved away from tail');
+ cases.push({label,before,after,followed,resumed,finished,tokenCount:tokens.length});
+ }
+ const audit=await js('window.streamAudit.running=false;({samples:window.streamAudit.samples,timeline:window.streamAudit.timeline,errors:window.ax5406Stats.errors})');
+ const phases={};
+ for(const s of audit.samples){const p=phases[s.phase]??={samples:0,blank:0,overlap:0,maxBottomDistance:0};
+ p.samples++;p.blank+=Number(s.blank>0);p.overlap+=Number(s.overlap>0);p.maxBottomDistance=Math.max(p.maxBottomDistance,s.distance);}
+ for(const [name,p]of Object.entries(phases)){
+ if(p.blank||p.overlap)failures.push(`${name}: ${p.blank} blank / ${p.overlap} overlaps`);
+ if(/-follow$|-resume$|-finish$/.test(name)&&p.maxBottomDistance>2){
+ const detail=`${name}: transient tail gap ${p.maxBottomDistance}px`;
+ geometryWarnings.push(detail);
+ // A task between DOM commit and ResizeObserver is not a painted frame.
+ // Without the native-paint probe keep the original conservative failure.
+ if(config.streamProbe!=='on')failures.push(detail);
+ }
+ }
+ if(audit.errors.length)failures.push('renderer errors');
+ let paintVerification;
+ if(config.streamProbe==='on'){
+ const following=paintAudit.filter(p=>/-follow$|-resume$|-finish$/.test(p.phase));
+ const missing=following.filter(p=>!p.markerPixels);
+ const negativeControl=paintAudit.filter(p=>p.phase.endsWith('-reading')&&!p.markerPixels);
+ const resize=audit.timeline.filter(e=>e.kind==='resize-after-owner');
+ paintVerification={followingFrames:following.length,missingMarkerFrames:missing.length,
+ negativeControlFrames:negativeControl.length,postResizeSamples:resize.length,
+ postResizeGaps:resize.filter(e=>e.distance>2).length};
+ if(!following.some(p=>p.markerPixels>0)||!negativeControl.length)failures.push('paint probe controls not verified');
+ for(const c of cases)for(const suffix of ['follow','resume','finish']){
+ if(!following.some(p=>p.phase===c.label+'-'+suffix))failures.push(c.label+'-'+suffix+': no native paint evidence');
+ }
+ if(missing.length)failures.push(`${missing.length} actually painted frames away from bottom`);
+ if(!resize.length||paintVerification.postResizeGaps)failures.push('post-compensation bottom position failed');
+ }
+ win.webContents.endFrameSubscription();
+ fs.writeFileSync(path.join(output,'stream-audit.json'),JSON.stringify({cases,phases,failures,geometryWarnings,paintVerification,paintedFrames,paintAudit,...audit},null,2));
+ return {failures,geometryWarnings,paintVerification,phases,cases:cases.map(c=>({label:c.label,tokenCount:c.tokenCount})),samples:audit.samples.length};
+};
diff --git a/apps/desktop/scripts/ax5406/symbolize-stack.mjs b/apps/desktop/scripts/ax5406/symbolize-stack.mjs
new file mode 100644
index 0000000000..fb92b992ba
--- /dev/null
+++ b/apps/desktop/scripts/ax5406/symbolize-stack.mjs
@@ -0,0 +1,47 @@
+/** Symbolize DbgEng-unwound PCs using the matching official Electron Breakpad symbols.
+ * Usage: node symbolize-stack.mjs dump.dmp stack.txt electron.exe.sym
+ * Export-symbol guesses from DbgEng are deliberately discarded.
+ */
+import fs from 'node:fs';
+import readline from 'node:readline';
+import { inspectDump } from './inspect-dump.mjs';
+const [dump, stackFile, symbolFile] = process.argv.slice(2);
+const metadata = inspectDump(dump);
+const bytes = fs.readFileSync(stackFile);
+const stack = bytes.toString(bytes[0] === 0xff && bytes[1] === 0xfe ? 'utf16le' : 'utf8');
+const base = BigInt(metadata.faultModule.base);
+const rows = [...stack.matchAll(/^([0-9a-f]+`[0-9a-f]+)\s+([0-9a-f]+`[0-9a-f]+)\s+:/gmi)];
+if (!rows.length) throw new Error('No DbgEng kv frames found');
+const pcs = [base + BigInt(metadata.faultModule.rva), ...rows.slice(0, -1).map(row => BigInt('0x' + row[2].replace('`', '')))];
+const frames = pcs.map((pc, i) => ({ frame: i, pc: `0x${pc.toString(16)}`,
+ module: pc >= base && pc < base + BigInt(metadata.faultModule.size) ? metadata.faultModule.name : 'other-module',
+ rva: Number(pc - base),
+ // Return addresses point past the calling instruction.
+ lookup: Number(pc - base) - (i ? 1 : 0), function: null, source: null }));
+const files = new Map();
+let first = true;
+for await (const line of readline.createInterface({ input: fs.createReadStream(symbolFile), crlfDelay: Infinity })) {
+ if (first) {
+ first = false;
+ if (!line.startsWith(`MODULE windows x86_64 ${metadata.faultModule.pdb.symbolKey} `)) throw new Error('Symbols do not match dump PDB identity');
+ }
+ if (line.startsWith('FILE ')) { const match = /^FILE (\d+) (.*)$/.exec(line); if (match) files.set(Number(match[1]), match[2]); }
+ else if (line.startsWith('FUNC ')) {
+ const match = /^FUNC (?:m )?([\da-f]+) ([\da-f]+) [\da-f]+ (.*)$/i.exec(line);
+ if (!match) continue;
+ const address = parseInt(match[1], 16), size = parseInt(match[2], 16);
+ for (const frame of frames) if (frame.lookup >= address && frame.lookup < address + size) {
+ frame.function = match[3]; frame.offset = frame.rva - address;
+ }
+ } else if (/^[\da-f]+ /i.test(line)) {
+ const match = /^([\da-f]+) ([\da-f]+) (\d+) (\d+)$/i.exec(line);
+ if (!match) continue;
+ const address = parseInt(match[1], 16), size = parseInt(match[2], 16);
+ for (const frame of frames) if (frame.lookup >= address && frame.lookup < address + size) {
+ frame.source = { file: files.get(Number(match[4])), line: Number(match[3]) };
+ }
+ }
+}
+console.log(JSON.stringify({ metadata, method: 'DbgEng x64 unwind + matching official Breakpad FUNC/line records; optimized inline frames not expanded',
+ frames: frames.map(({ lookup, ...frame }) => ({ ...frame,
+ rva: frame.module === 'other-module' ? null : `0x${frame.rva.toString(16)}` })) }, null, 2));
diff --git a/apps/desktop/scripts/ax5406/text-access-tests.cjs b/apps/desktop/scripts/ax5406/text-access-tests.cjs
new file mode 100644
index 0000000000..2b5d39912b
--- /dev/null
+++ b/apps/desktop/scripts/ax5406/text-access-tests.cjs
@@ -0,0 +1,69 @@
+// Actual navigation callback + real browser geometry, then the built MessageStream.
+// Usage: node text-access-tests.cjs <fresh component artifact root> <output directory>
+const fs = require('node:fs');
+const path = require('node:path');
+const assert = require('node:assert/strict');
+const ts = require('typescript');
+const { chromium } = require('playwright-core');
+const source = path.resolve(__dirname, '../../src/renderer');
+const read = file => fs.readFileSync(path.join(source, file), 'utf8');
+const stream = read('components/chat/MessageStream.tsx');
+const helper = read('lib/scrollRangeIntoView.ts');
+const access = read('lib/pageTextAccess.ts');
+const func = (text, name) => ts.createSourceFile('x.tsx', text, ts.ScriptTarget.Latest, true, ts.ScriptKind.TSX)
+ .statements.find(n => ts.isFunctionDeclaration(n) && n.name?.text === name).getText().replace(/^export /, '');
+const callback = stream.slice(stream.indexOf(' const navigateText ='), stream.indexOf(' root.addEventListener(PAGE_TEXT_NAVIGATION_EVENT'));
+const code = ts.transpileModule(func(helper, 'getRangeRect') + '\n' + func(helper, 'scrollRangeIntoView') + '\n' +
+ func(stream, 'resolveChipJumpTargetScrollTop') + '\n' + func(access, 'requestPageTextNavigation') + '\n' + callback,
+ { compilerOptions: { target: ts.ScriptTarget.ES2022 } }).outputText;
+
+(async () => {
+ const browser = await chromium.launch({ channel: 'chrome', headless: true, args: ['--allow-file-access-from-files'] });
+ const results = { navigation: [], accessibility: [] };
+ try {
+ const p = await browser.newPage({ viewport: { width: 1000, height: 760 } });
+ for (const nested of [false, true]) {
+ await p.setContent(`<div id="root" style="width:300px;height:400px;overflow:auto"><div style="height:900px"></div><div data-message-client-id="message"><div id="vertical" style="${nested ? 'height:100px;overflow-y:auto;' : ''}"><div style="height:${nested ? 700 : 0}px"></div><pre id="code" style="overflow-x:auto;white-space:pre"><span>${'long_line_'.repeat(25)}</span><span id="needle">NEEDLE</span></pre></div></div><div style="height:900px"></div></div>`);
+ const result = await p.evaluate(code => {
+ const root = document.querySelector('#root'), scroll = document.querySelector('#code'), vertical = document.querySelector('#vertical');
+ const range = document.createRange(); range.selectNodeContents(document.querySelector('#needle'));
+ const PAGE_TEXT_NAVIGATION_EVENT = 'cindy-page-text-navigation';
+ const api = new Function('root', 'PAGE_TEXT_NAVIGATION_EVENT', 'cancelFocusJump', 'unpinAutoFollowForUserUpIntent', 'beginChipJump', 'syncMessageViewport',
+ code + '\nreturn {navigateText,requestPageTextNavigation}')(root, PAGE_TEXT_NAVIGATION_EVENT, () => {}, () => {}, () => {}, () => {});
+ root.addEventListener(PAGE_TEXT_NAVIGATION_EVENT, api.navigateText);
+ const handled = api.requestPageTextNavigation(range);
+ const r = range.getBoundingClientRect(), x = scroll.getBoundingClientRect(), y = vertical.getBoundingClientRect(), outer = root.getBoundingClientRect();
+ return { handled, scrollLeft: scroll.scrollLeft, nestedTop: vertical.scrollTop, outerTop: root.scrollTop,
+ visible: r.left >= x.left && r.right <= x.right && r.top >= y.top && r.bottom <= y.bottom && r.top >= outer.top && r.bottom <= outer.bottom };
+ }, code);
+ results.navigation.push(result); assert.ok(result.handled && result.visible); assert.ok(result.scrollLeft > 0);
+ if (nested) assert.ok(result.nestedTop > 0);
+ }
+ const url = require('node:url').pathToFileURL(path.join(process.argv[2], 'component/component.html')).href;
+ for (const initial of ['off', 'on']) {
+ await p.goto(url + '?workload=visual&rows=200&accessibility=' + initial);
+ await p.waitForFunction(() => window.ax5406Visual);
+ await p.evaluate(() => window.ax5406Visual.streamFinish());
+ await p.waitForTimeout(500);
+ const cdp = await p.context().newCDPSession(p); await cdp.send('Accessibility.enable');
+ const snapshot = async () => {
+ const dom = await p.locator('.msg-stream-items').evaluate(e => ({
+ count: e.children.length, keys: [...e.children].map(e => e.dataset.messageClientId),
+ hidden: e.querySelectorAll('[data-message-placeholder]').length,
+ }));
+ const tree = await cdp.send('Accessibility.getFullAXTree');
+ return { ...dom, exposed: [...new Set(tree.nodes.flatMap(n => n.role?.value === 'StaticText' ? [...(n.name?.value || '').matchAll(/Synthetic row (\d+)/g)].map(m => Number(m[1])) : []))].sort((a, b) => a - b) };
+ };
+ const before = await snapshot();
+ if (initial === 'off') assert.ok(before.hidden > 0); else assert.equal(before.hidden, 0);
+ await p.evaluate(() => window.ax5406Accessibility(true)); await p.waitForTimeout(500);
+ const enabled = await snapshot(); assert.deepEqual(enabled.keys, before.keys); assert.equal(enabled.count, 80);
+ assert.equal(enabled.hidden, 0); assert.deepEqual(enabled.exposed, Array.from({ length: 80 }, (_, i) => i + 120));
+ await p.evaluate(() => window.ax5406Accessibility(false)); await p.waitForTimeout(500);
+ const disabled = await snapshot(); assert.deepEqual(disabled.keys, before.keys); assert.ok(disabled.hidden > 0);
+ results.accessibility.push({ initial, before, enabled, disabled }); await cdp.detach();
+ }
+ fs.writeFileSync(path.join(process.argv[3], 'text-access.json'), JSON.stringify(results, null, 2));
+ console.log('TEXT_ACCESS_PASS', JSON.stringify(results.navigation));
+ } finally { await browser.close(); }
+})().catch(error => { console.error(error); process.exitCode = 1; });
diff --git a/apps/desktop/scripts/ax5406/uia.ps1 b/apps/desktop/scripts/ax5406/uia.ps1
new file mode 100644
index 0000000000..4be4cf0441
--- /dev/null
+++ b/apps/desktop/scripts/ax5406/uia.ps1
@@ -0,0 +1,33 @@
+param([long]$WindowHandle, [int]$ExpectedProcessId, [int]$Seconds)
+$ErrorActionPreference = 'Stop'
+[Console]::OutputEncoding = [Text.UTF8Encoding]::new($false)
+Add-Type -AssemblyName UIAutomationClient
+Add-Type -AssemblyName UIAutomationTypes
+$root = [System.Windows.Automation.AutomationElement]::FromHandle([IntPtr]$WindowHandle)
+if ($root.Current.ProcessId -ne $ExpectedProcessId) { throw 'Unexpected fixture window owner' }
+$clock = [Diagnostics.Stopwatch]::StartNew()
+$queries = 0; $ranges = 0; $errors = 0; $iterations = 0; $lastError = ''
+while ($clock.Elapsed.TotalSeconds -lt $Seconds) {
+ try {
+ # Search only the fixture HWND, never the desktop or another application.
+ $nodes = $root.FindAll([System.Windows.Automation.TreeScope]::Descendants,
+ [System.Windows.Automation.PropertyCondition]::new(
+ [System.Windows.Automation.AutomationElement]::IsTextPatternAvailableProperty, $true))
+ for ($i = 0; $i -lt [Math]::Min(8, $nodes.Count); $i++) {
+ $pattern = $nodes[$i].GetCurrentPattern([System.Windows.Automation.TextPattern]::Pattern)
+ $range = $pattern.DocumentRange
+ $null = $range.GetText(1024)
+ $queries++
+ $range.ExpandToEnclosingUnit([System.Windows.Automation.Text.TextUnit]::Line)
+ $null = $range.GetBoundingRectangles()
+ $null = $range.Move([System.Windows.Automation.Text.TextUnit]::Line, 1)
+ $ranges++
+ }
+ } catch { $errors++; $lastError = $_.Exception.Message }
+ $iterations++
+ if ($iterations % 20 -eq 0) {
+ @{ queries=$queries; ranges=$ranges; errors=$errors; lastError=$lastError; elapsedMs=$clock.ElapsedMilliseconds } | ConvertTo-Json -Compress
+ }
+ Start-Sleep -Milliseconds 30
+}
+@{ queries=$queries; ranges=$ranges; errors=$errors; lastError=$lastError; elapsedMs=$clock.ElapsedMilliseconds } | ConvertTo-Json -Compress
diff --git a/apps/desktop/scripts/ax5406/visual-gallery.mjs b/apps/desktop/scripts/ax5406/visual-gallery.mjs
new file mode 100644
index 0000000000..75a58fc9e1
--- /dev/null
+++ b/apps/desktop/scripts/ax5406/visual-gallery.mjs
@@ -0,0 +1,29 @@
+// Package real Electron capturePage screenshots into a portable, offline report.
+import fs from 'node:fs/promises';
+import path from 'node:path';
+const root = path.resolve(process.argv[2]);
+const report = JSON.parse(await fs.readFile(path.join(root, 'report.json'), 'utf8'));
+const escape = value => String(value).replaceAll('&', '&amp;').replaceAll('<', '&lt;').replaceAll('"', '&quot;');
+const captions = {
+ '01-light-bottom': '浅色:首次进入,显示尾部消息',
+ '02-light-middle': '浅色:滚动到历史消息',
+ '04-async-image': '异步图片加载完成;黄色为原有搜索定位高亮',
+ '08-dark-narrow': '深色窄窗:长回复换行;棕色为原有定位高亮',
+ '13-expanded-return': '展开长消息,滚走后返回:展开状态保留',
+ '14-dark-bottom': '深色:回到底部,显示最新消息',
+ '15-follow-new-message': '深色:新消息到达,继续贴底',
+};
+const cards = [];
+for (const [name, caption] of Object.entries(captions)) {
+ const step = report.visual.steps.find(step => step.name === name);
+ const png = await fs.readFile(path.join(root, `${name}.png`));
+ cards.push(`<figure><figcaption>${escape(caption)}<small>正文挂载 ${step.mounted} 条;可见占位 ${step.visible.filter(row => row.placeholder).length} 条;行重叠 ${step.overlaps}</small></figcaption><img src="data:image/png;base64,${png.toString('base64')}" alt="${escape(caption)}"></figure>`);
+}
+const html = `<!doctype html><html lang="zh-CN"><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>#5406 视口挂载截图验收</title>
+<style>body{font:16px/1.65 system-ui,sans-serif;max-width:1000px;margin:auto;padding:20px;background:#f3f4f6;color:#17202a}h1{font-size:24px}p{max-width:760px}figure{margin:24px 0;background:white;border:1px solid #ddd;border-radius:12px;overflow:hidden}figcaption{padding:16px;font-weight:600}small{display:block;font-weight:400;color:#525b65}img{width:100%;height:auto;display:block}code{overflow-wrap:anywhere}li{margin:8px 0}</style>
+<h1>#5406 视口挂载截图验收</h1><p>这是 Windows Electron 中运行真实 MessageStream、UserMessage、AssistantMessage 和正式样式后直接截取的画面。消息内容为合成测试数据,未连接账号或后端;不代表完整安装版客户端验收。</p>
+<p>自动布局检查:${report.visual.failures.length ? escape(report.visual.failures.join(';')) : '全部通过'}。覆盖快速滚动、正文增高、图片加载、搜索定位、窄窗、浅深色、重挂载、阅读时新增消息、展开状态保留、回底跟随和键盘选择。</p>
+<p>正常浏览只挂载视口附近正文。工具卡、正在输出及已交互的消息保留;分享或键盘全选时恢复逻辑窗口内全部正文。下列截图原样嵌入,可放大查看;未进行图像编辑。</p>${cards.join('')}
+<p>截图来源:<code>${escape(root)}</code>。原始断言与逐行坐标保存在同目录 visual-steps.json。</p></html>`;
+await fs.writeFile(path.join(root, 'visual-report.html'), html);
+console.log(path.join(root, 'visual-report.html'));
diff --git a/apps/desktop/scripts/ax5406/visual.cjs b/apps/desktop/scripts/ax5406/visual.cjs
new file mode 100644
index 0000000000..28bd29b55d
--- /dev/null
+++ b/apps/desktop/scripts/ax5406/visual.cjs
@@ -0,0 +1,143 @@
+// Real Electron layout and screenshots; synthetic props, no user profile/backend.
+const fs = require('node:fs');
+const path = require('node:path');
+module.exports = async (win, output) => {
+ const steps = [], failures = [];
+ const js = code => win.webContents.executeJavaScript(code);
+ const settle = async () => { await new Promise(resolve => setTimeout(resolve, 450)); };
+ // Do not mutate the target while its smooth focus navigation still owns the
+ // scroll position. Match the bounded landing check in scroll-tests.cjs.
+ const focusMessage = async id => {
+ await js(`window.ax5406Visual.focus(${JSON.stringify(id)})`);
+ const samples = [];
+ let previous, stable = 0;
+ const started = Date.now();
+ do {
+ await new Promise(resolve => setTimeout(resolve, 50));
+ const state = await js(`(() => {
+ const root=document.querySelector('[data-scroll-container]');
+ const target=document.querySelector('[data-message-client-id="${id}"]');
+ const r=root.getBoundingClientRect(), b=target?.getBoundingClientRect();
+ return {top:root.scrollTop, visible:!!b && b.bottom>r.top && b.top<r.bottom};
+ })()`);
+ samples.push({ms:Date.now()-started,...state});
+ stable = state.visible && previous === state.top ? stable + 1 : 0;
+ previous = state.top;
+ if (stable >= 4 && Date.now()-started >= 1200) break;
+ } while (Date.now()-started < 3000);
+ if (!samples.at(-1)?.visible || stable < 4) failures.push(`focus ${id}: did not settle within 3s`);
+ steps.push({name:'focus-settlement',id,samples});
+ };
+ const stableAnchor = (name, before, after) => {
+ const anchor = before.visible[0];
+ const current = after.rows.find(row => row.key === anchor?.key);
+ if (!current || Math.abs(current.top - anchor.top) > 2) failures.push(`${name}: reading anchor moved`);
+ };
+ const snapshot = async name => {
+ await settle();
+ const state = await js(`(() => {
+ const root = document.querySelector('[data-scroll-container]'), bounds = root.getBoundingClientRect();
+ const rows = [...document.querySelector('.msg-stream-items').children].map(e => {
+ const r = e.getBoundingClientRect(); return { key:e.dataset.renderItemKey, id:e.dataset.messageClientId,
+ top:r.top-bounds.top, bottom:r.bottom-bounds.top, height:r.height,
+ placeholder:e.hasAttribute('data-message-placeholder'), visibility:getComputedStyle(e).contentVisibility };
+ });
+ const visible = rows.filter(e => e.bottom > 1 && e.top < root.clientHeight-1 && e.height > 0);
+ return { rows, visible, scrollTop:root.scrollTop, distance:root.scrollHeight-root.scrollTop-root.clientHeight,
+ mounted:rows.filter(e=>!e.placeholder).length, errors:window.ax5406Stats.errors,
+ overlaps:rows.slice(1).filter((e,i)=>e.top < rows[i].bottom-1).length };
+ })()`);
+ if (state.visible.some(e => e.placeholder)) failures.push(`${name}: visible placeholder`);
+ if (state.overlaps) failures.push(`${name}: overlapping rows`);
+ if (state.errors.length) failures.push(`${name}: renderer errors`);
+ if (!state.visible.length) failures.push(`${name}: empty viewport`);
+ fs.writeFileSync(path.join(output, `${name}.png`), (await win.webContents.capturePage()).toPNG());
+ steps.push({ name, ...state });
+ fs.writeFileSync(path.join(output, 'visual-steps.json'), JSON.stringify({ steps, failures }, null, 2));
+ return state;
+ };
+ await settle();
+ const first = await snapshot('01-light-bottom');
+ if (first.mounted >= 40) failures.push('initial: too many mounted bodies');
+ if (first.distance > 2) failures.push('initial: not pinned to bottom');
+ win.webContents.sendInputEvent({ type: 'mouseWheel', x: 400, y: 300, deltaY: 600, deltaX: 0 });
+ await settle();
+ await js(`(() => {const r=document.querySelector('[data-scroll-container]');r.scrollTop=r.scrollHeight*.45;})()`);
+ const middle = await snapshot('02-light-middle');
+ if (middle.distance < 1000) failures.push('middle: unexpectedly returned to bottom');
+ const sweep = await js(`(async () => {
+ const root=document.querySelector('[data-scroll-container]'); const results=[];
+ for(const fraction of [.2,.8,.35,.7,.4]) {
+ root.scrollTop=(root.scrollHeight-root.clientHeight)*fraction;
+ await new Promise(resolve=>requestAnimationFrame(()=>requestAnimationFrame(resolve)));
+ const bounds=root.getBoundingClientRect();
+ const placeholders=[...document.querySelectorAll('[data-message-placeholder]')].filter(e=>{
+ const r=e.getBoundingClientRect();return r.bottom>bounds.top+1&&r.top<bounds.bottom-1;
+ });results.push({fraction,blankRows:placeholders.length});
+ } return results;
+ })()`);
+ if(sweep.some(step=>step.blankRows)) failures.push('rapid-scroll: placeholders still visible after two frames');
+ steps.push({name:'rapid-scroll',sweep});
+ await js(`(() => {const r=document.querySelector('[data-scroll-container]');r.scrollTop=${middle.scrollTop};})()`);
+ const beforeGrowth = await snapshot('03a-before-growth');
+ await js(`window.ax5406Visual.grow(${JSON.stringify(beforeGrowth.visible[0]?.id)})`);
+ const growth = await snapshot('03b-async-growth');
+ stableAnchor('async-growth', beforeGrowth, growth);
+ const user = beforeGrowth.visible.find(e => Number(e.id?.split('-').at(-1)) % 2 === 0);
+ if (user) {
+ await focusMessage(user.id);
+ const beforeImage = await snapshot('04a-before-image');
+ await js(`window.ax5406Visual.image(${JSON.stringify(user.id)})`);
+ const image = await snapshot('04-async-image');
+ stableAnchor('async-image', beforeImage, image);
+ if (!await js(`!!document.querySelector('[data-message-client-id="${user.id}"] img')?.naturalWidth`)) failures.push('image: not decoded');
+ } else failures.push('image: no visible user row');
+ await js(`(() => {const r=document.querySelector('[data-scroll-container]');r.scrollTop=0;})()`);
+ await snapshot('05-top');
+ await focusMessage('synthetic-155');
+ const focus = await snapshot('06-search-jump');
+ if (!focus.visible.some(row => row.id === 'synthetic-155')) failures.push('focus: target not visible');
+ win.setSize(620, 760); await snapshot('07-narrow');
+ await js('window.ax5406Visual.theme(true)'); await snapshot('08-dark-narrow');
+ win.setSize(1000, 760); await snapshot('09-dark-wide');
+ await js('window.ax5406Visual.remount()'); const remount = await snapshot('10-remount');
+ await js('window.ax5406Visual.append()'); const appended = await snapshot('11-new-message-reading');
+ stableAnchor('append-while-reading', remount, appended);
+ await focusMessage('synthetic-198');
+ await settle();
+ await js(`window.ax5406Visual.grow('synthetic-198')`);
+ await settle();
+ const expanded = await js(`(() => {
+ const button=document.querySelector('[data-message-client-id="synthetic-198"] button[aria-expanded="false"]');
+ if(!button)return false;
+ button.dispatchEvent(new PointerEvent('pointerdown',{bubbles:true}));button.click();return true;
+ })()`);
+ if (!expanded) failures.push('expand: missing collapsed message control');
+ await snapshot('12-expanded-message');
+ await js(`(() => {const r=document.querySelector('[data-scroll-container]');r.scrollTop=0;})()`);
+ await settle();
+ if (!await js(`!!document.querySelector('[data-message-client-id="synthetic-198"] button[aria-expanded="true"]')`)) failures.push('expand: state lost offscreen');
+ await focusMessage('synthetic-199');
+ await settle();
+ await focusMessage('synthetic-198');
+ await snapshot('13-expanded-return');
+ await js(`window.ax5406Visual.focus(undefined)`);
+ const jumped = await js(`(() => {
+ const button=[...document.querySelectorAll('button')].find(e=>/new messages|Jump to bottom/.test(e.textContent));
+ if(!button)return false;button.click();return true;
+ })()`);
+ if(!jumped) failures.push('follow: missing jump-to-bottom control');
+ await new Promise(resolve => setTimeout(resolve, 3000));
+ const bottom = await snapshot('14-dark-bottom');
+ if(bottom.distance>2) failures.push('follow: did not reach bottom');
+ await js('window.ax5406Visual.append()');
+ const followed = await snapshot('15-follow-new-message');
+ if(followed.distance>2) failures.push('follow: new message not followed');
+ // Native selection must see all logically loaded bodies, even offscreen.
+ await js(`document.querySelector('[data-scroll-container]').dispatchEvent(new KeyboardEvent('keydown',{key:'a',ctrlKey:true,bubbles:true}))`);
+ const selected = await snapshot('16-keyboard-selection');
+ if (selected.rows.some(row => row.placeholder)) failures.push('selection: missing loaded bodies');
+ if(selected.distance>2) failures.push('selection: bottom anchor lost');
+ fs.writeFileSync(path.join(output, 'visual-steps.json'), JSON.stringify({ steps, failures }, null, 2));
+ return { steps, failures };
+};
diff --git a/apps/desktop/src/main/__tests__/accessibilitySupportIpc.test.ts b/apps/desktop/src/main/__tests__/accessibilitySupportIpc.test.ts
new file mode 100644
index 0000000000..1a27260633
--- /dev/null
+++ b/apps/desktop/src/main/__tests__/accessibilitySupportIpc.test.ts
@@ -0,0 +1,43 @@
+import { beforeEach, expect, it, vi } from 'vitest';
+import { ACCESSIBILITY_SUPPORT_CHANGED, ACCESSIBILITY_SUPPORT_GET } from '../../shared/accessibilitySupport';
+
+const mocks = vi.hoisted(() => ({
+ app: { on: vi.fn(), accessibilitySupportEnabled: false },
+ on: vi.fn(), windows: vi.fn(), trustedEvent: vi.fn(), trustedWindow: vi.fn(),
+}));
+vi.mock('electron', () => ({ app: mocks.app, ipcMain: { on: mocks.on }, BrowserWindow: { getAllWindows: mocks.windows } }));
+vi.mock('../security/trustedAppRenderer.js', () => ({
+ isTrustedAppRendererEvent: mocks.trustedEvent, isTrustedAppRendererWindow: mocks.trustedWindow,
+}));
+beforeEach(() => { vi.resetModules(); vi.clearAllMocks(); });
+
+it('registers once and returns local state only to a trusted app renderer', async () => {
+ const { registerAccessibilitySupportIpc } = await import('../accessibility-support-ipc');
+ registerAccessibilitySupportIpc(); registerAccessibilitySupportIpc();
+ expect(mocks.on).toHaveBeenCalledTimes(1);
+ expect(mocks.on.mock.calls[0][0]).toBe(ACCESSIBILITY_SUPPORT_GET);
+ const read = mocks.on.mock.calls[0][1];
+ const event = { returnValue: undefined };
+ mocks.trustedEvent.mockReturnValue(true);
+ for (const enabled of [true, false]) {
+ mocks.app.accessibilitySupportEnabled = enabled;
+ read(event); expect(event.returnValue).toBe(enabled);
+ }
+ mocks.trustedEvent.mockReturnValue(false);
+ read(event); expect(event.returnValue).toBeNull();
+});
+
+it('broadcasts live changes only to trusted living application windows', async () => {
+ const { registerAccessibilitySupportIpc } = await import('../accessibility-support-ipc');
+ registerAccessibilitySupportIpc();
+ const appWindow = { webContents: { send: vi.fn() } };
+ const otherWindow = { webContents: { send: vi.fn() } };
+ mocks.windows.mockReturnValue([appWindow, otherWindow]);
+ mocks.trustedWindow.mockImplementation(win => win === appWindow);
+ expect(mocks.app.on.mock.calls[0][0]).toBe('accessibility-support-changed');
+ for (const enabled of [true, false]) {
+ mocks.app.on.mock.calls[0][1]({}, enabled);
+ expect(appWindow.webContents.send).toHaveBeenLastCalledWith(ACCESSIBILITY_SUPPORT_CHANGED, enabled);
+ }
+ expect(otherWindow.webContents.send).not.toHaveBeenCalled();
+});
diff --git a/apps/desktop/src/main/__tests__/codexLocalSessions.test.ts b/apps/desktop/src/main/__tests__/codexLocalSessions.test.ts
index 05ead07c59..37884b72a2 100644
--- a/apps/desktop/src/main/__tests__/codexLocalSessions.test.ts
+++ b/apps/desktop/src/main/__tests__/codexLocalSessions.test.ts
@@ -5,9 +5,13 @@ import fs from 'node:fs';
import os from 'node:os';
import path from 'node:path';
-const electronMock = vi.hoisted(() => ({ userData: '' }));
+const electronMock = vi.hoisted(() => ({ userData: '', region: 'global' as 'global' | 'cn' }));
const dbMock = vi.hoisted(() => ({ current: null as Database.Database | null }));
+vi.mock('../../shared/brandRegion.js', () => ({
+ get CURRENT_CINDY_REGION() { return electronMock.region; },
+}));
+
vi.mock('electron', () => ({
app: {
getPath: vi.fn(() => electronMock.userData),
@@ -77,6 +81,9 @@ function createLocalDb(): Database.Database {
context_tokens INTEGER NOT NULL DEFAULT 0,
context_window INTEGER NOT NULL DEFAULT 0,
fast_mode INTEGER NOT NULL DEFAULT 0,
+ list_preview TEXT,
+ list_preview_role TEXT,
+ list_message_count INTEGER,
cleared_at INTEGER,
pinned_at INTEGER,
user_send_at INTEGER,
@@ -255,6 +262,7 @@ function rolloutLineWithImage(id: string, text: string, timestamp: string): stri
}
beforeEach(() => {
+ electronMock.region = 'global';
originalCodexHome = process.env.CODEX_HOME;
rootDir = fs.mkdtempSync(path.join(os.tmpdir(), 'codex-local-sessions-'));
externalHome = path.join(rootDir, 'external-codex-home');
@@ -1583,6 +1591,7 @@ describe('prepareExternalCodexSessionForResume orphan rollout synthesis', () =>
}
it('adopts a legacy branded Codex HOME and remains resumable after the old directory is removed', async () => {
+ electronMock.region = 'cn';
const legacyUserData = path.join(path.dirname(targetUserData), 'xdt-maker');
const legacyHome = path.join(legacyUserData, 'codex-home');
const sourceRollout = path.join(
@@ -1628,7 +1637,28 @@ describe('prepareExternalCodexSessionForResume orphan rollout synthesis', () =>
expect(fs.readFileSync(adopted.rolloutPath, 'utf-8')).toBe(sourceContents);
});
+ it('does not implicitly adopt China-edition legacy state in the Global edition', async () => {
+ const legacyHome = path.join(path.dirname(targetUserData), 'xdt-maker', 'codex-home');
+ const sourceRollout = path.join(legacyHome, 'sessions', 'legacy.jsonl');
+ fs.mkdirSync(path.dirname(sourceRollout), { recursive: true });
+ fs.writeFileSync(sourceRollout, 'LEGACY_ROLLOUT');
+ insertThread(createStateDb(legacyHome), threadId, sourceRollout, { updatedAt: 2_000 });
+ const targetDbPath = createStateDb(desktopHome());
+ process.env.CODEX_HOME = path.join(rootDir, 'missing-external-home');
+
+ await prepareExternalCodexSessionForResume(threadId);
+
+ const targetDb = new Database(targetDbPath, { readonly: true });
+ try {
+ expect(targetDb.prepare('SELECT id FROM threads WHERE id = ?').get(threadId)).toBeUndefined();
+ } finally {
+ targetDb.close();
+ }
+ expect(fs.readFileSync(sourceRollout, 'utf8')).toBe('LEGACY_ROLLOUT');
+ });
+
it('repairs a pre-existing external rollout pointer without overwriting current thread metadata', async () => {
+ electronMock.region = 'cn';
const legacyHome = path.join(path.dirname(targetUserData), 'xdt-maker', 'codex-home');
const sourceRollout = path.join(legacyHome, 'sessions', `rollout-2026-07-14-${threadId}.jsonl`);
const sourceDbPath = createStateDb(legacyHome);
@@ -2043,6 +2073,7 @@ describe('prepareExternalCodexSessionForResume orphan rollout synthesis', () =>
});
it('prioritizes the legacy rollout already referenced by target state over a newer linked external copy', async () => {
+ electronMock.region = 'cn';
const legacyHome = path.join(path.dirname(targetUserData), 'xdt-maker', 'codex-home');
const legacyRollout = path.join(legacyHome, 'sessions', `rollout-2026-07-14-${threadId}.jsonl`);
fs.mkdirSync(path.dirname(legacyRollout), { recursive: true });
@@ -2145,6 +2176,7 @@ describe('prepareExternalCodexSessionForResume orphan rollout synthesis', () =>
});
it('synthesizes into the current HOME when legacy state survives but its rollout is missing', async () => {
+ electronMock.region = 'cn';
const legacyHome = path.join(path.dirname(targetUserData), 'xdt-maker', 'codex-home');
const missingSourceRollout = path.join(
legacyHome,
diff --git a/apps/desktop/src/main/__tests__/makerSendToSessionOrdering.test.ts b/apps/desktop/src/main/__tests__/makerSendToSessionOrdering.test.ts
index 198c39f6e6..51c319255c 100644
--- a/apps/desktop/src/main/__tests__/makerSendToSessionOrdering.test.ts
+++ b/apps/desktop/src/main/__tests__/makerSendToSessionOrdering.test.ts
@@ -142,7 +142,9 @@ describe('sendToSession ordering', () => {
expect(serviceDepsBlock).toContain("source: 'lead'");
expect(serviceDepsBlock).toContain('meta: dispatchMeta,');
- expect(lifecycleDispatchBlock).toContain('return await deps.dispatchWorkerTask({');
+ expect(lifecycleDispatchBlock).toContain('const result = await deps.dispatchWorkerTask({');
+ expect(lifecycleDispatchBlock).toContain('}, assertAccepted);');
+ expect(lifecycleDispatchBlock).toContain('if (!result.queued && rejected) throw rejected.error;');
expect(lifecycleDispatchBlock).toContain('createHostSendFailure(');
expect(lifecycleDispatchBlock).toContain('Collab delegate send failed before vendor dispatch: $' + '{params.context}');
expect(lifecycleDispatchBlock).not.toContain('sendPersistedUserMessageToSession({');
@@ -214,7 +216,8 @@ describe('sendToSession ordering', () => {
expect(createWorkerReadyBlock).toContain(
"session.send({ type: 'user', content: ORCA_WORKER_READY_MESSAGE }, { planMode: false })",
);
- expect(workerReadyPlaceholderBlock).toContain('{ planMode: false, throwOnStartFailure: true },');
+ expect(workerReadyPlaceholderBlock).toMatch(/planMode: false,\s+throwOnStartFailure: true,/);
+ expect(workerReadyPlaceholderBlock).toContain('await assertCurrent?.();');
expect(sendToSessionBlock).toContain('planMode: false,');
expect(queuedCreateOptsBlock).toContain('inheritTargetPlanMode = false,');
expect(queuedCreateOptsBlock).toContain('planMode: inheritTargetPlanMode ? !!row.planModeEnabled : false,');
@@ -780,7 +783,7 @@ describe('sendToSession ordering', () => {
expect(serviceDepsBlock).toContain('resumeWorkerSession: async (target) => {');
expect(serviceDepsBlock).toContain('await resumeOrcaWorkerSessionIfMissing(target);');
expect(switchFocusIpcBlock).toContain('const didResume = await resumeOrcaWorkerSessionIfMissing(target);');
- expect(switchFocusMcpBlock).toContain('await resumeOrcaWorkerSessionIfMissing(target);');
+ expect(switchFocusMcpBlock).toContain('await resumeOrcaWorkerSessionIfMissing(target, assertCurrent);');
});
it('keeps IPC and MCP createWorker delegated to the shared lifecycle service', () => {
@@ -919,11 +922,11 @@ describe('sendToSession ordering', () => {
expect(serviceIdleBlock).toContain('await deps.markWorkerIdle(worker.id)');
expect(serviceIdleBlock).toContain('await deps.hasPendingWorkerInput(worker.sessionId)');
expect(serviceIdleBlock).toContain('deps.hasSendToSessionLock(worker.sessionId)');
- expect(serviceIdleBlock).toContain("await closeWorkerSessionBestEffort(worker.sessionId, 'idleWorker');");
+ expect(serviceIdleBlock).toContain("await closeWorkerSessionBestEffort(worker.sessionId, 'idleWorker', opts?.assertCurrent);");
expectOrder(serviceIdleBlock, 'await deps.markWorkerIdleIfStatus(worker.id, params.expectedStatus)', 'clearRuntimeState(worker.sessionId);');
- expectOrder(serviceIdleBlock, 'clearRuntimeState(worker.sessionId);', "await closeWorkerSessionBestEffort(worker.sessionId, 'idleWorker');");
+ expectOrder(serviceIdleBlock, 'clearRuntimeState(worker.sessionId);', "await closeWorkerSessionBestEffort(worker.sessionId, 'idleWorker', opts?.assertCurrent);");
- expect(serviceDepsBlock).toContain('if (sendToSessionLocks.has(sessionId)) return false;');
+ expect(serviceDepsBlock).toContain('if (!sendLockHeld && sendToSessionLocks.has(sessionId)) return false;');
expect(serviceDepsBlock).toContain('await inputCoordinator.ensureQueueRestored(sessionId).catch(() => undefined);');
expect(serviceDepsBlock).toContain('if (!inputCoordinator.isQueueRestored(sessionId)) return true;');
});
@@ -937,7 +940,7 @@ describe('sendToSession ordering', () => {
const serviceArchiveBlock = extractBetween(
orcaTeamServiceSource,
'async function archiveWorker(params: {',
- 'return {',
+ 'function queuedMessageSource(',
);
expect(disableBlock).toContain('orcaTeamService.clearAutoBridgeState(w.sessionId);');
@@ -945,12 +948,12 @@ describe('sendToSession ordering', () => {
expectOrder(disableBlock, 'orcaTeamService.clearAutoBridgeState(w.sessionId);', 'await sess.abort();');
expect(source).toContain('archiveWorker: (params) => orcaTeamService.archiveWorker(params),');
expect(serviceArchiveBlock).toContain('clearRuntimeState(worker.sessionId);');
- expect(serviceArchiveBlock).toContain("await closeWorkerSessionBestEffort(worker.sessionId, 'archiveWorker');");
- expect(serviceArchiveBlock).toContain('await deps.archiveWorkerSession(worker.sessionId);');
+ expect(serviceArchiveBlock).toContain("await closeWorkerSessionBestEffort(worker.sessionId, 'archiveWorker', params.beforeArchive);");
+ expect(serviceArchiveBlock).toContain('await deps.archiveWorkerSession(worker.sessionId, params.beforeArchive);');
expect(serviceArchiveBlock).toContain("await deps.updateWorkerStatus(worker.id, 'done');");
- expectOrder(serviceArchiveBlock, 'clearRuntimeState(worker.sessionId);', "await closeWorkerSessionBestEffort(worker.sessionId, 'archiveWorker');");
- expectOrder(serviceArchiveBlock, "await closeWorkerSessionBestEffort(worker.sessionId, 'archiveWorker');", 'await deps.archiveWorkerSession(worker.sessionId);');
- expectOrder(serviceArchiveBlock, 'await deps.archiveWorkerSession(worker.sessionId);', "await deps.updateWorkerStatus(worker.id, 'done');");
+ expectOrder(serviceArchiveBlock, 'clearRuntimeState(worker.sessionId);', "await closeWorkerSessionBestEffort(worker.sessionId, 'archiveWorker', params.beforeArchive);");
+ expectOrder(serviceArchiveBlock, "await closeWorkerSessionBestEffort(worker.sessionId, 'archiveWorker', params.beforeArchive);", 'await deps.archiveWorkerSession(worker.sessionId, params.beforeArchive);');
+ expectOrder(serviceArchiveBlock, 'await deps.archiveWorkerSession(worker.sessionId, params.beforeArchive);', "await deps.updateWorkerStatus(worker.id, 'done');");
});
it('keeps worker idle/archive adapters passing the caller lead session id', () => {
@@ -980,7 +983,7 @@ describe('sendToSession ordering', () => {
' });\n orcaTeamServiceForEvents = orcaTeamService;',
);
- expect(serviceSendBlock).toContain("return dispatchToWorker({ ...params, mode: 'normal' })");
+ expect(serviceSendBlock).toContain("return dispatchToWorker({ ...params, mode: 'normal' }, assertCurrent)");
expect(serviceDispatchBoundaryBlock).toContain(
'const execution = await dispatchResolvedWorker({',
);
diff --git a/apps/desktop/src/main/accessibility-support-ipc.ts b/apps/desktop/src/main/accessibility-support-ipc.ts
new file mode 100644
index 0000000000..57532b581c
--- /dev/null
+++ b/apps/desktop/src/main/accessibility-support-ipc.ts
@@ -0,0 +1,19 @@
+import { app, BrowserWindow, ipcMain } from 'electron';
+import { ACCESSIBILITY_SUPPORT_CHANGED, ACCESSIBILITY_SUPPORT_GET } from '../shared/accessibilitySupport.js';
+import { isTrustedAppRendererEvent, isTrustedAppRendererWindow } from './security/trustedAppRenderer.js';
+
+let registered = false;
+
+/** Register before creating chat windows so preload can expose the initial state. */
+export function registerAccessibilitySupportIpc(): void {
+ if (registered) return;
+ registered = true;
+ ipcMain.on(ACCESSIBILITY_SUPPORT_GET, event => {
+ event.returnValue = isTrustedAppRendererEvent(event) ? app.accessibilitySupportEnabled : null;
+ });
+ app.on('accessibility-support-changed', (_event, enabled) => {
+ for (const win of BrowserWindow.getAllWindows()) {
+ if (isTrustedAppRendererWindow(win)) win.webContents.send(ACCESSIBILITY_SUPPORT_CHANGED, enabled);
+ }
+ });
+}
diff --git a/apps/desktop/src/main/bootstrap-electron.ts b/apps/desktop/src/main/bootstrap-electron.ts
index d74db2f6f9..d26abb7cac 100644
--- a/apps/desktop/src/main/bootstrap-electron.ts
+++ b/apps/desktop/src/main/bootstrap-electron.ts
@@ -1,3 +1,4 @@
+import { registerAccessibilitySupportIpc } from './accessibility-support-ipc.js';
import { prepareImportedAutomation, finishImportedAutomation } from './bot-import/automationRuntime.js';
import { ensureImportedAutomationReady, recoverCompanionImports } from './bot-import/host.js';
import { listWorktreeRecycleStatus, controlWorktreeRecycle } from './worktree/recycleControls';
@@ -2572,6 +2573,7 @@ registerBrowserBackendIpc();
// ipcMain.handle 在 app ready 前注册也有效。
registerAppShortcutIpc();
registerAppearanceSettingsIpc();
+registerAccessibilitySupportIpc();
registerLoginItemIpc();
// ── 资源用量面板 IPC ─────────────────────────────────────────────────
diff --git a/apps/desktop/src/main/cindy-brain/__tests__/mobilePageAssets.test.ts b/apps/desktop/src/main/cindy-brain/__tests__/mobilePageAssets.test.ts
index 404d91feaf..4dee90d6a8 100644
--- a/apps/desktop/src/main/cindy-brain/__tests__/mobilePageAssets.test.ts
+++ b/apps/desktop/src/main/cindy-brain/__tests__/mobilePageAssets.test.ts
@@ -1,4 +1,4 @@
-import { afterEach, describe, expect, it } from 'vitest';
+import { afterEach, describe, expect, it, vi } from 'vitest';
import fs from 'node:fs/promises';
import os from 'node:os';
import path from 'node:path';
@@ -7,6 +7,7 @@ import { listMobilePageFiles, readMobilePageChunk } from '../mobilePageAssets.js
const roots: string[] = [];
afterEach(async () => {
+ vi.restoreAllMocks();
await Promise.all(roots.splice(0).map((root) => fs.rm(root, { recursive: true, force: true })));
});
async function fixture() {
@@ -28,9 +29,46 @@ describe('mobile page package snapshot', () => {
const ghost = await fixture();
const [file] = await listMobilePageFiles(ghost, 'panel.html');
const outside = path.join(ghost.dir, 'outside.html');
+ const entry = path.join(ghost.dir, 'panel.html');
+ const stat = await fs.lstat(entry, { bigint: true });
await fs.writeFile(outside, '<html>other</html>');
- await fs.unlink(path.join(ghost.dir, 'panel.html'));
- await fs.symlink(outside, path.join(ghost.dir, 'panel.html'));
- await expect(readMobilePageChunk(ghost, file, 0)).rejects.toThrow();
+ await fs.unlink(entry);
+ try {
+ await fs.symlink(outside, entry);
+ } catch (error) {
+ if (process.platform !== 'win32' ||
+ !['EPERM', 'EACCES', 'ENOTSUP'].includes((error as NodeJS.ErrnoException).code ?? '')) throw error;
+ // File symlinks require a privilege on Windows. Keep the file-link guard
+ // exercised there, alongside the real directory-junction case below.
+ const lstat = fs.lstat;
+ stat.isSymbolicLink = () => true;
+ vi.spyOn(fs, 'lstat').mockImplementation((...args) => args[0] === entry
+ ? Promise.resolve(stat) as ReturnType<typeof fs.lstat>
+ : lstat(...args));
+ }
+ const open = vi.spyOn(fs, 'open');
+ await expect(readMobilePageChunk(ghost, file, 0)).rejects.toThrow(
+ 'plugin mobile page path segment is a link: panel.html',
+ );
+ expect(open).not.toHaveBeenCalled();
+ });
+
+ it('does not follow a parent directory replaced by an external link', async () => {
+ const ghost = await fixture();
+ const parent = path.join(ghost.dir, 'assets');
+ await fs.mkdir(parent);
+ await fs.writeFile(path.join(parent, 'page.html'), '<html>first</html>');
+ const files = await listMobilePageFiles(ghost, 'assets/page.html');
+ const file = files.find((candidate) => candidate.path === 'assets/page.html')!;
+ const outside = await fs.mkdtemp(path.join(os.tmpdir(), 'cindy-mobile-plugin-outside-'));
+ roots.push(outside);
+ await fs.writeFile(path.join(outside, 'page.html'), '<html>other</html>');
+ await fs.rename(parent, path.join(ghost.dir, 'original-assets'));
+ await fs.symlink(outside, parent, process.platform === 'win32' ? 'junction' : 'dir');
+ const open = vi.spyOn(fs, 'open');
+ await expect(readMobilePageChunk(ghost, file, 0)).rejects.toThrow(
+ 'plugin mobile page path segment is a link: assets/page.html',
+ );
+ expect(open).not.toHaveBeenCalled();
});
});
diff --git a/apps/desktop/src/main/cindy-brain/__tests__/skillSlot.test.ts b/apps/desktop/src/main/cindy-brain/__tests__/skillSlot.test.ts
index 41190728d5..2cfbfe6f59 100644
--- a/apps/desktop/src/main/cindy-brain/__tests__/skillSlot.test.ts
+++ b/apps/desktop/src/main/cindy-brain/__tests__/skillSlot.test.ts
@@ -162,8 +162,8 @@ describe('skillSlot · reconcileGhostSkillLinks', () => {
await fs.promises.mkdir(claudeDir(), { recursive: true });
const legacy = path.join(legacySharedDir(), 'my-ghost--foo');
const fanout = path.join(claudeDir(), 'my-ghost--foo');
- await fs.promises.symlink(target, legacy, 'dir');
- await fs.promises.symlink(legacy, fanout, 'dir');
+ await fs.promises.symlink(target, legacy, process.platform === 'win32' ? 'junction' : 'dir');
+ await fs.promises.symlink(legacy, fanout, process.platform === 'win32' ? 'junction' : 'dir');
const user = path.join(legacySharedDir(), 'user-skill');
await fs.promises.mkdir(user);
await fs.promises.writeFile(path.join(user, 'SKILL.md'), '# User skill');
@@ -179,9 +179,9 @@ describe('skillSlot · reconcileGhostSkillLinks', () => {
await fs.promises.mkdir(legacySharedDir(), { recursive: true });
await fs.promises.mkdir(claudeDir(), { recursive: true });
const legacy = path.join(legacySharedDir(), 'my-ghost--foo');
- await fs.promises.symlink(path.join(brainRoot, 'my-ghost', 'missing'), legacy, 'dir');
- await fs.promises.symlink(legacy, path.join(claudeDir(), 'my-ghost--foo'), 'dir');
- await fs.promises.symlink(path.join(workDir, 'user-missing'), path.join(claudeDir(), 'user-skill'), 'dir');
+ await fs.promises.symlink(path.join(brainRoot, 'my-ghost', 'missing'), legacy, process.platform === 'win32' ? 'junction' : 'dir');
+ await fs.promises.symlink(legacy, path.join(claudeDir(), 'my-ghost--foo'), process.platform === 'win32' ? 'junction' : 'dir');
+ await fs.promises.symlink(path.join(workDir, 'user-missing'), path.join(claudeDir(), 'user-skill'), process.platform === 'win32' ? 'junction' : 'dir');
await removeGhostSkillLinksForRoots([brainRoot, approvalStateRoot], homeDir);
expect(fs.readdirSync(legacySharedDir())).toEqual([]);
expect(fs.readdirSync(claudeDir())).toEqual(['user-skill']);
diff --git a/apps/desktop/src/main/localDb/__tests__/conversationSearch.test.ts b/apps/desktop/src/main/localDb/__tests__/conversationSearch.test.ts
index 8fcbf70939..0580f4eda2 100644
--- a/apps/desktop/src/main/localDb/__tests__/conversationSearch.test.ts
+++ b/apps/desktop/src/main/localDb/__tests__/conversationSearch.test.ts
@@ -22,7 +22,7 @@ import { searchConversations } from '../conversationSearch.js';
const conversationSearchSource = readFileSync(
resolve(__dirname, '..', 'conversationSearch.ts'),
'utf8',
-);
+).replace(/\r\n?/g, '\n');
describe('conversationSearch source invariants', () => {
it('includes visible AskUser cards in content search roles', () => {
@@ -95,6 +95,7 @@ function createSearchDb(): Database.Database {
total_cost_is_approximate INTEGER NOT NULL DEFAULT 0,
context_tokens INTEGER NOT NULL DEFAULT 0,
context_window INTEGER NOT NULL DEFAULT 0,
+ context_window_runtime INTEGER,
fast_mode INTEGER NOT NULL DEFAULT 0,
plan_mode_enabled INTEGER NOT NULL DEFAULT 0,
cleared_at INTEGER,
diff --git a/apps/desktop/src/main/localDb/__tests__/dbSlimmingUpgradeOrder.test.ts b/apps/desktop/src/main/localDb/__tests__/dbSlimmingUpgradeOrder.test.ts
index 81f5c91137..e8767d3f39 100644
--- a/apps/desktop/src/main/localDb/__tests__/dbSlimmingUpgradeOrder.test.ts
+++ b/apps/desktop/src/main/localDb/__tests__/dbSlimmingUpgradeOrder.test.ts
@@ -26,7 +26,7 @@ describe('database cleanup and upgrade startup order', () => {
open,
);
const migration = source.indexOf(
- 'await runMigrations(db, filePath)',
+ 'runMigrations: () => runMigrations(db, filePath)',
schemaStartup,
);
diff --git a/apps/desktop/src/main/localDb/__tests__/drizzle-split.spike.test.ts b/apps/desktop/src/main/localDb/__tests__/drizzle-split.spike.test.ts
index 7c96583a78..11b61500ec 100644
--- a/apps/desktop/src/main/localDb/__tests__/drizzle-split.spike.test.ts
+++ b/apps/desktop/src/main/localDb/__tests__/drizzle-split.spike.test.ts
@@ -123,6 +123,20 @@ async function runMigrationStatement(target: DbClient, statement: string): Promi
}
function applyMigrationScriptSync(db: Sqlite, fileName: string): void {
+ if (fileName === '0097_fresh_stryfe.sql') {
+ ensureColumnSync(db, 'sessions', 'list_preview', 'text');
+ ensureColumnSync(db, 'sessions', 'list_preview_role', 'text');
+ ensureColumnSync(db, 'sessions', 'list_message_count', 'integer');
+ return;
+ }
+ if (fileName === '0099_boring_champions.sql') {
+ ensureColumnSync(db, 'sessions', 'writable_dirs', "text DEFAULT '[]' NOT NULL");
+ return;
+ }
+ if (fileName === '0091_amazing_blur.sql') {
+ ensureColumnSync(db, 'sessions', 'codex_plan_json', 'text');
+ return;
+ }
if (fileName === '0038_add_session_remote_host_id.sql') {
ensureColumnSync(db, 'sessions', 'remote_host_id', 'text');
return;
@@ -205,6 +219,20 @@ function applyMigrationScriptSync(db: Sqlite, fileName: string): void {
}
async function applyMigrationScript(target: DbClient, fileName: string): Promise<void> {
+ if (fileName === '0097_fresh_stryfe.sql') {
+ await ensureColumn(target, 'sessions', 'list_preview', 'text');
+ await ensureColumn(target, 'sessions', 'list_preview_role', 'text');
+ await ensureColumn(target, 'sessions', 'list_message_count', 'integer');
+ return;
+ }
+ if (fileName === '0099_boring_champions.sql') {
+ await ensureColumn(target, 'sessions', 'writable_dirs', "text DEFAULT '[]' NOT NULL");
+ return;
+ }
+ if (fileName === '0091_amazing_blur.sql') {
+ await ensureColumn(target, 'sessions', 'codex_plan_json', 'text');
+ return;
+ }
if (fileName === '0038_add_session_remote_host_id.sql') {
await ensureColumn(target, 'sessions', 'remote_host_id', 'text');
return;
diff --git a/apps/desktop/src/main/localDb/ipc/__tests__/messagesClearRace.test.ts b/apps/desktop/src/main/localDb/ipc/__tests__/messagesClearRace.test.ts
index 61be0a28c3..1602919f41 100644
--- a/apps/desktop/src/main/localDb/ipc/__tests__/messagesClearRace.test.ts
+++ b/apps/desktop/src/main/localDb/ipc/__tests__/messagesClearRace.test.ts
@@ -1,8 +1,9 @@
import Database from 'better-sqlite3';
import { drizzle } from 'drizzle-orm/better-sqlite3';
-import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
import { messages, sessions } from '../../schema';
+import { tx as runInprocTx } from '../../worker/opHandlers/tx';
const h = vi.hoisted(() => ({
db: null as ReturnType<typeof drizzle> | null,
@@ -62,6 +63,9 @@ function createDb(): Database.Database {
sqlite.exec(`
CREATE TABLE sessions (
id TEXT PRIMARY KEY,
+ list_preview TEXT,
+ list_preview_role TEXT,
+ list_message_count INTEGER,
cleared_at INTEGER,
status TEXT NOT NULL DEFAULT 'active'
);
@@ -85,18 +89,21 @@ function createDb(): Database.Database {
h.db = db;
h.client = {
drizzle: db,
- exec: vi.fn(async (sql: string, params: unknown[] = []) => {
- // Model /clear winning between the preflight SELECT and the guarded
- // INSERT. The single SQL statement must then insert zero rows.
- if (h.raceOnInsert && sql.startsWith('INSERT INTO messages')) {
+ tx: vi.fn(async (name: string, args: unknown) => {
+ if (h.raceOnInsert && name === 'message.insert') {
sqlite.prepare('UPDATE sessions SET cleared_at = ? WHERE id = ?').run(200, 's1');
}
+ return runInprocTx(sqlite, { name, args });
+ }),
+ exec: vi.fn(async (sql: string, params: unknown[] = []) => {
return sqlite.prepare(sql).run(...params);
}),
};
return sqlite;
}
+afterEach(() => { h.sqlite?.close(); });
+
describe('message persistence clear boundary', () => {
let sqlite: Database.Database;
diff --git a/apps/desktop/src/main/localDb/ipc/__tests__/messagesWriteReadback.test.ts b/apps/desktop/src/main/localDb/ipc/__tests__/messagesWriteReadback.test.ts
index b419b1ade8..0dfc440817 100644
--- a/apps/desktop/src/main/localDb/ipc/__tests__/messagesWriteReadback.test.ts
+++ b/apps/desktop/src/main/localDb/ipc/__tests__/messagesWriteReadback.test.ts
@@ -10,9 +10,10 @@
*/
import Database from 'better-sqlite3';
import { drizzle } from 'drizzle-orm/better-sqlite3';
-import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
import { messages, sessions } from '../../schema';
+import { tx as runInprocTx } from '../../worker/opHandlers/tx';
const h = vi.hoisted(() => ({
db: null as ReturnType<typeof drizzle> | null,
@@ -71,10 +72,13 @@ vi.mock('../../client/current', () => ({
import { createMessage, updateMessageContent } from '../messages';
function setupDb(): void {
- const sqlite = new Database(':memory:');
+ const sqlite = new Database(':memory:', { verbose: (sql) => h.queries.push(String(sql)) });
sqlite.exec(`
CREATE TABLE sessions (
id TEXT PRIMARY KEY,
+ list_preview TEXT,
+ list_preview_role TEXT,
+ list_message_count INTEGER,
cleared_at INTEGER,
status TEXT NOT NULL DEFAULT 'active'
);
@@ -95,21 +99,21 @@ function setupDb(): void {
sqlite.prepare("INSERT INTO sessions (id, cleared_at, status) VALUES ('s1', NULL, 'active')").run();
const db = drizzle(sqlite, {
schema: { messages, sessions },
- logger: {
- logQuery: (query: string) => {
- h.queries.push(query);
- },
- },
});
h.sqlite = sqlite;
h.db = db;
h.client = {
drizzle: db,
+ tx: vi.fn(async (name: string, args: unknown) => {
+ return runInprocTx(sqlite, { name, args });
+ }),
exec: vi.fn(async (sql: string, params: unknown[] = []) => h.sqlite!.prepare(sql).run(...params)),
query: vi.fn(async (sql: string, params: unknown[] = []) => h.sqlite!.prepare(sql).all(...params)),
};
}
+afterEach(() => { h.sqlite?.close(); });
+
describe('message write paths avoid large-content readback', () => {
beforeEach(() => {
h.queries.length = 0;
@@ -127,10 +131,10 @@ describe('message write paths avoid large-content readback', () => {
createdAt: 1000,
});
- const insertIdx = h.queries.findIndex((q) => q.startsWith('insert into "messages"'));
+ const insertIdx = h.queries.findIndex((q) => /^insert into ["`]?messages["`]?\s/i.test(q));
expect(insertIdx).toBeGreaterThanOrEqual(0);
expect(
- h.queries.slice(insertIdx + 1).filter((q) => q.includes('from "messages"')),
+ h.queries.slice(insertIdx + 1).filter((q) => /\bfrom ["`]?messages["`]?\b/i.test(q)),
).toEqual([]);
expect(msg.clientId).toBe('c1');
@@ -188,11 +192,11 @@ describe('message write paths avoid large-content readback', () => {
expect(updated?.role).toBe('tool_result');
const postUpdateSelects = h.queries.filter(
- (q) => q.startsWith('select') && q.includes('from "messages"'),
+ (q) => /^select\b/i.test(q) && /\bfrom ["`]?messages["`]?\b/i.test(q),
);
expect(postUpdateSelects.length).toBeGreaterThan(0);
for (const q of postUpdateSelects) {
- expect(q).not.toMatch(/select[^]*"content"[^]*from "messages"/);
+ expect(q).not.toMatch(/select[^]*\bcontent\b[^]*from ["`]?messages/i);
}
const stored = h.sqlite!
diff --git a/apps/desktop/src/main/localDb/ipc/__tests__/sessionImportDirFacts.test.ts b/apps/desktop/src/main/localDb/ipc/__tests__/sessionImportDirFacts.test.ts
index eb86beb018..4b918a5832 100644
--- a/apps/desktop/src/main/localDb/ipc/__tests__/sessionImportDirFacts.test.ts
+++ b/apps/desktop/src/main/localDb/ipc/__tests__/sessionImportDirFacts.test.ts
@@ -1,15 +1,16 @@
+import path from 'node:path';
import { describe, expect, it, vi } from 'vitest';
import { createGitRepoProbe } from '../sessionImportDirFacts.js';
describe('createGitRepoProbe', () => {
it('stats each unique directory once and reports only git repositories', async () => {
- const statExists = vi.fn(async (target: string) => target.startsWith('/w/repo'));
+ const statExists = vi.fn(async (target: string) => target === path.join('/w/repo', '.git'));
const probe = createGitRepoProbe(statExists);
expect(await probe(['/w/repo', '/w/plain', '/w/repo', ''])).toEqual(['/w/repo']);
expect(await probe(['/w/plain', '/w/repo'])).toEqual(['/w/repo']);
expect(statExists).toHaveBeenCalledTimes(2);
- expect(statExists.mock.calls.map(([target]) => target.replace(/\\/g, '/'))).toEqual(['/w/repo/.git', '/w/plain/.git']);
+ expect(statExists.mock.calls.map(([target]) => target)).toEqual([path.join('/w/repo', '.git'), path.join('/w/plain', '.git')]);
});
it('checks a directory again after five minutes, so a newly created or removed repo is noticed', async () => {
diff --git a/apps/desktop/src/main/localDb/ipc/__tests__/subagentRunsBroadcast.test.ts b/apps/desktop/src/main/localDb/ipc/__tests__/subagentRunsBroadcast.test.ts
index 5c4f310889..954fceb0f4 100644
--- a/apps/desktop/src/main/localDb/ipc/__tests__/subagentRunsBroadcast.test.ts
+++ b/apps/desktop/src/main/localDb/ipc/__tests__/subagentRunsBroadcast.test.ts
@@ -1,3 +1,4 @@
+import path from 'node:path';
import { beforeEach, describe, expect, it, vi } from 'vitest';
const h = vi.hoisted(() => {
@@ -46,7 +47,7 @@ vi.mock('@cindy/maker-core/pi-subagent-runs', () => ({
isPiSubagentTerminal: (state: string) => ['completed', 'failed', 'stopped'].includes(state),
listPiSubagentRunDiagnostics: h.listPiSubagentRunDiagnostics,
listPiSubagentRuns: h.listPiSubagentRuns,
- piSubagentRunRoot: (agentHome: string, sessionId: string) => `${agentHome}/runtime/pi-subagent-runs/${sessionId}`,
+ piSubagentRunRoot: (agentHome: string, sessionId: string) => path.join(agentHome, 'runtime', 'pi-subagent-runs', sessionId),
readPiSubagentTranscriptPage: h.readPiSubagentTranscriptPage,
}));
vi.mock('../../../appSessionState.js', () => ({
@@ -918,7 +919,7 @@ describe('Subagent runs broadcast boundary', () => {
limit: 25,
})).resolves.toEqual({ supported: true, entries: [] });
expect(h.readPiSubagentTranscriptPage).toHaveBeenCalledWith(
- '/user-data/pi-agent-home/runtime/pi-subagent-runs/session-1',
+ path.join('/user-data', 'pi-agent-home', 'runtime', 'pi-subagent-runs', 'session-1'),
[
'123e4567-e89b-42d3-a456-426614174000',
'123e4567-e89b-42d3-a456-426614174001',
diff --git a/apps/desktop/src/main/maker-ipc/__tests__/botWorkbenchHandover.test.ts b/apps/desktop/src/main/maker-ipc/__tests__/botWorkbenchHandover.test.ts
index 09598ad615..2166558cf7 100644
--- a/apps/desktop/src/main/maker-ipc/__tests__/botWorkbenchHandover.test.ts
+++ b/apps/desktop/src/main/maker-ipc/__tests__/botWorkbenchHandover.test.ts
@@ -27,7 +27,7 @@ describe('checkHandoverDirectory', () => {
expect(await checkHandoverDirectory(`${repo}/`, env)).toEqual({ ok: true, path: repo });
expect(await checkHandoverDirectory('~/code/repo', env)).toEqual({ ok: true, path: repo });
const link = path.join(root, 'repo-link');
- await symlink(repo, link);
+ await symlink(repo, link, process.platform === 'win32' ? 'junction' : 'dir');
expect(await checkHandoverDirectory(link, env)).toEqual({ ok: true, path: link });
});
@@ -39,8 +39,8 @@ describe('checkHandoverDirectory', () => {
});
it('rejects the filesystem root, the home directory and Cindy data, also through a symlink', async () => {
- await symlink(env.homeDir, path.join(root, 'home-link'));
- await symlink(path.join(env.userDataDir, 'owners'), path.join(root, 'data-link'));
+ await symlink(env.homeDir, path.join(root, 'home-link'), process.platform === 'win32' ? 'junction' : 'dir');
+ await symlink(path.join(env.userDataDir, 'owners'), path.join(root, 'data-link'), process.platform === 'win32' ? 'junction' : 'dir');
for (const target of [path.parse(root).root, env.homeDir, '~', path.join(root, 'home-link'),
path.join(env.userDataDir, 'owners'), path.join(root, 'data-link')]) {
expect(await checkHandoverDirectory(target, env)).toMatchObject({ ok: false, errorCode: 'INVALID_PROJECT_PATH' });
@@ -52,7 +52,7 @@ describe('findHandedProject', () => {
it('finds the handed project through ~/, a trailing slash, case and symlinks, and nothing else', async () => {
const repo = path.join(env.homeDir, 'code', 'repo');
const link = path.join(root, 'repo-link');
- await symlink(repo, link);
+ await symlink(repo, link, process.platform === 'win32' ? 'junction' : 'dir');
const dirs = [repo];
const opts = { homeDir: env.homeDir, caseInsensitive: true };
expect(await findHandedProject('~/code/repo/', dirs, opts)).toBe(repo);
diff --git a/apps/desktop/src/preload/__tests__/accessibilitySupport.test.ts b/apps/desktop/src/preload/__tests__/accessibilitySupport.test.ts
new file mode 100644
index 0000000000..5f952d09ed
--- /dev/null
+++ b/apps/desktop/src/preload/__tests__/accessibilitySupport.test.ts
@@ -0,0 +1,30 @@
+import { beforeEach, expect, it, vi } from 'vitest';
+import { ACCESSIBILITY_SUPPORT_CHANGED, ACCESSIBILITY_SUPPORT_GET } from '../../shared/accessibilitySupport';
+const mocks = vi.hoisted(() => ({ on: vi.fn(), sendSync: vi.fn() }));
+vi.mock('electron', () => ({ ipcRenderer: mocks }));
+import { createAccessibilitySupportBridge } from '../accessibilitySupport';
+beforeEach(() => vi.clearAllMocks());
+
+it.each([true, false, null, undefined])('reads initial state %s before first render', initial => {
+ mocks.sendSync.mockReturnValue(initial);
+ const bridge = createAccessibilitySupportBridge();
+ expect(mocks.sendSync).toHaveBeenCalledWith(ACCESSIBILITY_SUPPORT_GET);
+ expect(bridge.getSync()).toBe(initial !== false);
+});
+
+it('closes the render/subscribe gap, filters payloads, strips events and unsubscribes', () => {
+ mocks.sendSync.mockReturnValue(false);
+ const bridge = createAccessibilitySupportBridge();
+ expect(mocks.on.mock.calls[0][0]).toBe(ACCESSIBILITY_SUPPORT_CHANGED);
+ const emit = (value: unknown) => mocks.on.mock.calls[0][1]({ sender: 'private' }, value);
+ emit(true);
+ const callback = vi.fn();
+ const unsubscribe = bridge.onChanged(callback);
+ expect(callback).toHaveBeenLastCalledWith(true);
+ emit('false'); expect(bridge.getSync()).toBe(true);
+ expect(callback).toHaveBeenCalledTimes(1);
+ emit(false); expect(callback).toHaveBeenLastCalledWith(false);
+ unsubscribe(); emit(true);
+ expect(callback).toHaveBeenCalledTimes(2);
+ expect(bridge.getSync()).toBe(true);
+});
diff --git a/apps/desktop/src/preload/accessibilitySupport.ts b/apps/desktop/src/preload/accessibilitySupport.ts
new file mode 100644
index 0000000000..08312b0666
--- /dev/null
+++ b/apps/desktop/src/preload/accessibilitySupport.ts
@@ -0,0 +1,26 @@
+import { ipcRenderer } from 'electron';
+import {
+ ACCESSIBILITY_SUPPORT_CHANGED,
+ ACCESSIBILITY_SUPPORT_GET,
+ type AccessibilitySupportBridge,
+} from '../shared/accessibilitySupport';
+
+export function createAccessibilitySupportBridge(): AccessibilitySupportBridge {
+ // An unavailable initial snapshot must not hide text from assistive technology.
+ let current = ipcRenderer.sendSync(ACCESSIBILITY_SUPPORT_GET) !== false;
+ const subscribers = new Set<(enabled: boolean) => void>();
+ ipcRenderer.on(ACCESSIBILITY_SUPPORT_CHANGED, (_event, enabled: unknown) => {
+ if (typeof enabled !== 'boolean') return;
+ current = enabled;
+ subscribers.forEach(callback => callback(enabled));
+ });
+ return {
+ getSync: () => current,
+ onChanged(callback) {
+ subscribers.add(callback);
+ // Catch changes between initial render and effect subscription.
+ callback(current);
+ return () => { subscribers.delete(callback); };
+ },
+ };
+}
diff --git a/apps/desktop/src/preload/preload.ts b/apps/desktop/src/preload/preload.ts
index d5b2ce851f..200f18d23c 100644
--- a/apps/desktop/src/preload/preload.ts
+++ b/apps/desktop/src/preload/preload.ts
@@ -1,3 +1,4 @@
+import { createAccessibilitySupportBridge } from './accessibilitySupport';
import type { CompanionImportApi, CompanionImportSelection } from '@cindy/maker-shared/companion-import';
import { TASK_MIGRATION_LOCAL_CHANNEL } from '@cindy/device-link';
import type { WorktreeRecycleAction, WorktreeRecycleStatus } from '../shared/worktreeRecycle';
@@ -1090,6 +1091,7 @@ contextBridge.exposeInMainWorld('electronAPI', {
},
},
platform: process.platform,
+ accessibilitySupport: createAccessibilitySupportBridge(),
supportsBetaUpdateChannel: supportsBetaUpdateChannel(process.platform, process.arch),
windowBackdropMaterial: readWindowBackdropMaterialFromArgv(process.argv),
onWindowBackdropMaterialChanged: (
diff --git a/apps/desktop/src/preload/sidebarWindowPreload.ts b/apps/desktop/src/preload/sidebarWindowPreload.ts
index 95efedc34d..bb67cd9e89 100644
--- a/apps/desktop/src/preload/sidebarWindowPreload.ts
+++ b/apps/desktop/src/preload/sidebarWindowPreload.ts
@@ -1,3 +1,4 @@
+import { createAccessibilitySupportBridge } from './accessibilitySupport';
import { invokeOpenPath } from './openPath';
import { COPY_PNG_TO_CLIPBOARD_CHANNEL, type CopyPngToClipboardParams } from '../shared/pngClipboard';
/**
@@ -74,6 +75,7 @@ const fanOutFullscreenChange = (cb: (isFullscreen: boolean) => void): (() => voi
contextBridge.exposeInMainWorld('electronAPI', {
platform: process.platform,
+ accessibilitySupport: createAccessibilitySupportBridge(),
onWindowHiddenChange: (cb: (hidden: boolean) => void): (() => void) => {
const off = onPayload('window-hidden-change', cb);
cb(windowHidden);
diff --git a/apps/desktop/src/renderer/__tests__/animateFocusScroll.test.ts b/apps/desktop/src/renderer/__tests__/animateFocusScroll.test.ts
new file mode 100644
index 0000000000..818333d859
--- /dev/null
+++ b/apps/desktop/src/renderer/__tests__/animateFocusScroll.test.ts
@@ -0,0 +1,117 @@
+/** @vitest-environment jsdom */
+import { afterEach, expect, it, vi } from 'vitest';
+import { animateFocusScroll } from '../components/chat/animateFocusScroll';
+
+afterEach(() => { vi.unstubAllGlobals(); vi.restoreAllMocks(); });
+
+function fixture({ start = 22962, absolute = 14370, reduced = false, clockStart = 0 } = {}) {
+ let now = clockStart;
+ let nextFrame = 0;
+ let exists = true;
+ const frames = new Map<number, FrameRequestCallback>();
+ vi.stubGlobal('requestAnimationFrame', (cb: FrameRequestCallback) => {
+ frames.set(++nextFrame, cb); return nextFrame;
+ });
+ vi.stubGlobal('cancelAnimationFrame', (id: number) => frames.delete(id));
+ vi.spyOn(performance, 'now').mockImplementation(() => now);
+ vi.stubGlobal('matchMedia', () => ({ matches: reduced }));
+ const root = document.createElement('div');
+ const target = document.createElement('div');
+ root.scrollTop = start;
+ Object.defineProperty(root, 'clientHeight', { value: 1000 });
+ root.getBoundingClientRect = () => ({ top: 0 } as DOMRect);
+ root.scrollTo = ((options: ScrollToOptions) => {
+ root.scrollTop = Math.max(0, Math.min(26000, options.top ?? root.scrollTop));
+ }) as typeof root.scrollTo;
+ target.style.scrollMarginTop = '80px';
+ target.getBoundingClientRect = () => ({ top: absolute - root.scrollTop,
+ bottom: absolute - root.scrollTop + 330 } as DOMRect);
+ const onFinish = vi.fn();
+ const reconcile = vi.fn();
+ const cancel = animateFocusScroll({ root, getTarget: () => exists ? target : null,
+ reconcile, onFinish });
+ return { root, target, reconcile, onFinish, cancel,
+ move: (delta: number) => { absolute += delta; },
+ remove: () => { exists = false; },
+ frame: (elapsed: number) => {
+ now = elapsed;
+ const callbacks = [...frames.values()]; frames.clear(); callbacks.forEach(cb => cb(now));
+ return target.getBoundingClientRect().top;
+ },
+ };
+}
+
+it.each([
+ { absolute: 1000, firstFrame: 99.8 },
+ { absolute: 1000, firstFrame: 92 },
+ { absolute: 18000, firstFrame: 99.8 },
+ { absolute: 18000, firstFrame: 92 },
+])('does not reverse on an early first frame ($firstFrame, target $absolute)', ({ absolute, firstFrame }) => {
+ // Start away from both scroll boundaries so native clamping cannot hide a
+ // reverse movement. rAF's frame timestamp can precede performance.now().
+ const f = fixture({ start: 10000, absolute, clockStart: 100 });
+ f.frame(firstFrame);
+ expect(f.root.scrollTop).toBe(10000);
+ expect(f.reconcile).not.toHaveBeenCalled();
+ expect(f.onFinish).not.toHaveBeenCalled();
+ f.frame(100);
+ expect(f.root.scrollTop).toBe(10000);
+ f.frame(200);
+ expect(Math.sign(f.root.scrollTop - 10000)).toBe(Math.sign(absolute - 10000));
+ f.frame(1000);
+ expect(f.target.getBoundingClientRect().top).toBeCloseTo(375);
+ expect(f.onFinish).toHaveBeenCalledOnce();
+});
+
+it.each([416, -416])('keeps the visible trajectory when virtual heights change by %spx', shift => {
+ const f = fixture();
+ const positions: number[] = [];
+ for (let t = 0; t <= 850; t += 17) {
+ // Reproduce a height correction inside the mount caused by this scroll.
+ if (t === 510) f.reconcile.mockImplementationOnce(() => f.move(shift));
+ positions.push(f.frame(t));
+ }
+ expect(f.reconcile).toHaveBeenCalled();
+ expect(Math.abs(positions.at(-1)! - 375)).toBeLessThanOrEqual(0.5);
+ expect(positions.every((top, i) => i === 0 || top >= positions[i - 1] - 0.5)).toBe(true);
+ expect(f.onFinish).toHaveBeenCalledOnce();
+});
+
+it('tracks a target below the viewport when preceding rows shrink between frames', () => {
+ const f = fixture({ start: 2000, absolute: 18000 });
+ const positions = [f.frame(100), f.frame(300)];
+ f.move(-416);
+ positions.push(f.frame(500), f.frame(700), f.frame(850));
+ expect(positions.at(-1)).toBeCloseTo(375);
+ expect(positions.every((top, i) => i === 0 || top <= positions[i - 1] + 0.5)).toBe(true);
+ expect(f.onFinish).toHaveBeenCalledOnce();
+});
+
+it('does not recenter or finish after the caller cancels for user input/replacement/unmount', () => {
+ const f = fixture();
+ f.frame(200); f.cancel();
+ f.root.scrollTop = 7000;
+ f.move(416); f.frame(1000);
+ expect(f.root.scrollTop).toBe(7000);
+ expect(f.onFinish).not.toHaveBeenCalled();
+});
+
+it('hands a removed target back to the existing deletion settlement', () => {
+ const f = fixture();
+ f.frame(200); f.remove(); f.frame(220); f.frame(1000);
+ expect(f.onFinish).toHaveBeenCalledOnce();
+});
+
+it('honors reduced motion while still measuring the final mounted target', () => {
+ const f = fixture({ reduced: true });
+ f.reconcile.mockImplementationOnce(() => f.move(416));
+ expect(f.frame(17)).toBeCloseTo(375);
+ expect(f.onFinish).toHaveBeenCalledOnce();
+});
+
+it('finishes a target at the scroll boundary without oscillation', () => {
+ const f = fixture({ absolute: 0 });
+ f.frame(900);
+ expect(f.root.scrollTop).toBe(0);
+ expect(f.onFinish).toHaveBeenCalledOnce();
+});
diff --git a/apps/desktop/src/renderer/__tests__/focusScrollSettlement.test.ts b/apps/desktop/src/renderer/__tests__/focusScrollSettlement.test.ts
new file mode 100644
index 0000000000..346f394d06
--- /dev/null
+++ b/apps/desktop/src/renderer/__tests__/focusScrollSettlement.test.ts
@@ -0,0 +1,140 @@
+/** @vitest-environment jsdom */
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import ts from 'typescript';
+import { afterEach, expect, it, vi } from 'vitest';
+
+const source = ts.createSourceFile('MessageStream.tsx', readFileSync(
+ resolve(__dirname, '../components/chat/MessageStream.tsx'), 'utf8',
+), ts.ScriptTarget.Latest, true, ts.ScriptKind.TSX);
+const component = source.statements.find((node): node is ts.FunctionDeclaration =>
+ ts.isFunctionDeclaration(node) && node.name?.text === 'MessageStream')!;
+const effect = component.body!.statements.find(node => ts.isExpressionStatement(node) &&
+ ts.isCallExpression(node.expression) && node.expression.expression.getText(source) === 'useEffect' &&
+ node.getText(source).includes("root.addEventListener('scrollend', onScrollEnd)")) as ts.ExpressionStatement;
+const callback = (effect.expression as ts.CallExpression).arguments[0];
+const code = ts.transpileModule(`return (${callback.getText(source)});`, {
+ compilerOptions: { target: ts.ScriptTarget.ES2022 },
+}).outputText;
+const cleanups: (() => void)[] = [];
+afterEach(() => { cleanups.splice(0).forEach(cleanup => cleanup()); vi.unstubAllGlobals(); });
+
+function fixture() {
+ const root = document.createElement('div');
+ const frames: FrameRequestCallback[] = [];
+ vi.stubGlobal('requestAnimationFrame', (callback: FrameRequestCallback) => frames.push(callback));
+ const focusJumpRef = { current: {} as object | null };
+ const bindings = {
+ scrollRef: { current: root }, focusJumpRef, settleFocusJump: vi.fn(),
+ cancelFocusJump: () => { focusJumpRef.current = null; },
+ isScrollNavigationKey: () => true, isEditableKeyboardTarget: () => false,
+ };
+ const cleanup = new Function(...Object.keys(bindings), code)(...Object.values(bindings))();
+ cleanups.push(cleanup);
+ return { ...bindings, root, cleanup, frame: () => frames.splice(0).forEach(callback => callback(0)) };
+}
+
+it('waits for pending layout frames before final focus correction', () => {
+ const f = fixture();
+ f.root.dispatchEvent(new Event('scrollend'));
+ f.frame();
+ expect(f.settleFocusJump).not.toHaveBeenCalled();
+ f.frame();
+ expect(f.settleFocusJump).toHaveBeenCalledOnce();
+});
+
+it('does not treat each animated scroll write as the end of the focus jump', () => {
+ const f = fixture();
+ f.focusJumpRef.current = { cancelAnimation: vi.fn() };
+ f.root.dispatchEvent(new Event('scrollend'));
+ f.frame(); f.frame();
+ expect(f.settleFocusJump).not.toHaveBeenCalled();
+});
+
+it.each(['wheel', 'replacement', 'unmount'])('does not recenter after %s takes ownership', action => {
+ const f = fixture();
+ f.root.dispatchEvent(new Event('scrollend'));
+ f.frame();
+ if (action === 'wheel') f.root.dispatchEvent(new Event('wheel'));
+ else if (action === 'replacement') f.focusJumpRef.current = {};
+ else f.cleanup();
+ f.frame();
+ expect(f.settleFocusJump).not.toHaveBeenCalled();
+});
+
+it('keeps the generic scrollend listener from finishing a focus-owned generation', () => {
+ const f = fixture();
+ const genericEffect = component.body!.statements.find(node => ts.isExpressionStatement(node) &&
+ ts.isCallExpression(node.expression) && node.expression.expression.getText(source) === 'useEffect' &&
+ node.getText(source).includes('settleChipJump();')) as ts.ExpressionStatement;
+ const callback = (genericEffect.expression as ts.CallExpression).arguments[0];
+ const genericCode = ts.transpileModule(`return (${callback.getText(source)});`, {
+ compilerOptions: { target: ts.ScriptTarget.ES2022 },
+ }).outputText;
+ const bindings = {
+ scrollRef: { current: f.root }, focusJumpRef: f.focusJumpRef,
+ settleChipJump: vi.fn(), chipJumpGenerationRef: { current: null },
+ programmaticScrollRef: { current: true }, programmaticScrollGenerationRef: { current: 7 },
+ finishProgrammaticScroll: vi.fn(() => false), refreshViewportAnchor: vi.fn(),
+ };
+ cleanups.push(new Function(...Object.keys(bindings), genericCode)(...Object.values(bindings))());
+ f.root.dispatchEvent(new Event('scrollend'));
+ expect(bindings.finishProgrammaticScroll).not.toHaveBeenCalled();
+ f.frame();f.frame();
+ expect(f.settleFocusJump).toHaveBeenCalledOnce();
+ f.focusJumpRef.current = null;
+ f.root.dispatchEvent(new Event('scrollend'));
+ expect(bindings.finishProgrammaticScroll).toHaveBeenCalledWith(7);
+});
+
+function settlement() {
+ const declaration = component.body!.statements.flatMap(node => ts.isVariableStatement(node)
+ ? [...node.declarationList.declarations] : []).find(node => node.name.getText(source) === 'settleFocusJump')!;
+ const callback = (declaration.initializer as ts.CallExpression).arguments[0];
+ const body = ts.transpileModule(`return (${callback.getText(source)});`, {
+ compilerOptions: { target: ts.ScriptTarget.ES2022 },
+ }).outputText;
+ const frames: FrameRequestCallback[] = [];
+ vi.stubGlobal('requestAnimationFrame', (callback: FrameRequestCallback) => frames.push(callback));
+ const root = { scrollTop: 0, getBoundingClientRect: () => ({ top: 0 }) };
+ const target = { scrollIntoView: () => { root.scrollTop = 1000; },
+ getBoundingClientRect: () => ({ top: 100, bottom: 300 }), dataset: { messageClientId: 'target' } };
+ const jump = { clientId: 'target', requestKey: '1:target', targetKey: 'msg-target',
+ messageClientIdsAtJump: [], scrollGeneration: 7 };
+ const bindings = {
+ focusJumpRef: { current: jump as typeof jump | null }, focusScrollTimerRef: { current: null },
+ focusHighlightTimerRef: { current: null }, programmaticScrollGenerationRef: { current: 7 },
+ deferredDeleteCompensationRef: { current: false }, scrollRef: { current: root },
+ setHighlightMessageClientId: vi.fn(), allRenderItemsRef: { current: [] },
+ queryFocusElement: () => target, syncMessageViewport: vi.fn(),
+ refreshViewportAnchor: vi.fn(() => ({ viewportTopKey: 'msg-target', offset: 0 })),
+ finishProgrammaticScroll: vi.fn(() => false),
+ };
+ return { ...bindings, root, jump, settle: new Function(...Object.keys(bindings), body)(...Object.values(bindings)) as () => void,
+ frame: () => frames.splice(0).forEach(callback => callback(0)) };
+}
+
+it('corrects a late native offset before releasing search ownership', () => {
+ const f = settlement();
+ f.settle();f.frame();
+ expect(f.root.scrollTop).toBe(1000);
+ expect(f.finishProgrammaticScroll).not.toHaveBeenCalled();
+ f.root.scrollTop = 1800; // Native correction arrives after the first alignment.
+ f.frame();
+ expect(f.root.scrollTop).toBe(1000);
+ f.frame();f.frame();
+ expect(f.finishProgrammaticScroll).not.toHaveBeenCalled();
+ f.frame();
+ expect(f.finishProgrammaticScroll).toHaveBeenCalledOnce();
+ expect(f.focusJumpRef.current).toBeNull();
+});
+
+it('does not undo a user position after cancellation during layout settling', () => {
+ const f = settlement();
+ f.settle();
+ f.focusJumpRef.current = null;
+ f.root.scrollTop = 800;
+ f.frame();
+ expect(f.root.scrollTop).toBe(800);
+ expect(f.finishProgrammaticScroll).not.toHaveBeenCalled();
+});
diff --git a/apps/desktop/src/renderer/__tests__/focusScrollWindow.test.ts b/apps/desktop/src/renderer/__tests__/focusScrollWindow.test.ts
new file mode 100644
index 0000000000..da41a3e1d0
--- /dev/null
+++ b/apps/desktop/src/renderer/__tests__/focusScrollWindow.test.ts
@@ -0,0 +1,65 @@
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import ts from 'typescript';
+import { expect, it, vi } from 'vitest';
+import { resolveWindowCoverageLossAction, REPIN_AT_BOTTOM_PX } from '../components/chat/autoFollowIntent';
+
+const source = ts.createSourceFile('MessageStream.tsx', readFileSync(
+ resolve(__dirname, '../components/chat/MessageStream.tsx'), 'utf8',
+), ts.ScriptTarget.Latest, true, ts.ScriptKind.TSX);
+const component = source.statements.find((node): node is ts.FunctionDeclaration =>
+ ts.isFunctionDeclaration(node) && node.name?.text === 'MessageStream')!;
+const declaration = component.body!.statements.flatMap(node => ts.isVariableStatement(node)
+ ? [...node.declarationList.declarations] : []).find(node => node.name.getText(source) === 'handleScroll')!;
+const callback = (declaration.initializer as ts.CallExpression).arguments[0];
+const code = ts.transpileModule(`return (${callback.getText(source)});`, {
+ compilerOptions: { target: ts.ScriptTarget.ES2022 },
+}).outputText;
+
+function fixture(windowAtTop: boolean) {
+ const bindings = {
+ scrollRef: { current: { scrollTop: 0, scrollHeight: 10000, clientHeight: 600 } },
+ scrollbarDragStartTopRef: { current: null }, restoringRef: { current: false },
+ prevScrollTopRef: { current: 0 }, programmaticScrollRef: { current: true },
+ focusJumpRef: { current: {} as object | null }, chipJumpGenerationRef: { current: null },
+ chipJumpInProgressRef: { current: false }, SCROLL_DIRECTION_DEAD_ZONE_PX: 2,
+ TOP_HISTORY_TRIGGER_PX: 50, windowAtTop, prevScrollHeightRef: { current: 0 },
+ prevScrollTopAtLoadRef: { current: 0 }, expandWindow: vi.fn(),
+ isLoadingMore: false, onLoadMore: vi.fn(), hasMoreMessages: true,
+ };
+ const scroll = new Function(...Object.keys(bindings), code)(...Object.values(bindings)) as () => void;
+ return { ...bindings, scroll };
+}
+
+it.each([false, true])('does not load older history when a search lands on the top edge (atTop=%s)', windowAtTop => {
+ const f = fixture(windowAtTop);
+ f.scroll();
+ expect(f.expandWindow).not.toHaveBeenCalled();
+ expect(f.onLoadMore).not.toHaveBeenCalled();
+ expect(f.prevScrollHeightRef.current).toBe(0);
+ // Once focus navigation releases ownership, the existing history path resumes.
+ f.focusJumpRef.current = null;
+ f.scroll();
+ expect(windowAtTop ? f.onLoadMore : f.expandWindow).toHaveBeenCalledOnce();
+});
+
+it.each([false, true])('only repins a window extended to the tail outside programmatic navigation (navigating=%s)', navigating => {
+ const effect = component.body!.statements.find(node => ts.isExpressionStatement(node) &&
+ ts.isCallExpression(node.expression) && node.expression.expression.getText(source) === 'useLayoutEffect' &&
+ node.getText(source).includes('const wasCovering = prevWindowCoversEndRef.current;')) as ts.ExpressionStatement;
+ const callback = (effect.expression as ts.CallExpression).arguments[0];
+ const code = ts.transpileModule(`return (${callback.getText(source)});`, {
+ compilerOptions: { target: ts.ScriptTarget.ES2022 },
+ }).outputText;
+ const bindings = {
+ prevWindowCoversEndRef: { current: false }, windowCoversEnd: true,
+ firstVisibleItemKey: 'search-window', isNearBottomRef: { current: false },
+ programmaticScrollRef: { current: navigating }, restoringRef: { current: false },
+ scrollRef: { current: { scrollHeight: 600, scrollTop: 0, clientHeight: 600 } },
+ setIsNearBottom: vi.fn(), setUnreadCount: vi.fn(), setFirstVisibleItemKey: vi.fn(),
+ resolveWindowCoverageLossAction, REPIN_AT_BOTTOM_PX,
+ };
+ new Function(...Object.keys(bindings), code)(...Object.values(bindings))();
+ expect(bindings.isNearBottomRef.current).toBe(!navigating);
+ expect(bindings.setFirstVisibleItemKey).toHaveBeenCalledTimes(navigating ? 0 : 1);
+});
diff --git a/apps/desktop/src/renderer/__tests__/historyTurnChangesProjection.test.ts b/apps/desktop/src/renderer/__tests__/historyTurnChangesProjection.test.ts
new file mode 100644
index 0000000000..e5d674b306
--- /dev/null
+++ b/apps/desktop/src/renderer/__tests__/historyTurnChangesProjection.test.ts
@@ -0,0 +1,67 @@
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import ts from 'typescript';
+import { describe, expect, it } from 'vitest';
+import { buildRenderItems, groupWorkRuns } from '../components/chat/MessageStream';
+import type { ChatMessage } from '../lib/makerChatStore';
+import type { TurnChangeSetSummary } from '../../shared/turnChangeSet';
+
+// Exercise the actual history-view build callback, rather than supplying the
+// missing option directly to buildRenderItems (which already has unit coverage).
+const source = ts.createSourceFile('MessageStream.tsx', readFileSync(
+ resolve(__dirname, '../components/chat/MessageStream.tsx'), 'utf8',
+), ts.ScriptTarget.Latest, true, ts.ScriptKind.TSX);
+let callback: ts.ArrowFunction | undefined;
+function visit(node: ts.Node) {
+ if (ts.isCallExpression(node) && node.expression.getText(source) === 'renderHistoryView') {
+ const options = node.arguments[0] as ts.ObjectLiteralExpression;
+ callback = (options.properties.find(p => ts.isPropertyAssignment(p)
+ && p.name.getText(source) === 'build') as ts.PropertyAssignment).initializer as ts.ArrowFunction;
+ }
+ ts.forEachChild(node, visit);
+}
+visit(source);
+const code = ts.transpileModule(`return (${callback!.getText(source)});`, {
+ compilerOptions: { target: ts.ScriptTarget.ES2022 },
+}).outputText;
+const changeSet: TurnChangeSetSummary = {
+ id: 'changes-1', sessionId: 'session-1', anchorClientId: 'user-1', provider: 'codex',
+ providerTurnId: 'turn-1', cwd: 'C:/fixture', state: 'complete', workspaceState: 'applied',
+ isReversible: true, incompleteReasons: [], createdAt: 1, completedAt: 2,
+ files: Array.from({ length: 5 }, (_, i) => ({ id: `file-${i}`, path: `note-${i}.txt`,
+ oldPath: null, status: 'modified' as const, additions: 1, deletions: 1 })),
+ fileCount: 5, additions: 5, deletions: 5,
+};
+function render(rows: ChatMessage[], streaming = false) {
+ const bindings = { buildRenderItems, groupWorkRuns, results: new Map(),
+ taskUpdates: undefined, ghostCardSnapshot: undefined, workingDir: 'C:/fixture',
+ turnChangeSets: [changeSet], simplifiedBotConversation: false, sessionId: 'session-1',
+ markdownImageTargetCacheRef: { current: new Map() }, cindyMakeSessionId: undefined,
+ cindyMakeCompletionInComposer: undefined, subagentRunStatuses: undefined,
+ isSessionStreaming: streaming };
+ const build = new Function(...Object.keys(bindings), code)(...Object.values(bindings)) as
+ (rows: ChatMessage[], streaming: boolean) => ReturnType<typeof buildRenderItems>['items'];
+ return build(rows, streaming);
+}
+describe('history-view changed files cards', () => {
+ it('keeps the completed five-file card before the next streaming turn', () => {
+ const rows: ChatMessage[] = [
+ { clientId: 'user-1', role: 'user', content: 'Edit five files' },
+ { clientId: 'answer-1', role: 'assistant', content: 'Done' },
+ { clientId: 'user-2', role: 'user', content: 'Continue' },
+ { clientId: 'answer-2', role: 'assistant', content: 'Streaming', isStreaming: true },
+ ];
+ const items = render(rows, true);
+ const cards = items.filter(item => item.type === 'turn_changes');
+ expect(cards).toHaveLength(1);
+ expect(cards[0].changeSet.files).toHaveLength(5);
+ expect(items.map(item => item.key)).toEqual([
+ 'msg-user-1', 'msg-answer-1', 'turnchanges-changes-1', 'msg-user-2', 'msg-answer-2',
+ ]);
+ expect(render(rows.slice(0, 2)).filter(item => item.type === 'turn_changes')).toHaveLength(1);
+ });
+ it('does not pull a changed-files card from a turn outside the loaded history', () => {
+ expect(render([{ clientId: 'user-2', role: 'user', content: 'Another page' }])
+ .filter(item => item.type === 'turn_changes')).toEqual([]);
+ });
+});
diff --git a/apps/desktop/src/renderer/__tests__/historyViewportCompensation.test.ts b/apps/desktop/src/renderer/__tests__/historyViewportCompensation.test.ts
index ecb274755b..746881ccf1 100644
--- a/apps/desktop/src/renderer/__tests__/historyViewportCompensation.test.ts
+++ b/apps/desktop/src/renderer/__tests__/historyViewportCompensation.test.ts
@@ -118,6 +118,7 @@ describe('history viewport compensation', () => {
viewportAnchorCorrection,
settleChipJump: vi.fn(),
chipJumpGenerationRef: { current: null },
+ focusJumpRef: { current: null },
programmaticScrollRef: { current: true },
programmaticScrollGenerationRef: { current: 1 },
finishProgrammaticScroll: () => false,
diff --git a/apps/desktop/src/renderer/__tests__/jumpToLatestLayout.test.tsx b/apps/desktop/src/renderer/__tests__/jumpToLatestLayout.test.tsx
new file mode 100644
index 0000000000..02dc0aa913
--- /dev/null
+++ b/apps/desktop/src/renderer/__tests__/jumpToLatestLayout.test.tsx
@@ -0,0 +1,57 @@
+/** @vitest-environment jsdom */
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import ts from 'typescript';
+import { act, useRef, useState } from 'react';
+import { createRoot } from 'react-dom/client';
+import { flushSync } from 'react-dom';
+import { expect, it, vi } from 'vitest';
+
+// Execute the real callback against React commits: the old history window and
+// the latest window have different heights. A source-string contract would not
+// detect measuring the old DOM before React finishes switching windows.
+const source = ts.createSourceFile('MessageStream.tsx', readFileSync(
+ resolve(__dirname, '../components/chat/MessageStream.tsx'), 'utf8',
+), ts.ScriptTarget.Latest, true, ts.ScriptKind.TSX);
+const component = source.statements.find((node): node is ts.FunctionDeclaration =>
+ ts.isFunctionDeclaration(node) && node.name?.text === 'MessageStream')!;
+const statement = component.body!.statements.find(node => ts.isVariableStatement(node) &&
+ node.declarationList.declarations.some(d => d.name.getText(source) === 'scrollToBottomSmooth'))!;
+const code = ts.transpileModule(statement.getText(source) + '\nreturn scrollToBottomSmooth;', {
+ compilerOptions: { target: ts.ScriptTarget.ES2022 },
+}).outputText;
+
+it('measures the latest window after its React commit when jumping out of history', async () => {
+ (globalThis as { IS_REACT_ACT_ENVIRONMENT?: boolean }).IS_REACT_ACT_ENVIRONMENT = true;
+ vi.useFakeTimers();
+ const host = document.body.appendChild(document.createElement('div'));
+ const root = createRoot(host);
+ let jump: () => void = () => {};
+ const scroll = vi.fn();
+ function Fixture() {
+ const [firstKey, setFirstVisibleItemKey] = useState<string | null>('old-history');
+ const scrollRef = useRef<HTMLDivElement>(null);
+ const bindings = {
+ useCallback: (callback: () => void) => callback, flushSync, scrollRef,
+ restoringRef: { current: false }, cancelFocusJump: vi.fn(),
+ chipJumpGenerationRef: { current: null }, finishChipJump: vi.fn(),
+ setUnreadCount: vi.fn(), setIsNearBottom: vi.fn(), isNearBottomRef: { current: false },
+ beginProgrammaticScroll: () => 1, setFirstVisibleItemKey,
+ syncMessageViewport: vi.fn(),
+ finishProgrammaticScroll: () => false, refreshViewportAnchor: vi.fn(), CHIP_JUMP_SAFETY_MS: 1000,
+ };
+ jump = new Function(...Object.keys(bindings), code)(...Object.values(bindings));
+ return <div ref={scrollRef} data-window={firstKey ?? 'latest'} />;
+ }
+ try {
+ await act(async () => root.render(<Fixture />));
+ const element = host.firstElementChild as HTMLDivElement;
+ Object.defineProperty(element, 'scrollHeight', { get: () => element.dataset.window === 'latest' ? 8000 : 3000 });
+ element.scrollTo = scroll;
+ await act(async () => jump());
+ expect(element.dataset.window).toBe('latest');
+ expect(scroll).toHaveBeenCalledWith({ top: 8000, behavior: 'smooth' });
+ } finally {
+ await act(async () => root.unmount()); host.remove(); vi.clearAllTimers(); vi.useRealTimers();
+ }
+});
diff --git a/apps/desktop/src/renderer/__tests__/messageViewportGeometry.test.ts b/apps/desktop/src/renderer/__tests__/messageViewportGeometry.test.ts
new file mode 100644
index 0000000000..c3820b8ce4
--- /dev/null
+++ b/apps/desktop/src/renderer/__tests__/messageViewportGeometry.test.ts
@@ -0,0 +1,24 @@
+import { describe, expect, it } from 'vitest';
+import { findViewportRange } from '../components/chat/messageViewportGeometry';
+
+describe('indexed message geometry', () => {
+ it('matches intersecting rows including exact boundaries, gaps and zero-height rows', () => {
+ const tops: number[] = [], bottoms: number[] = [];
+ let cursor = 19;
+ for (let i = 0; i < 500; i++) {
+ cursor += i % 7;
+ tops.push(cursor); cursor += (i * 37) % 401; bottoms.push(cursor);
+ }
+ for (const top of [-1000, ...tops, ...bottoms, cursor + 1]) {
+ for (const height of [0, 1, 600, 1600]) {
+ const { start, end } = findViewportRange(tops, bottoms, top, top + height);
+ expect(tops.slice(start, end).map((_, i) => start + i)).toEqual(
+ tops.flatMap((value, i) => bottoms[i] >= top && value <= top + height ? [i] : []),
+ );
+ }
+ }
+ });
+ it('handles empty history', () => {
+ expect(findViewportRange([], [], 0, 800)).toEqual({ start: 0, end: 0 });
+ });
+});
diff --git a/apps/desktop/src/renderer/__tests__/messageViewportVirtualization.test.tsx b/apps/desktop/src/renderer/__tests__/messageViewportVirtualization.test.tsx
new file mode 100644
index 0000000000..41aa056fd2
--- /dev/null
+++ b/apps/desktop/src/renderer/__tests__/messageViewportVirtualization.test.tsx
@@ -0,0 +1,462 @@
+/** @vitest-environment jsdom */
+import { act, useLayoutEffect, useRef } from 'react';
+import { createRoot, type Root } from 'react-dom/client';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { MessageViewport, type MessageViewportApi } from '../components/chat/MessageViewport';
+import { acquirePageTextAccess, isPageTextAccessActive } from '../lib/pageTextAccess';
+
+let host: HTMLDivElement;
+let root: Root;
+let frames: Map<number, FrameRequestCallback>;
+let sequence: number;
+let viewportHeight: number;
+let scrollWrites: number[];
+let rowMeasurements: number;
+let parentRenders: number;
+let notifyResize: () => void;
+let syncViewport: () => void;
+let reconcileViewport: () => void;
+let setFollowing: (value: boolean) => void;
+const entries = Array.from({ length: 80 }, (_, index) => ({ key: String(index), retain: index === 79 }));
+const rectangle = (top: number, height: number) => ({ top, bottom: top + height, height, width: 800,
+ left: 0, right: 800, x: 0, y: top, toJSON() {} }) as DOMRect;
+function Fixture({ disabled = false, restore = false, restoreOffset, onProgrammaticScroll }: {
+ disabled?: boolean; restore?: boolean; restoreOffset?: number; onProgrammaticScroll?: () => void;
+}) {
+ parentRenders++;
+ const scrollRef = useRef<HTMLDivElement>(null);
+ const itemsRef = useRef<HTMLDivElement>(null);
+ const followRef = useRef(!restore);
+ const apiRef = useRef<MessageViewportApi>(null);
+ useLayoutEffect(() => { apiRef.current?.connect(); });
+ useLayoutEffect(() => {
+ if (restoreOffset !== undefined) scrollRef.current!.scrollTop = 40 * 180 + restoreOffset;
+ }, [restoreOffset]);
+ setFollowing = value => { followRef.current = value; };
+ return <div ref={scrollRef} data-scroll="" onWheel={() => { followRef.current = false; }}>
+ <MessageViewport apiRef={apiRef} options={{ entries, scrollRef, itemsRef, followRef, disabled, onProgrammaticScroll,
+ initialAnchor: restore ? '40' : undefined,
+ initialHeights: restore ? Object.fromEntries(entries.map(entry => [entry.key, 180])) : undefined,
+ }}>{viewport => {
+ syncViewport = () => apiRef.current!.syncViewport();
+ reconcileViewport = () => apiRef.current!.reconcileViewport();
+ return <div ref={itemsRef}>{entries.map(entry => viewport.shouldMount(entry)
+ ? <div key={entry.key} data-render-item-key={entry.key}><button>Row {entry.key}</button></div>
+ : <div key={entry.key} data-render-item-key={entry.key} data-message-placeholder=""
+ style={{ height: viewport.placeholderHeight(entry.key) }} />)}</div>;
+ }}</MessageViewport></div>;
+}
+async function flushFrames() {
+ for (let i = 0; i < 5 && frames.size; i++) {
+ const pending = [...frames.values()]; frames.clear();
+ await act(async () => { pending.forEach(callback => callback(i * 16)); });
+ }
+}
+const scroller = () => host.querySelector<HTMLElement>('[data-scroll]')!;
+const row = (key: number) => host.querySelector<HTMLElement>(`[data-render-item-key="${key}"]`)!;
+beforeEach(() => {
+ (globalThis as { IS_REACT_ACT_ENVIRONMENT?: boolean }).IS_REACT_ACT_ENVIRONMENT = true;
+ frames = new Map(); sequence = 0; viewportHeight = 600; scrollWrites = []; rowMeasurements = 0; parentRenders = 0;
+ vi.stubGlobal('requestAnimationFrame', (callback: FrameRequestCallback) => { frames.set(++sequence, callback); return sequence; });
+ vi.stubGlobal('cancelAnimationFrame', (id: number) => { frames.delete(id); });
+ vi.stubGlobal('ResizeObserver', class {
+ constructor(callback: () => void) { notifyResize = callback; }
+ observe() {} unobserve() {} disconnect() {}
+ });
+ vi.spyOn(HTMLElement.prototype, 'getBoundingClientRect').mockImplementation(function (this: HTMLElement) {
+ if (this.hasAttribute('data-render-item-key')) {
+ rowMeasurements++;
+ let top = 0;
+ for (const sibling of Array.from(this.parentElement!.children) as HTMLElement[]) {
+ if (sibling === this) break;
+ top += Number.parseFloat(sibling.style.height) || 180;
+ }
+ return rectangle(top - scroller().scrollTop, Number.parseFloat(this.style.height) || 180);
+ }
+ return rectangle(0, viewportHeight);
+ });
+ vi.spyOn(HTMLElement.prototype, 'clientHeight', 'get').mockImplementation(() => viewportHeight);
+ vi.spyOn(HTMLElement.prototype, 'scrollHeight', 'get').mockImplementation(function (this: HTMLElement) {
+ return Array.from(this.querySelectorAll<HTMLElement>('[data-render-item-key]'))
+ .reduce((sum, row) => sum + (Number.parseFloat(row.style.height) || 180), 0);
+ });
+ // jsdom does not clamp scrollTop like a browser.
+ const tops = new WeakMap<HTMLElement, number>();
+ vi.spyOn(HTMLElement.prototype, 'scrollTop', 'get').mockImplementation(function (this: HTMLElement) { return tops.get(this) || 0; });
+ vi.spyOn(HTMLElement.prototype, 'scrollTop', 'set').mockImplementation(function (this: HTMLElement, value: number) {
+ scrollWrites.push(value);
+ tops.set(this, Math.max(0, Math.min(value, this.scrollHeight - this.clientHeight)));
+ });
+ host = document.body.appendChild(document.createElement('div'));
+ root = createRoot(host);
+});
+afterEach(async () => {
+ await act(async () => root.unmount());
+ document.getSelection()?.removeAllRanges();
+ host.remove(); vi.useRealTimers(); vi.restoreAllMocks(); vi.unstubAllGlobals();
+});
+describe('message viewport content virtualization', () => {
+ it('initializes before the owner restores a precise reading offset', async () => {
+ await act(async () => root.render(<Fixture restore restoreOffset={97} />));
+ await flushFrames();
+ expect(row(40).getBoundingClientRect().top).toBe(-97);
+ await act(async () => root.render(<Fixture restore restoreOffset={97} />));
+ await flushFrames();
+ expect(row(40).getBoundingClientRect().top).toBe(-97);
+ });
+ it('changes the mounted range without rerendering the owning thread or measuring every row', async () => {
+ await act(async () => root.render(<Fixture restore />));
+ await flushFrames();
+ const before = parentRenders;
+ rowMeasurements = 0;
+ await act(async () => { scroller().scrollTop = 1800; syncViewport(); });
+ await flushFrames();
+ expect(row(10).querySelector('button')).not.toBeNull();
+ expect(row(40).hasAttribute('data-message-placeholder')).toBe(true);
+ expect(parentRenders).toBe(before);
+ expect(rowMeasurements).toBeLessThan(entries.length);
+ });
+ it('reuses the measured interval for small scrolls without reading every row again', async () => {
+ await act(async () => root.render(<Fixture restore />));
+ await flushFrames();
+ const mountedBefore = host.querySelectorAll('button').length;
+ rowMeasurements = 0;
+ await act(async () => {
+ scroller().scrollTop += 16;
+ syncViewport();
+ scroller().dispatchEvent(new Event('scroll'));
+ });
+ expect(rowMeasurements).toBe(0);
+ expect(host.querySelectorAll('button').length).toBe(mountedBefore);
+ expect(row(40).querySelector('button')).not.toBeNull();
+ });
+
+ it('coalesces the scroll event following an already committed script jump', async () => {
+ await act(async () => root.render(<Fixture restore />));
+ await act(async () => { scroller().scrollTop = 1800; syncViewport(); });
+ await flushFrames();
+ expect(row(10).querySelector('button')).not.toBeNull();
+ rowMeasurements = 0;
+ await act(async () => {
+ scroller().dispatchEvent(new Event('scroll'));
+ syncViewport();
+ reconcileViewport();
+ });
+ expect(rowMeasurements).toBe(0);
+ });
+
+ it('does not repeat a committed measurement when resize delivery catches up', async () => {
+ await act(async () => root.render(<Fixture restore />));
+ await flushFrames();
+ await act(async () => { scroller().scrollTop = 1800; syncViewport(); });
+ await flushFrames();
+ rowMeasurements = 0;
+ await act(async () => notifyResize());
+ await flushFrames();
+ expect(rowMeasurements).toBe(0);
+ });
+
+ it('invalidates the interval when nested rows redistribute height without changing the total', async () => {
+ await act(async () => root.render(<Fixture restore />));
+ await flushFrames();
+ const total = scroller().scrollHeight;
+ rowMeasurements = 0;
+ await act(async () => {
+ row(39).style.height = '270px';
+ row(40).style.height = '90px';
+ expect(scroller().scrollHeight).toBe(total);
+ // Before MutationObserver delivery: synchronous navigation must also see it.
+ syncViewport();
+ });
+ expect(rowMeasurements).toBeGreaterThan(0);
+ expect(row(39).querySelector('button')).not.toBeNull();
+ expect(row(40).querySelector('button')).not.toBeNull();
+ });
+
+ it('invalidates an unchanged scroll position when the viewport grows', async () => {
+ await act(async () => root.render(<Fixture restore />));
+ await flushFrames();
+ expect(row(48).querySelector('button')).toBeNull();
+ await act(async () => { viewportHeight = 1600; syncViewport(); });
+ expect(row(48).querySelector('button')).not.toBeNull();
+ });
+
+ it('exposes every loaded body immediately when accessibility support is already enabled', async () => {
+ vi.stubGlobal('electronAPI', { accessibilitySupport: { getSync: () => true, onChanged: () => () => {} } });
+ await act(async () => root.render(<Fixture restore />));
+ expect(host.querySelectorAll('button').length).toBe(80);
+ expect(host.querySelectorAll('[data-message-placeholder]').length).toBe(0);
+ });
+
+ it('handles accessibility changes after subscription without changing logical rows or the reading anchor', async () => {
+ let notify: (enabled: boolean) => void = () => {};
+ const unsubscribe = vi.fn();
+ vi.stubGlobal('electronAPI', { accessibilitySupport: {
+ getSync: () => false,
+ onChanged: (callback: typeof notify) => { notify = callback; return unsubscribe; },
+ } });
+ await act(async () => root.render(<Fixture restore />));
+ await flushFrames();
+ const before = row(40).getBoundingClientRect().top;
+ expect(host.querySelectorAll('button').length).toBeLessThan(20);
+ await act(async () => notify(true));
+ expect(host.querySelectorAll('button').length).toBe(80);
+ expect(row(40).getBoundingClientRect().top).toBe(before);
+ await act(async () => notify(false));
+ expect(host.querySelectorAll('button').length).toBeLessThan(20);
+ expect(row(40).getBoundingClientRect().top).toBe(before);
+ expect(host.querySelectorAll('[data-render-item-key]').length).toBe(80);
+ await act(async () => root.render(null));
+ expect(unsubscribe).toHaveBeenCalledTimes(1);
+ });
+
+ it('exposes only the logical window for page text consumers and restores virtualization on release', async () => {
+ await act(async () => root.render(<Fixture restore />));
+ await flushFrames();
+ const before = row(40).getBoundingClientRect().top;
+ let release = () => {};
+ let releaseSecond = () => {};
+ try {
+ await act(async () => { release = acquirePageTextAccess(); releaseSecond = acquirePageTextAccess(); });
+ expect(host.querySelectorAll('button').length).toBe(80);
+ expect(row(40).getBoundingClientRect().top).toBe(before);
+ await act(async () => { release(); release(); });
+ expect(isPageTextAccessActive()).toBe(true);
+ expect(host.querySelectorAll('button').length).toBe(80);
+ await act(async () => releaseSecond());
+ expect(isPageTextAccessActive()).toBe(false);
+ expect(host.querySelectorAll('button').length).toBeLessThan(20);
+ expect(row(40).getBoundingClientRect().top).toBe(before);
+ expect(host.querySelectorAll('[data-render-item-key]').length).toBe(80);
+ } finally { await act(async () => { release(); releaseSecond(); }); }
+ });
+ it.each([{ ctrlKey: true }, { metaKey: true }])('exposes page text before native select-all with BODY focused: %j', async modifiers => {
+ // jsdom does not perform native select-all. Inspect the keydown commit
+ // before the later settlement task checks the browser's resulting selection.
+ vi.useFakeTimers();
+ await act(async () => root.render(<Fixture />));
+ await flushFrames();
+ expect(document.activeElement).toBe(document.body);
+ await act(async () => document.body.dispatchEvent(new KeyboardEvent('keydown', {
+ key: 'a', bubbles: true, ...modifiers,
+ })));
+ expect(host.querySelectorAll('button').length).toBe(80);
+ expect(scroller().scrollHeight - scroller().scrollTop - viewportHeight).toBe(0);
+ await act(async () => vi.runOnlyPendingTimers());
+ expect(host.querySelectorAll('button').length).toBeLessThan(20);
+ });
+ it.each(['input', 'textarea'])('leaves select-all in an editable %s alone', async tag => {
+ await act(async () => root.render(<Fixture />));
+ await flushFrames();
+ const input = host.appendChild(document.createElement(tag));
+ input.focus();
+ await act(async () => input.dispatchEvent(new KeyboardEvent('keydown', { key: 'a', ctrlKey: true, bubbles: true })));
+ expect(host.querySelectorAll('button').length).toBeLessThan(20);
+ });
+ it.each([false, true])('exposes offscreen controls before Tab enters from outside (reverse: %s), then releases on exit', async shiftKey => {
+ vi.useFakeTimers();
+ await act(async () => root.render(<Fixture restore />));
+ const outside = host.appendChild(document.createElement('input'));
+ outside.focus();
+ expect(row(0).querySelector('button')).toBeNull();
+ await act(async () => {
+ outside.dispatchEvent(new KeyboardEvent('keydown', { key: 'Tab', shiftKey, bubbles: true }));
+ // Assert during keydown, before the browser chooses its default target.
+ expect(row(0).querySelector('button')).not.toBeNull();
+ row(0).querySelector('button')!.focus();
+ vi.runOnlyPendingTimers();
+ });
+ expect(host.querySelectorAll('button')).toHaveLength(80);
+ await act(async () => { outside.focus(); vi.runOnlyPendingTimers(); });
+ expect(host.querySelectorAll('button').length).toBeLessThan(20);
+ // The row that was actually used keeps its state; untouched rows can unmount.
+ expect(row(0).querySelector('button')).not.toBeNull();
+ expect(row(1).hasAttribute('data-message-placeholder')).toBe(true);
+ });
+ it('releases a prevented external Tab that leaves focus outside the messages', async () => {
+ vi.useFakeTimers();
+ await act(async () => root.render(<Fixture restore />));
+ const outside = host.appendChild(document.createElement('input'));
+ outside.focus();
+ outside.addEventListener('keydown', event => event.preventDefault());
+ await act(async () => outside.dispatchEvent(new KeyboardEvent('keydown', { key: 'Tab', bubbles: true, cancelable: true })));
+ await act(async () => vi.runOnlyPendingTimers());
+ expect(host.querySelectorAll('button').length).toBeLessThan(20);
+ });
+ it('releases select-all on selection collapse without moving the reading anchor', async () => {
+ vi.useFakeTimers();
+ await act(async () => root.render(<Fixture restore />));
+ const before = row(40).getBoundingClientRect().top;
+ await act(async () => {
+ document.body.dispatchEvent(new KeyboardEvent('keydown', { key: 'a', ctrlKey: true, bubbles: true }));
+ const range = document.createRange(); range.selectNodeContents(scroller());
+ document.getSelection()!.addRange(range);
+ document.dispatchEvent(new Event('selectionchange'));
+ vi.runOnlyPendingTimers();
+ });
+ expect(host.querySelectorAll('button')).toHaveLength(80);
+ await act(async () => { document.getSelection()!.removeAllRanges(); document.dispatchEvent(new Event('selectionchange')); });
+ expect(host.querySelectorAll('button').length).toBeLessThan(20);
+ expect(row(40).getBoundingClientRect().top).toBe(before);
+ });
+ it('preserves selections starting outside the stream and releases when they move outside', async () => {
+ await act(async () => root.render(<Fixture restore />));
+ const outside = document.createElement('span'); outside.textContent = 'Outside'; host.prepend(outside);
+ await act(async () => {
+ const range = document.createRange(); range.setStart(outside.firstChild!, 0); range.setEndAfter(row(40));
+ document.getSelection()!.addRange(range); document.dispatchEvent(new Event('selectionchange'));
+ });
+ expect(host.querySelectorAll('button')).toHaveLength(80);
+ await act(async () => {
+ const range = document.createRange(); range.selectNodeContents(outside);
+ document.getSelection()!.removeAllRanges(); document.getSelection()!.addRange(range);
+ document.dispatchEvent(new Event('selectionchange'));
+ });
+ expect(host.querySelectorAll('button').length).toBeLessThan(20);
+ });
+ it('keeps page-text access active when a selection ends, then releases independently', async () => {
+ await act(async () => root.render(<Fixture restore />));
+ let release = () => {};
+ try {
+ await act(async () => { release = acquirePageTextAccess(); });
+ await act(async () => document.dispatchEvent(new Event('selectionchange')));
+ expect(host.querySelectorAll('button')).toHaveLength(80);
+ await act(async () => release());
+ expect(host.querySelectorAll('button').length).toBeLessThan(20);
+ } finally { await act(async () => release()); }
+ });
+ it('mounts the bottom viewport and preserves full row geometry on first paint', async () => {
+ await act(async () => root.render(<Fixture />));
+ expect(host.querySelectorAll('button').length).toBeLessThan(20);
+ expect(row(79).querySelector('button')).not.toBeNull();
+ expect(scroller().scrollHeight - scroller().scrollTop - 600).toBeLessThan(1);
+ });
+ it('mounts rows reached by a large scroll and remembers heights when they leave', async () => {
+ await act(async () => root.render(<Fixture />));
+ await act(async () => { scroller().dispatchEvent(new WheelEvent('wheel', { bubbles: true })); scroller().scrollTop = 0; scroller().dispatchEvent(new Event('scroll')); });
+ // The destination must exist before another animation frame is allowed.
+ // Otherwise fast wheel/scrollbar input can paint a viewport of placeholders.
+ expect(row(0).querySelector('button')).not.toBeNull();
+ await flushFrames();
+ expect(row(0).querySelector('button')).not.toBeNull();
+ expect(scroller().scrollTop).toBe(0);
+ expect(row(77).hasAttribute('data-message-placeholder')).toBe(true);
+ expect(row(77).style.height).toBe('180px');
+ expect(row(79).querySelector('button')).not.toBeNull();
+ });
+ it('starts around a restored reading anchor with remembered row heights', async () => {
+ await act(async () => root.render(<Fixture restore />));
+ await flushFrames();
+ expect(row(40).querySelector('button')).not.toBeNull();
+ expect(row(40).getBoundingClientRect().top).toBe(0);
+ expect(row(0).style.height).toBe('180px');
+ expect(host.querySelectorAll('button').length).toBeLessThan(20);
+ });
+ it('commits a programmatic jump before the browser has dispatched its scroll event', async () => {
+ await act(async () => root.render(<Fixture restore />));
+ await act(async () => {
+ scroller().scrollTop = 1800;
+ syncViewport();
+ expect(row(10).querySelector('button')).not.toBeNull();
+ });
+ expect(row(10).getBoundingClientRect().top).toBe(0);
+ });
+ it('mounts a direct animation-frame write at its microtask checkpoint without a scroll event', async () => {
+ await act(async () => root.render(<Fixture restore />));
+ await flushFrames();
+ expect(row(10).querySelector('button')).toBeNull();
+ await act(async () => {
+ requestAnimationFrame(() => { scroller().scrollTop = 1800; });
+ const pending = [...frames.values()];
+ frames.clear();
+ pending.forEach(callback => callback(16));
+ await new Promise<void>(resolve => queueMicrotask(resolve));
+ // No scroll event or next animation frame has been delivered.
+ expect(row(10).querySelector('button')).not.toBeNull();
+ expect(row(10).getBoundingClientRect().top).toBe(0);
+ });
+ expect(host.querySelectorAll('button').length).toBeLessThan(20);
+ });
+ it('lets a new tail-follow intent supersede a queued reading anchor', async () => {
+ await act(async () => root.render(<Fixture restore />));
+ await act(async () => {
+ scroller().scrollTop = 1800;
+ reconcileViewport();
+ setFollowing(true);
+ scroller().scrollTop = scroller().scrollHeight;
+ });
+ expect(scroller().scrollHeight - scroller().scrollTop - viewportHeight).toBe(0);
+ expect(row(78).querySelector('button')).not.toBeNull();
+ });
+ it('preserves a script jump away from the tail before scroll can clear the old follow flag', async () => {
+ await act(async () => root.render(<Fixture />));
+ await flushFrames();
+ await act(async () => {
+ scroller().scrollTop = 0;
+ await new Promise<void>(resolve => queueMicrotask(resolve));
+ expect(scroller().scrollTop).toBe(0);
+ expect(row(0).querySelector('button')).not.toBeNull();
+ });
+ expect(host.querySelectorAll('button').length).toBeLessThan(20);
+ });
+ it('updates the owner before DOM observers can compensate toward a stale reading position', async () => {
+ let savedTop = 40 * 180;
+ const observeScroll = vi.fn(() => { savedTop = scroller().scrollTop; });
+ await act(async () => root.render(<Fixture restore onProgrammaticScroll={observeScroll} />));
+ await flushFrames();
+ // Model the owner's existing content-height compensator: a DOM replacement
+ // restores its last known reading point unless a scroll updated that point.
+ const compensator = new MutationObserver(() => {
+ if (scroller().scrollTop !== savedTop) scroller().scrollTop = savedTop;
+ });
+ compensator.observe(scroller(), { childList: true, subtree: true });
+ try {
+ await act(async () => {
+ scroller().scrollTop = 1800;
+ await new Promise<void>(resolve => queueMicrotask(resolve));
+ });
+ expect(observeScroll).toHaveBeenCalled();
+ expect(scroller().scrollTop).toBe(1800);
+ expect(row(10).querySelector('button')).not.toBeNull();
+ } finally { compensator.disconnect(); }
+ });
+ it('does not rewrite an already aligned position when the mounted range changes', async () => {
+ await act(async () => root.render(<Fixture restore />));
+ await act(async () => {
+ scroller().scrollTop = 1800;
+ scrollWrites.length = 0;
+ scroller().dispatchEvent(new Event('scroll'));
+ });
+ await flushFrames();
+ expect(row(10).querySelector('button')).not.toBeNull();
+ expect(scrollWrites).toEqual([]);
+ });
+ it('compensates the first scroll even when the initial mounted range already fits', async () => {
+ viewportHeight = 1100;
+ await act(async () => root.render(<Fixture />));
+ expect(host.querySelectorAll('button').length).toBe(10);
+ await act(async () => {
+ scroller().dispatchEvent(new WheelEvent('wheel', { bubbles: true }));
+ scroller().scrollTop = 50 * 240 + 30;
+ scroller().dispatchEvent(new Event('scroll'));
+ });
+ await flushFrames();
+ expect(row(50).querySelector('button')).not.toBeNull();
+ expect(row(50).getBoundingClientRect().top).toBe(-30);
+ });
+ it('retains an interacted row after scrolling away', async () => {
+ await act(async () => root.render(<Fixture />));
+ await act(async () => row(77).querySelector('button')!.dispatchEvent(new Event('pointerdown', { bubbles: true })));
+ await act(async () => { scroller().dispatchEvent(new WheelEvent('wheel', { bubbles: true })); scroller().scrollTop = 0; scroller().dispatchEvent(new Event('scroll')); });
+ await flushFrames();
+ expect(row(77).querySelector('button')).not.toBeNull();
+ });
+ it('exposes loaded rows for sharing and keyboard selection', async () => {
+ vi.useFakeTimers();
+ await act(async () => root.render(<Fixture disabled />));
+ expect(host.querySelectorAll('button').length).toBe(80);
+ await act(async () => root.render(<Fixture />));
+ await act(async () => scroller().dispatchEvent(new KeyboardEvent('keydown', { key: 'a', ctrlKey: true, bubbles: true })));
+ expect(host.querySelectorAll('button').length).toBe(80);
+ });
+});
diff --git a/apps/desktop/src/renderer/__tests__/observeProgrammaticScroll.test.ts b/apps/desktop/src/renderer/__tests__/observeProgrammaticScroll.test.ts
new file mode 100644
index 0000000000..13fa66debf
--- /dev/null
+++ b/apps/desktop/src/renderer/__tests__/observeProgrammaticScroll.test.ts
@@ -0,0 +1,89 @@
+/** @vitest-environment jsdom */
+import { describe, expect, it, vi } from 'vitest';
+import { observeProgrammaticScroll } from '../components/chat/observeProgrammaticScroll';
+
+const checkpoint = () => new Promise<void>(resolve => queueMicrotask(resolve));
+
+describe('owned scroll container write observation', () => {
+ it('batches changed writes after the caller finishes without modifying the DOM prototype', async () => {
+ const element = document.createElement('div');
+ const other = document.createElement('div');
+ const prototype = Object.getOwnPropertyDescriptor(Element.prototype, 'scrollTop');
+ const onChange = vi.fn();
+ const stop = observeProgrammaticScroll(element, onChange);
+ element.scrollTop = 100;
+ element.scrollTop = 200;
+ other.scrollTop = 300;
+ expect(onChange).not.toHaveBeenCalled();
+ await checkpoint();
+ expect(onChange).toHaveBeenCalledTimes(1);
+ expect(element.scrollTop).toBe(200);
+ expect(Object.getOwnPropertyDescriptor(Element.prototype, 'scrollTop')).toEqual(prototype);
+ expect(Object.hasOwn(other, 'scrollTop')).toBe(false);
+ stop();
+ expect(Object.hasOwn(element, 'scrollTop')).toBe(false);
+ });
+
+ it('preserves native clamping and still calls the setter for unchanged positions', async () => {
+ const element = document.createElement('div');
+ let top = 0;
+ const write = vi.fn((value: number) => { top = Math.max(0, Math.min(500, value)); });
+ const original = { configurable: true, enumerable: false, get: () => top, set: write };
+ Object.defineProperty(element, 'scrollTop', original);
+ const onChange = vi.fn();
+ const stop = observeProgrammaticScroll(element, onChange);
+ element.scrollTop = 800;
+ await checkpoint();
+ expect(element.scrollTop).toBe(500);
+ expect(onChange).toHaveBeenCalledTimes(1);
+ element.scrollTop = 900;
+ await checkpoint();
+ // An unchanged write can cancel a native smooth scroll, so it must not be elided.
+ expect(write).toHaveBeenCalledTimes(2);
+ expect(onChange).toHaveBeenCalledTimes(1);
+ stop();
+ expect(Object.getOwnPropertyDescriptor(element, 'scrollTop')).toEqual(original);
+ });
+
+ it('cancels pending work on cleanup and can observe the same element again', async () => {
+ const element = document.createElement('div');
+ const first = vi.fn();
+ const stop = observeProgrammaticScroll(element, first);
+ element.scrollTop = 100;
+ stop();
+ const next = vi.fn();
+ const stopNext = observeProgrammaticScroll(element, next);
+ element.scrollTop = 200;
+ await checkpoint();
+ expect(first).not.toHaveBeenCalled();
+ expect(next).toHaveBeenCalledTimes(1);
+ stopNext();
+ });
+
+ it('does not clobber a later owner and leaves its saved setter functional after cleanup', async () => {
+ const element = document.createElement('div');
+ const onChange = vi.fn();
+ const stop = observeProgrammaticScroll(element, onChange);
+ const observed = Object.getOwnPropertyDescriptor(element, 'scrollTop')!;
+ const later = { ...observed, set(value: number) { observed.set!.call(element, value); } };
+ Object.defineProperty(element, 'scrollTop', later);
+ stop();
+ element.scrollTop = 100;
+ await checkpoint();
+ expect(element.scrollTop).toBe(100);
+ expect(onChange).not.toHaveBeenCalled();
+ expect(Object.getOwnPropertyDescriptor(element, 'scrollTop')).toEqual(later);
+ });
+
+ it('leaves a non-configurable property intact', async () => {
+ const element = document.createElement('div');
+ Object.defineProperty(element, 'scrollTop', { configurable: false, value: 10, writable: true });
+ const onChange = vi.fn();
+ const stop = observeProgrammaticScroll(element, onChange);
+ element.scrollTop = 20;
+ await checkpoint();
+ stop();
+ expect(element.scrollTop).toBe(20);
+ expect(onChange).not.toHaveBeenCalled();
+ });
+});
diff --git a/apps/desktop/src/renderer/__tests__/previousQuestionPlaceholder.test.tsx b/apps/desktop/src/renderer/__tests__/previousQuestionPlaceholder.test.tsx
new file mode 100644
index 0000000000..f9c7fcddd0
--- /dev/null
+++ b/apps/desktop/src/renderer/__tests__/previousQuestionPlaceholder.test.tsx
@@ -0,0 +1,70 @@
+/** @vitest-environment jsdom */
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import React, { act, useRef } from 'react';
+import { createRoot } from 'react-dom/client';
+import ts from 'typescript';
+import { expect, it, vi } from 'vitest';
+import { usePrevUserMessageInView } from '../components/chat/usePrevUserMessageInView';
+
+// Render the actual placeholder expression: the navigation hook and click handler
+// must find a user message even while its body is outside the mounted viewport.
+const source = ts.createSourceFile('MessageStream.tsx', readFileSync(
+ resolve(__dirname, '../components/chat/MessageStream.tsx'), 'utf8',
+), ts.ScriptTarget.Latest, true, ts.ScriptKind.TSX);
+let expression = '';
+function visit(node: ts.Node) {
+ if (ts.isJsxSelfClosingElement(node) && node.attributes.properties.some(
+ p => ts.isJsxAttribute(p) && p.name.getText(source) === 'data-message-placeholder',
+ )) expression = node.getText(source);
+ ts.forEachChild(node, visit);
+}
+visit(source);
+const renderPlaceholder = new Function('React', 'item', 'messageViewport', ts.transpileModule(
+ `return (${expression});`, { compilerOptions: { jsx: ts.JsxEmit.React, target: ts.ScriptTarget.ES2022 } },
+).outputText);
+
+it('finds an offscreen question through its real placeholder, without mounting its body', async () => {
+ (globalThis as { IS_REACT_ACT_ENVIRONMENT?: boolean }).IS_REACT_ACT_ENVIRONMENT = true;
+ const frames = new Map<number, FrameRequestCallback>();
+ let sequence = 0;
+ vi.stubGlobal('requestAnimationFrame', (cb: FrameRequestCallback) => { frames.set(++sequence, cb); return sequence; });
+ vi.stubGlobal('cancelAnimationFrame', (id: number) => frames.delete(id));
+ vi.stubGlobal('ResizeObserver', class { observe() {} disconnect() {} });
+ vi.stubGlobal('CSS', { escape: (s: string) => s });
+ vi.spyOn(HTMLElement.prototype, 'getBoundingClientRect').mockImplementation(function (this: HTMLElement) {
+ const top = this.hasAttribute('data-message-placeholder') ? -300 : 0;
+ return { top, bottom: top + 100, height: 100 } as DOMRect;
+ });
+ const host = document.body.appendChild(document.createElement('div'));
+ const root = createRoot(host);
+ let target: string | null = null;
+ function Fixture() {
+ const scrollRef = useRef<HTMLDivElement>(null);
+ target = usePrevUserMessageInView({ scrollRef, userMessageIds: ['question'], resetKey: 'test' }).displayId;
+ return <div ref={scrollRef}>{renderPlaceholder(React,
+ { key: 'msg-question', type: 'message', message: { clientId: 'question', role: 'user' } },
+ { placeholderHeight: () => 100 },
+ )}</div>;
+ }
+ try {
+ await act(async () => root.render(<Fixture />));
+ await act(async () => { const callbacks = [...frames.values()]; frames.clear(); callbacks.forEach(cb => cb(16)); });
+ expect(target).toBe('question');
+ const placeholder = host.querySelector('[data-user-msg-id="question"]');
+ expect(placeholder?.hasAttribute('data-message-placeholder')).toBe(true);
+ expect(placeholder?.getAttribute('aria-hidden')).toBe('true');
+ expect(placeholder?.textContent).toBe('');
+ } finally {
+ await act(async () => root.unmount()); host.remove(); vi.restoreAllMocks(); vi.unstubAllGlobals();
+ }
+});
+
+it.each([
+ { clientId: 'assistant', role: 'assistant' },
+ { clientId: 'synthetic', role: 'user', isSyntheticTrigger: true },
+])('does not offer a question target for $clientId', message => {
+ const placeholder = renderPlaceholder(React, { key: message.clientId, type: 'message', message },
+ { placeholderHeight: () => 100 });
+ expect(placeholder.props['data-user-msg-id']).toBeUndefined();
+});
diff --git a/apps/desktop/src/renderer/__tests__/restoredScrollIndicator.test.tsx b/apps/desktop/src/renderer/__tests__/restoredScrollIndicator.test.tsx
new file mode 100644
index 0000000000..18b9268aed
--- /dev/null
+++ b/apps/desktop/src/renderer/__tests__/restoredScrollIndicator.test.tsx
@@ -0,0 +1,56 @@
+/** @vitest-environment jsdom */
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import ts from 'typescript';
+import { act, useRef, useState } from 'react';
+import { createRoot } from 'react-dom/client';
+import { describe, expect, it, vi } from 'vitest';
+
+// Run the production initializers and user-intent callback together. Restoring
+// history starts unfollowed; the callback deliberately no-ops when already so.
+// Testing either state in isolation would miss a permanently hidden indicator.
+const source = ts.createSourceFile('MessageStream.tsx', readFileSync(
+ resolve(__dirname, '../components/chat/MessageStream.tsx'), 'utf8',
+), ts.ScriptTarget.Latest, true, ts.ScriptKind.TSX);
+const component = source.statements.find((node): node is ts.FunctionDeclaration =>
+ ts.isFunctionDeclaration(node) && node.name?.text === 'MessageStream')!;
+const names = ['isNearBottomRef', '[isNearBottom, setIsNearBottom]', 'unpinAutoFollowForUserUpIntent'];
+const statements = names.map(name => component.body!.statements.find(node => ts.isVariableStatement(node)
+ && node.declarationList.declarations.some(d => d.name.getText(source) === name))!);
+const code = ts.transpileModule(statements.map(s => s.getText(source)).join('\n')
+ + '\nreturn { isNearBottom, isNearBottomRef, unpinAutoFollowForUserUpIntent };', {
+ compilerOptions: { target: ts.ScriptTarget.ES2022 },
+}).outputText;
+
+describe('restored history indicator', () => {
+ it.each([true, false])('keeps the UI and follow intent aligned when restoring=%s', async (restoring) => {
+ (globalThis as { IS_REACT_ACT_ENVIRONMENT?: boolean }).IS_REACT_ACT_ENVIRONMENT = true;
+ const host = document.body.appendChild(document.createElement('div'));
+ const root = createRoot(host);
+ let unpin: () => void = () => {};
+ let following = true;
+ function Fixture() {
+ const restoringRef = useRef(restoring);
+ const bindings = { useRef, useState, restoringRef, sessionId: 'history',
+ useCallback: (callback: () => void) => callback, bumpSendFollowCancelGeneration: vi.fn() };
+ const state = new Function(...Object.keys(bindings), code)(...Object.values(bindings));
+ following = state.isNearBottomRef.current;
+ unpin = state.unpinAutoFollowForUserUpIntent;
+ return <button hidden={state.isNearBottom}>Return to latest</button>;
+ }
+ try {
+ await act(async () => root.render(<Fixture />));
+ expect(following).toBe(!restoring);
+ expect(host.querySelector('button')!.hidden).toBe(!restoring);
+ await act(async () => unpin());
+ expect(following).toBe(false);
+ expect(host.querySelector('button')!.hidden).toBe(false);
+ // Repeated manual input must not be needed to repair an initialization mismatch.
+ await act(async () => unpin());
+ expect(host.querySelector('button')!.hidden).toBe(false);
+ } finally {
+ await act(async () => root.unmount());
+ host.remove();
+ }
+ });
+});
diff --git a/apps/desktop/src/renderer/__tests__/scrollRangeIntoView.test.ts b/apps/desktop/src/renderer/__tests__/scrollRangeIntoView.test.ts
new file mode 100644
index 0000000000..710d625021
--- /dev/null
+++ b/apps/desktop/src/renderer/__tests__/scrollRangeIntoView.test.ts
@@ -0,0 +1,29 @@
+/** @vitest-environment jsdom */
+import { afterEach, expect, it, vi } from 'vitest';
+import { scrollRangeIntoView } from '../lib/scrollRangeIntoView';
+afterEach(() => { document.body.replaceChildren(); vi.restoreAllMocks(); });
+
+it('reveals matches on both axes inside nested scrollers without moving the owning message list', () => {
+ document.body.innerHTML = '<div id="owner"><div id="vertical"><pre id="horizontal">needle</pre></div></div>';
+ const owner = document.getElementById('owner')!;
+ const vertical = document.getElementById('vertical')!;
+ const horizontal = document.getElementById('horizontal')!;
+ const box = (top: number, left: number) => ({ top, bottom: top + 20, left, right: left + 40, width: 40, height: 20 }) as DOMRect;
+ for (const element of [owner, vertical, horizontal]) {
+ element.style.overflowY = 'auto'; element.style.overflowX = 'auto';
+ for (const [key, value] of Object.entries({ scrollHeight: 1000, scrollWidth: 1000, clientHeight: 100, clientWidth: 100 }))
+ Object.defineProperty(element, key, { value });
+ vi.spyOn(element, 'getBoundingClientRect').mockReturnValue({ top: 0, bottom: 100, left: 0, right: 100 } as DOMRect);
+ }
+ horizontal.style.overflowY = 'visible'; vertical.style.overflowX = 'visible';
+ const range = document.createRange(); range.setStart(horizontal.firstChild!, 0); range.setEnd(horizontal.firstChild!, 6);
+ range.getClientRects = () => [box(600 - horizontal.scrollTop - vertical.scrollTop, 800 - horizontal.scrollLeft - vertical.scrollLeft)] as unknown as DOMRectList;
+ // The second wrapped fragment is wider than the first. Its right edge must
+ // also be exposed (the real Markdown table reproducer clipped it by ~2px).
+ range.getBoundingClientRect = () => ({ ...range.getClientRects()[0], right: 850 - horizontal.scrollLeft - vertical.scrollLeft }) as DOMRect;
+ const scrollWindow = vi.spyOn(window, 'scrollBy').mockImplementation(() => {});
+ scrollRangeIntoView(range, owner);
+ expect(horizontal.scrollLeft).toBe(750); expect(vertical.scrollTop).toBe(520);
+ expect(owner.scrollTop).toBe(0); expect(owner.scrollLeft).toBe(0);
+ expect(scrollWindow).not.toHaveBeenCalled();
+});
diff --git a/apps/desktop/src/renderer/__tests__/shareSelectionContainment.test.ts b/apps/desktop/src/renderer/__tests__/shareSelectionContainment.test.ts
index aa010f72bd..c9880910c8 100644
--- a/apps/desktop/src/renderer/__tests__/shareSelectionContainment.test.ts
+++ b/apps/desktop/src/renderer/__tests__/shareSelectionContainment.test.ts
@@ -31,11 +31,19 @@ describe('分享选择模式的消息布局隔离', () => {
);
});
- it('常态消息仍保留 content-visibility 性能优化', () => {
+ it('#5406: 常态消息也保持真实布局,避免 Blink AX 遍历跳过布局的文本', () => {
const rule = cssRuleBody('.msg-stream-items > *');
- expect(rule).toContain('content-visibility: auto;');
- expect(rule).toContain('contain-intrinsic-size: auto 240px;');
+ expect(rule).toContain('content-visibility: visible;');
+ expect(rule).toContain('contain-intrinsic-size: none;');
+ // Any later, more specific message-row rule must not restore the unsafe
+ // optimization (including ordinary assistant and nested Bot message rows).
+ globalsCss.walkRules((candidate) => {
+ if (!candidate.selector.includes('.msg-stream-items')) return;
+ candidate.walkDecls('content-visibility', (declaration) => {
+ expect(declaration.value).toBe('visible');
+ });
+ });
});
it.each([
diff --git a/apps/desktop/src/renderer/__tests__/tailWindowScrollLayout.test.ts b/apps/desktop/src/renderer/__tests__/tailWindowScrollLayout.test.ts
new file mode 100644
index 0000000000..7b99a9f32d
--- /dev/null
+++ b/apps/desktop/src/renderer/__tests__/tailWindowScrollLayout.test.ts
@@ -0,0 +1,84 @@
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import ts from 'typescript';
+import { describe, expect, it, vi } from 'vitest';
+import {
+ resolveNearBottomOnScroll, resolveEffectiveNearBottom,
+ shouldBumpSendFollowCancelOnScroll, shouldUnpinOnScrollbarDrag, shouldUnpinOnUpIntent,
+} from '../components/chat/autoFollowIntent';
+
+// Execute the actual scroll coordinator, including the order of follow-state
+// updates and window changes. Geometry-only scrolls occur when Ctrl+F / Ctrl+A
+// replace estimated placeholders with full text at an already-followed tail.
+const source = ts.createSourceFile('MessageStream.tsx', readFileSync(
+ resolve(__dirname, '../components/chat/MessageStream.tsx'), 'utf8',
+), ts.ScriptTarget.Latest, true, ts.ScriptKind.TSX);
+const component = source.statements.find((node): node is ts.FunctionDeclaration =>
+ ts.isFunctionDeclaration(node) && node.name?.text === 'MessageStream')!;
+const statement = component.body!.statements.find(node => ts.isVariableStatement(node)
+ && node.declarationList.declarations.some(d => d.name.getText(source) === 'handleScroll')) as ts.VariableStatement;
+const initializer = statement.declarationList.declarations[0].initializer as ts.CallExpression;
+const code = ts.transpileModule(`return (${initializer.arguments[0].getText(source)});`, {
+ compilerOptions: { target: ts.ScriptTarget.ES2022 },
+}).outputText;
+
+function fixture(following: boolean, delta: number, distance = 0, coversEnd = true) {
+ const setFirstVisibleItemKey = vi.fn();
+ const setAnchoredForwardItems = vi.fn();
+ const setUnreadCount = vi.fn();
+ const onLoadMore = vi.fn();
+ const expandWindow = vi.fn();
+ const isNearBottomRef = { current: following };
+ const bindings = {
+ scrollRef: { current: { scrollTop: 10_000, scrollHeight: 10_600 + distance, clientHeight: 600 } },
+ prevScrollTopRef: { current: 10_000 - delta },
+ isNearBottomRef, setIsNearBottom: vi.fn(), setUnreadCount,
+ restoringRef: { current: false }, scrollbarDragStartTopRef: { current: null },
+ programmaticScrollRef: { current: false }, isLoadingMore: false,
+ prevScrollHeightRef: { current: 0 }, saveRafRef: { current: 1 },
+ firstVisibleItemKey: 'msg-qa5406-340', windowCoversEnd: coversEnd,
+ setFirstVisibleItemKey, anchoredForwardItems: 160, setAnchoredForwardItems,
+ jumpDownIdleTimerRef: { current: null }, setShowJumpDown: vi.fn(),
+ window: { setTimeout: vi.fn(), clearTimeout: vi.fn() }, JUMP_DOWN_IDLE_MS: 1500,
+ SCROLL_DIRECTION_DEAD_ZONE_PX: 1, RENDER_WINDOW_GROWTH_ITEMS: 80,
+ TOP_HISTORY_TRIGGER_PX: 50, onLoadMore, expandWindow,
+ resolveNearBottomOnScroll, resolveEffectiveNearBottom,
+ shouldBumpSendFollowCancelOnScroll, shouldUnpinOnScrollbarDrag, shouldUnpinOnUpIntent,
+ bumpSendFollowCancelGeneration: vi.fn(), sessionId: 'restored-tail',
+ };
+ const scroll = new Function(...Object.keys(bindings), code)(...Object.values(bindings)) as () => void;
+ return { scroll, isNearBottomRef, setFirstVisibleItemKey, setAnchoredForwardItems, setUnreadCount, onLoadMore, expandWindow };
+}
+
+describe('tail window during layout scrolls', () => {
+ it.each([-1605, 0, 1605])('preserves the searchable window when text mounting changes scrollTop by %d', delta => {
+ const state = fixture(true, delta);
+ state.scroll();
+ expect(state.isNearBottomRef.current).toBe(true);
+ expect(state.setFirstVisibleItemKey).not.toHaveBeenCalled();
+ expect(state.setAnchoredForwardItems).not.toHaveBeenCalled();
+ expect(state.onLoadMore).not.toHaveBeenCalled();
+ expect(state.expandWindow).not.toHaveBeenCalled();
+ });
+ it('still returns to the default tail when the reader scrolls down to resume following', () => {
+ const state = fixture(false, 1605);
+ state.scroll();
+ expect(state.isNearBottomRef.current).toBe(true);
+ expect(state.setFirstVisibleItemKey).toHaveBeenCalledExactlyOnceWith(null);
+ expect(state.setUnreadCount).toHaveBeenCalledExactlyOnceWith(0);
+ });
+ it('does not shrink history when scrolling up close to the tail', () => {
+ const state = fixture(false, -40, 40);
+ state.scroll();
+ expect(state.isNearBottomRef.current).toBe(false);
+ expect(state.setFirstVisibleItemKey).not.toHaveBeenCalled();
+ });
+ it('still expands an intermediate history window by the existing 80 items', () => {
+ const state = fixture(false, 100, 20, false);
+ state.scroll();
+ expect(state.isNearBottomRef.current).toBe(false);
+ expect(state.setFirstVisibleItemKey).not.toHaveBeenCalled();
+ expect(state.setAnchoredForwardItems).toHaveBeenCalledExactlyOnceWith(240);
+ expect(state.onLoadMore).not.toHaveBeenCalled();
+ });
+});
diff --git a/apps/desktop/src/renderer/components/chat/MessageStream.tsx b/apps/desktop/src/renderer/components/chat/MessageStream.tsx
index 67f9cd9321..18bf778e7d 100644
--- a/apps/desktop/src/renderer/components/chat/MessageStream.tsx
+++ b/apps/desktop/src/renderer/components/chat/MessageStream.tsx
@@ -1,4 +1,8 @@
+import { scrollRangeIntoView } from '@/lib/scrollRangeIntoView';
+import { animateFocusScroll } from './animateFocusScroll';
import { simplifyBotRenderItems } from '@/features/bots/botConversationPresentation';
+import { MessageViewport, type MessageViewportApi } from './MessageViewport';
+import { PAGE_TEXT_NAVIGATION_EVENT } from '@/lib/pageTextAccess';
export { simplifyBotRenderItems } from '@/features/bots/botConversationPresentation';
import { placeBotTaskCardsAfterIntroduction } from '@cindy/maker-shared/botCollaboration';
import { describeToolUse, sourcePathCandidatesFromDescriptor } from '@cindy/maker-shared/tool-use-descriptor';
@@ -46,7 +50,7 @@ import {
} from '@/lib/makerChatStore';
import { isCindyMakeCompletionMessage, isCindyMakePreparationMessage } from '@/lib/cindyMakeComposer';
import { getDataOwnerGeneration } from '@/contexts/dataOwnerGeneration';
-import { createPortal } from 'react-dom';
+import { createPortal, flushSync } from 'react-dom';
import { GitFork } from 'lucide-react';
import { SelectionQuoteButton } from './SelectionQuoteButton';
import {
@@ -2881,9 +2885,13 @@ export function MessageStream({
keysAtJump: readonly string[];
messageClientIdsAtJump: readonly string[];
scrollGeneration: number;
+ settling?: boolean;
+ cancelAnimation?: () => void;
} | null>(null);
useEffect(
() => () => {
+ focusJumpRef.current?.cancelAnimation?.();
+ focusJumpRef.current = null;
if (focusScrollTimerRef.current !== null) {
window.clearTimeout(focusScrollTimerRef.current);
}
@@ -3000,6 +3008,7 @@ export function MessageStream({
const chunk = buildRenderItems([...rows], taskUpdates, ghostCardSnapshot, {
historyWindowIncomplete: true,
historyArtifacts,
+ turnChangeSets,
workingDir,
botSessionId: simplifiedBotConversation ? sessionId : undefined,
markdownImageTargetCache: markdownImageTargetCacheRef.current,
@@ -3232,6 +3241,20 @@ export function MessageStream({
// 镜像 ref:unmount cleanup / ResizeObserver / 落定回调里读最新值(闭包会 stale)。
const visibleRenderItemsRef = useRef(visibleRenderItems);
visibleRenderItemsRef.current = visibleRenderItems;
+ // Keep complex/stateful cards alive. Plain historical message bodies can be
+ // replaced by measured-height placeholders without browser display locking.
+ const viewportEntries = useMemo(() => visibleRenderItems.map(item => ({
+ key: item.key,
+ retain: item.type !== 'message' || item.message.isStreaming === true || Boolean(item.message.systemCardType) ||
+ (item.message.role !== 'user' && item.message.role !== 'assistant') ||
+ item.message.clientId === focusMessageClientId,
+ })), [visibleRenderItems, focusMessageClientId]);
+ const messageViewportRef = useRef<MessageViewportApi>(null);
+ // Child layout effects run before this ancestor's DOM ref attaches on mount.
+ // Connecting here schedules the initial measurement before the first paint.
+ useLayoutEffect(() => { messageViewportRef.current?.connect(); });
+ const syncMessageViewport = useCallback(() => messageViewportRef.current?.syncViewport(), []);
+ const reconcileMessageViewport = useCallback(() => messageViewportRef.current?.reconcileViewport(), []);
// 量出当前视口顶端 render-item;若它内部还有已渲染的子消息,再记实际跨过视口顶边
// 的 message clientId。折叠工作组 / 折叠工具块的聚合 data-message-client-ids 只给
// focus 回退用,不参与视口快照,避免把隐藏 child 当成活锚点。
@@ -3464,6 +3487,7 @@ export function MessageStream({
} = {}): boolean => {
const jump = focusJumpRef.current;
if (!jump) return false;
+ jump.cancelAnimation?.();
focusJumpRef.current = null;
if (focusScrollTimerRef.current !== null) {
window.clearTimeout(focusScrollTimerRef.current);
@@ -3473,7 +3497,7 @@ export function MessageStream({
window.clearTimeout(focusHighlightTimerRef.current);
focusHighlightTimerRef.current = null;
}
- // 只终止仍由这次 focus 拥有的原生 smooth 动画;过期 focus 不得打断后发滚动。
+ // 只终止仍由这次 focus 拥有的滚动;过期 focus 不得打断后发滚动。
if (jump.scrollGeneration === programmaticScrollGenerationRef.current) {
const root = scrollRef.current;
if (root) root.scrollTo({ top: root.scrollTop, behavior: 'auto' });
@@ -3486,15 +3510,17 @@ export function MessageStream({
},
[finishProgrammaticScroll, refreshViewportAnchor],
);
- // focus 跳转落定收尾(scrollend 主路径与兜底 timer 共用,幂等):途中布局变化
- // (删除 / 流式)会让 smooth 落点偏离目标,先瞬时校正回目标;目标在跳转途中被删时
+ // focus 跳转落定收尾(逐帧动画结束与兜底 timer 共用,幂等):动画已跟踪途中高度变化,
+ // 此处只处理最终布局与所有权交接;目标在跳转途中被删时
// 锚到跳转时序列中它之后第一条存活 item(与删除补偿同语义,落点在窗口外则走窗口
// 重建 + pending 复位);用户已接管则不校正。下一帧再清 programmatic 标记并刷新
// 删除前快照——半途量测会把跳变中的位置误存为锚点。
const settleFocusJump = useCallback(() => {
const jump = focusJumpRef.current;
- if (!jump) return;
- focusJumpRef.current = null;
+ if (!jump || jump.settling) return;
+ jump.cancelAnimation?.();
+ jump.cancelAnimation = undefined;
+ jump.settling = true;
if (focusScrollTimerRef.current !== null) {
window.clearTimeout(focusScrollTimerRef.current);
focusScrollTimerRef.current = null;
@@ -3503,7 +3529,10 @@ export function MessageStream({
window.clearTimeout(focusHighlightTimerRef.current);
focusHighlightTimerRef.current = null;
}
- if (jump.scrollGeneration !== programmaticScrollGenerationRef.current) return;
+ if (jump.scrollGeneration !== programmaticScrollGenerationRef.current) {
+ focusJumpRef.current = null;
+ return;
+ }
// settle 前已观察到的删除由当前目标校正消费;同帧后续删除仍走通用重放。
deferredDeleteCompensationRef.current = false;
// 邻居锚定分支会显式写入快照(窗口重建的 DOM 下一提交才就绪),此时不得再用
@@ -3516,6 +3545,7 @@ export function MessageStream({
const target = queryFocusElement(root, jump.clientId);
if (target) {
target.scrollIntoView({ block: 'center' });
+ syncMessageViewport();
const measured = refreshViewportAnchor();
const rootTop = root.getBoundingClientRect().top;
const targetRect = target.getBoundingClientRect();
@@ -3574,13 +3604,32 @@ export function MessageStream({
}
}
}
- requestAnimationFrame(() => {
- const activeJump = focusJumpRef.current;
- if (activeJump && activeJump.requestKey !== jump.requestKey) return;
+ let stableFrames = 0;
+ let frames = 0;
+ const finishAfterLayout = () => {
+ if (focusJumpRef.current !== jump) return;
+ if (!snapshotPinned && jump.scrollGeneration === programmaticScrollGenerationRef.current && root) {
+ const target = queryFocusElement(root, jump.clientId);
+ if (target) {
+ const before = root.scrollTop;
+ target.scrollIntoView({ block: 'center' });
+ syncMessageViewport();
+ stableFrames = Math.abs(root.scrollTop - before) <= 1 ? stableFrames + 1 : 0;
+ // A native height/scroll update can arrive after the first scrollend.
+ // Keep ownership while checking consecutive paints, and respect user
+ // cancellation/replacement on every frame. Bound live-stream settling.
+ if (++frames < 8 && stableFrames < 3) {
+ requestAnimationFrame(finishAfterLayout);
+ return;
+ }
+ }
+ }
+ focusJumpRef.current = null;
const replayingDelete = finishProgrammaticScroll(jump.scrollGeneration);
if (!snapshotPinned && replayingDelete === false) refreshViewportAnchor();
- });
- }, [finishProgrammaticScroll, refreshViewportAnchor, restoreViewportSnapshotOrRebuildWindow]);
+ };
+ requestAnimationFrame(finishAfterLayout);
+ }, [finishProgrammaticScroll, refreshViewportAnchor, restoreViewportSnapshotOrRebuildWindow, syncMessageViewport]);
// 接管 / 落定监听挂载级注册一次,读 focusJumpRef 判定,无活跃跳转时空转。挂在下面
// 的 reactive effect 里会被流式重渲染的 cleanup 拆掉且早退分支不再重挂,导致接管
// 失灵、兜底 timer 落定时把用户拽回目标。
@@ -3600,13 +3649,23 @@ export function MessageStream({
if (isEditableKeyboardTarget(event.target)) return;
onUserInput();
};
- const onScrollEnd = () => settleFocusJump();
+ let disposed = false;
+ const onScrollEnd = () => {
+ const jump = focusJumpRef.current;
+ if (!jump || jump.cancelAnimation) return;
+ // Per-frame writes also emit scrollend. The live-target animation owns
+ // completion until it releases its handle; then drain pending layout.
+ requestAnimationFrame(() => requestAnimationFrame(() => {
+ if (!disposed && focusJumpRef.current === jump) settleFocusJump();
+ }));
+ };
root.addEventListener('wheel', onUserInput, { passive: true });
root.addEventListener('touchstart', onUserInput, { passive: true });
root.addEventListener('mousedown', onUserInput);
window.addEventListener('keydown', onNavigationKey);
root.addEventListener('scrollend', onScrollEnd);
return () => {
+ disposed = true;
root.removeEventListener('wheel', onUserInput);
root.removeEventListener('touchstart', onUserInput);
root.removeEventListener('mousedown', onUserInput);
@@ -3652,6 +3711,11 @@ export function MessageStream({
return;
}
lastMissingFocusRef.current = null;
+ // A search owns the reading position even while rebuilding its window.
+ // Otherwise a newly clamped history window can be mistaken for tail follow.
+ restoringRef.current = false;
+ isNearBottomRef.current = false;
+ setIsNearBottom(false);
if (!visibleRenderItems.some((item) => item.key === targetKey)) {
setFirstVisibleItemKey(targetKey);
setAnchoredForwardItems(RENDER_WINDOW_FIRST_PAINT_ITEMS);
@@ -3661,12 +3725,8 @@ export function MessageStream({
if (!root) return;
const el = queryFocusElement(root, focusMessageClientId);
if (!el) return;
- restoringRef.current = false;
- isNearBottomRef.current = false;
- setIsNearBottom(false);
const scrollGeneration = beginProgrammaticScroll();
- // 新跳直接覆盖未落定的旧跳(用户快速连点两条结果):旧跳转态被替换,旧兜底
- // timer 一并重设,浏览器的旧 smooth 动画由新 scrollIntoView 接管。
+ // 新请求已取消旧动画;保留目标身份与删除前快照,直到逐帧动画完成。
focusJumpRef.current = {
requestKey: focusRequestKey,
clientId: focusMessageClientId,
@@ -3675,7 +3735,17 @@ export function MessageStream({
messageClientIdsAtJump: collectDeleteAnchorClientIds(allRenderItems),
scrollGeneration,
};
- el.scrollIntoView({ behavior: 'smooth', block: 'center' });
+ const jump = focusJumpRef.current;
+ jump.cancelAnimation = animateFocusScroll({
+ root,
+ getTarget: () => queryFocusElement(root, jump.clientId),
+ reconcile: syncMessageViewport,
+ onFinish: () => {
+ if (focusJumpRef.current !== jump) return;
+ jump.cancelAnimation = undefined;
+ settleFocusJump();
+ },
+ });
lastAppliedFocusRef.current = focusRequestKey;
if (focusScrollTimerRef.current !== null) {
window.clearTimeout(focusScrollTimerRef.current);
@@ -3683,11 +3753,10 @@ export function MessageStream({
if (focusHighlightTimerRef.current !== null) {
window.clearTimeout(focusHighlightTimerRef.current);
}
- // 落定主路径是挂载级 scrollend 监听;有 scrollend 时兜底只是安全网(长距离
- // smooth 常 >800ms,给足 2.5s),无 scrollend 的环境用 800ms 近似落定。
+ // 动画主动完成;timer 仅作为安全网,不依赖原生 scrollend 的到达时机。
focusScrollTimerRef.current = window.setTimeout(
settleFocusJump,
- 'onscrollend' in window ? 2500 : 800,
+ 2500,
);
// 高亮等落定后再点亮(落定回调里做),点亮后不再自动淡出——停在搜索命中处,直到
// 下次跳转覆盖或切会话。scrollend 未触发(距离为 0 / 环境不支持)时 ~600ms 兜底。
@@ -3703,6 +3772,7 @@ export function MessageStream({
beginProgrammaticScroll,
cancelFocusJump,
settleFocusJump,
+ syncMessageViewport,
]);
// 会话内全部图片的有序 src(全量,来自未裁剪的 allRenderItems),下发给
@@ -3826,7 +3896,10 @@ export function MessageStream({
// 锚定窗向下扩到真正盖住尾部,且用户已经贴在当前窗口底 → 切回默认尾窗并
// 恢复跟随。扩窗发生在本次 scroll 之后,同一帧的 handleScroll 还看不到
// windowCoversEnd=true,没有下一次滚动时会永远停在「已到底、但不跟」。
- if (!restoringRef.current && !wasCovering && windowCoversEnd && firstVisibleItemKey !== null) {
+ if (
+ !restoringRef.current && !programmaticScrollRef.current &&
+ !wasCovering && windowCoversEnd && firstVisibleItemKey !== null
+ ) {
const el = scrollRef.current;
if (!el) return;
const distanceFromBottom = el.scrollHeight - el.scrollTop - el.clientHeight;
@@ -4226,7 +4299,9 @@ export function MessageStream({
// 显隐(两者同步更新,任何路径都不允许只更新其中一个)。
// `unreadCount` 在"已离底 + 新 assistant/ask_user/plan_review 消息到达"时递增,
// 点击按钮 / 自动回底 / 切换会话 → 归零。
- const [isNearBottom, setIsNearBottom] = useState<boolean>(true);
+ // Restored history starts unfollowed. Initialize the indicator from the same
+ // snapshot as the scroll gate: later input may correctly leave false unchanged.
+ const [isNearBottom, setIsNearBottom] = useState<boolean>(() => isNearBottomRef.current);
const [unreadCount, setUnreadCount] = useState<number>(0);
// Only the rendered tail of a canonical Bot chat acknowledges replies. History
// navigation, background windows and streaming work never move its read position.
@@ -4443,12 +4518,41 @@ export function MessageStream({
},
[beginProgrammaticScroll, settleChipJump],
);
+ useEffect(() => {
+ const root = scrollRef.current;
+ if (!root) return;
+ const navigateText = (event: Event) => {
+ const range = (event as CustomEvent<Range>).detail;
+ const element = range?.startContainer?.parentElement?.closest<HTMLElement>('[data-message-client-id]');
+ const clientId = element?.dataset.messageClientId;
+ if (!element || !clientId || !root.contains(element)) return;
+ event.preventDefault();
+ cancelFocusJump({ consumeDeferredDelete: true });
+ unpinAutoFollowForUserUpIntent();
+ // Keep the exact text below the find bar. Reuse message navigation's
+ // ownership, cancellation and settling, so reaching the oldest loaded
+ // row is not misread as user intent to fetch another history page.
+ scrollRangeIntoView(range, root);
+ const topOffset = Math.min(80, root.clientHeight / 3)
+ - (range.getBoundingClientRect().top - element.getBoundingClientRect().top);
+ beginChipJump({ clientId, selector: 'message', topOffset });
+ root.scrollTop = resolveChipJumpTargetScrollTop({
+ scrollTop: root.scrollTop, containerTop: root.getBoundingClientRect().top,
+ targetTop: element.getBoundingClientRect().top, topOffset,
+ });
+ syncMessageViewport();
+ };
+ root.addEventListener(PAGE_TEXT_NAVIGATION_EVENT, navigateText);
+ return () => root.removeEventListener(PAGE_TEXT_NAVIGATION_EVENT, navigateText);
+ }, [beginChipJump, cancelFocusJump, syncMessageViewport, unpinAutoFollowForUserUpIntent]);
useEffect(() => {
const root = scrollRef.current;
if (!root) return;
const onScrollEnd = () => {
settleChipJump();
- if (chipJumpGenerationRef.current !== null) return;
+ // Each navigation owner finishes its own generation after correcting its
+ // target. Generic scrollend must not invalidate a pending focus settle.
+ if (chipJumpGenerationRef.current !== null || focusJumpRef.current !== null) return;
if (!programmaticScrollRef.current) return;
const generation = programmaticScrollGenerationRef.current;
if (finishProgrammaticScroll(generation) === false) refreshViewportAnchor(true);
@@ -4696,7 +4800,7 @@ export function MessageStream({
]);
useNavigationKeyListener(clearChipJumpSuppression, ownsHardwareScrollActions);
- const pinToBottom = useCallback(() => {
+ const pinToBottom = useCallback((fromLayout = false) => {
const el = scrollRef.current;
if (!el) return;
// 滚动条拖拽中不要钉回,否则滑块上移会被下一帧 pin 吃掉。
@@ -4704,6 +4808,10 @@ export function MessageStream({
const generation = beginProgrammaticScroll();
suppressScrollbarActivation(el);
el.scrollTop = el.scrollHeight;
+ // Layout effects already flush their state updates before paint. Observer
+ // and input callbacks need an explicit commit before the next scroll event.
+ if (fromLayout) reconcileMessageViewport();
+ else syncMessageViewport();
// Clear the flag on the next frame — after the browser has dispatched
// the resulting scroll event. We use rAF (not a microtask) because the
// scroll event is dispatched asynchronously.
@@ -4712,7 +4820,7 @@ export function MessageStream({
refreshViewportAnchor();
}
});
- }, [beginProgrammaticScroll, finishProgrammaticScroll, refreshViewportAnchor]);
+ }, [beginProgrammaticScroll, finishProgrammaticScroll, refreshViewportAnchor, reconcileMessageViewport, syncMessageViewport]);
pinToBottomRef.current = pinToBottom;
// Composer send is an explicit "show me the result" intent. Don't wait for
@@ -4733,7 +4841,7 @@ export function MessageStream({
isNearBottomRef.current = true;
setIsNearBottom(true);
setUnreadCount(0);
- pinToBottom();
+ pinToBottom(true);
}, [cancelFocusJump, finishChipJump, followLatestRequestKey, pinToBottom]);
// F3: 平滑滚到底的按钮回调。
@@ -4756,8 +4864,9 @@ export function MessageStream({
isNearBottomRef.current = true;
const generation = beginProgrammaticScroll();
// render-window-bidirectional: 清除锚点回到默认尾部窗口(chip/jump-down 语义)。
- setFirstVisibleItemKey(null);
+ flushSync(() => setFirstVisibleItemKey(null));
el.scrollTo({ top: el.scrollHeight, behavior: 'smooth' });
+ syncMessageViewport();
window.setTimeout(() => {
if (finishProgrammaticScroll(generation) === false) refreshViewportAnchor();
}, CHIP_JUMP_SAFETY_MS);
@@ -4767,6 +4876,7 @@ export function MessageStream({
finishChipJump,
finishProgrammaticScroll,
refreshViewportAnchor,
+ syncMessageViewport,
]);
// ── Codex Micro 摇杆:按住持续滚动 ──
@@ -4812,6 +4922,7 @@ export function MessageStream({
} else {
el.scrollTop += delta;
}
+ syncMessageViewport();
joystickScrollFrameRef.current = requestAnimationFrame(step);
};
joystickScrollFrameRef.current = requestAnimationFrame(step);
@@ -4844,6 +4955,7 @@ export function MessageStream({
scrollToBottomSmooth,
stopJoystickScroll,
unpinAutoFollowForUserUpIntent,
+ syncMessageViewport,
]);
// F2: messages diff → 按角色累计 unreadCount
@@ -4942,7 +5054,7 @@ export function MessageStream({
restoringRef.current = false;
isNearBottomRef.current = true;
}
- if (decision.pinToBottom && !windowHandoff.deferPinToNextRender) pinToBottom();
+ if (decision.pinToBottom && !windowHandoff.deferPinToNextRender) pinToBottom(true);
const el = scrollRef.current;
if (el) prevScrollTopRef.current = el.scrollTop;
@@ -5523,13 +5635,16 @@ export function MessageStream({
if (effectiveNearBottom !== isNearBottomRef.current) {
isNearBottomRef.current = effectiveNearBottom;
setIsNearBottom(effectiveNearBottom);
- if (effectiveNearBottom) setUnreadCount(0);
- }
- // render-window-bidirectional P1 fix: 锚定窗口覆盖末尾 + 用户到达底部 →
- // 切回默认尾窗。必须在 handleScroll 里而不是 layout effect 里做——
- // 用户从"向上扩窗"滚回底部时 wasCovering 从始至终为 true,layout effect 捕不到。
- if (effectiveNearBottom && firstVisibleItemKey !== null && windowCoversEnd) {
- setFirstVisibleItemKey(null);
+ if (effectiveNearBottom) {
+ setUnreadCount(0);
+ // Only shrink history when the reader resumes following the tail.
+ // Ctrl+F / Ctrl+A mount offscreen text and change scroll geometry at
+ // an already-followed tail; those scroll events must preserve the
+ // existing logical window, otherwise find/selection loses its text.
+ if (firstVisibleItemKey !== null && windowCoversEnd) {
+ setFirstVisibleItemKey(null);
+ }
+ }
}
if (effectiveNearBottom) {
// 到底了:无论方向都隐藏 chip,清掉 timer
@@ -5601,11 +5716,11 @@ export function MessageStream({
// "穿过顶部区间"与"停在顶部继续上滚"的完整触发面)
if (el.scrollTop >= TOP_HISTORY_TRIGGER_PX) return;
- // chip jump 期间抑制 — chip click 是导航语义不是"想加载更多",而且 smooth
+ // chip / 搜索 focus 期间抑制 — 定位是导航语义不是"想加载更多",而且 smooth
// 路径穿过顶部时叠加 F-SYNC-2 的 scrollTop+=delta 可能把 viewport 拽飞
// (长距离跳转踹回底嫌疑)。用户主动 wheel/touch/keydown 会立刻清掉这个 ref
// (见 mount effect 里的监听),所以"跳完立刻继续往上翻"完全 OK。
- if (chipJumpInProgressRef.current) {
+ if (chipJumpInProgressRef.current || focusJumpRef.current !== null) {
return;
}
@@ -6085,15 +6200,21 @@ export function MessageStream({
React `key` 一律取 item.key — stable across builds(派生约定见
RenderItem 类型注释 / buildRenderItems),复用 DOM 节点避免折叠
态丢失 / 滚动锚点漂走。 */}
- <div
+ <MessageViewport apiRef={messageViewportRef} options={{
+ entries: viewportEntries, scrollRef, itemsRef, followRef: isNearBottomRef,
+ initialAnchor: restoreSnapshotRef.current?.viewportTopKey,
+ initialHeights: restoreSnapshotRef.current?.itemHeights?.byKey,
+ disabled: shareSelectionActive,
+ // Refresh ownership before virtualization mutates the DOM.
+ onProgrammaticScroll: () => handleScroll(),
+ }}>{messageViewport => <div
ref={itemsRef}
data-share-selection-active={shareSelectionActive ? '' : undefined}
className={cn(
- // msg-stream-items:直接子元素(每条 render item 的根节点)带
- // content-visibility:auto(globals.css)—— 视口外条目跳过布局
- // 与绘制,切入长 session 的首帧成本从「整个窗口 80 条」降到
- // 「一屏」。滚动恢复按条目锚定 + ResizeObserver 纠偏,估高
- // (240px)与真实高度的偏差在条目进入视口后被自动纠正。
+ // #5406: normal layout avoids the row display-locking condition
+ // reproduced in Blink AX text-fragment serialization.
+ // Historical bodies mount near the viewport; keyed height
+ // placeholders preserve the existing scroll/restore geometry.
'msg-stream-items flex flex-col gap-3.5',
// 分享选择模式:整列内容右移,左侧让出复选框那一列。缩进加在
// 容器上(不是逐条消息),工具卡等不可选的 item 也跟着移,
@@ -6102,7 +6223,16 @@ export function MessageStream({
'transition-[padding] duration-[var(--motion-base)] ease-[var(--motion-ease-move)] motion-reduce:transition-none',
)}
>
- {visibleRenderItems.map((item) => {
+ {visibleRenderItems.map((item, itemIndex) => {
+ if (!messageViewport.shouldMount(viewportEntries[itemIndex])) {
+ return <div key={item.key} data-render-item-key={item.key}
+ data-message-client-id={item.type === 'message' ? item.message.clientId : undefined}
+ // Previous-question navigation must still find offscreen user rows.
+ data-user-msg-id={item.type === 'message' && item.message.role === 'user'
+ && !item.message.isSyntheticTrigger ? item.message.clientId : undefined}
+ data-message-placeholder="" aria-hidden="true"
+ style={{ height: messageViewport.placeholderHeight(item.key), flexShrink: 0 }} />;
+ }
if (item.type === 'fork_origin') {
return (
<ForkOriginMarker
@@ -6383,7 +6513,7 @@ export function MessageStream({
</div>
);
})}
- </div>
+ </div>}</MessageViewport>
</div>
</div>
diff --git a/apps/desktop/src/renderer/components/chat/MessageViewport.tsx b/apps/desktop/src/renderer/components/chat/MessageViewport.tsx
new file mode 100644
index 0000000000..4b43811a08
--- /dev/null
+++ b/apps/desktop/src/renderer/components/chat/MessageViewport.tsx
@@ -0,0 +1,37 @@
+import { useCallback, useImperativeHandle, useRef, useState, type ReactNode, type Ref } from 'react';
+import { useMessageViewport } from './useMessageViewport';
+
+export type MessageViewportApi = Pick<ReturnType<typeof useMessageViewport>, 'syncViewport' | 'reconcileViewport'> & {
+ connect: () => void;
+};
+
+/** Own viewport state below MessageStream: mounting rows must not rerun the
+ * thread's metadata projections and scroll-coordination layout effects.
+ * The render function preserves the existing DOM and keyed card identities.
+ */
+export function MessageViewport({ apiRef, options, children }: {
+ apiRef: Ref<MessageViewportApi>;
+ options: Parameters<typeof useMessageViewport>[0];
+ children: (viewport: ReturnType<typeof useMessageViewport>) => ReactNode;
+}) {
+ const [connection, setConnection] = useState(0);
+ const connected = useRef<{ root: HTMLElement; items: HTMLElement } | null>(null);
+ const viewport = useMessageViewport({ ...options, connection });
+ const layout = useRef(viewport.connectViewport);
+ layout.current = viewport.connectViewport;
+ const connect = useCallback(() => {
+ const root = options.scrollRef.current, items = options.itemsRef.current;
+ if (!root || !items || (connected.current?.root === root && connected.current.items === items)) return;
+ connected.current = { root, items };
+ // Initialize before the owner's later layout effects restore its precise
+ // reading offset. Deferring this until our next commit overwrites restoration.
+ layout.current();
+ setConnection(value => value + 1);
+ }, [options.scrollRef, options.itemsRef]);
+ useImperativeHandle(apiRef, () => ({
+ syncViewport: viewport.syncViewport,
+ reconcileViewport: viewport.reconcileViewport,
+ connect,
+ }), [viewport.syncViewport, viewport.reconcileViewport, connect]);
+ return children(viewport);
+}
diff --git a/apps/desktop/src/renderer/components/chat/animateFocusScroll.ts b/apps/desktop/src/renderer/components/chat/animateFocusScroll.ts
new file mode 100644
index 0000000000..266715ddb5
--- /dev/null
+++ b/apps/desktop/src/renderer/components/chat/animateFocusScroll.ts
@@ -0,0 +1,55 @@
+/** Scroll toward a live element, not the absolute offset captured by native smooth
+ * scrolling. Virtual rows can replace estimated heights anywhere along the path. */
+export function animateFocusScroll({
+ root, getTarget, reconcile, onFinish,
+}: {
+ root: HTMLElement;
+ getTarget: () => HTMLElement | null;
+ reconcile: () => void;
+ onFinish: () => void;
+}): () => void {
+ const centeredOffset = (target: HTMLElement) => {
+ const rect = target.getBoundingClientRect();
+ const container = root.getBoundingClientRect();
+ const style = getComputedStyle(target);
+ const rootStyle = getComputedStyle(root);
+ const px = (value: string) => Number.parseFloat(value) || 0;
+ const targetCenter = (rect.top + rect.bottom + px(style.scrollMarginBottom) - px(style.scrollMarginTop)) / 2;
+ const viewportCenter = container.top + root.clientTop +
+ (root.clientHeight + px(rootStyle.scrollPaddingTop) - px(rootStyle.scrollPaddingBottom)) / 2;
+ return targetCenter - viewportCenter;
+ };
+ const target = getTarget();
+ const initialOffset = target ? centeredOffset(target) : 0;
+ const duration = window.matchMedia('(prefers-reduced-motion: reduce)').matches
+ ? 0 : Math.min(800, Math.max(200, Math.sqrt(Math.abs(initialOffset)) * 8));
+ let frame = 0;
+ let cancelled = false;
+ const start = performance.now();
+ // Stop an earlier native animation before taking ownership.
+ root.scrollTo({ top: root.scrollTop, behavior: 'instant' });
+ const tick = (now: number) => {
+ if (cancelled) return;
+ // rAF uses the frame timestamp, which can precede our performance.now()
+ // start. Negative progress would scroll away from the target on frame one.
+ const progress = duration ? Math.max(0, Math.min(1, (now - start) / duration)) : 1;
+ const remaining = initialOffset * (1 - progress) ** 3;
+ // Mounting the new viewport may move the target. Correct that displacement
+ // in the same paint, preserving the animation's intended visual position.
+ for (let pass = 0; pass < 3; pass++) {
+ const current = getTarget();
+ if (!current) break;
+ const delta = centeredOffset(current) - remaining;
+ if (Math.abs(delta) <= 0.5) break;
+ const before = root.scrollTop;
+ root.scrollTo({ top: before + delta, behavior: 'instant' });
+ reconcile();
+ if (cancelled) return;
+ if (Math.abs(root.scrollTop - before) <= 0.5) break;
+ }
+ if (progress === 1 || !getTarget()) onFinish();
+ else frame = requestAnimationFrame(tick);
+ };
+ frame = requestAnimationFrame(tick);
+ return () => { cancelled = true; cancelAnimationFrame(frame); };
+}
diff --git a/apps/desktop/src/renderer/components/chat/messageViewportGeometry.ts b/apps/desktop/src/renderer/components/chat/messageViewportGeometry.ts
new file mode 100644
index 0000000000..e94c2f286d
--- /dev/null
+++ b/apps/desktop/src/renderer/components/chat/messageViewportGeometry.ts
@@ -0,0 +1,126 @@
+/** Geometry is rebuilt on structural/width changes, and patched for dirty rows.
+ * Scrolling only queries the ordered numeric offsets; it never scans row DOM.
+ */
+export function findViewportRange(tops: readonly number[], bottoms: readonly number[], top: number, bottom: number) {
+ let lo = 0, hi = bottoms.length;
+ while (lo < hi) {
+ const mid = (lo + hi) >>> 1;
+ if (bottoms[mid] < top) lo = mid + 1; else hi = mid;
+ }
+ const start = lo;
+ lo = start; hi = tops.length;
+ while (lo < hi) {
+ const mid = (lo + hi) >>> 1;
+ if (tops[mid] <= bottom) lo = mid + 1; else hi = mid;
+ }
+ return { start, end: lo };
+}
+
+export class MessageViewportGeometry {
+ rows: HTMLElement[] = [];
+ keys: string[] = [];
+ tops: number[] = [];
+ bottoms: number[] = [];
+ origin = 0;
+ private sizes: number[] = [];
+ private gaps: number[] = [];
+ private dirty = new Set<HTMLElement>();
+ private structure = true;
+ private full = true;
+ private width = -1;
+ private itemsWidth = -1;
+ private itemsHeight = -1;
+ private observer: ResizeObserver | null = null;
+
+ get invalid() { return this.full || this.structure || this.dirty.size > 0; }
+
+ observe(observer: ResizeObserver | null) {
+ this.observer = observer;
+ if (observer) for (const row of this.rows) observer.observe(row);
+ }
+
+ resize(row: HTMLElement, height?: number) {
+ const index = this.rows.indexOf(row);
+ if (index >= 0 && (height == null || Math.abs(height - this.sizes[index]) > 0.01)) this.dirty.add(row);
+ }
+
+ mutations(records: MutationRecord[], items: HTMLElement) {
+ for (const record of records) {
+ if (record.target === items) {
+ if (record.type === 'childList') this.structure = true;
+ else this.full = true;
+ continue;
+ }
+ let row = record.target instanceof HTMLElement ? record.target : record.target.parentElement;
+ while (row && row.parentElement !== items) row = row.parentElement;
+ if (row) this.dirty.add(row);
+ }
+ }
+
+ refresh(root: HTMLElement, items: HTMLElement, remembered: Map<string, number>) {
+ if (this.structure) {
+ const rows = Array.from(items.children) as HTMLElement[];
+ const keys = rows.map(row => row.dataset.renderItemKey ?? '');
+ if (keys.length !== this.keys.length || keys.some((key, i) => key !== this.keys[i])) this.full = true;
+ const old = new Set(this.rows), next = new Set(rows);
+ for (const row of old) if (!next.has(row)) { this.observer?.unobserve(row); this.dirty.delete(row); }
+ for (const row of rows) if (!old.has(row)) { this.dirty.add(row); this.observer?.observe(row); }
+ this.rows = rows; this.keys = keys; this.structure = false;
+ }
+ const width = root.clientWidth, itemsWidth = items.clientWidth, itemsHeight = items.clientHeight;
+ // A container resize without a row notification may be a stylesheet/font
+ // change. Keep the full measurement fallback for this uncommon path.
+ this.full ||= this.width !== width || this.itemsWidth !== itemsWidth ||
+ (this.itemsHeight !== itemsHeight && this.dirty.size === 0);
+ if (!this.full && !this.dirty.size) return;
+ const boxes = new Map<number, DOMRect>();
+ const box = (index: number) => {
+ let result = boxes.get(index);
+ if (!result) { result = this.rows[index].getBoundingClientRect(); boxes.set(index, result); }
+ return result;
+ };
+ const changed: number[] = [];
+ for (let i = 0; i < this.rows.length; i++) if (this.full || this.dirty.has(this.rows[i])) changed.push(i);
+ if (this.full) { this.sizes = []; this.gaps = []; }
+ for (const i of changed) {
+ box(i);
+ // Capture margins/gaps as well as heights. Measuring immediate neighbors
+ // prevents a changed row wrapper from invalidating later numeric offsets.
+ if (i > 0) box(i - 1);
+ if (i + 1 < this.rows.length) box(i + 1);
+ }
+ for (const [i, rect] of boxes) {
+ this.sizes[i] = rect.height;
+ if (this.keys[i] && !this.rows[i].hasAttribute('data-message-placeholder')) remembered.set(this.keys[i], rect.height);
+ }
+ for (const i of changed) {
+ this.gaps[i] = i === 0 ? 0 : box(i).top - box(i - 1).bottom;
+ if (i + 1 < this.rows.length) this.gaps[i + 1] = box(i + 1).top - box(i).bottom;
+ }
+ this.origin = this.rows.length ? box(0).top + root.scrollTop - root.getBoundingClientRect().top : 0;
+ this.tops = []; this.bottoms = [];
+ let offset = 0;
+ for (let i = 0; i < this.rows.length; i++) {
+ offset += this.gaps[i]; this.tops.push(offset);
+ offset += this.sizes[i]; this.bottoms.push(offset);
+ }
+ this.width = width; this.itemsWidth = itemsWidth; this.itemsHeight = itemsHeight;
+ this.full = false; this.dirty.clear();
+ }
+
+ range(position: number, height: number, overscan: number) {
+ const relative = position - this.origin;
+ const { start, end } = findViewportRange(this.tops, this.bottoms, relative - overscan, relative + height + overscan);
+ let lower = -Infinity, upper = Infinity;
+ const boundary = (value: number) => {
+ if (value <= position) lower = Math.max(lower, value);
+ if (value >= position) upper = Math.min(upper, value);
+ };
+ for (const i of [start - 1, start]) if (i >= 0 && i < this.rows.length) boundary(this.origin + this.bottoms[i] + overscan);
+ for (const i of [end - 1, end]) if (i >= 0 && i < this.rows.length) boundary(this.origin + this.tops[i] - height - overscan);
+ let anchorIndex = findViewportRange(this.tops, this.bottoms, relative, relative + height).start;
+ while (anchorIndex < this.rows.length && (this.bottoms[anchorIndex] <= relative || this.sizes[anchorIndex] === 0)) anchorIndex++;
+ return { keys: this.keys.slice(start, end).filter(Boolean), lower, upper,
+ anchor: anchorIndex < this.keys.length ? { key: this.keys[anchorIndex], offset: this.origin + this.tops[anchorIndex] - position } : null };
+ }
+}
diff --git a/apps/desktop/src/renderer/components/chat/observeProgrammaticScroll.ts b/apps/desktop/src/renderer/components/chat/observeProgrammaticScroll.ts
new file mode 100644
index 0000000000..8f35c17c54
--- /dev/null
+++ b/apps/desktop/src/renderer/components/chat/observeProgrammaticScroll.ts
@@ -0,0 +1,45 @@
+/**
+ * Native scroll events can arrive one paint after a script writes scrollTop in
+ * rAF. Observe writes on this owned element (never a DOM prototype) so the
+ * virtualizer can commit its destination at the current microtask checkpoint.
+ * Waiting until the writer's stack finishes also avoids flushSync inside a
+ * React render/commit when layout effects themselves adjust the scroll offset.
+ */
+export function observeProgrammaticScroll(root: HTMLElement, onChange: () => void): () => void {
+ const originalOwn = Object.getOwnPropertyDescriptor(root, 'scrollTop');
+ let owner: object | null = root;
+ let descriptor: PropertyDescriptor | undefined;
+ while (owner && !descriptor) {
+ descriptor = Object.getOwnPropertyDescriptor(owner, 'scrollTop');
+ owner = Object.getPrototypeOf(owner);
+ }
+ if (originalOwn?.configurable === false || !descriptor?.get || !descriptor.set) return () => {};
+ const read = descriptor.get;
+ const write = descriptor.set;
+ let active = true;
+ let queued = false;
+ const setter = function (this: HTMLElement, value: number) {
+ const before = read.call(this);
+ write.call(this, value);
+ if (!active || this !== root || queued || read.call(this) === before) return;
+ queued = true;
+ queueMicrotask(() => {
+ queued = false;
+ if (active) onChange();
+ });
+ };
+ Object.defineProperty(root, 'scrollTop', {
+ configurable: true,
+ enumerable: descriptor.enumerable,
+ get: read,
+ set: setter,
+ });
+ return () => {
+ active = false;
+ // Do not undo another owner's later descriptor. Its saved setter can still
+ // delegate to ours, which becomes an ordinary native write after cleanup.
+ if (Object.getOwnPropertyDescriptor(root, 'scrollTop')?.set !== setter) return;
+ if (originalOwn) Object.defineProperty(root, 'scrollTop', originalOwn);
+ else delete (root as unknown as { scrollTop?: number }).scrollTop;
+ };
+}
diff --git a/apps/desktop/src/renderer/components/chat/useMessageViewport.ts b/apps/desktop/src/renderer/components/chat/useMessageViewport.ts
new file mode 100644
index 0000000000..20b2c2de51
--- /dev/null
+++ b/apps/desktop/src/renderer/components/chat/useMessageViewport.ts
@@ -0,0 +1,311 @@
+import { useCallback, useLayoutEffect, useRef, useState, type RefObject } from 'react';
+import { flushSync } from 'react-dom';
+import { observeProgrammaticScroll } from './observeProgrammaticScroll';
+import { isEditableKeyboardTarget } from '@/lib/editableKeyboardTarget';
+import { isPageTextAccessActive, subscribePageTextAccess } from '@/lib/pageTextAccess';
+import { MessageViewportGeometry } from './messageViewportGeometry';
+
+type Entry = { key: string; retain: boolean };
+type Options = {
+ entries: readonly Entry[];
+ scrollRef: RefObject<HTMLDivElement | null>;
+ itemsRef: RefObject<HTMLDivElement | null>;
+ followRef: RefObject<boolean>;
+ initialAnchor?: string;
+ initialHeights?: Record<string, number>;
+ onProgrammaticScroll?: () => void;
+ disabled: boolean;
+ /** The owner connects after ancestor DOM refs have attached, before paint. */
+ connection?: number;
+};
+const ESTIMATE = 240;
+const OVERSCAN = 600;
+
+/** Keep the existing keyed row/scroll geometry, virtualizing only row contents.
+ * Stateful cards are retained by the caller. Interacted-with rows stay mounted
+ * for this MessageStream lifetime, so editors, media and portaled menus survive.
+ * No browser display locking/content-visibility is used.
+ */
+export function useMessageViewport(options: Options) {
+ const latest = useRef(options);
+ latest.current = options;
+ const [heightCache] = useState(() => new Map(Object.entries(options.initialHeights ?? {})
+ .filter(([, height]) => Number.isFinite(height) && height > 0)));
+ const heights = useRef(heightCache);
+ const retained = useRef(new Set<string>());
+ const [accessibilitySupport, setAccessibilitySupport] = useState(
+ () => window.electronAPI?.accessibilitySupport?.getSync() ?? false,
+ );
+ const accessibilitySupportRef = useRef(accessibilitySupport);
+ const [keyboardOrSelection, setKeyboardOrSelection] = useState(false);
+ const keyboardOrSelectionRef = useRef(false);
+ const [pageTextAccess, setPageTextAccess] = useState(isPageTextAccessActive);
+ const pageTextAccessRef = useRef(pageTextAccess);
+ const [mounted, setMounted] = useState(() => {
+ const index = options.initialAnchor
+ ? Math.max(0, options.entries.findIndex(e => e.key === options.initialAnchor))
+ : Math.max(0, options.entries.length - 8);
+ return new Set(options.entries.slice(Math.max(0, index - 2), index + 8).map(e => e.key));
+ });
+ const mountedRef = useRef(mounted);
+ mountedRef.current = mounted;
+ const pendingAnchor = useRef<{
+ key: string; offset: number; wasFollowing: boolean; atBottom: boolean;
+ } | null>(null);
+ const firstLayout = useRef(true);
+ const measurement = useRef<{
+ entries: readonly Entry[]; top: number; width: number; height: number; scrollHeight: number;
+ itemsWidth: number; itemsHeight: number;
+ lower: number; upper: number;
+ } | null>(null);
+ const mutations = useRef<MutationObserver | null>(null);
+ const [geometry] = useState(() => new MessageViewportGeometry());
+ const needsReconcileRef = useRef<() => boolean>(() => true);
+ const reconcileRef = useRef<() => void>(() => {});
+ // Programmatic writes made in rAF or an event callback can paint before the
+ // browser emits scroll. Their callers must commit the destination immediately.
+ const reconcileViewport = useCallback(() => reconcileRef.current(), []);
+ const syncViewport = useCallback(() => {
+ if (needsReconcileRef.current()) flushSync(reconcileViewport);
+ }, [reconcileViewport]);
+
+ const preserveTextAccessAnchor = useCallback(() => {
+ const { scrollRef, itemsRef, followRef } = latest.current;
+ const root = scrollRef.current;
+ const items = itemsRef.current;
+ if (!root || !items) return;
+ const top = root.getBoundingClientRect().top;
+ const row = Array.from(items.children).find(element => {
+ const rect = element.getBoundingClientRect();
+ return rect.height > 0 && rect.bottom > top;
+ }) as HTMLElement | undefined;
+ if (row?.dataset.renderItemKey) pendingAnchor.current = {
+ key: row.dataset.renderItemKey, offset: row.getBoundingClientRect().top - top,
+ wasFollowing: followRef.current,
+ atBottom: Math.abs(root.scrollHeight - root.scrollTop - root.clientHeight) <= 1,
+ };
+ }, []);
+
+ useLayoutEffect(() => window.electronAPI?.accessibilitySupport?.onChanged(enabled => {
+ if (enabled === accessibilitySupportRef.current) return;
+ accessibilitySupportRef.current = enabled;
+ preserveTextAccessAnchor();
+ setAccessibilitySupport(enabled);
+ }), [preserveTextAccessAnchor]);
+
+ useLayoutEffect(() => {
+ const update = () => {
+ const next = isPageTextAccessActive();
+ if (next === pageTextAccessRef.current) return;
+ pageTextAccessRef.current = next;
+ preserveTextAccessAnchor();
+ setPageTextAccess(next);
+ };
+ const unsubscribe = subscribePageTextAccess(update);
+ update();
+ return unsubscribe;
+ }, [preserveTextAccessAnchor]);
+
+ const connectViewport = () => {
+ const root = options.scrollRef.current;
+ const items = options.itemsRef.current;
+ if (!root || !items) return;
+ const initial = firstLayout.current;
+ firstLayout.current = false;
+ if (initial) {
+ if (options.followRef.current) root.scrollTop = root.scrollHeight;
+ else if (options.initialAnchor) {
+ const row = Array.from(items.children).find(e => (e as HTMLElement).dataset.renderItemKey === options.initialAnchor);
+ if (row) root.scrollTop += row.getBoundingClientRect().top - root.getBoundingClientRect().top;
+ }
+ }
+ const anchor = pendingAnchor.current;
+ pendingAnchor.current = null;
+ if (anchor) {
+ if (options.followRef.current && (!anchor.wasFollowing || anchor.atBottom)) {
+ // A NEW tail-follow intent supersedes an older reading anchor. An
+ // already-following container can have been moved away by a script
+ // before its scroll event updates followRef; preserve that destination.
+ if (Math.abs(root.scrollHeight - root.scrollTop - root.clientHeight) > 1) root.scrollTop = root.scrollHeight;
+ }
+ else {
+ const row = Array.from(items.children).find(e => (e as HTMLElement).dataset.renderItemKey === anchor.key);
+ const delta = row ? row.getBoundingClientRect().top - root.getBoundingClientRect().top - anchor.offset : 0;
+ // Even assigning the same scrollTop cancels Chromium's native smooth
+ // animation. Only interrupt it when geometry actually needs correction.
+ if (Math.abs(delta) > 1) root.scrollTop += delta;
+ }
+ }
+ const needsReconcile = () => {
+ // Drain mutations already represented by this commit before trusting the
+ // cached interval. Nested message updates can run without a parent render.
+ const records = mutations.current?.takeRecords();
+ if (records?.length) { geometry.mutations(records, items); measurement.current = null; }
+ const cached = measurement.current;
+ const position = root.scrollTop;
+ return !cached || geometry.invalid || cached.entries !== latest.current.entries ||
+ cached.width !== root.clientWidth || cached.height !== root.clientHeight ||
+ cached.itemsWidth !== items.clientWidth || cached.itemsHeight !== items.clientHeight ||
+ cached.scrollHeight !== root.scrollHeight ||
+ !(position === cached.top || (position > cached.lower && position < cached.upper));
+ };
+ needsReconcileRef.current = needsReconcile;
+ const reconcile = (preserveAnchor = true) => {
+ if (!needsReconcile()) return;
+ const current = latest.current;
+ const position = root.scrollTop;
+ geometry.refresh(root, items, heights.current);
+ const { keys, lower, upper, anchor: viewportAnchor } = geometry.range(position, root.clientHeight, OVERSCAN);
+ const next = new Set(keys);
+ for (const entry of current.entries) {
+ if (entry.retain || retained.current.has(entry.key)) next.add(entry.key);
+ }
+ measurement.current = { entries: current.entries, top: position,
+ width: root.clientWidth, height: root.clientHeight, scrollHeight: root.scrollHeight,
+ itemsWidth: items.clientWidth, itemsHeight: items.clientHeight,
+ lower, upper };
+ if (next.size === mountedRef.current.size && [...next].every(key => mountedRef.current.has(key))) return;
+ if (preserveAnchor && viewportAnchor) pendingAnchor.current = {
+ ...viewportAnchor,
+ wasFollowing: current.followRef.current,
+ atBottom: Math.abs(root.scrollHeight - root.scrollTop - root.clientHeight) <= 1,
+ };
+ mountedRef.current = next;
+ setMounted(next);
+ };
+ reconcileRef.current = reconcile;
+ reconcile(!initial);
+ };
+ useLayoutEffect(connectViewport);
+
+ useLayoutEffect(() => {
+ const root = options.scrollRef.current;
+ const items = options.itemsRef.current;
+ if (!root || !items) return;
+ let frame = 0;
+ // A scroll event runs before paint. Deferring mounting to another rAF can
+ // expose empty placeholders when a wheel/scrollbar jump exceeds overscan.
+ const reconcileBeforePaint = syncViewport;
+ const stopObservingWrites = observeProgrammaticScroll(root, () => flushSync(() => {
+ // The owner's scroll coordinator must see the new position before our
+ // DOM replacement triggers its height/MutationObserver compensation.
+ latest.current.onProgrammaticScroll?.();
+ reconcileRef.current();
+ }));
+ const schedule = () => {
+ if (!frame) frame = requestAnimationFrame(() => { frame = 0; reconcileBeforePaint(); });
+ };
+ const retainInteraction = (event: Event) => {
+ const row = event.target instanceof Element ? event.target.closest<HTMLElement>('[data-render-item-key]') : null;
+ if (row && items.contains(row) && row.dataset.renderItemKey) {
+ retained.current.add(row.dataset.renderItemKey);
+ measurement.current = null;
+ }
+ };
+ let keyboardTraversal = false;
+ let textAccessTimer: ReturnType<typeof setTimeout> | undefined;
+ const setTextAccess = (enabled: boolean) => {
+ if (keyboardOrSelectionRef.current === enabled) return;
+ keyboardOrSelectionRef.current = enabled;
+ preserveTextAccessAnchor();
+ setKeyboardOrSelection(enabled);
+ };
+ const selectionIntersectsItems = () => {
+ const value = document.getSelection();
+ if (!value || value.isCollapsed) return false;
+ // A page-wide selection can start outside this message stream.
+ for (let index = 0; index < value.rangeCount; index++) {
+ if (value.getRangeAt(index).intersectsNode(items)) return true;
+ }
+ return false;
+ };
+ const updateTextAccess = () => {
+ setTextAccess((keyboardTraversal && root.contains(document.activeElement)) || selectionIntersectsItems());
+ };
+ const settleTextAccess = () => {
+ clearTimeout(textAccessTimer);
+ // Native focus movement/selection happens after keydown. Also handle a
+ // prevented Tab or select-all, without leaving the entire window mounted.
+ textAccessTimer = setTimeout(updateTextAccess, 0);
+ };
+ const pointer = () => {
+ keyboardTraversal = false;
+ settleTextAccess();
+ };
+ const keyboard = (event: KeyboardEvent) => {
+ if (event.defaultPrevented) return;
+ if (event.key === 'Tab') {
+ // Capture at window: Tab/Shift+Tab can enter from a composer or toolbar
+ // outside the scroll root. Mount before native tab-order traversal.
+ keyboardTraversal = true;
+ flushSync(() => setTextAccess(true));
+ settleTextAccess();
+ return;
+ }
+ // Clicking ordinary message text leaves BODY focused. The page-level
+ // shortcut therefore never reaches the scroll root's keydown listener.
+ if (event.altKey || !(event.ctrlKey || event.metaKey)
+ || event.key.toLowerCase() !== 'a' || isEditableKeyboardTarget(event.target)) return;
+ flushSync(() => setTextAccess(true));
+ settleTextAccess();
+ };
+ const invalidate = (records: MutationRecord[]) => {
+ geometry.mutations(records, items);
+ measurement.current = null;
+ schedule();
+ };
+ // Resize delivery can describe a commit that the layout effect already
+ // measured. Compare dimensions/DOM generation before scheduling it again.
+ const observer = new ResizeObserver(entries => {
+ for (const entry of entries ?? []) {
+ if (entry.target !== root && entry.target !== items) {
+ geometry.resize(entry.target as HTMLElement, entry.borderBoxSize?.[0]?.blockSize);
+ }
+ }
+ if (needsReconcileRef.current()) schedule();
+ });
+ observer.observe(items);
+ observer.observe(root);
+ geometry.observe(observer);
+ const mutationObserver = new MutationObserver(invalidate);
+ mutations.current = mutationObserver;
+ mutationObserver.observe(items, { subtree: true, childList: true, characterData: true, attributes: true });
+ root.addEventListener('scroll', reconcileBeforePaint, { passive: true });
+ root.addEventListener('pointerdown', retainInteraction, true);
+ root.addEventListener('focusin', retainInteraction);
+ root.addEventListener('keydown', retainInteraction, true);
+ window.addEventListener('keydown', keyboard, true);
+ window.addEventListener('pointerdown', pointer, true);
+ document.addEventListener('focusin', settleTextAccess);
+ document.addEventListener('focusout', settleTextAccess);
+ document.addEventListener('selectionchange', updateTextAccess);
+ return () => {
+ stopObservingWrites();
+ cancelAnimationFrame(frame);
+ clearTimeout(textAccessTimer);
+ observer.disconnect();
+ geometry.observe(null);
+ mutationObserver.disconnect();
+ mutations.current = null;
+ measurement.current = null;
+ root.removeEventListener('scroll', reconcileBeforePaint);
+ root.removeEventListener('pointerdown', retainInteraction, true);
+ root.removeEventListener('focusin', retainInteraction);
+ root.removeEventListener('keydown', retainInteraction, true);
+ window.removeEventListener('keydown', keyboard, true);
+ window.removeEventListener('pointerdown', pointer, true);
+ document.removeEventListener('focusin', settleTextAccess);
+ document.removeEventListener('focusout', settleTextAccess);
+ document.removeEventListener('selectionchange', updateTextAccess);
+ };
+ }, [options.scrollRef, options.itemsRef, options.connection, preserveTextAccessAnchor, syncViewport, geometry]);
+
+ return {
+ connectViewport,
+ reconcileViewport,
+ syncViewport,
+ shouldMount: (entry: Entry) => options.disabled || accessibilitySupport || pageTextAccess || keyboardOrSelection || entry.retain ||
+ retained.current.has(entry.key) || mounted.has(entry.key),
+ placeholderHeight: (key: string) => heights.current.get(key) ?? ESTIMATE,
+ };
+}
diff --git a/apps/desktop/src/renderer/components/find-in-page/FindInPageBar.tsx b/apps/desktop/src/renderer/components/find-in-page/FindInPageBar.tsx
index 20061284d2..7af56474fa 100644
--- a/apps/desktop/src/renderer/components/find-in-page/FindInPageBar.tsx
+++ b/apps/desktop/src/renderer/components/find-in-page/FindInPageBar.tsx
@@ -1,4 +1,5 @@
-import { useCallback, useEffect, useRef, useState } from 'react';
+import { scrollRangeIntoView } from '@/lib/scrollRangeIntoView';
+import { useCallback, useEffect, useLayoutEffect, useRef, useState } from 'react';
import { useTranslation } from 'react-i18next';
import { ChevronDown, ChevronUp, X } from 'lucide-react';
@@ -6,6 +7,7 @@ import { cn } from '@/lib/utils';
import { useAppShortcut } from '@/hooks/useAppShortcut';
import { WINDOW_NO_DRAG_STYLE } from '@/components/layout/windowDrag';
import { isFindInPageClaimed } from './findInPageOwnership';
+import { acquirePageTextAccess, requestPageTextNavigation } from '@/lib/pageTextAccess';
const MATCH_HIGHLIGHT_NAME = 'cindy-find-in-page-match';
const ACTIVE_HIGHLIGHT_NAME = 'cindy-find-in-page-active';
@@ -373,67 +375,6 @@ function isInsideRoot(node: Node, root: HTMLElement | null): boolean {
return Boolean(root && (node === root || root.contains(node)));
}
-function getRangeRect(range: Range): DOMRect | null {
- const rects = typeof range.getClientRects === 'function' ? range.getClientRects() : [];
- const rect =
- rects[0] ??
- (typeof range.getBoundingClientRect === 'function' ? range.getBoundingClientRect() : null);
- if (!rect) return null;
- if (rect.width === 0 && rect.height === 0 && rect.top === 0 && rect.bottom === 0) return null;
- return rect;
-}
-
-function scrollRangeIntoView(range: Range) {
- const element = range.startContainer.parentElement;
- if (!element) return;
-
- let ancestor: HTMLElement | null = element;
- while (ancestor) {
- const style = window.getComputedStyle(ancestor);
- const canScrollY =
- /(auto|scroll|overlay|hidden)/.test(style.overflowY) &&
- ancestor.scrollHeight > ancestor.clientHeight;
- const canScrollX =
- /(auto|scroll|overlay|hidden)/.test(style.overflowX) &&
- ancestor.scrollWidth > ancestor.clientWidth;
- if (!canScrollY && !canScrollX) {
- ancestor = ancestor.parentElement;
- continue;
- }
-
- const rect = getRangeRect(range);
- const containerRect = ancestor.getBoundingClientRect();
- if (!rect) return;
- if (canScrollY) {
- if (rect.top < containerRect.top) ancestor.scrollTop -= containerRect.top - rect.top;
- else if (rect.bottom > containerRect.bottom)
- ancestor.scrollTop += rect.bottom - containerRect.bottom;
- }
- if (canScrollX) {
- if (rect.left < containerRect.left) ancestor.scrollLeft -= containerRect.left - rect.left;
- else if (rect.right > containerRect.right)
- ancestor.scrollLeft += rect.right - containerRect.right;
- }
- ancestor = ancestor.parentElement;
- }
-
- const rect = getRangeRect(range);
- if (!rect || typeof window.scrollBy !== 'function') return;
- const viewportHeight = window.innerHeight;
- const viewportWidth = window.innerWidth;
- if (rect.top < 0 || rect.bottom > viewportHeight) {
- window.scrollBy({
- top: rect.top < 0 ? rect.top : rect.bottom - viewportHeight,
- behavior: 'auto',
- });
- }
- if (rect.left < 0 || rect.right > viewportWidth) {
- window.scrollBy({
- left: rect.left < 0 ? rect.left : rect.right - viewportWidth,
- behavior: 'auto',
- });
- }
-}
/**
* F-FIP-1 — Find in Page overlay (Ctrl/Cmd+F).
@@ -450,6 +391,10 @@ function scrollRangeIntoView(range: Range) {
export function FindInPageBar() {
const { t } = useTranslation();
const [open, setOpen] = useState(false);
+ // Text ranges must cover the logical page, including virtualized row bodies.
+ // Hold them mounted while highlights refer to their text nodes; release on
+ // close/unmount without changing the message store or pagination cursor.
+ useLayoutEffect(() => open ? acquirePageTextAccess() : undefined, [open]);
const [text, setText] = useState('');
const [matches, setMatches] = useState(0);
const [active, setActive] = useState(0);
@@ -484,6 +429,7 @@ export function FindInPageBar() {
if (!range) return;
const element = range.startContainer.parentElement;
if (!element || isInsideRoot(element, rootRef.current)) return;
+ if (requestPageTextNavigation(range)) return;
scrollRangeIntoView(range);
if (typeof requestAnimationFrame === 'function') {
pendingScrollFrameRef.current = requestAnimationFrame(() => {
diff --git a/apps/desktop/src/renderer/components/find-in-page/__tests__/FindInPageBar.test.tsx b/apps/desktop/src/renderer/components/find-in-page/__tests__/FindInPageBar.test.tsx
index eb64782b33..38fd1d92c7 100644
--- a/apps/desktop/src/renderer/components/find-in-page/__tests__/FindInPageBar.test.tsx
+++ b/apps/desktop/src/renderer/components/find-in-page/__tests__/FindInPageBar.test.tsx
@@ -25,6 +25,7 @@ vi.mock('@/components/find-in-page/findInPageOwnership', () => ({
}));
import { FindInPageBar } from '../FindInPageBar';
+import { isPageTextAccessActive, PAGE_TEXT_NAVIGATION_EVENT } from '@/lib/pageTextAccess';
class MockHighlight {
priority = 0;
@@ -57,6 +58,30 @@ function getHighlight(name: string): MockHighlight | undefined {
}
describe('FindInPageBar', () => {
+ it('lets the owning message scroller coordinate a match jump', async () => {
+ const page = document.createElement('main');
+ page.textContent = 'owned search target';
+ const navigate = vi.fn((event: Event) => {
+ expect((event as CustomEvent<Range>).detail.toString()).toBe('search target');
+ event.preventDefault();
+ });
+ page.addEventListener(PAGE_TEXT_NAVIGATION_EVENT, navigate);
+ const input = await openFindBar(page);
+ fireEvent.change(input, { target: { value: 'search target' } });
+ expect(screen.getByText('1/1')).toBeTruthy();
+ expect(navigate).toHaveBeenCalled();
+ });
+ it('requests full logical text only while open and releases on close or unmount', async () => {
+ expect(isPageTextAccessActive()).toBe(false);
+ await openFindBar();
+ expect(isPageTextAccessActive()).toBe(true);
+ fireEvent.click(screen.getByRole('button', { name: 'findInPage.close' }));
+ expect(isPageTextAccessActive()).toBe(false);
+ await act(async () => { mocks.shortcutHandler?.(new KeyboardEvent('keydown')); });
+ expect(isPageTextAccessActive()).toBe(true);
+ cleanup();
+ expect(isPageTextAccessActive()).toBe(false);
+ });
beforeEach(() => {
vi.clearAllMocks();
mocks.shortcutHandler = null;
diff --git a/apps/desktop/src/renderer/lib/pageTextAccess.ts b/apps/desktop/src/renderer/lib/pageTextAccess.ts
new file mode 100644
index 0000000000..c5dfb7342e
--- /dev/null
+++ b/apps/desktop/src/renderer/lib/pageTextAccess.ts
@@ -0,0 +1,34 @@
+/** A DOM text consumer can request complete text from each current logical
+ * window. This only changes mounting; it never fetches or extends history. */
+const leases = new Set<symbol>();
+const listeners = new Set<() => void>();
+export const PAGE_TEXT_NAVIGATION_EVENT = 'cindy-page-text-navigation';
+
+/** Give an owning scroll coordinator first refusal before generic DOM scrolling.
+ * A handled request must preserve the text target and its pagination boundary. */
+export function requestPageTextNavigation(range: Range): boolean {
+ const element = range.startContainer.parentElement;
+ if (!element) return false;
+ return !element.dispatchEvent(new CustomEvent<Range>(PAGE_TEXT_NAVIGATION_EVENT, {
+ bubbles: true, cancelable: true, detail: range,
+ }));
+}
+
+export const isPageTextAccessActive = () => leases.size > 0;
+
+export function subscribePageTextAccess(listener: () => void) {
+ listeners.add(listener);
+ return () => { listeners.delete(listener); };
+}
+
+export function acquirePageTextAccess() {
+ const lease = Symbol();
+ const wasActive = isPageTextAccessActive();
+ leases.add(lease);
+ if (!wasActive) listeners.forEach(listener => listener());
+ return () => {
+ if (leases.delete(lease) && !isPageTextAccessActive()) {
+ listeners.forEach(listener => listener());
+ }
+ };
+}
diff --git a/apps/desktop/src/renderer/lib/scrollRangeIntoView.ts b/apps/desktop/src/renderer/lib/scrollRangeIntoView.ts
new file mode 100644
index 0000000000..76fc17d99e
--- /dev/null
+++ b/apps/desktop/src/renderer/lib/scrollRangeIntoView.ts
@@ -0,0 +1,70 @@
+/** Reveal a text match inside nested scrollers. A scroll owner can exclude its
+ * own container so its coordinator retains control of pagination and anchoring. */
+function getRangeRect(range: Range): DOMRect | null {
+ const rects = typeof range.getClientRects === 'function' ? range.getClientRects() : [];
+ const rect =
+ rects[0] ??
+ (typeof range.getBoundingClientRect === 'function' ? range.getBoundingClientRect() : null);
+ if (!rect) return null;
+ if (rect.width === 0 && rect.height === 0 && rect.top === 0 && rect.bottom === 0) return null;
+ return rect;
+}
+
+export function scrollRangeIntoView(range: Range, stopBefore?: HTMLElement) {
+ const element = range.startContainer.parentElement;
+ if (!element) return;
+
+ let ancestor: HTMLElement | null = element;
+ while (ancestor && ancestor !== stopBefore) {
+ const style = window.getComputedStyle(ancestor);
+ const canScrollY =
+ /(auto|scroll|overlay|hidden)/.test(style.overflowY) &&
+ ancestor.scrollHeight > ancestor.clientHeight;
+ const canScrollX =
+ /(auto|scroll|overlay|hidden)/.test(style.overflowX) &&
+ ancestor.scrollWidth > ancestor.clientWidth;
+ if (!canScrollY && !canScrollX) {
+ ancestor = ancestor.parentElement;
+ continue;
+ }
+
+ const rect = getRangeRect(range);
+ const containerRect = ancestor.getBoundingClientRect();
+ if (!rect) return;
+ if (canScrollY) {
+ if (rect.top < containerRect.top) ancestor.scrollTop -= containerRect.top - rect.top;
+ else if (rect.bottom > containerRect.bottom)
+ ancestor.scrollTop += rect.bottom - containerRect.bottom;
+ }
+ if (canScrollX) {
+ // Wrapped matches have differently sized fragments. Reveal their full
+ // horizontal extent, while vertical navigation still starts at line one.
+ const horizontalRect = typeof range.getBoundingClientRect === 'function'
+ ? range.getBoundingClientRect() : rect;
+ const left = containerRect.left + ancestor.clientLeft;
+ const right = left + ancestor.clientWidth;
+ if (horizontalRect.left < left) ancestor.scrollLeft -= left - horizontalRect.left;
+ else if (horizontalRect.right > right)
+ ancestor.scrollLeft += horizontalRect.right - right;
+ }
+ ancestor = ancestor.parentElement;
+ }
+
+ if (stopBefore) return;
+ const rect = getRangeRect(range);
+ if (!rect || typeof window.scrollBy !== 'function') return;
+ const viewportHeight = window.innerHeight;
+ const viewportWidth = window.innerWidth;
+ if (rect.top < 0 || rect.bottom > viewportHeight) {
+ window.scrollBy({
+ top: rect.top < 0 ? rect.top : rect.bottom - viewportHeight,
+ behavior: 'auto',
+ });
+ }
+ if (rect.left < 0 || rect.right > viewportWidth) {
+ window.scrollBy({
+ left: rect.left < 0 ? rect.left : rect.right - viewportWidth,
+ behavior: 'auto',
+ });
+ }
+}
diff --git a/apps/desktop/src/renderer/styles/globals.css b/apps/desktop/src/renderer/styles/globals.css
index f3eceb76fa..56a234a5f7 100644
--- a/apps/desktop/src/renderer/styles/globals.css
+++ b/apps/desktop/src/renderer/styles/globals.css
@@ -1112,25 +1112,21 @@ body.resizing-pane [data-ghost-webview] {
}
}
-/* 消息流条目级渲染跳过(Codex Desktop 同款,2026-08-09):视口外的 render
- item 跳过整棵子树的布局与绘制,只按 contain-intrinsic-size 估高占位
- (auto 前缀:渲染过一次后记住真实高度,滚回时用真实值,锚点不漂)。
- 切入长 session 时首帧只需布局视口内的几条消息 —— 之前是渲染窗口全量
- 80 条同步布局,几万字的会话切换有数百毫秒长任务(2026-08-09 实测卡顿)。
- 仅作用于 .msg-stream-items 的直接子元素(每条 render item 的根节点):
- 滚动恢复(measureViewportTop/applyRestore)按 children 索引取
- getBoundingClientRect —— 对 content-visibility 隐藏的条目返回估高盒,
- 量测仍然成立,进入视口后 ResizeObserver 纠偏收敛到真实高度。
- 打印/导出走独立渲染树,不经过本容器,不受影响。 */
+/* #5406: Electron 41 的 Blink 在跳过消息行布局后,正文更新/滚动触发的
+ 原生 AX 增量序列化会在 AXBlockFlowData::ComputeNeighborOnLine 断言崩溃。
+ 已用真实 MessageStream 复现,不依赖 CDP 查询。消息行必须保持真实布局,
+ 不能恢复 content-visibility:auto 的估高占位,也不能靠关闭无障碍规避。
+ 逻辑尾窗保留 80 个条目;历史正文按视口挂载,其余用实测高度占位。
+ 复现及对照见 scripts/ax5406/COMPONENT-REPRO.md。 */
.msg-stream-items > * {
- content-visibility: auto;
- contain-intrinsic-size: auto 240px;
+ content-visibility: visible;
+ contain-intrinsic-size: none;
}
/* Fixed-position menu triggers must keep the viewport as their containing
block. Their menu content is portaled to body, but Radix still measures the
- zero-size trigger inside the render item. Opt only those items out of the
- containment boundary; plain text items keep the render-skip optimization. */
+ zero-size trigger inside the render item. Keep this explicit exception when
+ changing message-row layout rules: a containing block would offset the menu. */
.msg-stream-items > *:has([data-fixed-menu-anchor]) {
content-visibility: visible;
contain-intrinsic-size: none;
@@ -1139,7 +1135,7 @@ body.resizing-pane [data-ghost-webview] {
/* 分享选择模式会在消息 wrapper 左侧动态挂载绝对定位的选择框。该元素需要真实
消息盒参与布局与绘制;继续使用视口外 intrinsic 占位会让长消息末尾的选择框
被压缩或裁切。伙伴消息的分享 wrapper 位于含时间分组的条目内部,也必须让
- 外层条目退出隔离;常态和工具类条目继续保留渲染跳过。 */
+ 外层条目保持真实布局,包括伙伴消息的嵌套分享 wrapper。 */
.msg-stream-items[data-share-selection-active] > [data-share-message-id],
.msg-stream-items[data-share-selection-active] > :has([data-share-message-id]) {
content-visibility: visible;
diff --git a/apps/desktop/src/renderer/vite-env.d.ts b/apps/desktop/src/renderer/vite-env.d.ts
index 2432dc2da3..bc2fd8fc01 100644
--- a/apps/desktop/src/renderer/vite-env.d.ts
+++ b/apps/desktop/src/renderer/vite-env.d.ts
@@ -1224,6 +1224,7 @@ interface ElectronAPI {
pageZoomIn: () => Promise<{ ok: true; zoomFactor: number }>;
pageZoomOut: () => Promise<{ ok: true; zoomFactor: number }>;
pageZoomReset: () => Promise<{ ok: true; zoomFactor: number }>;
+ accessibilitySupport: import('../shared/accessibilitySupport').AccessibilitySupportBridge;
appearanceSettings: {
importWallpaper: () => Promise<import('../shared/appearanceSettings').AppearanceSettings | null>;
ensureWallpaperVideo?: (id: import('../shared/appearanceSettings').WallpaperId) => Promise<string | null>;
diff --git a/apps/desktop/src/shared/accessibilitySupport.ts b/apps/desktop/src/shared/accessibilitySupport.ts
new file mode 100644
index 0000000000..3b4cf07b93
--- /dev/null
+++ b/apps/desktop/src/shared/accessibilitySupport.ts
@@ -0,0 +1,8 @@
+export const ACCESSIBILITY_SUPPORT_GET = 'accessibility-support:get-sync';
+export const ACCESSIBILITY_SUPPORT_CHANGED = 'accessibility-support:changed';
+
+/** Local viewer state, independent of the machine executing a remote task. */
+export interface AccessibilitySupportBridge {
+ getSync(): boolean;
+ onChanged(callback: (enabled: boolean) => void): () => void;
+}
diff --git a/docs/design-rules/design-inventory.md b/docs/design-rules/design-inventory.md
index e408b2a47f..340f8c0ffa 100644
--- a/docs/design-rules/design-inventory.md
+++ b/docs/design-rules/design-inventory.md
@@ -18,12 +18,12 @@
| `desktop.auth.add-account` | desktop | 添加账号 | hash `/add-account`(ProtectedRoute → AddAccountLoginPage) | AddAccountLoginPage | apps/desktop/src/renderer/components/login/AddAccountLoginPage.tsx, apps/desktop/src/renderer/components/login/LoginBrandStage.tsx, apps/desktop/src/renderer/components/login/LoginCaptchaOverlay.tsx, apps/desktop/src/renderer/components/login/LoginControls.tsx, apps/desktop/src/renderer/components/login/LoginPage.tsx, apps/desktop/src/renderer/components/login/loginDesignTokens.ts | 59 | 0 | 20 |
| `desktop.auth.legacy-migration` | desktop | 首登数据迁移弹窗 | App 顶层挂载 LegacyMigrationDialog(仅主窗;main 检测到旧版 userData 经 `legacy-migration:state` 驱动) | LegacyMigrationDialog | apps/desktop/src/renderer/components/auth/LegacyMigrationDialog.tsx | 8 | 0 | 2 |
| `desktop.auth.login` | desktop | 登录页 | hash `/login`(GuestRoute → LoginPage) | LoginBrandStage, LoginCaptchaOverlay, LoginControls, LoginPage | apps/desktop/src/renderer/components/login/LoginBrandStage.tsx, apps/desktop/src/renderer/components/login/LoginCaptchaOverlay.tsx, apps/desktop/src/renderer/components/login/LoginControls.tsx, apps/desktop/src/renderer/components/login/LoginPage.tsx, apps/desktop/src/renderer/components/login/loginDesignTokens.ts | 59 | 0 | 20 |
-| `desktop.bots` | desktop | 伙伴(列表 / 对话 / 设置 / 历史 / 伙伴私聊 / 群聊) | hash `/bots`、`/bots/list`、`/bots/:botId`、`/bots/roster` 及伙伴当前/历史任务、伙伴私聊、伙伴群聊路由(BotsFeatureLayout) | BotBasicProfileFields, BotCollaborationCard, BotDirectMessageView, BotGroupChatView, BotGroupCreateDialog, BotGroupSettingsDrawer, BotHistorySessionView, BotLifecycleSettings, BotModelChainEditor, BotRosterView, BotSessionView, BotSettingsDrawer, BotsHomeView, BotsListView, RemoteBotSessionView | apps/desktop/src/renderer/components/chat/AgentActionRow.tsx, apps/desktop/src/renderer/components/chat/AgentActionsBlock.tsx, apps/desktop/src/renderer/components/chat/AgentTaskCard.tsx, apps/desktop/src/renderer/components/chat/AgentTaskLiveDetails.tsx, apps/desktop/src/renderer/components/chat/AnnotationStrokesSvg.tsx, apps/desktop/src/renderer/components/chat/AskUserQuestionBubble.tsx, apps/desktop/src/renderer/components/chat/AssistantMessage.tsx, apps/desktop/src/renderer/components/chat/AutomationOriginBadge.tsx, apps/desktop/src/renderer/components/chat/ChatAudioCard.tsx, apps/desktop/src/renderer/components/chat/ChatDisplaySnapshotContext.tsx, apps/desktop/src/renderer/components/chat/ChatImageView.tsx, apps/desktop/src/renderer/components/chat/ChatSessionFileContext.tsx, apps/desktop/src/renderer/components/chat/ChatSoundEffectCard.tsx, apps/desktop/src/renderer/components/chat/ChatVideoView.tsx, apps/desktop/src/renderer/components/chat/CindyMakeDoctorCard.tsx, apps/desktop/src/renderer/components/chat/CopyAsImageBlock.tsx, apps/desktop/src/renderer/components/chat/CredentialSwitchWaitBanner.tsx, apps/desktop/src/renderer/components/chat/DiffView.tsx, apps/desktop/src/renderer/components/chat/ErrorBanner.tsx, apps/desktop/src/renderer/components/chat/ErrorMessageCard.tsx, apps/desktop/src/renderer/components/chat/GeneratedFilesCard.tsx, apps/desktop/src/renderer/components/chat/GhostCardHostPrompts.tsx, apps/desktop/src/renderer/components/chat/GhostSummonCard.tsx, apps/desktop/src/renderer/components/chat/GhostToolCard.tsx, apps/desktop/src/renderer/components/chat/HookTaskCard.tsx, apps/desktop/src/renderer/components/chat/ImageGalleryContext.tsx, apps/desktop/src/renderer/components/chat/ImageHoverPreview.tsx, apps/desktop/src/renderer/components/chat/ImageLightbox.tsx, apps/desktop/src/renderer/components/chat/ImageMissingPlaceholder.tsx, apps/desktop/src/renderer/components/chat/InlineReferenceChip.tsx, apps/desktop/src/renderer/components/chat/InterruptedTurnBanner.tsx, apps/desktop/src/renderer/components/chat/JumpToBottomChip.tsx, apps/desktop/src/renderer/components/chat/MarkdownDiffBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownMermaidBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownRenderer.tsx, apps/desktop/src/renderer/components/chat/MermaidLightbox.tsx, apps/desktop/src/renderer/components/chat/MessageActionBar.tsx, apps/desktop/src/renderer/components/chat/MessageNavRail.tsx, apps/desktop/src/renderer/components/chat/MessageStream.tsx, apps/desktop/src/renderer/components/chat/ModelLightbox.tsx, apps/desktop/src/renderer/components/chat/NewMessageIndicator.tsx, apps/desktop/src/renderer/components/chat/PlanReviewBubble.tsx, apps/desktop/src/renderer/components/chat/PrevMessageJumpChip.tsx, apps/desktop/src/renderer/components/chat/ProjectLinkChip.tsx, apps/desktop/src/renderer/components/chat/QuoteChip.tsx, apps/desktop/src/renderer/components/chat/RewindPreviewDialog.tsx, apps/desktop/src/renderer/components/chat/SelectionQuoteButton.tsx, apps/desktop/src/renderer/components/chat/SentAgentReferenceChip.tsx, apps/desktop/src/renderer/components/chat/SentInlineAtomBody.tsx, apps/desktop/src/renderer/components/chat/SessionHandoffCard.tsx, apps/desktop/src/renderer/components/chat/SessionLinkChip.tsx, apps/desktop/src/renderer/components/chat/ShareMessageCheckbox.tsx, apps/desktop/src/renderer/components/chat/ShareSelectionBar.tsx, apps/desktop/src/renderer/components/chat/SlackIcon.tsx, apps/desktop/src/renderer/components/chat/StreamFadeSpan.tsx, apps/desktop/src/renderer/components/chat/StreamingMarkdownChunk.tsx, apps/desktop/src/renderer/components/chat/SystemCard.tsx, apps/desktop/src/renderer/components/chat/TextLightbox.tsx, apps/desktop/src/renderer/components/chat/ThinkingCard.tsx, apps/desktop/src/renderer/components/chat/ThinkingText.tsx, apps/desktop/src/renderer/components/chat/TodoListCard.tsx, apps/desktop/src/renderer/components/chat/ToolCallCard.tsx, apps/desktop/src/renderer/components/chat/ToolPayloadLightbox.tsx, apps/desktop/src/renderer/components/chat/TopRightChipStack.tsx, apps/desktop/src/renderer/components/chat/TurnChangesCard.tsx, apps/desktop/src/renderer/components/chat/UnreadFailedScheduleBanner.tsx, apps/desktop/src/renderer/components/chat/UpgradeBanner.tsx, apps/desktop/src/renderer/components/chat/UserAttachmentChip.tsx, apps/desktop/src/renderer/components/chat/UserMessage.tsx, apps/desktop/src/renderer/components/chat/UserMessageEditBox.tsx, apps/desktop/src/renderer/components/chat/UserMessageUrlLink.tsx, apps/desktop/src/renderer/components/chat/VideoLightbox.tsx, apps/desktop/src/renderer/components/chat/WorkGroupBlock.tsx, apps/desktop/src/renderer/components/chat/WorktreeRestoreBanner.tsx, apps/desktop/src/renderer/components/chat/XIcon.tsx, apps/desktop/src/renderer/components/chat/activityRowChrome.ts, apps/desktop/src/renderer/components/chat/autoFollowIntent.ts, apps/desktop/src/renderer/components/chat/chatChrome.ts, apps/desktop/src/renderer/components/chat/errorReasonI18n.ts, apps/desktop/src/renderer/components/chat/generatedFilesProjection.ts, apps/desktop/src/renderer/components/chat/imageDisplaySize.ts, apps/desktop/src/renderer/components/chat/lightboxAnnotations.ts, apps/desktop/src/renderer/components/chat/lightboxGestures.ts, apps/desktop/src/renderer/components/chat/markdownImageTargets.ts, apps/desktop/src/renderer/components/chat/messageNavRailModel.ts, apps/desktop/src/renderer/components/chat/messageNavRailWheel.ts, apps/desktop/src/renderer/components/chat/messageNavigationProjection.ts, apps/desktop/src/renderer/components/chat/messageProjectionCache.ts, apps/desktop/src/renderer/components/chat/messageStreamIndicatorPosition.ts, apps/desktop/src/renderer/components/chat/messageViewportCompensation.ts, apps/desktop/src/renderer/components/chat/messageWorkGroups.ts, apps/desktop/src/renderer/components/chat/rehypeFencedCodeMarker.ts, apps/desktop/src/renderer/components/chat/rehypeHighlightShared.ts, apps/desktop/src/renderer/components/chat/rehypeMathBlockMarker.ts, apps/desktop/src/renderer/components/chat/rehypeStreamWordFade.ts, apps/desktop/src/renderer/components/chat/remarkHtmlImages.ts, apps/desktop/src/renderer/components/chat/remarkLocalPathLinks.ts, apps/desktop/src/renderer/components/chat/remarkPreserveRawLocalDestinations.ts, apps/desktop/src/renderer/components/chat/remarkSessionLinks.ts, apps/desktop/src/renderer/components/chat/remarkStrictInlineMath.ts, apps/desktop/src/renderer/components/chat/remarkTruncateCjkUrls.ts, apps/desktop/src/renderer/components/chat/repairStreamingMarkdown.ts, apps/desktop/src/renderer/components/chat/scrollAnchoringDetect.ts, apps/desktop/src/renderer/components/chat/shareSelectionStore.ts, apps/desktop/src/renderer/components/chat/streamingMarkdownBlocks.tsx, apps/desktop/src/renderer/components/chat/streamingMarkdownChunks.ts, apps/desktop/src/renderer/components/chat/streamingMessageProjection.ts, apps/desktop/src/renderer/components/chat/toolLoopI18n.ts, apps/desktop/src/renderer/components/chat/unreadCount.ts, apps/desktop/src/renderer/components/chat/useAutomaticHistoryLoadBudget.ts, apps/desktop/src/renderer/components/chat/useCopyAsImage.tsx, apps/desktop/src/renderer/components/chat/useDeleteMessage.ts, apps/desktop/src/renderer/components/chat/useFileChipContextMenu.tsx, apps/desktop/src/renderer/components/chat/useForkAtMessage.ts, apps/desktop/src/renderer/components/chat/useNavigationKeyListener.ts, apps/desktop/src/renderer/components/chat/useOpenWithMenu.tsx, apps/desktop/src/renderer/components/chat/usePrevUserMessageInView.ts, apps/desktop/src/renderer/components/chat/useTurnChangeSets.ts, apps/desktop/src/renderer/components/chat/userMessageCollapse.ts, apps/desktop/src/renderer/components/chat/userMessageDisplayText.ts, apps/desktop/src/renderer/components/chat/userMessageLinkify.ts, apps/desktop/src/renderer/components/chat/viewportFillDetect.ts, apps/desktop/src/renderer/components/new-chat/AddRemoteProjectDialog.tsx, apps/desktop/src/renderer/components/new-chat/AgentSelect.tsx, apps/desktop/src/renderer/components/new-chat/AskUserQuestionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/AtMentionPanel.tsx, apps/desktop/src/renderer/components/new-chat/AttachmentTypeThumb.tsx, apps/desktop/src/renderer/components/new-chat/ChatInput.tsx, apps/desktop/src/renderer/components/new-chat/CjkPunctDecoration.ts, apps/desktop/src/renderer/components/new-chat/CjkPunctuationUtils.ts, apps/desktop/src/renderer/components/new-chat/ComposerAttachments.tsx, apps/desktop/src/renderer/components/new-chat/ComposerListIndentDecoration.ts, apps/desktop/src/renderer/components/new-chat/ComposerListNodes.ts, apps/desktop/src/renderer/components/new-chat/ComposerQuoteNode.tsx, apps/desktop/src/renderer/components/new-chat/DeviceSwitcherPill.tsx, apps/desktop/src/renderer/components/new-chat/EffortSlider.tsx, apps/desktop/src/renderer/components/new-chat/EmptyDocSelectionGuard.ts, apps/desktop/src/renderer/components/new-chat/ExtraDirsButton.tsx, apps/desktop/src/renderer/components/new-chat/FastModeToggle.tsx, apps/desktop/src/renderer/components/new-chat/FolderPickerPopover.tsx, apps/desktop/src/renderer/components/new-chat/FullAccessConfirmContent.tsx, apps/desktop/src/renderer/components/new-chat/GhostCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/GoalAdvancedLimits.tsx, apps/desktop/src/renderer/components/new-chat/GoalIndicator.tsx, apps/desktop/src/renderer/components/new-chat/HomeUsageDashboard.tsx, apps/desktop/src/renderer/components/new-chat/ListComposerTextarea.tsx, apps/desktop/src/renderer/components/new-chat/LocalModelCatalogNotice.tsx, apps/desktop/src/renderer/components/new-chat/MentionChipNode.tsx, apps/desktop/src/renderer/components/new-chat/MentionDragCaretDecoration.ts, apps/desktop/src/renderer/components/new-chat/ModelCompatibilityNotice.tsx, apps/desktop/src/renderer/components/new-chat/ModelConfigFlyout.tsx, apps/desktop/src/renderer/components/new-chat/ModelHarnessPicker.tsx, apps/desktop/src/renderer/components/new-chat/ModelSelector.tsx, apps/desktop/src/renderer/components/new-chat/ModelSourceDetails.tsx, apps/desktop/src/renderer/components/new-chat/NewGoalDialog.tsx, apps/desktop/src/renderer/components/new-chat/PastedTextChipNode.tsx, apps/desktop/src/renderer/components/new-chat/PendingQueuePanel.tsx, apps/desktop/src/renderer/components/new-chat/PermissionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/PermissionSelector.tsx, apps/desktop/src/renderer/components/new-chat/PinnedPlanPanel.tsx, apps/desktop/src/renderer/components/new-chat/PlanActionCard.tsx, apps/desktop/src/renderer/components/new-chat/PlanModeIndicator.tsx, apps/desktop/src/renderer/components/new-chat/PlanViewerCard.tsx, apps/desktop/src/renderer/components/new-chat/PluginConnectionForm.tsx, apps/desktop/src/renderer/components/new-chat/PluginOauthDeviceCode.tsx, apps/desktop/src/renderer/components/new-chat/PluginSetupPrompt.tsx, apps/desktop/src/renderer/components/new-chat/PluginWriteAccessRecovery.tsx, apps/desktop/src/renderer/components/new-chat/QuickStartPillMark.ts, apps/desktop/src/renderer/components/new-chat/RemoteOauthSetupCard.tsx, apps/desktop/src/renderer/components/new-chat/SendButton.tsx, apps/desktop/src/renderer/components/new-chat/SlashCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/SlashCommandPalette.tsx, apps/desktop/src/renderer/components/new-chat/TakeoverMask.tsx, apps/desktop/src/renderer/components/new-chat/ThinkingToggle.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedFlyoutHost.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelPanel.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRail.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRow.tsx, apps/desktop/src/renderer/components/new-chat/UsageDailyBars.tsx, apps/desktop/src/renderer/components/new-chat/UsageHeatmap.tsx, apps/desktop/src/renderer/components/new-chat/VendorSegmentedSwitcher.tsx, apps/desktop/src/renderer/components/new-chat/VoiceInputDraftDecoration.ts, apps/desktop/src/renderer/components/new-chat/WindowsSelectionReplacement.ts, apps/desktop/src/renderer/components/new-chat/WorktreeChipsRow.tsx, apps/desktop/src/renderer/components/new-chat/WorktreeCreatingOverlay.tsx, apps/desktop/src/renderer/components/new-chat/agentOptions.ts, apps/desktop/src/renderer/components/new-chat/agentSwitchConfirmation.ts, apps/desktop/src/renderer/components/new-chat/branchPick.ts, apps/desktop/src/renderer/components/new-chat/composerBlankPointerFocus.ts, apps/desktop/src/renderer/components/new-chat/composerContentSerialization.ts, apps/desktop/src/renderer/components/new-chat/composerDocState.ts, apps/desktop/src/renderer/components/new-chat/composerFrameScheduler.ts, apps/desktop/src/renderer/components/new-chat/composerHistoryProjection.ts, apps/desktop/src/renderer/components/new-chat/composerModelSelection.ts, apps/desktop/src/renderer/components/new-chat/composerPromptRecommendation.ts, apps/desktop/src/renderer/components/new-chat/composerRenderGate.ts, apps/desktop/src/renderer/components/new-chat/composerSendOwnership.ts, apps/desktop/src/renderer/components/new-chat/composerSendSnapshot.ts, apps/desktop/src/renderer/components/new-chat/effortChangeQueue.ts, apps/desktop/src/renderer/components/new-chat/extraDirsActions.ts, apps/desktop/src/renderer/components/new-chat/ghostComposerPlacement.ts, apps/desktop/src/renderer/components/new-chat/localAttachmentPicker.ts, apps/desktop/src/renderer/components/new-chat/mentionChipInsertion.ts, apps/desktop/src/renderer/components/new-chat/modelWindowErrorToast.ts, apps/desktop/src/renderer/components/new-chat/pastePipeline.ts, apps/desktop/src/renderer/components/new-chat/pathPaste.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueLocks.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowActivity.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowPresentation.ts, apps/desktop/src/renderer/components/new-chat/planModeComposerCommand.ts, apps/desktop/src/renderer/components/new-chat/priceTierMarks.tsx, apps/desktop/src/renderer/components/new-chat/remoteBrowseAdapters.ts, apps/desktop/src/renderer/components/new-chat/remoteExistingProjects.ts, apps/desktop/src/renderer/components/new-chat/restoreComposerDocument.ts, apps/desktop/src/renderer/components/new-chat/sessionLinkPaste.ts, apps/desktop/src/renderer/components/new-chat/sourceSwitch.ts, apps/desktop/src/renderer/components/new-chat/unifiedModelSelection.ts, apps/desktop/src/renderer/components/new-chat/usagePalette.ts, apps/desktop/src/renderer/components/new-chat/useComposerSendFocusRestore.ts, apps/desktop/src/renderer/components/new-chat/useModelDiscoveryPending.ts, apps/desktop/src/renderer/components/new-chat/useProviderWeeklyQuota.ts, apps/desktop/src/renderer/components/new-chat/useUnifiedRowActions.ts, apps/desktop/src/renderer/features/bots/BotAuthorizationCard.tsx, apps/desktop/src/renderer/features/bots/BotAvatar.tsx, apps/desktop/src/renderer/features/bots/BotBasicProfileFields.tsx, apps/desktop/src/renderer/features/bots/BotCapabilitySettings.tsx, apps/desktop/src/renderer/features/bots/BotCollaborationCard.tsx, apps/desktop/src/renderer/features/bots/BotConnectionStatus.tsx, apps/desktop/src/renderer/features/bots/BotCreateMenu.tsx, apps/desktop/src/renderer/features/bots/BotDeleteDialog.tsx, apps/desktop/src/renderer/features/bots/BotDirectMessageCard.tsx, apps/desktop/src/renderer/features/bots/BotDirectMessageView.tsx, apps/desktop/src/renderer/features/bots/BotFollowMark.tsx, apps/desktop/src/renderer/features/bots/BotGenerationLabel.tsx, apps/desktop/src/renderer/features/bots/BotGroupAvatars.tsx, apps/desktop/src/renderer/features/bots/BotGroupChatView.tsx, apps/desktop/src/renderer/features/bots/BotGroupComposer.tsx, apps/desktop/src/renderer/features/bots/BotGroupCreateDialog.tsx, apps/desktop/src/renderer/features/bots/BotGroupPendingInteraction.tsx, apps/desktop/src/renderer/features/bots/BotGroupPlan.tsx, apps/desktop/src/renderer/features/bots/BotGroupSettingsDrawer.tsx, apps/desktop/src/renderer/features/bots/BotGroupSidebarRow.tsx, apps/desktop/src/renderer/features/bots/BotHistorySessionView.tsx, apps/desktop/src/renderer/features/bots/BotImportForm.tsx, apps/desktop/src/renderer/features/bots/BotInvitationWelcome.tsx, apps/desktop/src/renderer/features/bots/BotLearningFooter.tsx, apps/desktop/src/renderer/features/bots/BotLifecycleSettings.tsx, apps/desktop/src/renderer/features/bots/BotMemorySettings.tsx, apps/desktop/src/renderer/features/bots/BotModelChainEditor.tsx, apps/desktop/src/renderer/features/bots/BotPortraitPicker.tsx, apps/desktop/src/renderer/features/bots/BotRosterView.tsx, apps/desktop/src/renderer/features/bots/BotRoutines.tsx, apps/desktop/src/renderer/features/bots/BotSessionContentHeader.tsx, apps/desktop/src/renderer/features/bots/BotSessionTaskResultCard.tsx, apps/desktop/src/renderer/features/bots/BotSessionView.tsx, apps/desktop/src/renderer/features/bots/BotSettingsBlock.tsx, apps/desktop/src/renderer/features/bots/BotSettingsDrawer.tsx, apps/desktop/src/renderer/features/bots/BotTaskCardHeader.tsx, apps/desktop/src/renderer/features/bots/BotTaskModelEditor.tsx, apps/desktop/src/renderer/features/bots/BotWorkbench.tsx, apps/desktop/src/renderer/features/bots/BotWorkingStatus.tsx, apps/desktop/src/renderer/features/bots/BotsFeatureLayout.tsx, apps/desktop/src/renderer/features/bots/BotsGlobalSettingsSection.tsx, apps/desktop/src/renderer/features/bots/BotsHomeView.tsx, apps/desktop/src/renderer/features/bots/BotsListView.tsx, apps/desktop/src/renderer/features/bots/BotsSidebar.tsx, apps/desktop/src/renderer/features/bots/ChatBotAccessField.tsx, apps/desktop/src/renderer/features/bots/ChatGroupSettings.tsx, apps/desktop/src/renderer/features/bots/ChatServerControls.tsx, apps/desktop/src/renderer/features/bots/ChatThreadPanel.tsx, apps/desktop/src/renderer/features/bots/CindyDevicePicker.tsx, apps/desktop/src/renderer/features/bots/CindyDeviceRow.tsx, apps/desktop/src/renderer/features/bots/RemoteBotSessionView.tsx, apps/desktop/src/renderer/features/bots/RemoteBotSettings.tsx, apps/desktop/src/renderer/features/bots/botAvatarIdentity.ts, apps/desktop/src/renderer/features/bots/botCapabilityDefaults.ts, apps/desktop/src/renderer/features/bots/botChatPresentation.ts, apps/desktop/src/renderer/features/bots/botConversationPresentation.ts, apps/desktop/src/renderer/features/bots/botConversationTimeline.ts, apps/desktop/src/renderer/features/bots/botDelegationLive.ts, apps/desktop/src/renderer/features/bots/botFollowScopes.ts, apps/desktop/src/renderer/features/bots/botGeneratedArtifacts.ts, apps/desktop/src/renderer/features/bots/botGroupAttachments.ts, apps/desktop/src/renderer/features/bots/botGroupLane.ts, apps/desktop/src/renderer/features/bots/botGroupMentions.ts, apps/desktop/src/renderer/features/bots/botGroupPresentation.ts, apps/desktop/src/renderer/features/bots/botGroupStore.ts, apps/desktop/src/renderer/features/bots/botListDisplay.ts, apps/desktop/src/renderer/features/bots/botNavigation.ts, apps/desktop/src/renderer/features/bots/botPronounContext.tsx, apps/desktop/src/renderer/features/bots/botReadState.ts, apps/desktop/src/renderer/features/bots/botRosterDisplay.ts, apps/desktop/src/renderer/features/bots/botSessionOwners.ts, apps/desktop/src/renderer/features/bots/botSettingsAutosave.ts, apps/desktop/src/renderer/features/bots/botStore.ts, apps/desktop/src/renderer/features/bots/botWelcomeContext.ts, apps/desktop/src/renderer/features/bots/botWorkbenchProjection.ts, apps/desktop/src/renderer/features/bots/cindyDeviceRoster.ts, apps/desktop/src/renderer/features/bots/remoteBotRoster.ts, apps/desktop/src/renderer/features/bots/remoteBotSettingsData.ts, apps/desktop/src/renderer/features/bots/useBotGeneratedFileDeliveries.ts, apps/desktop/src/renderer/features/bots/useBotIslandVisibleSession.ts, apps/desktop/src/renderer/features/bots/useBotSettingsAutosave.ts, apps/desktop/src/renderer/features/bots/useBotUnreadSync.ts, apps/desktop/src/renderer/features/bots/useRemoteBots.ts, apps/desktop/src/renderer/features/bots/useWorkingStatusCopy.ts, apps/desktop/src/renderer/features/cc-agent/CCAgentFeatureLayout.tsx, apps/desktop/src/renderer/features/cc-agent/CCAgentSessionView.tsx | 279 | 41 | 478 |
+| `desktop.bots` | desktop | 伙伴(列表 / 对话 / 设置 / 历史 / 伙伴私聊 / 群聊) | hash `/bots`、`/bots/list`、`/bots/:botId`、`/bots/roster` 及伙伴当前/历史任务、伙伴私聊、伙伴群聊路由(BotsFeatureLayout) | BotBasicProfileFields, BotCollaborationCard, BotDirectMessageView, BotGroupChatView, BotGroupCreateDialog, BotGroupSettingsDrawer, BotHistorySessionView, BotLifecycleSettings, BotModelChainEditor, BotRosterView, BotSessionView, BotSettingsDrawer, BotsHomeView, BotsListView, RemoteBotSessionView | apps/desktop/src/renderer/components/chat/AgentActionRow.tsx, apps/desktop/src/renderer/components/chat/AgentActionsBlock.tsx, apps/desktop/src/renderer/components/chat/AgentTaskCard.tsx, apps/desktop/src/renderer/components/chat/AgentTaskLiveDetails.tsx, apps/desktop/src/renderer/components/chat/AnnotationStrokesSvg.tsx, apps/desktop/src/renderer/components/chat/AskUserQuestionBubble.tsx, apps/desktop/src/renderer/components/chat/AssistantMessage.tsx, apps/desktop/src/renderer/components/chat/AutomationOriginBadge.tsx, apps/desktop/src/renderer/components/chat/ChatAudioCard.tsx, apps/desktop/src/renderer/components/chat/ChatDisplaySnapshotContext.tsx, apps/desktop/src/renderer/components/chat/ChatImageView.tsx, apps/desktop/src/renderer/components/chat/ChatSessionFileContext.tsx, apps/desktop/src/renderer/components/chat/ChatSoundEffectCard.tsx, apps/desktop/src/renderer/components/chat/ChatVideoView.tsx, apps/desktop/src/renderer/components/chat/CindyMakeDoctorCard.tsx, apps/desktop/src/renderer/components/chat/CopyAsImageBlock.tsx, apps/desktop/src/renderer/components/chat/CredentialSwitchWaitBanner.tsx, apps/desktop/src/renderer/components/chat/DiffView.tsx, apps/desktop/src/renderer/components/chat/ErrorBanner.tsx, apps/desktop/src/renderer/components/chat/ErrorMessageCard.tsx, apps/desktop/src/renderer/components/chat/GeneratedFilesCard.tsx, apps/desktop/src/renderer/components/chat/GhostCardHostPrompts.tsx, apps/desktop/src/renderer/components/chat/GhostSummonCard.tsx, apps/desktop/src/renderer/components/chat/GhostToolCard.tsx, apps/desktop/src/renderer/components/chat/HookTaskCard.tsx, apps/desktop/src/renderer/components/chat/ImageGalleryContext.tsx, apps/desktop/src/renderer/components/chat/ImageHoverPreview.tsx, apps/desktop/src/renderer/components/chat/ImageLightbox.tsx, apps/desktop/src/renderer/components/chat/ImageMissingPlaceholder.tsx, apps/desktop/src/renderer/components/chat/InlineReferenceChip.tsx, apps/desktop/src/renderer/components/chat/InterruptedTurnBanner.tsx, apps/desktop/src/renderer/components/chat/JumpToBottomChip.tsx, apps/desktop/src/renderer/components/chat/MarkdownDiffBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownMermaidBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownRenderer.tsx, apps/desktop/src/renderer/components/chat/MermaidLightbox.tsx, apps/desktop/src/renderer/components/chat/MessageActionBar.tsx, apps/desktop/src/renderer/components/chat/MessageNavRail.tsx, apps/desktop/src/renderer/components/chat/MessageStream.tsx, apps/desktop/src/renderer/components/chat/MessageViewport.tsx, apps/desktop/src/renderer/components/chat/ModelLightbox.tsx, apps/desktop/src/renderer/components/chat/NewMessageIndicator.tsx, apps/desktop/src/renderer/components/chat/PlanReviewBubble.tsx, apps/desktop/src/renderer/components/chat/PrevMessageJumpChip.tsx, apps/desktop/src/renderer/components/chat/ProjectLinkChip.tsx, apps/desktop/src/renderer/components/chat/QuoteChip.tsx, apps/desktop/src/renderer/components/chat/RewindPreviewDialog.tsx, apps/desktop/src/renderer/components/chat/SelectionQuoteButton.tsx, apps/desktop/src/renderer/components/chat/SentAgentReferenceChip.tsx, apps/desktop/src/renderer/components/chat/SentInlineAtomBody.tsx, apps/desktop/src/renderer/components/chat/SessionHandoffCard.tsx, apps/desktop/src/renderer/components/chat/SessionLinkChip.tsx, apps/desktop/src/renderer/components/chat/ShareMessageCheckbox.tsx, apps/desktop/src/renderer/components/chat/ShareSelectionBar.tsx, apps/desktop/src/renderer/components/chat/SlackIcon.tsx, apps/desktop/src/renderer/components/chat/StreamFadeSpan.tsx, apps/desktop/src/renderer/components/chat/StreamingMarkdownChunk.tsx, apps/desktop/src/renderer/components/chat/SystemCard.tsx, apps/desktop/src/renderer/components/chat/TextLightbox.tsx, apps/desktop/src/renderer/components/chat/ThinkingCard.tsx, apps/desktop/src/renderer/components/chat/ThinkingText.tsx, apps/desktop/src/renderer/components/chat/TodoListCard.tsx, apps/desktop/src/renderer/components/chat/ToolCallCard.tsx, apps/desktop/src/renderer/components/chat/ToolPayloadLightbox.tsx, apps/desktop/src/renderer/components/chat/TopRightChipStack.tsx, apps/desktop/src/renderer/components/chat/TurnChangesCard.tsx, apps/desktop/src/renderer/components/chat/UnreadFailedScheduleBanner.tsx, apps/desktop/src/renderer/components/chat/UpgradeBanner.tsx, apps/desktop/src/renderer/components/chat/UserAttachmentChip.tsx, apps/desktop/src/renderer/components/chat/UserMessage.tsx, apps/desktop/src/renderer/components/chat/UserMessageEditBox.tsx, apps/desktop/src/renderer/components/chat/UserMessageUrlLink.tsx, apps/desktop/src/renderer/components/chat/VideoLightbox.tsx, apps/desktop/src/renderer/components/chat/WorkGroupBlock.tsx, apps/desktop/src/renderer/components/chat/WorktreeRestoreBanner.tsx, apps/desktop/src/renderer/components/chat/XIcon.tsx, apps/desktop/src/renderer/components/chat/activityRowChrome.ts, apps/desktop/src/renderer/components/chat/animateFocusScroll.ts, apps/desktop/src/renderer/components/chat/autoFollowIntent.ts, apps/desktop/src/renderer/components/chat/chatChrome.ts, apps/desktop/src/renderer/components/chat/errorReasonI18n.ts, apps/desktop/src/renderer/components/chat/generatedFilesProjection.ts, apps/desktop/src/renderer/components/chat/imageDisplaySize.ts, apps/desktop/src/renderer/components/chat/lightboxAnnotations.ts, apps/desktop/src/renderer/components/chat/lightboxGestures.ts, apps/desktop/src/renderer/components/chat/markdownImageTargets.ts, apps/desktop/src/renderer/components/chat/messageNavRailModel.ts, apps/desktop/src/renderer/components/chat/messageNavRailWheel.ts, apps/desktop/src/renderer/components/chat/messageNavigationProjection.ts, apps/desktop/src/renderer/components/chat/messageProjectionCache.ts, apps/desktop/src/renderer/components/chat/messageStreamIndicatorPosition.ts, apps/desktop/src/renderer/components/chat/messageViewportCompensation.ts, apps/desktop/src/renderer/components/chat/messageViewportGeometry.ts, apps/desktop/src/renderer/components/chat/messageWorkGroups.ts, apps/desktop/src/renderer/components/chat/observeProgrammaticScroll.ts, apps/desktop/src/renderer/components/chat/rehypeFencedCodeMarker.ts, apps/desktop/src/renderer/components/chat/rehypeHighlightShared.ts, apps/desktop/src/renderer/components/chat/rehypeMathBlockMarker.ts, apps/desktop/src/renderer/components/chat/rehypeStreamWordFade.ts, apps/desktop/src/renderer/components/chat/remarkHtmlImages.ts, apps/desktop/src/renderer/components/chat/remarkLocalPathLinks.ts, apps/desktop/src/renderer/components/chat/remarkPreserveRawLocalDestinations.ts, apps/desktop/src/renderer/components/chat/remarkSessionLinks.ts, apps/desktop/src/renderer/components/chat/remarkStrictInlineMath.ts, apps/desktop/src/renderer/components/chat/remarkTruncateCjkUrls.ts, apps/desktop/src/renderer/components/chat/repairStreamingMarkdown.ts, apps/desktop/src/renderer/components/chat/scrollAnchoringDetect.ts, apps/desktop/src/renderer/components/chat/shareSelectionStore.ts, apps/desktop/src/renderer/components/chat/streamingMarkdownBlocks.tsx, apps/desktop/src/renderer/components/chat/streamingMarkdownChunks.ts, apps/desktop/src/renderer/components/chat/streamingMessageProjection.ts, apps/desktop/src/renderer/components/chat/toolLoopI18n.ts, apps/desktop/src/renderer/components/chat/unreadCount.ts, apps/desktop/src/renderer/components/chat/useAutomaticHistoryLoadBudget.ts, apps/desktop/src/renderer/components/chat/useCopyAsImage.tsx, apps/desktop/src/renderer/components/chat/useDeleteMessage.ts, apps/desktop/src/renderer/components/chat/useFileChipContextMenu.tsx, apps/desktop/src/renderer/components/chat/useForkAtMessage.ts, apps/desktop/src/renderer/components/chat/useMessageViewport.ts, apps/desktop/src/renderer/components/chat/useNavigationKeyListener.ts, apps/desktop/src/renderer/components/chat/useOpenWithMenu.tsx, apps/desktop/src/renderer/components/chat/usePrevUserMessageInView.ts, apps/desktop/src/renderer/components/chat/useTurnChangeSets.ts, apps/desktop/src/renderer/components/chat/userMessageCollapse.ts, apps/desktop/src/renderer/components/chat/userMessageDisplayText.ts, apps/desktop/src/renderer/components/chat/userMessageLinkify.ts, apps/desktop/src/renderer/components/chat/viewportFillDetect.ts, apps/desktop/src/renderer/components/new-chat/AddRemoteProjectDialog.tsx, apps/desktop/src/renderer/components/new-chat/AgentSelect.tsx, apps/desktop/src/renderer/components/new-chat/AskUserQuestionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/AtMentionPanel.tsx, apps/desktop/src/renderer/components/new-chat/AttachmentTypeThumb.tsx, apps/desktop/src/renderer/components/new-chat/ChatInput.tsx, apps/desktop/src/renderer/components/new-chat/CjkPunctDecoration.ts, apps/desktop/src/renderer/components/new-chat/CjkPunctuationUtils.ts, apps/desktop/src/renderer/components/new-chat/ComposerAttachments.tsx, apps/desktop/src/renderer/components/new-chat/ComposerListIndentDecoration.ts, apps/desktop/src/renderer/components/new-chat/ComposerListNodes.ts, apps/desktop/src/renderer/components/new-chat/ComposerQuoteNode.tsx, apps/desktop/src/renderer/components/new-chat/DeviceSwitcherPill.tsx, apps/desktop/src/renderer/components/new-chat/EffortSlider.tsx, apps/desktop/src/renderer/components/new-chat/EmptyDocSelectionGuard.ts, apps/desktop/src/renderer/components/new-chat/ExtraDirsButton.tsx, apps/desktop/src/renderer/components/new-chat/FastModeToggle.tsx, apps/desktop/src/renderer/components/new-chat/FolderPickerPopover.tsx, apps/desktop/src/renderer/components/new-chat/FullAccessConfirmContent.tsx, apps/desktop/src/renderer/components/new-chat/GhostCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/GoalAdvancedLimits.tsx, apps/desktop/src/renderer/components/new-chat/GoalIndicator.tsx, apps/desktop/src/renderer/components/new-chat/HomeUsageDashboard.tsx, apps/desktop/src/renderer/components/new-chat/ListComposerTextarea.tsx, apps/desktop/src/renderer/components/new-chat/LocalModelCatalogNotice.tsx, apps/desktop/src/renderer/components/new-chat/MentionChipNode.tsx, apps/desktop/src/renderer/components/new-chat/MentionDragCaretDecoration.ts, apps/desktop/src/renderer/components/new-chat/ModelCompatibilityNotice.tsx, apps/desktop/src/renderer/components/new-chat/ModelConfigFlyout.tsx, apps/desktop/src/renderer/components/new-chat/ModelHarnessPicker.tsx, apps/desktop/src/renderer/components/new-chat/ModelSelector.tsx, apps/desktop/src/renderer/components/new-chat/ModelSourceDetails.tsx, apps/desktop/src/renderer/components/new-chat/NewGoalDialog.tsx, apps/desktop/src/renderer/components/new-chat/PastedTextChipNode.tsx, apps/desktop/src/renderer/components/new-chat/PendingQueuePanel.tsx, apps/desktop/src/renderer/components/new-chat/PermissionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/PermissionSelector.tsx, apps/desktop/src/renderer/components/new-chat/PinnedPlanPanel.tsx, apps/desktop/src/renderer/components/new-chat/PlanActionCard.tsx, apps/desktop/src/renderer/components/new-chat/PlanModeIndicator.tsx, apps/desktop/src/renderer/components/new-chat/PlanViewerCard.tsx, apps/desktop/src/renderer/components/new-chat/PluginConnectionForm.tsx, apps/desktop/src/renderer/components/new-chat/PluginOauthDeviceCode.tsx, apps/desktop/src/renderer/components/new-chat/PluginSetupPrompt.tsx, apps/desktop/src/renderer/components/new-chat/PluginWriteAccessRecovery.tsx, apps/desktop/src/renderer/components/new-chat/QuickStartPillMark.ts, apps/desktop/src/renderer/components/new-chat/RemoteOauthSetupCard.tsx, apps/desktop/src/renderer/components/new-chat/SendButton.tsx, apps/desktop/src/renderer/components/new-chat/SlashCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/SlashCommandPalette.tsx, apps/desktop/src/renderer/components/new-chat/TakeoverMask.tsx, apps/desktop/src/renderer/components/new-chat/ThinkingToggle.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedFlyoutHost.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelPanel.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRail.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRow.tsx, apps/desktop/src/renderer/components/new-chat/UsageDailyBars.tsx, apps/desktop/src/renderer/components/new-chat/UsageHeatmap.tsx, apps/desktop/src/renderer/components/new-chat/VendorSegmentedSwitcher.tsx, apps/desktop/src/renderer/components/new-chat/VoiceInputDraftDecoration.ts, apps/desktop/src/renderer/components/new-chat/WindowsSelectionReplacement.ts, apps/desktop/src/renderer/components/new-chat/WorktreeChipsRow.tsx, apps/desktop/src/renderer/components/new-chat/WorktreeCreatingOverlay.tsx, apps/desktop/src/renderer/components/new-chat/agentOptions.ts, apps/desktop/src/renderer/components/new-chat/agentSwitchConfirmation.ts, apps/desktop/src/renderer/components/new-chat/branchPick.ts, apps/desktop/src/renderer/components/new-chat/composerBlankPointerFocus.ts, apps/desktop/src/renderer/components/new-chat/composerContentSerialization.ts, apps/desktop/src/renderer/components/new-chat/composerDocState.ts, apps/desktop/src/renderer/components/new-chat/composerFrameScheduler.ts, apps/desktop/src/renderer/components/new-chat/composerHistoryProjection.ts, apps/desktop/src/renderer/components/new-chat/composerModelSelection.ts, apps/desktop/src/renderer/components/new-chat/composerPromptRecommendation.ts, apps/desktop/src/renderer/components/new-chat/composerRenderGate.ts, apps/desktop/src/renderer/components/new-chat/composerSendOwnership.ts, apps/desktop/src/renderer/components/new-chat/composerSendSnapshot.ts, apps/desktop/src/renderer/components/new-chat/effortChangeQueue.ts, apps/desktop/src/renderer/components/new-chat/extraDirsActions.ts, apps/desktop/src/renderer/components/new-chat/ghostComposerPlacement.ts, apps/desktop/src/renderer/components/new-chat/localAttachmentPicker.ts, apps/desktop/src/renderer/components/new-chat/mentionChipInsertion.ts, apps/desktop/src/renderer/components/new-chat/modelWindowErrorToast.ts, apps/desktop/src/renderer/components/new-chat/pastePipeline.ts, apps/desktop/src/renderer/components/new-chat/pathPaste.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueLocks.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowActivity.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowPresentation.ts, apps/desktop/src/renderer/components/new-chat/planModeComposerCommand.ts, apps/desktop/src/renderer/components/new-chat/priceTierMarks.tsx, apps/desktop/src/renderer/components/new-chat/remoteBrowseAdapters.ts, apps/desktop/src/renderer/components/new-chat/remoteExistingProjects.ts, apps/desktop/src/renderer/components/new-chat/restoreComposerDocument.ts, apps/desktop/src/renderer/components/new-chat/sessionLinkPaste.ts, apps/desktop/src/renderer/components/new-chat/sourceSwitch.ts, apps/desktop/src/renderer/components/new-chat/unifiedModelSelection.ts, apps/desktop/src/renderer/components/new-chat/usagePalette.ts, apps/desktop/src/renderer/components/new-chat/useComposerSendFocusRestore.ts, apps/desktop/src/renderer/components/new-chat/useModelDiscoveryPending.ts, apps/desktop/src/renderer/components/new-chat/useProviderWeeklyQuota.ts, apps/desktop/src/renderer/components/new-chat/useUnifiedRowActions.ts, apps/desktop/src/renderer/features/bots/BotAuthorizationCard.tsx, apps/desktop/src/renderer/features/bots/BotAvatar.tsx, apps/desktop/src/renderer/features/bots/BotBasicProfileFields.tsx, apps/desktop/src/renderer/features/bots/BotCapabilitySettings.tsx, apps/desktop/src/renderer/features/bots/BotCollaborationCard.tsx, apps/desktop/src/renderer/features/bots/BotConnectionStatus.tsx, apps/desktop/src/renderer/features/bots/BotCreateMenu.tsx, apps/desktop/src/renderer/features/bots/BotDeleteDialog.tsx, apps/desktop/src/renderer/features/bots/BotDirectMessageCard.tsx, apps/desktop/src/renderer/features/bots/BotDirectMessageView.tsx, apps/desktop/src/renderer/features/bots/BotFollowMark.tsx, apps/desktop/src/renderer/features/bots/BotGenerationLabel.tsx, apps/desktop/src/renderer/features/bots/BotGroupAvatars.tsx, apps/desktop/src/renderer/features/bots/BotGroupChatView.tsx, apps/desktop/src/renderer/features/bots/BotGroupComposer.tsx, apps/desktop/src/renderer/features/bots/BotGroupCreateDialog.tsx, apps/desktop/src/renderer/features/bots/BotGroupPendingInteraction.tsx, apps/desktop/src/renderer/features/bots/BotGroupPlan.tsx, apps/desktop/src/renderer/features/bots/BotGroupSettingsDrawer.tsx, apps/desktop/src/renderer/features/bots/BotGroupSidebarRow.tsx, apps/desktop/src/renderer/features/bots/BotHistorySessionView.tsx, apps/desktop/src/renderer/features/bots/BotImportForm.tsx, apps/desktop/src/renderer/features/bots/BotInvitationWelcome.tsx, apps/desktop/src/renderer/features/bots/BotLearningFooter.tsx, apps/desktop/src/renderer/features/bots/BotLifecycleSettings.tsx, apps/desktop/src/renderer/features/bots/BotMemorySettings.tsx, apps/desktop/src/renderer/features/bots/BotModelChainEditor.tsx, apps/desktop/src/renderer/features/bots/BotPortraitPicker.tsx, apps/desktop/src/renderer/features/bots/BotRosterView.tsx, apps/desktop/src/renderer/features/bots/BotRoutines.tsx, apps/desktop/src/renderer/features/bots/BotSessionContentHeader.tsx, apps/desktop/src/renderer/features/bots/BotSessionTaskResultCard.tsx, apps/desktop/src/renderer/features/bots/BotSessionView.tsx, apps/desktop/src/renderer/features/bots/BotSettingsBlock.tsx, apps/desktop/src/renderer/features/bots/BotSettingsDrawer.tsx, apps/desktop/src/renderer/features/bots/BotTaskCardHeader.tsx, apps/desktop/src/renderer/features/bots/BotTaskModelEditor.tsx, apps/desktop/src/renderer/features/bots/BotWorkbench.tsx, apps/desktop/src/renderer/features/bots/BotWorkingStatus.tsx, apps/desktop/src/renderer/features/bots/BotsFeatureLayout.tsx, apps/desktop/src/renderer/features/bots/BotsGlobalSettingsSection.tsx, apps/desktop/src/renderer/features/bots/BotsHomeView.tsx, apps/desktop/src/renderer/features/bots/BotsListView.tsx, apps/desktop/src/renderer/features/bots/BotsSidebar.tsx, apps/desktop/src/renderer/features/bots/ChatBotAccessField.tsx, apps/desktop/src/renderer/features/bots/ChatGroupSettings.tsx, apps/desktop/src/renderer/features/bots/ChatServerControls.tsx, apps/desktop/src/renderer/features/bots/ChatThreadPanel.tsx, apps/desktop/src/renderer/features/bots/CindyDevicePicker.tsx, apps/desktop/src/renderer/features/bots/CindyDeviceRow.tsx, apps/desktop/src/renderer/features/bots/RemoteBotSessionView.tsx, apps/desktop/src/renderer/features/bots/RemoteBotSettings.tsx, apps/desktop/src/renderer/features/bots/botAvatarIdentity.ts, apps/desktop/src/renderer/features/bots/botCapabilityDefaults.ts, apps/desktop/src/renderer/features/bots/botChatPresentation.ts, apps/desktop/src/renderer/features/bots/botConversationPresentation.ts, apps/desktop/src/renderer/features/bots/botConversationTimeline.ts, apps/desktop/src/renderer/features/bots/botDelegationLive.ts, apps/desktop/src/renderer/features/bots/botFollowScopes.ts, apps/desktop/src/renderer/features/bots/botGeneratedArtifacts.ts, apps/desktop/src/renderer/features/bots/botGroupAttachments.ts, apps/desktop/src/renderer/features/bots/botGroupLane.ts, apps/desktop/src/renderer/features/bots/botGroupMentions.ts, apps/desktop/src/renderer/features/bots/botGroupPresentation.ts, apps/desktop/src/renderer/features/bots/botGroupStore.ts, apps/desktop/src/renderer/features/bots/botListDisplay.ts, apps/desktop/src/renderer/features/bots/botNavigation.ts, apps/desktop/src/renderer/features/bots/botPronounContext.tsx, apps/desktop/src/renderer/features/bots/botReadState.ts, apps/desktop/src/renderer/features/bots/botRosterDisplay.ts, apps/desktop/src/renderer/features/bots/botSessionOwners.ts, apps/desktop/src/renderer/features/bots/botSettingsAutosave.ts, apps/desktop/src/renderer/features/bots/botStore.ts, apps/desktop/src/renderer/features/bots/botWelcomeContext.ts, apps/desktop/src/renderer/features/bots/botWorkbenchProjection.ts, apps/desktop/src/renderer/features/bots/cindyDeviceRoster.ts, apps/desktop/src/renderer/features/bots/remoteBotRoster.ts, apps/desktop/src/renderer/features/bots/remoteBotSettingsData.ts, apps/desktop/src/renderer/features/bots/useBotGeneratedFileDeliveries.ts, apps/desktop/src/renderer/features/bots/useBotIslandVisibleSession.ts, apps/desktop/src/renderer/features/bots/useBotSettingsAutosave.ts, apps/desktop/src/renderer/features/bots/useBotUnreadSync.ts, apps/desktop/src/renderer/features/bots/useRemoteBots.ts, apps/desktop/src/renderer/features/bots/useWorkingStatusCopy.ts, apps/desktop/src/renderer/features/cc-agent/CCAgentFeatureLayout.tsx, apps/desktop/src/renderer/features/cc-agent/CCAgentSessionView.tsx | 279 | 41 | 478 |
| `desktop.chat.files` | desktop | 工作目录文件浏览 | hash `/cc-agent/files/:sessionId`(WorkdirBrowseRoute) | FileBodyView, FileTreeView, WorkdirBrowseRoute | apps/desktop/src/renderer/features/cc-agent/workdir-browse/DocSearchBar.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/DrawioPreview.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/FileBodyView.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/FileFilterInput.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/FileTabsBar.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/FileTreeView.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/FilterResultList.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/ImagePreview.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/OpenInSystemActions.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/PdfPreview.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/SessionTabsBar.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/UnrenderablePlaceholder.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/WorkdirBrowseRoute.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/WorkdirBrowseSidebar.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useChatRailCollapsed.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useChatRailResize.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useConfirmSwitchAwayIfDirty.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useDelayedFlag.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useFileContent.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useFileTree.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useOpenTabs.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useProjectFileList.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useRevealFileInTree.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/activeFileBodyHandle.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/docModeSwitchProjects.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/drawioExt.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/expandedStore.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/fileContentCache.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/fileIcon.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/fileMeta.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/fileScrollStore.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/fileSelectionParams.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/filterFiles.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/imageExt.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/markdownAutosave.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/openTabsStore.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/pdfExt.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/selectedFileStore.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/search/SearchInput.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/search/SearchPanel.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/search/SearchResults.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/search/hooks/useProjectSearch.ts | 17 | 7 | 45 |
| `desktop.chat.new-draft` | desktop | 新建任务草稿页 | hash `/cc-agent/new`(NewMakerDraftRoute) | NewMakerDraftRoute | apps/desktop/src/renderer/features/cc-agent/NewMakerDraftRoute.tsx | 15 | 0 | 2 |
-| `desktop.chat.orca-workflow` | desktop | Orca 协同工作台 | hash `/cc-agent/orca/:sessionId`(OrcaWorkflowRoute) | CCAgentSessionView, OrcaSplitView, OrcaWorkerPanel, OrcaWorkflowRoute | apps/desktop/src/renderer/components/chat/AgentActionRow.tsx, apps/desktop/src/renderer/components/chat/AgentActionsBlock.tsx, apps/desktop/src/renderer/components/chat/AgentTaskCard.tsx, apps/desktop/src/renderer/components/chat/AgentTaskLiveDetails.tsx, apps/desktop/src/renderer/components/chat/AnnotationStrokesSvg.tsx, apps/desktop/src/renderer/components/chat/AskUserQuestionBubble.tsx, apps/desktop/src/renderer/components/chat/AssistantMessage.tsx, apps/desktop/src/renderer/components/chat/AutomationOriginBadge.tsx, apps/desktop/src/renderer/components/chat/ChatAudioCard.tsx, apps/desktop/src/renderer/components/chat/ChatDisplaySnapshotContext.tsx, apps/desktop/src/renderer/components/chat/ChatImageView.tsx, apps/desktop/src/renderer/components/chat/ChatSessionFileContext.tsx, apps/desktop/src/renderer/components/chat/ChatSoundEffectCard.tsx, apps/desktop/src/renderer/components/chat/ChatVideoView.tsx, apps/desktop/src/renderer/components/chat/CindyMakeDoctorCard.tsx, apps/desktop/src/renderer/components/chat/CopyAsImageBlock.tsx, apps/desktop/src/renderer/components/chat/CredentialSwitchWaitBanner.tsx, apps/desktop/src/renderer/components/chat/DiffView.tsx, apps/desktop/src/renderer/components/chat/ErrorBanner.tsx, apps/desktop/src/renderer/components/chat/ErrorMessageCard.tsx, apps/desktop/src/renderer/components/chat/GeneratedFilesCard.tsx, apps/desktop/src/renderer/components/chat/GhostCardHostPrompts.tsx, apps/desktop/src/renderer/components/chat/GhostSummonCard.tsx, apps/desktop/src/renderer/components/chat/GhostToolCard.tsx, apps/desktop/src/renderer/components/chat/HookTaskCard.tsx, apps/desktop/src/renderer/components/chat/ImageGalleryContext.tsx, apps/desktop/src/renderer/components/chat/ImageHoverPreview.tsx, apps/desktop/src/renderer/components/chat/ImageLightbox.tsx, apps/desktop/src/renderer/components/chat/ImageMissingPlaceholder.tsx, apps/desktop/src/renderer/components/chat/InlineReferenceChip.tsx, apps/desktop/src/renderer/components/chat/InterruptedTurnBanner.tsx, apps/desktop/src/renderer/components/chat/JumpToBottomChip.tsx, apps/desktop/src/renderer/components/chat/MarkdownDiffBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownMermaidBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownRenderer.tsx, apps/desktop/src/renderer/components/chat/MermaidLightbox.tsx, apps/desktop/src/renderer/components/chat/MessageActionBar.tsx, apps/desktop/src/renderer/components/chat/MessageNavRail.tsx, apps/desktop/src/renderer/components/chat/MessageStream.tsx, apps/desktop/src/renderer/components/chat/ModelLightbox.tsx, apps/desktop/src/renderer/components/chat/NewMessageIndicator.tsx, apps/desktop/src/renderer/components/chat/PlanReviewBubble.tsx, apps/desktop/src/renderer/components/chat/PrevMessageJumpChip.tsx, apps/desktop/src/renderer/components/chat/ProjectLinkChip.tsx, apps/desktop/src/renderer/components/chat/QuoteChip.tsx, apps/desktop/src/renderer/components/chat/RewindPreviewDialog.tsx, apps/desktop/src/renderer/components/chat/SelectionQuoteButton.tsx, apps/desktop/src/renderer/components/chat/SentAgentReferenceChip.tsx, apps/desktop/src/renderer/components/chat/SentInlineAtomBody.tsx, apps/desktop/src/renderer/components/chat/SessionHandoffCard.tsx, apps/desktop/src/renderer/components/chat/SessionLinkChip.tsx, apps/desktop/src/renderer/components/chat/ShareMessageCheckbox.tsx, apps/desktop/src/renderer/components/chat/ShareSelectionBar.tsx, apps/desktop/src/renderer/components/chat/SlackIcon.tsx, apps/desktop/src/renderer/components/chat/StreamFadeSpan.tsx, apps/desktop/src/renderer/components/chat/StreamingMarkdownChunk.tsx, apps/desktop/src/renderer/components/chat/SystemCard.tsx, apps/desktop/src/renderer/components/chat/TextLightbox.tsx, apps/desktop/src/renderer/components/chat/ThinkingCard.tsx, apps/desktop/src/renderer/components/chat/ThinkingText.tsx, apps/desktop/src/renderer/components/chat/TodoListCard.tsx, apps/desktop/src/renderer/components/chat/ToolCallCard.tsx, apps/desktop/src/renderer/components/chat/ToolPayloadLightbox.tsx, apps/desktop/src/renderer/components/chat/TopRightChipStack.tsx, apps/desktop/src/renderer/components/chat/TurnChangesCard.tsx, apps/desktop/src/renderer/components/chat/UnreadFailedScheduleBanner.tsx, apps/desktop/src/renderer/components/chat/UpgradeBanner.tsx, apps/desktop/src/renderer/components/chat/UserAttachmentChip.tsx, apps/desktop/src/renderer/components/chat/UserMessage.tsx, apps/desktop/src/renderer/components/chat/UserMessageEditBox.tsx, apps/desktop/src/renderer/components/chat/UserMessageUrlLink.tsx, apps/desktop/src/renderer/components/chat/VideoLightbox.tsx, apps/desktop/src/renderer/components/chat/WorkGroupBlock.tsx, apps/desktop/src/renderer/components/chat/WorktreeRestoreBanner.tsx, apps/desktop/src/renderer/components/chat/XIcon.tsx, apps/desktop/src/renderer/components/chat/activityRowChrome.ts, apps/desktop/src/renderer/components/chat/autoFollowIntent.ts, apps/desktop/src/renderer/components/chat/chatChrome.ts, apps/desktop/src/renderer/components/chat/errorReasonI18n.ts, apps/desktop/src/renderer/components/chat/generatedFilesProjection.ts, apps/desktop/src/renderer/components/chat/imageDisplaySize.ts, apps/desktop/src/renderer/components/chat/lightboxAnnotations.ts, apps/desktop/src/renderer/components/chat/lightboxGestures.ts, apps/desktop/src/renderer/components/chat/markdownImageTargets.ts, apps/desktop/src/renderer/components/chat/messageNavRailModel.ts, apps/desktop/src/renderer/components/chat/messageNavRailWheel.ts, apps/desktop/src/renderer/components/chat/messageNavigationProjection.ts, apps/desktop/src/renderer/components/chat/messageProjectionCache.ts, apps/desktop/src/renderer/components/chat/messageStreamIndicatorPosition.ts, apps/desktop/src/renderer/components/chat/messageViewportCompensation.ts, apps/desktop/src/renderer/components/chat/messageWorkGroups.ts, apps/desktop/src/renderer/components/chat/rehypeFencedCodeMarker.ts, apps/desktop/src/renderer/components/chat/rehypeHighlightShared.ts, apps/desktop/src/renderer/components/chat/rehypeMathBlockMarker.ts, apps/desktop/src/renderer/components/chat/rehypeStreamWordFade.ts, apps/desktop/src/renderer/components/chat/remarkHtmlImages.ts, apps/desktop/src/renderer/components/chat/remarkLocalPathLinks.ts, apps/desktop/src/renderer/components/chat/remarkPreserveRawLocalDestinations.ts, apps/desktop/src/renderer/components/chat/remarkSessionLinks.ts, apps/desktop/src/renderer/components/chat/remarkStrictInlineMath.ts, apps/desktop/src/renderer/components/chat/remarkTruncateCjkUrls.ts, apps/desktop/src/renderer/components/chat/repairStreamingMarkdown.ts, apps/desktop/src/renderer/components/chat/scrollAnchoringDetect.ts, apps/desktop/src/renderer/components/chat/shareSelectionStore.ts, apps/desktop/src/renderer/components/chat/streamingMarkdownBlocks.tsx, apps/desktop/src/renderer/components/chat/streamingMarkdownChunks.ts, apps/desktop/src/renderer/components/chat/streamingMessageProjection.ts, apps/desktop/src/renderer/components/chat/toolLoopI18n.ts, apps/desktop/src/renderer/components/chat/unreadCount.ts, apps/desktop/src/renderer/components/chat/useAutomaticHistoryLoadBudget.ts, apps/desktop/src/renderer/components/chat/useCopyAsImage.tsx, apps/desktop/src/renderer/components/chat/useDeleteMessage.ts, apps/desktop/src/renderer/components/chat/useFileChipContextMenu.tsx, apps/desktop/src/renderer/components/chat/useForkAtMessage.ts, apps/desktop/src/renderer/components/chat/useNavigationKeyListener.ts, apps/desktop/src/renderer/components/chat/useOpenWithMenu.tsx, apps/desktop/src/renderer/components/chat/usePrevUserMessageInView.ts, apps/desktop/src/renderer/components/chat/useTurnChangeSets.ts, apps/desktop/src/renderer/components/chat/userMessageCollapse.ts, apps/desktop/src/renderer/components/chat/userMessageDisplayText.ts, apps/desktop/src/renderer/components/chat/userMessageLinkify.ts, apps/desktop/src/renderer/components/chat/viewportFillDetect.ts, apps/desktop/src/renderer/components/new-chat/AddRemoteProjectDialog.tsx, apps/desktop/src/renderer/components/new-chat/AgentSelect.tsx, apps/desktop/src/renderer/components/new-chat/AskUserQuestionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/AtMentionPanel.tsx, apps/desktop/src/renderer/components/new-chat/AttachmentTypeThumb.tsx, apps/desktop/src/renderer/components/new-chat/ChatInput.tsx, apps/desktop/src/renderer/components/new-chat/CjkPunctDecoration.ts, apps/desktop/src/renderer/components/new-chat/CjkPunctuationUtils.ts, apps/desktop/src/renderer/components/new-chat/ComposerAttachments.tsx, apps/desktop/src/renderer/components/new-chat/ComposerListIndentDecoration.ts, apps/desktop/src/renderer/components/new-chat/ComposerListNodes.ts, apps/desktop/src/renderer/components/new-chat/ComposerQuoteNode.tsx, apps/desktop/src/renderer/components/new-chat/DeviceSwitcherPill.tsx, apps/desktop/src/renderer/components/new-chat/EffortSlider.tsx, apps/desktop/src/renderer/components/new-chat/EmptyDocSelectionGuard.ts, apps/desktop/src/renderer/components/new-chat/ExtraDirsButton.tsx, apps/desktop/src/renderer/components/new-chat/FastModeToggle.tsx, apps/desktop/src/renderer/components/new-chat/FolderPickerPopover.tsx, apps/desktop/src/renderer/components/new-chat/FullAccessConfirmContent.tsx, apps/desktop/src/renderer/components/new-chat/GhostCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/GoalAdvancedLimits.tsx, apps/desktop/src/renderer/components/new-chat/GoalIndicator.tsx, apps/desktop/src/renderer/components/new-chat/HomeUsageDashboard.tsx, apps/desktop/src/renderer/components/new-chat/ListComposerTextarea.tsx, apps/desktop/src/renderer/components/new-chat/LocalModelCatalogNotice.tsx, apps/desktop/src/renderer/components/new-chat/MentionChipNode.tsx, apps/desktop/src/renderer/components/new-chat/MentionDragCaretDecoration.ts, apps/desktop/src/renderer/components/new-chat/ModelCompatibilityNotice.tsx, apps/desktop/src/renderer/components/new-chat/ModelConfigFlyout.tsx, apps/desktop/src/renderer/components/new-chat/ModelHarnessPicker.tsx, apps/desktop/src/renderer/components/new-chat/ModelSelector.tsx, apps/desktop/src/renderer/components/new-chat/ModelSourceDetails.tsx, apps/desktop/src/renderer/components/new-chat/NewGoalDialog.tsx, apps/desktop/src/renderer/components/new-chat/PastedTextChipNode.tsx, apps/desktop/src/renderer/components/new-chat/PendingQueuePanel.tsx, apps/desktop/src/renderer/components/new-chat/PermissionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/PermissionSelector.tsx, apps/desktop/src/renderer/components/new-chat/PinnedPlanPanel.tsx, apps/desktop/src/renderer/components/new-chat/PlanActionCard.tsx, apps/desktop/src/renderer/components/new-chat/PlanModeIndicator.tsx, apps/desktop/src/renderer/components/new-chat/PlanViewerCard.tsx, apps/desktop/src/renderer/components/new-chat/PluginConnectionForm.tsx, apps/desktop/src/renderer/components/new-chat/PluginOauthDeviceCode.tsx, apps/desktop/src/renderer/components/new-chat/PluginSetupPrompt.tsx, apps/desktop/src/renderer/components/new-chat/PluginWriteAccessRecovery.tsx, apps/desktop/src/renderer/components/new-chat/QuickStartPillMark.ts, apps/desktop/src/renderer/components/new-chat/RemoteOauthSetupCard.tsx, apps/desktop/src/renderer/components/new-chat/SendButton.tsx, apps/desktop/src/renderer/components/new-chat/SlashCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/SlashCommandPalette.tsx, apps/desktop/src/renderer/components/new-chat/TakeoverMask.tsx, apps/desktop/src/renderer/components/new-chat/ThinkingToggle.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedFlyoutHost.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelPanel.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRail.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRow.tsx, apps/desktop/src/renderer/components/new-chat/UsageDailyBars.tsx, apps/desktop/src/renderer/components/new-chat/UsageHeatmap.tsx, apps/desktop/src/renderer/components/new-chat/VendorSegmentedSwitcher.tsx, apps/desktop/src/renderer/components/new-chat/VoiceInputDraftDecoration.ts, apps/desktop/src/renderer/components/new-chat/WindowsSelectionReplacement.ts, apps/desktop/src/renderer/components/new-chat/WorktreeChipsRow.tsx, apps/desktop/src/renderer/components/new-chat/WorktreeCreatingOverlay.tsx, apps/desktop/src/renderer/components/new-chat/agentOptions.ts, apps/desktop/src/renderer/components/new-chat/agentSwitchConfirmation.ts, apps/desktop/src/renderer/components/new-chat/branchPick.ts, apps/desktop/src/renderer/components/new-chat/composerBlankPointerFocus.ts, apps/desktop/src/renderer/components/new-chat/composerContentSerialization.ts, apps/desktop/src/renderer/components/new-chat/composerDocState.ts, apps/desktop/src/renderer/components/new-chat/composerFrameScheduler.ts, apps/desktop/src/renderer/components/new-chat/composerHistoryProjection.ts, apps/desktop/src/renderer/components/new-chat/composerModelSelection.ts, apps/desktop/src/renderer/components/new-chat/composerPromptRecommendation.ts, apps/desktop/src/renderer/components/new-chat/composerRenderGate.ts, apps/desktop/src/renderer/components/new-chat/composerSendOwnership.ts, apps/desktop/src/renderer/components/new-chat/composerSendSnapshot.ts, apps/desktop/src/renderer/components/new-chat/effortChangeQueue.ts, apps/desktop/src/renderer/components/new-chat/extraDirsActions.ts, apps/desktop/src/renderer/components/new-chat/ghostComposerPlacement.ts, apps/desktop/src/renderer/components/new-chat/localAttachmentPicker.ts, apps/desktop/src/renderer/components/new-chat/mentionChipInsertion.ts, apps/desktop/src/renderer/components/new-chat/modelWindowErrorToast.ts, apps/desktop/src/renderer/components/new-chat/pastePipeline.ts, apps/desktop/src/renderer/components/new-chat/pathPaste.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueLocks.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowActivity.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowPresentation.ts, apps/desktop/src/renderer/components/new-chat/planModeComposerCommand.ts, apps/desktop/src/renderer/components/new-chat/priceTierMarks.tsx, apps/desktop/src/renderer/components/new-chat/remoteBrowseAdapters.ts, apps/desktop/src/renderer/components/new-chat/remoteExistingProjects.ts, apps/desktop/src/renderer/components/new-chat/restoreComposerDocument.ts, apps/desktop/src/renderer/components/new-chat/sessionLinkPaste.ts, apps/desktop/src/renderer/components/new-chat/sourceSwitch.ts, apps/desktop/src/renderer/components/new-chat/unifiedModelSelection.ts, apps/desktop/src/renderer/components/new-chat/usagePalette.ts, apps/desktop/src/renderer/components/new-chat/useComposerSendFocusRestore.ts, apps/desktop/src/renderer/components/new-chat/useModelDiscoveryPending.ts, apps/desktop/src/renderer/components/new-chat/useProviderWeeklyQuota.ts, apps/desktop/src/renderer/components/new-chat/useUnifiedRowActions.ts, apps/desktop/src/renderer/features/cc-agent/CCAgentFeatureLayout.tsx, apps/desktop/src/renderer/features/cc-agent/CCAgentSessionView.tsx, apps/desktop/src/renderer/features/cc-agent/OrcaSplitView.tsx, apps/desktop/src/renderer/features/cc-agent/OrcaWorkerPanel.tsx, apps/desktop/src/renderer/features/cc-agent/OrcaWorkflowRoute.tsx | 255 | 41 | 342 |
+| `desktop.chat.orca-workflow` | desktop | Orca 协同工作台 | hash `/cc-agent/orca/:sessionId`(OrcaWorkflowRoute) | CCAgentSessionView, OrcaSplitView, OrcaWorkerPanel, OrcaWorkflowRoute | apps/desktop/src/renderer/components/chat/AgentActionRow.tsx, apps/desktop/src/renderer/components/chat/AgentActionsBlock.tsx, apps/desktop/src/renderer/components/chat/AgentTaskCard.tsx, apps/desktop/src/renderer/components/chat/AgentTaskLiveDetails.tsx, apps/desktop/src/renderer/components/chat/AnnotationStrokesSvg.tsx, apps/desktop/src/renderer/components/chat/AskUserQuestionBubble.tsx, apps/desktop/src/renderer/components/chat/AssistantMessage.tsx, apps/desktop/src/renderer/components/chat/AutomationOriginBadge.tsx, apps/desktop/src/renderer/components/chat/ChatAudioCard.tsx, apps/desktop/src/renderer/components/chat/ChatDisplaySnapshotContext.tsx, apps/desktop/src/renderer/components/chat/ChatImageView.tsx, apps/desktop/src/renderer/components/chat/ChatSessionFileContext.tsx, apps/desktop/src/renderer/components/chat/ChatSoundEffectCard.tsx, apps/desktop/src/renderer/components/chat/ChatVideoView.tsx, apps/desktop/src/renderer/components/chat/CindyMakeDoctorCard.tsx, apps/desktop/src/renderer/components/chat/CopyAsImageBlock.tsx, apps/desktop/src/renderer/components/chat/CredentialSwitchWaitBanner.tsx, apps/desktop/src/renderer/components/chat/DiffView.tsx, apps/desktop/src/renderer/components/chat/ErrorBanner.tsx, apps/desktop/src/renderer/components/chat/ErrorMessageCard.tsx, apps/desktop/src/renderer/components/chat/GeneratedFilesCard.tsx, apps/desktop/src/renderer/components/chat/GhostCardHostPrompts.tsx, apps/desktop/src/renderer/components/chat/GhostSummonCard.tsx, apps/desktop/src/renderer/components/chat/GhostToolCard.tsx, apps/desktop/src/renderer/components/chat/HookTaskCard.tsx, apps/desktop/src/renderer/components/chat/ImageGalleryContext.tsx, apps/desktop/src/renderer/components/chat/ImageHoverPreview.tsx, apps/desktop/src/renderer/components/chat/ImageLightbox.tsx, apps/desktop/src/renderer/components/chat/ImageMissingPlaceholder.tsx, apps/desktop/src/renderer/components/chat/InlineReferenceChip.tsx, apps/desktop/src/renderer/components/chat/InterruptedTurnBanner.tsx, apps/desktop/src/renderer/components/chat/JumpToBottomChip.tsx, apps/desktop/src/renderer/components/chat/MarkdownDiffBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownMermaidBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownRenderer.tsx, apps/desktop/src/renderer/components/chat/MermaidLightbox.tsx, apps/desktop/src/renderer/components/chat/MessageActionBar.tsx, apps/desktop/src/renderer/components/chat/MessageNavRail.tsx, apps/desktop/src/renderer/components/chat/MessageStream.tsx, apps/desktop/src/renderer/components/chat/MessageViewport.tsx, apps/desktop/src/renderer/components/chat/ModelLightbox.tsx, apps/desktop/src/renderer/components/chat/NewMessageIndicator.tsx, apps/desktop/src/renderer/components/chat/PlanReviewBubble.tsx, apps/desktop/src/renderer/components/chat/PrevMessageJumpChip.tsx, apps/desktop/src/renderer/components/chat/ProjectLinkChip.tsx, apps/desktop/src/renderer/components/chat/QuoteChip.tsx, apps/desktop/src/renderer/components/chat/RewindPreviewDialog.tsx, apps/desktop/src/renderer/components/chat/SelectionQuoteButton.tsx, apps/desktop/src/renderer/components/chat/SentAgentReferenceChip.tsx, apps/desktop/src/renderer/components/chat/SentInlineAtomBody.tsx, apps/desktop/src/renderer/components/chat/SessionHandoffCard.tsx, apps/desktop/src/renderer/components/chat/SessionLinkChip.tsx, apps/desktop/src/renderer/components/chat/ShareMessageCheckbox.tsx, apps/desktop/src/renderer/components/chat/ShareSelectionBar.tsx, apps/desktop/src/renderer/components/chat/SlackIcon.tsx, apps/desktop/src/renderer/components/chat/StreamFadeSpan.tsx, apps/desktop/src/renderer/components/chat/StreamingMarkdownChunk.tsx, apps/desktop/src/renderer/components/chat/SystemCard.tsx, apps/desktop/src/renderer/components/chat/TextLightbox.tsx, apps/desktop/src/renderer/components/chat/ThinkingCard.tsx, apps/desktop/src/renderer/components/chat/ThinkingText.tsx, apps/desktop/src/renderer/components/chat/TodoListCard.tsx, apps/desktop/src/renderer/components/chat/ToolCallCard.tsx, apps/desktop/src/renderer/components/chat/ToolPayloadLightbox.tsx, apps/desktop/src/renderer/components/chat/TopRightChipStack.tsx, apps/desktop/src/renderer/components/chat/TurnChangesCard.tsx, apps/desktop/src/renderer/components/chat/UnreadFailedScheduleBanner.tsx, apps/desktop/src/renderer/components/chat/UpgradeBanner.tsx, apps/desktop/src/renderer/components/chat/UserAttachmentChip.tsx, apps/desktop/src/renderer/components/chat/UserMessage.tsx, apps/desktop/src/renderer/components/chat/UserMessageEditBox.tsx, apps/desktop/src/renderer/components/chat/UserMessageUrlLink.tsx, apps/desktop/src/renderer/components/chat/VideoLightbox.tsx, apps/desktop/src/renderer/components/chat/WorkGroupBlock.tsx, apps/desktop/src/renderer/components/chat/WorktreeRestoreBanner.tsx, apps/desktop/src/renderer/components/chat/XIcon.tsx, apps/desktop/src/renderer/components/chat/activityRowChrome.ts, apps/desktop/src/renderer/components/chat/animateFocusScroll.ts, apps/desktop/src/renderer/components/chat/autoFollowIntent.ts, apps/desktop/src/renderer/components/chat/chatChrome.ts, apps/desktop/src/renderer/components/chat/errorReasonI18n.ts, apps/desktop/src/renderer/components/chat/generatedFilesProjection.ts, apps/desktop/src/renderer/components/chat/imageDisplaySize.ts, apps/desktop/src/renderer/components/chat/lightboxAnnotations.ts, apps/desktop/src/renderer/components/chat/lightboxGestures.ts, apps/desktop/src/renderer/components/chat/markdownImageTargets.ts, apps/desktop/src/renderer/components/chat/messageNavRailModel.ts, apps/desktop/src/renderer/components/chat/messageNavRailWheel.ts, apps/desktop/src/renderer/components/chat/messageNavigationProjection.ts, apps/desktop/src/renderer/components/chat/messageProjectionCache.ts, apps/desktop/src/renderer/components/chat/messageStreamIndicatorPosition.ts, apps/desktop/src/renderer/components/chat/messageViewportCompensation.ts, apps/desktop/src/renderer/components/chat/messageViewportGeometry.ts, apps/desktop/src/renderer/components/chat/messageWorkGroups.ts, apps/desktop/src/renderer/components/chat/observeProgrammaticScroll.ts, apps/desktop/src/renderer/components/chat/rehypeFencedCodeMarker.ts, apps/desktop/src/renderer/components/chat/rehypeHighlightShared.ts, apps/desktop/src/renderer/components/chat/rehypeMathBlockMarker.ts, apps/desktop/src/renderer/components/chat/rehypeStreamWordFade.ts, apps/desktop/src/renderer/components/chat/remarkHtmlImages.ts, apps/desktop/src/renderer/components/chat/remarkLocalPathLinks.ts, apps/desktop/src/renderer/components/chat/remarkPreserveRawLocalDestinations.ts, apps/desktop/src/renderer/components/chat/remarkSessionLinks.ts, apps/desktop/src/renderer/components/chat/remarkStrictInlineMath.ts, apps/desktop/src/renderer/components/chat/remarkTruncateCjkUrls.ts, apps/desktop/src/renderer/components/chat/repairStreamingMarkdown.ts, apps/desktop/src/renderer/components/chat/scrollAnchoringDetect.ts, apps/desktop/src/renderer/components/chat/shareSelectionStore.ts, apps/desktop/src/renderer/components/chat/streamingMarkdownBlocks.tsx, apps/desktop/src/renderer/components/chat/streamingMarkdownChunks.ts, apps/desktop/src/renderer/components/chat/streamingMessageProjection.ts, apps/desktop/src/renderer/components/chat/toolLoopI18n.ts, apps/desktop/src/renderer/components/chat/unreadCount.ts, apps/desktop/src/renderer/components/chat/useAutomaticHistoryLoadBudget.ts, apps/desktop/src/renderer/components/chat/useCopyAsImage.tsx, apps/desktop/src/renderer/components/chat/useDeleteMessage.ts, apps/desktop/src/renderer/components/chat/useFileChipContextMenu.tsx, apps/desktop/src/renderer/components/chat/useForkAtMessage.ts, apps/desktop/src/renderer/components/chat/useMessageViewport.ts, apps/desktop/src/renderer/components/chat/useNavigationKeyListener.ts, apps/desktop/src/renderer/components/chat/useOpenWithMenu.tsx, apps/desktop/src/renderer/components/chat/usePrevUserMessageInView.ts, apps/desktop/src/renderer/components/chat/useTurnChangeSets.ts, apps/desktop/src/renderer/components/chat/userMessageCollapse.ts, apps/desktop/src/renderer/components/chat/userMessageDisplayText.ts, apps/desktop/src/renderer/components/chat/userMessageLinkify.ts, apps/desktop/src/renderer/components/chat/viewportFillDetect.ts, apps/desktop/src/renderer/components/new-chat/AddRemoteProjectDialog.tsx, apps/desktop/src/renderer/components/new-chat/AgentSelect.tsx, apps/desktop/src/renderer/components/new-chat/AskUserQuestionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/AtMentionPanel.tsx, apps/desktop/src/renderer/components/new-chat/AttachmentTypeThumb.tsx, apps/desktop/src/renderer/components/new-chat/ChatInput.tsx, apps/desktop/src/renderer/components/new-chat/CjkPunctDecoration.ts, apps/desktop/src/renderer/components/new-chat/CjkPunctuationUtils.ts, apps/desktop/src/renderer/components/new-chat/ComposerAttachments.tsx, apps/desktop/src/renderer/components/new-chat/ComposerListIndentDecoration.ts, apps/desktop/src/renderer/components/new-chat/ComposerListNodes.ts, apps/desktop/src/renderer/components/new-chat/ComposerQuoteNode.tsx, apps/desktop/src/renderer/components/new-chat/DeviceSwitcherPill.tsx, apps/desktop/src/renderer/components/new-chat/EffortSlider.tsx, apps/desktop/src/renderer/components/new-chat/EmptyDocSelectionGuard.ts, apps/desktop/src/renderer/components/new-chat/ExtraDirsButton.tsx, apps/desktop/src/renderer/components/new-chat/FastModeToggle.tsx, apps/desktop/src/renderer/components/new-chat/FolderPickerPopover.tsx, apps/desktop/src/renderer/components/new-chat/FullAccessConfirmContent.tsx, apps/desktop/src/renderer/components/new-chat/GhostCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/GoalAdvancedLimits.tsx, apps/desktop/src/renderer/components/new-chat/GoalIndicator.tsx, apps/desktop/src/renderer/components/new-chat/HomeUsageDashboard.tsx, apps/desktop/src/renderer/components/new-chat/ListComposerTextarea.tsx, apps/desktop/src/renderer/components/new-chat/LocalModelCatalogNotice.tsx, apps/desktop/src/renderer/components/new-chat/MentionChipNode.tsx, apps/desktop/src/renderer/components/new-chat/MentionDragCaretDecoration.ts, apps/desktop/src/renderer/components/new-chat/ModelCompatibilityNotice.tsx, apps/desktop/src/renderer/components/new-chat/ModelConfigFlyout.tsx, apps/desktop/src/renderer/components/new-chat/ModelHarnessPicker.tsx, apps/desktop/src/renderer/components/new-chat/ModelSelector.tsx, apps/desktop/src/renderer/components/new-chat/ModelSourceDetails.tsx, apps/desktop/src/renderer/components/new-chat/NewGoalDialog.tsx, apps/desktop/src/renderer/components/new-chat/PastedTextChipNode.tsx, apps/desktop/src/renderer/components/new-chat/PendingQueuePanel.tsx, apps/desktop/src/renderer/components/new-chat/PermissionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/PermissionSelector.tsx, apps/desktop/src/renderer/components/new-chat/PinnedPlanPanel.tsx, apps/desktop/src/renderer/components/new-chat/PlanActionCard.tsx, apps/desktop/src/renderer/components/new-chat/PlanModeIndicator.tsx, apps/desktop/src/renderer/components/new-chat/PlanViewerCard.tsx, apps/desktop/src/renderer/components/new-chat/PluginConnectionForm.tsx, apps/desktop/src/renderer/components/new-chat/PluginOauthDeviceCode.tsx, apps/desktop/src/renderer/components/new-chat/PluginSetupPrompt.tsx, apps/desktop/src/renderer/components/new-chat/PluginWriteAccessRecovery.tsx, apps/desktop/src/renderer/components/new-chat/QuickStartPillMark.ts, apps/desktop/src/renderer/components/new-chat/RemoteOauthSetupCard.tsx, apps/desktop/src/renderer/components/new-chat/SendButton.tsx, apps/desktop/src/renderer/components/new-chat/SlashCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/SlashCommandPalette.tsx, apps/desktop/src/renderer/components/new-chat/TakeoverMask.tsx, apps/desktop/src/renderer/components/new-chat/ThinkingToggle.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedFlyoutHost.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelPanel.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRail.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRow.tsx, apps/desktop/src/renderer/components/new-chat/UsageDailyBars.tsx, apps/desktop/src/renderer/components/new-chat/UsageHeatmap.tsx, apps/desktop/src/renderer/components/new-chat/VendorSegmentedSwitcher.tsx, apps/desktop/src/renderer/components/new-chat/VoiceInputDraftDecoration.ts, apps/desktop/src/renderer/components/new-chat/WindowsSelectionReplacement.ts, apps/desktop/src/renderer/components/new-chat/WorktreeChipsRow.tsx, apps/desktop/src/renderer/components/new-chat/WorktreeCreatingOverlay.tsx, apps/desktop/src/renderer/components/new-chat/agentOptions.ts, apps/desktop/src/renderer/components/new-chat/agentSwitchConfirmation.ts, apps/desktop/src/renderer/components/new-chat/branchPick.ts, apps/desktop/src/renderer/components/new-chat/composerBlankPointerFocus.ts, apps/desktop/src/renderer/components/new-chat/composerContentSerialization.ts, apps/desktop/src/renderer/components/new-chat/composerDocState.ts, apps/desktop/src/renderer/components/new-chat/composerFrameScheduler.ts, apps/desktop/src/renderer/components/new-chat/composerHistoryProjection.ts, apps/desktop/src/renderer/components/new-chat/composerModelSelection.ts, apps/desktop/src/renderer/components/new-chat/composerPromptRecommendation.ts, apps/desktop/src/renderer/components/new-chat/composerRenderGate.ts, apps/desktop/src/renderer/components/new-chat/composerSendOwnership.ts, apps/desktop/src/renderer/components/new-chat/composerSendSnapshot.ts, apps/desktop/src/renderer/components/new-chat/effortChangeQueue.ts, apps/desktop/src/renderer/components/new-chat/extraDirsActions.ts, apps/desktop/src/renderer/components/new-chat/ghostComposerPlacement.ts, apps/desktop/src/renderer/components/new-chat/localAttachmentPicker.ts, apps/desktop/src/renderer/components/new-chat/mentionChipInsertion.ts, apps/desktop/src/renderer/components/new-chat/modelWindowErrorToast.ts, apps/desktop/src/renderer/components/new-chat/pastePipeline.ts, apps/desktop/src/renderer/components/new-chat/pathPaste.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueLocks.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowActivity.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowPresentation.ts, apps/desktop/src/renderer/components/new-chat/planModeComposerCommand.ts, apps/desktop/src/renderer/components/new-chat/priceTierMarks.tsx, apps/desktop/src/renderer/components/new-chat/remoteBrowseAdapters.ts, apps/desktop/src/renderer/components/new-chat/remoteExistingProjects.ts, apps/desktop/src/renderer/components/new-chat/restoreComposerDocument.ts, apps/desktop/src/renderer/components/new-chat/sessionLinkPaste.ts, apps/desktop/src/renderer/components/new-chat/sourceSwitch.ts, apps/desktop/src/renderer/components/new-chat/unifiedModelSelection.ts, apps/desktop/src/renderer/components/new-chat/usagePalette.ts, apps/desktop/src/renderer/components/new-chat/useComposerSendFocusRestore.ts, apps/desktop/src/renderer/components/new-chat/useModelDiscoveryPending.ts, apps/desktop/src/renderer/components/new-chat/useProviderWeeklyQuota.ts, apps/desktop/src/renderer/components/new-chat/useUnifiedRowActions.ts, apps/desktop/src/renderer/features/cc-agent/CCAgentFeatureLayout.tsx, apps/desktop/src/renderer/features/cc-agent/CCAgentSessionView.tsx, apps/desktop/src/renderer/features/cc-agent/OrcaSplitView.tsx, apps/desktop/src/renderer/features/cc-agent/OrcaWorkerPanel.tsx, apps/desktop/src/renderer/features/cc-agent/OrcaWorkflowRoute.tsx | 255 | 41 | 342 |
| `desktop.chat.scheduled` | desktop | 调度任务列表 | hash `/cc-agent/scheduled`(SchedulerPage) | SchedulerPage | apps/desktop/src/renderer/features/scheduler/SchedulerPage.tsx, apps/desktop/src/renderer/features/scheduler/components/AgentMark.tsx, apps/desktop/src/renderer/features/scheduler/components/BoundSessionCard.tsx, apps/desktop/src/renderer/features/scheduler/components/ProjectAutomationNotifyBridge.tsx, apps/desktop/src/renderer/features/scheduler/components/RunHistoryCard.tsx, apps/desktop/src/renderer/features/scheduler/components/RunHistoryPane.tsx, apps/desktop/src/renderer/features/scheduler/components/ScheduleChips.tsx, apps/desktop/src/renderer/features/scheduler/components/ScheduleFormDialog.tsx, apps/desktop/src/renderer/features/scheduler/components/ScheduleSessionIndexOwner.tsx, apps/desktop/src/renderer/features/scheduler/components/ScheduleStatusChip.tsx, apps/desktop/src/renderer/features/scheduler/components/ScriptCapabilityMultiSelect.tsx, apps/desktop/src/renderer/features/scheduler/components/TaskListCell.tsx, apps/desktop/src/renderer/features/scheduler/components/TaskListFilterPopover.tsx, apps/desktop/src/renderer/features/scheduler/components/TaskListPane.tsx, apps/desktop/src/renderer/features/scheduler/components/TemplateCard.tsx, apps/desktop/src/renderer/features/scheduler/components/TemplateGallery.tsx, apps/desktop/src/renderer/features/scheduler/components/TemplateParamForm.tsx, apps/desktop/src/renderer/features/scheduler/hooks/useDeleteScheduleWithSessions.tsx, apps/desktop/src/renderer/features/scheduler/hooks/useReadFailedScheduleRuns.ts, apps/desktop/src/renderer/features/scheduler/hooks/useRunNowBusyGuard.ts, apps/desktop/src/renderer/features/scheduler/hooks/useRuns.ts, apps/desktop/src/renderer/features/scheduler/hooks/useScheduleForm.ts, apps/desktop/src/renderer/features/scheduler/hooks/useScheduleUnreadRunCounts.ts, apps/desktop/src/renderer/features/scheduler/hooks/useSchedules.ts, apps/desktop/src/renderer/features/scheduler/hooks/useSessionReferences.ts, apps/desktop/src/renderer/features/scheduler/hooks/useTemplates.ts, apps/desktop/src/renderer/features/scheduler/index.ts, apps/desktop/src/renderer/features/scheduler/lib/cronCodexPreset.ts, apps/desktop/src/renderer/features/scheduler/lib/cronToHuman.ts, apps/desktop/src/renderer/features/scheduler/lib/failedScheduleDismissal.ts, apps/desktop/src/renderer/features/scheduler/lib/formatters.ts, apps/desktop/src/renderer/features/scheduler/lib/pluginScheduleCreateIntent.ts, apps/desktop/src/renderer/features/scheduler/lib/projectAutomationConfig.ts, apps/desktop/src/renderer/features/scheduler/lib/projectScheduleSidebarIndex.ts, apps/desktop/src/renderer/features/scheduler/lib/runHistoryGrouping.ts, apps/desktop/src/renderer/features/scheduler/lib/runUnread.ts, apps/desktop/src/renderer/features/scheduler/lib/scheduleFormLogic.ts, apps/desktop/src/renderer/features/scheduler/lib/scheduleRunReadSync.ts, apps/desktop/src/renderer/features/scheduler/lib/scheduleSessionBinding.ts, apps/desktop/src/renderer/features/scheduler/lib/scheduleSidebarIndexRuns.ts, apps/desktop/src/renderer/features/scheduler/lib/schedulesStore.ts, apps/desktop/src/renderer/features/scheduler/lib/statusFilter.ts, apps/desktop/src/renderer/features/scheduler/lib/statusFilterStorage.ts, apps/desktop/src/renderer/features/scheduler/lib/templateLocalization.ts, apps/desktop/src/renderer/features/scheduler/lib/usageLimitScheduleCreateIntent.ts | 36 | 0 | 92 |
-| `desktop.chat.session` | desktop | 会话工作台 | hash `/cc-agent/:sessionId`;副窗经 `/cc-agent/boot` 解析后落到同一会话视图 | AssistantMessage, CCAgentFeatureLayout, CCAgentSessionView, ChatInput, PermissionPrompt | apps/desktop/src/renderer/components/chat/AgentActionRow.tsx, apps/desktop/src/renderer/components/chat/AgentActionsBlock.tsx, apps/desktop/src/renderer/components/chat/AgentTaskCard.tsx, apps/desktop/src/renderer/components/chat/AgentTaskLiveDetails.tsx, apps/desktop/src/renderer/components/chat/AnnotationStrokesSvg.tsx, apps/desktop/src/renderer/components/chat/AskUserQuestionBubble.tsx, apps/desktop/src/renderer/components/chat/AssistantMessage.tsx, apps/desktop/src/renderer/components/chat/AutomationOriginBadge.tsx, apps/desktop/src/renderer/components/chat/ChatAudioCard.tsx, apps/desktop/src/renderer/components/chat/ChatDisplaySnapshotContext.tsx, apps/desktop/src/renderer/components/chat/ChatImageView.tsx, apps/desktop/src/renderer/components/chat/ChatSessionFileContext.tsx, apps/desktop/src/renderer/components/chat/ChatSoundEffectCard.tsx, apps/desktop/src/renderer/components/chat/ChatVideoView.tsx, apps/desktop/src/renderer/components/chat/CindyMakeDoctorCard.tsx, apps/desktop/src/renderer/components/chat/CopyAsImageBlock.tsx, apps/desktop/src/renderer/components/chat/CredentialSwitchWaitBanner.tsx, apps/desktop/src/renderer/components/chat/DiffView.tsx, apps/desktop/src/renderer/components/chat/ErrorBanner.tsx, apps/desktop/src/renderer/components/chat/ErrorMessageCard.tsx, apps/desktop/src/renderer/components/chat/GeneratedFilesCard.tsx, apps/desktop/src/renderer/components/chat/GhostCardHostPrompts.tsx, apps/desktop/src/renderer/components/chat/GhostSummonCard.tsx, apps/desktop/src/renderer/components/chat/GhostToolCard.tsx, apps/desktop/src/renderer/components/chat/HookTaskCard.tsx, apps/desktop/src/renderer/components/chat/ImageGalleryContext.tsx, apps/desktop/src/renderer/components/chat/ImageHoverPreview.tsx, apps/desktop/src/renderer/components/chat/ImageLightbox.tsx, apps/desktop/src/renderer/components/chat/ImageMissingPlaceholder.tsx, apps/desktop/src/renderer/components/chat/InlineReferenceChip.tsx, apps/desktop/src/renderer/components/chat/InterruptedTurnBanner.tsx, apps/desktop/src/renderer/components/chat/JumpToBottomChip.tsx, apps/desktop/src/renderer/components/chat/MarkdownDiffBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownMermaidBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownRenderer.tsx, apps/desktop/src/renderer/components/chat/MermaidLightbox.tsx, apps/desktop/src/renderer/components/chat/MessageActionBar.tsx, apps/desktop/src/renderer/components/chat/MessageNavRail.tsx, apps/desktop/src/renderer/components/chat/MessageStream.tsx, apps/desktop/src/renderer/components/chat/ModelLightbox.tsx, apps/desktop/src/renderer/components/chat/NewMessageIndicator.tsx, apps/desktop/src/renderer/components/chat/PlanReviewBubble.tsx, apps/desktop/src/renderer/components/chat/PrevMessageJumpChip.tsx, apps/desktop/src/renderer/components/chat/ProjectLinkChip.tsx, apps/desktop/src/renderer/components/chat/QuoteChip.tsx, apps/desktop/src/renderer/components/chat/RewindPreviewDialog.tsx, apps/desktop/src/renderer/components/chat/SelectionQuoteButton.tsx, apps/desktop/src/renderer/components/chat/SentAgentReferenceChip.tsx, apps/desktop/src/renderer/components/chat/SentInlineAtomBody.tsx, apps/desktop/src/renderer/components/chat/SessionHandoffCard.tsx, apps/desktop/src/renderer/components/chat/SessionLinkChip.tsx, apps/desktop/src/renderer/components/chat/ShareMessageCheckbox.tsx, apps/desktop/src/renderer/components/chat/ShareSelectionBar.tsx, apps/desktop/src/renderer/components/chat/SlackIcon.tsx, apps/desktop/src/renderer/components/chat/StreamFadeSpan.tsx, apps/desktop/src/renderer/components/chat/StreamingMarkdownChunk.tsx, apps/desktop/src/renderer/components/chat/SystemCard.tsx, apps/desktop/src/renderer/components/chat/TextLightbox.tsx, apps/desktop/src/renderer/components/chat/ThinkingCard.tsx, apps/desktop/src/renderer/components/chat/ThinkingText.tsx, apps/desktop/src/renderer/components/chat/TodoListCard.tsx, apps/desktop/src/renderer/components/chat/ToolCallCard.tsx, apps/desktop/src/renderer/components/chat/ToolPayloadLightbox.tsx, apps/desktop/src/renderer/components/chat/TopRightChipStack.tsx, apps/desktop/src/renderer/components/chat/TurnChangesCard.tsx, apps/desktop/src/renderer/components/chat/UnreadFailedScheduleBanner.tsx, apps/desktop/src/renderer/components/chat/UpgradeBanner.tsx, apps/desktop/src/renderer/components/chat/UserAttachmentChip.tsx, apps/desktop/src/renderer/components/chat/UserMessage.tsx, apps/desktop/src/renderer/components/chat/UserMessageEditBox.tsx, apps/desktop/src/renderer/components/chat/UserMessageUrlLink.tsx, apps/desktop/src/renderer/components/chat/VideoLightbox.tsx, apps/desktop/src/renderer/components/chat/WorkGroupBlock.tsx, apps/desktop/src/renderer/components/chat/WorktreeRestoreBanner.tsx, apps/desktop/src/renderer/components/chat/XIcon.tsx, apps/desktop/src/renderer/components/chat/activityRowChrome.ts, apps/desktop/src/renderer/components/chat/autoFollowIntent.ts, apps/desktop/src/renderer/components/chat/chatChrome.ts, apps/desktop/src/renderer/components/chat/errorReasonI18n.ts, apps/desktop/src/renderer/components/chat/generatedFilesProjection.ts, apps/desktop/src/renderer/components/chat/imageDisplaySize.ts, apps/desktop/src/renderer/components/chat/lightboxAnnotations.ts, apps/desktop/src/renderer/components/chat/lightboxGestures.ts, apps/desktop/src/renderer/components/chat/markdownImageTargets.ts, apps/desktop/src/renderer/components/chat/messageNavRailModel.ts, apps/desktop/src/renderer/components/chat/messageNavRailWheel.ts, apps/desktop/src/renderer/components/chat/messageNavigationProjection.ts, apps/desktop/src/renderer/components/chat/messageProjectionCache.ts, apps/desktop/src/renderer/components/chat/messageStreamIndicatorPosition.ts, apps/desktop/src/renderer/components/chat/messageViewportCompensation.ts, apps/desktop/src/renderer/components/chat/messageWorkGroups.ts, apps/desktop/src/renderer/components/chat/rehypeFencedCodeMarker.ts, apps/desktop/src/renderer/components/chat/rehypeHighlightShared.ts, apps/desktop/src/renderer/components/chat/rehypeMathBlockMarker.ts, apps/desktop/src/renderer/components/chat/rehypeStreamWordFade.ts, apps/desktop/src/renderer/components/chat/remarkHtmlImages.ts, apps/desktop/src/renderer/components/chat/remarkLocalPathLinks.ts, apps/desktop/src/renderer/components/chat/remarkPreserveRawLocalDestinations.ts, apps/desktop/src/renderer/components/chat/remarkSessionLinks.ts, apps/desktop/src/renderer/components/chat/remarkStrictInlineMath.ts, apps/desktop/src/renderer/components/chat/remarkTruncateCjkUrls.ts, apps/desktop/src/renderer/components/chat/repairStreamingMarkdown.ts, apps/desktop/src/renderer/components/chat/scrollAnchoringDetect.ts, apps/desktop/src/renderer/components/chat/shareSelectionStore.ts, apps/desktop/src/renderer/components/chat/streamingMarkdownBlocks.tsx, apps/desktop/src/renderer/components/chat/streamingMarkdownChunks.ts, apps/desktop/src/renderer/components/chat/streamingMessageProjection.ts, apps/desktop/src/renderer/components/chat/toolLoopI18n.ts, apps/desktop/src/renderer/components/chat/unreadCount.ts, apps/desktop/src/renderer/components/chat/useAutomaticHistoryLoadBudget.ts, apps/desktop/src/renderer/components/chat/useCopyAsImage.tsx, apps/desktop/src/renderer/components/chat/useDeleteMessage.ts, apps/desktop/src/renderer/components/chat/useFileChipContextMenu.tsx, apps/desktop/src/renderer/components/chat/useForkAtMessage.ts, apps/desktop/src/renderer/components/chat/useNavigationKeyListener.ts, apps/desktop/src/renderer/components/chat/useOpenWithMenu.tsx, apps/desktop/src/renderer/components/chat/usePrevUserMessageInView.ts, apps/desktop/src/renderer/components/chat/useTurnChangeSets.ts, apps/desktop/src/renderer/components/chat/userMessageCollapse.ts, apps/desktop/src/renderer/components/chat/userMessageDisplayText.ts, apps/desktop/src/renderer/components/chat/userMessageLinkify.ts, apps/desktop/src/renderer/components/chat/viewportFillDetect.ts, apps/desktop/src/renderer/components/new-chat/AddRemoteProjectDialog.tsx, apps/desktop/src/renderer/components/new-chat/AgentSelect.tsx, apps/desktop/src/renderer/components/new-chat/AskUserQuestionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/AtMentionPanel.tsx, apps/desktop/src/renderer/components/new-chat/AttachmentTypeThumb.tsx, apps/desktop/src/renderer/components/new-chat/ChatInput.tsx, apps/desktop/src/renderer/components/new-chat/CjkPunctDecoration.ts, apps/desktop/src/renderer/components/new-chat/CjkPunctuationUtils.ts, apps/desktop/src/renderer/components/new-chat/ComposerAttachments.tsx, apps/desktop/src/renderer/components/new-chat/ComposerListIndentDecoration.ts, apps/desktop/src/renderer/components/new-chat/ComposerListNodes.ts, apps/desktop/src/renderer/components/new-chat/ComposerQuoteNode.tsx, apps/desktop/src/renderer/components/new-chat/DeviceSwitcherPill.tsx, apps/desktop/src/renderer/components/new-chat/EffortSlider.tsx, apps/desktop/src/renderer/components/new-chat/EmptyDocSelectionGuard.ts, apps/desktop/src/renderer/components/new-chat/ExtraDirsButton.tsx, apps/desktop/src/renderer/components/new-chat/FastModeToggle.tsx, apps/desktop/src/renderer/components/new-chat/FolderPickerPopover.tsx, apps/desktop/src/renderer/components/new-chat/FullAccessConfirmContent.tsx, apps/desktop/src/renderer/components/new-chat/GhostCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/GoalAdvancedLimits.tsx, apps/desktop/src/renderer/components/new-chat/GoalIndicator.tsx, apps/desktop/src/renderer/components/new-chat/HomeUsageDashboard.tsx, apps/desktop/src/renderer/components/new-chat/ListComposerTextarea.tsx, apps/desktop/src/renderer/components/new-chat/LocalModelCatalogNotice.tsx, apps/desktop/src/renderer/components/new-chat/MentionChipNode.tsx, apps/desktop/src/renderer/components/new-chat/MentionDragCaretDecoration.ts, apps/desktop/src/renderer/components/new-chat/ModelCompatibilityNotice.tsx, apps/desktop/src/renderer/components/new-chat/ModelConfigFlyout.tsx, apps/desktop/src/renderer/components/new-chat/ModelHarnessPicker.tsx, apps/desktop/src/renderer/components/new-chat/ModelSelector.tsx, apps/desktop/src/renderer/components/new-chat/ModelSourceDetails.tsx, apps/desktop/src/renderer/components/new-chat/NewGoalDialog.tsx, apps/desktop/src/renderer/components/new-chat/PastedTextChipNode.tsx, apps/desktop/src/renderer/components/new-chat/PendingQueuePanel.tsx, apps/desktop/src/renderer/components/new-chat/PermissionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/PermissionSelector.tsx, apps/desktop/src/renderer/components/new-chat/PinnedPlanPanel.tsx, apps/desktop/src/renderer/components/new-chat/PlanActionCard.tsx, apps/desktop/src/renderer/components/new-chat/PlanModeIndicator.tsx, apps/desktop/src/renderer/components/new-chat/PlanViewerCard.tsx, apps/desktop/src/renderer/components/new-chat/PluginConnectionForm.tsx, apps/desktop/src/renderer/components/new-chat/PluginOauthDeviceCode.tsx, apps/desktop/src/renderer/components/new-chat/PluginSetupPrompt.tsx, apps/desktop/src/renderer/components/new-chat/PluginWriteAccessRecovery.tsx, apps/desktop/src/renderer/components/new-chat/QuickStartPillMark.ts, apps/desktop/src/renderer/components/new-chat/RemoteOauthSetupCard.tsx, apps/desktop/src/renderer/components/new-chat/SendButton.tsx, apps/desktop/src/renderer/components/new-chat/SlashCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/SlashCommandPalette.tsx, apps/desktop/src/renderer/components/new-chat/TakeoverMask.tsx, apps/desktop/src/renderer/components/new-chat/ThinkingToggle.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedFlyoutHost.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelPanel.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRail.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRow.tsx, apps/desktop/src/renderer/components/new-chat/UsageDailyBars.tsx, apps/desktop/src/renderer/components/new-chat/UsageHeatmap.tsx, apps/desktop/src/renderer/components/new-chat/VendorSegmentedSwitcher.tsx, apps/desktop/src/renderer/components/new-chat/VoiceInputDraftDecoration.ts, apps/desktop/src/renderer/components/new-chat/WindowsSelectionReplacement.ts, apps/desktop/src/renderer/components/new-chat/WorktreeChipsRow.tsx, apps/desktop/src/renderer/components/new-chat/WorktreeCreatingOverlay.tsx, apps/desktop/src/renderer/components/new-chat/agentOptions.ts, apps/desktop/src/renderer/components/new-chat/agentSwitchConfirmation.ts, apps/desktop/src/renderer/components/new-chat/branchPick.ts, apps/desktop/src/renderer/components/new-chat/composerBlankPointerFocus.ts, apps/desktop/src/renderer/components/new-chat/composerContentSerialization.ts, apps/desktop/src/renderer/components/new-chat/composerDocState.ts, apps/desktop/src/renderer/components/new-chat/composerFrameScheduler.ts, apps/desktop/src/renderer/components/new-chat/composerHistoryProjection.ts, apps/desktop/src/renderer/components/new-chat/composerModelSelection.ts, apps/desktop/src/renderer/components/new-chat/composerPromptRecommendation.ts, apps/desktop/src/renderer/components/new-chat/composerRenderGate.ts, apps/desktop/src/renderer/components/new-chat/composerSendOwnership.ts, apps/desktop/src/renderer/components/new-chat/composerSendSnapshot.ts, apps/desktop/src/renderer/components/new-chat/effortChangeQueue.ts, apps/desktop/src/renderer/components/new-chat/extraDirsActions.ts, apps/desktop/src/renderer/components/new-chat/ghostComposerPlacement.ts, apps/desktop/src/renderer/components/new-chat/localAttachmentPicker.ts, apps/desktop/src/renderer/components/new-chat/mentionChipInsertion.ts, apps/desktop/src/renderer/components/new-chat/modelWindowErrorToast.ts, apps/desktop/src/renderer/components/new-chat/pastePipeline.ts, apps/desktop/src/renderer/components/new-chat/pathPaste.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueLocks.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowActivity.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowPresentation.ts, apps/desktop/src/renderer/components/new-chat/planModeComposerCommand.ts, apps/desktop/src/renderer/components/new-chat/priceTierMarks.tsx, apps/desktop/src/renderer/components/new-chat/remoteBrowseAdapters.ts, apps/desktop/src/renderer/components/new-chat/remoteExistingProjects.ts, apps/desktop/src/renderer/components/new-chat/restoreComposerDocument.ts, apps/desktop/src/renderer/components/new-chat/sessionLinkPaste.ts, apps/desktop/src/renderer/components/new-chat/sourceSwitch.ts, apps/desktop/src/renderer/components/new-chat/unifiedModelSelection.ts, apps/desktop/src/renderer/components/new-chat/usagePalette.ts, apps/desktop/src/renderer/components/new-chat/useComposerSendFocusRestore.ts, apps/desktop/src/renderer/components/new-chat/useModelDiscoveryPending.ts, apps/desktop/src/renderer/components/new-chat/useProviderWeeklyQuota.ts, apps/desktop/src/renderer/components/new-chat/useUnifiedRowActions.ts, apps/desktop/src/renderer/features/cc-agent/CCAgentFeatureLayout.tsx, apps/desktop/src/renderer/features/cc-agent/CCAgentSessionView.tsx | 255 | 41 | 341 |
+| `desktop.chat.session` | desktop | 会话工作台 | hash `/cc-agent/:sessionId`;副窗经 `/cc-agent/boot` 解析后落到同一会话视图 | AssistantMessage, CCAgentFeatureLayout, CCAgentSessionView, ChatInput, PermissionPrompt | apps/desktop/src/renderer/components/chat/AgentActionRow.tsx, apps/desktop/src/renderer/components/chat/AgentActionsBlock.tsx, apps/desktop/src/renderer/components/chat/AgentTaskCard.tsx, apps/desktop/src/renderer/components/chat/AgentTaskLiveDetails.tsx, apps/desktop/src/renderer/components/chat/AnnotationStrokesSvg.tsx, apps/desktop/src/renderer/components/chat/AskUserQuestionBubble.tsx, apps/desktop/src/renderer/components/chat/AssistantMessage.tsx, apps/desktop/src/renderer/components/chat/AutomationOriginBadge.tsx, apps/desktop/src/renderer/components/chat/ChatAudioCard.tsx, apps/desktop/src/renderer/components/chat/ChatDisplaySnapshotContext.tsx, apps/desktop/src/renderer/components/chat/ChatImageView.tsx, apps/desktop/src/renderer/components/chat/ChatSessionFileContext.tsx, apps/desktop/src/renderer/components/chat/ChatSoundEffectCard.tsx, apps/desktop/src/renderer/components/chat/ChatVideoView.tsx, apps/desktop/src/renderer/components/chat/CindyMakeDoctorCard.tsx, apps/desktop/src/renderer/components/chat/CopyAsImageBlock.tsx, apps/desktop/src/renderer/components/chat/CredentialSwitchWaitBanner.tsx, apps/desktop/src/renderer/components/chat/DiffView.tsx, apps/desktop/src/renderer/components/chat/ErrorBanner.tsx, apps/desktop/src/renderer/components/chat/ErrorMessageCard.tsx, apps/desktop/src/renderer/components/chat/GeneratedFilesCard.tsx, apps/desktop/src/renderer/components/chat/GhostCardHostPrompts.tsx, apps/desktop/src/renderer/components/chat/GhostSummonCard.tsx, apps/desktop/src/renderer/components/chat/GhostToolCard.tsx, apps/desktop/src/renderer/components/chat/HookTaskCard.tsx, apps/desktop/src/renderer/components/chat/ImageGalleryContext.tsx, apps/desktop/src/renderer/components/chat/ImageHoverPreview.tsx, apps/desktop/src/renderer/components/chat/ImageLightbox.tsx, apps/desktop/src/renderer/components/chat/ImageMissingPlaceholder.tsx, apps/desktop/src/renderer/components/chat/InlineReferenceChip.tsx, apps/desktop/src/renderer/components/chat/InterruptedTurnBanner.tsx, apps/desktop/src/renderer/components/chat/JumpToBottomChip.tsx, apps/desktop/src/renderer/components/chat/MarkdownDiffBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownMermaidBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownRenderer.tsx, apps/desktop/src/renderer/components/chat/MermaidLightbox.tsx, apps/desktop/src/renderer/components/chat/MessageActionBar.tsx, apps/desktop/src/renderer/components/chat/MessageNavRail.tsx, apps/desktop/src/renderer/components/chat/MessageStream.tsx, apps/desktop/src/renderer/components/chat/MessageViewport.tsx, apps/desktop/src/renderer/components/chat/ModelLightbox.tsx, apps/desktop/src/renderer/components/chat/NewMessageIndicator.tsx, apps/desktop/src/renderer/components/chat/PlanReviewBubble.tsx, apps/desktop/src/renderer/components/chat/PrevMessageJumpChip.tsx, apps/desktop/src/renderer/components/chat/ProjectLinkChip.tsx, apps/desktop/src/renderer/components/chat/QuoteChip.tsx, apps/desktop/src/renderer/components/chat/RewindPreviewDialog.tsx, apps/desktop/src/renderer/components/chat/SelectionQuoteButton.tsx, apps/desktop/src/renderer/components/chat/SentAgentReferenceChip.tsx, apps/desktop/src/renderer/components/chat/SentInlineAtomBody.tsx, apps/desktop/src/renderer/components/chat/SessionHandoffCard.tsx, apps/desktop/src/renderer/components/chat/SessionLinkChip.tsx, apps/desktop/src/renderer/components/chat/ShareMessageCheckbox.tsx, apps/desktop/src/renderer/components/chat/ShareSelectionBar.tsx, apps/desktop/src/renderer/components/chat/SlackIcon.tsx, apps/desktop/src/renderer/components/chat/StreamFadeSpan.tsx, apps/desktop/src/renderer/components/chat/StreamingMarkdownChunk.tsx, apps/desktop/src/renderer/components/chat/SystemCard.tsx, apps/desktop/src/renderer/components/chat/TextLightbox.tsx, apps/desktop/src/renderer/components/chat/ThinkingCard.tsx, apps/desktop/src/renderer/components/chat/ThinkingText.tsx, apps/desktop/src/renderer/components/chat/TodoListCard.tsx, apps/desktop/src/renderer/components/chat/ToolCallCard.tsx, apps/desktop/src/renderer/components/chat/ToolPayloadLightbox.tsx, apps/desktop/src/renderer/components/chat/TopRightChipStack.tsx, apps/desktop/src/renderer/components/chat/TurnChangesCard.tsx, apps/desktop/src/renderer/components/chat/UnreadFailedScheduleBanner.tsx, apps/desktop/src/renderer/components/chat/UpgradeBanner.tsx, apps/desktop/src/renderer/components/chat/UserAttachmentChip.tsx, apps/desktop/src/renderer/components/chat/UserMessage.tsx, apps/desktop/src/renderer/components/chat/UserMessageEditBox.tsx, apps/desktop/src/renderer/components/chat/UserMessageUrlLink.tsx, apps/desktop/src/renderer/components/chat/VideoLightbox.tsx, apps/desktop/src/renderer/components/chat/WorkGroupBlock.tsx, apps/desktop/src/renderer/components/chat/WorktreeRestoreBanner.tsx, apps/desktop/src/renderer/components/chat/XIcon.tsx, apps/desktop/src/renderer/components/chat/activityRowChrome.ts, apps/desktop/src/renderer/components/chat/animateFocusScroll.ts, apps/desktop/src/renderer/components/chat/autoFollowIntent.ts, apps/desktop/src/renderer/components/chat/chatChrome.ts, apps/desktop/src/renderer/components/chat/errorReasonI18n.ts, apps/desktop/src/renderer/components/chat/generatedFilesProjection.ts, apps/desktop/src/renderer/components/chat/imageDisplaySize.ts, apps/desktop/src/renderer/components/chat/lightboxAnnotations.ts, apps/desktop/src/renderer/components/chat/lightboxGestures.ts, apps/desktop/src/renderer/components/chat/markdownImageTargets.ts, apps/desktop/src/renderer/components/chat/messageNavRailModel.ts, apps/desktop/src/renderer/components/chat/messageNavRailWheel.ts, apps/desktop/src/renderer/components/chat/messageNavigationProjection.ts, apps/desktop/src/renderer/components/chat/messageProjectionCache.ts, apps/desktop/src/renderer/components/chat/messageStreamIndicatorPosition.ts, apps/desktop/src/renderer/components/chat/messageViewportCompensation.ts, apps/desktop/src/renderer/components/chat/messageViewportGeometry.ts, apps/desktop/src/renderer/components/chat/messageWorkGroups.ts, apps/desktop/src/renderer/components/chat/observeProgrammaticScroll.ts, apps/desktop/src/renderer/components/chat/rehypeFencedCodeMarker.ts, apps/desktop/src/renderer/components/chat/rehypeHighlightShared.ts, apps/desktop/src/renderer/components/chat/rehypeMathBlockMarker.ts, apps/desktop/src/renderer/components/chat/rehypeStreamWordFade.ts, apps/desktop/src/renderer/components/chat/remarkHtmlImages.ts, apps/desktop/src/renderer/components/chat/remarkLocalPathLinks.ts, apps/desktop/src/renderer/components/chat/remarkPreserveRawLocalDestinations.ts, apps/desktop/src/renderer/components/chat/remarkSessionLinks.ts, apps/desktop/src/renderer/components/chat/remarkStrictInlineMath.ts, apps/desktop/src/renderer/components/chat/remarkTruncateCjkUrls.ts, apps/desktop/src/renderer/components/chat/repairStreamingMarkdown.ts, apps/desktop/src/renderer/components/chat/scrollAnchoringDetect.ts, apps/desktop/src/renderer/components/chat/shareSelectionStore.ts, apps/desktop/src/renderer/components/chat/streamingMarkdownBlocks.tsx, apps/desktop/src/renderer/components/chat/streamingMarkdownChunks.ts, apps/desktop/src/renderer/components/chat/streamingMessageProjection.ts, apps/desktop/src/renderer/components/chat/toolLoopI18n.ts, apps/desktop/src/renderer/components/chat/unreadCount.ts, apps/desktop/src/renderer/components/chat/useAutomaticHistoryLoadBudget.ts, apps/desktop/src/renderer/components/chat/useCopyAsImage.tsx, apps/desktop/src/renderer/components/chat/useDeleteMessage.ts, apps/desktop/src/renderer/components/chat/useFileChipContextMenu.tsx, apps/desktop/src/renderer/components/chat/useForkAtMessage.ts, apps/desktop/src/renderer/components/chat/useMessageViewport.ts, apps/desktop/src/renderer/components/chat/useNavigationKeyListener.ts, apps/desktop/src/renderer/components/chat/useOpenWithMenu.tsx, apps/desktop/src/renderer/components/chat/usePrevUserMessageInView.ts, apps/desktop/src/renderer/components/chat/useTurnChangeSets.ts, apps/desktop/src/renderer/components/chat/userMessageCollapse.ts, apps/desktop/src/renderer/components/chat/userMessageDisplayText.ts, apps/desktop/src/renderer/components/chat/userMessageLinkify.ts, apps/desktop/src/renderer/components/chat/viewportFillDetect.ts, apps/desktop/src/renderer/components/new-chat/AddRemoteProjectDialog.tsx, apps/desktop/src/renderer/components/new-chat/AgentSelect.tsx, apps/desktop/src/renderer/components/new-chat/AskUserQuestionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/AtMentionPanel.tsx, apps/desktop/src/renderer/components/new-chat/AttachmentTypeThumb.tsx, apps/desktop/src/renderer/components/new-chat/ChatInput.tsx, apps/desktop/src/renderer/components/new-chat/CjkPunctDecoration.ts, apps/desktop/src/renderer/components/new-chat/CjkPunctuationUtils.ts, apps/desktop/src/renderer/components/new-chat/ComposerAttachments.tsx, apps/desktop/src/renderer/components/new-chat/ComposerListIndentDecoration.ts, apps/desktop/src/renderer/components/new-chat/ComposerListNodes.ts, apps/desktop/src/renderer/components/new-chat/ComposerQuoteNode.tsx, apps/desktop/src/renderer/components/new-chat/DeviceSwitcherPill.tsx, apps/desktop/src/renderer/components/new-chat/EffortSlider.tsx, apps/desktop/src/renderer/components/new-chat/EmptyDocSelectionGuard.ts, apps/desktop/src/renderer/components/new-chat/ExtraDirsButton.tsx, apps/desktop/src/renderer/components/new-chat/FastModeToggle.tsx, apps/desktop/src/renderer/components/new-chat/FolderPickerPopover.tsx, apps/desktop/src/renderer/components/new-chat/FullAccessConfirmContent.tsx, apps/desktop/src/renderer/components/new-chat/GhostCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/GoalAdvancedLimits.tsx, apps/desktop/src/renderer/components/new-chat/GoalIndicator.tsx, apps/desktop/src/renderer/components/new-chat/HomeUsageDashboard.tsx, apps/desktop/src/renderer/components/new-chat/ListComposerTextarea.tsx, apps/desktop/src/renderer/components/new-chat/LocalModelCatalogNotice.tsx, apps/desktop/src/renderer/components/new-chat/MentionChipNode.tsx, apps/desktop/src/renderer/components/new-chat/MentionDragCaretDecoration.ts, apps/desktop/src/renderer/components/new-chat/ModelCompatibilityNotice.tsx, apps/desktop/src/renderer/components/new-chat/ModelConfigFlyout.tsx, apps/desktop/src/renderer/components/new-chat/ModelHarnessPicker.tsx, apps/desktop/src/renderer/components/new-chat/ModelSelector.tsx, apps/desktop/src/renderer/components/new-chat/ModelSourceDetails.tsx, apps/desktop/src/renderer/components/new-chat/NewGoalDialog.tsx, apps/desktop/src/renderer/components/new-chat/PastedTextChipNode.tsx, apps/desktop/src/renderer/components/new-chat/PendingQueuePanel.tsx, apps/desktop/src/renderer/components/new-chat/PermissionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/PermissionSelector.tsx, apps/desktop/src/renderer/components/new-chat/PinnedPlanPanel.tsx, apps/desktop/src/renderer/components/new-chat/PlanActionCard.tsx, apps/desktop/src/renderer/components/new-chat/PlanModeIndicator.tsx, apps/desktop/src/renderer/components/new-chat/PlanViewerCard.tsx, apps/desktop/src/renderer/components/new-chat/PluginConnectionForm.tsx, apps/desktop/src/renderer/components/new-chat/PluginOauthDeviceCode.tsx, apps/desktop/src/renderer/components/new-chat/PluginSetupPrompt.tsx, apps/desktop/src/renderer/components/new-chat/PluginWriteAccessRecovery.tsx, apps/desktop/src/renderer/components/new-chat/QuickStartPillMark.ts, apps/desktop/src/renderer/components/new-chat/RemoteOauthSetupCard.tsx, apps/desktop/src/renderer/components/new-chat/SendButton.tsx, apps/desktop/src/renderer/components/new-chat/SlashCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/SlashCommandPalette.tsx, apps/desktop/src/renderer/components/new-chat/TakeoverMask.tsx, apps/desktop/src/renderer/components/new-chat/ThinkingToggle.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedFlyoutHost.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelPanel.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRail.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRow.tsx, apps/desktop/src/renderer/components/new-chat/UsageDailyBars.tsx, apps/desktop/src/renderer/components/new-chat/UsageHeatmap.tsx, apps/desktop/src/renderer/components/new-chat/VendorSegmentedSwitcher.tsx, apps/desktop/src/renderer/components/new-chat/VoiceInputDraftDecoration.ts, apps/desktop/src/renderer/components/new-chat/WindowsSelectionReplacement.ts, apps/desktop/src/renderer/components/new-chat/WorktreeChipsRow.tsx, apps/desktop/src/renderer/components/new-chat/WorktreeCreatingOverlay.tsx, apps/desktop/src/renderer/components/new-chat/agentOptions.ts, apps/desktop/src/renderer/components/new-chat/agentSwitchConfirmation.ts, apps/desktop/src/renderer/components/new-chat/branchPick.ts, apps/desktop/src/renderer/components/new-chat/composerBlankPointerFocus.ts, apps/desktop/src/renderer/components/new-chat/composerContentSerialization.ts, apps/desktop/src/renderer/components/new-chat/composerDocState.ts, apps/desktop/src/renderer/components/new-chat/composerFrameScheduler.ts, apps/desktop/src/renderer/components/new-chat/composerHistoryProjection.ts, apps/desktop/src/renderer/components/new-chat/composerModelSelection.ts, apps/desktop/src/renderer/components/new-chat/composerPromptRecommendation.ts, apps/desktop/src/renderer/components/new-chat/composerRenderGate.ts, apps/desktop/src/renderer/components/new-chat/composerSendOwnership.ts, apps/desktop/src/renderer/components/new-chat/composerSendSnapshot.ts, apps/desktop/src/renderer/components/new-chat/effortChangeQueue.ts, apps/desktop/src/renderer/components/new-chat/extraDirsActions.ts, apps/desktop/src/renderer/components/new-chat/ghostComposerPlacement.ts, apps/desktop/src/renderer/components/new-chat/localAttachmentPicker.ts, apps/desktop/src/renderer/components/new-chat/mentionChipInsertion.ts, apps/desktop/src/renderer/components/new-chat/modelWindowErrorToast.ts, apps/desktop/src/renderer/components/new-chat/pastePipeline.ts, apps/desktop/src/renderer/components/new-chat/pathPaste.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueLocks.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowActivity.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowPresentation.ts, apps/desktop/src/renderer/components/new-chat/planModeComposerCommand.ts, apps/desktop/src/renderer/components/new-chat/priceTierMarks.tsx, apps/desktop/src/renderer/components/new-chat/remoteBrowseAdapters.ts, apps/desktop/src/renderer/components/new-chat/remoteExistingProjects.ts, apps/desktop/src/renderer/components/new-chat/restoreComposerDocument.ts, apps/desktop/src/renderer/components/new-chat/sessionLinkPaste.ts, apps/desktop/src/renderer/components/new-chat/sourceSwitch.ts, apps/desktop/src/renderer/components/new-chat/unifiedModelSelection.ts, apps/desktop/src/renderer/components/new-chat/usagePalette.ts, apps/desktop/src/renderer/components/new-chat/useComposerSendFocusRestore.ts, apps/desktop/src/renderer/components/new-chat/useModelDiscoveryPending.ts, apps/desktop/src/renderer/components/new-chat/useProviderWeeklyQuota.ts, apps/desktop/src/renderer/components/new-chat/useUnifiedRowActions.ts, apps/desktop/src/renderer/features/cc-agent/CCAgentFeatureLayout.tsx, apps/desktop/src/renderer/features/cc-agent/CCAgentSessionView.tsx | 255 | 41 | 341 |
| `desktop.dev.maker-experimental` | desktop | Maker 实验诊断页 | hash `/maker-experimental`(MakerExperimentalView;EXPERIMENTAL_FEATURES 现为空,仍是生产路由) | MakerExperimentalView | apps/desktop/src/renderer/features/maker-experimental/MakerExperimentalView.tsx | 9 | 0 | 7 |
| `desktop.issues.guide` | desktop | Issue 引导页 | hash `/issues`(IssueTrackerFeatureLayout,已迁 GitHub 后的引导页) | IssueTrackerFeatureLayout | apps/desktop/src/renderer/features/issue-tracker/IssueTrackerFeatureLayout.tsx, apps/desktop/src/renderer/features/issue-tracker/MyIssueList.tsx, apps/desktop/src/renderer/features/issue-tracker/hooks/useMyIssues.ts, apps/desktop/src/renderer/features/issue-tracker/lib/myIssuesNotices.ts, apps/desktop/src/renderer/features/issue-tracker/lib/startIssueChat.ts | 0 | 0 | 7 |
| `desktop.native.app-menu` | desktop | 应用菜单 | Menu.setApplicationMenu(用户可见出口,不展开业务逻辑) | applicationMenuLabels | apps/desktop/src/main/applicationMenuLabels.ts | 0 | 0 | 0 |
diff --git a/packages/maker-core/src/agents/claude-code/__tests__/bot-own-skills-mount.test.ts b/packages/maker-core/src/agents/claude-code/__tests__/bot-own-skills-mount.test.ts
index aa2e2e14f5..5301422c84 100644
--- a/packages/maker-core/src/agents/claude-code/__tests__/bot-own-skills-mount.test.ts
+++ b/packages/maker-core/src/agents/claude-code/__tests__/bot-own-skills-mount.test.ts
@@ -305,6 +305,12 @@ describe('Cindy managed skills use Claude session plugins', () => {
describe('managed skill command collisions', () => {
+ async function isolatedWorkingDir(): Promise<string> {
+ const workingDir = await makeTempDir();
+ // Stop native ancestor discovery at this fixture rather than the user's home.
+ await fs.mkdir(path.join(workingDir, '.git'));
+ return workingDir;
+ }
it('keeps user /learn and exposes Cindy under its full native name', async () => {
const configDir = await makeTempDir();
process.env.CLAUDE_CONFIG_DIR = configDir;
@@ -315,7 +321,7 @@ describe('managed skill command collisions', () => {
deps.getManagedSkills = async () => [{ kind: 'agent-skill', name: 'learn', source: 'skill',
path: '/cindy/learn/SKILL.md', enabled: true, claudeCommandName: 'cindy:learn' }];
const agent = new ClaudeCodeAgent(deps);
- const result = await agent.listRuntimeSkills({ workingDir: await makeTempDir(), runtimeConfigDir: configDir });
+ const result = await agent.listRuntimeSkills({ workingDir: await isolatedWorkingDir(), runtimeConfigDir: configDir });
expect(result.skills.map((skill) => skill.name)).toEqual(['cindy:learn', 'learn']);
expect(result.skills[0]?.runtimeCommandName).toBe('cindy:learn');
expect(result.skills[1]?.path).toBe(path.join(userSkill, 'SKILL.md'));
@@ -329,7 +335,7 @@ describe('managed skill command collisions', () => {
kind: 'agent-skill', name: index ? 'demo' : 'learn', source: 'skill', enabled: true,
path: `/${plugin}/SKILL.md`, claudeCommandName: `${plugin}:${index ? 'demo' : 'learn'}`,
}));
- const result = await new ClaudeCodeAgent(deps).listRuntimeSkills({ workingDir: await makeTempDir(), runtimeConfigDir: configDir });
+ const result = await new ClaudeCodeAgent(deps).listRuntimeSkills({ workingDir: await isolatedWorkingDir(), runtimeConfigDir: configDir });
expect(result.skills.map((skill) => skill.name)).toEqual(['learn', 'cindy-plugin-a:demo', 'cindy-plugin-b:demo']);
});
});
diff --git a/packages/maker-core/src/agents/claude-code/__tests__/context-window.integration.test.ts b/packages/maker-core/src/agents/claude-code/__tests__/context-window.integration.test.ts
index e9271b40aa..850de75c44 100644
--- a/packages/maker-core/src/agents/claude-code/__tests__/context-window.integration.test.ts
+++ b/packages/maker-core/src/agents/claude-code/__tests__/context-window.integration.test.ts
@@ -1,9 +1,11 @@
-import { existsSync, mkdtempSync, rmSync } from 'node:fs';
+import { spawn } from 'node:child_process';
+import { existsSync, mkdtempSync } from 'node:fs';
+import { rm } from 'node:fs/promises';
import { createServer } from 'node:http';
import { tmpdir } from 'node:os';
import path from 'node:path';
import { fileURLToPath } from 'node:url';
-import { query, type SDKUserMessage } from '@anthropic-ai/claude-agent-sdk';
+import { query, type SDKUserMessage, type SpawnOptions } from '@anthropic-ai/claude-agent-sdk';
import { describe, expect, it } from 'vitest';
import { buildClaudeEnv, applyClaudeContextWindow } from '../env-builder.js';
import { createAsyncQueue } from '../../shared/async-queue.js';
@@ -12,10 +14,41 @@ const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../../.
const binary = path.join(root, 'apps/claude-code-bin', `${process.platform}-${process.arch}`,
process.platform === 'win32' ? 'claude.exe' : 'claude');
+/** Query.close() requests termination; Windows retains cwd until the process closes. */
+function trackedClaudeProcess() {
+ const closed: Promise<void>[] = [];
+ return {
+ spawn(options: SpawnOptions) {
+ const child = spawn(options.command, options.args, {
+ cwd: options.cwd, env: options.env, signal: options.signal,
+ stdio: ['pipe', 'pipe', 'pipe'], windowsHide: true,
+ });
+ // Drain stderr just as the SDK's default launcher does.
+ child.stderr.resume();
+ closed.push(new Promise<void>((resolve) => child.once('close', () => resolve())));
+ return child;
+ },
+ async waitForClose() {
+ let timer: ReturnType<typeof setTimeout> | undefined;
+ try {
+ await Promise.race([
+ Promise.all(closed),
+ new Promise<never>((_, reject) => {
+ timer = setTimeout(() => reject(new Error('Claude test process did not close')), 10_000);
+ }),
+ ]);
+ } finally {
+ clearTimeout(timer);
+ }
+ },
+ };
+}
+
describe.skipIf(!existsSync(binary))('Claude native context policy (isolated home, fake upstream)', () => {
it.each([{ window: 1_000, compact: true, resume: false }, { window: 128_000, compact: false, resume: false },
{ window: 1_000, compact: true, resume: true }])(
'uses the configured $window budget for native compaction (resume: $resume)', { timeout: 60_000 }, async ({ window, compact, resume }) => {
+ const runtime = trackedClaudeProcess();
const home = mkdtempSync(path.join(tmpdir(), 'claude-native-compact-'));
const bodies: string[] = [];
const server = createServer((req, res) => {
@@ -54,6 +87,7 @@ describe.skipIf(!existsSync(binary))('Claude native context policy (isolated hom
});
let input = createAsyncQueue<SDKUserMessage>();
const options = {
+ spawnClaudeCodeProcess: runtime.spawn,
pathToClaudeCodeExecutable: binary, cwd: home, model: 'claude-opus-4-6[1m]',
tools: [], mcpServers: {}, settingSources: [], systemPrompt: 'Context control test.',
maxTurns: 3, env: { ...env, HOME: home, USERPROFILE: home, CLAUDE_CONFIG_DIR: home,
@@ -80,6 +114,7 @@ describe.skipIf(!existsSync(binary))('Claude native context policy (isolated hom
if (resume && results === 2) {
expect(compacted).toBe(false);
q.close(); input.end();
+ await runtime.waitForClose();
requestsBeforeResume = bodies.length;
const resumedEnv: Record<string, string> = { ...env, HOME: home, USERPROFILE: home, CLAUDE_CONFIG_DIR: home };
applyClaudeContextWindow(resumedEnv, window, 90);
@@ -99,12 +134,14 @@ describe.skipIf(!existsSync(binary))('Claude native context policy (isolated hom
expect(bodies.at(-1)).toContain('CONTEXT_HISTORY_CANARY');
} finally {
q.close(); input.end();
+ await runtime.waitForClose();
await new Promise<void>((resolve) => server.close(() => resolve()));
- rmSync(home, { recursive: true, force: true });
+ await rm(home, { recursive: true, force: true, maxRetries: 5, retryDelay: 100 });
}
});
it('reads the native working window and its documented minimum for known models', { timeout: 60_000 }, async () => {
+ const runtime = trackedClaudeProcess();
const home = mkdtempSync(path.join(tmpdir(), 'claude-context-policy-'));
const server = createServer((req, res) => {
req.resume();
@@ -127,6 +164,7 @@ describe.skipIf(!existsSync(binary))('Claude native context policy (isolated hom
const pending = new Promise<void>((resolve) => { release = resolve; });
async function* prompt(): AsyncGenerator<SDKUserMessage> { await pending; }
const q = query({ prompt: prompt(), options: {
+ spawnClaudeCodeProcess: runtime.spawn,
pathToClaudeCodeExecutable: binary, cwd: home, model,
tools: [], mcpServers: {}, settingSources: [], systemPrompt: 'Context control test.',
env: { ...env, HOME: home, USERPROFILE: home, CLAUDE_CONFIG_DIR: home,
@@ -141,11 +179,11 @@ describe.skipIf(!existsSync(binary))('Claude native context policy (isolated hom
expect(usage.rawMaxTokens).toBe(Math.max(100_000, window));
expect(usage.maxTokens).toBe(Math.max(100_000, window));
expect(usage.isAutoCompactEnabled).toBe(true);
- } finally { q.close(); release(); }
+ } finally { q.close(); release(); await runtime.waitForClose(); }
}
} finally {
await new Promise<void>((resolve) => server.close(() => resolve()));
- rmSync(home, { recursive: true, force: true });
+ await rm(home, { recursive: true, force: true, maxRetries: 5, retryDelay: 100 });
}
});
});
diff --git a/packages/maker-core/src/agents/claude-code/__tests__/rewind-runtime-settings.test.ts b/packages/maker-core/src/agents/claude-code/__tests__/rewind-runtime-settings.test.ts
index dd4eb60288..9a311c3018 100644
--- a/packages/maker-core/src/agents/claude-code/__tests__/rewind-runtime-settings.test.ts
+++ b/packages/maker-core/src/agents/claude-code/__tests__/rewind-runtime-settings.test.ts
@@ -180,7 +180,7 @@ function createFakeQuery(stream = createControlledStream()) {
[Symbol.asyncIterator]: () => stream[Symbol.asyncIterator](),
setPermissionMode: vi.fn(async () => assertWritable()),
setModel: vi.fn(async () => assertWritable()),
- applyFlagSettings: vi.fn(async () => assertWritable()),
+ applyFlagSettings: vi.fn(async (_settings: Record<string, unknown>) => assertWritable()),
interrupt: vi.fn(async () => {}),
send: vi.fn(async () => {}),
close: vi.fn(() => {
diff --git a/packages/maker-core/src/agents/pi/__tests__/nativeProviderAdapterRefresh.test.ts b/packages/maker-core/src/agents/pi/__tests__/nativeProviderAdapterRefresh.test.ts
index 02d4c59fc5..c032d62237 100644
--- a/packages/maker-core/src/agents/pi/__tests__/nativeProviderAdapterRefresh.test.ts
+++ b/packages/maker-core/src/agents/pi/__tests__/nativeProviderAdapterRefresh.test.ts
@@ -91,6 +91,36 @@ describe('Cindy native provider refresh bridge', () => {
expect(h.handlers.size).toBe(1);
});
+ it.each([
+ ['missing', () => { throw Object.assign(new Error('missing'), { code: 'ENOENT' }); }, {}],
+ ['configured', () => JSON.stringify({ compaction: { reserveTokens: 1234 } }), { compaction: { reserveTokens: 1234 } }],
+ ])('loads legacy runtime settings when the file is %s', (_label, read, expected) => {
+ const source = CINDY_BRIDGE_EXTENSION_SOURCE;
+ const start = source.indexOf('const initialNativeSettings =');
+ const end = source.indexOf("pi.registerCommand('cindy-native-provider-refresh'", start);
+ const code = source.slice(start, end) + ';globalThis.settings = initialNativeSettings;';
+ const sandbox: Record<string, unknown> = {
+ pi: {}, process: { env: { PI_CODING_AGENT_DIR: '/fixture' } },
+ path: { join: () => '/fixture/settings.json' }, readFileSync: read,
+ };
+ runInNewContext(code, sandbox);
+ expect(sandbox.settings).toEqual(expected);
+ });
+
+ it.each(['EACCES', 'invalid-json'])('does not hide %s while loading legacy settings', (kind) => {
+ const source = CINDY_BRIDGE_EXTENSION_SOURCE;
+ const start = source.indexOf('const initialNativeSettings =');
+ const end = source.indexOf("pi.registerCommand('cindy-native-provider-refresh'", start);
+ expect(() => runInNewContext(source.slice(start, end), {
+ pi: {}, process: { env: { PI_CODING_AGENT_DIR: '/fixture' } },
+ path: { join: () => '/fixture/settings.json' },
+ readFileSync: () => {
+ if (kind === 'EACCES') throw Object.assign(new Error('denied'), { code: 'EACCES' });
+ return '{';
+ },
+ })).toThrow();
+ });
+
it('acknowledges success only after applying a valid staged snapshot', async () => {
const source = CINDY_BRIDGE_EXTENSION_SOURCE;
const start = source.indexOf('const initialNativeSettings =');
diff --git a/packages/maker-core/src/agents/pi/cindy-bridge-source.ts b/packages/maker-core/src/agents/pi/cindy-bridge-source.ts
index e0fd535bd7..4a9f164c3d 100644
--- a/packages/maker-core/src/agents/pi/cindy-bridge-source.ts
+++ b/packages/maker-core/src/agents/pi/cindy-bridge-source.ts
@@ -3678,7 +3678,16 @@ export default async function cindyBridge(pi: any) {
installTextOnlyTurnPolicy(pi);
const nativeProviderAdapters = await registerCindyNativeProviderAdapters(pi);
const initialNativeSettings = typeof pi.getSettings === 'function' ? undefined
- : JSON.parse(readFileSync(path.join(process.env.PI_CODING_AGENT_DIR, 'settings.json'), 'utf8'));
+ : (() => {
+ try {
+ return JSON.parse(readFileSync(path.join(process.env.PI_CODING_AGENT_DIR, 'settings.json'), 'utf8'));
+ } catch (error) {
+ // Durable child homes may have no settings file: Pi uses its defaults.
+ // Keep malformed/unreadable settings visible instead of hiding them.
+ if (error?.code === 'ENOENT') return {};
+ throw error;
+ }
+ })();
pi.registerCommand('cindy-native-provider-refresh', {
description: 'Cindy internal native provider refresh',
handler: async (args: string, ctx: any) => {
diff --git a/packages/maker-remote-ssh/src/__tests__/remote-agent-installer.test.ts b/packages/maker-remote-ssh/src/__tests__/remote-agent-installer.test.ts
index ed09317e61..d54b40d19e 100644
--- a/packages/maker-remote-ssh/src/__tests__/remote-agent-installer.test.ts
+++ b/packages/maker-remote-ssh/src/__tests__/remote-agent-installer.test.ts
@@ -1,9 +1,10 @@
-import { describe, expect, it } from 'vitest';
+import { beforeAll, describe, expect, it } from 'vitest';
import { spawnSync } from 'node:child_process';
import { chmodSync, mkdirSync, mkdtempSync, rmSync, writeFileSync } from 'node:fs';
import os from 'node:os';
import path from 'node:path';
import codexPackage from '../../../../tools/codex-package/latest.json';
+import { resolvePosixShell } from '../../../../scripts/lib/posix-shell.mjs';
import { BOOTSTRAP_SH, VERIFY_CODEX_LAYOUT_SH } from '../bootstrap/bootstrap-script.js';
import {
@@ -17,6 +18,21 @@ import {
import type { RemoteHost } from '../RemoteHost.js';
describe('remote agent installer', () => {
+ let bash: string;
+ beforeAll(() => {
+ const shell = resolvePosixShell('bash');
+ if (!shell) throw new Error('Git Bash is required for the remote bootstrap tests');
+ bash = shell;
+ // Git Bash's first launch on a cold Windows runner can exceed the 5s test
+ // budget. Initialize it once in fixture setup (the default 10s hook budget),
+ // keeping all syntax and behavior assertions under their normal timeout.
+ const result = spawnSync(bash, ['--noprofile', '--norc', '-c', ':'], {
+ encoding: 'utf8', timeout: 8_000, windowsHide: true,
+ });
+ expect(result.error).toBeUndefined();
+ expect(result.status, result.stderr).toBe(0);
+ });
+
it('passes the pinned Codex release to the remote bootstrap script', async () => {
const calls: Array<{ command: string; input: string }> = [];
const host = {
@@ -52,7 +68,7 @@ describe('remote agent installer', () => {
});
it('keeps the generated bootstrap valid bash', () => {
- const result = spawnSync('bash', ['-n'], { input: BOOTSTRAP_SH, encoding: 'utf8' });
+ const result = spawnSync(bash, ['-n'], { input: BOOTSTRAP_SH, encoding: 'utf8' });
expect(result.error).toBeUndefined();
expect(result.status, result.stderr).toBe(0);
});
@@ -79,7 +95,7 @@ describe('remote agent installer', () => {
writeFileSync(destination, '#!/bin/sh\nexit 0\n');
chmodSync(destination, 0o755);
}
- const result = spawnSync('bash', ['-c', `
+ const result = spawnSync(bash, ['-c', `
BIN_PATH="$PWD/codex"
uname() { printf '%s\n' '${remoteOs}'; }
${VERIFY_CODEX_LAYOUT_SH}
@@ -151,7 +167,7 @@ describe('remote agent installer', () => {
exec: async (command: string, opts: { input?: string }) => {
const args = [...command.matchAll(/'([^']*)'/g)].map((match) => match[1]);
expect(args).toContain(PINNED_CODEX_RELEASE_VERSION);
- const result = spawnSync('bash', ['-s', '--', ...args], {
+ const result = spawnSync(bash, ['-s', '--', ...args], {
cwd: root, encoding: 'utf8',
input: 'export HOME="$PWD"\ncurl() { return 1; }\nwget() { return 1; }\n' + opts.input,
});
diff --git a/scripts/lib/posix-shell.d.mts b/scripts/lib/posix-shell.d.mts
new file mode 100644
index 0000000000..a45007c988
--- /dev/null
+++ b/scripts/lib/posix-shell.d.mts
@@ -0,0 +1,12 @@
+import { spawnSync } from 'node:child_process';
+import { existsSync } from 'node:fs';
+
+export function resolvePosixShell(
+ shellName: string,
+ options?: {
+ platform?: NodeJS.Platform;
+ env?: NodeJS.ProcessEnv;
+ spawnSyncImpl?: typeof spawnSync;
+ existsSync?: typeof existsSync;
+ },
+): string | null;