Commit Graph
687 Commits
Author SHA1 Message Date
zhangxiang 009e840fa7 feat(home): 首页 10 段收 8 段(对标段序)+ 透明信任层 + 反伪造成果插槽;SLA 收进单一真源
对标实测的首页段序(Bain:洞察轮播 → 宣言 → 客户成果 → SEE ALL CLIENT RESULTS → 视频 →
Latest Insights → CTA → 招聘;Porsche:video hero → News & Trends → Industry Expertise →
4 实践 accordion → 8 个案例 → AI 专题 → 招聘 → CTA)收敛为:
以编辑内容或客户成果开场、行业成网格、能力做 accordion、成果独立成频道、CTA 安静收尾。
我们 0 案例 / 2 新闻 / 无视频 / 无招聘页,填不了其中两格,所以**取其顺序、换其内容、
并在区块标题里说明换的是什么**(决策 3 零编造透明路线)。

段序 10 → 8
- 合并 HeroStatsBand + TrustSection 为「可审计数字账本」:两段都在说"这是我们的数字",
  是冗余不是节奏。合并后按 label 去重,口径角注取**最弱**的那个 basis。
- 合并 InsightsSection + NewsSection 为「洞察」:本就同轴,且两段各自指向 /news,
  是组件层的竞争真源。
- 新增行业网格(读 solution 模型 6 行)、能力 accordion(4 条 service ⇒ 恰好 4 个实践组)。
- 整块删除 NarrativeSection(与 /methodology 重复,其 text-4xl/5xl font-black 装饰编号
  正是「装饰大字对比度裁决」要防的手法)与 FounderQuoteSection
  (全站唯一 bg-brand-section #8B1530 满幅面;实测两家都是「饱和红只做点缀、
  绝不做页面背景/阴影」,且都没有 CEO 引言带 —— 那是 Accenture 语法)。
- 删除 home-content-v15.tsx(994 行)及其测试:page.tsx 已改渲染 v16,v15 只剩自己的测试
  引用它,属 DEC-P-2 死码族。v15 的 267 行测试里可转移的意图已在 v16 测试中重写;
  其中「挂载持续漂移粒子循环」那条与 CONTEXT.md:81「禁止连续循环动画」自相矛盾,不再延续。

反伪造不变量(本次最实质的内容诚信改动)
- 新增 ResultsSlot:判别式状态 ready | authorized-pending | co-creation | empty。
  ready 必须 verified===true 且 testimonial.author 非空 且 至少一个指标 basis==='verified',
  否则**抛错而不是静默渲染**。为此给 CaseMetric 补了 basis 字段 ——
  它原本没有这个维度,等于给"案例数字"开了个不需要出处的后门。
- CaseStudy 有两份类型(cases.ts 全量 / products.ts 精简),本轮用全量那份;
  类型合并留给组件清理批次。
- 空态必须肉眼可见是空态,读者不会把共创面板误读成客户成果。11 条用例含正对照。

SLA 从四条互斥收进单一真源(闭合台账 DEC-N30)
问题不是"四选一",而是**对象没拆开**:工作日2h / <4h / <2h·7×24 抢的是同一个对象
(响应时间),48h 给的是另一个对象(交付周期)。旧写法在四处各自硬写,所以会漂。
- 新增 lib/constants/commitments.ts:一个 about 只允许一条承诺(用例钉住 + 负向自证)。
- 撤下 <4小时(与 2h 同对象冲突)、7×24(对任何一次夜间延迟都会自破、不可验证)、
  48小时给出初步方案(交付周期不用小时数承诺)。
- 顺带发现 prisma/seeds/services.ts 的三行 dataProofs **完全没有 basis**
  (该文件带 @ts-nocheck,所以没人发现)⇒ 补上 basis,并把该文件里的 <4小时 整行撤下。
- 再查出第五条同类混淆:products.ts:84 的「<2小时」是 CRM 产品能力的设计目标,
  与本公司客服承诺撞脸 ⇒ 不删(对象确实不同、已标 target),改写 description 把对象说明白。

顺手修掉的既有缺陷:home-solutions 与 home-news 两个 zone 在库里确有编排内容,
但 page.tsx 只读 hero/stats/services/cases 四个,这两个整个被丢弃 —— 等于后台在运营一个
页面上不存在的开关。之所以长期无人发现:v15 的 News/Insights 各自 import 了硬编码
NEWS / FALLBACK_INSIGHTS 兜底,把「zone 被忽略」渲染成了「看起来有内容」。
⇒ 兜底在这里起的是**遮蔽**作用而不是降级作用。zone 判定也从 Object.keys(zones).length>0
改成逐键 some(len>0)(home-cases 的 items 是空数组,"有键"不等于"那段有内容")。

三条由真浏览器实测推翻我自己判断的记录(jsdom + tsc 全绿时都看不见):
1. 「账本合并」我原先假设两段同类,实测发现 TRUST_SIGNALS 里 成都/全流程/共创 根本不是数字,
   全按 63px 渲染等于让全页最响的一块装三个名词 —— 恰是对标反对的数据大字报。
   ⇒ 同段内分层:定量走 .text-5xl/500/黑,定性降为 15.75px 小字行。
2. data-testid 挂到 StaggerReveal 上会被静默丢弃 —— 真实组件解构固定 prop 列表、不透传,
   而我的 mock 透传了 ⇒ 单测绿、线上找不到该容器。典型的「mock 比实现宽松」。
   ⇒ 本轮把 testid 移到外层普通 div(grid 类仍留在 StaggerReveal 上,Q-5 的教训),
     props 透传本身留给组件清理批次统一做。
