用途:在首次站点改动前,为 TYPO3 14.3 全站升级图构建并封存确定性的变更前基线 Baseline A。每个节点从 t3u node-brief --node <id> 开始,该命令携带契约、路由与预算。
主要能力:包含 deterministic-baseline(工作流步骤 1–7,仅在确定性循环为绿且 A-original 封存后通过)、determinism-recovery(用 ADR 支持的适配器稳定观测到的非确定性形态)、harness-recovery(修复测量工具,如崩溃、二进制、浏览器/会话设置,而非站点)、session-recovery(处理导致证明比较不同状态的同意/会话问题)。测量节点可依据 ADR 重新校准 config/ 与自检;变更守卫仍拒绝编辑基线封条、URL 清单或功能计划。
使用方式:输入为节点简报,写出证据文件并返回一个允许的结果,不得运行 node-open/node-close 或编辑运行状态。证据保持精简(约 120 行证明,早期产物按路径与哈希引用,一个探针产物),在简报预测时间(15 分钟或以内)或其两倍时停止,返回已证明内容与未决问题。
前置条件:接收身份与已接受数据集证据为绿;捕获前未发生站点/配置/依赖修复;宿主渲染器与 DDEV 应用环境通过 t3u doctor;本地站点渲染生产资源构建,DOM 中无 /@vite/client 或其他开发服务器 URL。
工作流:封存环境与源编辑/文件指纹;发现所有站点/语言 URL(站点地图缺失或损坏时先记录 ADR 并使用批准的页面树/爬取回退,命名未覆盖的动态路由);构建封存清单(HTTP/DOM 全部 URL、分层视觉样本、模板簇、黄金路径、确定性种子、视口、权威状态、覆盖排除);清点组件并编写代表性旅程(同意、滑块/轮播、导航/下拉/手风琴/模态、搜索、表单、登录/重置/404/媒体/语言及项目特定高价值交互);稳定时钟/随机性/动画、字体、图像解码、懒加载内容、滚动条、同意、视频与两个稳定布局帧;运行种子诊断,然后进行一次未变更的穷举双重捕获,要求 HTTP、DOM 与像素差异为零;将第二次穷举通过封存为 A-original(含清单/校验和/锁),不可解封。
失败路由:invalid 返回对应身份节点;harness-error 修复工具后仅重复受影响证明;未变更渲染非零按失败形态做确定性恢复,绝不修复站点;缺少组件清单或代表性旅程则基线保持开放。不得提高容差、缩小样本、隔离页面、复用操作员浏览器或编辑站点使自检通过。
输出:不可变 baseline/A-original/、封存清单/指纹/自检锁、交互清单、覆盖缺口、确切命令与退出码,以及图节点的绿色有界证据循环。
边界:源/项目决策使用 typo3-upgrade-intake,目标比较使用 typo3-upgrade-closure;此处不现代化 Vite、Bootstrap、标记、无障碍或安全。