Skip to content

前端流畅性:减少重复渲染、工具组按需显示、Excel Worker 与脉络图缓存 - #234

Merged
greyoak111 merged 5 commits into
greyoak111:mainfrom
chenshi723:perf/frontend-fluency-all-20261118
Nov 18, 2026
Merged

greyoak111 merged 5 commits into
greyoak111:mainfrom
chenshi723:perf/frontend-fluency-all-20261118

Conversation

@chenshi723

Copy link
Copy Markdown
Contributor

关联与提交状态

Refs #233。已按“大改先聊”先发布提案,维护者回复“接受”;这里先提供 Draft PR 供逐项审阅,不请求在设备验收未完成时合并。

基于 main f1188f538bc4540a436dd52b43ce35c84e9520c5。整合最近两批通用前端优化,分为 5 个独立提交;共 34 个文件,15 个生产文件,其余为回归测试和合成浏览器 fixture。没有携带 fork 专属托管/远程来源、接口配置、包名/签名或其他定制。

改了什么

1. 减少重复工作与长代码高亮阻塞(9a25be0)

  • 流式高亮预算 2000 字符/40 行,定稿 12000 字符/160 行;超预算保留可复制原文。异步库加载回调只处理原节点,重新检查预算,不以流式旧回调干扰定稿。
  • 隐藏的会话整页不在状态事件中重建,侧栏仍更新,重进立即绘制内存状态。搜索使用首次 ID 索引,保留原 find 的重复 ID 首条语义。
  • 组件与定时任务详情在内容不变时保留 DOM;变化时恢复对应条目的展开状态,失败控件回滚会失效缓存。
  • 文件 Git 标记每次只计算一次可见列表;终端主题值没有变化时不触发 xterm 重绘。
  • 稳定模型面板可用高度,避免短中文待发消息被 flex 挤窄。

2. 工具组按需挂载(23b3a27)

  • 折叠组只存调用数据,普通展开按 40 个条目窗口实化;前后分页仍可访问全部步骤。
  • 权限、实时失败、图片允许窗口外例外,不能为了 DOM 上限隐藏待确认卡。
  • 保留子代理/孙代理定位、结果先到、异步回执、在途分页后重试、同 ID owner、防实化重入和顶层增量状态计数。
  • 永久释放覆盖停放在 DocumentFragment 中的步骤、子树与 ThinkBlock 定时器,reset/remove 清理在移除 DOM 前进行。
  • 独立复核还找出“已实化子卡随父条目停放后收到失败回执,错误未重新露出”的边界,本提交已修;新增用例修前确实失败。子工具失败只影响可见性,不混入顶层状态计数,关闭错误后恢复窗口预算。

3. Excel 同源 Worker + 有界分页(3cbb2c2)

  • 转移输入 ArrayBuffer,SheetJS 和完整工作簿只保留在 Worker;主线程不再同步读整本表,也不接收整本工作簿的 structured clone。
  • page/cell 响应有界:每批至多 1200 格、120 可见行、256Ki 个 UTF-16 字符 HTML;维持原 5000 行/200 列显示窗口。
  • 保留隐藏表/行列、宽度、合并隐藏锚点、1904 日期、公式、完整单格内容和原始地址。
  • 不放宽 32MB 输入与 ZIP 展开预算;支持 stat/fetch/load/page/cell 取消、序号/代次检查、120 秒超时、Worker 终止和 pending/timer 清理。
  • 关闭、换文件、切版式、直接隐藏均退出;旧 owner 失效只停自己,不能清掉新文件。
  • Worker 不可用不回退到同步主线程大解析,沿用原版式/PDF/分享出口。

4. 脉络图复用与交互合并(f81f60d)

  • 内容/选项/比例驱动轴与车道缓存,同值新对象可复用,原地内容变化会失效。
  • 选择、多选只更新既有 SVG/树行,家族关系使用索引,保留命中区域与关系语义。
  • wheel/pinch 期间按帧变换预览,结束只做一次精确布局;文字、圆环和勾路径反向缩放。
  • 保留预览后 home 的尺寸与边界恢复。
  • snapshot 独立生成完整场景,不污染活缓存;先读全部计算样式再写具体样式。destroy 清监听器、observer、pointer capture、帧、定时器和引用。

5. 无新增依赖的可选浏览器验收(d7bd345)

