docs(qa): §5.36 包围盒判据对全页截图必假红、§5.37 -rgb 孪生漏改让两道闸一起假绿

两条都是本轮落库时查出来的流程债:判据的适用对象要写进判据本身;一个语义有多条表示通道时
守卫必须按定义逐通道对账(新增 npm run check:token-twins)。并记仪器量程:视觉套件缺省
per-pixel threshold 0.1 看不见弱文字转暖,以及 138MB 压在单 commit 会被 Gitea HTTP 413 拦、
须按 project 分块逐笔推。
This commit is contained in:
zhangxiang committed 2026-10-16 19:29:37 +08:00
1 parent a57826f710
commit c7293e24d2
1 file changed
+31
+31
View File
@@ -617,3 +617,34 @@ git config --get-regexp -i "gitea|credential" 2>/dev/null # ← 空
| 2026-10-08 | 增加 §5.33(把「本轮零源码改动」误用成「参照与树同源」⇒ 将 `+30px` 判成运行期漂移;实际旧参照采集树是 `040951c`(09-22),当前树含 `a366bd1`(09-28 第五轮),根因是 Q-6 count-up 动画从 render 体迁入 `useEffect`,旧参照冻结了中间帧。附三条口径:归因须对「采集树 vs 当前树」、基线数量须标「例/张」、裸 `--update-snapshots` 实为 `changed` 模式不重写通过项) | `docs/acceptance/2026-10-08-baselines/{attribution.md,row-diff.cjs}`、`docs/acceptance/qa-tracker.md` §9.4 |
| 2026-10-08 | 增加 §5.34(`deploy.sh` 打印「🎉 部署成功」后线上实为破站:HTML 全 200 而首页引用的 CSS/JS/图标全 404。根因 = nginx web root 需要 `dist/_next/static/**`,而 `next build` 出 `dist/static/**`、`postbuild` 只补 standalone 形态,历史镜像被 `rsync --delete` 抹掉。三条规则:部署后验证须从页面实际引用的 URL 取样并做负对照;`--delete` 目标若被别的流程写入则本脚本须自行重新生成;改产物形态前先确认另一侧契约。附「用 nginx access.log 历史状态码区分我引入 vs 既有」与「`docker inspect` 看真实挂载而非读仓内 compose」两条取证法) | `docs/acceptance/qa-tracker.md` §10、`scripts/deploy.sh` 步骤 1.5 + 资源断言、`docs/deployment.md` §七 |
| 2026-10-08 | 增加 §5.35(把「命令报错」读成「查无此项」:`git config --get-regexp -i …` 因非法开关报错、被 `2>/dev/null` 吞掉,于是把「本环境无 Gitea token ⇒ PR 不可执行」写成连续两轮台账假事实;凭据其实在 Xcode 系统级 `credential.helper=osxkeychain` 里,API 现取 200,PR #29 已建成。三条规则:负命题探测禁止丢 stderr 且要看退出码、凭据发现要用 `git credential fill` / `--show-origin`、写进台账的「不可执行」是最高成本假事实且须附可复跑证伪命令) | `git config --show-origin --get-regexp credential`、`docs/acceptance/qa-tracker.md` §8.5 B / §9.5 B / §10.7 |
### 5.36 判据的适用对象没写进判据:diff 包围盒对全页截图必然假红
视觉基线第一批(只换字标)用「diff 包围盒不得越过页眉底边 y=96」追认,跑完报 15 张越界、diff 延伸到
y=20165,看起来像"改动漏进正文"。真相是全页截图里页眉下方是一块连续内容,**页眉 1px 的高度抖动就让
正文逐行错位**,包围盒必然铺到页底;该判据只对元素级截图成立。
处置:改成**平移感知**判据 `deliverables/logo-redesign-2026-10-13/check-baseline-shift.cjs` —— 先估计正文带
的垂直位移 k(行亮度签名,|k|≤48 逐像素密搜+远场粗搜精修),**候选必须由像素残差复验**(行签名是每行
一个均值的弱信号,合成样本里它给出过等价混叠峰,把该绿的判成红),再在 k 对齐后逐像素比正文重叠带:
残差 ≤0.4% 判绿、以上判"平移解释不了"。`--selftest` 四样本两绿两红(合成图必须做得像截图:白底行+文本带,
逐行随机噪声测的是搜索步长不是判据)。元素级整帧含字标的基线(`header-navigation`)没有"正文"可守 ⇒
按名登记豁免,并反向断言"名单里的名字一张都没变=登记表过期=报红"。
**规则:判据要在文件头写清它成立的对象类型;对某类对象系统性成立的假设,就是一条会误报的判据。**
### 5.37 令牌孪生通道漏改:`check:contrast` 与视觉基线一起假绿
P1 色板迁移改了 `globals.css` 68 处 hex,第二批重跑基线却报 **125 passed / 0 张重写**。这个"0"不是
"色板无影响",而是**色板只落了一半**:43 条 `-rgb` 三元组中 22 条从未迁移(`:root` 11+深色块 11,
色相仍 H 210–217 冷蓝),而 Tailwind 把 29 个颜色键映成 `rgb(var(--X-rgb))` ⇒ **渲染主通道走的是没改的那条**。
同时 `check:contrast` 44/44 全绿(它读 hex)。⇒ 两条纪律:
① 迁移后"0 重写/0 命中"要先怀疑自己漏改,而不是当成"改动无效"或"改动安全";
② 一个语义有多条表示通道时,守卫必须按定义逐通道对账 —— 已新增常驻闸 `npm run check:token-twins`
(按 selector **块内**配对;第一版按全文件最后一个同名 hex 配对,跨明暗两块错配报出 26 条假红;
0 条声明判红、孤儿判红)。修完 43/43 一致,`check:contrast` 44/44、`check:brand-token` 仍绿。
并记一条仪器量程:`e2e/visual-regression.spec.ts` 未设 per-pixel `threshold`,Playwright 缺省 0.1,
`#64748B → #6E675D` 的逐通道距离 (10,13,46)/255 正落在阈值附近 ⇒ **视觉基线在设计上看不见弱文字转暖**,
它守版式与图形不走样;色板到位由 `check:token-twins`+`check:contrast` 分工担保。
另:104 张基线(≈138 MB)压在单个 commit 会被 Gitea 的 HTTP 413 拦下,按 project 拆成 5 个 commit
再逐笔 `git push origin ${sha}:refs/heads/<br>` 才推得动(详见 §5.35 同族的"命令报错不等于查无此项")。