Commit Graph
767 Commits
Author SHA1 Message Date
zhangxiang 024cab9cc3 chore(visual): 重采基线 chromium-mobile(图标下移 3px 后的真实像素) 2026-10-26 10:46:44 +08:00
zhangxiang ac589c808c chore(visual): 重采基线 chromium-tablet(图标下移 3px 后的真实像素) 2026-10-26 10:45:22 +08:00
zhangxiang 97f51b4128 chore(visual): 重采基线 firefox-desktop(图标下移 3px 后的真实像素) 2026-10-26 10:45:12 +08:00
zhangxiang 16baf7300a chore(visual): 重采基线 chromium-desktop(图标下移 3px 后的真实像素) 2026-10-26 10:44:43 +08:00
zhangxiang a63cf38c62 fix(footer): 联系我们图标与首行文字同中线
旧写法用固定 mt-0.5 给图标手拍偏移,而本项目 --line-height-relaxed 是 1.85(非 Tailwind
默认 1.625),根字号又有 16/17/18 三档 ⇒ 图标中心比文字行盒中心高 3.319/3.134/2.950px
(地址行)与 3.313/3.133/2.945px(邮箱行)。

改为结构对齐:地址行图标包进高 = 行盒高(--line-height-relaxed × --font-size-sm)的
items-center 单元格,换行后仍对齐首行;邮箱行是单行链接,整行 items-center。
行高/字号/页高零变化,只移动两个图标。
2026-10-26 10:43:57 +08:00
zhangxiang 03be1c9e36 test(visual): 首页缺 data-cms-state 时判红,避免守卫退化成死判据
上一版写成「有标记就校验、没有就跳过」。可标记正是这条守卫存在的理由:
prop 没透传、组件换成旧版、属性改名,任何一种都会让守卫静默失效,
而用例照样绿——正是「备好但从未跑成」的那类自伤。

改为按路径判定:`/` 必须带标记且为 ok,否则按名字报错;其它页面跳过。
正控:25 个首页相关用例全绿(标记确实在 DOM 里且为 ok)。
负控:临时把属性去掉 ⇒ 立刻红,报「首页缺少 data-cms-state 标记」。
2026-10-21 16:57:47 +08:00
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
zhangxiang dee0c4835c docs(lessons): §5.51 更正——串行并非全绿,视觉间歇红有两种签名
同树全量 `--workers=1` 实测 124 passed / 1 failed,且那条红在同一棵树上
`--repeat-each=3` 隔离复跑 3 passed、在改动前的 3fabb77c 上单跑也 passed
⇒ 上一笔把它归因成「4 worker 的 dwell 竞态」过强,串行全绿不能给并行红背书。

按 actual/expected 的签名拆开:同高 + 带内空白 = dwell 竞态(/team、/about/brand);
不等高(矮 3114px)+ 整段换成另一套版式 = `page.tsx:60` 的
`getHomePageCopy().catch(() => null)` 在负载下退化,页面照常 200 但内容回落成常量版式。
后者不能靠加大 dwell 修,也不该由视觉基线来背。
2026-10-20 22:31:38 +08:00
zhangxiang 9ea8d5f495 docs(lessons): §5.51 视觉门禁的红位会随并行漂移——是 dwell 竞态,不是基线过期
只读比对在 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:13:10 +08:00
zhangxiang 97a3c1bda9 chore(repo): 交付物本地件登记进 .gitignore,清掉 139 个临时件
工作树长期挂着 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` 静默失效。
2026-10-20 22:07:23 +08:00
zhangxiang a9fff488cf chore(assets): hero 影像收到 1920 宽,字节 -6.1%
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 全部仍与基线一致 ⇒ 该降档在测试视口下无像素外溢。
2026-10-20 22:07:10 +08:00
zhangxiang 3f11d7ee22 test(a11y): alt 判据只盯漏标,取消「允许 2 张」兜底
旧实现把 `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)首页用例全绿。
2026-10-20 22:06:56 +08:00
zhangxiang b125d16a2e fix(motion): 首页影像 hover 位移改用 --transition-hover 令牌
三处场间位移把 500ms 硬编码在 class 上(`duration-500`),与 CONTEXT.md
动效四原则里 hover 那一档 150ms 冲突。仓库已有令牌:globals.css:287 定义
`--transition-hover: 150ms`,tailwind.config.js:215 把它映射到
transitionDuration.hover ⇒ 改用 `duration-hover`,不再新增数值。
2026-10-20 22:06:39 +08:00
zhangxiang 3fabb77caa docs(ops): 补齐 nginx 对齐、门禁读数与 PR #32 记录 2026-10-20 14:57:13 +08:00
zhangxiang 0b1543df8b docs(ops): 记录站内跳转白屏修复发布(2f86c441) 2026-10-20 14:12:29 +08:00
zhangxiang 2f86c4419a fix(motion): 站内跳转白屏——路由内容不再走 AnimatePresence wait 退场
现象:生产环境所有站内跳转白屏,地址与标题已切换,刷新才恢复。
根因: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 14:00:41 +08:00
zhangxiang 092ed385b0 docs(acceptance): 去掉会随提交漂移的分支 tip 字面 2026-10-20 11:28:36 +08:00
zhangxiang dd9b01f7e3 docs(acceptance): 补首页改版发布源码推送与 nginx 临时限额记录 2026-10-20 11:28:27 +08:00
zhangxiang ba05b2e57b docs(acceptance): 首页改版生产发布记录与线上多端验收
- 记录 acb6b673 发布、镜像/备份锚点与 14 路由 200
- 补线上多端探针 report-production 与 prod 截图
- 探针先 eager 加载再滚屏,避免把懒加载未触发误报成破图
2026-10-20 11:24:16 +08:00
zhangxiang acb6b67357 feat(brand): 首页影像版式与名+号字标上线
- 首页按咨询机构影像版式重排,保留原站文案与“洞察→行业→能力”段序
- 导航/页脚/品牌页换用上下锁定字标,alt 维持法定主体名
- 修复 reduce 下 PageTransition 祖先 opacity 停留导致的白屏
- 4 浏览器 × 9 宽度多端复核,axe 0 violation
- 视觉基线 106 张更新并只读复跑 125/125
2026-10-20 11:09:32 +08:00
zhangxiang f6e750c318 docs(runbook): 修正 build/up 串链位置——注释不能落在 && 之后(否则是 shell 语法错) 2026-10-20 08:23:49 +08:00
zhangxiang 702c732d27 fix(contact): 去掉 useSearchParams 让 /contact 可完整预渲染;补发布后 ISR 预热脚本
冷首访白屏的第二个真因:/contact 用 useSearchParams() 读 ?success,客户端组件里
这会让整页在预渲染时退化成 Suspense fallback(首访只看到「加载中…」,限速下 ~6s 才出内容)。
该参数只用于一次性成功提示 ⇒ 改为挂载后从 window.location 读并 replaceState 清理。

