worktree-ui-grammar-two-axis
dev
useSearchParams 会让该页预渲染退化为 Suspense fallback ⇒ 改读 window.location。 冷首访 h1:6.0s → 1.5s;另加 warm-routes 预热脚本与 runbook 更新。
承接 #33/#34/#35/#36/#37。本 PR 含两笔:1e80167b(产品与测试侧修复)、7d947fbc(键盘可达性测试的脆性修复 + §14.2/§14.3 台账)。
1e80167b
7d947fbc
§14.1 的纯净对照把 36 条红分成"既有红"与"本批引入",本 PR 把后者逐条修掉:
detail-trust-section
publishableCases
map caseStudies
min-h-6
role="region"
aria-label
@admin
route.test.ts
mobile.spec:45
website-acceptance:139
navigation.ts
consult-button
p4 焦点管理
pollBoundingBox
probe-logo.mjs
nav-keyboard:56
残差(不洗成通过):两次干净全量跑分别是 1067/1 与 1065/3,红项集合互不重合,全是 18–25s 超时类且隔离各自绿 ⇒ 定性为 --workers=4 下的并行墙钟抖动;CI 侧 retries=2 + workers=1 覆盖。本地要稳定复现绿用 --workers=1。PR-DESCRIPTION.md 里 npm run test 一项继续保持未勾选。
--workers=4
retries=2 + workers=1
--workers=1
PR-DESCRIPTION.md
npm run test
N/A:本 PR 是 §14 待办的执行,来源是我自己的合并后补跑与纯净对照。
bash scripts/check-pr-checklist.sh
npm run type-check
npm run type-check:e2e
npm run lint
<a>
check:motion
console.log
TODO
.only()
console.error
[revalidation-failed]
check:dead
detail-trust-gate.test.tsx
jest detail-trust-gate + detail.test
test:e2e:fast
website-acceptance
nav-keyboard
test:functional
npm run test:unit
test:coverage
npm run check:a11y
check:contrast
check:headings
check:brand-token
npm run lighthouse
npm run test:security:headers
qa-tracker.md
lessons-learned.md
test.skip
origin/*
复算读数(本笔 HEAD 7d947fbc):tsc 0、type-check:e2e 0、check:package-keys 0、check:visual 0、check:dead 0、check:motion 0、jest 1804 例 0、test:e2e:fast 59 passed、website-acceptance ×4 56 passed ×2、nav-keyboard 12 passed(变异 1 例红)。
tsc
type-check:e2e
check:package-keys
check:visual
jest
website-acceptance ×4
未验证/未通过项(不沉默)
ContentModel.fields
navigation
Jenkinsfile
when { branch 'main' }
冷首访白屏的第二个真因:/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 成功。
No dependencies set.
The note is not visible to the blocked user.
修复:/contact 冷首访
useSearchParams 会让该页预渲染退化为 Suspense fallback ⇒ 改读 window.location。
冷首访 h1:6.0s → 1.5s;另加 warm-routes 预热脚本与 runbook 更新。
PR:§14.2–§14.3 —— 把全量功能 E2E 从 36 红做到残差抖动,并修掉其中一条真 fail-open
承接 #33/#34/#35/#36/#37。本 PR 含两笔:
1e80167b(产品与测试侧修复)、7d947fbc(键盘可达性测试的脆性修复 + §14.2/§14.3 台账)。变更摘要
§14.1 的纯净对照把 36 条红分成"既有红"与"本批引入",本 PR 把后者逐条修掉:
detail-trust-section渲染绕过门槛(算了publishableCases却仍map caseStudies)⇒ 只要一条过闸,未授权/无 verified 的案例照样上线min-h-6间距刻度);能力面板role="region"缺可访问名(补aria-label)@admin旅程第 11 次登录起必得 429(即"单跑绿、全量红")。额度改为可按环境覆盖,默认仍 10,只在 e2e harness 抬到 500route.test.ts双向用例:未设⇒10;设 3⇒第 4 次判限流。9 例 EXIT=0mobile.spec:45、website-acceptance:139按真源navigation.ts重锚(一级只剩 行业/能力/洞察/关于我们;联系入口是consult-button)p4 焦点管理:webkit/chromium-mobile 上 Tab 不落到链接(Safari 系需系统级设置)。我先前"窗口焦点"假设被自己的读数否掉,改为同契约按引擎取证,断言不减pollBoundingBox先 poll 到非空再单独读一次,hydration 亚 60ms 重挂即误报"元素消失"⇒ 改在同一次读取里既判非空又取值probe-logo.mjs实测;两 spec × 4 project 各 56 passednav-keyboard:56押死"连按 3 次 Tab"⇒ 冷启动/前序用例改变焦点起点就碎。改为有界键盘行走(≤8 次到不了即失败)残差(不洗成通过):两次干净全量跑分别是 1067/1 与 1065/3,红项集合互不重合,全是 18–25s 超时类且隔离各自绿 ⇒ 定性为
--workers=4下的并行墙钟抖动;CI 侧retries=2 + workers=1覆盖。本地要稳定复现绿用--workers=1。PR-DESCRIPTION.md里npm run test一项继续保持未勾选。关联 Issue
N/A:本 PR 是 §14 待办的执行,来源是我自己的合并后补跑与纯净对照。
提交前检查
bash scripts/check-pr-checklist.sh对本描述文件 EXIT=0(读数见「其他说明」)全链路检查
npm run type-checkEXIT=0(复算于本笔 HEAD)npm run type-check:e2eEXIT=0 —— 它在本批内两次抓到真问题(我自己的重复键 env、以及 e2e 既有缺陷)npm run lint:N/A 复跑于本笔 ⇒ 沿用 #33 的 0 error 读数;本批未新增 error 级问题(新代码只加min-h-6/aria-label/测试文件)<a>的最小高min-h-6使首页相关区块增高 1px ⇒ 基线随之重采并只读复跑 125/125)aria-label与min-h-6不涉及色值)check:motion在 #33 已归零且判据按用途在消费点)console.log/TODO/.only():新增console.error只有门槛封条与[revalidation-failed]两类有意信号;check:deadEXIT=0测试分层检查(L0–L3)
route.test.ts新增限流双向用例;detail-trust-gate.test.tsx3 例(含 fail-closed 与逐条隐藏)jest detail-trust-gate + detail.test35 例 EXIT=0;变异验证证明断言有牙test:e2e:fast59 passed;website-acceptance× 4 project 两次各 56 passed;nav-keyboard隔离 12 passed、合跑 68 passedmin-h-6增高后重采并只读复跑 125 passed / 0 failed(逐名清单机制同批上线)test:functional:未 100% 通过(1065–1067 passed / 1~3 残差超时抖动,隔离各自绿)⇒ 已在 §14.3 与 #36 的未勾项上登记,不写成本 PR 已闭质量门禁
npm run test:unit/test:coverage:1804 例 EXIT=0,All files 89.48/88.01/88.14/89.48 ≥ 阈值,阈值未下调npm run test(全量 Playwright):N/A 于"本 PR 是否声明它通过"——本 PR 明确不声明,残差已登记(见上一节末项)npm run check:a11y:EXIT=0(check:contrast/check:headings/check:brand-token);本 PR 的两处 a11y 修复让两条触摸目标 spec 由红转绿npm run lighthouse:EXIT=0(#33 重建装配上取得;本 PR 未改渲染路径之外的样式,除 1px 增高)npm run test:security:headers:EXIT=0;本 PR 未碰响应头/CSP,但动了限流默认值的读取方式(默认值不变,有单测钉)qa-tracker.md§14.2/§14.3、lessons-learned.md(§5.44–§5.47 已在 #33/#36 落)假绿灯纪律
test.skip或提高 timeout 来掩盖origin/*与实测为准:dev 与分支同 sha 已核其他说明
复算读数(本笔 HEAD
7d947fbc):tsc0、type-check:e2e0、check:package-keys0、check:visual0、check:dead0、check:motion0、jest1804 例 0、test:e2e:fast59 passed、website-acceptance ×456 passed ×2、nav-keyboard12 passed(变异 1 例红)。未验证/未通过项(不沉默)
test:functional在--workers=4下仍有 1~3 条超时类残差(跨轮集合不重合、隔离绿);CI 以retries=2 + workers=1覆盖,本地稳定复现请用--workers=1。ContentModel.fields(DEC-N4 新字段声明)与navigation行的同形核对属部署期动作。Jenkinsfile的部署阶段挂在when { branch 'main' },合 main = 无人值守线上发布。