From c7293e24d28ab5e3165c99b4532c50b3a0f6004d Mon Sep 17 00:00:00 2001 From: zhangxiang Date: Fri, 16 Oct 2026 19:29:37 +0800 Subject: [PATCH] =?UTF-8?q?docs(qa):=20=C2=A75.36=20=E5=8C=85=E5=9B=B4?= =?UTF-8?q?=E7=9B=92=E5=88=A4=E6=8D=AE=E5=AF=B9=E5=85=A8=E9=A1=B5=E6=88=AA?= =?UTF-8?q?=E5=9B=BE=E5=BF=85=E5=81=87=E7=BA=A2=E3=80=81=C2=A75.37=20-rgb?= =?UTF-8?q?=20=E5=AD=AA=E7=94=9F=E6=BC=8F=E6=94=B9=E8=AE=A9=E4=B8=A4?= =?UTF-8?q?=E9=81=93=E9=97=B8=E4=B8=80=E8=B5=B7=E5=81=87=E7=BB=BF?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 两条都是本轮落库时查出来的流程债:判据的适用对象要写进判据本身;一个语义有多条表示通道时 守卫必须按定义逐通道对账(新增 npm run check:token-twins)。并记仪器量程:视觉套件缺省 per-pixel threshold 0.1 看不见弱文字转暖,以及 138MB 压在单 commit 会被 Gitea HTTP 413 拦、 须按 project 分块逐笔推。 --- docs/lessons-learned.md | 31 +++++++++++++++++++++++++++++++ 1 file changed, 31 insertions(+) diff --git a/docs/lessons-learned.md b/docs/lessons-learned.md index 157a875..d3277d1 100644 --- a/docs/lessons-learned.md +++ b/docs/lessons-learned.md @@ -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/
` 才推得动(详见 §5.35 同族的"命令报错不等于查无此项")。