- /contact 冷首访 h1 可见:6.0s → 1.5s;HTML 73KB 含正文(此前只有外壳)。
- 新增 scripts/ops/warm-routes.mjs:按 sitemap 预热并断言全 200、第二遍 <1500ms 或 HIT;
  本轮线上第二遍:非 200 = 0、>1500ms = 0。
- 全站冷首访复测:/ 827ms、/about 1652ms、/contact 1511ms、/products 917ms、
  /services/software 922ms、/insights 1532ms。
- runbook:加发布前磁盘检查(≥2G)与「构建失败必须中止」;加 §4.0 预热步骤。
- 事故记录:第三次重建时服务器磁盘 99%,COPY 报 ENOSPC 而 up -d 仍执行(旧镜像被当已发布);
  清理旧备份 1.8G + docker image prune 1.075G 后回到 81%,重建 015b6d75 成功。
2026-10-20 08:23:34 +08:00
zhangxiang ca3df3221d fix(motion): 冷首访白屏——JS 就绪前强制入场元素可见,水合后再交还 framer
用户反馈「首次访问白屏,需要刷新才可以」。用禁用缓存 + 限速复现并量化:
745ms 时 SSR HTML 已在(正文 1177 字),但 h1 的 opacity 仍为 0;
直到 5945ms 才变 1 ⇒ 冷首访/弱网下 3–5 秒白屏,刷新后脚本已在缓存里所以「刷新就好」。

根因是全站性的:167 处 framer 入场把初始 opacity 内联成 0
(SSR 实测 style="opacity:0;transform:translateY(30px)"),而它只能由 JS 驱动;
页面级 template 的 initial 也是 {opacity:0,y:8}。逐文件改既大又有误伤风险
(面板/轮播的 opacity 是状态语义,不是入场)。

修法(一处兜底 + 一处交接,失败也是敞开的):
- globals.css 新增规则:当 html 上没有 data-content-ready 时,
  把内联 opacity:0 的入场元素强制为 1(同时匹配 "opacity:0" 与 "opacity: 0" 两种写法)。
  JS 尚未执行时内容可见;若脚本永远失败,则永不置位,内容一直可见。
- 营销页 template:水合后 800ms(> 最长入场 280ms + 余量)置位 data-content-ready,
  把控制权交还 framer,避免「闪一下」。

