nex_animation/scripts/ui/rhythmcheck.py

189 lines
10 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

#!/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;i<kids.length;i++){
const a=kids[i-1].getBoundingClientRect(),b=kids[i].getBoundingClientRect();
/* 「同一行」的三种形态都要跳过:top 齐平;纵向有重叠;横向根本不相接
(grid 多列 + items-center 时两个子块的 top 会差几十 px,只比 top 会把
并排的两块当成上下两块,量出 -30px 的假间距)。 */
const vOverlap = a.top < b.bottom - 1 && b.top < a.bottom - 1;
const sideBySide = a.right <= b.left + 1 || b.right <= a.left + 1;
if (Math.abs(a.top-b.top)<2 || vOverlap || sideBySide) continue;
// 末块确实钉在容器「内容底」(减掉下内边距,直接比 border box 会永远差一个 padding)
// 注意 isPin 要读**元素**——b 已经是 DOMRect 了,传进去永远判不出钉底
if (i===kids.length-1 && isPin(kids[i])) {
if (Math.abs(box.bottom-pb-b.bottom)<=2) continue;
}
gaps.push(Math.round(b.top-(a.top+a.height)));
}
if (!gaps.length) continue;
const uniq=[...new Set(gaps.map(g=>Math.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())