nex_animation/scripts/ui/feedbackcheck.py

206 lines
12 KiB
Python
Raw Normal View History

规范与闸门收口: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 15:58:44 +00:00
# -*- coding: utf-8 -*-
"""
第 9 道常驻闸:反馈四级表面必须真的是「自绘的那一套」,不许退回默认组件(R19)。
症状(2026-11 第十三轮 · 用户原话「整体修改系统中所有提示窗、完成后的反馈 tips 等。
不要使用默认组件」):改动做完之后,源码层由 classaudit 的第 6 条静态禁止
`window.confirm` / `message.*` / `notification.*`,但**静态查不出两件事实**——
① 运行时是否还有某条老路径真的弹出过原生对话框(`dialog` 事件);
② 自绘吐司是否真的**显示出来了**:ToastHost 挂错位置、provider 没渲染、
store 被引成第二份实例,都会让 notify() 静默返回、页面一条提示都不出,
而静态审计照样是 0。
做法:一条浏览器路径逐项验(视口 1440×900,明暗两套主题各跑一遍)——
A 全站禁止原生对话框:任何一次 `dialog`(alert / confirm / prompt)都算失败;
用户管理按其它模块的口径重做,卡头不再复读页签与角标 用户这一轮两条,其实是同一句话:**同一个信息在一屏里只许说一次,同一类操作在任何模块里必须是同一个动作**。 **1)用户管理:从「左右两栏 + 常驻表单」改成「列表 + 抽屉 + 行内动作」(UI规范新增 §13.5)** 它是站内唯一一个没跟上口径的模块:左列表 + 右详情面板各占一半、页面顶部常驻一张新建表单(还自带一套 `formDirty` / `keepForms` / `syncEdit` 脏检查)、表格没有操作列、五张统计卡只有数字不能点、 抽屉里那颗「允许登录」`Check` 与列表上的「停用」是同一件事的两种写法。逐条对齐资产库 / 模型管理中心: - 整行点开抽屉(`Table onPick`),**新建与编辑共用同一张 Drawer**(980px,与资产库编辑抽屉同宽)—— 关掉即放弃,于是压根不需要脏检查:Kit 没有的那层状态不再自己造; - 操作列四颗纯图标(编辑 / 重置密码 / 注销会话 / 停用⇄启用),逐个 `aria-label`,0 会话与停用自己分别 disabled,整列 `stopPropagation`,免得点图标连带打开压在底下的抽屉; - 四张统计卡**全部是筛选入口**(AS-7 同一口径),删掉第五张「活跃会话」:它不是入口,数字还被探针登录污染成四位数; - 后端 `GET /api/users` 新增 `status`(`active` / `disabled` / `pending`,非法值 400),与既有 `q` `role` 可叠加,`counts` 恒为全库数——统计卡点下去不会把自己的数字点没。「管理员」那张必须筛 `role=admin&status=active` 才与卡上的数一致(`counts.admins` 只数启用中的),`pending` 同理写 `must_change_password && is_active`:停用的账号本来就登不进去,不该再算「待改初始密码」; - 搜索 320ms 防抖(与资产库同一个值);`useAutoRefresh` 第 4 参带上「任一浮层开着」,30 秒轮询不再冲掉敲了一半的表单; - **停用与重置密码不能共用一张底部**:§10 那条动作条只许一颗 `type="primary"`,而停用确认是 `primary danger`。于是停用留在行内走 `confirmAction`,重置密码独立一张 Modal(新密码 + 两颗 Check)。 **2)卡头去掉重复的二级标题(§13.6)** 资产库卡头写「人物母版 / 共 10 个母版」,头顶页签写「人物母版 10」,卡底 `Pager` 写「共 10 条」, 第一张统计卡的 `hint` 再写一遍「人物 10 · 场景 6 · 声线 3」——同一句话在一屏里出现四遍。 卡头的 `title` 与 `sub` 整块删掉,只留右端视图切换器;数量交还 `Pager` 与页签角标;`hint` 换成 「点下去清空筛选,回到这一类母版的网格视图」这种只在这里才有的信息。模型管理中心是同一形状 (左栏已经选中「大模型」,卡头再来一句「大模型」):删 `title`,能力说明挂到计数的原生 `title` 上(G2)。 **3)顺着这次改动发现闸门自己有两个洞,一并补上** - `aligncheck` 与 `symmetrycheck` 的 BASE 写死 `localhost:5173`,而那台端口上跑着**另一个项目**: 十三页一个门牌都没量到,三个跨页集合全是空集、「最大跳动 0」,两把尺于是**空跑成绿**。 现在两把都认 `NEX_BASE` 并且自报样本数(`ALIGN_PROBED` 底线 40、`SYM_HEADS n/13` 底线 10), 掉到地板一律退出码 2——凡是「0 = 通过」的尺都必须报样本数,和 `FOOTER_PROBED` 同一条规矩。 - `feedbackcheck` 的 B 项靠 /users 页面上那颗常驻「保存」触发,保存搬进抽屉后它点不到东西直接抛异常 (而 `| tail` 把非零吞了,看上去还是绿的)。改成整行点开抽屉再点抽屉底部「保存账号」; **点完必须把指针挪开**——那颗主按钮正对着吐司的落位带,手留在那儿就等于一直 hover,C 永远读到 `paused`。 - `footercheck` 加进 `/users` 三张浮层;行内图标按钮没有可见文案,触发器新增 `@无障碍名` 写法按 `aria-label` 找。 验证(dev 跑在 :5199 / :8010,8000 与 5173 被 nex_buddy 占着) - 前端闸门:`classaudit.mjs` 六项全 0;`tsc --noEmit`、`npm run build` 通过。 - 探针全绿:aligncheck `ALIGN_PROBED 181` / 0 处(明暗两档)、symmetrycheck `SYM_HEADS 13/13` 三集合单值 {273}/{109}/{1391}(明暗两档)、tableaudit 0、gridcheck 0、rhythmcheck 0、 tagcheck 0(明暗)、btnrowcheck 413 组 0、btnclustercheck 154 簇 0、footercheck `FOOTER_PROBED 39 FOOTER_BAD_TOTAL 0`(加 /users 前 30)、feedbackcheck 明暗两套全过、 gateprobe 11/11、visualcheck 0 断言 0 HTTP 失败。 - 后端 `pytest -q` 全量 **503 passed / 1 skipped**(新增 `test_user_list_filters_are_server_side`: 三档状态筛选、`role`+`status`+`q` 叠加、counts 不随筛选变化、非法值 400)。 - 重启 dev 之后实测:点「管理员」卡 → 角色=管理员 状态=正常 → 表里 1 行 = 卡上 1、卡头「筛选出 1 / 3 个账号」; 点「待改初始密码」(0)→ 空态「没有匹配的账号,换个关键词或清空筛选。」;`status=nope` → 400。 - 手册 12 张插图整批重拍(`helpshots.py`):上一轮删掉的开发期说明还留在插图里—— 插图是静态 PNG、不参与构建,UI 每换一次皮肤这 12 张就整批过期。
2026-11-05 17:12:21 +00:00
B 真实路径的成功反馈:/users 整行点开编辑抽屉 → 抽屉底部「保存账号」→ 右下角出现 `.nex-toast`、
规范与闸门收口: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 15:58:44 +00:00
`.ant-message` 一个都不许有、吐司落在视口右下角的留白带里、倒计时条在跑;
C 悬停暂停:指针移到吐司上 → `.nex-toast-progress` 的 animation-play-state 必须是 paused,
移开恢复 running(条停了卡片却消失 = 半成品);
D 去重与堆叠上限:同一句话推两次只留一颗且标 ×2;连推 7 句只留 5 颗;
`notifyLoading` 那颗不自动消失且没有倒计时条;
E 关闭键是唯一的即时出口:点 `.nex-toast-close` 后吐司消失;
F 真实路径的确认框:/ 点某张卡的删除 → `.nex-confirm` 可见、
问话与后果分两行、footer 恰好一颗 primary 且是 dangerous;按 Esc 关掉后
项目数量不变(确认框不许替用户做决定)。
为什么探针要用**应用自己那份 store 模块**:Vite 加载的 URL 带 `?t=` 时间戳,
`import('/src/stores/notice.ts')` 会拿到第二份 zustand 实例——push 进了新队列,
界面上那颗永远不出现,探针于是变成假绿。所以先从 performance 资源表里
找回应用真正加载的那条 URL 再 import。
"""
import os
import sys
from playwright.sync_api import sync_playwright
BASE = os.environ.get("NEX_BASE", "http://localhost:5173")
SHOTS = "/tmp/nexw/feedbackshots"
os.makedirs(SHOTS, exist_ok=True)
TOL = 40 # 吐司离视口右/下边缘允许的留白区间(设计值 marginLG = 24)
# 应用加载的模块 URL 带着 HMR 时间戳,必须从 performance 资源表里捞回同一份实例
IMPORT_STORE = """
(name) => {
const hit = performance.getEntriesByType('resource').map(e => e.name)
.filter(n => n.includes('/src/stores/' + name + '.ts')).pop();
if (!hit) throw new Error('应用没有加载 stores/' + name + '.ts,探针无从触发');
return hit;
}
"""
fails = []
def check(cond, msg):
if not cond:
fails.append(msg)
return cond
def login(pg, theme):
pg.goto(BASE + "/login", wait_until="networkidle")
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)
def push(pg, tone, title, desc=None, duration=None):
"""用应用自己那份 notice 实例推一条吐司(等价于页面上任何一次 notify())"""
pg.evaluate(
"""async ([u, tone, title, desc, duration]) => {
const m = await import(u);
const fn = { ok: m.notify, bad: m.notifyBad, warn: m.notifyWarn, info: m.notifyInfo }[tone];
fn({ title, ...(desc ? { desc } : {}), ...(duration ? { duration } : {}) });
}""",
[pg.evaluate(IMPORT_STORE, "notice"), tone, title, desc, duration])
pg.wait_for_timeout(260)
def box(pg, sel):
return pg.locator(sel).last.bounding_box()
def run_theme(pw, theme):
b = pw.chromium.launch()
pg = b.new_page(viewport={"width": 1440, "height": 900})
dialogs = []
pg.on("dialog", lambda d: (dialogs.append(d.type), d.dismiss()))
login(pg, theme)
# ── B/C/D/E:吐司 ────────────────────────────────────────────────────────
pg.goto(BASE + "/users", wait_until="networkidle")
pg.wait_for_timeout(1600)
用户管理按其它模块的口径重做,卡头不再复读页签与角标 用户这一轮两条,其实是同一句话:**同一个信息在一屏里只许说一次,同一类操作在任何模块里必须是同一个动作**。 **1)用户管理:从「左右两栏 + 常驻表单」改成「列表 + 抽屉 + 行内动作」(UI规范新增 §13.5)** 它是站内唯一一个没跟上口径的模块:左列表 + 右详情面板各占一半、页面顶部常驻一张新建表单(还自带一套 `formDirty` / `keepForms` / `syncEdit` 脏检查)、表格没有操作列、五张统计卡只有数字不能点、 抽屉里那颗「允许登录」`Check` 与列表上的「停用」是同一件事的两种写法。逐条对齐资产库 / 模型管理中心: - 整行点开抽屉(`Table onPick`),**新建与编辑共用同一张 Drawer**(980px,与资产库编辑抽屉同宽)—— 关掉即放弃,于是压根不需要脏检查:Kit 没有的那层状态不再自己造; - 操作列四颗纯图标(编辑 / 重置密码 / 注销会话 / 停用⇄启用),逐个 `aria-label`,0 会话与停用自己分别 disabled,整列 `stopPropagation`,免得点图标连带打开压在底下的抽屉; - 四张统计卡**全部是筛选入口**(AS-7 同一口径),删掉第五张「活跃会话」:它不是入口,数字还被探针登录污染成四位数; - 后端 `GET /api/users` 新增 `status`(`active` / `disabled` / `pending`,非法值 400),与既有 `q` `role` 可叠加,`counts` 恒为全库数——统计卡点下去不会把自己的数字点没。「管理员」那张必须筛 `role=admin&status=active` 才与卡上的数一致(`counts.admins` 只数启用中的),`pending` 同理写 `must_change_password && is_active`:停用的账号本来就登不进去,不该再算「待改初始密码」; - 搜索 320ms 防抖(与资产库同一个值);`useAutoRefresh` 第 4 参带上「任一浮层开着」,30 秒轮询不再冲掉敲了一半的表单; - **停用与重置密码不能共用一张底部**:§10 那条动作条只许一颗 `type="primary"`,而停用确认是 `primary danger`。于是停用留在行内走 `confirmAction`,重置密码独立一张 Modal(新密码 + 两颗 Check)。 **2)卡头去掉重复的二级标题(§13.6)** 资产库卡头写「人物母版 / 共 10 个母版」,头顶页签写「人物母版 10」,卡底 `Pager` 写「共 10 条」, 第一张统计卡的 `hint` 再写一遍「人物 10 · 场景 6 · 声线 3」——同一句话在一屏里出现四遍。 卡头的 `title` 与 `sub` 整块删掉,只留右端视图切换器;数量交还 `Pager` 与页签角标;`hint` 换成 「点下去清空筛选,回到这一类母版的网格视图」这种只在这里才有的信息。模型管理中心是同一形状 (左栏已经选中「大模型」,卡头再来一句「大模型」):删 `title`,能力说明挂到计数的原生 `title` 上(G2)。 **3)顺着这次改动发现闸门自己有两个洞,一并补上** - `aligncheck` 与 `symmetrycheck` 的 BASE 写死 `localhost:5173`,而那台端口上跑着**另一个项目**: 十三页一个门牌都没量到,三个跨页集合全是空集、「最大跳动 0」,两把尺于是**空跑成绿**。 现在两把都认 `NEX_BASE` 并且自报样本数(`ALIGN_PROBED` 底线 40、`SYM_HEADS n/13` 底线 10), 掉到地板一律退出码 2——凡是「0 = 通过」的尺都必须报样本数,和 `FOOTER_PROBED` 同一条规矩。 - `feedbackcheck` 的 B 项靠 /users 页面上那颗常驻「保存」触发,保存搬进抽屉后它点不到东西直接抛异常 (而 `| tail` 把非零吞了,看上去还是绿的)。改成整行点开抽屉再点抽屉底部「保存账号」; **点完必须把指针挪开**——那颗主按钮正对着吐司的落位带,手留在那儿就等于一直 hover,C 永远读到 `paused`。 - `footercheck` 加进 `/users` 三张浮层;行内图标按钮没有可见文案,触发器新增 `@无障碍名` 写法按 `aria-label` 找。 验证(dev 跑在 :5199 / :8010,8000 与 5173 被 nex_buddy 占着) - 前端闸门:`classaudit.mjs` 六项全 0;`tsc --noEmit`、`npm run build` 通过。 - 探针全绿:aligncheck `ALIGN_PROBED 181` / 0 处(明暗两档)、symmetrycheck `SYM_HEADS 13/13` 三集合单值 {273}/{109}/{1391}(明暗两档)、tableaudit 0、gridcheck 0、rhythmcheck 0、 tagcheck 0(明暗)、btnrowcheck 413 组 0、btnclustercheck 154 簇 0、footercheck `FOOTER_PROBED 39 FOOTER_BAD_TOTAL 0`(加 /users 前 30)、feedbackcheck 明暗两套全过、 gateprobe 11/11、visualcheck 0 断言 0 HTTP 失败。 - 后端 `pytest -q` 全量 **503 passed / 1 skipped**(新增 `test_user_list_filters_are_server_side`: 三档状态筛选、`role`+`status`+`q` 叠加、counts 不随筛选变化、非法值 400)。 - 重启 dev 之后实测:点「管理员」卡 → 角色=管理员 状态=正常 → 表里 1 行 = 卡上 1、卡头「筛选出 1 / 3 个账号」; 点「待改初始密码」(0)→ 空态「没有匹配的账号,换个关键词或清空筛选。」;`status=nope` → 400。 - 手册 12 张插图整批重拍(`helpshots.py`):上一轮删掉的开发期说明还留在插图里—— 插图是静态 PNG、不参与构建,UI 每换一次皮肤这 12 张就整批过期。
2026-11-05 17:12:21 +00:00
# 管理类模块统一走「整行点开抽屉」(UI规范 §13.5),保存那颗按钮在抽屉底部:
# PATCH 的还是原值,不改数据,只验反馈 surface 是真的。
pg.locator('main button[aria-label="编辑账号"]').first.click()
pg.wait_for_timeout(900)
pg.locator(".ant-drawer-footer button:has-text('保存账号')").click()
# 指针必须挪开:抽屉底部那颗主按钮就在右下角,正对着吐司的落位带,
# 手留在那儿 = 一直 hover 着吐司,C 读到的倒计时条永远是 paused(探针自己造的假红)。
pg.mouse.move(24, 320)
规范与闸门收口: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 15:58:44 +00:00
pg.wait_for_timeout(900)
toasts = pg.locator(".nex-toast")
用户管理按其它模块的口径重做,卡头不再复读页签与角标 用户这一轮两条,其实是同一句话:**同一个信息在一屏里只许说一次,同一类操作在任何模块里必须是同一个动作**。 **1)用户管理:从「左右两栏 + 常驻表单」改成「列表 + 抽屉 + 行内动作」(UI规范新增 §13.5)** 它是站内唯一一个没跟上口径的模块:左列表 + 右详情面板各占一半、页面顶部常驻一张新建表单(还自带一套 `formDirty` / `keepForms` / `syncEdit` 脏检查)、表格没有操作列、五张统计卡只有数字不能点、 抽屉里那颗「允许登录」`Check` 与列表上的「停用」是同一件事的两种写法。逐条对齐资产库 / 模型管理中心: - 整行点开抽屉(`Table onPick`),**新建与编辑共用同一张 Drawer**(980px,与资产库编辑抽屉同宽)—— 关掉即放弃,于是压根不需要脏检查:Kit 没有的那层状态不再自己造; - 操作列四颗纯图标(编辑 / 重置密码 / 注销会话 / 停用⇄启用),逐个 `aria-label`,0 会话与停用自己分别 disabled,整列 `stopPropagation`,免得点图标连带打开压在底下的抽屉; - 四张统计卡**全部是筛选入口**(AS-7 同一口径),删掉第五张「活跃会话」:它不是入口,数字还被探针登录污染成四位数; - 后端 `GET /api/users` 新增 `status`(`active` / `disabled` / `pending`,非法值 400),与既有 `q` `role` 可叠加,`counts` 恒为全库数——统计卡点下去不会把自己的数字点没。「管理员」那张必须筛 `role=admin&status=active` 才与卡上的数一致(`counts.admins` 只数启用中的),`pending` 同理写 `must_change_password && is_active`:停用的账号本来就登不进去,不该再算「待改初始密码」; - 搜索 320ms 防抖(与资产库同一个值);`useAutoRefresh` 第 4 参带上「任一浮层开着」,30 秒轮询不再冲掉敲了一半的表单; - **停用与重置密码不能共用一张底部**:§10 那条动作条只许一颗 `type="primary"`,而停用确认是 `primary danger`。于是停用留在行内走 `confirmAction`,重置密码独立一张 Modal(新密码 + 两颗 Check)。 **2)卡头去掉重复的二级标题(§13.6)** 资产库卡头写「人物母版 / 共 10 个母版」,头顶页签写「人物母版 10」,卡底 `Pager` 写「共 10 条」, 第一张统计卡的 `hint` 再写一遍「人物 10 · 场景 6 · 声线 3」——同一句话在一屏里出现四遍。 卡头的 `title` 与 `sub` 整块删掉,只留右端视图切换器;数量交还 `Pager` 与页签角标;`hint` 换成 「点下去清空筛选,回到这一类母版的网格视图」这种只在这里才有的信息。模型管理中心是同一形状 (左栏已经选中「大模型」,卡头再来一句「大模型」):删 `title`,能力说明挂到计数的原生 `title` 上(G2)。 **3)顺着这次改动发现闸门自己有两个洞,一并补上** - `aligncheck` 与 `symmetrycheck` 的 BASE 写死 `localhost:5173`,而那台端口上跑着**另一个项目**: 十三页一个门牌都没量到,三个跨页集合全是空集、「最大跳动 0」,两把尺于是**空跑成绿**。 现在两把都认 `NEX_BASE` 并且自报样本数(`ALIGN_PROBED` 底线 40、`SYM_HEADS n/13` 底线 10), 掉到地板一律退出码 2——凡是「0 = 通过」的尺都必须报样本数,和 `FOOTER_PROBED` 同一条规矩。 - `feedbackcheck` 的 B 项靠 /users 页面上那颗常驻「保存」触发,保存搬进抽屉后它点不到东西直接抛异常 (而 `| tail` 把非零吞了,看上去还是绿的)。改成整行点开抽屉再点抽屉底部「保存账号」; **点完必须把指针挪开**——那颗主按钮正对着吐司的落位带,手留在那儿就等于一直 hover,C 永远读到 `paused`。 - `footercheck` 加进 `/users` 三张浮层;行内图标按钮没有可见文案,触发器新增 `@无障碍名` 写法按 `aria-label` 找。 验证(dev 跑在 :5199 / :8010,8000 与 5173 被 nex_buddy 占着) - 前端闸门:`classaudit.mjs` 六项全 0;`tsc --noEmit`、`npm run build` 通过。 - 探针全绿:aligncheck `ALIGN_PROBED 181` / 0 处(明暗两档)、symmetrycheck `SYM_HEADS 13/13` 三集合单值 {273}/{109}/{1391}(明暗两档)、tableaudit 0、gridcheck 0、rhythmcheck 0、 tagcheck 0(明暗)、btnrowcheck 413 组 0、btnclustercheck 154 簇 0、footercheck `FOOTER_PROBED 39 FOOTER_BAD_TOTAL 0`(加 /users 前 30)、feedbackcheck 明暗两套全过、 gateprobe 11/11、visualcheck 0 断言 0 HTTP 失败。 - 后端 `pytest -q` 全量 **503 passed / 1 skipped**(新增 `test_user_list_filters_are_server_side`: 三档状态筛选、`role`+`status`+`q` 叠加、counts 不随筛选变化、非法值 400)。 - 重启 dev 之后实测:点「管理员」卡 → 角色=管理员 状态=正常 → 表里 1 行 = 卡上 1、卡头「筛选出 1 / 3 个账号」; 点「待改初始密码」(0)→ 空态「没有匹配的账号,换个关键词或清空筛选。」;`status=nope` → 400。 - 手册 12 张插图整批重拍(`helpshots.py`):上一轮删掉的开发期说明还留在插图里—— 插图是静态 PNG、不参与构建,UI 每换一次皮肤这 12 张就整批过期。
2026-11-05 17:12:21 +00:00
if not check(toasts.count() >= 1, f"[{theme}] B 抽屉「保存账号」之后右下角没有出现自绘吐司"):
规范与闸门收口: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 15:58:44 +00:00
return pg, b
check(pg.locator(".ant-message").count() == 0, f"[{theme}] B 出现了 antd 默认 <message>(R19 禁)")
bx = box(pg, ".nex-toast")
gap_r = 1440 - (bx["x"] + bx["width"])
gap_b = 900 - (bx["y"] + bx["height"])
check(0 <= gap_r <= TOL, f"[{theme}] B 吐司没贴右下角留白带:距右缘 {gap_r:.0f}px(应 ≤{TOL})")
check(0 <= gap_b <= TOL, f"[{theme}] B 吐司没贴右下角留白带:距下缘 {gap_b:.0f}px(应 ≤{TOL})")
check(bx["x"] + bx["width"] / 2 > 720 and bx["y"] + bx["height"] / 2 > 450,
f"[{theme}] B 吐司不在右下象限:{bx['x']:.0f},{bx['y']:.0f}")
# 截图前先清干净,后面几项都从「屏上只有探针吐司」的状态出发
pg.evaluate("async (u) => (await import(u)).clearNotices()", pg.evaluate(IMPORT_STORE, "notice"))
pg.wait_for_timeout(400)
push(pg, "bad", "探针:失败反馈", "第二行放后果 / 明细,读不读得完由悬停决定")
state = pg.evaluate(
"""() => { const el = document.querySelector('.nex-toast .nex-toast-progress');
return el ? getComputedStyle(el).animationPlayState : 'none'; }""")
check(state == "running", f"[{theme}] C 倒计时条初始不是 running(读到 {state})")
pg.locator(".nex-toast").last.hover()
pg.wait_for_timeout(300)
state = pg.evaluate(
"""() => { const el = document.querySelector('.nex-toast .nex-toast-progress');
return el ? getComputedStyle(el).animationPlayState : 'none'; }""")
check(state == "paused", f"[{theme}] C 悬停后倒计时条没有暂停(读到 {state})")
pg.mouse.move(200, 700)
pg.wait_for_timeout(300)
state = pg.evaluate(
"""() => { const el = document.querySelector('.nex-toast .nex-toast-progress');
return el ? getComputedStyle(el).animationPlayState : 'none'; }""")
check(state == "running", f"[{theme}] C 移开后倒计时条没有恢复(读到 {state})")
pg.screenshot(path=f"{SHOTS}/f-{theme}-toast.png")
push(pg, "ok", "探针:重复的同一句话")
push(pg, "ok", "探针:重复的同一句话")
same = pg.locator(".nex-toast", has=pg.locator(".nex-toast-title", has_text="探针:重复的同一句话"))
check(same.count() == 1, f"[{theme}] D 同一句话推了两次,屏上出现 {same.count()} 颗(应去重成 1 颗)")
check(pg.locator(".nex-toast-count").count() >= 1
and "×2" in pg.locator(".nex-toast-count").first.inner_text(),
f"[{theme}] D 去重后没有用 ×N 说明真实发生次数")
pg.evaluate("async (u) => (await import(u)).clearNotices()", pg.evaluate(IMPORT_STORE, "notice"))
pg.wait_for_timeout(300)
for i in range(7):
push(pg, "info", f"探针:刷屏第 {i + 1} 颗")
check(toasts.count() == 5, f"[{theme}] D 连推 7 句后屏上有 {toasts.count()} 颗(堆叠上限应为 5)")
pg.evaluate("async (u) => (await import(u)).clearNotices()", pg.evaluate(IMPORT_STORE, "notice"))
pg.wait_for_timeout(300)
pg.evaluate("""async (u) => { const m = await import(u);
m.notifyLoading('探针:进行中的长任务'); }""", pg.evaluate(IMPORT_STORE, "notice"))
pg.wait_for_timeout(300)
if check(pg.locator(".nex-toast").count() == 1, f"[{theme}] D 进行中吐司没出现"):
check(pg.locator(".nex-toast .nex-toast-progress").count() == 0,
f"[{theme}] D 不自动消失的吐司画了倒计时条(时长 0 = 没有进度可言)")
pg.locator(".nex-toast .nex-toast-close").first.click()
pg.wait_for_timeout(400)
check(pg.locator(".nex-toast").count() == 0, f"[{theme}] E 关闭键没能关掉吐司")
# ── F:确认框(真实删除入口,按 Esc 取消,不改数据)─────────────────────────
pg.goto(BASE + "/", wait_until="networkidle")
pg.wait_for_timeout(1800)
cards_before = pg.locator('[title="删除这个项目"]').count()
check(cards_before >= 1, f"[{theme}] F 工作台找不到删除入口,确认框这一项没验到")
if cards_before:
pg.locator('[title="删除这个项目"]').first.click()
pg.wait_for_timeout(600)
confirm = pg.locator(".nex-confirm")
check(confirm.count() >= 1 and confirm.last.is_visible(),
f"[{theme}] F 删除没有弹出站内确认框(`.nex-confirm` 不可见)")
check(pg.locator(".ant-message").count() == 0, f"[{theme}] F 反馈链路里混进了 antd <message>")
check(pg.locator(".nex-confirm-title").count() == 1, f"[{theme}] F 确认框缺「一句问话」")
check(pg.locator(".nex-confirm-desc").count() == 1, f"[{theme}] F 确认框缺「一层后果」")
primaries = pg.locator(".nex-confirm .ant-modal-footer button.ant-btn-primary")
check(primaries.count() == 1, f"[{theme}] F 确认框底部有 {primaries.count()} 颗主按钮(最多一颗)")
check(primaries.count() == 1 and "ant-btn-dangerous" in (primaries.first.get_attribute("class") or ""),
f"[{theme}] F 删除这类不可恢复操作,主按钮没有用危险重点色")
pg.screenshot(path=f"{SHOTS}/f-{theme}-confirm.png")
pg.keyboard.press("Escape")
pg.wait_for_timeout(700)
check(not (pg.locator(".nex-confirm").count()
and pg.locator(".nex-confirm").last.is_visible()),
f"[{theme}] F 按 Esc 之后确认框还看得见")
check(pg.locator('[title="删除这个项目"]').count() == cards_before,
f"[{theme}] F 取消确认却删掉了项目({cards_before} → 变了)")
check(not dialogs, f"[{theme}] A 弹出了浏览器原生对话框:{dialogs}")
return pg, b
with sync_playwright() as pw:
for theme in ("light", "dark"):
pg, b = run_theme(pw, theme)
pg.close()
b.close()
if fails:
print("反馈四级表面 %d 处不合格:" % len(fails))
for f in fails:
print(" ✗ " + f)
sys.exit(1)
print("通过:原生对话框 0 次;吐司右下角 / 悬停暂停 / 去重 ×N / 上限 5 颗 / 关闭键生效;"
"确认框两层文案 + 唯一危险主按钮,明暗两套主题截图在 %s" % SHOTS)