2026-11-03 15:49:31 +00:00
|
|
|
|
#!/usr/bin/env python3
|
|
|
|
|
|
# -*- coding: utf-8 -*-
|
|
|
|
|
|
"""
|
|
|
|
|
|
同一行必须同心:全站横排容器里落在**同一条视觉行**上的子件,中线 y 必须一致(≤1px)。
|
|
|
|
|
|
|
|
|
|
|
|
症状(2026-11 第十四轮 · 用户原话「垂直居中对齐,和其它子页面要一致。请检查。」+
|
|
|
|
|
|
调度中心工具条截图):卡头标题槽外面套的是一个**行内 span**,里面坐的却是
|
|
|
|
|
|
`TagGroup`/`Flex` 这种块级 div——块级装在行内里会先撑出一段匿名行盒,
|
|
|
|
|
|
于是那一排 25px 的只读胶囊整体浮到卡头中线上方 6.5px(同页其它单行卡头偏 0.5px)。
|
|
|
|
|
|
肉眼看到的就是「这排标签贴顶、下面空一截」,而它和别的子页面同类的行对不上。
|
|
|
|
|
|
做法:把「同一行同心」写成一把可执行的尺,逐容器按 y 中心把可见子件**分组成视觉行**,
|
|
|
|
|
|
每一行内所有子件的中线必须与该行中心相差 ≤1px;同时记录该行最高子件与
|
|
|
|
|
|
字体(字号/字重),用来抓「继承到标题档 600 字重」这一类隐性病。
|
|
|
|
|
|
覆盖:卡头(.ant-card-head-wrapper)、内容页门牌(.nex-pagehead 的第一行)、
|
|
|
|
|
|
控件栏(.nex-ctlbar)、卡内横排(.ant-card-body 里那些 align-items:center 的 Flex)。
|
|
|
|
|
|
为什么只比中心不比高度:R3 允许同行出现 22/24/32 三档(标签 + 输入框 + 按钮),
|
|
|
|
|
|
它们的**中心**必须一致,顶边一致反而错。
|
|
|
|
|
|
为什么不查跨行:折行是 flex-wrap 的正常结果(R1),所以先按 y 分桶再逐桶判定。
|
2026-11-05 17:12:21 +00:00
|
|
|
|
用法:NEX_BASE=http://127.0.0.1:5173 .venv/bin/python -u scripts/ui/aligncheck.py [theme] [width]。
|
|
|
|
|
|
退出码:有任何一处偏位 >1px 或卡头标题继承到 600 字重 → 1;
|
|
|
|
|
|
量到的容器数掉到地板(< MIN_PROBED)→ 2,闸门自己坏了,不算通过。
|
|
|
|
|
|
|
|
|
|
|
|
⚠ 2026-11-06 踩过:BASE 早先写死 `localhost:5173`,那台端口上跑的是**另一个项目**,
|
|
|
|
|
|
十三页全都「没有对齐容器」,这把于是空跑成 0 处偏位还照样绿。凡是「0 = 通过」的尺
|
|
|
|
|
|
都必须自报样本数——和 footercheck 的 FOOTER_PROBED 同一个道理。
|
2026-11-03 15:49:31 +00:00
|
|
|
|
"""
|
2026-11-05 17:12:21 +00:00
|
|
|
|
import os
|
2026-11-03 15:49:31 +00:00
|
|
|
|
import sys
|
|
|
|
|
|
from playwright.sync_api import sync_playwright
|
|
|
|
|
|
|
2026-11-05 17:12:21 +00:00
|
|
|
|
BASE = os.environ.get("NEX_BASE", "http://127.0.0.1:5173")
|
|
|
|
|
|
MIN_PROBED = int(os.environ.get("NEX_MIN_PROBED", "40"))
|
2026-11-03 15:49:31 +00:00
|
|
|
|
THEME = sys.argv[1] if len(sys.argv) > 1 else 'light'
|
|
|
|
|
|
WIDTH = int(sys.argv[2]) if len(sys.argv) > 2 else 1440
|
|
|
|
|
|
TOL = 1.0 # 同一行允许的中线偏差(px):亚像素舍入留 1px
|
前端四项调整:输入框去掉光晕、账号菜单收口、逐页删开发期说明书、登录页重做成左右分栏
用户这一轮提了四条,其中三条是同一件事的三个面——**界面上残留着写给开发者自己的话**。
逐条落地的口径与取舍:
**1)所有输入框聚焦时的蓝色外框**
量出来其实是三层叠在一起:antd 组件 token 的 `activeShadow`(2px 主色光晕)、
`genFocusStyle` 画的 `outline`、站内 `app.css` 给自绘表面准备的全站 `:focus-visible` 兜底。
第二层没有独立 token,而它依赖的 `lineWidthFocus` 还被 Upload 拖拽区复用,动 token 会连带改上传框,
所以分两刀收:`theme/antd.ts` 关 token(`Input`/`InputNumber` 的 `activeShadow` = `none`、
`Select.activeOutlineColor` = `transparent`),`styles/app.css` 用
`:where(...):focus-visible { outline: none }` 关那圈 outline——用 `:where()` 是为了把特异度归零,
它只是一份选择器清单而不是新加一层优先级,将来谁要恢复焦点环不必先赢过一条 `!important`
(app.css 本身不在 `@layer` 里,压得住被 Tailwind 放进 `@layer antd` 的那份,本来就不需要 `!important`)。
**焦点指示没有被删**:antd 的 `activeBorderColor` + 加粗边框仍在,键盘用户看得见焦点;
自绘表面继续吃全站那条兜底。实测聚焦 `#login-user`:`box-shadow: none`、`outline: none 3px`、
`border-color` 浅 rgb(22,119,255) / 深 rgb(22,104,220)。
**2)账号胶囊:菜单去重、项上不留副标题**
「设置新密码」和「我的账号」是同一件事,且首启时登录页已经直接把人的带到 `/account?must=1`,
重复排队只让菜单变长——删掉,待办语义留着头像上的 Badge 红点。
菜单项不再写「账号信息 · 密码 · 登录设备」这类预演式说明;顺手把胶囊第二行的
`第 N 次登录` 也去了:那是「用户管理」表格里逐人登记的数据,挂在人人都要看的顶栏里等于把统计搬进导航。
现在菜单就是三项:我的账号 / 用户管理 / 退出登录。
**3)逐页去开发时冗余说明**(`Dashboard` / `AssetLibrary` / `ModelCenter` / `AgentConsole` /
`project/{Library,Overview,Storyboard,Timeline,Review,Delivery}` / `ProjectBriefDrawer`)
三类处置,已写进 UI规范 §14 G2:
- 常驻说明书删掉可见文字,信息进 `title`/`desc`:IndexTTS2 那四行论文式介绍(两处重复,
含「下面这条预告会说清楚:」)、总控台「期间页面不会推进,属正常现象」;
- 开发者口径翻成「会怎样」:ffmpeg libass 提示只留降级后果,`FFMPEG_BIN` / `brew install ffmpeg-full` /
当前探测路径收进 `title`;`Delivery` 卡头「媒体由后端 `/media` 直出,下载走 `/api/exports/:id/download`」整条删;
「每一站的汇总状态由它覆盖的那几个节点折算而来」→「点一行直接跳到对应环节」;
- 内部词不许漏到版面:`mock/Mock` → 站内既有的**演练通道**(四处)、「未匹配的列在 `unmatched_images`」
→ 翻成人话;**一个物件只有一个名字**,`/models` 曾同时叫「模型中心 / 模型控制台 / 调度中心 → 模型中心」,
全站统一成侧栏那一项的写法 **模型管理中心**(含 `.env` 注释、`dev.sh`/`server.sh`/`seed.py` 的引导语、
后端四条给用户的报错文案、README、docs、探针页面名),并修掉不存在的入口路径「调度中心 → 模型中心」。
有意保留:单位与取值口径的括号(`(秒)(毫秒)(可选)(0=自动)(dB)`——读数不该依赖悬停)、
条件出现的 `Notice`/`LineHint`/`ErrorText`、`confirmAction` 的 `desc`、`Stat hint`、`nav.hint`、
`PageHead sub`(kit 既定槽位的一句话职责说明)、`Help.tsx` 整页(登记在册的产品手册)。
配套给 `OptionGrid` 单开 `labelTitle`,让组标签的括号补充有地方去而不额外占一行。
**4)登录页重做**(UI规范新增 §13.4)
左右分栏:左栏 `w-[46%] max-w-[620px]` 写平台自述(品牌行 →「把一条长视频,做成一条流水线」+
三条能力点 → 角色可见范围),底色用 `color-mix` 把主色掺进 `color-bg-layout`,**零新 hex**;
右栏卡片保留原生 `<form>` 包在 `<Panel>` 外(Enter 提交与密码自动填充都挂在 form 上)。
窄于 `lg` 左栏整列收起,品牌行回到卡片顶部,任何宽度都认得出登的是哪个系统。
去掉后端下发的种子账号预填(`login_hint` 字段本身保留,`test_auth.py` 与 `e2e_selfcheck.py` 还在用它判首启),
placeholder 回到「用户名」「密码」;新增**记住我**:键 `nex-login`,账号+口令一起记一起清
(只清口令留账号的话勾选框就不算数了),只在登录成功后落盘,取消勾选当场 `writeLocal(key, null)`,
默认不勾(本机明文口令)。
文档同步:UI规范 §8.4(`labelTitle`)、§9.3(焦点轮廓三层口径)、§13.4(登录页)、
§14 G2(三类处置 + 一个物件一个名字)与 §14 例外登记(登录页左栏、`Help.tsx` 整页豁免);
README 鉴权一节补登录页与记住我;命名统一顺带扫了 `.env.example` / 三个脚本 / 后端文案。
验证:`npx tsc --noEmit`、`npm run build` 全绿;`node scripts/ui/classaudit.mjs` 七道闸门 0/0/0/0/0/0/0;
后端 + 前端起在 :8010/:5199 后跑完 §15 全部探针,退出码全 0——visualcheck 1440×明暗 15 路由
(console 0 / HTTP 失败 0 / 断言 0)、tableaudit 0、gridcheck 0、rhythmcheck 0、tagcheck 0/0、
btnrowcheck 0(413 组)、aligncheck 0、symmetrycheck 0、feedbackcheck 通过、footercheck 0(30 处吸底条)、
btnclustercheck 0(159 簇);gateprobe 11/11 反向验证;`pytest -q` 全量 502 passed 1 skipped
(后端改了四条用户可见文案,对应 3 处断言同步更新)。记住我三条路径(勾上存 / 不勾清空 / 取消即清)实测过。
2026-11-05 14:09:16 +00:00
|
|
|
|
PAGES = [('总览', '/'), ('资产库', '/assets'), ('模型管理中心', '/models'),
|
2026-11-03 15:49:31 +00:00
|
|
|
|
('①概览', '/projects/10/overview'), ('②资产', '/projects/10/library'),
|
|
|
|
|
|
('③分镜', '/projects/10/storyboard'), ('④调度', '/projects/10/dispatch'),
|
|
|
|
|
|
('⑤质检', '/projects/10/review'), ('⑥时间线', '/projects/10/timeline'),
|
|
|
|
|
|
('⑦导出', '/projects/10/delivery'), ('账号', '/account'), ('手册', '/help'),
|
|
|
|
|
|
('用户管理', '/users')]
|
|
|
|
|
|
|
|
|
|
|
|
# 逐个容器把「直接可见子件」按中线 y 分桶(同一视觉行),桶内比中心。
|
|
|
|
|
|
# 两条尺:
|
|
|
|
|
|
# ① 兄弟尺——同一容器里落在**同一条视觉行**上的子件,中线必须一致(按 y 分桶后逐桶比);
|
|
|
|
|
|
# ② 父子尺——单行容器的几何中心必须等于它**内容**的中心。
|
|
|
|
|
|
# 抓的是「容器被一段下边距撑高、内容贴顶」这一类:调度中心那条工具条整排
|
|
|
|
|
|
# 浮在卡头中线上方 6px,兄弟之间全都对得上,① 看不见它,只有 ② 抓得住。
|
|
|
|
|
|
JS = """() => {
|
|
|
|
|
|
const SEL = ['.ant-card-head-wrapper', '.nex-pagehead .ant-card-body > .ant-flex',
|
|
|
|
|
|
'.nex-ctlbar', '.nex-taggroup', '.ant-tabs-nav-wrap'];
|
|
|
|
|
|
const PARENT = ['.ant-card-head-title', '.nex-pagehead-title', '.ant-card-extra', '.nex-ctlbar'];
|
|
|
|
|
|
const vis = (e) => { const r = e.getBoundingClientRect(); const s = getComputedStyle(e);
|
|
|
|
|
|
return r.width >= 1 && r.height >= 1 && s.visibility !== 'hidden' && s.display !== 'none'; };
|
|
|
|
|
|
const box = (e) => { const r = e.getBoundingClientRect(), s = getComputedStyle(e);
|
|
|
|
|
|
return { y: r.y + r.height / 2, h: r.height, fs: s.fontSize, fw: s.fontWeight,
|
|
|
|
|
|
tag: (e.className && e.className.toString ? e.className.toString() : e.tagName).trim().split(/\\s+/)[0].slice(0, 30) }; };
|
|
|
|
|
|
const rows = [];
|
|
|
|
|
|
const seen = new Set();
|
2026-11-05 17:12:21 +00:00
|
|
|
|
let seen2 = 0; // 量到的容器数(判据能不能算数,全看这个)
|
2026-11-03 15:49:31 +00:00
|
|
|
|
// ── ② 父子尺:整页跑一遍(每个容器只看一次)
|
|
|
|
|
|
document.querySelectorAll(PARENT.join(',')).forEach((c) => {
|
|
|
|
|
|
if (!vis(c)) return;
|
2026-11-05 17:12:21 +00:00
|
|
|
|
seen2 += 1;
|
2026-11-03 15:49:31 +00:00
|
|
|
|
const kids = [...c.querySelectorAll('*')].filter((k) => vis(k) && !k.querySelector(':scope > *'));
|
|
|
|
|
|
if (!kids.length) return;
|
|
|
|
|
|
const cb = box(c), ys = kids.map((k) => box(k));
|
|
|
|
|
|
if (Math.max(...ys.map((b) => b.y)) - Math.min(...ys.map((b) => b.y)) > 8) return; // 多行不比
|
|
|
|
|
|
const content = ys.reduce((t, b) => t + b.y, 0) / ys.length;
|
|
|
|
|
|
const d = Math.abs(cb.y - content);
|
|
|
|
|
|
const key = cb.tag + '@' + Math.round(cb.y);
|
|
|
|
|
|
if (d > __TOL__ && !seen.has(key)) { seen.add(key); rows.push({ host: '父·' + cb.tag.slice(0, 22),
|
|
|
|
|
|
worst: +d.toFixed(1), dev: '容器中心' + cb.y.toFixed(1) + ' vs 内容中心' + content.toFixed(1), bold: '' }); }
|
|
|
|
|
|
});
|
|
|
|
|
|
document.querySelectorAll(SEL.join(',')).forEach((c) => {
|
|
|
|
|
|
if (!vis(c)) return;
|
2026-11-05 17:12:21 +00:00
|
|
|
|
seen2 += 1;
|
2026-11-03 15:49:31 +00:00
|
|
|
|
const kids = [...c.querySelectorAll(':scope > *')].filter(vis);
|
|
|
|
|
|
if (kids.length < 2) return;
|
|
|
|
|
|
const items = kids.map((k) => box(k));
|
|
|
|
|
|
const lines = [];
|
|
|
|
|
|
items.forEach((it) => {
|
|
|
|
|
|
const ln = lines.find((l) => Math.abs(l.c - it.y) < Math.max(6, Math.min(l.h, it.h) / 2));
|
|
|
|
|
|
if (ln) { ln.p.push(it); ln.c = ln.p.reduce((s, p) => s + p.y, 0) / ln.p.length;
|
|
|
|
|
|
ln.h = Math.max(ln.h, it.h); }
|
|
|
|
|
|
else lines.push({ c: it.y, h: it.h, p: [it] });
|
|
|
|
|
|
});
|
|
|
|
|
|
lines.forEach((ln) => { if (ln.p.length < 2) return;
|
|
|
|
|
|
const worst = Math.max(...ln.p.map((p) => Math.abs(p.y - ln.c)));
|
|
|
|
|
|
const boldTag = ln.p.filter((p) => /^(ant-tag|nex-tag|nex-chip|ant-segmented)/.test(p.tag) && +p.fw >= 500)
|
|
|
|
|
|
.map((p) => p.tag + ' ' + p.fs + '/' + p.fw);
|
|
|
|
|
|
if (worst > __TOL__ || boldTag.length)
|
|
|
|
|
|
rows.push({ host: c.className.toString().slice(0, 40), worst: +worst.toFixed(1),
|
|
|
|
|
|
dev: ln.p.map((p) => p.tag + '@' + (p.y - ln.c).toFixed(1)).slice(0, 4).join(' '),
|
|
|
|
|
|
bold: [...new Set(boldTag)].join(' ') });
|
|
|
|
|
|
});
|
|
|
|
|
|
});
|
2026-11-05 17:12:21 +00:00
|
|
|
|
return { rows, probed: seen2 };
|
2026-11-03 15:49:31 +00:00
|
|
|
|
}""".replace("__TOL__", str(TOL))
|
|
|
|
|
|
|
|
|
|
|
|
bad = 0
|
2026-11-05 17:12:21 +00:00
|
|
|
|
probed = 0
|
2026-11-03 15:49:31 +00:00
|
|
|
|
with sync_playwright() as pw:
|
|
|
|
|
|
b = pw.chromium.launch()
|
|
|
|
|
|
pg = b.new_page(viewport={'width': WIDTH, 'height': 1000})
|
2026-11-05 17:12:21 +00:00
|
|
|
|
pg.goto(BASE + '/login', wait_until='networkidle')
|
2026-11-03 15:49:31 +00:00
|
|
|
|
if pg.locator('#login-user').count():
|
|
|
|
|
|
pg.fill('#login-user', 'admin'); pg.fill('#login-pass', 'admin1234')
|
|
|
|
|
|
pg.click('button[type=submit]'); pg.wait_for_timeout(1200)
|
|
|
|
|
|
pg.evaluate('t => localStorage.setItem("nex-the", t)', THEME)
|
|
|
|
|
|
for name, route in PAGES:
|
2026-11-05 17:12:21 +00:00
|
|
|
|
pg.goto(BASE + route, wait_until='networkidle')
|
2026-11-03 15:49:31 +00:00
|
|
|
|
pg.wait_for_timeout(2200)
|
2026-11-05 17:12:21 +00:00
|
|
|
|
got = pg.evaluate(JS)
|
|
|
|
|
|
probed += got.get('probed', 0)
|
|
|
|
|
|
rows = got.get('rows', [])
|
2026-11-03 15:49:31 +00:00
|
|
|
|
for r in rows:
|
|
|
|
|
|
bad += 1
|
|
|
|
|
|
print('!! %-6s %-26s 同行偏位 %-5s %s %s' % (name, r['host'][:26], r['worst'], r['dev'],
|
|
|
|
|
|
('字重:' + r['bold']) if r['bold'] else ''))
|
|
|
|
|
|
b.close()
|
2026-11-05 17:12:21 +00:00
|
|
|
|
print('ALIGN_PROBED', probed)
|
|
|
|
|
|
if probed < MIN_PROBED:
|
|
|
|
|
|
print(f'⚠ 只量到 {probed} 个容器(底线 {MIN_PROBED})——BASE 指错端口或选择器漂了,'
|
|
|
|
|
|
f'不算通过:NEX_BASE={BASE}')
|
|
|
|
|
|
sys.exit(2)
|
2026-11-03 15:49:31 +00:00
|
|
|
|
print('%s:全站 %d 处同一行不同心 / 只读胶囊继承到标题字重' % ('未通过' if bad else '通过', bad))
|
|
|
|
|
|
sys.exit(1 if bad else 0)
|