回归守卫 e2e/first-paint-visibility.spec.ts:
① 禁用 JS 时 h1 内联仍 opacity:0 但计算值为 1(兜底生效,且证明前提仍在);
② 正常加载时 data-content-ready 置位、交接前后 h1 均为 1。
变异验证:删掉 CSS 规则 ⇒ 2 条全红;恢复 ⇒ 2 条绿。
复算:tsc / type-check:e2e 0、check:visual 0、视觉 chromium-desktop 25/25、reduce 回归 2 绿。
2026-10-20 08:16:06 +08:00
zhangxiang 12999348bc docs(evidence): /about 白屏排查的探针与线上 reduce 实测截图入库
- probe-reduce-after.mjs:线上 reduce 偏好下 hydration 错误计数(修复后 0)
- probe-reduce-scroll.mjs:逐屏滚动后 hidden 14→3、末段 opacity=1
- about-reduce-after-scroll.png:修复后 reduce 渲染实物
其余探针(nojs / matrix / clientnav / live / webkit)已在 fix(motion) 那笔一并入库。
2026-10-20 08:03:39 +08:00
zhangxiang c394347dd0 docs(qa): §16.5 修复上线与线上 reduce 实测(hidden 14→3、0 hydration 错误)
同时登记本轮的编排事故:第一次重传用 set -- $pair 分词,zsh 不分词 ⇒ 5 条 rsync 全失败,
但未开 set -e 仍继续 docker build,等于用旧文件重建了一次镜像(无可见症状)。
已改为逐条判退出码重传并重建,用 BUILD_ID 与 reduce 实测确认线上确是新代码。
教训同 §5.44:命令都返回了 ≠ 命令都成功了。
2026-10-20 08:03:14 +08:00
zhangxiang d0090cea56 fix(motion): reduce 偏好下 hydration 不匹配(React #418)且元素停在 opacity:0
线上 /about 白屏排查(§16):30 条路由 + 6 种环境里唯一可复现的缺陷是
webkit/chromium + prefers-reduced-motion:reduce ⇒ pageerror #418,main 内 14 个元素
opacity 恒 0(正常环境只有 3 个首屏以下的滚动入场项)。

根因:useReducedMotion 用 window.matchMedia 作 useState 初值 ⇒ SSR false、客户端首帧 true;
scroll-reveal / template / page-transition 又用它决定 initial/variants/甚至早返回不同树结构,
与 SSR HTML 不一致;且 reduce 时 whileInView 被清空 ⇒ 元素停在 initial 的 opacity:0。

修法(结构恒定,减少动效改用「时长 0」表达):
- hook 首帧恒 false,挂载后 effect 同步真实偏好;
- ScrollReveal/StaggerReveal 的 initial/whileInView/variants 不再按 reduce 清空;
- template.tsx 与 StaggerChildren 去掉早返回裸结构,改空 variants。

回归守卫 e2e/reduced-motion-hydration.spec.ts(/about 与 /):断言 reduce 自证生效、
无 hydration 错误、h1 与末段标题 opacity=1。变异验证:hook 改回 matchMedia 初值 ⇒ 2 红,恢复 ⇒ 2 绿。

另:runbook 明确禁止对 dist/_next/static 用 --delete(回访者旧 HTML 会引用上一代 chunk);
本轮已从备份 --ignore-existing 合并回旧代 101 个文件。复算:tsc/type-check:e2e 0、
jest 35 套件 462 例 0、check:visual 0、check:motion 0、视觉 chromium-desktop 25/25。
2026-10-20 08:00:20 +08:00
zhangxiang 524c1b6575 docs(release): 生产发布记录 §15 + runbook 更正「合 main 不会触发部署」
实测更正:Jenkins 任务 novalon-website-ci-cd 的 config.xml 是 <triggers/>(空)、builds 只有 permalinks
(从未构建)、匿名 POST /job/…/build 返 403、Gitea webhook 打不进去 ⇒「合 main 自动部署」当前不成立。
runbook §3 补「设计路径(需管理员加 GenericTrigger)」与「手动路径(本轮实际执行)」两节。

发布记录(§15):本地重建 → 服务器 dist/public 备份 → rsync 增量(3011 文件 / 2432 传输 /
线上 3.4MB,speedup 44)→ 镜像重建 c2c955d3 → 容器 healthy → 10 个页面全 200 →
线上 HTML 出现新标记(成果槽空态 / results-slot / 预约咨询 / 四轴导航)→ 服务端回退日志 0、error 0 →
停容器迁移(source=cms / issues=0,回传后 chown 1001:1001)→ 迁移后库读数:导航四轴 + 三模型门槛字段 ✓、
内容 38 行未变、案例 0 条 → 线上全页截图人工确认。回滚锚点三项已登记。
2026-10-20 07:49:56 +08:00
zhangxiang 7a410cee92 chore(ops): sync-cms-schema 置为可执行(100755,含 shebang) 2026-10-20 07:42:18 +08:00
zhangxiang 5a67734c57 docs(qa): 视觉基线核验记录——125 张结构全量扫描 + 4 张人工读图,0 空白/塌版
- 结构性全量:唯一色中位数 1344、近黑 15.1%、近白 72.6%;可疑 2 张均为白底裁图
  (mobile 按钮 132x132 近白 94.6%、移动端顶栏 1170x240 近白 95.1%),非空白页。
- 人工读图 4 张:首页全页(8 段 + ResultsSlot 空态)、/contact(文案与当前 seed 一致,
  证明是内容漂移后的重采而非旧图)、暗色首页(暖墨底/品牌红/白字标)、按钮裁图。
- 如实登记:其余 121 张未逐张肉眼读;逐名清单与结构扫描口径已入库,供分批追认。
2026-10-20 07:41:58 +08:00
zhangxiang 2c0a5b2cdf fix(ops): 修 cee21e17 留下的 tsc 红——node:sqlite 在本仓 @types/node 里没声明
自报第三次同类:那条命令里我先算出 TSC=2,却仍把提交与推送做完了。
根因不是新问题而是老缺口:@types/node 版本不带 node:sqlite 的类型(TS2307)。
修法不是 @ts-expect-error(将来类型补上会反过来报"未使用"),而是
createRequire + 本地最小接口(prepare/all/get/run/exec),既保留参数化查询
也不依赖模块解析。

复算以 HEAD 为准:tsc --noEmit EXIT=0;脚本对生产库副本的 dry-run 仍输出
「3 个模型各 +authorized,+basis / navigation 7→4 项 / source=cms issues=0」。
管理归零:后续提交一律走 `测量 && 提交` 的 && 链,红不得穿过(§5.47 已立,本轮再犯)。
2026-10-20 07:41:01 +08:00
zhangxiang cee21e178a docs(ops): 生产侧核对与发布 runbook;新增最小迁移脚本 sync-cms-schema(默认 dry-run)
只读核对生产库(scp 副本、本地 node:sqlite 查询,未写生产):
- navigation 行仍是旧 7 项 IA(panels products,solutions,services)⇒ 新代码每请求退回代码真源;
- 三处 caseStudies 的 ContentModel.fields 缺 authorized/basis ⇒ 后台填不出门槛字段;
- 生产案例条目 **0 条** ⇒ 只发代码不会隐藏任何内容(dataProofs 按裁定不套硬闸)。

新增 scripts/ops/sync-cms-schema.ts:只补 3 个模型的两个子字段 + 把 navigation 行改写为
由 NAVIGATION_V2/MEGA_DROPDOWN_DATA 派生的形状;默认 dry-run,--apply 才写,
写前用真实 resolveNavigation 验收派生形状、写后强制复查(不通过即退出码 1)。
在生产库副本上预演通过:source=cms / issues=0;逐行 diff 证明只动了
3 个 ContentModel 行 + 1 个 ContentItem 行(navigation),其余 37 行内容与 13 个模型逐字节不变。

docs/development/deploy-runbook.md 写清:备份与停容器顺序、**服务器 Node v20 无 node:sqlite
⇒ 迁移必须本机跑再回传**、不推荐用 db:seed(会重写所有覆盖行且需 SEED_ALLOW_EXTERNAL_DB=1)、
发布后四项只读核对、三条回滚路径,以及"合 main = 无人值守线上发布,须决策人显式发起"。
2026-10-20 07:40:37 +08:00
zhangxiang 8799a9658e chore(visual): 内容漂移后的基线重采(/contact ×5 + input ×2),并登记"基线与 seed 内容耦合"
重新 seed 把 contact-page 的两段文案恢复成 seed 版本(785→792 字节,差异键
heroDescription 与 commitmentItems[0]),而现有基线是在被污染的旧内容上采的
⇒ 终版产物门禁里视觉只读 6 failed,全部是内容型整页/表单裁图,不是样式回归。

- 重采后两次运行均 125 passed / 0 failed(--update-snapshots 与 --update-snapshots=none)。
- §14.6 写死口径:重跑 db:seed 或改 CMS 文案会让内容型基线失效,
  按「内容变更 ⇒ 重采 + 只读复验」处理;若只有 /contact、/news 整页红而组件裁图全绿,
  先查数据而不是查 CSS。
2026-10-20 06:46:07 +08:00
zhangxiang 9971fb54bb docs(qa): §14.4–§14.5 收口——数据层自伤防线、两处真根因,全量功能 E2E 1068/0
- §14.4:跨 worktree 的绝对 DATABASE_URL 让旧代码 seed 覆盖本树整库(§14.3 残差读数作废、
  AUTH-NAV 误判的源头);防线 checkSeedTarget 写前中止 + 活体负对照(外部库未被创建)。
  以及 contact 5 次/小时的进程内桶(结构性 429)与 uj-08 面板 280ms 动画 not stable。
- §14.5:曾记为「并行墙钟残差」的 1~3 条逐条查出真因(hydration 前点击、logo 混入菜单选择器、
  contact/login 限流、hover 撞动画),修完即 0。
  最终读数:test:functional(4 project、默认 workers)1068 passed / 0 failed / 44 skipped,EXIT=0。
- 口径修正:隔离能绿 + 集合每轮不同,不足以判为墙钟抖动;先读完整报错、再找同文件已修同类的
  前置约定(如 expectHydrated)。
- PR 描述里 npm run test 一项由「合并后补记的未勾选更正」改为闭合陈述(记录了最初勾错这件事)。
- 终版复算:test:all EXIT=0(149 套件 / 1815 例、真库 23 例、e2e:fast 59 passed)、
  check-pr-checklist EXIT=0(0 个未勾项)、tsc EXIT=0。
2026-10-20 06:19:20 +08:00
zhangxiang 3859d2a966 test(e2e): Logo 点击同样补 hydration 前置;§14.4 记录数据层自伤与两处真根因
- p2:136「Logo点击返回首页」在全量里 webkit 偶发 17.7s 超时,与 website-acceptance
  「导航菜单功能正常」同根因:元素可见 ≠ 可交互,hydration 窗口内派发的 click 被丢弃。
  补 expectHydrated(本仓既有约定,探 __reactProps$)后再点。
  复算:4 project × 3 轮 = 12/12 passed;此前同轮 4/4 failed 是漏了 import,已修。
- §14.4 记录:跨 worktree 的绝对 DATABASE_URL 让旧代码 seed 覆盖本树整库
  (§14.3 残差读数作废、AUTH-NAV 误判的源头),防线是 checkSeedTarget 的写前中止
  + 活体负对照(外部库未被创建);以及 contact 5 次/小时限流的结构性 429
  与 uj-08 面板动画 not stable 两处真根因。
2026-10-20 06:02:27 +08:00
zhangxiang 5530add712 fix(e2e,api): 联系表单限流同登录一样可覆盖;修 uj-08 面板动画与导航点击错位的两处真因
全量功能 E2E 在「修好数据」后的干净读数:1066 passed / 2 failed,两条都是
website-acceptance 的「导航菜单功能正常」在 firefox/webkit 上 15s 超时。
按「能复现就修根因」处理,不记成墙钟抖动:

1) 登录/联系表单限流同族:contact 也是进程内内存桶 5 次/小时/IP,而 e2e server
   跨整轮用例存活 ⇒ 多次提交必然 429。抽出 src/lib/rate-limit-config.ts 的
   readRateLimitMax(未设⇒默认、非法值⇒默认且打 [rate-limit-config] warn、
   合法值⇒取整),login 与 contact 都改用它;默认值都不动(10/5),
   仅在 e2e harness 抬到 500/200。3 例判据覆盖上述三条路径。