新增 node scripts/test-frontend-perf.mjs,仅需 Node 内置 WebSocket/CDP 和已安装 Chromium,可用 CHROMIUM_BIN 指定可执行程序。不修改现有 runner 或 CI。

使用仅回环合成 API/会话/工作簿、生产 app/CSP、真实同源 Worker/vendor;非 GET 一律拒绝并记录,外域请求由 CDP 阻断。覆盖 760 步全可达与窗口、嵌套权限与迟到失败、翻页中在途请求、reset 迟到清理、10 万格 Excel、100/1000 节点地图缓存/手势/导出/销毁。结束清理浏览器进程、profile、锁、连接与 timer。

本次上游移植实际测试

环境:HONOR PPG-AN00、Android 17 arm64,Node 26.12.1,Chromium 156.0.8078.47 无头/GPU 关闭。Node 22 是仓库 CI 环境,不冒称本机已用 Node 22 跑过。

范围 实际结果
最终完整隔离网关套件 1746 tests:1731 pass、7 fail、0 cancelled、8 skipped,约 735 秒,退出码 1
最终新增/相关定向集成(包括已有组件用例) 113/113 pass,0 fail/cancel/skip
工具组审查后聊天/生命周期定向 156/156 pass,0 fail/cancel/skip
Excel Worker/原读取安全/查看器/PDF 定向 76/76 pass
脉络图新旧回归 37/37 pass
最终可选完整 app 浏览器 两轮各 41/41 pass;未捕获异常、外域请求、API 写入均为 0
恢复原样 sparse 验签依赖后 antibreach 14/14 pass
干净 main 的失败对照文件集合 61 tests:54 pass、7 fail、0 cancel/skip;与最终全套的 7 项失败名称和错误一致
静态检查 拼接后的真实 app + 其他变更 JS 语法、git diff --check、内容/范围/字节快照检查通过

以上集合有重叠,不能相加成“总通过项数”。此前 fork 或旧版上游结果不代替本表。

复测入口:

node scripts/test.mjs
node scripts/test.mjs file-term-budget markdown-highlight-budget poll-render-state sessions-render-budget tool-group-render-budget office-worker lineage-render-budget lineage-zoom-boundaries components-ui
CHROMIUM_BIN=/path/to/chromium node scripts/test-frontend-perf.mjs

本机只对测试进程规范化 TMPDIR 的 realpath 别名,并使用 PATH="/system/bin:$PATH" 使 runner 为合成 shell 优先链接系统基础命令;没有修改真实 PREFIX、exec shim、原测试 runner、断言或被测后端。

全套仍失败的 7 项(不是全绿)

在相同局部环境中,以干净 main checkout 重新运行下列文件,七项均复现:

文件/用例 本机实际失败
a0610-b3-office-runs:转换期间 .runs 标记 假 soffice 执行 Permission denied
a0610-g1-mod-firstrun:首次配置失败恢复 系统 toybox tar 不支持 GNU --quoting-style=c,尚未进入预期断言路径
a0611-reconcile-fix:模块修补 同一 GNU tar 参数不支持,修补 state=fail
audit1101:git 钩子超时清理 Git 不能执行合成 pre-commit,Permission denied,未走到超时路径
audit1103:git 钩子信任指纹 同环境合成钩子执行失败,HTTP 500 而不是 200
d10-retention:终端包装脚本 合成包装脚本输出为空,解析 settings 出现 Unexpected end of JSON input
harden-v2b:端侧模型自有服务识别 合成 llama-server 启动 rc=126,未得到 READY ready

这些文件的被测后端不在本 PR diff 中。没有为了让本机全绿修改产品安全机制或删除断言;仍需 CI/兼容环境复测。

8 项 skip:GNU tar 穿链包 1、隔离环境 7-Zip 3、测试临时路径不满足应用目录/别名条件 3、默认关闭的 1.1GB 会话压力 1。不是把失败转换成 skip。

第一轮全套是 1725 pass / 8 fail / 8 skip;其中额外一项来自 sparse checkout 缺原版 devkit/pgp.mjs。恢复该 tracked 原文件(无 diff)后,验签定向 14/14 通过,最终全套不再有此失败。

性能证据与仍存在的限制

