Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
fix(desktop): 按视窗挂载消息正文并稳定滚动定位 (#5454)
DavidShenXDa5467dc0c166
diff --git a/apps/desktop/scripts/ax5406/BLACKBOX-VALIDATION.md b/apps/desktop/scripts/ax5406/BLACKBOX-VALIDATION.mdnew file mode 100644index 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.mjsnew file mode 100644index 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.mjsnew file mode 100644index 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.mjsnew file mode 100644index 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.htmlnew file mode 100644index 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.jsxnew file mode 100644index 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.htmlnew file mode 100644index 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.jsnew file mode 100644index 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.mjsnew file mode 100644index 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.mjsnew file mode 100644index 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.cjsnew file mode 100644index 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.cjsnew file mode 100644index 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.mjsnew file mode 100644index 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.mjsnew file mode 100644index 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('&','&').replaceAll('<','<');+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.mjsnew file mode 100644index 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.cjsnew file mode 100644index 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.mjsnew file mode 100644index 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('&','&').replaceAll('<','<');+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.cjsnew file mode 100644index 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.cppnew file mode 100644index 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.mjsnew file mode 100644index 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('&','&').replaceAll('<','<');+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.mjsnew file mode 100644index 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('&','&').replaceAll('<','<');+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.cjsnew file mode 100644index 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.mjsnew file mode 100644index 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.cjsnew file mode 100644index 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.ps1new file mode 100644index 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 -Compressdiff --git a/apps/desktop/scripts/ax5406/visual-gallery.mjs b/apps/desktop/scripts/ax5406/visual-gallery.mjsnew file mode 100644index 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('&', '&').replaceAll('<', '<').replaceAll('"', '"');+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.cjsnew file mode 100644index 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.tsnew file mode 100644index 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.tsindex 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.tsindex 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.tsnew file mode 100644index 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.tsindex 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.tsindex 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.jsconst 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsnew file mode 100644index 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.tsnew file mode 100644index 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.tsindex 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.tsindex 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): (() => voicontextBridge.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.tsnew file mode 100644index 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.tsnew file mode 100644index 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.tsnew file mode 100644index 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.tsnew file mode 100644index 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.tsindex 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.tsxnew file mode 100644index 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.tsnew file mode 100644index 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.tsxnew file mode 100644index 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.tsnew file mode 100644index 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.tsxnew file mode 100644index 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.tsxnew file mode 100644index 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.tsnew file mode 100644index 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.tsindex 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.tsnew file mode 100644index 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.tsxindex 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 => <divref={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.tsxnew file mode 100644index 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.tsnew file mode 100644index 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.tsnew file mode 100644index 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.tsnew file mode 100644index 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.tsnew file mode 100644index 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.tsxindex 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.tsxindex 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.tsnew file mode 100644index 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.tsnew file mode 100644index 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.cssindex 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 containingblock. 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.tsindex 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.tsnew file mode 100644index 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.mdindex 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.tsindex 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.tsindex 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 homif (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 homexpect(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 homconst 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 homexpect(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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.mtsnew file mode 100644index 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;