feat/brand-wordmark-landing
dev
本分支交付 2026-10-20 首页影像版式与「名 + 号」字标,并修复当日生产暴露的全站站内跳转白屏:
PageTransition
AnimatePresence mode="wait"
exit
motion.div
opacity:0
key={pathname}
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
npm run type-check
type-check:e2e
npm run lint
/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:unit
npm run test:coverage
npm run test
test:functional
npm run check:a11y
npm run lighthouse
npm run test:security:headers
docs/lessons-learned.md
skip
todo
origin/*
origin/dev
git ls-remote
已先于合并发布到生产(用户授权):
2f86c441
sha256:87ca390d44bb…
BUILD_ID=KO7S41-qvKY89xp5Kczbl
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
9ea8d5f4
duration-500
duration-hover
globals.css:287
--transition-hover: 150ms
tailwind.config.js:215
3f11d7ee
图片都有 alt 属性
alt=""
≤2
npm run check:axe
a9fff488
hero-architecture.webp
97a3c1bd
_*
.gitignore
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
--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 各两例。⇒ 不是内容漂移,也不是像素容差。
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
ScrollReveal
src/components/ui/scroll-reveal.tsx:80-96
className
test:all
替换 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 重写。
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 个文本/矢量件。
两条都是本轮落库时查出来的流程债:判据的适用对象要写进判据本身;一个语义有多条表示通道时 守卫必须按定义逐通道对账(新增 npm run check:token-twins)。并记仪器量程:视觉套件缺省 per-pixel threshold 0.1 看不见弱文字转暖,以及 138MB 压在单 commit 会被 Gitea HTTP 413 拦、 须按 project 分块逐笔推。
加元素级豁免时把主循环的调用点改成了两参数,同一次全局替换也命中了 selftest 循环里的调用, 而那里没有 rel 变量 ⇒ ReferenceError,--selftest 以非零码退出。这是「闸自身崩溃与判红共用 EXIT=1」那一族:崩溃看起来像判红,而这次连红都是假的。selftest 改传样本名,恢复四样本 两绿两红、EXIT=0(合成样本名不含 header-navigation,不会被元素级正则命中)。
- 首页按咨询机构影像版式重排,保留原站文案与“洞察→行业→能力”段序 - 导航/页脚/品牌页换用上下锁定字标,alt 维持法定主体名 - 修复 reduce 下 PageTransition 祖先 opacity 停留导致的白屏 - 4 浏览器 × 9 宽度多端复核,axe 0 violation - 视觉基线 106 张更新并只读复跑 125/125
- 记录 acb6b673 发布、镜像/备份锚点与 14 路由 200 - 补线上多端探针 report-production 与 prod 截图 - 探针先 eager 加载再滚屏,避免把懒加载未触发误报成破图
acb6b673
现象:生产环境所有站内跳转白屏,地址与标题已切换,刷新才恢复。 根因: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.
变更摘要
本分支交付 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。feat(brand): 品牌字标与色板字族落库(含 104 张视觉基线重写)to feat(brand): 首页影像版式与名+号字标;修复站内跳转白屏合并后补测(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」这一条门禁口径。