mula.liu
|
24513a976e
|
NEX 阶段 4 补齐状态表面:首屏骨架、抽屉骨架、权限不足与地址不存在兜底页
|
2026-11-07 17:14:37 +08:00 |
mula.liu
|
4411d222fa
|
NEX 阶段 0–3 落地:规范对齐、状态标签截断兜底、三处热区键盘可达、浮层层级表
阶段 0(0 行业务代码):根 nex.config.yaml 把本项目实测值写死(Header 56 / Sider 224·64 /
Content 24·1680),AGENTS.md 的 NEX 路径统一加 nex_design_system/ 前缀并声明
docs/UI规范.md 为项目级权威;新增 docs/NEX-对照与例外.md 逐条判定 81 行
(COMPLIANT 49 / ADAPTED 17 / ADOPTED 13 / DEFERRED 7 / N-A 10)+ 例外 E1–E10
+ 别名表(不新增 --nex-* 命名空间)+ 反向清单 N1–N15。
阶段 1:ui/Status.tsx 的 Tag 自己兜 title(flatText 取正文),分镜卡标题 min-w-0、
状态标签 flex-none,顶栏流水线台 max-md:hidden 收口;visualcheck 新增 tagtitle 断言,
「截断却没兜底」从此进闸门。修掉分镜卡标签压到 35px、顶栏胶囊塌成 7px 两处实测病灶。
阶段 2:三处非语义热区可键盘化——顶栏品牌区改真实 <Link>(头像与平台名合成一个焦点站)、
分镜卡 <article> 加 tabIndex/aria-label/aria-current + Enter/Space(不套 role=button,
免抹掉卡内勾选框与三颗按钮)、Rows::LogRow 只在真有 onClick 时进 Tab 序列。
阶段 3:lib/layers.ts 建立 9 档层级表并被 7 处浮层引用;顺带修掉两条实测遮挡——
素材抽屉里点缩略图灯箱看不见(220 < 抽屉 1000)、声线抽屉里录音面板点不着(260),
确认框第一次拥有自己的数(1190)以免灯箱抬升后压不住。
验证:typecheck / classaudit / build 全部 EXIT 0;visualcheck 84 状态(14 路由 × 3 视口 ×
2 主题)console 0 · HTTP 0 · 断言 0;11 道常驻探针 GATEPROBE_OK 11/11。
详细取证见 reports/NEX阶段0-3实施-2026-11-07.md。
|
2026-11-07 16:49:14 +08:00 |
mula.liu
|
9614b2d225
|
v 0.1.1
|
2026-11-05 16:53:24 +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
|
5ce8f4a207
|
检查点:布局层迁入 antd 原生(Panel/Controls/grid/Input + app.css 清理)
|
2026-11-03 14:37:22 +08:00 |
mula.liu
|
85a95a9ba3
|
登录页接入常驻探针并改用 kit 用词:「页签」一词收口到页面内部
产品口径落地复查(内容页不做多 Tab / 菜单只到两级 / 页签=页面内部页面)时发现两处该修的:
1) 常驻探针压根量不到登录页:登录之后再访问 /login 会被守卫回落首页,
第 4 条的 URL 比对只能报「路由不存在」(实测退出码 1),而默认路由表里
干脆没有 /login。改成**登录之前**先按 逐档宽度 × 明暗把 chromeless 的
登录页量一遍并截图,尺子检查从主循环抽成 audit() 由两处共用(同一份断言,
不给登录页开第二条口径);/login 进默认路由表,主循环跳过它。
实测 430 / 768 / 1440 × 明暗:断言 0、console 0、HTTP 失败 0。
2) 登录页还留着手写用词:两个 <label><span> 字段换成 FieldBlock(标签在上,
与全站同尺),三条自己拼「描边 + 底色」的提示条换成 Notice。截图逐像素对过,
版面没动,只是不再各写一份。
顺带把词收口:ProjectDetail 注释里的「各业务页签」改成「各业务子页」——
「页签」从本轮起只指页面内部页签(§6.4),外壳没有页签条(§6.1);
§6 表格里 Header 那一行按真实三块(折叠开关+品牌簇 / PipelineConsole / 状态+手册+主题+UserMenu)重写,
§15.2 登记探针的登录前置一趟。
|
2026-11-03 12:52:42 +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 |