dev
main
dev → main,11 笔提交(acb6b673 → 9ea8d5f4),对应已 rebase 合并的 #32。
acb6b673
9ea8d5f4
PageTransition
AnimatePresence mode="wait"
exit
opacity:0
key={pathname}
duration-500
--transition-hover
图片都有 alt 属性
alt=""
.gitignore
docs/lessons-learned.md
97a3c1bd
npm run type-check
type-check:e2e
npm run lint
npm run test:unit
--workers=1
这批代码已先于合并发布到生产(2026-10-20 14:05,镜像 sha256:87ca390d44bb…, BUILD_ID=KO7S41-qvKY89xp5Kczbl,备份锚点见 #32 描述)。本 PR 的作用是把 main 对齐到线上实际在跑的源码,不触发新的部署动作(runbook 已记:合 main 不触发部署)。
sha256:87ca390d44bb…
BUILD_ID=KO7S41-qvKY89xp5Kczbl
ScrollReveal
npm run test
npm run test:e2e:prod
本分支交付 2026-10-20 首页影像版式与「名 + 号」字标,并修复当日生产暴露的全站站内跳转白屏:
motion.div
mounted
template
e2e/client-navigation-visibility.spec.ts
whileInView
关闭:N/A —— 来源为 2026-10-20 生产白屏缺陷反馈与首页改版验收,无协作平台 Issue。 证据:docs/acceptance/2026-10-20-home-multiplatform/README.md、 docs/acceptance/2026-10-20-axe/、docs/development/deploy-runbook.md §3.4。
docs/acceptance/2026-10-20-home-multiplatform/README.md
docs/acceptance/2026-10-20-axe/
docs/development/deploy-runbook.md
硬性门禁:bash scripts/check-pr-checklist.sh /tmp/pr32-body.md 已通过(模板三节完整、全部子项已勾选)。
bash scripts/check-pr-checklist.sh /tmp/pr32-body.md
/about
/products
/methodology
/insights
/about/brand
db:seed
ease-ink [0.22, 1, 0.36, 1]
#C41E3A
console.log
TODO
FIXME
.only()
git diff
npm run test:e2e:fast
playwright test visual-regression.spec.ts --update-snapshots=none
npm run test:coverage
test:functional
npm run check:a11y
npm run lighthouse
npm run test:security:headers
skip
todo
origin/*
origin/dev
git ls-remote
已先于合并发布到生产(用户授权):
2f86c441
dist_backup_20261020_140513
public_backup_20261020_140513
nginx-static-production.conf.bak.20261020_142648
warm-routes
unsafe-eval
npm run test:integration:real
b125d16a
duration-hover
globals.css:287
--transition-hover: 150ms
tailwind.config.js:215
3f11d7ee
≤2
npm run check:axe
a9fff488
hero-architecture.webp
_*
npm run type-check:e2e
-f json
no-console
react-hooks/set-state-in-effect
no-img-element
no-explicit-any
no-sync-scripts
no-html-link-for-pages
home-content-v16.tsx
p2-functional-e2e.spec.ts
3fabb77c
visual-regression.spec.ts --update-snapshots=none
默认并行(4 workers)跑 visual-regression.spec.ts:121 passed / 4 failed / EXIT=1, 且失败集合在两次运行之间漂移——第一次为 chromium-tablet(/brand、/team) + chromium-mobile(/brand) + webkit(/team),第二次 chromium-tablet 两例转为通过、 红位改落到 chromium-mobile 与 webkit 各两例。⇒ 不是内容漂移,也不是像素容差。
visual-regression.spec.ts
chromium-tablet
chromium-mobile
webkit
逐张比对 actual/expected 定位到机理:差异集中在长页中部约 1.4k px 的一条带内, 带内 actual 是空白(/team 的「团队文化」整段停在 opacity:0),expected 是已显影正文。 即 waitForPageStable 的逐屏滚动(visual-regression.spec.ts:54-59,步长 dwell 120ms) 在 4 worker CPU 争用下没能把 whileInView 提交完——正是该 helper 注释里已经写明的失效模式, 只是 dwell 取值在并行下不够。同一批用例 --workers=1 重跑:10 passed / 0 failed / EXIT=0。
/team
waitForPageStable
visual-regression.spec.ts:54-59
据此更正本文上一版「125 passed / 0 failed」的口径:那一次是在并行下偶然取到的读数, 不足以作为该门禁的可复现证据;本批的视觉层结论以「红位四例串行全绿 + 本批未碰这两个页面任何文件」为准;全量串行复跑仍在后台进行,其结论不改变上面这条归因。
建议的收口(独立动作,不在本 PR 夹带):把逐屏滚动的 dwell 提到 ≥250ms 并在每步 排空一帧(requestAnimationFrame),或给 ScrollReveal 加一个「已显影」可查询标记供用例 等待——该组件目前不暴露任何钩子(src/components/ui/scroll-reveal.tsx:80-96 只透传 className),所以「等显影计数归零」这条现在写不出来。同时把视觉门禁的默认执行口径钉成 --workers=1;否则 test:all 里这一层是可红可绿的。
requestAnimationFrame
src/components/ui/scroll-reveal.tsx:80-96
className
test:all
- 首页按咨询机构影像版式重排,保留原站文案与“洞察→行业→能力”段序 - 导航/页脚/品牌页换用上下锁定字标,alt 维持法定主体名 - 修复 reduce 下 PageTransition 祖先 opacity 停留导致的白屏 - 4 浏览器 × 9 宽度多端复核,axe 0 violation - 视觉基线 106 张更新并只读复跑 125/125
- 记录 acb6b673 发布、镜像/备份锚点与 14 路由 200 - 补线上多端探针 report-production 与 prod 截图 - 探针先 eager 加载再滚屏,避免把懒加载未触发误报成破图
现象:生产环境所有站内跳转白屏,地址与标题已切换,刷新才恢复。 根因:AnimatePresence mode="wait" 要求新页等旧页退场完成才挂载;App Router 导航期间的重复渲染会重置退场完成标记,切换 state 的窗口被错过, motion.div 永久停在 exit 变体(opacity:0; translateY(-8px))。 修法:路由内容只保留 key={pathname} 的 280ms 入场;首屏仍由 mounted 渲染 裸 children;reduce 变体改为显式可见终值,避免切到空变体时冻结在半透明。 守卫:新增 client-navigation-visibility(导航后落定再读祖先链乘积); 首屏用例改逐帧采样;视觉用例改逐屏滚动触发 whileInView。 验证:E2E 20/20(四浏览器)、视觉 125/125、单测 1815、type-check/lint 0 error。
三处场间位移把 500ms 硬编码在 class 上(`duration-500`),与 CONTEXT.md 动效四原则里 hover 那一档 150ms 冲突。仓库已有令牌:globals.css:287 定义 `--transition-hover: 150ms`,tailwind.config.js:215 把它映射到 transitionDuration.hover ⇒ 改用 `duration-hover`,不再新增数值。
旧实现把 `alt=""` 也计成「没有 alt」(getAttribute 返回空串即 falsy),再用 `toBeLessThanOrEqual(2)` 放行——首页影像版式落地后装饰图有十几张,这条用例 于是同时做两件错事:误报正确写法的装饰图,又给真正漏标的 <img> 留了 2 张额度。 现判据只覆盖机械可判的那一维:既无 alt 属性、又未用 aria-hidden/role 声明装饰性 的图片一律判红,额度 0。「信息图的 alt 语义是否正确」不在本用例的能力范围内, 由全站 axe 节点计数(npm run check:axe)承担。 4 project(chromium / chromium-mobile / firefox / webkit)首页用例全绿。
2000×797(125,310B)→ 1920×765(117,722B)。1920 是 2026-10-20 多端验收实测的 最宽视口(docs/acceptance/2026-10-20-home-multiplatform/report-production.json 的 desktop-1920),源图不再超出被测宽度一档。 视觉层复核:改图后 `visual-regression.spec.ts` 只读比对,home-fullpage 在 5 个 project 全部仍与基线一致 ⇒ 该降档在测试视口下无像素外溢。
工作树长期挂着 271 个未跟踪文件,其中 64MB 是 logo 目录里 `_*` 前缀的中间图与 试算脚本、45MB 是字体源,把 `git status` 变成噪音源。本轮: - 删:根目录 3 个线上探针 `.tmp-*.mjs`、logo 目录 130 个 `_*` 中间件(64MB)、 stray-landing-backup 内的未跟踪副本。 - 忽略不删:同名 `.py` 逐刀重生成的评审 HTML(85 个)、fonts/ 字体源、 landing/apply.sh 自建的还原点、assets-delivery 与 landing 的 png/ico 交付副本、 company-deck/(PPTX 走网盘)、历史 PR 描述稿 `.pr-seal-*.md`。 还原点按扩展名精确忽略而非目录级屏蔽:backup-*/ 里已入库的 svg 半份不能被 标成 ignored,否则「已跟踪却被屏蔽」会让后续 `git add` 静默失效。
只读比对在 4 worker 下给出 121 passed / 4 failed,原样重跑红位换了一批 (chromium-tablet 两例转绿),同一批用例 --workers=1 重跑 10/10 通过。逐行差分 显示差异只在长页中部一条带内、带内 actual 是空白 ⇒ 内容停在 opacity:0, 即 waitForPageStable 的 120ms dwell 在 CPU 争用下没能把 whileInView 提交完。 同时更正 §5.50 末尾「视觉全量 125/125」的口径:那是并行下偶然取到的一次读数, 不能当可复现证据。
合并后补测(2026-10-20 22:20–22:35)——本 PR 描述里「视觉层」那条读数需要更正,已由 #56 落进 docs/lessons-learned.md §5.51:
L2 主题切换 › 浅色主题 - 首页视觉
visual-chromium-tablet
--repeat-each=3
src/app/(marketing)/page.tsx:60
getHomePageCopy().catch(() => null)
本 PR 的产品结论不变(type-check / lint / 单元 / alt 用例的读数都独立于视觉层);被更正的是「125/125」这一条门禁口径。
No dependencies set.
The note is not visible to the blocked user.
发布:首页影像版式与「名 + 号」字标落库(PR #32 全量)
dev→main,11 笔提交(acb6b673→9ea8d5f4),对应已 rebase 合并的 #32。这一批进 main 的内容
PageTransition的AnimatePresence mode="wait"+exit在 App Router 重复渲染下永远等不到退场完成 ⇒ 新页不挂载、内容停在opacity:0。改为只保留key={pathname}的 280ms 入场duration-500硬编码改用--transition-hover(150ms)令牌图片都有 alt 属性判据修正:不再把alt=""误报成漏标,同时取消「允许 2 张」兜底额度.gitignore(工作树未跟踪由 271 归零)docs/lessons-learned.md§5.51(视觉门禁并行竞态)、发布与 nginx 对齐记录门禁读数(提交树
97a3c1bd,9ea8d5f4仅追加文档)npm run type-check/type-check:e2enpm run lintnpm run test:unit图片都有 alt 属性(4 project)--workers=1复跑 10 passed / 0 failed ⇒ 归因为装配竞态,详见 §5.51与线上的一致性
这批代码已先于合并发布到生产(2026-10-20 14:05,镜像
sha256:87ca390d44bb…,BUILD_ID=KO7S41-qvKY89xp5Kczbl,备份锚点见 #32 描述)。本 PR 的作用是把main对齐到线上实际在跑的源码,不触发新的部署动作(runbook 已记:合 main 不触发部署)。
未闭环项(不洗成通过)
ScrollReveal加显影标记)是独立动作,未随本批落地。
npm run test(默认 dev target)下 16 个 GA4 用例仍按既有设计 skip,真实断言只在npm run test:e2e:prod口径里;本批未改这一层。变更摘要
本分支交付 2026-10-20 首页影像版式与「名 + 号」字标,并修复当日生产暴露的全站站内跳转白屏:
accordion、全幅 CTA),保留原站文案与「洞察→行业→能力」段序。
PageTransition的AnimatePresence mode="wait"+exit在 Next App Router导航的重复渲染下永远等不到退场完成,新页不挂载、
motion.div永久停在opacity:0。改为只保留
key={pathname}的 280ms 入场;首屏仍由mounted渲染裸 children。PageTransition/ 营销template冻结修复(空变体改为显式可见终值)。e2e/client-navigation-visibility.spec.ts(导航落定后读祖先链 opacity 乘积);首屏用例改逐帧采样;视觉用例改逐屏滚动触发
whileInView。关联 Issue
关闭:N/A —— 来源为 2026-10-20 生产白屏缺陷反馈与首页改版验收,无协作平台 Issue。
证据:
docs/acceptance/2026-10-20-home-multiplatform/README.md、docs/acceptance/2026-10-20-axe/、docs/development/deploy-runbook.md§3.4。提交前检查
全链路检查
npm run type-check通过(0 error)— 源码与type-check:e2e均 EXIT=0npm run lint通过 — 0 error / 84 warning,与本次改动前基线同数,无新增告警/about/products/methodology/insights/about/brand,全部真实路由且线上 200db:seedaxe 8 次 0 violation;本轮修复后再跑线上三浏览器 15/15、iPhone 14 5/5
ease-ink [0.22, 1, 0.36, 1]、stagger 60ms,无 >700ms 入场#C41E3A触达 — 每页 ≥ 3 处、面积 ≤ 10%(沿用已验收的字标与页面配色)console.log/TODO/FIXME/.only()—git diff与 lint 均未命中测试分层检查(L0–L3)
PageTransition/ 营销template的过渡行为,无新增组件分支;行为由新增 E2E 覆盖
npm run test:e2e:fast:59 passed / 25 skipped(GA4 在 dev 下按既有设计跳过)/ EXIT=0;新增导航用例四浏览器 20/20(含首屏与 reduce 两组)
playwright test visual-regression.spec.ts --update-snapshots=none:125 passed / 0 failed / 0 张重写(5 project,4.3m);未盲更新基线
首屏用例要求「交接前采样 > 0」否则用例自身失败
.only()/ 跳过态残留 — GA4 环境性 skip 为既有设计,非本次新增质量门禁
npm run test:unit— 149 套件 / 1815 例全部通过npm run test:coverage— EXIT=0,149 套 / 1815 例;global stmts 89.56 / branch 88.28 / funcs 88.18 / lines 89.56(阈值未下调)npm run test(functional + visual)—test:functional1088 passed / 44 skipped / EXIT=0(4 project,13.6m);视觉 125/125 已只读复跑npm run check:a11y(contrast + headings + brand-token)— 11/11 页面通过、0 违规;contrast / headings / brand-token 全通过npm run lighthouse— 11 URL × 3 次 = 33 次运行,全部断言通过(EXIT=0)npm run test:security:headers— 线上 8/8 通过、0 警告(nginx 配置对齐后复测)docs/lessons-learned.md§5.50(机理与判据)、docs/development/deploy-runbook.md§3.4(发布/nginx/磁盘记录)、docs/acceptance/2026-10-20-home-multiplatform/README.md清理均在用户「继续完成待办」授权范围内执行;备份锚点见下
假绿灯纪律
skip/todo/ 下调阈值让门禁变绿 — 首屏用例由单点改为逐帧(更严格);视觉与 reduce 用例的滚动方式修正为真实用户路径,判据未放宽
探针自设条件,已记录机理后修正探针,未改产品以迁就探针
origin/*与实测为准 —origin/dev为 HEAD 祖先(0/6),无需 rebase;分支 tip 以
git ls-remote对账;线上结论以生产响应与浏览器实测为准其他说明
已先于合并发布到生产(用户授权):
2f86c441;镜像sha256:87ca390d44bb…;BUILD_ID=KO7S41-qvKY89xp5Kczbldist_backup_20261020_140513/public_backup_20261020_140513/nginx-static-production.conf.bak.20261020_142648warm-routes30 路由非 200=0;容器日志 error=0;站内跳转三浏览器 15/15、移动端 5/5;安全头单值化(XFO=DENY、CSP 无
unsafe-eval)实测门禁输出(回填)
npm run type-check/type-check:e2enpm run lintnpm run test:unitnpm run test:coveragenpm run test:integration:realnpm run test:e2e:fastplaywright test visual-regression.spec.ts --update-snapshots=nonenpm run test:security:headers(线上)npm run lighthouse追加:2026-10-20 收尾五笔(
b125d16a→9ea8d5f4)b125d16afix(motion)duration-500),改用duration-hover(globals.css:287的--transition-hover: 150ms,tailwind.config.js:215已映射),对齐动效四原则的 hover 档3f11d7eetest(a11y)图片都有 alt 属性判据修正:旧实现把alt=""(装饰图的正确写法)也计成「没有 alt」,再用≤2兜底 ⇒ 一边误报装饰图、一边给真漏标留 2 张额度。现只判「既无 alt 属性、又未用 aria-hidden/role 声明装饰性」,额度 0;alt 的语义正确性交给npm run check:axea9fff488chore(assets)hero-architecture.webp2000×797 → 1920×765(125,310B → 117,722B,-6.1%),收到验收实测最宽视口那一档97a3c1bdchore(repo)_*中间件 64MB + stray 还原点副本),交付物本地件(评审 HTML 85 个、fonts/ 43MB、还原点、company-deck、历史 PR 稿)写进.gitignore;工作树未跟踪由 271 归零9ea8d5f4docs(lessons)docs/lessons-learned.md§5.51 记录下面那条并行竞态,并更正 §5.50 末尾「视觉全量 125/125」的口径本轮实测读数(提交树
97a3c1bd;9ea8d5f4仅追加文档,读数不变)npm run type-check/npm run type-check:e2enpm run lint(-f json逐条计数)no-console+ 14react-hooks/set-state-in-effect+ 8no-img-element+ 4no-explicit-any+ 1no-sync-scripts+ 1no-html-link-for-pages= 84,分项自洽。本批两个被改文件(home-content-v16.tsx、p2-functional-e2e.spec.ts)单独 lint 各贡献 0 条 ⇒ 计数与3fabb77c同数,无新增npm run test:unit图片都有 alt 属性(4 project)visual-regression.spec.ts --update-snapshots=none--workers=1复跑 10 passed / 0 failed / EXIT=0;全量--workers=1见下节结论⚠ 视觉门禁的并行竞态(本轮实测新发现,非本批引入)
默认并行(4 workers)跑
visual-regression.spec.ts:121 passed / 4 failed / EXIT=1,且失败集合在两次运行之间漂移——第一次为
chromium-tablet(/brand、/team) +chromium-mobile(/brand) +webkit(/team),第二次chromium-tablet两例转为通过、红位改落到
chromium-mobile与webkit各两例。⇒ 不是内容漂移,也不是像素容差。逐张比对 actual/expected 定位到机理:差异集中在长页中部约 1.4k px 的一条带内,
带内 actual 是空白(
/team的「团队文化」整段停在opacity:0),expected 是已显影正文。即
waitForPageStable的逐屏滚动(visual-regression.spec.ts:54-59,步长 dwell 120ms)在 4 worker CPU 争用下没能把
whileInView提交完——正是该 helper 注释里已经写明的失效模式,只是 dwell 取值在并行下不够。同一批用例
--workers=1重跑:10 passed / 0 failed / EXIT=0。据此更正本文上一版「125 passed / 0 failed」的口径:那一次是在并行下偶然取到的读数,
不足以作为该门禁的可复现证据;本批的视觉层结论以「红位四例串行全绿 + 本批未碰这两个页面任何文件」为准;全量串行复跑仍在后台进行,其结论不改变上面这条归因。
建议的收口(独立动作,不在本 PR 夹带):把逐屏滚动的 dwell 提到 ≥250ms 并在每步
排空一帧(
requestAnimationFrame),或给ScrollReveal加一个「已显影」可查询标记供用例等待——该组件目前不暴露任何钩子(
src/components/ui/scroll-reveal.tsx:80-96只透传className),所以「等显影计数归零」这条现在写不出来。同时把视觉门禁的默认执行口径钉成--workers=1;否则test:all里这一层是可红可绿的。现象:生产环境所有站内跳转白屏,地址与标题已切换,刷新才恢复。 根因:AnimatePresence mode="wait" 要求新页等旧页退场完成才挂载;App Router 导航期间的重复渲染会重置退场完成标记,切换 state 的窗口被错过, motion.div 永久停在 exit 变体(opacity:0; translateY(-8px))。 修法:路由内容只保留 key={pathname} 的 280ms 入场;首屏仍由 mounted 渲染 裸 children;reduce 变体改为显式可见终值,避免切到空变体时冻结在半透明。 守卫:新增 client-navigation-visibility(导航后落定再读祖先链乘积); 首屏用例改逐帧采样;视觉用例改逐屏滚动触发 whileInView。 验证:E2E 20/20(四浏览器)、视觉 125/125、单测 1815、type-check/lint 0 error。合并后补测(2026-10-20 22:20–22:35)——本 PR 描述里「视觉层」那条读数需要更正,已由 #56 落进
docs/lessons-learned.md§5.51:9ea8d5f4)全量--workers=1复跑:visual-regression.spec.ts= 124 passed / 1 failed,不是「串行即全绿」。L2 主题切换 › 浅色主题 - 首页视觉@visual-chromium-tablet;在同一棵树上--repeat-each=3隔离复跑 3 passed,在改动前的3fabb77c上单跑也 passed ⇒ 负载相关的间歇红,与本批五笔提交无因果。waitForPageStable的 120ms dwell 竞态(/team、/about/brand那四条);不等高(actual 矮 3114px)+ 整段换成另一套版式 =src/app/(marketing)/page.tsx:60的getHomePageCopy().catch(() => null)在负载下退化,页面照常 200 但内容回落成常量版式。本 PR 的产品结论不变(type-check / lint / 单元 / alt 用例的读数都独立于视觉层);被更正的是「125/125」这一条门禁口径。