Commit Graph

3 Commits (a73ce504c94fbb0df318ec5edf0c3c72fcce4b49)

Author SHA1 Message Date
mula.liu a73ce504c9 用户管理按其它模块的口径重做,卡头不再复读页签与角标
用户这一轮两条,其实是同一句话:**同一个信息在一屏里只许说一次,同一类操作在任何模块里必须是同一个动作**。

**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-06 01:12:21 +08:00
mula.liu b504e31628 前端四项调整:输入框去掉光晕、账号菜单收口、逐页删开发期说明书、登录页重做成左右分栏
用户这一轮提了四条,其中三条是同一件事的三个面——**界面上残留着写给开发者自己的话**。
逐条落地的口径与取舍:

**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 22:09:16 +08:00
mula.liu 552b6b0163 门牌与卡头标题前的图形全部摘掉,跨页页头改成同一把尺量
症状(用户原话「1、不要图标 2、垂直居中对齐,和其它子页面要一致。请检查。」+ 两张截图:
门牌上那枚主色方块、调度中心那一排浮在卡头顶部的只读胶囊):
   ① 上一笔刚给门牌接上「菜单同款图标」,用户看了还是不要。那枚方块的语义是「图形 =
      这一站」,可这句话左栏高亮项、顶栏流程条、项目概况抽屉已经各说一遍(R18),门牌
      再摆一次就是给同一条信息配第二个视觉锚点;它还和顶栏的品牌 N、统计卡的色块同形状
      同圆角,一屏三颗方块互相抢注意力。
   ② 标题前挂着 42px 的方块,门牌标题的左缘就比下面每一张卡正文的左缘右移 42px,
      「门牌与正文同一条竖线」这件事在有图标的情况下做不到。
   ③ 跨页从来没人量过:aligncheck 量的是**同一个容器内**同一行的中线,逐页看都不算错,
      连着切页就是晃。总控台卡头把 `<Mark>N</Mark>` 和标题拼进同一个标题槽,方块的
      自然高度决定那一行的行高,22px 的文字跟着整排错位。
   ④ 调度中心那一排只读胶囊(任务执行 / 已取消 / 失败 / 已跳过 / 已完成)套在卡头标题
      槽外面那个**行内 span** 里,块级 div 装进行内先撑出一段匿名行盒,实测整排浮到卡头
      中线上方 6.5px,同页其它单行卡头只偏 0.5px——肉眼就是「这排贴顶、下面空一截」。

做法:
   · `components/ui/Page.tsx`:`PageHead` 删掉 `icon` 形参与 `navItemAt()` 反查、标题行
     只剩 `Title level=3`——菜单图形那一层整层撤掉,不是传 `icon={null}` 豁免;不在菜单
     里的账号页 / 手册页也不再自己补 `IconUser` / `IconBook`。窄屏那一档换法:
     `HEAD_ACTIONS = 'max-lg:w-full'`,不再写 `[&>button]:flex-1`——`useAutoStack()` 的
     自然宽度只在「子项都按内容定尺」时量得到,等分一挂上自动档就永远认为量不到,
     三颗主操作在窄屏折成 2 + 1,正是 `btnrowcheck.BTNROWS` 点名的破法。
   · `pages/project/AgentConsole.tsx`:卡头标题去掉 `<Mark>N</Mark>`,标题槽只留文字
     (`Mark` 组件本身留着——登录页的品牌方牌还在用,那一处是品牌不是导航)。
   · 跨页这把尺:新增 `scripts/ui/symmetrycheck.py`(站内第 10 道常驻像素闸)。它收齐
     13 个页面同一个量的实测值,要求每个量**收敛到单值**:门牌标题左缘、标题行中线、
     主操作右缘三个集合的 `len` 必须 == 1,另加三条页内判定(标题行高 >= controlHeight、
     标题里不许再有 svg / `*-mark` / `ant-avatar`、卡头标题与 extra 同心 + 正文卡左缘 ==
     门牌标题左缘)。`aligncheck.py` 补上它原来漏掉的卡头 extra 与匿名行盒这一类。
   · `components/ui/{Controls,grid}.tsx` 一并落地(见下方记账):门牌的窄屏方案现在直接
     踩在 `ActionGroup` 的自动档上——量「整组的自然宽 vs 能给它的最窄祖先」,放不下整组
     就整组竖排等宽。少了这一半,本笔的门牌在窄屏会退回 2 + 1。

实测:明暗两档各 13 页 `SYM_TOTAL 0`、`aligncheck` 0 处不同心;三个跨页集合实测都是单值
——门牌左缘 {273}、标题行中线 {109}、主操作右缘 {1391},跨页最大跳动 0.0,主操作中线与
标题中线 Δ 全 0.0,controlHeight 32 == 32。反向验证两发都响:往标题里塞一枚
`nex-stat-mark` → `SYM_TOTAL 13`(全页点名「标题前不许有图形」);把 `actions` 从第一行
挪进说明行 → `SYM_TOTAL 10` 并点名「⚠主操作不在标题那一行(中线 153.0 vs 标题 109.0)」。
探针自己修过两处漏判:`'max-w-full'.includes('w-full')` 的子串误伤(改
`:scope > .nex-action-group`)和「动作离开第一行被当成这一页没动作」(改抓游离的
`.nex-action-group`)。

⚠ 记账两笔:
   ① `Controls.tsx`(`ActionGroup` 自动档 + `Ctlbar` 栅格末格贴右缘)与 `grid.tsx`
     (`FILL_AT`)是并行会话在途的按钮行收口,本轮门牌依赖它才自洽,所以提前落地;顺带
     把 `e5ccbe0` 遗留的那条 tsc 红修好了——那一笔提交了用 `<ActionGroup auto={false}>`
     的 `Page.tsx` 却没提交带 `auto` 的 `Controls.tsx`,`e5ccbe0` 与本分支上一笔 b6a1df6
     的树都是红的(`npm run typecheck` 在 `src/components/ui/Page.tsx:169` 报 TS2322),
     到这一笔才绿;`auto` 这个开关在本笔里连同它的豁免一起删掉了,窄屏怎么排只留一个答案。
   ② 上一笔 b6a1df6 的 `app.css` 是整文件提交的,里面已经删掉了 `.nex-pagehead-mark`
     那条尺,而它那一笔的 `Page.tsx` 还在挂色块:两笔之间那一格的门牌色块是没有皮肤的。
2026-11-03 23:49:31 +08:00