用户管理按其它模块的口径重做,卡头不再复读页签与角标

用户这一轮两条,其实是同一句话:**同一个信息在一屏里只许说一次,同一类操作在任何模块里必须是同一个动作**。

**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 张就整批过期。
main
mula.liu 2026-11-06 01:12:21 +08:00
parent b504e31628
commit a73ce504c9
22 changed files with 516 additions and 296 deletions

View File

@ -257,15 +257,32 @@ def revoke_my_session(session_id: int, request: Request, user: User = Depends(re
# ------------------------------------------------------------------ 账号管理
#: 状态筛选的三档(页面顶部四张统计卡里的三张就是这三档,见 UI规范 §12)
STATUS_FILTERS = ("active", "disabled", "pending")
@router.get("/api/users")
def list_users(db: Session = Depends(get_db), _: User = Depends(require_admin),
q: str = "", role: str = "") -> dict:
q: str = "", role: str = "", status: str = "") -> dict:
"""账号列表。筛选一律在服务端做(与资产库 / 模型管理中心同口径):
`q` 跨字段、`role` 单档、`status`=正常 / 已停用 / 待改初始密码。
`counts` 恒为全库数,统计卡才不会因为「一点就把自己数字点没」而跳字。"""
rows = db.scalars(select(User).order_by(User.id)).all()
keyword = q.strip().lower()
if role and role not in Role.ALL:
raise HTTPException(400, "角色只能是 管理员 / 制作 / 观摩")
if status and status not in STATUS_FILTERS:
raise HTTPException(400, "状态只能是 正常 / 已停用 / 待改初始密码")
out = []
for row in rows:
if role and row.role != role:
continue
if status == "active" and not row.is_active:
continue
if status == "disabled" and row.is_active:
continue
if status == "pending" and not (row.must_change_password and row.is_active):
continue
if keyword and keyword not in " ".join([row.username, row.display_name, row.email, row.note]).lower():
continue
out.append(auth_service.public_user(db, row))

View File

@ -240,6 +240,52 @@ def test_admin_cannot_lock_itself_out(secured):
assert secured.get("/api/users", params={"role": "viewer"}).json()["items"][0]["username"] == "admin2"
def test_user_list_filters_are_server_side(secured, member):
"""账号列表的三档状态筛选(页面顶部三张统计卡点的就是它们)与 q / role 可叠加。
口径:`items` 跟随筛选,`counts` 恒为全库数——否则统计卡一点就把自己的数字点没了。
"""
watcher = member("viewer", "watcher")
maker = member("editor", "maker")
secured.cookies.clear()
sign_in(secured, **ADMIN)
def names(**params):
return [row["username"] for row in secured.get("/api/users", params=params).json()["items"]]
whole = secured.get("/api/users").json()
assert [row["username"] for row in whole["items"]] == ["admin", "watcher", "maker"]
assert whole["counts"]["total"] == 3 and whole["counts"]["disabled"] == 0
# 新建的账号一律先落在「待改初始密码」;播种出来的管理员用的还是默认口令,
# 所以它自己也在这一档里——这一档数的是「还没改过自己密码且还能登录」的账号。
assert whole["counts"]["pending_password"] == 3
assert names(status="pending") == ["admin", "watcher", "maker"]
assert names(status="active") == ["admin", "watcher", "maker"]
assert names(status="disabled") == []
# 管理员代改密码并勾掉「下次登录改密」之后,该账号才离开 pending 这一档
secured.post(f"/api/users/{maker}/password",
json={"new_password": "Rotated#2026", "must_change": False, "revoke_sessions": True})
assert names(status="pending") == ["admin", "watcher"]
secured.delete(f"/api/users/{watcher}")
assert names(status="disabled") == ["watcher"]
assert names(status="active") == ["admin", "maker"]
assert names(status="pending") == ["admin"] # 停用账号不再算待改口令
# 停用是「收回登录权」,不是从库里抹掉:全量列表与 counts 都还看得见它
disabled = secured.get("/api/users", params={"status": "disabled"}).json()
assert disabled["counts"]["total"] == 3 and disabled["counts"]["disabled"] == 1
# 角色 + 状态 + 关键词三个条件叠加,与页面上「统计卡 + 两条下拉 + 搜索框」一一对应
assert names(role="viewer", status="disabled") == ["watcher"]
assert names(q="wat", status="disabled") == ["watcher"]
assert names(q="wat", status="active") == []
# 非法档位直接 400,不让前端把拼错的参数静默当成「没筛」
assert secured.get("/api/users", params={"status": "nope"}).status_code == 400
assert secured.get("/api/users", params={"role": "nope"}).status_code == 400
def test_duplicate_username_rejected(secured):
sign_in(secured, **ADMIN)
res = secured.post("/api/users", json={"username": "admin", "password": "Another#2026"})

View File

@ -1066,7 +1066,7 @@ antd 的 `Tag.CheckableTag` 未选中态是**完全透明**的。铺进等宽格
| 平台资产库 | 仅疑似重复 / 仅多版本素材 | `duplicate_only` / 素材墙 `multi_only` | 保留(后者仅 `view==='media'`) |
| 平台资产库 | 每页 | `page_size` | **移出筛选栏** → `Pager` |
| 项目资产库 | 类型 / 状态 / 排序 | 与平台侧同一套参数 | 保留,同行 |
| 用户管理 | 角色 / 状态 | `GET /api/admin/users` | 保留,同行 |
| 用户管理 | 搜索 / 角色 / 状态 | `GET /api/users` 的 `q` `role` `status` | 保留,同行;四张统计卡是同一批参数的快捷入口(§13.5),`counts` 恒为全库数 |
| 仪表盘 | 事件类型 / 级别 | `GET /api/events` | 保留,同行 |
### 12.1 状态类下拉的唯一来源
@ -1149,7 +1149,7 @@ antd 的 `Tag.CheckableTag` 未选中态是**完全透明**的。铺进等宽格
提示条 / 确认框同一族,一大一小两档几何)。**不传 `icon` 就没有色块,正文满宽**;色块顶对齐标题
(它标的是「这一格是什么」),说明文字缩进正文列,不许钻到色块底下。
栅格一律 `StatGrid`,卡片列数走 `steps`,别在页面写 `grid-cols-*` 定宽;**每页卡数由内容决定**
(概览 8、用户 5、调度与交付 2),不为了凑齐一行删掉真实指标。
(概览 8、用户 4、调度与交付 2),不为了凑齐一行删掉真实指标。
**② 只读回显:一律 `Info`。** `Info` 的 label 列由 antd 上 `colorFillAlter` 底纹(深色档在 `app.css`
抬到 7% 白,4% 压不出「这一列是标签」),值列 `overflow-wrap:anywhere`。用法三约束:
@ -1290,6 +1290,55 @@ chromeless 页面(不套顶栏 / 侧栏,也不拉需要鉴权的 `/api/meta`
---
### 13.5 管理类模块统一口径:列表 + 抽屉 + 行内动作(2026-11-06 · 用户第 1 条)
**症状**:用户管理是唯一一个没跟上资产库 / 模型管理中心交互口径的页面——左右两栏常驻详情、
页面顶部常驻一张新建表单、表格没有操作列、五张统计卡只有数字不能点。
逐条改掉,并把「管理类模块」的口径写成可核对的六行:
| 部位 | 过去(用户管理) | 现在(与资产库 / 模型管理中心同一套) |
|---|---|---|
| 详情 | 左列表 + 右「选中详情」面板各占一半,右栏平时只回显几个字段,还要维护一个 `selectedId` | **整行点开抽屉**:`<Table onPick={openEdit}>`,与母版卡点击是同一个动作语义 |
| 新建 | 页面顶部一张永远摊开的表单,占掉首屏三分之一,自带一套 `formDirty` / `keepForms` / `syncEdit` 脏检查 | 页头一颗 `+ 新建账号` → **与编辑共用同一张抽屉**(`width="min(980px, calc(100vw - 24px))"`,与资产库编辑抽屉同宽)。关掉抽屉就是放弃,于是根本不需要脏检查——**Kit 没有的那层状态不要自己造** |
| 行内动作 | 无操作列,停用 / 改密 / 注销会话散在详情面板的按钮排里 | 操作列四颗**纯图标** `type="text"` 按钮(编辑 / 重置密码 / 注销会话 / 停用⇄启用),逐个 `aria-label`;0 会话时「注销」disabled、停用自己 disabled;整列 `onCell` 里 `stopPropagation`,否则点图标会连带打开压在底下的抽屉 |
| 统计卡 | 五张纯展示卡,其中「活跃会话」既不是筛选入口、数字又被探针登录污染成四位数 | 四张卡**全是筛选入口**(AS-7 · §13.1),点下去等价于填筛选栏;「账号总数」那张回到的是「清空筛选」 |
| 状态语义 | 抽屉里一颗「允许登录」`Check`,与列表上的「停用」是同一件事的两种写法 | 停只在行内,抽屉只管资料;`sub` 那一行放**只读事实**(`#id · 登录名 … · 由谁创建`) |
| 筛选 | 一次拉全量再本地 `filter`,卡上的「共 N 个账号」与表里的行数各说各话 | `GET /api/users` 的 `q` `role` `status` 服务端筛(§12),搜索 320ms 防抖(与资产库同一个值),`counts` 恒为全库数,卡头右端回显「筛选出 X / Y 个账号」 |
四条硬约束(都是从别的模块抄来的,别在管理页里再发明一遍):
- **卡上的数字与点进去的行数必须一致**:`counts.admins` 只数**启用中**的管理员,这张卡就必须筛
`role=admin&status=active`;只筛 `role=admin` 的话点进去比卡上多出一个停用账号。
后端 `pending` 同理写成 `must_change_password && is_active`——停用的账号本来就登不进去,
不该再算「待改初始密码」。
- **停用与重置密码不许共用一张底部**:§10 那条动作条只允许一颗 `type="primary"`,
而停用确认是 `type="primary" danger`,同一排放不下两颗 primary。
于是停用留在行内(走 `confirmAction`),重置密码独立一张 `<Modal width={560}>`。
- **自动刷新不许冲掉浮层**:`useAutoRefresh(fn, 30000, reading || !!busy, !!form || !!pwd)`——
第 4 个参数 `paused` 必须带上「任一浮层开着」,否则 30 秒一次的轮询会盖掉敲了一半的表单。
- **`footercheck` 必须跟着加 CASES**:`/users`(新建账号 / `@编辑账号` / `@重置密码`)。
行内那种只有图形的图标按钮没有可见文案,触发器写 `@无障碍名` 按 `aria-label` 找。
**点出来的浮层是新表面,没进闸门就等于没有**(§15.7 那条老规矩)。
### 13.6 卡头不许复读页签、角标与分页条(2026-11-06 · 用户第 2 条)
**症状**:资产库卡头写着「人物母版」+「共 10 个母版」,而它头顶的页签写着同一句
「人物母版 10」,卡底 `Pager` 又写一遍「共 10 条」,第一张统计卡的 `hint` 再写一遍
「人物 10 · 场景 6 · 声线 3」——**同一句话在 40px 内出现四遍**。
模型管理中心是同一形状:左栏已经选中「大模型」,卡头再来一句「大模型」。
- **一个层级只说一次**:卡头(`.ant-card-head`)的职责是「这一栏是什么」,
页签 / 左栏已经说过的就整块删 `title`;数量归页签角标与 `Pager`,卡头 `sub` 不再复读。
- **删空之后的卡头只留右端 `extra` 是合法形态**(视图切换器、以及「共 N 个账号」这类
**随筛选变化**的只读回显),不必为了「左边不能空」把标题塞回去。
- **别顺手删掉统计卡的 `hint`**:重复的是数字,不是解释。第一张卡的 `hint` 换成
「点下去清空筛选,回到这一类母版的网格视图」这种**只在这里才有的信息**。
- 探针侧只有一处要留意:`aligncheck` ② 那条父子尺拿 `.ant-card-head-title` 定位,
只剩 `extra` 的卡头少一个样本。它量的是渲染结果,不要求每页样本数相同——
看的是 `ALIGN_PROBED` 总有没有掉到地板(本轮实测 181 / 底线 40),不是数标题。
---
## 14. 说明文字与表单增删(G1/G2/G3/G4/G5)
背景:分镜编辑页的老毛病是「每加一个东西就新增一行」——一行只有一个小按钮,
@ -1675,7 +1724,8 @@ NEX_ROUTES="/projects/{id}/review" NEX_THEMES=light \
未分层赢过分层,于是页面里写 `mb-0` **压不住** kit 的下边距。归零必须写在同一层、按结构命中
(`app.css` 里那两条卡头归零尺)。
用法 `.venv/bin/python -u scripts/ui/aligncheck.py [theme] [width]`,默认 light / 1440 跑 13 个内容页。
用法 `NEX_BASE=http://127.0.0.1:5173 .venv/bin/python -u scripts/ui/aligncheck.py [theme] [width]`,
默认 light / 1440 跑 13 个内容页。
**反向验证(第十四轮)**:摘掉 `app.css` 那两条卡头归零尺重跑 → 报 3 处并点名
(④调度 `父·.ant-card-head-title` 偏 6、④调度 `父·.ant-card-extra` 偏 6、⑤质检 `父·.ant-card-extra` 偏 6);
装回 → `通过:全站 0 处同一行不同心 / 只读胶囊继承到标题字重`。
@ -1703,7 +1753,15 @@ NEX_ROUTES="/projects/{id}/review" NEX_THEMES=light \
第 ② 条一开始是**漏判**的:探针原先只比对「第一行里含按钮的直接子件」,挪进说明行之后
它被当成「本页没有主操作」放过——跨页尺必须把门牌里**任何**游离的 `.nex-action-group`
都抓出来,否则回归会静默通过(闸门安静返回 0 比误报更危险,同 §15.12 那条)。
用法 `.venv/bin/python -u scripts/ui/symmetrycheck.py [theme] [width]`,默认 light / 1440。
用法 `NEX_BASE=… .venv/bin/python -u scripts/ui/symmetrycheck.py [theme] [width]`,默认 light / 1440。
**两把尺都认 `NEX_BASE`,且都必须自报样本数(2026-11-06 补)**:它们早先把端口写死成
`localhost:5173`,而那台端口上跑着**另一个项目**——十三页一个门牌都没量到,
于是 `通过:全站 0 处` 与 `SYM_TOTAL 0` 双双**空跑变绿**,「跨页最大跳动 0」的真相是
压根没有第二个样本。现在 `aligncheck` 打印 `ALIGN_PROBED`(量到的容器数,底线 40,
`NEX_MIN_PROBED` 可覆盖)、`symmetrycheck` 打印 `SYM_HEADS n/13`(底线 10,`NEX_MIN_HEADS` 可覆盖),
掉到地板一律**退出码 2**(闸门自己坏了),不再冒充通过。与 §15.10 的 `FOOTER_PROBED`、
§15.12「闸门安静返回 0 比误报更危险」是同一条规矩:**凡是「0 = 通过」的尺都必须报样本数**。
### 15.9 `.venv/bin/python scripts/ui/feedbackcheck.py` —— 运行时证明反馈不是默认组件(R19)
@ -1714,8 +1772,10 @@ provider 漏渲染、store 被引成第二份实例,都会让 `notify()` 静
明暗两套主题各跑一遍(视口 1440×900),六组断言:
1. **A 原生框禁绝**:`page.on('dialog')` 记下任何一次 alert / confirm / prompt,有就算失败;
2. **B 真实路径的成功反馈**:`/users` 点「保存」(PATCH 同一个值,不改数据)→ `.nex-toast` 出现、
`.ant-message` 必须一个都不许有、吐司落在视口右下角留白带(离右 / 下缘 ≤40px、中心在右下象限);
2. **B 真实路径的成功反馈**:`/users` 整行点开编辑抽屉 → 抽屉底部「保存账号」(PATCH 同一个值,不改数据)
→ `.nex-toast` 出现、`.ant-message` 必须一个都不许有、吐司落在视口右下角留白带(离右 / 下缘 ≤40px、中心在右下象限);
**点完必须把指针挪开**(`pg.mouse.move`):抽屉那颗主按钮就在右下角,正对着吐司的落位带,
手留在那儿 = 一直 hover 着吐司,C 会读到 `paused`(2026-11-06 探针自己造的假红);
3. **C 悬停暂停**:`.nex-toast-progress` 的 `animation-play-state` 必须 running → hover 后 paused →
移开恢复 running(条停了卡片却消失 = 半成品);
4. **D 队列语义**:同文案推两次只留一颗且标 `×2`;连推 7 句只剩 5 颗;`notifyLoading` 那颗不自动消失且**没有**倒计时条;
@ -1743,7 +1803,8 @@ provider 漏渲染、store 被引成第二份实例,都会让 `notify()` 静
|---|---|
| 量什么 | `.ant-drawer-footer` / `.ant-modal-footer` / `.ant-modal-confirm-btns` 里可见的 `button`(`display:none` 的层与嵌套按钮各只算一次) |
| 判据 | 同一底部里按钮的垂直中心落在 **2 条以上水平线** = 这一组被劈开;唯一合法的多行 = **整组竖排等宽**(每行一颗、每颗宽 ≥ 底部内宽的 92%)——于是 2+1 / 2+2 点名,430 档三颗满宽竖排放行 |
| CASES | `/assets`(编辑 / 新建人物 / 引入项目;勾一行后再开 打标签 / 批量 / 删除)、`/projects/10/library`(新建人物 / 场景 / 声线 / 打开生成台 / 编辑)、`/models`(添加大模型 / 配置)、`/projects/10/storyboard`(导入脚本 / 关键帧),外加 `BRIEF`=概览页 `button.nex-console` 展开的项目概况抽屉(含删除二次确认态那 4 颗,全站唯一 4 按钮底部) |
| CASES | `/assets`(编辑 / 新建人物 / 引入项目;勾一行后再开 打标签 / 批量 / 删除)、`/users`(新建账号 / `@编辑账号` / `@重置密码`,§13.5 那张抽屉与那张独立弹窗)、`/projects/10/library`(新建人物 / 场景 / 声线 / 打开生成台 / 编辑)、`/models`(添加大模型 / 配置)、`/projects/10/storyboard`(导入脚本 / 关键帧),外加 `BRIEF`=概览页 `button.nex-console` 展开的项目概况抽屉(含删除二次确认态那 4 颗,全站唯一 4 按钮底部) |
| 触发器写法 | 默认按**可见文案**找按钮;行内那种只有图形的图标按钮没有文案,写 `@无障碍名` 走 `main button[aria-label="…"]`(2026-11-06 随 `/users` 补) |
| 覆盖口径 | 2 颗(取消+主行动)/ 3 颗(辅助 `mr-auto` + 取消 + 主行动)/ 4 颗(确认态多一颗取消)三种底部形态 |
| 死闸门底线 | 报 `FOOTER_PROBED n`;`n < MIN_PROBED`(默认 8,`NEX_MIN_PROBED` 可覆盖)= 触发器或选择器漂了,闸门在**假装通过** → 退出码 2 |
| 退出码 | 0 = 干净;1 = 有点名;2 = 一道都没量到(闸门自己坏了) |
@ -1751,6 +1812,7 @@ provider 漏渲染、store 被引成第二份实例,都会让 `notify()` 静
判据在 JS 里算好 `bad` 并带上 `cls`,`main` 与 `gateprobe` 共用同一条尺子——
反向验证不许拿一份抄本去测。2026-11-03 三档(1440 / 576 / 430)全量:
**`FOOTER_PROBED 30 FOOTER_BAD_TOTAL 0`**(改前同一批是 430 档 2 条)。
2026-11-06 加进 `/users` 三张浮层后同一批全量:**`FOOTER_PROBED 39 FOOTER_BAD_TOTAL 0`**。
单档耗时约 19 分钟(每条 CASE 都要开层、量、`Esc`),别把它塞进秒级反馈回路里。
### 15.11 `.venv/bin/python scripts/ui/btnclustercheck.py` —— 不认类名量「一组按钮被劈开」(§7 · 用户第 2 条)

Binary file not shown.

Before

Width:  |  Height:  |  Size: 320 KiB

After

Width:  |  Height:  |  Size: 316 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 290 KiB

After

Width:  |  Height:  |  Size: 288 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 340 KiB

After

Width:  |  Height:  |  Size: 331 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 321 KiB

After

Width:  |  Height:  |  Size: 319 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 205 KiB

After

Width:  |  Height:  |  Size: 201 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 288 KiB

After

Width:  |  Height:  |  Size: 286 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 420 KiB

After

Width:  |  Height:  |  Size: 417 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 308 KiB

After

Width:  |  Height:  |  Size: 304 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 267 KiB

After

Width:  |  Height:  |  Size: 266 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 514 KiB

After

Width:  |  Height:  |  Size: 511 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 339 KiB

After

Width:  |  Height:  |  Size: 337 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 219 KiB

After

Width:  |  Height:  |  Size: 215 KiB

View File

@ -1014,7 +1014,7 @@ export default function AssetLibrary() {
<Stat tone="lead" icon={<IconLibrary />} label="母版资产" value={totals.human + totals.scene + totals.voice}
title="查看全部母版:清空筛选并回到网格视图"
active={view !== 'media' && !filtersActive} onClick={focusMasters}
hint={`人物 ${totals.human} · 场景 ${totals.scene} · 声线 ${totals.voice}`} />
hint="点下去清空筛选,回到这一类母版的网格视图" />
<Stat icon={<IconBlocks />} label="已登记素材" value={totals.media}
title="切换到跨母版的「全部素材」视角,直接翻找图片与音频"
active={view === 'media'} onClick={focusWall}
@ -1044,18 +1044,14 @@ export default function AssetLibrary() {
以前外面套一层什么都不管的 <section>,卡自己又写 p-4(antd 的卡身内边距
于是变成两层),筛选条再自己描一次边——卡里套盒子,盒子里再套盒子。 */}
<Panel>
<PanelHead
title={view === 'media' ? '全部素材墙' : `${typeMeta.label}母版`}
sub={view === 'media'
? <>共 {wall.total} 个素材,当前第 {wall.page} / {wall.pages} 页 · 素材墙按<b>当前类型</b>过滤:{typeMeta.label}素材 {wall.stats?.by_owner?.[type] || 0} 个</>
: filtersActive
? `筛选出 ${resultCount} 个母版,本页 ${rows.length} 个(第 ${summary.page} / ${summary.pages} 页)`
: `共 ${resultCount} 个母版`}
/* 不给 block:PanelHead 的 right 是 flex-wrap 容器,宽度由内容决定,
block 会把三段等分成 1/3,最长的「全部素材」装不下就被
.ant-segmented-item-label 的 overflow:hidden 裁掉半个字。 */
right={<ViewSwitch value={view} onChange={chooseView} items={VIEW_ITEMS}
className="shrink-0" />} />
{/* 卡头不再写标题:这一屏看的是「哪一类 / 哪个视角」,上方页签与右端切换器
已经各说了一遍,卡头第三次复述就成了三级重复标题(§14 G2)。
数量与页码交给卡底的 <Pager>——它本来就是干这件事的。
不给 block:PanelHead 的 right 是 flex-wrap 容器,宽度由内容决定,
block 会把切换器裁成 1/3 宽,最长的「全部素材」装不下就被
.ant-segmented-item-label 的 overflow:hidden 切掉半个字。 */}
<PanelHead right={<ViewSwitch value={view} onChange={chooseView} items={VIEW_ITEMS}
className="shrink-0" />} />
{/* 筛选栏:坐在卡正文里,不再自己描边(站内有边框的横块只有 Card 一种)。
「每页」不在这里——分页条是 page_size 唯一的家(UI规范 §5)。 */}

View File

@ -582,10 +582,11 @@ export default function ModelCenter() {
<Panel className="bg-bg-container">
{/* 同项目总览:卡头右端只放计数,筛选条放正文(见 Dashboard 同处注释) */}
{/* 「搜索」以前独占一行且右端全空:一个控件不配一行,收进卡头右端与计数同排(R2) */}
{/* 左栏那一列已经把能力名说了一遍,卡头再写一次就是同级重复标题;
能力说明挂在计数的原生 title 上(§14 G2:口径不占版面)。 */}
<PanelHead
title={<span title={selectedMeta?.description}>{selectedMeta?.label}</span>}
right={<>
<Value>{currentRows.length} / {countOf(selectedType)} 个配置</Value>
<Value title={selectedMeta?.description}>{currentRows.length} / {countOf(selectedType)} 个配置</Value>
<Field inline label="搜索" width="wide">
<SearchInput value={keyword} aria-label="搜索模型" placeholder="名称 / 模型标识 / 编码" onChange={(e) => setKeyword(e.target.value)} />
</Field>

View File

@ -1,22 +1,35 @@
/**
* 用户管理(仅管理员):账号列表 / 新建 / 详情编辑 / 重置密码 / 操作流水。
* 用户管理(仅管理员)。
*
* 账号列表到点自动刷新,页头不放任何刷新控件。但自动刷新不能把管理员
* 正在敲的表单冲掉:syncEdit() 会用服务端值重写 edit/reset 两个表单,
* 因此只要这几块里有没保存的内容,就暂停轮询,保存完自动恢复。
* 交互口径与资产库 / 模型管理中心完全一致(UI规范 §13.5):统计卡就是筛选入口、
* 搜索与筛选在服务端做、整行点开抽屉、"新建"与"编辑"共用同一张抽屉、
* 停用 / 重置密码 / 注销会话是行内动作。页头只留一颗主操作「新建账号」。
*
* 自动刷新只在浮层没打开时进行——抽屉里的表单不能被轮询冲掉。
*/
import { useCallback, useEffect, useState } from 'react'
import * as api from '../api/client'
import { fmtAgo, fmtTime } from '../lib/format'
import { useAutoRefresh } from '../hooks'
import { SecretInput, Select } from '../components/forms'
import { ActionGroup, Actions, Badge, Button, Check, Ctlbar, Empty, ErrorText, Field, FieldBlock, FormRow, Heading, Input, Layout, MUTED, MUTED_MONO, Mono, PageHead, PageStack, Panel, PanelHead, SearchInput, Stack, Stat, StatGrid, Sub, Table, Tag, TextArea } from '../components/ui'
import { Button, Check, Ctlbar, Drawer, Empty, Field, FormGrid, FormRow, Input, LogBox, LogRow, Modal, MONO, MUTED_MONO, Notice, PageHead, PageStack, Panel, PanelHead, Row, SearchInput, Spinner, Stat, StatGrid, Table, Tag, TextArea, Value } from '../components/ui'
import { notify, notifyBad } from '../stores/notice'
import { confirmAction } from '../stores/confirm'
import { roleLabel, useAuthStore } from '../stores/auth'
import { IconAdd, IconCheck, IconClock, IconKey, IconLogout, IconStop, IconTeam, IconUser } from '../components/icons'
import { IconAdd, IconCheck, IconClose, IconEdit, IconKey, IconLogout, IconShield, IconStop, IconUser } from '../components/icons'
const NOWRAP = 'whitespace-nowrap'
const FALLBACK_ROLES = ['admin', 'editor', 'viewer'].map((v) => ({ value: v, label: roleLabel(v) }))
const STATUS_OPTIONS = [
{ value: '', label: '全部状态' },
{ value: 'active', label: '正常' },
{ value: 'disabled', label: '已停用' },
{ value: 'pending', label: '待改初始密码' }
]
const BLANK = { username: '', password: '', display_name: '', email: '', role: 'editor', note: '' }
type Draft = typeof BLANK & { id?: number }
type PwdTicket = { row: any; password: string; must_change: boolean; revoke_sessions: boolean }
export default function UserAdmin() {
const auth = useAuthStore()
@ -26,303 +39,345 @@ export default function UserAdmin() {
const [counts, setCounts] = useState<any>({})
const [error, setError] = useState('')
const [busy, setBusy] = useState('')
const [reading, setReading] = useState(false)
const [search, setSearch] = useState('')
const [keyword, setKeyword] = useState('')
const [roleFilter, setRoleFilter] = useState('')
const [selectedId, setSelectedId] = useState<number | null>(null)
const [create, setCreate] = useState({ username: '', password: '', display_name: '', email: '', role: 'editor', note: '' })
const [edit, setEdit] = useState({ display_name: '', email: '', role: 'editor', is_active: true, note: '' })
const [reset, setReset] = useState({ password: '', must_change: true, revoke_sessions: true })
const [statusFilter, setStatusFilter] = useState('')
const [form, setForm] = useState<Draft | null>(null)
const [pwd, setPwd] = useState<PwdTicket | null>(null)
const roleOptions = roles.length ? roles : FALLBACK_ROLES
const selected = users.find((row) => row.id === selectedId) || null
const visible = users.filter((row) => {
if (roleFilter && row.role !== roleFilter) return false
const q = keyword.trim().toLowerCase()
if (!q) return true
return [row.username, row.display_name, row.email, row.note].join(' ').toLowerCase().includes(q)
})
const filtersActive = !!(keyword || roleFilter || statusFilter)
const editing = !!form?.id
/** 详情表单是否已被服务端数据覆盖过(切行时同步一次,避免每次渲染都重置输入框) */
const syncEdit = useCallback((row: any) => {
if (!row) return
setEdit({
display_name: row.display_name || '', email: row.email || '',
role: row.role || 'editor', is_active: !!row.is_active, note: row.note || ''
})
setReset({ password: '', must_change: true, revoke_sessions: true })
}, [])
const load = useCallback(async (silent = true, keepForms = false) => {
if (!silent) setBusy('读取账号')
const load = useCallback(async () => {
setReading(true)
setError('')
try {
const [list, trail] = await Promise.all([
api.get('/api/users'),
api.get('/api/users', { q: keyword, role: roleFilter, status: statusFilter }),
api.get('/api/users/audit', { limit: 60 })
])
const items: any[] = list.items || []
setUsers(items)
setUsers(list.items || [])
if (list.roles?.length) setRoles(list.roles)
setCounts(list.counts || {})
setAudit(trail.items || [])
setSelectedId((cur) => {
if (items.some((row) => row.id === cur)) return cur
return items[0]?.id ?? null
})
if (!keepForms) syncEdit(items.find((row) => row.id === selectedId) || items[0])
} catch (exc: any) {
setError(exc?.message || String(exc))
} finally {
setBusy('')
setReading(false)
}
// eslint-disable-next-line react-hooks/exhaustive-deps
}, [selectedId, syncEdit])
}, [keyword, roleFilter, statusFilter])
useEffect(() => { void load(false) }, [])
useEffect(() => { void load() }, [load])
useAutoRefresh(() => void load(), 30000, reading || !!busy, !!form || !!pwd)
const formDirty = !!selected && (
edit.display_name !== (selected.display_name || '') || edit.email !== (selected.email || '')
|| edit.role !== (selected.role || 'editor') || edit.is_active !== !!selected.is_active
|| edit.note !== (selected.note || ''))
|| !!reset.password
|| !!(create.username || create.password || create.display_name || create.email || create.note)
/** 关键词防抖:与资产库同一条 320ms,中文输入法连打半截拼音时不反复查库 */
useEffect(() => {
const timer = window.setTimeout(() => setKeyword(search), 320)
return () => window.clearTimeout(timer)
}, [search])
useAutoRefresh(() => void load(true, true), 30000, !!busy, formDirty)
function pick(row: any) {
setSelectedId(row.id)
syncEdit(row)
const patch = (next: Partial<Draft>) => setForm((cur) => ({ ...(cur || BLANK), ...next }))
const clearFilters = () => { setSearch(''); setKeyword(''); setRoleFilter(''); setStatusFilter('') }
/** 统计卡切筛选:整张卡代表一组条件,点下去就是"只看这一批",因此先清掉别的条件 */
const focusWith = (role: string, status: string) => {
setSearch(''); setKeyword(''); setRoleFilter(role); setStatusFilter(status)
}
const openCreate = () => setForm({ ...BLANK })
const openEdit = (row: any) => setForm({
id: row.id, username: row.username, password: '',
display_name: row.display_name || '', email: row.email || '',
role: row.role || 'editor', note: row.note || ''
})
async function createUser() {
if (!create.username.trim() || !create.password) { notifyBad('用户名和密码都不能为空'); return }
setBusy('新建账号'); setError('')
async function save() {
if (!form) return
if (!editing && (!form.username.trim() || !form.password)) { notifyBad('用户名和初始密码都不能为空'); return }
setBusy(editing ? '保存账号' : '新建账号')
setError('')
try {
const made = await api.post('/api/users', { ...create, username: create.username.trim() })
const name = made?.username || create.username.trim()
setCreate({ username: '', password: '', display_name: '', email: '', role: create.role, note: '' })
setSelectedId(made?.id ?? null)
await load(true, true)
notify(`账号已创建:${name}`)
if (editing) {
await api.patch(`/api/users/${form.id}`, {
display_name: form.display_name, email: form.email, role: form.role, note: form.note
})
notify(`账号「${form.username}」已更新`)
} else {
const made = await api.post('/api/users', { ...form, username: form.username.trim() })
notify(`账号已创建:${made?.username || form.username.trim()}`)
}
setForm(null)
await load()
} catch (exc: any) { setError(exc?.message || String(exc)) }
finally { setBusy('') }
}
async function saveEdit() {
if (!selected) return
setBusy('保存账号'); setError('')
async function toggleActive(row: any) {
const off = !!row.is_active
if (off) {
const ok = await confirmAction({
title: `停用「${row.display_name || row.username}」?`,
desc: '停用后该账号无法登录,其全部会话立即注销,历史操作记录仍会保留。',
tone: 'warn', confirmText: '停用', confirmIcon: <IconStop />
})
if (!ok) return
}
setBusy(off ? '停用账号' : '启用账号')
setError('')
try {
await api.patch(`/api/users/${selected.id}`, { ...edit })
await load(true, true)
notify(`账号「${selected.username}」已更新`)
if (off) await api.del(`/api/users/${row.id}`)
else await api.patch(`/api/users/${row.id}`, { is_active: true })
await load()
notify(`账号「${row.username}」已${off ? '停用' : '启用'}`)
} catch (exc: any) { setError(exc?.message || String(exc)) }
finally { setBusy('') }
}
async function kickSessions(row: any) {
const ok = await confirmAction({
title: `注销「${row.display_name || row.username}」的登录会话?`,
desc: `${row.active_sessions || 0} 台设备需要重新登录,账号本身不受影响。`,
tone: 'warn', confirmText: '注销会话', confirmIcon: <IconLogout />
})
if (!ok) return
setBusy('注销会话')
setError('')
try {
const data = await api.post(`/api/users/${row.id}/sessions/revoke`)
await load()
notify(`已注销「${row.username}」的 ${data?.revoked ?? 0} 个会话`)
} catch (exc: any) { setError(exc?.message || String(exc)) }
finally { setBusy('') }
}
async function resetPassword() {
if (!selected || !reset.password) { notifyBad('请先填写新密码'); return }
setBusy('重置密码'); setError('')
if (!pwd) return
if (!pwd.password) { notifyBad('请先填写新密码'); return }
const target = pwd.row
setBusy('重置密码')
setError('')
try {
await api.post(`/api/users/${selected.id}/password`, { ...reset })
setReset((r) => ({ ...r, password: '' }))
await load(true, true)
notify(`已重置「${selected.username}」的密码${reset.revoke_sessions ? ',并注销其全部会话' : ''}`)
} catch (exc: any) { setError(exc?.message || String(exc)) }
finally { setBusy('') }
}
async function kickSessions() {
if (!selected) return
setBusy('注销会话'); setError('')
try {
const data = await api.post(`/api/users/${selected.id}/sessions/revoke`)
await load(true, true)
notify(`已注销「${selected.username}」的 ${data?.revoked ?? 0} 个会话`)
} catch (exc: any) { setError(exc?.message || String(exc)) }
finally { setBusy('') }
}
async function disable() {
if (!selected) return
const ok = await confirmAction({
title: `停用「${selected.display_name || selected.username}」?`,
desc: '停用后该账号无法登录,历史操作记录仍会保留。',
tone: 'warn', confirmText: '停用', confirmIcon: <IconStop />
})
if (!ok) return
setBusy('停用账号'); setError('')
try {
await api.del(`/api/users/${selected.id}`)
await load(true, true)
notify(`账号「${selected.username}」已停用`)
await api.post(`/api/users/${target.id}/password`, {
new_password: pwd.password, must_change: pwd.must_change, revoke_sessions: pwd.revoke_sessions
})
setPwd(null)
await load()
notify(`已重置「${target.username}」的密码${pwd.revoke_sessions ? ',并注销其全部会话' : ''}`)
} catch (exc: any) { setError(exc?.message || String(exc)) }
finally { setBusy('') }
}
return (
<PageStack className="min-w-0">
<PageHead title="用户管理" />
<ErrorText className="text-xs">{error}</ErrorText>
<PageHead
title={<span title="账号、角色与会话在这里维护。停用只收回登录权,历史操作仍记在原账号名下;角色决定谁能改账号与模型配置。">用户管理</span>}
actions={<Button icon={<IconAdd />} type="primary" onClick={openCreate}>新建账号</Button>}
/>
<Notice danger>{error}</Notice>
{/* 统计卡一共 5 项:给 5 列,别让第 5 张孤零零掉到第二行 */}
{/* 症状:档位写成「≤1600 三列」,而 1440 正是最常见的宽度——5 张卡排成 3+2,
右下角留一个空位,看着像少了一张卡。5 这一档本来就排得下(每张 ~214px,
标签最长 6 个字),宽屏一列铺满,窄下去才降列。 */}
{/* 五张统计卡:≥1200 就一排放完(列宽换算见 grid.tsx 的 flex 档,不再取整掉行) */}
<StatGrid steps={[{ at: 'lg', cols: 3 }, { at: 'md', cols: 2 }, { at: 'sm', cols: 1 }]}>
<Stat icon={<IconUser />} label="账号总数" value={counts.total ?? users.length} />
<Stat icon={<IconTeam />} label="管理员" value={counts.admins ?? 0} />
<Stat icon={<IconStop />} label="已停用" value={counts.disabled ?? 0} />
<Stat icon={<IconKey />} label="待改初始密码" value={counts.pending_password ?? 0} />
<Stat icon={<IconClock />} label="活跃会话" value={counts.sessions ?? 0} />
{/* 四张卡同时是四个筛选入口(与资产库 AS-7 同一口径):数字点下去就到那一批账号,
不必再去下拉里找对应的档位。数字恒为全库数,点完不会把自己点没。 */}
<StatGrid>
<Stat tone="lead" icon={<IconUser />} label="账号总数" value={counts.total ?? 0}
title="查看全部账号:清空搜索与筛选"
active={!filtersActive} onClick={clearFilters}
hint={`${counts.online ?? 0} 个账号 15 分钟内登录过`} />
<Stat icon={<IconShield />} label="管理员" value={counts.admins ?? 0}
title="只看启用中的管理员账号"
active={roleFilter === 'admin' && statusFilter === 'active'}
onClick={() => focusWith('admin', 'active')}
hint="可维护账号、模型配置与全部项目" />
<Stat icon={<IconStop />} label="已停用" value={counts.disabled ?? 0}
title="只看已停用的账号"
active={statusFilter === 'disabled'} onClick={() => focusWith('', 'disabled')}
hint="不能登录,历史操作仍记在其名下" />
<Stat tone="warn" icon={<IconKey />} label="待改初始密码" value={counts.pending_password ?? 0}
title="只看还没改过自己密码的账号"
active={statusFilter === 'pending'} onClick={() => focusWith('', 'pending')}
hint="下次登录会先被要求改自己的密码" />
</StatGrid>
<Layout>
<Stack>
<Panel>
<PanelHead title="账号列表" right={<Badge>{visible.length}</Badge>} />
<Ctlbar>
<Field inline label="搜索" width="grow">
<SearchInput value={keyword} placeholder="用户名 / 姓名 / 邮箱 / 备注" onChange={(e) => setKeyword(e.target.value)} />
</Field>
<Field inline label="角色" width="narrow">
<Select ariaLabel="按角色筛选" value={roleFilter} onChange={setRoleFilter}
options={[{ value: '', label: '全部角色' }, ...roleOptions]} />
</Field>
</Ctlbar>
<Table
maxHeight={460}
minWidth={0}
onPick={pick}
chosen={(row) => row.id === selectedId}
empty={<Empty className="m-3 border-0">没有匹配的账号。</Empty>}
columns={[
{ title: '账号', key: 'name', render: (_: any, row: any) => (
<>
<b className="text-sm">{row.display_name || row.username}</b>
<p className={`mt-1 mb-0 ${MUTED_MONO}`}>{row.username}{row.email ? ` · ${row.email}` : ''}</p>
</>
) },
{ title: '角色', key: 'role', width: 96, render: (_: any, row: any) =>
<Tag tone={row.role === 'admin' ? 'info' : 'default'}>{row.role_label || roleLabel(row.role)}</Tag> },
{ title: '状态', key: 'state', width: 132, render: (_: any, row: any) => (
<>
<Tag tone={row.is_active ? 'default' : 'bad'}>{row.is_active ? '正常' : '已停用'}</Tag>
{row.must_change_password && <p className={`mt-1 mb-0 ${MUTED}`}>未改初始密码</p>}
</>
) },
{ title: '最近登录', key: 'login', width: 168, render: (_: any, row: any) => (
<>
<span>{row.last_login_at ? fmtAgo(row.last_login_at) : '从未登录'}</span>
<p className={`mt-1 mb-0 ${MUTED}`}>{row.login_count || 0} 次{row.last_login_ip ? ' · ' + row.last_login_ip : ''}</p>
</>
) },
{ title: '会话', key: 'sessions', width: 72, align: 'right', render: (_: any, row: any) => row.active_sessions || 0 }
]}
dataSource={visible}
/>
</Panel>
<Panel>
<PanelHead title="账号"
right={<>
<Value muted title="统计卡始终是全部账号的数量,这里数的是当前筛选命中的">
{filtersActive ? `筛选出 ${users.length} / ${counts.total ?? 0} 个账号` : `共 ${counts.total ?? 0} 个账号`}
</Value>
{busy || reading ? <Value><Spinner /> {busy || '读取账号'}…</Value> : null}
</>} />
<Ctlbar cols={3}>
<Field inline label="搜索" width="grow">
<SearchInput value={search} placeholder="用户名 / 姓名 / 邮箱 / 备注"
onChange={(e) => setSearch(e.target.value)} />
</Field>
<Field inline label="角色" width="narrow">
<Select ariaLabel="按角色筛选" value={roleFilter} onChange={setRoleFilter}
options={[{ value: '', label: '全部角色' }, ...roleOptions]} />
</Field>
<Field inline label="状态" width="narrow">
<Select ariaLabel="按状态筛选" value={statusFilter} onChange={setStatusFilter}
options={STATUS_OPTIONS} />
</Field>
</Ctlbar>
<Table
maxHeight={460}
minWidth={0}
onPick={openEdit}
empty={<Empty className="m-3 border-0">没有匹配的账号,换个关键词或清空筛选。</Empty>}
columns={[
{ title: '账号', key: 'name', render: (_: any, row: any) => (
<>
<b className="text-sm">{row.display_name || row.username}</b>
<p className={`mt-1 mb-0 ${MUTED_MONO}`}>{row.username}{row.email ? ` · ${row.email}` : ''}</p>
</>
) },
{ title: '角色', key: 'role', width: 96, render: (_: any, row: any) =>
<Tag tone={row.role === 'admin' ? 'info' : 'default'}>{row.role_label || roleLabel(row.role)}</Tag> },
{ title: '状态', key: 'state', width: 132, render: (_: any, row: any) => (
<>
<Tag tone={row.is_active ? 'default' : 'bad'}>{row.is_active ? '正常' : '已停用'}</Tag>
{row.must_change_password && <p className={`mt-1 mb-0 ${MUTED_MONO}`}>未改初始密码</p>}
</>
) },
{ title: '最近登录', key: 'login', width: 168, render: (_: any, row: any) => (
<>
<span title={row.last_login_at ? fmtTime(row.last_login_at) : undefined}>
{row.last_login_at ? fmtAgo(row.last_login_at) : '从未登录'}
</span>
<p className={`mt-1 mb-0 ${MUTED_MONO}`}>{row.login_count || 0} 次{row.last_login_ip ? ' · ' + row.last_login_ip : ''}</p>
</>
) },
{ title: '会话', key: 'sessions', width: 72, align: 'right', className: NOWRAP,
render: (_: any, row: any) => row.active_sessions || 0 },
/* 动作列不冒泡成"点行看详情",否则重置密码的弹窗底下还压着一张抽屉 */
{ title: '操作', key: 'actions', width: 190, align: 'right', className: NOWRAP,
onCell: () => ({ onClick: (ev: any) => ev.stopPropagation() }),
render: (_: any, row: any) => {
const self = row.id === auth.user?.id
return (
<Row tight className="justify-end">
<Button type="text" icon={<IconEdit />} title="编辑账号" aria-label="编辑账号"
onClick={() => openEdit(row)} />
<Button type="text" icon={<IconKey />} title="重置密码" aria-label="重置密码"
onClick={() => setPwd({ row, password: '', must_change: true, revoke_sessions: true })} />
<Button type="text" icon={<IconLogout />} title={row.active_sessions ? '注销其全部会话' : '当前没有在线会话'}
aria-label="注销会话" disabled={!row.active_sessions} onClick={() => void kickSessions(row)} />
<Button type="text" danger={!row.is_active} icon={row.is_active ? <IconStop /> : <IconCheck />}
title={self ? '不能停用当前登录的账号' : (row.is_active ? '停用账号' : '启用账号')}
aria-label={row.is_active ? '停用账号' : '启用账号'}
disabled={self} onClick={() => void toggleActive(row)} />
</Row>
)
} }
]}
dataSource={users}
/>
</Panel>
<Panel>
<PanelHead title="新建账号" />
<FormRow cols={2}>
<Field label="用户名" required hint="登录用,小写字母或数字,创建后不可改">
<Input value={create.username} maxLength={60} placeholder="例如 zhangsan" onChange={(e) => setCreate((f) => ({ ...f, username: e.target.value }))} />
</Field>
<Field label="显示名">
<Input value={create.display_name} maxLength={80} onChange={(e) => setCreate((f) => ({ ...f, display_name: e.target.value }))} />
</Field>
<Field label="邮箱">
<Input value={create.email} maxLength={160} placeholder="用于通知,可留空" onChange={(e) => setCreate((f) => ({ ...f, email: e.target.value }))} />
</Field>
<Field label="角色">
<Select value={create.role} onChange={(v) => setCreate((f) => ({ ...f, role: v }))} options={roleOptions} />
</Field>
<Field label="初始密码" required hint="至少 8 位,字母 / 数字 / 符号至少两种">
<SecretInput value={create.password} maxLength={200} autocomplete="new-password" placeholder="首次登录要求修改"
onChange={(v) => setCreate((f) => ({ ...f, password: v }))} />
</Field>
<Field label="备注">
<Input value={create.note} maxLength={200} placeholder="例如:外包配音,仅本项目" onChange={(e) => setCreate((f) => ({ ...f, note: e.target.value }))} />
</Field>
</FormRow>
<Actions><Button icon={<IconAdd />} type="primary" disabled={!!busy} onClick={createUser}>创建账号</Button></Actions>
</Panel>
<Panel>
<PanelHead title={<span title="登录 / 改密 / 停用都会留痕">账号操作流水</span>} />
{!audit.length
? <Empty>还没有账号操作记录。</Empty>
: (
<div className="flex max-h-[320px] flex-col gap-0.5 overflow-auto scrollbar-slim">
{audit.map((row) => (
<div key={row.id}
className="flex items-baseline gap-2 border-b border-border-secondary px-0.5 py-2 text-xs last:border-b-0 max-sm:flex-wrap">
<Mono className="flex-none">{fmtTime(row.created_at)}</Mono>
<span className="w-[74px] flex-none font-semibold text-primary-hover [overflow-wrap:anywhere]">{row.actor || 'system'}</span>
<span className="min-w-0 flex-1 text-text-secondary [overflow-wrap:anywhere]">{row.message}</span>
</div>
))}
</div>
)}
</Panel>
</Stack>
<Stack>
{selected ? (
<Panel>
<PanelHead title={selected.display_name || selected.username}
right={<Tag tone="mono">#{selected.id}</Tag>} />
<FormRow cols={2}>
<Field label="显示名">
<Input value={edit.display_name} maxLength={80} onChange={(e) => setEdit((f) => ({ ...f, display_name: e.target.value }))} />
</Field>
<Field label="邮箱">
<Input value={edit.email} maxLength={160} placeholder="用于通知,可留空" onChange={(e) => setEdit((f) => ({ ...f, email: e.target.value }))} />
</Field>
<Field label="角色">
<Select value={edit.role} disabled={selected.id === auth.user?.id}
title={selected.id === auth.user?.id ? '不能修改自己的角色' : undefined}
onChange={(v) => setEdit((f) => ({ ...f, role: v }))} options={roleOptions} />
</Field>
</FormRow>
<Ctlbar>
<Check checked={edit.is_active} onChange={(v) => setEdit((f) => ({ ...f, is_active: v }))}>允许登录</Check>
</Ctlbar>
<FieldBlock label="备注">
<TextArea rows={2} maxLength={200} value={edit.note} onChange={(e) => setEdit((f) => ({ ...f, note: e.target.value }))} />
</FieldBlock>
<Actions>
<Button icon={<IconCheck />} type="primary" disabled={!!busy} onClick={saveEdit}>保存</Button>
<Button icon={<IconStop />} disabled={!!busy || !selected.is_active} onClick={disable}>停用账号</Button>
</Actions>
<Sub>
<Heading level={5} className="!mb-3 !mt-0">重置密码</Heading>
<FieldBlock label="新密码" required>
<SecretInput value={reset.password} maxLength={200} autocomplete="new-password" placeholder="留空不可提交"
onChange={(v) => setReset((f) => ({ ...f, password: v }))} />
</FieldBlock>
{/* 这两条是「重置时顺带做什么」的两个选项:竖排等宽,
而不是在窄侧栏里被折成一行一个、行宽还各不同 */}
<Ctlbar>
<ActionGroup stack className="w-full">
<Check checked={reset.must_change} onChange={(v) => setReset((f) => ({ ...f, must_change: v }))}>要求该账号下次登录改密</Check>
<Check checked={reset.revoke_sessions} onChange={(v) => setReset((f) => ({ ...f, revoke_sessions: v }))}>同时注销该账号全部会话</Check>
</ActionGroup>
</Ctlbar>
<Actions>
<Button icon={<IconKey />} disabled={!!busy || !reset.password} onClick={resetPassword}>重置密码</Button>
<Button icon={<IconLogout />} disabled={!!busy} onClick={kickSessions}>仅注销会话</Button>
</Actions>
</Sub>
</Panel>
) : (
<Panel><Empty>在左侧选择一个账号开始管理。</Empty></Panel>
<Panel>
<PanelHead title={<span title="登录、改密、停用、注销会话都会在这里留痕">账号操作流水</span>}
right={<Value muted>{audit.length} 条</Value>} />
{!audit.length
? <Empty className="m-3 border-0">还没有账号操作记录。</Empty>
: (
<LogBox maxHeight={320}>
{audit.map((row) => (
<LogRow key={row.id} level={row.level}
time={<span title={fmtTime(row.created_at)}>{fmtAgo(row.created_at)}</span>}
who={<span className={MONO} title={row.action}>{row.actor || 'system'}</span>}>
{row.message}
</LogRow>
))}
</LogBox>
)}
</Stack>
</Layout>
</Panel>
<Drawer open={!!form} onClose={() => setForm(null)} label={editing ? '编辑账号' : '新建账号'}
width="min(980px, calc(100vw - 24px))"
title={editing ? `编辑账号 · ${form?.display_name || form?.username}` : '新建账号'}
sub={editing ? <span className={MONO}>
#{form?.id} · 登录名 {form?.username} 创建后不可改 · 由 {users.find((r) => r.id === form?.id)?.created_by || '系统'} 创建
</span>
: '新账号首次登录会被要求改掉这个初始密码'}
actions={<>
<Button icon={<IconClose />} onClick={() => setForm(null)}>取消</Button>
<Button icon={<IconCheck />} type="primary" disabled={!!busy} onClick={() => void save()}>
{busy ? '处理中…' : (editing ? '保存账号' : '创建账号')}
</Button>
</>}>
<FormGrid>
<FormRow cols={2}>
<Field label="用户名" required={!editing} hint="登录用,小写字母或数字,创建后不可改">
<Input value={form?.username || ''} maxLength={60} disabled={editing}
title={editing ? '用户名是登录凭据,创建后不可改' : undefined}
placeholder="例如 zhangsan"
onChange={(e) => patch({ username: e.target.value })} />
</Field>
<Field label="显示名" hint="留空时默认与用户名相同">
<Input value={form?.display_name || ''} maxLength={80} placeholder="事件流水与审核记录里显示的名字"
onChange={(e) => patch({ display_name: e.target.value })} />
</Field>
<Field label="邮箱" hint="用于通知,可留空">
<Input value={form?.email || ''} maxLength={160} placeholder="name@example.com"
onChange={(e) => patch({ email: e.target.value })} />
</Field>
<Field label="角色" title={editing && form?.id === auth.user?.id ? '不能修改自己的角色' : undefined}>
<Select value={form?.role || 'editor'} disabled={editing && form?.id === auth.user?.id}
title={editing && form?.id === auth.user?.id ? '不能修改自己的角色,请让另一位管理员调整' : undefined}
onChange={(v) => patch({ role: v })} options={roleOptions} ariaLabel="账号角色" />
</Field>
{!editing && (
<Field label="初始密码" required hint="至少 8 位,字母 / 数字 / 符号至少两种">
<SecretInput value={form?.password || ''} maxLength={200} autocomplete="new-password"
placeholder="交给本人首次登录后修改"
onChange={(v) => patch({ password: v })} />
</Field>
)}
<Field label="备注" hint="例如:外包配音,仅本项目">
<TextArea rows={2} maxLength={200} value={form?.note || ''}
onChange={(e) => patch({ note: e.target.value })} />
</Field>
</FormRow>
{editing && (
<Value muted>
启用 / 停用、重置密码、注销会话都在账号列表那一行上,这里只改资料。
</Value>
)}
</FormGrid>
</Drawer>
<Modal open={!!pwd} onClose={() => setPwd(null)} label="重置密码" width={560}
title={<span>重置密码 · {pwd?.row.display_name || pwd?.row.username}</span>}
footer={<>
<Button icon={<IconClose />} onClick={() => setPwd(null)}>取消</Button>
<Button icon={<IconKey />} type="primary" disabled={!!busy || !pwd?.password}
onClick={() => void resetPassword()}>重置密码</Button>
</>}>
<FormGrid>
<Field label="新密码" required width="full" hint="至少 8 位,字母 / 数字 / 符号至少两种">
<SecretInput value={pwd?.password || ''} maxLength={200} autocomplete="new-password"
placeholder="粘贴或输入一个新密码"
onChange={(v) => setPwd((cur) => (cur ? { ...cur, password: v } : cur))} />
</Field>
<div className="min-w-0 pb-2">
<Value muted>
当前账号 {pwd?.row.active_sessions || 0} 个会话 · 最近登录{' '}
{pwd?.row.last_login_at ? fmtAgo(pwd.row.last_login_at) : '从未登录'}
</Value>
</div>
<div className="flex flex-col gap-2">
<Check checked={!!pwd?.must_change}
onChange={(v) => setPwd((cur) => (cur ? { ...cur, must_change: v } : cur))}>
要求该账号下次登录改密
</Check>
<Check checked={!!pwd?.revoke_sessions}
onChange={(v) => setPwd((cur) => (cur ? { ...cur, revoke_sessions: v } : cur))}>
同时注销该账号全部会话
</Check>
</div>
</FormGrid>
</Modal>
</PageStack>
)
}

View File

@ -16,12 +16,20 @@
为什么只比中心不比高度:R3 允许同行出现 22/24/32 三档(标签 + 输入框 + 按钮),
它们的**中心**必须一致,顶边一致反而错。
为什么不查跨行:折行是 flex-wrap 的正常结果(R1),所以先按 y 分桶再逐桶判定。
用法:.venv/bin/python -u scripts/ui/aligncheck.py [theme] [width];dev server 需在 :5173。
退出码:有任何一处偏位 >1px 或卡头标题继承到 600 字重 → 1。
用法: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 同一个道理。
"""
import os
import sys
from playwright.sync_api import sync_playwright
BASE = os.environ.get("NEX_BASE", "http://127.0.0.1:5173")
MIN_PROBED = int(os.environ.get("NEX_MIN_PROBED", "40"))
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
@ -49,9 +57,11 @@ JS = """() => {
tag: (e.className && e.className.toString ? e.className.toString() : e.tagName).trim().split(/\\s+/)[0].slice(0, 30) }; };
const rows = [];
const seen = new Set();
let seen2 = 0; // 量到的容器数(判据能不能算数,全看这个)
// ── ② 父子尺:整页跑一遍(每个容器只看一次)
document.querySelectorAll(PARENT.join(',')).forEach((c) => {
if (!vis(c)) return;
seen2 += 1;
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));
@ -64,6 +74,7 @@ JS = """() => {
});
document.querySelectorAll(SEL.join(',')).forEach((c) => {
if (!vis(c)) return;
seen2 += 1;
const kids = [...c.querySelectorAll(':scope > *')].filter(vis);
if (kids.length < 2) return;
const items = kids.map((k) => box(k));
@ -84,26 +95,34 @@ JS = """() => {
bold: [...new Set(boldTag)].join(' ') });
});
});
return rows;
return { rows, probed: seen2 };
}""".replace("__TOL__", str(TOL))
bad = 0
probed = 0
with sync_playwright() as pw:
b = pw.chromium.launch()
pg = b.new_page(viewport={'width': WIDTH, 'height': 1000})
pg.goto('http://localhost:5173/login', wait_until='networkidle')
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)
for name, route in PAGES:
pg.goto('http://localhost:5173' + route, wait_until='networkidle')
pg.goto(BASE + route, wait_until='networkidle')
pg.wait_for_timeout(2200)
rows = pg.evaluate(JS)
got = pg.evaluate(JS)
probed += got.get('probed', 0)
rows = got.get('rows', [])
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()
print('ALIGN_PROBED', probed)
if probed < MIN_PROBED:
print(f'⚠ 只量到 {probed} 个容器(底线 {MIN_PROBED})——BASE 指错端口或选择器漂了,'
f'不算通过:NEX_BASE={BASE}')
sys.exit(2)
print('%s:全站 %d 处同一行不同心 / 只读胶囊继承到标题字重' % ('未通过' if bad else '通过', bad))
sys.exit(1 if bad else 0)

View File

@ -11,7 +11,7 @@
而静态审计照样是 0。
做法:一条浏览器路径逐项验(视口 1440×900,明暗两套主题各跑一遍)——
A 全站禁止原生对话框:任何一次 `dialog`(alert / confirm / prompt)都算失败;
B 真实路径的成功反馈:/users 点「保存」→ 右下角出现 `.nex-toast`、
B 真实路径的成功反馈:/users 整行点开编辑抽屉 → 抽屉底部「保存账号」→ 右下角出现 `.nex-toast`、
`.ant-message` 一个都不许有、吐司落在视口右下角的留白带里、倒计时条在跑;
C 悬停暂停:指针移到吐司上 → `.nex-toast-progress` 的 animation-play-state 必须是 paused,
移开恢复 running(条停了卡片却消失 = 半成品);
@ -90,10 +90,17 @@ def run_theme(pw, theme):
# ── B/C/D/E:吐司 ────────────────────────────────────────────────────────
pg.goto(BASE + "/users", wait_until="networkidle")
pg.wait_for_timeout(1600)
pg.locator("button:has-text('保存')").first.click() # 真实路径:PATCH 同一个值
# 管理类模块统一走「整行点开抽屉」(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)
pg.wait_for_timeout(900)
toasts = pg.locator(".nex-toast")
if not check(toasts.count() >= 1, f"[{theme}] B 点「保存」后右下角没有出现自绘吐司"):
if not check(toasts.count() >= 1, f"[{theme}] B 抽屉「保存账号」之后右下角没有出现自绘吐司"):
return pg, b
check(pg.locator(".ant-message").count() == 0, f"[{theme}] B 出现了 antd 默认 <message>(R19 禁)")
bx = box(pg, ".nex-toast")

View File

@ -35,11 +35,14 @@ THEMES = os.environ.get("NEX_THEMES", "light").split(",")
USER, PWD = os.environ.get("NEX_USER", "admin"), os.environ.get("NEX_PASS", "admin1234")
MIN_PROBED = int(os.environ.get("NEX_MIN_PROBED", "8"))
# (路线, 是否先勾一行, [打开浮层的按钮文案]) —— 覆盖 Overlay.Drawer / Modal 的全部底部形态:
# (路线, 是否先勾一行, [打开浮层的按钮]) —— 覆盖 Overlay.Drawer / Modal 的全部底部形态:
# 2 颗(取消+主行动)、3 颗(辅助 mr-auto + 取消 + 主行动)、4 颗(二次确认多一颗取消)。
# 按钮默认按**可见文案**找;行内那种只有图形的图标按钮没有文案,用 `@无障碍名`
# 按 aria-label 找(用户管理的「编辑 / 重置密码」就是这一类)。
CASES = [
("/assets", False, ["编辑", "新建人物", "引入项目"]),
("/assets", True, ["打标签", "批量", "删除"]),
("/users", False, ["新建账号", "@编辑账号", "@重置密码"]),
("/projects/10/library", False, ["新建人物", "新建场景", "新建声线", "打开生成台", "编辑"]),
("/models", False, ["添加大模型", "配置"]),
("/projects/10/storyboard", False, ["导入脚本 / 关键帧"]),
@ -107,7 +110,10 @@ def main():
if box.count():
box.first.click()
page.wait_for_timeout(300)
loc = page.locator("main button:has-text('%s')" % trig)
if trig.startswith("@"):
loc = page.locator('main button[aria-label="%s"]' % trig[1:])
else:
loc = page.locator("main button:has-text('%s')" % trig)
if not loc.count():
continue
try:

View File

@ -16,12 +16,18 @@
(门牌与正文同一条竖线,R20 删掉图标方块之后才成立)。
最后打印三个跨页集合:门牌标题左缘 / 标题行中线 / 主操作右缘,每个都必须是单值。
退出码:任一点名 → 1(`SYM_TOTAL`)。
用法:python scripts/ui/symmetrycheck.py [light|dark] [宽度]
退出码:任一点名 → 1(`SYM_TOTAL`);量到的门牌数掉到地板 → 2(闸门自己坏了,不算通过)。
用法:NEX_BASE=http://127.0.0.1:5173 python scripts/ui/symmetrycheck.py [light|dark] [宽度]
⚠ BASE 早先写死 `localhost:5173`:那台端口被另一个项目占着时,这把尺十三页一个门牌
都没量到,三个跨页集合全是空集、最大跳动 0,于是「空跑」冒充「一致」照样绿。
"""
import os
import sys
from playwright.sync_api import sync_playwright
BASE = os.environ.get('NEX_BASE', 'http://127.0.0.1:5173')
MIN_HEADS = int(os.environ.get('NEX_MIN_HEADS', '10')) # 13 页里 12 页该有门牌
THEME = sys.argv[1] if len(sys.argv) > 1 else 'light'
WIDTH = int(sys.argv[2]) if len(sys.argv) > 2 else 1440
PAGES = [('总览', '/'), ('资产库', '/assets'), ('模型管理中心', '/models'),
@ -74,13 +80,13 @@ rows = []
with sync_playwright() as pw:
b = pw.chromium.launch()
pg = b.new_page(viewport={'width': WIDTH, 'height': 1000})
pg.goto('http://localhost:5173/login', wait_until='networkidle')
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)
for name, route in PAGES:
pg.goto('http://localhost:5173' + route, wait_until='networkidle')
pg.goto(BASE + route, wait_until='networkidle')
pg.wait_for_timeout(2200)
rows.append((name, route, pg.evaluate(JS)))
b.close()
@ -126,5 +132,10 @@ print('门牌左缘集合:', sorted(set(lefts)), ' 门牌中线集合:', sorted(
print('跨页最大跳动:', '标题中线', (max(titles)-min(titles)) if titles else 0,
'标题左缘', (max(lefts)-min(lefts)) if lefts else 0,
'动作右缘', (max(acts)-min(acts)) if acts else 0)
print('SYM_HEADS', len(lefts), '/', len(PAGES))
if len(lefts) < MIN_HEADS:
print(f'⚠ 只量到 {len(lefts)} 个门牌(底线 {MIN_HEADS})——BASE 指错端口或门牌结构变了,'
f'不算通过:NEX_BASE={BASE}')
sys.exit(2)
print('SYM_TOTAL', bad)
sys.exit(1 if bad else 0)