2) uj-08:helper hover 的是顶栏里第一个 a[href=/services](实测命中工具行那条),
   且面板正在播 280ms 入场动画 ⇒ Playwright 判 not stable 重试到 15s。
   改为语义锚点「查看全部能力」+ 等 320ms(> token 的 280ms),
   并断言其 href 就是导航项自己声明的 /services。firefox+chromium 复跑 2 passed。
3) website-acceptance「导航菜单功能正常」:日志显示点击后 navigated to /
   ⇒ 点在了 logo 上。①补 expectHydrated(nav)(相邻用例早有,这条漏了);
   ②选择器排除 href=/ ⇒ 测的真是菜单项。firefox+webkit 连跑 **5/5 绿**(4.7s,
   此前 15s 超时)。

复算:tsc 0、type-check:e2e 0、rate-limit-config + login + seed-target 测试全绿。
2026-10-20 05:46:05 +08:00
zhangxiang 944fb018e7 fix(prisma): seed 前加目标库沙盒检查,堵住跨 worktree 的绝对 DATABASE_URL 整库覆盖
事故:把 worktree A 的 .env 拷进 worktree B 做基线对照,而 DATABASE_URL 是绝对路径
(file:/…/A/prisma/dev.db)⇒ B 上跑的旧代码 seed 顺着它把 A 的库整库覆盖成旧 IA 数据。
之后 A 上的门禁与 e2e 全在这份脏数据上出数,而「每棵树各有自己的 dev.db」看起来完全正常。
本轮 §14.3 的残差读数与一次 AUTH-NAV 重开的误判都源于此。