此前同一设备、合成无头 Chromium 对照(来自已完成的 fork 隔离验收,不是本 PR 的新帧率测试):

  • 760 步实时工具组两帧展开延迟约 166.9/168.3ms → 16.9/14.2ms;普通挂载卡 760 → 40,所有步骤可达。小组收益较小,点击本身会因实化首批略增加。
  • 10 万格 Excel:旧同步解析 timer 延后约 485.5ms;Worker 首屏约 719ms、主线程 timer 最大延后约 1.4ms。目标是减少主线程阻塞,不是保证总解析更快。
  • 1000 节点地图:4 次选择的轴/布局/scene 各 4 → 0,30 次 wheel 各 30 → 1。首绘并未更快,部分 P95 更高,最终排布/导出仍有数百毫秒长任务;未做视口裁剪,不能宣称稳定 60fps。

真实 Android WebView/GPU、中文输入法、双设备、人工安装/交互仍未完成;没有发送真实聊天、调用付费模型、连接真实中继或更改接口配置。原可选 scripts/test-managed-ui.mjs 的 512000/524288 既有断言没有改动,本 PR 最终验收未重跑该脚本。

交叉与安全初筛说明

  • 保留当前上游 PDF 工具箱:vwPdf 按钮、pdftools 委托与 LibreOffice/PDF 尾部均保留(除新增 sheet 生命周期清理外尾部字节一致)。
  • 与 Draft 修正表格活动页、Git 对比、指令 YAML 和午夜用量统计 #232 的活动表选择触及相同 Excel 区域。 本 PR 仍从第一个可见工作表开始,不声称修复 activeTab,也不复制 修正表格活动页、Git 对比、指令 YAML 和午夜用量统计 #232 的 Git/YAML/用量修复;请维护者决定合并顺序并保留该活动表修正。
  • 原样运行 scripts/pr-guard.mjs <base> HEAD:高 3、中 14,按规则退出 1,未修改或绕过规则。高项是两个新增 gateway/web/office/sheet-*.js 被目录规则标作第三方,以及可选测试脚本被 scripts/ 规则标作构建/发版脚本;这里均为可审阅的 plain JS 源文件,不是替换 minified vendor 或修改构建/签名。中项主要是测试提取实际源码执行、Node Worker 桥与 CDP/Chromium 子进程。请逐行审阅,不能当作初筛已通过。
  • 不改 backend、安全层、vendor、依赖、CI、构建/发版、原生 manifest/DEX/库或签名。没有二进制、符号链接、新可执行位、私有路径、凭据或长编码载荷。

待维护者/设备验收

  • CI / Node 22 结果复核,七项本机基线失败在兼容环境复测。
  • 上述三个安全初筛高路径人工审阅。
  • 实际 Android WebView/GPU、中文输入法与长会话操作。
  • 确定与 修正表格活动页、Git 对比、指令 YAML 和午夜用量统计 #232 的合并顺序及活动表修正保留方式。
  • 大规模地图首绘/导出等剩余长任务继续评估。

🤖 Generated with Claude Code

chenshi723 and others added 5 commits November 18, 2026 10:33
Keep unchanged poll DOM and hidden session lists intact, cache repeated file-list work, avoid redundant terminal theme updates, and stabilize model/queue geometry. Add isolated regressions without dependencies or vendor changes.

Co-Authored-By: Claude Code <noreply@anthropic.com>
Preserve pending permissions, failure and image attention, nested-agent navigation, in-flight paging retries, cached results and identity-safe disposal. Keep child error attention visible after its parent is parked without changing top-level summary counts.

Co-Authored-By: Claude Code <noreply@anthropic.com>
Transfer the input buffer, keep the workbook in the worker, and return bounded page and cell responses. Preserve size and ZIP budgets, workbook formatting, owner-safe cancellation and cleanup on close, replacement, layout switch and direct hiding. Retain upstream PDF tools; active-sheet selection remains separate.

Co-Authored-By: Claude Code <noreply@anthropic.com>
Keep selection and picking on existing SVG/tree nodes, cache axis and lane geometry, and commit precise layout once after zoom gestures. Preserve independent complete snapshots, preview-home bounds, inverse-scaled pick marks and deterministic resource disposal.

