mula.liu
|
0b9ea0a430
|
NEX 阶段 8·N16:断点治理装上机器闸,登记从「两份人写的表」变成一条可对账的规矩
阶段 7 把页面里 5 把裸 max-[1240px] 之类的私档改名成 --breakpoint-* 命名变体,
归名之后留下的问题是:「登记」这件事只剩两份人写的表(styles/index.css 的 @theme
和 UI规范 §4 那张表)加一句 grep。下一轮谁再写一个 max-[900px]:flex,编译得过、
像素也对,只有人眼能发现;反过来说,往 @theme 加一档却忘了同步 visualcheck.py 的
BP 表更糟——wantDisplay 会对这一档静默返回 null,断言悄悄不跑了,比报错更难查。
classaudit.mjs 新增第 9 闸 BP:尺子的唯一真相是 @theme 里的 --breakpoint-*,其余
四处(页面用词 / UI规范 §4 表 / 探针的 BP·BPORDER / 尺子自己的使用面)全部由这条
闸向它对账,五条判据——① 裸 max-[…]/min-[…];② 用了没登记的变体名(写错名字
Tailwind 不报错,只是这一档压根不生成规则);③ 登记尺子必须有且仅有一个使用者、
不得 0 使用者、必须被 §4 表收录(§4 那三条口径的机器化);④ 每档都要出现在探针的
BP 与 BPORDER 里且同名同值同序(顺序错了会挑错赢家);⑤ .css 里 @media
(max|min)-width: Npx 的 N 必须是登记值,否则页面归了名、样式表里再开一批私档白干。
主阶梯「该不该在这一档换排布」是 R9 的语义判断,机器量不出来,这条闸不管。
闸按 §15.1 的口径反证过 10 例(写坏→红且点名→还原复绿),含一条反向的反向:agent
这把尺子的口径是「一个使用者」不是「一次使用」,同文件第 11 处复用必须放行,否则
闸就成了数次数的假判据。产物 reports/ui_evidence/nex-p8/n16/scripts/gate_bp_proof.py。
顺带修一处本轮写闸时踩到的自伤:新增第 9 闸时把 process.exit 表达式里的 dead.length
顶掉了(第一道闸从此不影响退出码),已还原——这类「闸门静默失效」正是这条闸自己要
防的毛病,写闸的人也一样会犯。
规范侧:NEX 04-layout-system.md 新增 §8.1 命名断点登记出口(有名字/有唯一使用者/
有实测/有对账四条)与 §8.2 专业工作区窄屏降级范式(<768 导航只留一个入口),已在
nex_design_system 子仓库单独提交 63e36ec;UI规范 §4 复核口径从「grep 必须为 0」
改为五条判据 + 指向第 9 闸,§15.1 闸表 8→9 并补基线输出;nex.config.yaml 补
breakpoints_registered 五档、ui_gates 注释改 9 道子闸、custom_breakpoints 从
forbidden 改 registered_only(原注释「禁止私档断点」已与阶段 7 的登记出口不一致)。
验证:classaudit 九道全绿(10 档在册 / 5 把登记尺子 / 0 命中,exit 0)·
反证 BP_PROBE_OK 10/10 · typecheck 通过。页面与样式文件零改动,像素不受影响。
|
2026-11-07 22:39:17 +08:00 |
Codex
|
1227003173
|
NEX 阶段 8·D16:kit 的 Tag 不再吞 className,顺带量清「页面到底能给它写什么」
Status.tsx::Tag 的形参收了 className 却没并进 cn(),全站 10 处站点从写下去那天起就是空转。
并进 cn() 末位(学同文件 Badge 的写法,tailwind-merge 保留后写者)之后逐站点实测,
结论与最初的推测不一样,两半都得记下来:
· 真的一半:styles/index.css:55 的 @import "./app.css" 不带 layer,未层声明高于任何
@layer,所以 .nex-tag.ant-tag 独占的 13 族属性页面 utility 压不动(display/底/色/圆角/
内距/字号/行高/min-height/gap/max-width/white-space/overflow/margin-inline-end);
· 假的一半:.ant-tag 带 transition:all .2s,改完类名立刻 getComputedStyle 读到的是过渡
起始值,margin/flex/font-weight 曾被集体误判成「输了」(700ms 后再读就对了)。
明暗两档逐属性量出能力矩阵,写进 UI规范 §1.1.1,并给 classaudit 加第 8 闸 TAGSKIN:
给 kit 的 Tag/Status 写皮肤类 = 判违规(该走 tone,或把 display 留在 wrapper 上)。
站点回归:ModelCenter「默认」只留 font-bold(皮肤族点不亮,§2.1 也早已废止语义铺底);
Review 的视觉模型名改走 tone="mono";分镜卡撤掉 flex-none 那层 wrapper,
缩略图角标的 absolute 第一次真的生效(此前掉出 overflow-hidden 盒子,探针 visible=False);
PipelineConsole 的 wrapper 保留,注释改成实情:它只为 display 族存在,撤它得先降 .nex-tag 皮肤入层。
验证:typecheck / build 通过;classaudit 8 道闸全 0;常驻 11 道探针 EXIT=0;
visualcheck 15 路由 × 4 视口 × 明暗 = 120 状态全绿(断言 0 / HTTP 0 / console 0);
932 颗标签 before/after 逐站点 diff,46 处差异全部落在预期站点,且无一处皮肤字段改动。
证据与元素级前后截图:reports/ui_evidence/nex-p8/d16/。
|
2026-11-07 22:35:11 +08:00 |
mula.liu
|
3e86b282e0
|
NEX 阶段 6 拆 kit 与清死代码:Panel/Controls 按职责分成五份、删 7 个 0 调用导出与 2 个死 hook、R8 承认 app 为外壳层
|
2026-11-07 18:21:47 +08:00 |
mula.liu
|
bc5d1bcc90
|
NEX 阶段 5 定一次操作的反馈预算:Library 5 处原生对话框收口、录音链 3 颗吐司并成 1 颗、模型中心开关补结果反馈、430 统计卡改两列
|
2026-11-07 17:51:40 +08:00 |
mula.liu
|
9d62b88b05
|
规范与闸门收口:R19 反馈四级、R20 标题前不挂图形写进硬规则,探针补到十道
这一笔只动文档、审计与闸门,代码一行没改——前三笔(b6a1df6 反馈表面、552b6b0 门牌图形)
把事做完了,但规范和闸门还停在第十八条 / 六道探针的状态:新规矩没进 §0 那张硬规则表就
等于没立;探针不落地,下一轮改动照样能悄悄长出第五套反馈皮肤。
补进去的规矩(§0 从 18 条到 20 条):
· R19 反馈只有四级表面,各有唯一实现:行内 `ErrorText`/`LineHint` → 页面 `Notice` →
结果 `notify*`(自绘吐司)→ 确认 `confirmAction`(自绘确认框);`window.confirm` /
`window.alert` / `Modal.confirm` / antd `message` / `notification` / 裸 `<Alert>`
全站清零,也不许再给它们打样式补丁。新增 §13.3 一整节写四级的分工、吐司的四件事
(右下角堆叠 / 倒计时条与 JS 同源 / 同句去重成 ×N / 一屏最多 5 颗)和确认框的键盘映射。
· R20 标题前面不挂图形:门牌与卡头的一级标题左侧不许出现图标、色块、头像。
· 旧口径逐条纠正(10 处锚点全部命中才落盘):R16 ③ 与 §13.1 那张表里 `Notice`=antd
`Alert`、§13.1 正文「图标由 Alert 自带」、§6.5 外壳表里 `App.tsx` 的「系统异常
`Alert` → 页面」、§6.1「Content 里除了异常 Alert 就是 `<Outlet />`」、§15.6 tagcheck
的豁免语「整段 Notice / Alert 保留 antd 语义底」、§13.3 症状里那个被真实换行截断的
code span。站内已经没有 `Alert` 这个名字了,文档留着它就是在教人写回旧写法。
· `docs/工程规范.md`:目录职责图与「谁可以 `import 'antd'`」那段摘掉 `stores/notice.ts`
——吐司自绘之后它不再 import antd,白名单从四处收成三处。
· README:闸门命令块补 `aligncheck` / `symmetrycheck` / `feedbackcheck` 三行,硬规则
摘要补第 6、7 两条审计的说明。
闸门:
· `classaudit.mjs` 从五条判据加到七条。第 6 条静态禁反馈默认件(`window.confirm(` /
`window.alert(` / `Modal.confirm(` / `message.xxx(` / `notification.xxx(` / 裸
`<Alert`),实现本体白名单只有 `components/ui/{Toast,Confirm,Panel,Button,tone}.tsx`
与 `stores/{notice,confirm}.ts`;第 7 条钉住 R20——门牌与卡头标题里不许再挂前置图形。
同时把第 5 条 R8 的白名单里那第四处 `stores/notice.ts` 删掉:留着它就等于给「以后
谁想在 store 里 import 组件库」开后门。
· 新增第 9 道 `scripts/ui/feedbackcheck.py`:静态审计查不出两件事实——运行时是否真有
某条老路径弹出过原生对话框、自绘吐司是否真的**显示出来了**(`ToastHost` 挂错位、
provider 没渲染、store 被引成第二份实例,都会让 `notify()` 静默返回而静态审计照样
是 0)。它按真实路径逐项验 A~F:全站零 `dialog`、/users 保存后吐司落在右下角且
`.ant-message` 一个不许有、悬停时 `animation-play-state` 必须 paused、同句去重成 ×2、
连推 7 句只留 5 颗、关闭键生效、/ 上点删除出确认框(两层文案 + 恰好一颗 dangerous
primary)、Esc 关掉后项目数不变。
· 实测(明暗两档):`classaudit` 七条全 0 · `feedbackcheck` 通过 · `btnrowcheck`
`BTNROWS_TOTAL 0` / `HEAD_BREAK_TOTAL 0`(413 组动作排 / 59 处竖排豁免)·
`footercheck` `FOOTER_PROBED 30` / `FOOTER_BAD_TOTAL 0` · `aligncheck` 0 ·
`symmetrycheck` `SYM_TOTAL 0` · `tsc --noEmit` 与 `npm run build` 绿。
手册 12 张插图按「改完 UI 必须重跑 `helpshots.py`」的口径整批重拍(1600×1000@2x →
LANCZOS、锁 light、主角项目 12):旧图还是带主色方块门牌与卡头品牌 N 的那一版。
|
2026-11-03 23:58:44 +08:00 |
mula.liu
|
7e784b5303
|
规范补到十七条并把探针升到「六道 + 一道反向验证」:行高、栅格、纵向节奏、标签底色全部有闸
症状:这一轮改的每一类毛病里,有四类靠人眼复查根本守不住——表格行被内容撑高(实测最高
255px)、该用栅格的地方用自然排列(窄屏两种坏画面:一行右边缘参差不齐、折行点随内容
漂移)、纵向节奏断(底边不齐 / 收缩错位)、标签自带彩色底纹(§2.1 要求中性底);而卡头
`right` 长起来把标题压成竖排(430 档标题 291×145)也没有任何闸门会报。更麻烦的是
rhythmcheck 的判据原先读像素,豁免写宽一格就永远安静地返回 0——14 条命中里混着探针
自己的假警报,没人敢信它的红。
做法:①`docs/UI规范.md` 新增 R17 表格行高纪律(§13.2)与 R16 信息块三件套的落地口径
(§13.1),§9.3 补卡头折行那条(含「折行样式要挂在 `.ant-card-head-wrapper` 而不是
`.ant-card-head`」这个陷阱与 430/1440 的实测数据),§15 扩成 15.1–15.7 六道常驻探针
加一道反向验证,§16 提交清单插入第 9 步「动过布局跑三张像素闸、改过判据跑 gateprobe」;
②新增 `tableaudit.py`(逐表报容器宽/可视宽/行数/最高行/列宽,超行高点名)、
`gridcheck.py`、`rhythmcheck.py`(GAP + RAG,四条写法级豁免逐条写明为什么豁免)、
`tagcheck.py`(扫标签 tinted 底);③`gateprobe.py` 用「坏 fixture 必须被点名、合法形态
必须被放行」两组用例反向验证三张像素闸,共 4/4 全对,不碰源码不触发 HMR;
④`rhythmcheck.py` 的判据改成只读写法不读像素(`isPin` 认 mt-auto / inline margin-top /
justify-content;RAG 侧放行子块自带 max-width、align-self 与整行居中的胶囊组),
`classaudit.mjs` 把 `<Flex align="flex-start">` 的取值加进 PROSE 白名单(它天天作为
props 值出现,逐行切词分不清引号内外);⑤`visualcheck.py` 的项目子页改成量「镜头最多」
的项目并支持 NEX_PROJECT_ID 覆盖——列表第一个常是空项目,空态下溢出与截断两类断言等于
没测;⑥README 的规范条目数同步到十七条(只提这一行,其余内容归并行的后端改动)。
为什么:这类毛病全是「看起来挺整齐、量一下才知道差 200px」,只有把它们变成退出码才能
防止下一轮又漏回去;而像素闸一旦可能悄悄失灵,就必须配一道反向验证——先证明闸门坏了
会响,它的绿才有意义。
|
2026-11-03 20:21:39 +08:00 |
mula.liu
|
be07d9d712
|
闸门跟着 antd 布局层重新校准:三处检查不再说假话
症状:布局层搬进 antd(Flex / Drawer actions / Tag)之后,四道闸里冒出一批
「查的是老口径」的误报,逼得人想给闸门加豁免——那是要把闸门关掉的前兆。
① visualcheck 侧栏探针只认 .ant-menu-item-selected,可菜单折叠时高亮的是
父级 SubMenu 标题,antd 给它的是透明底 + colorPrimary(正确长相),
拿选中项的 controlItemBgActive 去比就必然红:430 档
projects/13/{delivery,dispatch,timeline} 三页连续报假故障。
② 同一支脚本把「行高为 0」当塌陷,而 antd 的图标复位本来就把 .anticon
写成 line-height:0(盒子由 font-size 撑开),图标一旦带上 text-* 就中枪。
③ classaudit 第 4 条用 \b(actions|footer)=\{ 找浮层底部动作条,
PageHead actions(页头视图开关)和 Toolbar actions(勾选后的批量条)
名字撞车被一起吞进来,「最后一颗必须是主行动」判到了不该管的地方。
④ Tailwind 词表没有 Flex 的 wrap / space-between 与 cursor 的 not-allowed,
这三个 props 值天天出现,逐行切词分不清引号内外,只能点名放行。
做法:①探针多输出一个 kind(item / submenu),Python 侧只在 kind=item 时比色板,
submenu 交给原有的浮层复核分支;②行高断言排除 .anticon;
③先定位 prop 挂在哪个元素上,只有 Drawer / Modal(含 kit 转发的 AntDrawer /
AntModal)才算底部动作条——实测全站 25 处里受管 12 处,另 12 处归 §7 控件栏;
④三个词进白名单,并在注释里写清「当类名写出来仍是笔误」;
顺带删掉临时探针 nexprobe.cjs / nexprobe.tsx(能力已并进 visualcheck),
新增 scripts/ui/helpshots.py:手册的 12 张插图是静态 PNG,不参与构建,
UI 每换一次皮肤就整批过期,拍摄口径(视口/dpr/主题/主角项目/先收概况)写进脚本头。
为什么:闸门报一次假,人就多写一次豁免;豁免写满,真故障就混在里面没人看。
所以这一轮修的是检查本身的口径,而不是给页面加特例。
|
2026-11-03 17:02:03 +08:00 |
mula.liu
|
5f294c9ccb
|
补上 R8 这道闸并让文档说真话:classaudit 第五道检查 + README/工程规范回到 antd 版现状
症状:README 还在讲 metrics.ts / palette.ts / css-vars.ts 三把尺子、33 组 ComponentToken、
--ctl-h* 变量、ToolButton/IconSpot/MenuRow 这些本轮已经删掉的东西;R8「谁可以 import 'antd'」
只写在文档里,没有任何机器拦着——文档一漂,规范就退化成建议。
做法:
- classaudit.mjs 加第 5 道闸:`from 'antd'` 逐行扫,白名单只有 theme/ · app/ ·
components/{ui,forms} · stores/notice.ts,退出码并入违规总数;已反向验证
(pages/Account.tsx 临时插一行 import 后探针点名并报 exit=1,撤掉复绿)。
- README 分层表与两段口径重写:theme/ 只剩 antd.ts(buildAntdTheme + applyRootVars + HEADER_HEIGHT)、
styles/ 的 --radius-* 只是 --ant-* 的别名、裸 <button> 白名单换成 CUSTOM_SURFACES 真实的 7 个文件、
两道探针的描述换成它们各自真正查的东西(五道 / 八类)。
- 工程规范:theme/ 目录行、--ctl-h 档位、§0.5 与「§6 自绘区边界」这些失效指针改到
R8 / §1 四层分工 / §5.2 自定义表面族;stores 补 recording;app/ 行写明 nav.tsx 是两级菜单唯一来源。
- kit 注释里的 §0.6 指针改指 R8 与 §5.2(那一节已随手写规范退场)。
验收:typecheck + build 通过;classaudit 五道全绿 exit=0;visualcheck 1440/768/430 × dark/light
(含登录页在登录前先量一趟)console 0 条、HTTP 失败 0 条、断言 0 条。
|
2026-11-03 12:59:59 +08:00 |
mula.liu
|
62c356952c
|
UI 规范与两道常驻探针同步到 antd 版:classaudit.mjs + visualcheck.py,旧探针归档
docs/UI规范.md 按 antd 重写(16 章 / 十四条硬规矩 R1–R14):
- §6 外壳(Header 56 + 两级 Sider + Content)、内容页不做多页签、页签只在页面内部,
Tabs vs ViewSwitch 的判据;§9.3 值型控件的宽度归控件而非「标签+控件」+ nex-prose-value 豁免登记;
§10 下拉面板「至少同宽」与折行、标记类全集 18 只;§5.1 按钮上的字必须整颗放得下;
- §15 两道闸的判定口径写死,退出码都必须为 0。
scripts/ui/classaudit.mjs:四道判定(死类名 / 绕过登记表的图标 import / 裸 <button> /
浮层底部动作口径),基线 3912 个候选,必须在仓库根跑。
scripts/ui/visualcheck.py:登录 → 逐路由 × 逐档宽度 × 明暗截图,钉死八件事——
:root 尺子、行高、侧栏选中态(窄屏折叠时展开浮层复核二级项)、路由没被 path:'*' 静默吞掉、
display utility 被组件样式盖掉(R13 闸门)、横向溢出与切字、
控件标签**含下拉当前值**不许被省略号截断(散文型选项值按 nex-prose-value 放行)、
4xx/5xx 按 URL 分诊(素材缺文件单独计数,接口 404 点名发出它的路由)。
新增的 4xx/5xx 一条顺带治好了时间线 / 交付页「空状态对、代价是两条 404」的假绿。
旧的 audit.py / metrics.py / vocab.py 量的是已删的那套自造尺子,移进 scripts/ui/legacy/ 并标注作废。
README 与 docs/工程规范.md 同步:theme/ 只剩 antd.ts 一把尺子,导航与页签口径改为两级菜单 + 内部页签。
本轮验证:tsc 0 错 / classaudit 四道全 0 / vite build 通过 /
visualcheck 两轮各 104 张(1440·992·768·430 × dark·light,空项目与数据齐全项目各一轮)
console 0 条、HTTP 失败 0 条、断言 0 条。
|
2026-11-03 12:42:28 +08:00 |