zhangxiang
|
2c974d1971
|
docs(lessons): §5.51 收回未证实的机理——hero 无条件黑底,null copy 造不出浅色版式
上一版把首页那条间歇红(actual 矮 3114px、整段换成另一套版式)归因到
`getHomePageCopy().catch(() => null)`。读回代码就知道这条解释站不住:
hero 是无条件 `bg-[#0B0A08]`,copy 为 null 只影响文案,产生不出「浅色无图 hero」。
改成如实记录:机理未取证,已确证的只有「同树隔离 3/3 绿、基线与被测代码一致 ⇒
环境侧偶发」。同时把修法写成可验证的状态判据(已落地):dwell + 排帧、
显影落定等待、截图前断言 data-cms-state;并写明没有采用 --workers=1 的理由
(用串行掩盖竞态、把 5 分钟的层拖到 17 分钟)。
|
2026-10-21 16:36:55 +08:00 |
|
zhangxiang
|
ec30f508fa
|
test(visual): 截图前等显影落定,dwell 120ms→260ms 并排两帧
旧 helper 只靠固定 120ms 步长等 whileInView 提交,4 worker 抢 CPU 时中间某屏会被
IO 回调漏掉,截图留下一条 opacity:0 的空白带(lessons §5.51 签名 1)。这是装配竞态,
不该靠「多等一会儿」赌,也不该把整层钉成 --workers=1 用串行遮掉。
- 每步 dwell 提到 260ms 并排两帧(rAF×2)后再进下一屏。
- 滚动结束后等**状态**而不是时长:`main` 下 inline `opacity:0` 且仍有高度的元素必须
归零;8s 超时则把前 5 个 offender 的标签写进错误,让红按名字出现。
判据用 inline style 而非计算样式——framer 未开始时写 `opacity:0`、完成后写 `1`,
两者只差这一笔;同时排除 display:none 与零高度节点,避免误判折叠菜单。
- 顺带修掉 `document.fonts?.ready` 只取 promise 不 await 的老问题(等于没等字体)。
- 截图前断言首页的 `data-cms-state`:CMS 退化按名字失败,不留给像素比对去猜。
|
2026-10-21 16:36:49 +08:00 |
|
zhangxiang
|
a5ce27c6ec
|
feat(cms): 首页输出 data-cms-state,退化时按名字失败而不是猜像素
CMS 读数全空时首页会整套落到常量版式,页面照常 200,外观与「后台就是没内容」
不可区分。视觉基线对此只能给出一团无从归因的像素差——2026-10-20 那次间歇红
就是被这样当成了竞态。
- `page.tsx` 统计六路内容来源,全空判 `cmsState='empty'`,非空为 `ok`;
同时把 `getHomePageCopy` 原本 `catch(() => null)` 的静默吞掉改成带 tag 的
`console.warn`(行为不变,只是不再无声)。
- `home-content-v16.tsx` 在根节点渲染 `data-cms-state`;默认 `ok`,不影响其它调用方。
- 单测新增三例:全空 ⇒ empty;任一来源有内容 ⇒ ok;copy 抛错 ⇒ 页面不炸、
状态仍 ok、且 warn 被调用(钉住「不静默」这条)。
视觉层据此在截图前断言该标记(下一笔)。
|
2026-10-21 16:36:34 +08:00 |
|
zhangxiang
|
81dc70b86c
|
docs(brand): 字体授权文本与清单入库,43MB 字源仍留本地
OFL 要求分发时附带许可与版权声明;这两份文件也是「用了哪几套字、各自的子集口径」
的唯一记录。原先把整个 fonts/ 目录屏蔽,连它们一起挡在了仓库外。
.gitignore 由目录级 `fonts/` 改为 `fonts/*` + 三条反选:
FONT-MANIFEST.md / LICENSES.md / OFL-*.txt 入库,8 个 ttf/woff2 继续留本地
(站内实际引用的字体在 public/fonts,已入库)。
|
2026-10-21 16:36:28 +08:00 |
|