Co-Authored-By: Claude Code <noreply@anthropic.com>
Use Node CDP and synthetic loopback-only APIs to exercise production app, real same-origin workbook workers and lineage views. Cover paging, nested permissions and late failures, cancellation, cache reuse, gesture commits, snapshots and disposal without touching gateway configuration or sending model traffic.

Co-Authored-By: Claude Code <noreply@anthropic.com>
@github-actions

Copy link
Copy Markdown

PR 安全初筛 / Safety pre-check

改动 34 个文件;高 3 项、中 14 项。

档 文件 行 为什么要看
高 gateway/web/office/sheet-model.js 第三方代码(应与上游发布逐字节一致)
高 gateway/web/office/sheet-worker.js 第三方代码(应与上游发布逐字节一致)
高 scripts/test-frontend-perf.mjs 构建 / 发版 / 签名脚本
中 gateway/tests/file-term-budget.test.mjs 37, 164 动态执行代码
中 gateway/tests/fixtures/frontend-perf-server.mjs 39 动态执行代码
中 gateway/tests/fixtures/office-worker-node.mjs 10, 14 动态执行代码
中 gateway/tests/lineage-render-budget.test.mjs 22, 44, 53, 75, 96, 141 … 动态执行代码
中 gateway/tests/lineage-zoom-boundaries.test.mjs 26, 71 动态执行代码
中 gateway/tests/markdown-highlight-budget.test.mjs 35 动态执行代码
中 gateway/tests/office-worker-lifecycle.test.mjs 28, 95 动态执行代码
中 gateway/tests/office-worker-model.test.mjs 13, 14 动态执行代码
中 gateway/tests/office-worker-owner-exit.test.mjs 35 动态执行代码
中 gateway/tests/poll-render-state.test.mjs 53, 119 动态执行代码
中 gateway/tests/sessions-render-budget.test.mjs 68 动态执行代码
中 gateway/tests/tool-group-render-budget.test.mjs 155 动态执行代码
中 scripts/test-frontend-perf.mjs 8 起子进程
中 scripts/test-frontend-perf.mjs 41, 74, 75, 77, 78, 112 … 动态执行代码

「高」不等于有问题,只是这些地方一旦被动手脚,后果最重(能拿到签名钥匙、改到用户手机上的权限、或藏进看不见的内容),合并前请逐行看过。

greyoak111 pushed a commit that referenced this pull request Nov 18, 2026
单元测试(8 项):markdown 高亮预算改 innerHTML/.hl 断言;工具组分页
双向遍历 400/760 条;office 成功路径走通 load→分页→单元格详情并断言
ArrayBuffer 已 detach、transfer 真转移、onmessageerror 释放会话、vwTake
入口释放;组件 reindex/toggle 按钮点击验证失效与单次重绘;worker 循环
加超时与兜底 terminate;新增 chat-drop-cards 测试直接跑生产 dropCards。

Chromium 验收(scripts/test-frontend-perf.mjs + fixture):
- 服务端 held 队列让「关闭取消下载」「迟到响应」成为真竞态,abort 由
  服务器观察到才断言;agentReplies 等「响应真的发完」,全部固定 sleep
  换成可观测信号的 until / 页面内 __waitFor
- office 脚本 no-store + officeScripts 计数:Worker 三个脚本全部送达才
  允许 terminate,消除脚本加载中被截断的 NetworkError 竞态
- 白名单 defaults 补全(含启动后台只读探测与 /api/ui),最终检查断言
  无白名单外 /api 调用、无 /api/chat、无写请求
- 地图区 sleep 换 __waitFor;repeat 用例等 Worker postMessage(load) 再关

同批发现并修复:map.js drawNow 的 insertBefore 引用节点错误(首次打开
脉络图必崩,见上一提交);replay-flush-179 的 vm context 补
trackChatBlock/CHAT_BLOCKS 桩;验收的最终白名单检查改用
state.requests + isAllowed。

验证:node scripts/test.mjs 全量 1747 通过 0 失败;Chromium 验收 44 项
全过(含 100/1000 会话地图 22 项、Excel Worker 9 项)。

Co-Authored-By: Claude Code <noreply@anthropic.com>
@greyoak111
greyoak111 merged commit 6a0cac9 into greyoak111:main Nov 18, 2026
2 of 3 checks passed

This branch was successfully deployed

1 active deployment
apk-ci — d7bd3457 Deployed Nov 18, 2026 by chenshi723 via build #263
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants