#!/usr/bin/env python3 # -*- coding: utf-8 -*- """节奏体检:组件之间的上下、左右边距是否由**版面尺子**给(2026-11 第七轮起常驻)。 用户口径:**组件之间的上下、左右边距要合理**。本站唯一的纵向间距来源是 `PageStack`(页内区块)与栅格 `gutter`(格与格),页面里再补 `mt-*/mb-*` 就会同一屏出现 12/16/20/24 混着来。这里对着渲染结果量两件事: 1) 纵向节奏(gap):容器(flex-column / grid / .nex-stack)里相邻可见子块的 实际间距必须**只有一档**,且 ≤ 24px(= --ant-margin 那一档)。 豁免三种合法形态: · 末块**钉**在容器内容底——只认既定写法(卡底动作 `mt-auto`、`justify-content` 钉两端),跨卡把按钮排到同一水平线上用的,这一档间距本来就不该固定; 钉底不能读像素(margin-top:auto 的计算值恰好等于它吃掉的余量,永远算不出 「有余量」;而内容撑开的列容器里末块天然贴着内容底,只比位置等于把全站末档全放过); · 同一行的两块(top 齐平 / 纵向重叠 / 横向不相接——grid 多列 + items-center 时两块的 top 会差几十 px,只比 top 会把并排量成 -30px 的假间距); · 单行胶囊按钮(高 ≤48,宽度跟文案走是设计意图)。 2) 收缩错位(ragged):flex-column 容器把子块排成「一块宽一块窄」的 shrink-wrap 效果。同样豁免两种刻意行为:子块自己写了 max-width / align-self (正文 `max-w-[72ch]` 这种栏宽)、整块内容居中(容器 items-center 且每个子块 align-self:center,是排版不是排列)。 用法: NEX_THEMES=light,dark NEX_WIDTHS=1440,1280 .venv/bin/python scripts/ui/rhythmcheck.py 退出码:0 = 干净,1 = 有立案。 """ import json import os import pathlib import sys from playwright.sync_api import sync_playwright BASE = os.environ.get("NEX_BASE", "http://127.0.0.1:5173") WIDTHS = [int(x) for x in os.environ.get("NEX_WIDTHS", "1440").split(",")] THEMES = os.environ.get("NEX_THEMES", "light,dark").split(",") ROUTES = [r for r in os.environ.get( "NEX_ROUTES", "/,/assets,/models,/projects/{id}/overview,/projects/{id}/library," "/projects/{id}/storyboard,/projects/{id}/dispatch,/projects/{id}/review," "/projects/{id}/timeline,/projects/{id}/delivery,/account,/users,/help").split(",") if r] USER = os.environ.get("NEX_USER", "admin") PWD = os.environ.get("NEX_PASS", "admin1234") OUT = pathlib.Path(os.environ.get("NEX_SHOTS", "/tmp/nex_ui_rhythm")); OUT.mkdir(parents=True, exist_ok=True) PROJECT_JS = r"""async () => { const t = localStorage.getItem('nex-auth'); const tok = t ? (JSON.parse(t)?.state?.token || JSON.parse(t)?.token) : ''; const h = {headers: {Authorization: 'Bearer ' + tok}}; const j = await (await fetch('/api/projects', h)).json(); const list = j.projects || j.items || j.data || (Array.isArray(j) ? j : []); let best = ''; let n = -1; for (const p of list) { const s = await (await fetch(`/api/projects/${p.id}/shots`, h)).json(); const c = s.count ?? (s.shots || []).length; if (c > n) { n = c; best = p.id; } } return best || list[0]?.id || ''; }""" # 纵向节奏:同一容器内相邻子块的间距只准一档 GAP = r"""() => { const cls=(el)=>(typeof el.className==='string'?el.className:'').trim().split(/\s+/).slice(0,4).join('.'); const out=[]; const all=[document.querySelector('main')||document.body,...document.querySelectorAll('main *')]; for (const el of all) { const cs=getComputedStyle(el); if (!(el.classList.contains('nex-stack')||(cs.display==='flex'&&cs.flexDirection==='column')||cs.display==='grid')) continue; const kids=[...el.children].filter(c=>{const k=getComputedStyle(c),r=c.getBoundingClientRect(); return k.display!=='none'&&k.position!=='absolute'&&k.position!=='fixed'&&r.height>6&&r.width>120;}); if (kids.length<2) continue; const gaps=[]; const box=el.getBoundingClientRect(); const pb=parseFloat(cs.paddingBottom)||0; /* 「末块是钉到底上的」只能读写法,不能读像素:margin-top:auto 的计算值就是 它吃掉的全部余量,于是「有余量」永远算不出来;而内容撑开的容器里最后一块 **天然**贴着内容底,只看位置等于把每条容器的最后一档间距全放过。 本站钉底只有两种写法:卡底动作的 `mt-auto`,和 justify-content 的钉两端。 */ const jc=['flex-end','space-between','space-around','space-evenly'].includes(cs.justifyContent); const isPin=(k)=>/(^|\s)mt-auto(\s|$)/.test(typeof k.className==='string'?k.className:'') || (k.style && k.style.marginTop==='auto') || jc; for (let i=1;iMath.abs(g)))]; if (uniq.length>1||uniq[0]>24) out.push({el:el.tagName.toLowerCase()+'.'+cls(el),kids:kids.length,gaps, detail:kids.slice(0,8).map(k=>k.tagName.toLowerCase()+'.'+cls(k)+':'+Math.round(k.getBoundingClientRect().height))}); } return out; }""" # shrink-wrap:列容器里子块宽度参差 RAG = r"""() => { const cls=(el)=>(typeof el.className==='string'?el.className:'').trim().split(/\s+/).slice(0,4).join('.'); const out=[]; for (const el of document.querySelectorAll('main *')) { const cs=getComputedStyle(el); const col=el.classList.contains('nex-tile')||(cs.display==='flex'&&cs.flexDirection==='column'); if (!col) continue; const kids=[...el.children].filter(c=>{const k=getComputedStyle(c),r=c.getBoundingClientRect(); return k.display!=='none'&&k.display!=='contents'&&k.position!=='absolute'&&k.position!=='fixed'&&r.height>10&&r.width>40;}); if (kids.length<2) continue; const cw=el.getBoundingClientRect().width; if (cw<260) continue; const hh=el.getBoundingClientRect().height; // 单行胶囊 / 标签按钮:align-items:center + 子块宽度跟文案走,本来就该收缩 if (hh<=48) continue; /* 「比容器窄」有两种,只有一种是病: · 子块自己写了 max-width(正文 72ch 那种刻意的栏宽)或 align-self——是设计选择,放行; · 整块内容居中(容器 items-center 且每个子块 align-self:center)——排版不是排列,放行; · 剩下的才是 shrink-wrap:容器在要求撑满,子块却各自贴着内容宽度,左右边缘七零八落。 */ const optOut=(k)=>{const s=getComputedStyle(k); return s.maxWidth!=='none'||s.alignSelf!=='auto'||/max-w-|w-\[/.test(typeof k.className==='string'?k.className:'');}; const widths=kids.map(k=>Math.round(k.getBoundingClientRect().width)); const ragged=kids.some((k,i)=>cw-widths[i]>48&&!optOut(k)); const al=cs.alignItems; const centered=al==='center'&&kids.every(k=>getComputedStyle(k).alignSelf==='center'); if (al==='flex-start'||al==='start'||al==='end'||al==='baseline'|| (ragged&&!centered&&al!=='center'&&!el.classList.contains('nex-stack'))) out.push({el:el.tagName.toLowerCase()+'.'+cls(el),align:al,cw:Math.round(cw),widths, first:kids[0].tagName.toLowerCase()+'.'+cls(kids[0]).slice(0,40)}); } return out; }""" def main() -> int: res = {"gap": {}, "rag": {}} with sync_playwright() as pw: b = pw.chromium.launch() pg = b.new_context(viewport={"width": 1440, "height": 900}).new_page() pg.set_default_timeout(20000) pg.goto(BASE + "/login") pg.wait_for_selector("#login-user") pg.fill("#login-user", USER) pg.fill("#login-pass", PWD) pg.click("button[type=submit]") pg.wait_for_url(lambda u: "/login" not in u, timeout=20000) pid = pg.evaluate(PROJECT_JS) for width in WIDTHS: pg.set_viewport_size({"width": width, "height": 900}) for theme in THEMES: pg.evaluate("(t) => localStorage.setItem('nex-the', t)", theme) for r in ROUTES: if "{id}" in r and not pid: continue route = r.replace("{id}", str(pid)) pg.goto(BASE + route) pg.wait_for_timeout(1300) key = f"{route}@{width}/{theme}" res["gap"][key] = pg.evaluate(GAP) res["rag"][key] = pg.evaluate(RAG) bg = pg.evaluate("getComputedStyle(document.body).backgroundColor") b.close() for k in res["gap"]: for x in res["gap"][k]: print(f"GAP {k:<34} {x['el'][:60]} kids={x['kids']} gaps={x['gaps']}") print(f" {x['detail']}") for k in res["rag"]: for x in res["rag"][k]: print(f"RAG {k:<34} {x['el'][:60]} align={x['align']} cw={x['cw']} widths={x['widths']}") g = sum(len(v) for v in res["gap"].values()) rg = sum(len(v) for v in res["rag"].values()) print("body-bg", bg, "GAP_TOTAL", g, "RAGGED_TOTAL", rg) (OUT / "rhythm.json").write_text(json.dumps(res, ensure_ascii=False, indent=1)) if g or rg: print("→ 纵向间距只准由 PageStack / 栅格 gutter 给:删掉页面里补的 mt-*/mb-*," "或给列容器 items-stretch 让子块撑满") return 1 return 0 if __name__ == "__main__": sys.exit(main())