feat(brand): 首页影像版式与名+号字标;修复站内跳转白屏 #32

Merged
zhangxiang merged 12 commits from feat/brand-wordmark-landing into dev 2026-10-20 22:14:20 +08:00
Owner

变更摘要

本分支交付 2026-10-20 首页影像版式与「名 + 号」字标,并修复当日生产暴露的全站站内跳转白屏:

  • 首页按咨询机构影像版式重排(hero 黑底面板 + 叠图、新闻大图卡、行业影像网格、能力左图右
    accordion、全幅 CTA),保留原站文案与「洞察→行业→能力」段序。
  • 导航 / 页脚 / 品牌页换用上下锁定字标;favicon 全套同步;106 张视觉基线重写并逐张抽查。
  • 站内跳转白屏修复:PageTransition 的 AnimatePresence mode="wait" + exit 在 Next App Router
    导航的重复渲染下永远等不到退场完成,新页不挂载、motion.div 永久停在 opacity:0。
    改为只保留 key={pathname} 的 280ms 入场;首屏仍由 mounted 渲染裸 children。
  • reduce 动效下 PageTransition / 营销 template 冻结修复(空变体改为显式可见终值)。
  • 守卫:新增 e2e/client-navigation-visibility.spec.ts(导航落定后读祖先链 opacity 乘积);
    首屏用例改逐帧采样;视觉用例改逐屏滚动触发 whileInView。
  • 运维:发布记录、线上 nginx 配置与仓库对齐(消除重复安全头)、发布产物验证。

关联 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。

提交前检查

硬性门禁:bash scripts/check-pr-checklist.sh /tmp/pr32-body.md 已通过(模板三节完整、全部子项已勾选)。

全链路检查

  • npm run type-check 通过(0 error)— 源码与 type-check:e2e 均 EXIT=0
  • npm run lint 通过 — 0 error / 84 warning,与本次改动前基线同数,无新增告警
  • 路由/链接真实 — 本次改动未新增 href;导航用例覆盖 /about /products /methodology
    /insights /about/brand,全部真实路由且线上 200
  • 涉及 CMS 内容模型 — N/A:本批不改内容模型与 seed,无需 db:seed
  • 视觉/交互改动 — 已在 production standalone 产物与线上复核;4 浏览器 × 9 宽度探针 15/15、
    axe 8 次 0 violation;本轮修复后再跑线上三浏览器 15/15、iPhone 14 5/5
  • 暗黑模式 — N/A:本批未新增颜色/主题样式(仅动效与过渡)
  • 动效合规 — 入场 280ms、ease-ink [0.22, 1, 0.36, 1]、stagger 60ms,无 >700ms 入场
  • 品牌红 #C41E3A 触达 — 每页 ≥ 3 处、面积 ≤ 10%(沿用已验收的字标与页面配色)
  • 数字与宣称口径 — N/A:本批未改结果型数字与宣称
  • 无遗留 console.log / TODO / FIXME / .only() — git diff 与 lint 均未命中

测试分层检查(L0–L3)

  • L0 单元 — 149 套件 / 1815 例通过(本批无新增工具函数;既有用例全绿)
  • L1 组件 — 本批只改 PageTransition / 营销 template 的过渡行为,无新增组件分支;
    行为由新增 E2E 覆盖
  • L2 E2E — npm run test:e2e:fast:59 passed / 25 skipped(GA4 在 dev 下按既有设计跳过)
    / EXIT=0;新增导航用例四浏览器 20/20(含首屏与 reduce 两组)
  • L3 视觉回归 — playwright test visual-regression.spec.ts --update-snapshots=none:
    125 passed / 0 failed / 0 张重写(5 project,4.3m);未盲更新基线
  • 新增机械守卫带正控制 — 导航用例先在旧实现上转红(有效 opacity 恒 0),修复后转绿;
    首屏用例要求「交接前采样 > 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:functional 1088 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
  • 提交信息符合 Conventional Commits — 6 个提交均为可独立评审的垂直切片
  • 破坏性/共享状态动作已单独授权 — 生产发布(2026-10-20 14:05)、nginx reload 与悬空镜像
    清理均在用户「继续完成待办」授权范围内执行;备份锚点见下

