Endoleap/PERFORMANCE.md

画布打开与空闲性能检查（2026-11-06）

本次证据

用户提供的开发日志中，画布页面路由多数约 20ms；物料元数据读取约 200–1,646ms，完整画布 GET 出现 190ms、2.4s、5.1s、11.4s 等样本，PATCH 约 1.4–4.1s。路由渲染与远程数据读取是两个阶段，不能以路由 200 很快判断画布已经可用。

日志只有 Next application-code 总时间，包含代理请求上游、响应体传输及 JSON 处理，不能据此断言是数据库 SQL 或本机渲染卡顿。既有鉴权令牌没有读取，本轮没有对用户线上画布做测试写入或生成。

本次修改

• 画布编辑器改为独立动态模块，路由客户端先启动元数据/快照读取，同时加载编辑器代码。元数据和快照继续并行读取，不引入第二段等待。
• 成功的 Canvas GET 在同源代理直接流式转发，不在 Next 中先缓冲完整 JSON，再解析并重新编码。ETag、schema、HttpOnly 会话续期和 no-store 保留；登录兑换响应仍按原逻辑移除凭证。
• Canvas 流式响应的 Server-Timing 分别报告上游响应头等待和代理准备时间。它们不包含后续完整响应体传输时间，不把 proxy_headers 当作整个请求完成时间。
• 空闲 AI 任务发现改为每 30 秒；有任务或尚待合并结果时每 1.2 秒轮询。发起生成、取消、应用结果会立即唤醒；隐藏标签页暂停网络查询，切回立即检查。
• 没有新事件/状态时不再替换 runs/activeEdges 状态，避免空闲轮询反复触发画布渲染。
• 侧栏请求 include_subgraphs=true 并完成分页，以 parent_board_id 建立可展开目录。它读取物料摘要，不下载每个子画布快照。创建、解散和撤销关系变更后刷新目录。

验证方法与边界

• 单元测试覆盖子图分页、层级、缺失父项、循环防护、搜索路径、当前子图祖先，以及元数据/快照同时开始读取。
• DOM 回归使用实际目录组件和 AI hook，验证展开/收起、当前路径、空闲 30 秒调度、空响应无重渲染、隐藏暂停及可见恢复；保留原有生成、取消、跨图连线和事务回归。
• API 冒烟让模拟上游发送快照开头后暂停，在收到代理首段后才释放剩余响应，以证明代理没有等待完整 JSON；同时检查版本、schema 和会话续期。
• 生产构建在临时副本进行，不改动当前开发服务器产物。最终执行结果记录于 VALIDATION.md。

本轮没有真实登录会话的公网前后对照，也没有浏览器视觉/手感验收，因此不能给出“线上打开从 11.4 秒降至某个时间”的结论。若更新后仍等待数秒，应结合 Network 中 Server-Timing 的 upstream 值、响应体下载时间和体积进一步追踪公网链路/后端；前端减少重复工作不等于消除了上游延迟。