- 新增 src/lib/seed-target.ts:纯函数 checkSeedTarget(url, repoRoot, allowExternal)。
  目标库不在本树内 ⇒ 写之前就抛错中止;非 file: 协议同样要求显式放行。
  生产容器 seed(file:/app/data/prod.db 在仓库根之外)按显式 SEED_ALLOW_EXTERNAL_DB=1 走。
- prisma/seed.ts 在 main() 最先处调用,并打印实际目标库与判定理由。
- 8 例判据:本树内 / 相对路径 / 带查询串 / 仓库根之外 / 兄弟目录前缀陷阱 /
  显式放行 / URL 缺失 / 非 file: 协议。
- 活体负对照:DATABASE_URL=file:/tmp/outside-sandbox.db 跑 seed ⇒ EXIT=1,
  且 /tmp/outside-sandbox.db 未被创建(拦住发生在写之前);本树 seed 正常并打印目标路径。
- 顺带修正:守卫的测试最初放在 prisma/ 下,jest roots=['src'] 根本不收集它
  (读数:Pattern: prisma/seed-target - 0 matches)⇒ 一个不被跑的守卫比没有守卫更危险,
  已把模块与测试一起搬进 src/lib。
- 数据已修复:重新 seed 后 navigation 行为 行业/能力/洞察/关于我们 + 面板
  industries/capabilities/insights;服务端每请求「退回代码真源」的日志由每次变 0 次。