3. 我在一次 Edit 里重复定义了 toLedger —— **tsc EXIT=0、jest 1834 例全过,Turbopack 却报
   「name is defined multiple times」把整页打挂**。TS 允许同名函数重声明,所以类型检查
   和单测都不代表能构建。⇒ 本批补跑 npm run build(EXIT=0,/insights 静态预渲染在场,
     并显式核对 dist/static + public 已拷入 standalone,即 N-9 那个"缺资源 Lighthouse 仍
     exit 0"的坑)。

视觉语法在首页的落地(实测浏览器读数,dark 主题):
- h1 81px / 字重 700 / **border-radius 0**;hero CTA radius 0、#C41E3A 底、15.75px、
  字重 500、**box-shadow: none**(彩色光晕已退役)
- 成果数字 63px / 字重 500 / 纸白(对暗底对比度实测 17.45:1)
- 一级导航渲染为 行业 / 能力 / 洞察 / 关于我们;移动端 tab bar 首页·行业·能力·洞察·联系
- HeroParticleField 已不在 DOM(data-testid 查询为 null)

配套门禁调整(都是让闸更准,不是放宽):
- metrics-basis 的禁词扫描器现在先剥注释(保换行 ⇒ 行号仍准)。理由与 check:grammar 同一条:
  解释「为什么禁用这句话」的注释里最容易出现这句话本身;不剥只剩"改措辞绕闸"或"闸常驻红"两条坏路。
  已双向验证:禁词塞进 JSX 文案 ⇒ 抓到并报 results-slot.tsx:130;恢复 ⇒ 16/16 通过。
- REQUIRED_ANNOTATED_SOURCES 的 home-content-v15 路径改为 v15 的替代者(否则该用例 ENOENT 而"红得没道理")。
- CONSULT_CTA_ALLOWLIST 登记「成为首批共创客户」并写明理由(白名单就是为可解释例外存在的,
  已有同族的「了解共创合作」)。

KNOWN-RED: test:visual —— 首页段序换、导航 7→4、页脚三栏改标题与取数、tab bar 换轴、
CTA 去胶囊与箭头、卡片去 hover 抬升,页面级基线大面积 churn。按计划 #10 在代码全部落地后
一次性重捕(需 AUTH-VISUAL),再跑只读 --update-snapshots=none 作为真门禁。

门禁实测:type-check EXIT=0 · **npm run build EXIT=0** · 全量 jest 148 套件 / 1834 例通过 ·
eslint --quiet 0 error · check:grammar 9/9 + selftest 9/9 · token-twins 44/44 ·
contrast 44/44 · brand-token 0 违规 · check:motion 22(未新增违规)·
dev 真实渲染:/ 与 /insights 均 HTTP 200,八段与页脚四栏链接数实测非空
2026-10-16 21:00:43 +08:00
zhangxiang 7d1a22a596 feat(ia): 一级导航改对标双轴(行业 × 能力 + 洞察),并把导航真源从 DB 行反转为代码
依据实测:Bain 一级导航 = Industries · Consulting Services · Digital · Insights · About · Careers,
Porsche = 行业 · 实践 · 洞察 · 职业 · 关于我们 —— **两家的导航里都没有「产品」**。
咨询业按「客户的问题空间 × 本所的能力」组织,不按产品 SKU 组织。本仓此前 7 项里
产品居首,且 案例(case-study 0 行)、新闻动态(2 行) 是挂在骨架上的空渠道。

落地策略是**换标签、不换路由**:行业→既有 /solutions(solution 模型本就是行业),
能力→既有 /services(service 模型的 4 行本就是能力组)。
理由不是省事,而是避免制造重复内容:若新增 /capabilities 与 /services 并行,
同一个 ContentItem 会同时挂在两个 URL 下 —— 那是 canonical 冲突,比不改更糟。
URL 改名 + 308 留给第二批一次性处理。唯一真正新增的面是 /insights:
它聚合 news + methodology + case-study,今天没有任何单一页面做过这件事,故不构成重复。

「轴 = 视图,模型 = 真源」:本轮零新 ContentModel、零 schema、零 seed 权限测试改动。
沿用 solution/service/product 三个 code ⇒ src/lib/seed-permissions.test.ts:50 的
SUPER_ADMIN_ONLY_MODELS 断言保持绿。**这是设计选择的回报,不是没做事。**

最关键的一处:反转导航优先级
  layout.tsx 原为 `(navData?.mainNav) || NAVIGATION_V2` —— **DB 行胜出、代码只兜底**。
  `navigation` 的字段是泛型 json,改导航不需动 schema,听起来省事,实际是:
  只改 navigation.ts 会上线一个**生产静默忽略它**的新导航。
  而 footer 按 megaDropdown 的 key 取栏目 —— 新代码 key 对旧 DB key ⇒ 页脚三栏静默变空。
  我在工作树里真的复现了这个状态:本地 navigation/default 行仍是旧 7 项,
  它**内部完全自洽**(每个 dropdownKey 都找得到面板),所以「自洽即放行」会继续覆盖代码。
  ⇒ 新校验器的标准是「它是不是这套 IA」(必须覆盖 industries/capabilities/insights 三轴),
    而不是「它是不是合法 JSON」。不合格则 fail-closed 到代码 + 把原因 console.warn 出来
    (渲染期不写库:Notification 是后台数据,在 RSC 里写它等于给每次首页渲染挂写副作用)。
  这条有专门用例:「旧 IA 的自洽配置必须被拒」。

顺带修掉两处同族缺陷
- injectStandaloneProducts 原按 `key === 'products'` 匹配;双轴改名后该 key 不存在 ⇒
  独立产品会**静默不再注入**。改为按组 id(STANDALONE_GROUP_ID)找,组 id 比 key 稳定。
- 激活判定原来有**三套**:header 的 8 分支 per-id 阶梯(末尾落回 pathname===`/${item.id}`,
  新 id industries 会拼出一个不存在的路由 ⇒ 行业永不高亮)、mobile-tab-bar 的 per-id
  if 阶梯(改名后每项静默返回 false ⇒ tab bar 照渲染、永不高亮 = 绿但空洞)、footer 自一套。
  现统一为 lib/nav-active.ts,按 segment 切(不被 /solutionship 这类同前缀误点亮)。

撤下两个空渠道入口(含一处我自己计划里的回退,已当场纠正)
- /cases 从一级导航与移动端 tab bar 撤下:case-study 0 行,点进去是空列表。
  路由与模型**保留休眠**,真实授权案例到位当天即可渲染,不必二次迁移。
- 补 { id: 'all-products', href: '/products' } 进能力轴第二层:
  撤「产品」时若不补这一条,/products(sitemap priority 0.9、6 个详情页的上游 hub)
  就变成**没有导航入口的孤儿页** —— 那是回退不是重构。「降级」不等于「消失」,
  已加守卫用例「被退出一级导航的 hub 必须在第二层仍可达」。

/insights 的三处登记(少一处就是「新页面没人扫、门禁仍然绿」的静默覆盖收缩)
- sitemap.ts:新增,priority 0.8;/news 暂留(已索引),第二批 301 归并
- check:headings 的 PAGES 列表:新增(该列表是硬编码路由清单)
- revalidate:新增 INSIGHTS_AFFECTED_MODELS(news/case-study/methodology)
  —— /insights 不在 CONTENT_TYPE_CONFIGS 的任何 listPage 里,通用推导只刷 /news、
  /methodology;少登记这条的后果不是报错,而是后台发了新内容、洞察页仍端出旧 ISR
  快照最长 1 小时,且没有任何门禁会红。已钉 3 正向 + 1 负向(product 变更不得刷
  /insights,否则该断言恒真、失去约束力)+ 1 去重。

删除 NAVIGATION(V1):7 个 href 全是 '/'、全站零生产引用,只被 constants.test.ts 供着 ——
那 4 条用例的作用是让死码看起来「有人在用」。已改写成断言活的 NAVIGATION_V2,
并保留其原有意图(每个目的地互不相同,正是 V1 缺的那条)。

KNOWN-RED: test:visual —— 一级导航 7→4、页脚三栏改标题改取数、移动端 tab bar 换轴,
header/footer 相关基线预期 churn。按计划 #10 在所有代码落地后一次性重捕(需 AUTH-VISUAL)。

待授权(本笔**未**执行,且必须执行才能对用户生效):
  CMS 的 navigation/default 行仍是旧 7 项。本笔的反转校验会让它 fail-closed 到代码,
  所以**新导航会立即在页面上生效**(不再被旧行遮蔽),但后台那一行要改需
  `npm run db:seed`(生产为独立授权动作)。seed.ts:945 直接引用 NAVIGATION_V2,
  重跑即得新行 —— 本地已复跑验证过(库内 mainNav 已是 industries/capabilities/insights)。

门禁实测:type-check EXIT=0 · 全量 jest 146 套件 / 1807 例通过 ·
eslint --quiet 改动文件 0 error · check:grammar 9/9 及其 selftest 9/9 ·
check:token-twins 44/44 · check:contrast 44/44 · check:brand-token 0 违规 ·
e2e nav-keyboard@chromium 6 passed(含 /insights 实测 HTTP 200)
2026-10-16 20:34:34 +08:00
zhangxiang e9bd965411 fix(nav): 「查看全部」不再靠中文标签反推路由,目的地改由导航项自身 href 提供
原实现(mega-dropdown.tsx:168):
  href={`/${label === '产品' ? 'products' : label === '解决方案' ? 'solutions' : 'services'}`}
第三个及以后任何标签都**静默落到 /services**。

为什么必须在 IA 改名之前修:改名前这个缺陷表现为一个刺眼的不合理跳转,很容易被发现;
改名后 /services 这条路由依然存在(本轮刻意不做任何 rename),于是它退化成一个
「看起来完全合理的错误目的地」—— 那类最难查的 bug。

- props 新增 viewAllHref;缺失时**整块不渲染**该链接(宁可少一个入口,不给错目的地)
- header.tsx 把 item.href 传下去(非下拉分支 :145 本来就用同一个值,两分支现已同源)
- 顺带把两处裸时长收进令牌:duration-200 → duration-hover、framer transition 补 ease-ink

单测(mega-dropdown.test.tsx,5 条新用例)已实测能失败:
修复前 4 failed / 5 passed,其中「产品→/products」那条通过正是
「防修一个坏一个」的基准 —— 它证明旧实现在前两个标签上确实是对的。

e2e(nav-keyboard.spec.ts,2 条 @a11y)是**浏览器层**负对照:单测只能证明组件契约,
「header 有没有真的把 href 接上」只有真实渲染看得见。
已实测该用例能失败:摘除 viewAllHref 传递 ⇒ 立刻判红「下拉「产品」没有渲染「查看全部」链接」,
恢复 ⇒ 2 passed。另含两条不变量:分母必须等于已登记的下拉数(新增导航项忘登记即判红,
不会"少测一个"悄悄放行)、各下拉目的地必须互不相同(原缺陷的表现形式正是多个标签塌到同一个
/services)。

首跑踩到本文件 :21-29 已记录的 dev/Fast Refresh hydration 竞态 —— click() 打在
hydration 后被整体替换的旧节点上、aria-expanded 恒 false。按仓库既有配方改为
把**交互本身**放进 toPass 重发,而非只重读断言。

门禁:type-check EXIT=0 · eslint --quiet 0 error · jest src/components/layout 全过 ·
e2e nav-keyboard@chromium 2 passed
2026-10-16 20:14:19 +08:00
zhangxiang 81daedbea1 feat(tokens): 视觉语法收口到对标实测——圆角 0–4 记档、彩色阴影退役、卡片去 lift
依据是实测而非口味。Bain & Company(archive 快照 2026-08-31, 1600×846)与
Porsche Consulting(live 国际站)的 getComputedStyle 抽样收敛到同一条:
**两家全站 border-radius 均为 0**,且面/字色近乎单色
(Bain 字色仅 #000/#FFF/#CC0000/#767676;Porsche 面色 #FFF/#000/#D6001D/#F2F2F2,
红出现 4 次且全部是按钮底、无一次是阴影或背景)。本仓此前的「中度软化」
3→32px 八档 + 三枚品牌红阴影 + 卡片 hover 抬升,三件全是对标没有的语法。

本轮按「借语法、不借色相」执行:保留 #C41E3A 色相与朱砂条,只收口形状与层次。

圆角
- --radius-xs/sm 3/6→0、md/lg 8/12→2、xl/2xl/3xl 18/24/32→4,新增 --radius-cta: 0
- **--radius-full 保持 9999 不动**:它承载真圆(avatar/switch/slider/radio-group/
  progress/scroll-area/skeleton),一并归零会把所有旋钮与头像方角化。这条是
  check:grammar R2/R9 的正向守卫 —— 刻意做成「仪器坏了它仍要失败」的那一维
- --badge-radius 由 var(--radius-full) 改指 var(--radius-cta)(实测该令牌零消费者,
  留档不复用,删除动作留给死码族 DEC-P-2 统一处理)
- button.tsx 的 sm/default/lg/xl 走 rounded-cta,icon 档保持 rounded-full(功能形状)

彩色阴影
- --shadow-brand / --shadow-brand-hover / --shadow-glow 三枚退役(实测前两者仅 2 处、
  后者 0 处消费者),消费方回落中性档
- 同批发现并修掉一处暖化漏网:阴影基色仍是冷墨 rgba(10,14,20,α)=#0A0E14,
  而暖墨 #141210 早已落地 —— globals.css 16 处 + 业务 2 处。check:token-twins 抓不到它,
  因为阴影是字面量 rgba、没有 -rgb 孪生兄弟可对照

卡片
- .bain-card hover 去 translateY(-4px) 与阴影增长,改为 hairline→rule + 底色微移
- --card-shadow-hover / --card-transition 随之退役(前者仅 :hover 消费、后者零消费者)

新增信息线令牌 --color-border-rule #8A8377
hover 边框是「告诉用户这个可交互」的信息,按品牌 P4 三档拆分不能用界灰 #C3BDB1
(实测对卡底仅 1.78,不达非文本 3:1)。#8A8377 由我自己算:对白 3.75、对纸 #FBF9F5
3.57、对暗底 #141210 4.89 —— 两主题都过 3:1,且 -rgb 孪生已同步(44/44)。

动效
- 补 --transition-hover: 150ms 并接进 Tailwind duration 档。动效四原则 CONTEXT.md:76
  早就写了 hover 150ms,仓库从来没有这个档(BRAND-MANUAL §6 冲突 C-1)。
  抬升与光晕去掉后 hover 成了唯一的可交互提示,没档可用等于语法自相矛盾
- cta-button 的 transition-all duration-200(裸字面量)一并改为 transition-colors duration-hover

CTA 两轨(实测尺寸之间取值:Bain 20/32+14px、Porsche 13/24+16px → px-7 py-3.5 + text-sm/500)
- 实心/描边两轨都直角;不做 text-transform(中文无大小写)、不补字距(Bain 实测
  letterSpacing: normal,它的大写感来自全大写本身)
- 箭头只保留在 inline 文字链轨:两家按钮实测都是纯文字
- 描边轨静止边框用 border-border-rule,不用 ink/20(≈1.54 不达 3:1)
- 改动半径实测:63 处 <CTAButton> 调用,其中 36 处不写 variant ⇒ 落默认 primary,
  24 处 secondary、3 处 dark、0 处 inline

新闸 npm run check:grammar(9 条规则)+ check:grammar:selftest(9/9 双向自证)
- 闸只看代码:扫描前统一剥注释。不剥的话,解释「为什么退出 rounded-full」的文档注释
  本身会被判红,于是只剩两条出路 —— 改措辞去绕闸(应试,闸就此失去解释力)或把闸调瞎
- 每条规则报分母;分母为 0 ⇒ exit 2 判「未能度量」,不算通过
- 退出码分档 0/1/2,避免闸自身崩溃与判红共用 exit 1 而吞掉同批已算好的打印

顺带删死码 hero-section-v2.tsx(200 行、单一导出、全站零生产引用,仅被自己的 3 个测试
dynamic import)+ 那 3 个测试。留测试会让死码继续占覆盖率分母,并被误读成「有活在跑」。

KNOWN-RED: test:visual —— 全局令牌改动没有"爆炸半径"可言,页面级 130 张基线预期全部churn。
按计划 §10 只在 #3–#9 落地后一次性重捕(需 AUTH-VISUAL 单独授权),不按笔重写以免归因失效。

门禁实测:type-check EXIT=0 · check:grammar 9/9 · check:grammar:selftest 9/9 ·
check:token-twins 44/44 · check:contrast 44/44 · check:brand-token 0 违规 ·
check:motion 23→22(--transition-* 采集数 6→7,假红已消)· 全量 jest 143 套件 / 1769 例通过
2026-10-16 20:02:11 +08:00
zhangxiang d346301405 fix(gates): check:motion 的 CSS 解析器不剥注释,会把紧随其后的令牌整条吞掉
extractCssDeclarations 的声明正则值部分是 `[^;{}]*`,天然跨行、一路吃到下一个 `;`。
它原先不剥注释,于是当一条令牌定义前面有一段含 **ASCII 冒号**的块注释时(例如注释里写
`CONTEXT.md:76`),正则会先从注释里的 `md:` 起匹配,把「注释余文 + 紧随其后的整条
`--transition-hover: 150ms;`」一起吞进 value 捕获组 —— 该声明根本没被采集。

后果不是少个数,是**假红**:R3 随后对着一个明明已定义的令牌报
「引用了未定义的 --transition-hover 令牌(编译后不生效)」。假红比假绿更贵,
它教会人无视这道闸。

发现方式:本批给 globals.css 加 --transition-hover 档时,闸报 `--transition-* 令牌 6`
而 `:root` 里实有 7 条,且判定分母对不上 —— 逐条核对才定位到解析器而非 CSS 写错。

- 新增 stripCssComments:整段替换为**等量换行**,故 lineOf 报出的行号仍指向原文件那一行
  (行号错位 = 判据不可行动,等同半个假绿)
- 配套回归用例是双向的:断言采集数 == 实际定义数(4),且注释在/不在时判定必须一致
- 已实测该用例能失败:摘掉修复 → Expected 4 / Received 3;恢复 → 20 passed

门禁:check:motion:test 20/20(原 19 + 新增 1);type-check EXIT=0;
全量 jest 143 套件 / 1769 例通过。
2026-10-16 20:01:20 +08:00
zhangxiang da9a5cb650 fix(visual): 判据仪器 selftest 调用点被全局替换误改,闸自己崩溃
加元素级豁免时把主循环的调用点改成了两参数,同一次全局替换也命中了 selftest 循环里的调用,
而那里没有 rel 变量 ⇒ ReferenceError,--selftest 以非零码退出。这是「闸自身崩溃与判红共用
EXIT=1」那一族:崩溃看起来像判红,而这次连红都是假的。selftest 改传样本名,恢复四样本
两绿两红、EXIT=0(合成样本名不含 header-navigation,不会被元素级正则命中)。
2026-10-16 19:31:21 +08:00
zhangxiang c7293e24d2 docs(qa): §5.36 包围盒判据对全页截图必假红、§5.37 -rgb 孪生漏改让两道闸一起假绿
两条都是本轮落库时查出来的流程债:判据的适用对象要写进判据本身;一个语义有多条表示通道时
守卫必须按定义逐通道对账(新增 npm run check:token-twins)。并记仪器量程:视觉套件缺省
per-pixel threshold 0.1 看不见弱文字转暖,以及 138MB 压在单 commit 会被 Gitea HTTP 413 拦、
须按 project 分块逐笔推。
2026-10-16 19:29:37 +08:00
zhangxiang a57826f710 docs(brand): 品牌全案手册与落库证据入库(判据、门禁、负例都在场)
BRAND-MANUAL.md 收敛识别方案裁定与实测判据;TOKEN-MIGRATION.md 记 P1/P3/P4 迁移面与孪生缺陷;
TEST-PATCH.md 记 P7 的 1→0 实测。随包入库的是结论赖以成立的仪器与证据:check-assets、check-manual、
verify-assets-cross、check-wordmark-copies、check-docsync、check-probes(四段闸,每段带能失败的负例)、
check-baseline-shift.cjs(平移感知基线判据,四合成样本两绿两红自测通过;它取代被证伪的
「diff 包围盒不许越页眉带」)与 measured/baseline-shift-p1.json(第一批 104 张逐张分类,带 _src 出处戳)。

大体积工作件不入库:样机 HTML 与栅格截图 100+MB、字体母版 45MB 留在盘上,入库 690 个文本/矢量件。
2026-10-16 19:23:28 +08:00
zhangxiang dd8ee80b97 feat(theme): 中性色转暖落地(含 -rgb 孪生通道),挂上孪生一致性闸
P1:globals.css 68 处中性色转暖,深通道按「保 L、色相→33°、S≤0.14」算;P4 弱文字分三档
(装饰线 #C3BDB1/非文本信息 #8A8377/正文级 #6E675D);P3 三个深底红收敛为 #E9455F(对暖墨
#141210 实测 4.88:1)。14 处彩性蓝按裁决故意不动。P2:public/fonts/ 放思源宋体可变子集 388.1KB
(cmap 回读 0 缺字)+两份 OFL 1.1 正文,--font-serif 队首插入 Novalon Serif SC,系统兜底全保留。

落库时查出并修一条真缺陷:43 条 -rgb 三元组有 22 条从未迁移(:root 11+深色块 11,色相仍 H210-217),
而 Tailwind 有 29 个颜色键经 rgb(var(--X-rgb)) 消费 ⇒ 渲染主通道还是冷的;当时 check:contrast 44/44
全绿(读 hex)、视觉套件 0 张重写 ⇒ 两道闸一起假绿。按「孪生等于同块 hex」对齐 22 条并新增常驻闸
npm run check:token-twins(0 条判红/不等判红/孤儿判红),复测 43/43 一致。
2026-10-16 19:23:25 +08:00
zhangxiang 723a3d0c20 docs(brand): 澄清书法字标与正文用字的边界,并闭合 P7 的空断言
DESIGN.md 原写「中文靠字族回退,不用书法制造文化氛围」并把 --font-brand 楷体标为新页面禁用,
而锁定的字标本身就是书法真迹 ⇒ 条款限定到正文用字并另立字标例外。CONTEXT.md 原说保留「Logo 中的
书法『睿』字」,现行是名=睿新致远四字真迹、「睿」单字是简标 ⇒ 改正。
e2e/p1-brand-visual-audit.spec.ts 的 <text> 遍历对新资产目标数为 0 ⇒ 补成两支都有非零目标数的断言。
2026-10-16 19:23:23 +08:00
zhangxiang 40ad8cdcda chore(visual): chromium-mobile 基线随字标落库重写
按 --update-snapshots=changed 重写;逐张过 check-baseline-shift.cjs(平移感知判据)分类,
末态在只读复跑 --update-snapshots=none 下 125 passed / 0 failed / 0 重写。
2026-10-16 19:23:21 +08:00
zhangxiang 2e7bcf01da chore(visual): webkit-desktop 基线随字标落库重写
按 --update-snapshots=changed 重写;逐张过 check-baseline-shift.cjs(平移感知判据)分类,
末态在只读复跑 --update-snapshots=none 下 125 passed / 0 failed / 0 重写。
2026-10-16 19:23:20 +08:00
zhangxiang c0cf9eb46d chore(visual): chromium-tablet 基线随字标落库重写
按 --update-snapshots=changed 重写;逐张过 check-baseline-shift.cjs(平移感知判据)分类,
末态在只读复跑 --update-snapshots=none 下 125 passed / 0 failed / 0 重写。
2026-10-16 19:23:18 +08:00
zhangxiang 4d8c023b0d chore(visual): firefox-desktop 基线随字标落库重写
按 --update-snapshots=changed 重写;逐张过 check-baseline-shift.cjs(平移感知判据)分类,
末态在只读复跑 --update-snapshots=none 下 125 passed / 0 failed / 0 重写。
2026-10-16 19:23:16 +08:00
zhangxiang 0dd49ef5ba chore(visual): chromium-desktop 基线随字标落库重写
按 --update-snapshots=changed 重写;逐张过 check-baseline-shift.cjs(平移感知判据)分类,
末态在只读复跑 --update-snapshots=none 下 125 passed / 0 failed / 0 重写。
2026-10-16 19:23:15 +08:00
zhangxiang ff7f7df5b3 feat(brand): 字标与 favicon 全套落库,同修 header/footer 的尺寸声明
替换 public 标识资产为已锁定的品牌字标(名=睿新致远四字真迹,简标=白文「睿」),重做 favicon
全套(16px 专用几何+补 48x48 缺失档),删除三个陈旧变体。新横排名 viewBox 比 2.663(旧 4.000),
两处 <Image> 用 w-auto 按高定宽 ⇒ 尺寸声明同批改:header.tsx width 160→106 ×2、footer.tsx
180→120 ×1。文件名全部不变,layout.tsx 四个 favicon link、structured-data.tsx 的 logo URL、
header.test.tsx 的 src 断言均无需改动(逐个核过)。
2026-10-16 19:23:08 +08:00
zhangxiang 8026d91759 docs(qa): §10.9 治理闭环——#29 以 fast-forward-only 合入 dev,#30 开向 main
选 FF 而非仓库默认 rebase:dev 是 HEAD 的严格祖先,FF 后 15 笔 sha 逐字不变,
避免本仓 AUTH-D1 记过的「同标题异 hash」拓扑分叉。#30 描述里显式标注
「合并即触发 CI 生产部署」与三条 CI 侧风险,是否点合留给决策人。
2026-10-08 18:22:39 +08:00
zhangxiang 104ec7db07 docs(release): 第二次发布记录与发布链修复的端到端验证
- 新 BUILD_ID HCvsEIztksM1GCWBJBrRP 上线;步骤 1.5 生成的镜像使 verify_remote
  的六项资源级断言在真实部署中全 200 —— 破站路径已由脚本自身堵住,不再靠人工复核
- 线上首页引用的 chunk 逐个回查本地产物确认同源;Playwright 三页 0 失败资源、0 控制台错误
- 证据补 deploy-2.txt 与可复跑的 probe.mjs
2026-10-08 18:05:10 +08:00
zhangxiang 2917416ff5 docs(qa): 撤销 K 项——navigation/site-config 无授予是刻意的站点级独占,非 seed 缺口
prisma/seed.ts:241-242 注释写明这两个模型仅 super_admin 可维护,
src/lib/seed-permissions.test.ts:18-19,50 用 SUPER_ADMIN_ONLY_MODELS 双向钉住。
我上一笔只看了 permissionMatrix 里没有就判为覆盖缺口,违反本仓 lessons §5.32
已立的「按缺推断机制不存在须给三条证据」规则,就地作废并留痕。
2026-10-08 18:02:30 +08:00
zhangxiang c0c41eb528 chore(release): 生产 seed 与 compose 漂移闭环、回滚重建容器、PR #29 与发布证据入库
- AUTH-D2 生产 db:seed 已执行:esbuild 打包真 seed → 生产库副本演练 → 逐表差异
  (Permission +63/−0、ContentItem 37→38、24 条随 seed 源更新、User 口令逐字节未变)
  → 停容器窗口内用生产镜像跑 → 事后取回比对。快照 prod.db.bak.20261008_174734-preseed
- H compose 漂移已消除:先 diff 证明只差挂载一行,备份后同步并重建,
  docker inspect 现取 ./uploads -> /app/public/uploads
- I cmd_rollback 追加 docker-compose build && up -d 与就绪轮询,并复用资源级 verify
- J PR #29 建成(qa/seal-2026-09-28 → dev,mergeable true);同时作废「本环境无 Gitea
  token」这条由 `2>/dev/null` 吞掉报错造成的假事实,教训入 lessons §5.35
- 新登记 K:navigation 与 site-config 在 seed 的 permissionMatrix 里无授予项
- 证据:docs/acceptance/2026-10-08-release/(build/deploy/type-check/lint 日志、
  seed 演练与逐表差异脚本及输出)
2026-10-08 17:58:21 +08:00
zhangxiang 81bdeebc64 docs(qa): §10 生产发布记录与事故复盘 + deployment §七 web root 契约 + lessons §5.34
- §10:发布内容/序列(build EXIT=0 → 真 prod.db 副本预生产演练 14 路由全 200 →
  prod.db.bak.20261008_173048 快照 → dist_backup_20261008_173111 → DEPLOY_EXIT=0)
- §10.2:本次部署引入的回归与恢复(≈4 分钟),并用 nginx access.log 现取 10-07
  同一 URL 为 200 的证据把回归定性为自己引入而非既有状态
- §10.4:Playwright 三页线上健康证据(stylesheets=2、品牌红命中、4xx/5xx GET=0、
  console error=0)
- §10.5:发布后仍未闭合项,含 AUTH-D2 的真凭据——prod.db 里 Permission.modelCode
  仍是旧码 team/legal(各 11 条授予)而 ContentModel 已是 team-page/legal-page/
  contact-page 等 16 个模型;并列出三条 seed 执行候选与建议
- deployment.md §七:两种产物形态的契约、镜像生成命令、回滚须连容器一起、
  compose/Dockerfile 从不同步导致的挂载漂移
- lessons §5.34:三条规则 + 两条取证法 + 管理归零(预生产演练、资源级门禁)
2026-10-08 17:41:36 +08:00
zhangxiang 722f08a159 fix(deploy): 上传前生成 nginx web root 镜像,并把部署验证升级为资源级断言
2026-10-08 生产事故:deploy.sh 打出「🎉 部署成功」而线上 CSS/JS/图标全 404。
根因是 nginx 站点根就是上传后的 dist/(nginx-static-production.conf:132 的
root /var/www/novalon + :136-142 的 try_files $uri =404),要求磁盘上存在
dist/_next/static/**;而 next build 出的是 dist/static/**,postbuild 只补
standalone 容器形态。历史镜像由旧流程产出,被本次 rsync --delete 抹掉。

- 步骤 1.5:上传前本地生成镜像(dist/static → dist/_next/static、public/. → dist/),
  dist/static 缺失即终止部署而非静默继续
- verify_remote:从首页 HTML 实际引用的 URL 取前 5 个 /_next/static/*.{js,css}
  加 /favicon.ico 逐个断言 200,任一非 200 即 return 1。负对照实测:换成不存在
  的取样 URL ⇒ RED 404 且 failed=1,断言可失败
- 只查五个 HTML 路径的门禁,在破站状态下会判绿——这是本次事故的直接放大原因
2026-10-08 17:41:35 +08:00
zhangxiang 19079e189d docs(qa): §9.5 F 行回填为已推送,抬头改为与 origin 同步并去掉笔数自指 2026-10-08 17:19:09 +08:00
zhangxiang 6c9900ffed docs(qa): 视觉转绿后的四处文档同步,并更正 quality-gates 的 -u 模式假事实
- quality-gates.md §6.2:原文称裸 --update-snapshots 取 missing,实为 changed
  (program.js:202 preset);missing 是完全不带旗标时的缺省(common/index.js:584)。
  两种触发条件差异改写,读数补 125/0 与「例数 ≠ 张数」「归因须对采集树 vs 当前树」口径
- docs/testing.md:参照计数 107→132(每 project 21→26),原「用例数−参照数=覆盖空洞」
  算式已不成立,改为三个 shot 归组来源;N-15 空洞标注已闭合
- README.md:撤下「视觉 94/31」现行口径(改历史 + 125/0),例外清单移出视觉基线,
  新增 2026-10-08 轮次条目,台账指针 §8→§9
- qa-tracker 新增 §9.6:本树一手复测 type-check EXIT=0 / lint 0 error 104 warning
  (此前 PR 引用沿用他轮读数,不满足「命令实际执行过」条)+ 四处同步清单 +
  PR 描述 .pr-seal-2026-10-08.md 过门禁 EXIT=0
2026-10-08 17:18:06 +08:00
zhangxiang bcd32b3784 docs(qa): 台账领先关系与未推集合改为现取式表述,消除自指计数
本文件所在提交本身会让「领先 N 笔」过期(§8.5 A 行就因这个失效过一次),
改为给出取数命令;本轮链以 sha 序列明示,HEAD 与未推集合标注现取方式。
2026-10-08 17:04:12 +08:00
zhangxiang c66dfcac26 docs(qa): 基线判红归因改判,作废「运行期漂移」初判并补 lessons §5.33
台账 §9.4 初稿把 chromium-mobile 两页 +30/+21px 记为「零源码改动 ⇒ 只能来自
运行期」,参照系用错:旧参照的采集树是 040951c(09-22),当前树含 a366bd1
(09-28 第五轮),参照比树旧了一个修复轮次。

- 实测归因:row-diff.cjs(sharp 逐行比对)定位发散行 y=7440 落在 /products/erp
  的 benefits 段;git diff 显示 Q-6 把指标 count-up 从 render 体迁入 useEffect
  并加取消 ⇒ 旧参照冻结的是动画中间帧,新参照是稳定终态,属预期改进
- 排除数据侧:prisma/seeds/products.ts 在该窗口零改动
- 三条口径落到 lessons §5.33:归因须对「采集树 vs 当前树」;基线数量须标「例/张」
  (本轮 38 张 = 31 例);裸 --update-snapshots 实为 changed 模式,不重写通过项
- §9.5 的 G 项就此关闭,取证脚本随证据目录入库
2026-10-08 17:03:24 +08:00
zhangxiang 6ba4b70a0c docs(qa): 台账 §9 记录基线入库轮次并回填 §8.5 授权状态
- §8.5:A 已推(a0328a6..1396666)、D 已执行(6ff19d1)、E 本轮不动且其前提部分失效
- 新增 §9:授权→执行→读数矩阵、三条新事实、逐张读图核看、自证循环处置、更新后的待授权清单
- 关键新事实:裸 --update-snapshots 实读为 changed 模式(program.js:202),故 13 张覆盖全是真判红
- 口径澄清:38 张文件 = 31 例(一例多 shot),历轮「20+11」是用例级读数,登记基线数须标口径
- N-15(b) 的 card/input 选择器实测已在树内修好(三重钉住 + 蜜罐契约断言),healer 对这两例不再必要
- 抬头改判:视觉门禁由 94/31 EXIT=1 升为 125/0 EXIT=0,参照现取 132 张在库
- 残留风险登记:chromium-mobile 两页 +30/+21px 未归因,列为 G 项只读取证
2026-10-08 16:58:32 +08:00
zhangxiang 6ff19d1dd4 test(visual): 补齐 20 例缺参照并追认 11 例过时参照,视觉门禁首次转绿
AUTH-D3 长期是视觉层唯一未判定项(94/31),本轮经用户裁定「缺参照与已过时
两者都授权」后一次性收口:

- 写入 38 张(25 新 + 13 覆盖)= 台账 31 例的文件级读数,一例多 shot 已逐组对账
- 裸 --update-snapshots 实读为 changed 模式(program.js:202 preset),只写缺失/不符,
  故 13 张覆盖全是真判红,不存在通过项被顺手改写
- 桌面/平板/webkit 全页高度收缩 1005–4034px,归 Q-5/S-2 网格修复;chromium-mobile
  按钮参照从 186x96 桌面下拉触发器改为 132x132 真实可见汉堡按钮(N-15(c))
- 逐张读图核看关键新参照:input-default 拍到真实姓名框而非蜜罐,product-card 中部
  留白与已批准的 products-fullpage 同形(flex-1 段落撑高),非渲染缺失
- 复跑 --update-snapshots=none:125 passed / 0 failed / EXIT=0,期间零写入
- 取证入 docs/acceptance/2026-10-08-baselines/(生成树 1396666、两次运行日志、
  归因表与未归因的移动端 +30/+21px 观察项)
2026-10-08 16:56:14 +08:00
zhangxiang 139666600e docs(qa): 台账抬头与 §8.5 待授权数字按 2026-10-08 现取校正
- 抬头 HEAD 由 a0328a6 改为 19569f6,并区分「代码封版点」与其后 3 笔未推的纯文档/测试提交
- 树状态口径更新:未跟踪 2→3 条;补记仓库无自定义 clean/smudge filter,故 porcelain 可直接采信
- 领先关系现取 origin 分支落后 3、origin/main 落后 37;29 个变更文件全在 docs/specs/e2e/README/.claude/.mcp
- §8.5 A/B 两行的 2 笔/36 笔为 19569f6 提交前读数,就地更正并注明来源
- B 行补 2026-10-08 复探依据:env 无 token、~/.config/gitea 与 ~/.gitea 不存在、git config 无 credential
2026-10-08 16:41:25 +08:00
zhangxiang 19569f63f9 docs(qa): 台账 §8 记录 agentic 作者侧工具化轮次与 2026-10-08 只读视觉复跑读数
- 选型判定与淘汰依据(采用 Playwright Test Agents,本轮不引入 tester-army/e2e)
- nav-keyboard.spec.ts 四个读数(dev 10/6、production 10/2、稳定性 24/24、lint/tsc 0)
- 两条引擎/目标差异定性:WebKit 不响应真实 Tab(N-27 同源);dev 下触发器节点被整体替换
- 视觉只读复跑 94/31 与 §7 同数,分层 20 缺参照 + 11 已过时参照;只读性已验(0 写入)
- 更正 AGENTS.md 的「85 张未提交」假事实(该文件 gitignore,仅本机)并作废我自己
  写错的「^1.58.2 vs 1.60.0」一条
- §8.5 待授权清单:push / PR(无 token) / deploy(不建议本轮) / 基线写 / healer
2026-10-08 16:12:10 +08:00
zhangxiang 1b5c75ab64 test(qa): 采用 Playwright Test Agents 做作者侧 AI + 补主导航键盘用例
选型:AI 只用在「写/修/探索」,运行期保持零模型、零外部服务。不引入
tester-army/e2e —— 它是第二套 runner,且与本仓最值钱的三块错配(无像素
基线可比、不模拟 touch/color-scheme/reduced-motion、另起 json/junit 产物
口径)。判据、对照表与边界见 docs/testing/agentic-test-authoring.md。

- init-agents 产物:.claude/agents/{planner,generator,healer}.md + .mcp.json
  指向仓内自带的 run-test-mcp-server(不装 @playwright/mcp;Playwright 自身
  不调 LLM,模型由宿主 loop 提供 ⇒ 无新增密钥依赖,也不外发应用内容)
- 故意不入库 init-agents 生成的 seed.spec.ts:空占位会被 test:functional
  的 4 个 project 当空用例收集
- specs/nav-keyboard-navigation.plan.md:7 个场景,3 个延后并写明原因
- e2e/nav-keyboard.spec.ts(tag @a11y,4 例):补「键盘打不开/走不出主导航
  下拉」。hover 路径早有覆盖,jsdom 单测替不了浏览器层的 relatedTarget 与
  真实焦点顺序;契约逐行取自 src/components/layout/mega-dropdown.tsx:35-76
- 实测读数:dev 四 project 10 passed / 6 skipped(EXIT=0);E2E_TARGET=
  production 10 passed / 2 skipped(EXIT=0);--workers=1 --repeat-each=3
  24/24;type-check 与 lint 均 0 error
- 测到并定性两条「非产品缺陷」:① WebKit 本机不响应真实 Tab 键(连续 4 次
  后 activeElement 仍是 BODY,而 .focus() 有效),与 N-27 同源;② dev 目标
  下触发器 DOM 节点在 hydration 后被整体替换(失败样本 click=1 而 aria 恒
  false,通过样本相反 ⇒ 监听绑在已被换掉的旧节点上),生产产物不复现
  ⇒ openWithKeyboard 用 toPass() 重发交互;跳过范围按引擎收窄,没有用守卫
  把红压掉
- 不在本提交:AGENTS.md 已被 .gitignore 排除,其「85 张基线未提交」的日期
  更正只落本地;该假事实的已入库更正记录在 docs/lessons-learned.md:505
2026-10-08 15:56:20 +08:00
zhangxiang 1b8ffd5486 docs(seal): 2026-09-30 封版验收判定与证据入库 + 台账假事实更正
代码封版点仍是 a0328a6;本提交只含验收证据与文档,用于把台账
§0 的「未达可判验收通过(唯一阻断 AUTH-D1)」改判为「封版通过
(含例外清单)」。

补齐 sealed 树上从未跑过的 5 项门禁并如实记录非全绿:
- 全站 check:axe EXIT=0(34 路由 × 双引擎 × 双主题,violation=0)
- 产物安全头 EXIT=0(每头单次,WARN 仅 HSTS 边缘注入)
- 生产目标 E2E 91 passed / 1 failed(唯一红 = firefox 并发墙钟,
  隔离与 4-project 复跑均绿;dev.db 指纹前后一致,未写库)
- 视觉只读 94 passed / 31 failed(20 缺参照 + 11 已过时参照,
  逐条归因;未写任何基线)
- check:motion EXIT=1 / 23 处(与周期 2 同数,未新增)

更正 4 处文档假事实:DEC-N21b(/admin 实有服务端 gating,入口是
src/proxy.ts 而非 middleware.ts)、视觉基线「85 张未提交」(实测
107 张全在库)、「无需重跑 db:seed」(seed 改过 modelCode 而
permissions 精确匹配)、lint 105→104。
2026-09-30 23:41:22 +08:00
zhangxiang a0328a623f chore(qa): 验收台账与证据入库 + 构建/部署配置同步
- docs/acceptance/qa-tracker.md:跨周期缺陷单一真源台账(§7=第五轮)。
- 周期 1/2 + iPhone SE/axe 验收证据目录、ACCEPTANCE_REVIEW 快照入库。
- 同步 README/CONTEXT/CLAUDE/DESIGN/testing/deployment/lessons-learned 口径;
  next.config/Dockerfile/nginx/Jenkinsfile/docker-compose/sentry/prisma 对齐
  standalone 产物装配与部署形态。
2026-09-28 10:48:09 +08:00
zhangxiang 6bb7c557ee test(qa): e2e 装配修正 + 集成/门禁测试与工具链重构
- e2e:修死选择器与蜜罐误命中、补断言、GA4/security-headers 用例诚实标注
  skip 边界;新增 assert-helpers/fixtures/hydrated/primary-nav/touch-targets
  等复用桩。
- 集成层:config/test/jest.integration.config.js + tests-integration/ 真库
  一次性 SQLite 用例,teardown 守卫开发库指纹。
- 门禁工具链:jest.setup 归位到根、scripts/accessibility 全站 axe 节点计数、
  check-brand-text-token/check-motion-constraints 机械守卫、stryker/lighthouse
  配置收敛。
2026-09-28 10:48:08 +08:00
zhangxiang a366bd1400 fix(qa): 第五轮系统性质量保障缺陷修复 + 单元/集成测试
安全/鉴权:登出清服务端 httpOnly 令牌、登录 IP 限流前置 bcrypt、停用账号
令牌在 6 个内联 role handler 失效、admin/items 存在性 oracle 认证前置、
同意偏好 sanitize fail-closed、api-crypto 按 HTTP 方法判体。

CMS:workflow 状态更新+审计收进交互式 $transaction(失败即回滚)、编辑器
richtext 走 textarea 防换行损毁、array/object 子字段按作用域读写防污染、
about/contact/erp-upgrade 补 ISR revalidate 与路由映射。

UI/a11y:AnimatedCounter 入视口前显起点、CLS 累计上报、MetricCard 动画入
effect 并卸载取消 rAF、后台状态四态映射/搜索防抖+序号守卫/媒体单 input/
吞错改横幅/表单 label-aria 关联。

新增对应判别性单测与 pagination/rate-limit/client-ip/sanitize/validate-content-data
等模块及 tests-integration 真库集成层。
2026-09-28 10:48:07 +08:00
zhangxiang 040951c0a3 test(visual): 以规范模式重生成全站视觉基线并补齐 firefox 缺口
改动前全量视觉套件 115 例中 87 例失败,且失败均为尺寸级不匹配(非像素抖动),
在 dev(:3001) 与 prod(:3002) 两种模式下同样失败。根因:e2e/playwright.config.ts
的 webServer 为 `npm run dev` + reuseExistingServer + url :3000,历史
`test:visual:update` 会静默打在 :3000 的旧生产预览上,跨浏览器基线长期失同步
(同一 / 页 firefox 基线高 6400px vs chromium 10936px)。

按配置意图以 dev 模式在新起 :3001(未复用 :3000)重生成 86 张,并补齐此前缺失的
methodology-fullpage-visual-firefox-desktop.png。逐张比对新旧像素高度,增量均为
本分支自身的收敛型缩减(最大 -15%,无归零/空白帧)。

Gates: 二次全量复跑 115 passed(5 projects × 23 subjects)。
2026-09-20 11:50:58 +08:00
zhangxiang 03ed066c6c chore(repo): 移植 PR-First 提交流程门禁(脚本 + Gitea PR 模板)
对齐 novavis AGENTS.md §27,逐项按本仓实测改写,不照抄不存在的命令:
- scripts/check-pr-checklist.sh:三种模式(模板结构 / 单 PR 文件 / --pr-dir 扫描)
  与退出码 0/1/2 保持同源;模板根改为按脚本自身位置解析并保留 AGENT_PROJECT_DIR
  覆写;修上游 --pr-dir 的参数解析缺陷(for arg in "$@" 内 shift 不消费值,
  目录会被再当成 PR 文件),改 while+shift
- .gitea/PULL_REQUEST_TEMPLATE.md:30 项 checklist 全部换成本仓真实门禁命令
  (type-check / lint / test:unit / test:coverage 阈值 / Playwright / visual /
  check:contrast / check:headings / lighthouse / test:security:headers),并补
  CMS 字段-需重跑 seed 声明、:3000 旧预览不作数、暗黑 token、动效 180–280ms、
  品牌红触达、数字 basis 口径等本仓专有约束
- 文档同源:docs/development/quality-gates.md 新增「提交与 PR 流程」权威副本
  (AGENTS.md 被 .gitignore 排除,不可依赖)、CLAUDE.md 补 Submission Flow 节

门禁自检:脚本 bash -n 通过;11 个用例覆盖三模式 + 缺节/缺文件/子项不足/非 PR
文件/未知选項/--quiet 等负路径,均带正控制以防「匹配零的假绿」。
2026-09-20 11:50:58 +08:00
zhangxiang 4dcc15ebd0 fix(metrics): 数字口径 basis 结构强制,删除详情页虚构佐证
复评 P0 收尾:把「每个数字带口径」从个别页自觉升级为结构性强制。
- metrics-basis.ts:METRIC_BASES / METRIC_BASIS_NOTES + resolveMetricBasis
  (缺失·非法·大小写错一律回落最弱 target)+ weakestBasis(一组数字取最弱者聚合)
  + FORBIDDEN_PROOF_PHRASES;MetricsBasisNote 收 basis prop
- 类型层 Product.metrics / DataProof / ServiceMetric / Solution.outcomes /
  DataMetric / about keyMetrics 全部加 basis?;9 处调用点改为 basis 驱动
- content-types.ts 新增共享 metricBasisField(select)展开进 9 处字段定义;
  trustSignals 有意跳过(已有自己的 source)。seed 显式声明 55 条 target
- 删除字面虚构佐证:详情页「每一项指标都源自真实客户案例」、「经过实战验证」×3、
  「来自真实客户的使用数据」、「经实际场景验证」;给此前完全裸奔的 3 个共享
  数字渲染器(DataProofSection / detail-trust / detail-product-value)补上角注
- metrics-basis.test 3→16 例:basis 解析正控制、weakestBasis 次序、seed 全量
  显式声明 + 覆盖证明(防空跑假绿)+ 禁任何条目自称 verified + 禁词全源码扫描
- 文档同源:DESIGN.md 立 The Declared-Basis Rule;PRODUCT.md 常驻禁令;
  CONTEXT.md 记决策并警示 admin 字段需重跑 seed 才激活

边界:CMS 字段定义存 ContentModel.fields(DB 内 JSON),basis 下拉须重跑 seed
才会出现在 admin 表单;本次 DB 与 seed 数据值零改动,渲染端对缺 basis 兜底 target。

Gates: type-check 0 · jest 1594/132 · contrast 7/7 · headings 10/10
lint 0e/128w(与 stash 基线逐行比对,零新增告警)
2026-09-20 11:50:58 +08:00
zhangxiang 84e01eb8e8 chore(codex): 新增 .codex/hooks.json 配置 2026-09-20 11:50:58 +08:00
zhangxiang 35ea1fff5f chore(impeccable): 审计工具链重构与精简
更新 .agents/skills/impeccable:移除旧 detector/live 脚本簇与若干 reference,
改用打包后的 scripts/bin 与精简 reference(含 degraded/*、native/*)。
纯工具链,不触及营销站源码与站点运行时。
2026-09-20 11:50:58 +08:00
zhangxiang f8917d4fda feat(ui): 营销站 UI/UE/UX 治理 P0→P3 收官
复评(impeccable critique)全部 Priority Issues 与 Minor Observations 落地:
- P0 数字口径:MetricsBasisNote 单一真源 + metrics-basis.test fs 防线,接入
  products/solutions/services/home/about;纯渲染端加角注,不动 DB/seed 值
- P1 转化断头路:敬请期待态 + 404 语境出口 + services 空态双出口
- P1 首页并卡:TrustSection 早鸟横幅并入 CasesSection 单张深色共创卡
- P2 CTA 治理:CONSULT_CTA_ALLOWLIST 白名单 + 逐字符扫描器,/contact CTA 全归一
- P3 polish:footer 补 服务/公司列、contact 死三元/空槽/toast、GlobalErrorTracker 幂等日志
- 文档同源:PRODUCT/CONTEXT 动效带统一 180–280ms;DESIGN.md 立 The 10px Floor;
  font-floor.test 守卫禁止再引入 <10px(保留 10/11px 有意 Bain 微标签)

Gates: type-check 0 · jest 1581/132 · lint 0e/126w · contrast 7/7 · headings 10/10
2026-09-20 11:50:58 +08:00
zhangxiang dcf8ed6f20 chore(audit): 同源 script 取消按后果导向判定(无未捕获异常不留痕)
App Router 静态 chunk 预取不带 Sec-Purpose 头无法按头识别;
必需 chunk 被取消必然伴随 hydration 失败(pageErrors 非空,仍以 P1 记录),
故同源 script ERR_ABORTED + 路由无未捕获异常 = 运行时自行取代,不留痕。
终验:33 路由 × 双主题 P1/P2/P3/INFO 全零。
2026-09-20 11:50:58 +08:00
zhangxiang 441a748f32 chore(audit): UI 审计工具链增强与噪音根治
- ui-audit.mjs:路由发现扩展至 33 路由(standalone 构建产物 + erp-upgrade 系列);
  GA/gtm 请求 mock(gtag/js 空 JS + collect 204);第三方统计噪音与同源
  ERR_ABORTED(重调度成功/prefetch)降级 INFO;LCP/CLS 断言按系统负载门控
  (load >= 5 跳过并注明,防测量环境假阳性);LCP 超阈值热缓存 reload 复测
  取优(lcpCold 留存冷值);clip 探针 sr-only 白名单;onReqFail 防御性修复
- ui-audit-report.mjs(新增):多主题探针聚合 HTML 报告,含截图画廊与 INFO 分级
- hardcoded-color-audit.mjs:bg-black/50 半透明遮罩误报修正(负向前瞻)+ 白名单
- 新增 brand-usage-scan.mjs / brand-ink-migrate.mjs(品牌令牌迁移辅助)
2026-09-20 11:50:58 +08:00
zhangxiang 5ecab7b15d fix(theme): 品牌色令牌语义拆分与暗黑模式全站治理
- 拆分品牌色「文字/底色」双通道:新增 --color-brand-ink(-rgb)(深色 #F87171)
  与 tailwind brand.ink;text-brand → text-brand-ink 迁移 247 处;
  bg-brand/border-brand 保持 --color-brand-rgb 不翻转(红底白字 5.58:1 不能动)
- dark 块补齐 --color-brand-bg: #2A1418(修复深色白字压浅粉底 1.04:1)
- hero 徽章新增 --badge-accent-text 桥接:accentColor 直用作深底文字不可读
  (#1e3a5f 深底 1.65:1),浅色取原色 / 深色 color-mix 提亮
- 硬编码颜色 token 化:bg-white/text-gray-*/border-gray-* → bg-bg-*/text-text-*/border-border-*
- 可访问性:触控目标 <24px 归零(footer 链接列 [&_a]:min-h-6 收口 377 处等)、
  news 搜索框补 aria-label、标题跳级 h2→h4 修正为 h3、装饰 blur 光斑容器补
  overflow-hidden 消除伪文本裁剪
- 验证:tsc 0 / eslint 0 error / jest 0 失败用例 / dogfood 33 路由 × 双主题 P1-P3 全零
2026-09-20 11:50:58 +08:00
zhangxiang d959fa9a81 refactor(theme): 营销页 bg-white token 化(暗黑模式 Phase 2 · marketing 批次)
问题:Tailwind 原生 bg-white 是硬编码值,深色主题下不翻转,
导致整页/整 section 恒为纯白,与转深色的页头页脚割裂。
(globals.css:--color-bg-primary-rgb 浅色 255 255 255 → 深色 10 14 20)

改动:10 文件 67 处 bg-white → 项目 token,按语义二分类
- bg-bg-primary  (33 处):页面/大块骨架(min-h-screen 容器、<section>、<main>)
- bg-bg-elevated (34 处):浮起层(带 border 的卡片、表单输入、图标盒、grid 单元格)
  --color-bg-elevated 浅色 #FFFFFF → 深色 #151B23,同样翻转。

浅色主题下 bg-white / bg-bg-primary / bg-bg-elevated 三者同值(纯白),
故本次改动在浅色主题下零像素差异,只修复深色主题。

新增审计工具:
- scripts/audit/hardcoded-color-audit.mjs:硬编码颜色分级盘点
  (含 alpha 误报修正:bg-white/NN 半透明叠加两主题均成立,判 INFO 非 P0)
- scripts/audit/darkmode-bg-verify.mjs:直接验证背景随主题翻转
  (浅色应纯白、深色应 rgb(10,14,20) 且无残留纯白块)

审计结果:marketing P0 67 → 0;全站 P0 97 → 30
(剩余 components 16 / other 8 / layout 3 / ui-kit 3 为第二批;admin 本就为 0)

门禁:
- tsc 0 error
- eslint 0 error(50 warnings 全为既有,改动文件未新增)
- jest 129/130 套件通过,1548 通过 / 2 跳过 / **0 断言失败**
  唯一失败 src/lib/admin-api.test.ts 为**沙箱环境限制非代码问题**:
  CODEBUDDY_BROKER_DENY 拦截 readFileSync,单独复验同样失败,
  与本次改动零交集(改动仅限 src/app/(marketing)/ 下 10 个页面组件)
- 暗黑模式背景验证 18/18 PASS(9 路由 × 浅深双版)
2026-09-20 11:50:58 +08:00
zhangxiang ad0b265ef2 refactor(motion): 收敛末批 P1 入场时长与变量递增 stagger 步进
动效合规专项(Task #16)收尾。

改动:
- page-transition.tsx:入场 duration 0.4/0.5 → 0.3(末处真 P1,由 client-layout 消费)
- 17 文件 21 处子元素 stagger 步进 80/100ms → 60ms
  (CONTEXT.md 原则4「子元素 stagger 30-60ms」;属已批准决策 04e91e3 的漏网,
   因当时审计脚本看不见 delay: i * N 的乘法写法)
- 审计脚本补盲区:新增变量递增 stagger 识别 + 明细表(此前漏掉全站 33 处)
- 审计脚本新增 NON_ENTRANCE 排除:flip-clock 机械翻转、design-system 死代码令牌
- delay 判据自我纠正:硬禁令约束的是 duration(动效时长),
  delay 属调度而非动效本身,一律判 P2(偏离指引),不得判 P0

门禁(全绿):
- tsc 0 error
- eslint 0 error(50 warnings 均为既有)
- jest 130/130 套件,1573 通过 / 2 跳过 / 0 失败
- 运行时冒烟 16/16 PASS(8 路由 × 浅深双版,0 控制台报错)
- 审计:P0=0 · P1=0 · stagger 步进 P2=0
2026-09-20 11:50:58 +08:00
zhangxiang e527b16cbc refactor(animations): annotate design-system.ts compliance trap
Task #16 残留陷阱治理(保留待用、不动代码):

scope: src/lib/constants/design-system.ts(零生产消费者的死代码)
action: 仅加注释,不改令牌值、不动 design-system.test.ts、零行为变化

- 文件头警示块:声明本文件为合规陷阱、令牌与 CONTEXT.md 冲突、
  test 用 // @ts-nocheck 断言错误值、勿在新代码 import
- 7 处冲突令牌行内 ⚠️ 注释:
  normal 0.4s 超目标 / slow 0.6s P1 / slower 0.8s P0 硬上限 /
  smooth 非 ease-ink / bounce 弹性缓动 / stagger 0.08 P2 / scroll 0.6s P1

verified:
- eslint design-system.ts: 0 errors (ESLINT_EXIT=0)
- jest design-system.test.ts: 20/20 passed (JEST_EXIT=0)
- 纯注释改动,tsc 无语法变化(已隔离单文件 diff)

note: 此前决策「保留待用、不动代码」——本提交仅显性化陷阱,
未来修正须同步改测试,否则必挂(P1 阶段已实践过该回退)。
2026-09-20 11:50:58 +08:00
zhangxiangand阿睿 e5a2efdaa2 refactor(animations): converge P2 stagger delays to ≤60ms target
Task #16 P2: converge 25 stagger/delay delays to ≤60ms target.

scope: 12 files, 25 staggerDelay/delayChildren props
before: 0.07/0.08/0.1/0.12s -> after: 0.05s (50ms, aligns ScrollReveal default)

verified:
- tsc --noEmit: clean (TSC_EXIT=0)
- eslint (12 files): 0 errors, 22 pre-existing warnings only
- jest: 130/130 suites, 1573 passed, 2 skipped, 0 failed (JEST_EXIT=0)
- motion audit: P0=0, P1=5 preserved, P2=0, OK=425

note: P1 residual 5 preserved (flip-clock 2 + page-transition 2 by
semantics; design-system.ts 1 dead-code deferred). visual regression
waived: stagger is entrance delay, reducedMotion yields same pixels.

Co-Authored-By: 阿睿 <workbuddy@local>
2026-09-20 11:50:58 +08:00
zhangxiangand阿睿 2aa0e21319 refactor(animations): converge P1 motion durations to ≤300ms target
- 151 scripted + 1 manual duration fixes across 46 files
- framer entrance 0.5/0.6s -> 0.3s
- Tailwind hover -> duration-150, entrance -> duration-300
- preserve flip-clock/page-transition per semantic decision
- design-system.ts dead-code deferred
- P1 violations 156 -> 5; P0 remains 0; OK class 249 -> 400
- verified: tsc clean, eslint 0 errors
- verified: 130/130 jest suites, 1573 passed
- verified: visual regression 46/46 zero-pixel diff

Co-Authored-By: 阿睿 <workbuddy@tencent.com>
2026-09-20 11:50:58 +08:00
zhangxiang 33564b7e9c chore: gitignore 审计产物目录
dogfood-motion-audit/ 与 dogfood-b2-verify/ 是审计脚本生成的截图/JSON 产物,
与既有 dogfood-output*/dogfood-ui-audit/ 规则一致,不应纳入版本控制。
2026-09-20 11:50:58 +08:00