假绿灯纪律

  • 门禁命令实际执行并记录真实输出 — 见「实测门禁输出」表;失败口径如实记录
  • 未通过删测试 / 放宽断言 / skip / todo / 下调阈值让门禁变绿 — 首屏用例由单点改为
    逐帧(更严格);视觉与 reduce 用例的滚动方式修正为真实用户路径,判据未放宽
  • 未把误报当问题「修掉」 — 视觉「跳底漏掉中间屏」与 reduce「瞬时跳转跳过目标」均判定为
    探针自设条件,已记录机理后修正探针,未改产品以迁就探针
  • 结论以 origin/* 与实测为准 — origin/dev 为 HEAD 祖先(0/6),无需 rebase;
    分支 tip 以 git ls-remote 对账;线上结论以生产响应与浏览器实测为准
  • UI 改动已人工复核关键与边界态 — 线上三浏览器 15/15、移动端 5/5;未验证项:无

其他说明

已先于合并发布到生产(用户授权):

  • 提交 2f86c441;镜像 sha256:87ca390d44bb…;BUILD_ID=KO7S41-qvKY89xp5Kczbl
  • 备份:dist_backup_20261020_140513 / public_backup_20261020_140513 /
    nginx-static-production.conf.bak.20261020_142648
  • 线上核对:9 条关键路由 200;warm-routes 30 路由非 200=0;容器日志 error=0;
    站内跳转三浏览器 15/15、移动端 5/5;安全头单值化(XFO=DENY、CSP 无 unsafe-eval)
  • 服务器悬空镜像回收 1.27GB,剩余 2.9G 可用(86%);dist 备份保留

实测门禁输出(回填)

命令 结果
npm run type-check / type-check:e2e EXIT=0 / 0 error
npm run lint 0 error / 84 warning(基线同数)
npm run test:unit 149 suites / 1815 tests
npm run test:coverage 149 suites / 1815 tests;global 89.56 / 88.28 / 88.18 / 89.56
npm run test:integration:real 4 suites / 23 tests 通过;teardown 守卫 3 个本地库 inode+size+mtime 未变
npm run test:e2e:fast 59 passed / 25 skipped / EXIT=0
动效/导航 E2E(production,4 project) 20/20 passed
playwright test visual-regression.spec.ts --update-snapshots=none 125 passed / 0 failed
npm run test:security:headers(线上) 8/8 PASS / 0 warning
npm run lighthouse 33 runs / 11 URL,全部断言通过(EXIT=0)

追加:2026-10-20 收尾五笔(b125d16a → 9ea8d5f4)

提交 内容
b125d16a fix(motion) 首页三处场间位移把 500ms 硬编码在 class 上(duration-500),改用 duration-hover(globals.css:287 的 --transition-hover: 150ms,tailwind.config.js:215 已映射),对齐动效四原则的 hover 档
3f11d7ee test(a11y) 图片都有 alt 属性 判据修正:旧实现把 alt=""(装饰图的正确写法)也计成「没有 alt」,再用 ≤2 兜底 ⇒ 一边误报装饰图、一边给真漏标留 2 张额度。现只判「既无 alt 属性、又未用 aria-hidden/role 声明装饰性」,额度 0;alt 的语义正确性交给 npm run check:axe
a9fff488 chore(assets) hero-architecture.webp 2000×797 → 1920×765(125,310B → 117,722B,-6.1%),收到验收实测最宽视口那一档
97a3c1bd chore(repo) 删 139 个临时件(根目录 3 个线上探针 + logo 目录 130 个 _* 中间件 64MB + stray 还原点副本),交付物本地件(评审 HTML 85 个、fonts/ 43MB、还原点、company-deck、历史 PR 稿)写进 .gitignore;工作树未跟踪由 271 归零
9ea8d5f4 docs(lessons) docs/lessons-learned.md §5.51 记录下面那条并行竞态,并更正 §5.50 末尾「视觉全量 125/125」的口径

本轮实测读数(提交树 97a3c1bd;9ea8d5f4 仅追加文档,读数不变)

命令 结果
npm run type-check / npm run type-check:e2e EXIT=0 / EXIT=0,0 error
npm run lint(-f json 逐条计数) 0 error / 84 warning:56 no-console + 14 react-hooks/set-state-in-effect + 8 no-img-element + 4 no-explicit-any + 1 no-sync-scripts + 1 no-html-link-for-pages = 84,分项自洽。本批两个被改文件(home-content-v16.tsx、p2-functional-e2e.spec.ts)单独 lint 各贡献 0 条 ⇒ 计数与 3fabb77c 同数,无新增
npm run test:unit 149 套件 / 1815 例全通过,EXIT=0
图片都有 alt 属性(4 project) 4 passed;改注释后复跑一次仍 4 passed
视觉只读比对 visual-regression.spec.ts --update-snapshots=none 并行(4 worker)121 passed / 4 failed;红位四例 --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 里这一层是可红可绿的。

## 变更摘要 本分支交付 2026-10-20 首页影像版式与「名 + 号」字标,并修复当日生产暴露的**全站站内跳转白屏**: - 首页按咨询机构影像版式重排(hero 黑底面板 + 叠图、新闻大图卡、行业影像网格、能力左图右 accordion、全幅 CTA),保留原站文案与「洞察→行业→能力」段序。 - 导航 / 页脚 / 品牌页换用上下锁定字标;favicon 全套同步;106 张视觉基线重写并逐张抽查。 - **站内跳转白屏修复**:`PageTransition` 的 `AnimatePresence mode="wait"` + `exit` 在 Next App Router 导航的重复渲染下永远等不到退场完成,新页不挂载、`motion.div` 永久停在 `opacity:0`。 改为只保留 `key={pathname}` 的 280ms 入场;首屏仍由 `mounted` 渲染裸 children。 - reduce 动效下 `PageTransition` / 营销 `template` 冻结修复(空变体改为显式可见终值)。 - 守卫:新增 `e2e/client-navigation-visibility.spec.ts`(导航落定后读祖先链 opacity 乘积); 首屏用例改逐帧采样;视觉用例改逐屏滚动触发 `whileInView`。 - 运维:发布记录、线上 nginx 配置与仓库对齐(消除重复安全头)、发布产物验证。 ## 关联 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。 ## 提交前检查 > 硬性门禁:`bash scripts/check-pr-checklist.sh /tmp/pr32-body.md` 已通过(模板三节完整、全部子项已勾选)。 ## 全链路检查 - [x] `npm run type-check` 通过(0 error)— 源码与 `type-check:e2e` 均 EXIT=0 - [x] `npm run lint` 通过 — 0 error / 84 warning,与本次改动前基线同数,无新增告警 - [x] 路由/链接真实 — 本次改动未新增 href;导航用例覆盖 `/about` `/products` `/methodology` `/insights` `/about/brand`,全部真实路由且线上 200 - [x] 涉及 CMS 内容模型 — N/A:本批不改内容模型与 seed,无需 `db:seed` - [x] 视觉/交互改动 — 已在 production standalone 产物与线上复核;4 浏览器 × 9 宽度探针 15/15、 axe 8 次 0 violation;本轮修复后再跑线上三浏览器 15/15、iPhone 14 5/5 - [x] 暗黑模式 — N/A:本批未新增颜色/主题样式(仅动效与过渡) - [x] 动效合规 — 入场 280ms、`ease-ink [0.22, 1, 0.36, 1]`、stagger 60ms,无 >700ms 入场 - [x] 品牌红 `#C41E3A` 触达 — 每页 ≥ 3 处、面积 ≤ 10%(沿用已验收的字标与页面配色) - [x] 数字与宣称口径 — N/A:本批未改结果型数字与宣称 - [x] 无遗留 `console.log` / `TODO` / `FIXME` / `.only()` — `git diff` 与 lint 均未命中 ## 测试分层检查(L0–L3) - [x] **L0 单元** — 149 套件 / 1815 例通过(本批无新增工具函数;既有用例全绿) - [x] **L1 组件** — 本批只改 `PageTransition` / 营销 `template` 的过渡行为,无新增组件分支; 行为由新增 E2E 覆盖 - [x] **L2 E2E** — `npm run test:e2e:fast`:59 passed / 25 skipped(GA4 在 dev 下按既有设计跳过) / EXIT=0;新增导航用例四浏览器 20/20(含首屏与 reduce 两组) - [x] **L3 视觉回归** — `playwright test visual-regression.spec.ts --update-snapshots=none`: **125 passed / 0 failed / 0 张重写**(5 project,4.3m);未盲更新基线 - [x] 新增机械守卫带**正控制** — 导航用例先在旧实现上转红(有效 opacity 恒 0),修复后转绿; 首屏用例要求「交接前采样 > 0」否则用例自身失败 - [x] 已运行相关测试并全绿,无 `.only()` / 跳过态残留 — GA4 环境性 skip 为既有设计,非本次新增 ## 质量门禁 - [x] `npm run test:unit` — 149 套件 / 1815 例全部通过 - [x] `npm run test:coverage` — EXIT=0,149 套 / 1815 例;global stmts 89.56 / branch 88.28 / funcs 88.18 / lines 89.56(阈值未下调) - [x] `npm run test`(functional + visual)— `test:functional` 1088 passed / 44 skipped / EXIT=0(4 project,13.6m);视觉 125/125 已只读复跑 - [x] `npm run check:a11y`(contrast + headings + brand-token)— 11/11 页面通过、0 违规;contrast / headings / brand-token 全通过 - [x] `npm run lighthouse` — 11 URL × 3 次 = 33 次运行,全部断言通过(EXIT=0) - [x] `npm run test:security:headers` — 线上 8/8 通过、0 警告(nginx 配置对齐后复测) - [x] 文档已同步 — `docs/lessons-learned.md` §5.50(机理与判据)、 `docs/development/deploy-runbook.md` §3.4(发布/nginx/磁盘记录)、 `docs/acceptance/2026-10-20-home-multiplatform/README.md` - [x] 提交信息符合 Conventional Commits — 6 个提交均为可独立评审的垂直切片 - [x] 破坏性/共享状态动作已单独授权 — 生产发布(2026-10-20 14:05)、nginx reload 与悬空镜像 清理均在用户「继续完成待办」授权范围内执行;备份锚点见下 ## 假绿灯纪律 - [x] 门禁命令实际执行并记录真实输出 — 见「实测门禁输出」表;失败口径如实记录 - [x] 未通过删测试 / 放宽断言 / `skip` / `todo` / 下调阈值让门禁变绿 — 首屏用例由单点改为 **逐帧**(更严格);视觉与 reduce 用例的滚动方式修正为真实用户路径,判据未放宽 - [x] 未把误报当问题「修掉」 — 视觉「跳底漏掉中间屏」与 reduce「瞬时跳转跳过目标」均判定为 探针自设条件,已记录机理后修正探针,未改产品以迁就探针 - [x] 结论以 `origin/*` 与实测为准 — `origin/dev` 为 HEAD 祖先(0/6),无需 rebase; 分支 tip 以 `git ls-remote` 对账;线上结论以生产响应与浏览器实测为准 - [x] UI 改动已人工复核关键与边界态 — 线上三浏览器 15/15、移动端 5/5;未验证项:无 ## 其他说明 **已先于合并发布到生产**(用户授权): - 提交 `2f86c441`;镜像 `sha256:87ca390d44bb…`;`BUILD_ID=KO7S41-qvKY89xp5Kczbl` - 备份:`dist_backup_20261020_140513` / `public_backup_20261020_140513` / `nginx-static-production.conf.bak.20261020_142648` - 线上核对:9 条关键路由 200;`warm-routes` 30 路由非 200=0;容器日志 error=0; 站内跳转三浏览器 15/15、移动端 5/5;安全头单值化(XFO=DENY、CSP 无 `unsafe-eval`) - 服务器悬空镜像回收 1.27GB,剩余 2.9G 可用(86%);dist 备份保留 ## 实测门禁输出(回填) | 命令 | 结果 | |---|---| | `npm run type-check` / `type-check:e2e` | EXIT=0 / 0 error | | `npm run lint` | 0 error / 84 warning(基线同数) | | `npm run test:unit` | 149 suites / 1815 tests | | `npm run test:coverage` | 149 suites / 1815 tests;global 89.56 / 88.28 / 88.18 / 89.56 | | `npm run test:integration:real` | 4 suites / 23 tests 通过;teardown 守卫 3 个本地库 inode+size+mtime 未变 | | `npm run test:e2e:fast` | 59 passed / 25 skipped / EXIT=0 | | 动效/导航 E2E(production,4 project) | 20/20 passed | | `playwright test visual-regression.spec.ts --update-snapshots=none` | 125 passed / 0 failed | | `npm run test:security:headers`(线上) | 8/8 PASS / 0 warning | | `npm run lighthouse` | 33 runs / 11 URL,全部断言通过(EXIT=0) | --- ## 追加:2026-10-20 收尾五笔(`b125d16a` → `9ea8d5f4`) | 提交 | 内容 | |---|---| | `b125d16a` fix(motion) | 首页三处场间位移把 500ms 硬编码在 class 上(`duration-500`),改用 `duration-hover`(`globals.css:287` 的 `--transition-hover: 150ms`,`tailwind.config.js:215` 已映射),对齐动效四原则的 hover 档 | | `3f11d7ee` test(a11y) | `图片都有 alt 属性` 判据修正:旧实现把 `alt=""`(装饰图的正确写法)也计成「没有 alt」,再用 `≤2` 兜底 ⇒ 一边误报装饰图、一边给真漏标留 2 张额度。现只判「既无 alt 属性、又未用 aria-hidden/role 声明装饰性」,额度 0;alt 的语义正确性交给 `npm run check:axe` | | `a9fff488` chore(assets) | `hero-architecture.webp` 2000×797 → 1920×765(125,310B → 117,722B,-6.1%),收到验收实测最宽视口那一档 | | `97a3c1bd` chore(repo) | 删 139 个临时件(根目录 3 个线上探针 + logo 目录 130 个 `_*` 中间件 64MB + stray 还原点副本),交付物本地件(评审 HTML 85 个、fonts/ 43MB、还原点、company-deck、历史 PR 稿)写进 `.gitignore`;工作树未跟踪由 271 归零 | | `9ea8d5f4` docs(lessons) | `docs/lessons-learned.md` §5.51 记录下面那条并行竞态,并更正 §5.50 末尾「视觉全量 125/125」的口径 | ### 本轮实测读数(提交树 `97a3c1bd`;`9ea8d5f4` 仅追加文档,读数不变) | 命令 | 结果 | |---|---| | `npm run type-check` / `npm run type-check:e2e` | EXIT=0 / EXIT=0,0 error | | `npm run lint`(`-f json` 逐条计数) | 0 error / **84 warning**:56 `no-console` + 14 `react-hooks/set-state-in-effect` + 8 `no-img-element` + 4 `no-explicit-any` + 1 `no-sync-scripts` + 1 `no-html-link-for-pages` = 84,分项自洽。本批两个被改文件(`home-content-v16.tsx`、`p2-functional-e2e.spec.ts`)单独 lint 各贡献 **0** 条 ⇒ 计数与 `3fabb77c` 同数,无新增 | | `npm run test:unit` | 149 套件 / 1815 例全通过,EXIT=0 | | `图片都有 alt 属性`(4 project) | 4 passed;改注释后复跑一次仍 4 passed | | 视觉只读比对 `visual-regression.spec.ts --update-snapshots=none` | 并行(4 worker)121 passed / 4 failed;红位四例 `--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` 里这一层是可红可绿的。
zhangxiang added 9 commits 2026-10-16 19:27:39 +08:00
替换 public 标识资产为已锁定的品牌字标(名=睿新致远四字真迹,简标=白文「睿」),重做 favicon
全套(16px 专用几何+补 48x48 缺失档),删除三个陈旧变体。新横排名 viewBox 比 2.663(旧 4.000),
两处 <Image> 用 w-auto 按高定宽 ⇒ 尺寸声明同批改:header.tsx width 160→106 ×2、footer.tsx
180→120 ×1。文件名全部不变,layout.tsx 四个 favicon link、structured-data.tsx 的 logo URL、
header.test.tsx 的 src 断言均无需改动(逐个核过)。
按 --update-snapshots=changed 重写;逐张过 check-baseline-shift.cjs(平移感知判据)分类,
末态在只读复跑 --update-snapshots=none 下 125 passed / 0 failed / 0 重写。
按 --update-snapshots=changed 重写;逐张过 check-baseline-shift.cjs(平移感知判据)分类,
末态在只读复跑 --update-snapshots=none 下 125 passed / 0 failed / 0 重写。
按 --update-snapshots=changed 重写;逐张过 check-baseline-shift.cjs(平移感知判据)分类,
末态在只读复跑 --update-snapshots=none 下 125 passed / 0 failed / 0 重写。
按 --update-snapshots=changed 重写;逐张过 check-baseline-shift.cjs(平移感知判据)分类,
末态在只读复跑 --update-snapshots=none 下 125 passed / 0 failed / 0 重写。
按 --update-snapshots=changed 重写;逐张过 check-baseline-shift.cjs(平移感知判据)分类,
末态在只读复跑 --update-snapshots=none 下 125 passed / 0 failed / 0 重写。
DESIGN.md 原写「中文靠字族回退,不用书法制造文化氛围」并把 --font-brand 楷体标为新页面禁用,
而锁定的字标本身就是书法真迹 ⇒ 条款限定到正文用字并另立字标例外。CONTEXT.md 原说保留「Logo 中的
书法『睿』字」,现行是名=睿新致远四字真迹、「睿」单字是简标 ⇒ 改正。
e2e/p1-brand-visual-audit.spec.ts 的 <text> 遍历对新资产目标数为 0 ⇒ 补成两支都有非零目标数的断言。
P1:globals.css 68 处中性色转暖,深通道按「保 L、色相→33°、S≤0.14」算;P4 弱文字分三档
(装饰线 #C3BDB1/非文本信息 #8A8377/正文级 #6E675D);P3 三个深底红收敛为 #E9455F(对暖墨
#141210 实测 4.88:1)。14 处彩性蓝按裁决故意不动。P2:public/fonts/ 放思源宋体可变子集 388.1KB
(cmap 回读 0 缺字)+两份 OFL 1.1 正文,--font-serif 队首插入 Novalon Serif SC,系统兜底全保留。

落库时查出并修一条真缺陷:43 条 -rgb 三元组有 22 条从未迁移(:root 11+深色块 11,色相仍 H210-217),
而 Tailwind 有 29 个颜色键经 rgb(var(--X-rgb)) 消费 ⇒ 渲染主通道还是冷的;当时 check:contrast 44/44
全绿(读 hex)、视觉套件 0 张重写 ⇒ 两道闸一起假绿。按「孪生等于同块 hex」对齐 22 条并新增常驻闸
npm run check:token-twins(0 条判红/不等判红/孤儿判红),复测 43/43 一致。
BRAND-MANUAL.md 收敛识别方案裁定与实测判据;TOKEN-MIGRATION.md 记 P1/P3/P4 迁移面与孪生缺陷;
TEST-PATCH.md 记 P7 的 1→0 实测。随包入库的是结论赖以成立的仪器与证据:check-assets、check-manual、
verify-assets-cross、check-wordmark-copies、check-docsync、check-probes(四段闸,每段带能失败的负例)、
check-baseline-shift.cjs(平移感知基线判据,四合成样本两绿两红自测通过;它取代被证伪的
「diff 包围盒不许越页眉带」)与 measured/baseline-shift-p1.json(第一批 104 张逐张分类,带 _src 出处戳)。

大体积工作件不入库:样机 HTML 与栅格截图 100+MB、字体母版 45MB 留在盘上,入库 690 个文本/矢量件。
zhangxiang added 1 commit 2026-10-16 19:29:42 +08:00
两条都是本轮落库时查出来的流程债:判据的适用对象要写进判据本身;一个语义有多条表示通道时
守卫必须按定义逐通道对账(新增 npm run check:token-twins)。并记仪器量程:视觉套件缺省
per-pixel threshold 0.1 看不见弱文字转暖,以及 138MB 压在单 commit 会被 Gitea HTTP 413 拦、
须按 project 分块逐笔推。
zhangxiang added 1 commit 2026-10-16 19:31:25 +08:00
加元素级豁免时把主循环的调用点改成了两参数,同一次全局替换也命中了 selftest 循环里的调用,
而那里没有 rel 变量 ⇒ ReferenceError,--selftest 以非零码退出。这是「闸自身崩溃与判红共用
EXIT=1」那一族:崩溃看起来像判红,而这次连红都是假的。selftest 改传样本名,恢复四样本
两绿两红、EXIT=0(合成样本名不含 header-navigation,不会被元素级正则命中)。
zhangxiang added 2 commits 2026-10-20 11:27:24 +08:00
- 首页按咨询机构影像版式重排,保留原站文案与“洞察→行业→能力”段序
- 导航/页脚/品牌页换用上下锁定字标,alt 维持法定主体名
- 修复 reduce 下 PageTransition 祖先 opacity 停留导致的白屏
- 4 浏览器 × 9 宽度多端复核,axe 0 violation
- 视觉基线 106 张更新并只读复跑 125/125
- 记录 acb6b673 发布、镜像/备份锚点与 14 路由 200
- 补线上多端探针 report-production 与 prod 截图
- 探针先 eager 加载再滚屏,避免把懒加载未触发误报成破图
zhangxiang added 1 commit 2026-10-20 11:28:31 +08:00
zhangxiang added 1 commit 2026-10-20 11:28:40 +08:00
zhangxiang added 1 commit 2026-10-20 14:02:12 +08:00
现象:生产环境所有站内跳转白屏,地址与标题已切换,刷新才恢复。
根因: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。
zhangxiang added 1 commit 2026-10-20 14:12:33 +08:00
zhangxiang changed title from feat(brand): 品牌字标与色板字族落库(含 104 张视觉基线重写) to feat(brand): 首页影像版式与名+号字标;修复站内跳转白屏 2026-10-20 14:55:54 +08:00
zhangxiang added 1 commit 2026-10-20 14:57:16 +08:00
zhangxiang added 4 commits 2026-10-20 22:07:41 +08:00
三处场间位移把 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` 静默失效。
zhangxiang added 1 commit 2026-10-20 22:13:38 +08:00
只读比对在 4 worker 下给出 121 passed / 4 failed,原样重跑红位换了一批
(chromium-tablet 两例转绿),同一批用例 --workers=1 重跑 10/10 通过。逐行差分
显示差异只在长页中部一条带内、带内 actual 是空白 ⇒ 内容停在 opacity:0,
即 waitForPageStable 的 120ms dwell 在 CPU 争用下没能把 whileInView 提交完。

同时更正 §5.50 末尾「视觉全量 125/125」的口径:那是并行下偶然取到的一次读数,
不能当可复现证据。
zhangxiang merged commit 9ea8d5f495 into dev 2026-10-20 22:14:20 +08:00
Author
Owner

合并后补测(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,不是「串行即全绿」。
  • 那 1 条红是 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」这一条门禁口径。

**合并后补测(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**,不是「串行即全绿」。 - 那 1 条红是 `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」这一条门禁口径。
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: novalon/novalon-website#32