2026-10-17 12:00:27 +08:00
zhangxiang 73613fcfc5 docs(pr): §14.2–§14.3 批次的 PR 描述(32 子项、checklist EXIT=0,含 4 条不沉默的未验证项) 2026-10-17 11:54:09 +08:00
zhangxiang 7d947fbc05 test(e2e): 修 nav-keyboard 押死 Tab 次数的脆性(改有界键盘行走),§14.3 登记残差抖动口径
- 实取:final5 干净跑 1067 passed / 1 failed(本条),final6 干净跑 1065 / 3 failed
  且红项集合与 final5 不重合 —— 全是 18~25s 超时类、隔离复跑各自绿。
- nav-keyboard:56 原先连按 3 次 Tab 后断言焦点在触发器上,押死了站点计数;
  改成有界键盘行走(≤8 次 Tab 走不到即失败),断言强度不降:
  仍要求仅用键盘可达、且 Enter 真能展开面板。
- 复算:隔离 12 passed;与 p2/website-acceptance 合跑 68 passed;
  变异(把上界改成 1)⇒ 立刻判红,证明这条断言不是摆设。
- §14.3 把口径写死:不以「隔离能绿」关掉断言,也不把残差写成「全量通过」;
  PR 描述里 npm run test 一项保持未勾选,本地要稳定复现绿用 --workers=1。
2026-10-17 11:51:00 +08:00
zhangxiang fadc35b980 test(e2e): 修 pollBoundingBox 自身的二次读取竞态,§14.2 登记逐条处置与探针否证
- 探针 docs/acceptance/2026-10-17-final/probe-logo.mjs 实测加载期无双字标可见窗口
  (390x844 与 1280x800 各 60 次采样,双可见 0;唯一零可见是 t≈43ms header 尚未进 DOM)
  ⇒ 产品不闪,红来自辅助函数:expect.poll 等到非空后再单独读一次 boundingBox,
  hydration 亚 60ms 的重挂让第二次读取返回 null,被误报成「元素在断言瞬间消失」。
- 改为在同一次读取里既判非空又产出值;超时才 throw,且 throw 文案带轮询次数。
  判据不降:仍要求非空 box + 原几何断言,没有 catch、没有静默通过。
- website-acceptance × 4 project 连跑两次各 56 passed。
- §14.2 表逐条登记:fail-open 修复 / 触摸目标与 region 命名 / 限流真因与双向用例 /
  锚点重锚 / 引擎差异取证法(我上一个假设被自己的读数否掉)/ 本条竞态。
2026-10-17 10:59:50 +08:00
zhangxiang 1e80167b7c fix(a11y,e2e): 修 §14 定性出的 6 类功能 E2E 红,含一条 fail-open 与一处我自己造成的重复键
产品侧(真缺陷):
- detail-trust-section 渲染绕过门槛(publishableCases 算了却仍 map caseStudies)⇒
  只要一条过闸,未授权/无 verified 的案例照样上线。改回 publishableCases.map,
  新增 detail-trust-gate.test.tsx 3 例;变异验证:回退成 caseStudies.map ⇒ 2 条精确转红。
- 4 个文字链接触摸目标 23px < WCAG 2.5.8 的 24px(home 全部洞察/了解这一能力、
  成果槽两条 CTA)⇒ 走间距刻度 min-h-6 补齐,不塞任意值。判据本身复跑通过。
- 首页能力面板 role=region 缺可访问名(landmark 无名;axe 的 landmark-name 属
  best-practice 标签,我们的闸只跑 A/AA 所以没报)⇒ 补 aria-label。
- 登录限流额度改为可按环境覆盖(默认仍 10 次/15 分钟/IP,生产姿态不变);
  真因:进程内内存桶 + dev server 跨整轮存活 ⇒ @admin 旅程第 11 次登录起必得 429,
  即 §14 里「单跑绿、全量红」的机理。route.test.ts 加双向用例(未设=10;设 3 ⇒ 第 4 次限流)。

测试侧(锚点/引擎):
- mobile.spec:45、website-acceptance:139 的重锚:锚点取自真源 navigation.ts
  (一级只剩 行业/能力/洞察/关于我们,联系入口是 consult-button 而非导航项)。
- p4:403 焦点管理:webkit/chromium-mobile 上 Tab 不落到链接(Safari 系需系统级
  「Press Tab to highlight each item」,Playwright 起的 webkit 不带),
  我先试 bringToFront + 点空白**没有用**,故改为同契约按引擎取证(chromium 走真实键盘
  Tab,其余显式 focus 跳转链接),断言一条不减;复跑 webkit+mobile 2 passed。
- playwright.config.ts:我把 env 插成了重复键(TS1117),由本批新加的 type-check:e2e 当场抓到
  ——这条闸的价值的又一次现场证明。已合并进既有 env 对象。

待办:全量功能 E2E 终跑(4 project)正在后台,读数与 PR 勾选项的复位随下一笔。
2026-10-17 10:41:57 +08:00
zhangxiang 220ece524d fix(detail): 案例门槛只当了整块开关,未过闸条目仍逐条渲染(fail-open)
第 97 行算了 gateCaseItems、第 105/160 行用 publishableCases.length 决定出现与否,
但第 175 行渲染的仍是 caseStudies.map ⇒ 只要组里有一条过闸,未授权或口径为 target
的案例照样出现在页面上。DEC-N4 声称的逐条 fail-closed 在这里没生效。

- 改为 publishableCases.map。
- 新增 src/components/detail/detail-trust-gate.test.tsx 3 例:过闸的出、
  没过闸的一条都不出(含「有授权但 basis=target」这一维)、全被闸时整块不出现
  且 console.error 逐条喊原因、被闸条目不得占用网格位置。
- 变异验证:把渲染回退成 caseStudies.map ⇒ MUTANT=1(2 条精确转红、1 条仍绿),
  恢复 ⇒ 35 例 EXIT=0。另一处 detail-case-studies-section 复核为已正确使用
  publishable.map,无同类漏洞。

来源:§14 补跑全量功能 E2E 时暴露(本批引入,非基线既有)。
2026-10-17 10:14:49 +08:00
zhangxiang 53c0541c2a docs(qa): §14.1 纯净对照翻转定性——7 条导航红是本批未重锚,非基线既有
基线树配上它自己的 .env 与 seed 数据后重跑同样 8 个 spec:162 passed / 8 failed,
8 条全是 mobile-accessibility.spec.ts:41 的 axe 扫描;而第一次对照(旧代码 + 本批新数据)
报的 7 条导航类红在纯净基线上是绿的。

⇒ 那 7 条是本批引入的 spec 未重锚(§11 改双轴导航时漏掉 mobile.spec.ts、
p2-functional-e2e:99/132、user-journey:56/200、website-acceptance:139),
不是既有红;axe:41 那 8 条才是既有红。p1:579、p4:338/396、触摸目标两条与 @admin 三条
在纯净基线不红 ⇒ 归入本批,须逐条复现后定性,不许用放宽断言或加 retry 换绿。

另记仪器事实:同一份旧代码配不同数据,红项集合完全不同 —— 基线成对状态(代码+数据)
必须一起固定,否则会把自引入的回归读成既有状态;我上一条正是这样读反的,
且错在保守方向(更难被发现)。对照树已恢复原状(删掉临时 .env 与 dev.db)。
2026-10-17 10:11:20 +08:00
zhangxiang fe80e4dcb7 docs(qa): §14 合并后补跑全量功能 E2E,并把 PR #33 里一条不实勾选改回未勾选
本批只跑过 test:e2e:fast + 视觉 + GA4 + 受影响旅程,从未跑过全量 test:functional,
而 #33 的描述把那条链勾成了已过 —— 与 §5.47 同族(引用未成立的读数)。
在 HEAD 0da1fa42 补跑后实取 1032 passed / 36 failed / 44 skipped(24.5m,EXIT=1)。

- 对照:基线 worktree cov-base @ da9a5cb6 只跑其中 8 个红 spec × chromium ⇒ 163 passed / 7 failed。
  7 条与 A 层既有红同位(mobile.spec.ts、p2-functional-e2e、user-journey UJ-01/02、website-acceptance)。
- 混杂自己说破:对照树缺 dev.db 与 .env,是我从本批树拷的当前库 ⇒ 旧代码 + 新数据,
  对依赖导航/内容数据的 spec 不是纯净对照;纯净对照未做 ⇒ B 层不下"与本批无关"的结论。
- 分层登记:A 既有红 / B 待归因(证言区零断言守卫、ARIA 与焦点、触摸目标 ≥24px 硬门禁)/
  C 环境权限类(3 条 @admin 旅程仅 ~170ms 失败)。四条下一步含「把 fast ≠ 全量写进 AGENTS.md §5 口径」。
- PR-DESCRIPTION.md 该项保持未勾选 ⇒ 该文件的 checklist 现在 EXIT=1,是刻意状态;
  本笔另出 PR-CORRECTION.md 作为后续 PR 的描述(checklist EXIT=0)。
- 对照树已清场:拷过去的 dev.db / .env / .env.production 与 WAL sidecar 全删,恢复原状。

复算:tsc EXIT=0、check:package-keys EXIT=0、新描述文件 checklist EXIT=0、旧描述文件 checklist EXIT=1(刻意)。
2026-10-17 10:02:36 +08:00
zhangxiang 0da1fa4255 docs(evidence): §12.13 终版复验的车道脚本与逐名清单、axe 两份证据入库
- run-post-schema-lane.sh:schema 落地后的整链复验编排(build → test:all → axe →
  视觉只读 → GA4 → Lighthouse),取码方式仍是「重定向后读 $?」,不用管道。
- visual-manifest-post-schema.json:total=125 / passed=125 / failed=0,
  由 scripts/visual-manifest.mjs 产出(空日志走 EXIT=2,不与"全绿"同码)。
- axe-evidence:本轮跑闸刷新 2026-10-17-axe/ 与 latest 指针两处,
  这正是 §11.6 那条「证据应按轮次分目录」改造的第一次真实生效。
2026-10-17 09:31:15 +08:00
zhangxiang 699f19ce05 docs(qa): §13 治理闭环——#33 以 fast-forward-only 合入 dev
- 合并方式选 FF 而非 rebase:origin/dev 原 tip 8026d917 是 HEAD 的严格祖先
  (merge-base --is-ancestor EXIT=0),FF 后 47 笔 sha 逐字不变、origin/dev = 6d46dbe8。
  理由同 §10.9:本仓记过 rebase 造成「同标题异 hash」的拓扑分叉之痛。分支未删。
- 422「[Do]: Required」要按字面读:这套 Gitea 的 merge 端点把表单字段 do 当必填,
  补 {"do":"fast-forward-only"} 后 HTTP 200。不是权限、不是缺审批
  (reviews=[]、mergeable=true、draft=false)。另 GET /pulls/n/merge 与 /branches/protection
  在本实例 404 属端点不存在,不得当成「无保护」的证据。
- dev→main 不由代理执行:Jenkinsfile 的部署阶段带 when { branch 'main' },
  合 main = 授权一次无人值守的线上发布;生产侧字段与 navigation 行同形核对随发布做。
- 终版读数一览:tsc / type-check:e2e / check:package-keys / check:visual / check:dead /
  check:motion / build / check:axe / lighthouse 均 EXIT=0;jest 146 套件 1799 例 EXIT=0;
  视觉逐名清单 125/125;GA4 16 passed。PR 描述门禁 checklist EXIT=0(31 子项)。
2026-10-17 09:28:52 +08:00
zhangxiang 6d46dbe81a docs(pr): §12.13 终版复验读数回填(test:all 首跑 EXIT=1 的三把归因读数、逐名对账闭合、Lighthouse 复跑)
- test:all:终版首跑 EXIT=1、同条件复跑 EXIT=0(59 passed / 25 skipped)。
  归因不是「记成 flake 翻篇」:①数据面 —— db:seed 前后逐模型行数与 product 的 slug 集合逐一对账未变;
  ②代码面 —— 单跑该 spec --project=firefox ⇒ 9 passed / EXIT=0;
  ③机理 —— playwright.config.ts:12-15 的 fullyParallel + retries:CI?2:0 + workers:CI?1:undefined
  ⇒ 本地全速并行零重试下 firefox 大页墙钟抖动,CI 侧有 retries=2 + workers=1 兜住。
  没有用放宽断言或加 retry 的方式「修」它。
- 视觉基线:125 = 113 重采 + 12 未重写(具名)与 5 张孤儿参照删除后的恒等式写进读数表;
  终版复验再取的逐名清单 visual-manifest-post-schema.json = total 125 / failed 0。
- Lighthouse:schema 落地后重跑仍 EXIT=0(车道 run-post-schema-lane.sh)。
- 复算以 HEAD 为准:check-pr-checklist EXIT=0(31 子项)、tsc EXIT=0。
2026-10-17 09:26:48 +08:00
zhangxiang fd3e4f9cad docs(pr): 把 §12.12(schema 契约落地 + AUTH-NAV 判定已达成)与四次自报的仪器错配写进 PR 描述
check-pr-checklist EXIT=0(31 子项)。变更摘要补 DEC-N4 的功能性前置已闭合与 AUTH-NAV 的
核查结论;CMS 那条由「不改 content-types、不需 seed」改成「已同步、本地 seed 已验、生产库未动」;
未验证项②从待办改为已闭合,改写为部署期的生产侧同形核对;
假绿灯纪律一条改为逐条列举我自己造成的破坏(§5.44–§5.47 编号四条 + 当场纠正四次)。
2026-10-17 09:00:04 +08:00