Commit Graph

47 Commits (3404d7874fe1ff457f3d70bb7ccddcb2fa33b852)

Author SHA1 Message Date
mula.liu 3404d7874f 全局五个页面换成 kit 的信息块:统计卡配色块图标、只读回显改 Info、项目层压成一条面包屑
症状(用户第 1、2、7、8 条):①Dashboard 与 UserAdmin 的统计卡还是光秃秃的文字,
五张卡排成 3+2 右下角缺一张;项目表「项目」列三行 79px 把整表撑高(R17)。
②Account 把登录名、角色塞进 disabled 输入框,灰盒让人以为能改。③Help 整站只有
开头那块 primary 底纹封面是彩色的,读者把它当成提示条。④ProjectDetail 页头写着
「← 项目总览 + 已交付 + 当前节点」再加 24px 项目名,这四样在顶栏流程控制台全都有,
八个子页每一页首屏都要先读一遍重复信息。

做法:①两个总览页的 Stat 全部配上传递语义的色块图标,StatGrid 去掉写死的 cols
交给 grid 的 flex 档(≥1200 一排放完),项目表的片名列与规格行各封顶一行、全文挂
title,删掉 cellWrap 让行高回到内容本身;②Account 的只读身份项改成 Info 回显
(column=2、卡内加 nex-info-in-card),可编辑的显示名与邮箱才留在 FormRow 里;
③Help 的封面卡换成与其他 11 页同一把尺子的 PageHead(24px 标题 + 12px sub),
四张能力标签降为页头眉标,底纹与描边一并删掉;④项目外壳改为一条 Toolbar 面包屑
(左端只回答「我在哪个项目里」,右端放收放概况与删除项目),状态/进度/当前节点交还
顶栏,briefLine 只在概况折叠时出现且只剩顶栏没有的四项;⑤五个页面的外层 div 统一
换 PageStack,ErrorText 去掉自带的外边距(间距归 stack 管)。

为什么:信息块的底纹、色块、图标在 kit 里只定义一次,页面负责的是「给哪个数、配哪个
图标」;重复的项目身份同屏出现两遍就是第 8 条要清掉的东西,而只读回显用禁用输入框
会发出「这里可以改」的错误邀请。
2026-11-03 20:20:43 +08:00
mula.liu 50e0da3b31 侧栏二级菜单去掉「当前项目」这一层:项目身份全程只在顶栏控制台说一遍
症状:侧栏一级分组叫「当前项目」、title 拼项目名,底部还挂一块「当前节点」状态条,
      而顶栏的流程控制台从进项目到交付一直在显示同一份「项目名 + 当前节点 + 进度」——
      同一份状态两个出处,两边刷新时机不同就出现「侧栏还在讲上一个节点」的错位;
      菜单也因此看着像三级(分组标题 → 项 → 子项)。
做法:① 一级分组改成中性词「项目环节」,title 不再拼项目名;AppSider 删掉底部
         状态块与 useCurrentStageNote,App.tsx 不再为侧栏去读 project store
         (连带省掉「项目 404 时残留上一个项目名」那处补丁)。
      ② nav.tsx 的注释跟着改口径,四枚图标的换图理由同步(资产管理不再与父级同图)。
      ③ 流程控制台的状态标签改用 kit 的 Tag(中性底 + 语义圆点):它原本写 antd
         预设色名 color="success",渲染出 #f6ffed 一块浅绿——顶栏上「已交付」的项目
         长期顶着这块绿,正是用户要退役的那批浅绿标签的最后一个来源。
为什么:菜单只到两级是产品口径;「谁显示项目身份」只需要一个答案——顶栏控制台
      跨路由常驻,侧栏只回答「这个项目的七个环节我在哪一步」。
2026-11-03 20:19:17 +08:00
mula.liu 69bd8937ca 组件层补齐信息块三件套:统计卡配色块、回显改用 Descriptions、卡头不再被压成竖排
症状(用户第 6/7 条:「统计使用的信息块都加入底纹」「大的统计卡片…每个页面逐个优化」
      以及 430 档实测):
      ① 回显有两种假象——灰底圆角盒 + label 在上(长得就是禁用输入框,旁边真输入框
         时分不清哪个能填)、只读值外面再套一圈描边 Tag;同一屏「这块是信息」靠脑补。
      ② 统计卡与页面底色同色,四张并排时先看到四块同色灰、数字反而最弱。
      ③ 标签把语义色铺成底:满屏「完成 / 已交付 / 合格」各一块浅绿,绿色从语义色
         变成第二个品牌色,还把数字压住。
      ④ 430 档卡头:right 那句「下一步:时间线合成 + 配音/字幕/混音 — …」要 400px+,
         而 antd 的卡头是不换行的 flex,标题只剩 15px ⇒「流程进度」一个字一行。
      ⑤ 768 档 /assets 筛选条:Col 的断点量视口,正文 = 视口 − 侧栏 224 − 内边距 32,
         5 等分在 md 给 3 列时每格 158,选中值「全部类型」77px 被裁成 53px。
做法:① 新增 Info(antd Descriptions):label 列降一档字号 + text-tertiary +
         --nex-info-label-w 定列宽,值列 overflow-wrap:anywhere;卡内回显挂
         nex-info-in-card 去掉双层描边;配套 Value(title) / Count / Clamp 三只小件。
         统计卡 Stat = Card + Statistic,识别度交给数字左侧 32px 语义色块
         (color-mix 12%,深色档提到 18%),卡面回到 antd 自己的 colorBgContainer。
      ② 标签底一律中性 fill-tertiary(深色 8%),语义只由头部 6px 圆点承载
         (--nex-tag-tint 由 tone 映射到 --ant-color-*);Notice/Alert 保留 antd 语义底。
      ③ .nex-panel .ant-card-head-wrapper{flex-wrap:wrap} + .ant-card-extra
         {flex-shrink:0;max-width:100%}:宽屏同排读完,窄屏整句掉到第二行
         (实测 430 标题 292×24、1440 一字未动)。
      ④ Controls 的 ROW_STEPS 按正文宽整体降一档(5 等分改 ≤1600 四列 / ≤1200 三列 /
         ≤992 两列 / ≤576 单列),新增 OptionGrid;.nex-ctlbar-grid 里 --nex-ctl-w
         让位给列宽,同一行控件右缘必然对齐;新增 colSpans(cols,oneAt,steps) 支持逐档列数。
      ⑤ Table 补动作列与行高纪律需要的口子;RecordAudio 的麦克风状态条改中性底。
为什么:页面不准 import antd(R8)、.ant-* 只准出现在 styles/app.css、#hex 只准
      theme/antd.ts——皮肤集中在这一层,19 个页面才共用同一把尺子;
      antd Descriptions 的 span 不跟断点走,所以项里写 span 的回显 column 必须是定值
      (已在 §13.1 登记)。色值一律由语义变量比例混合,明暗两档自动跟主题。
2026-11-03 20:18:59 +08:00
mula.liu d65a78ce59 规范补到十六条:R15「按钮一律图标按钮」、R16「信息块一律带底纹」
症状:文档还停在十四条,而这一轮真正拦人的是四件没写进规矩的事——
      筛选条字段没规定必须 inline(所以「标签在上」被混进行内栏,一行散成两行)、
      按钮没规定必须带图标(所以整站是纯文字按钮)、
      统计/回显块没规定必须有底纹(所以每个页面自己涂一次白底描边)、
      重点色没规定「一个容器只留一颗」(所以三颗 blue primary 并排)。
      规矩没写=下一轮一定长回来,用户同一句抱怨会再说第三遍。
做法:R1/R2 补上「控件栏字段必须 <Field inline>,宽度落控件列 --nex-ctl-w」,
      新增 R15(图标按钮,含 FilePick/RecordAudio 也走 icon 槽)、
      R16(底纹走 fill-tertiary,禁止手涂 bg-[#...]);
      新增 §5.1.1「一颗按钮一只语义图标」、§5.1.2「关键动作才有重点色」;
      §2.1 记下状态色的新口径(浅色删掉自造档回到出厂,深色只抬亮一档,
      并写清深色会再走一遍 darkAlgorithm、字面量不是最终值);
      §7 示例改成 inline 写法,并登记现网实测「19 条 Ctlbar / 27 个字段,0 例外」;
      §9 补「标签在上只属于抽屉/弹窗/长表单」;
      §15.2 写清闸门的两处口径修正(浮层底部只查 Drawer/Modal;侧栏探针
      kind=item 才比色板、`.anticon` 不参与行高断言);README 索引同步到 R1–R16。
为什么:这四条不是审美偏好,是用户两次截图里的原话;写进硬规则并被 classaudit /
      visualcheck 管住,比在代码里留十条注释更能防止下一次回潮。
2026-11-03 17:03:34 +08:00
mula.liu 8c930cc1ef 19 个页面按 antd 口径重排:一行放完、按钮带图标、信息块带底纹、重点色只给关键动作
症状(用户三轮截图指向同一件事:控件换成 antd 了,版面还是手写的):
      ① 该一行的排成两行——项目列表把「搜索 + 状态」塞在卡头右端,两个带标签
         的字段折成一竖列,右边空出半张卡;筛选条里所有字段标签在上,
         一次横向扫读被排成填表。
      ② 按钮全是纯文字——AI 生成、上传、引入项目、清除筛选、下达指令、执行计划
         ……读者只能逐字读,一排按钮长得完全一样,扫不出主次。
      ③ 统计块和页面底色同色——项目总览四张指标卡、质检页的计数、抽屉里的回显块
         全是「白底白框」,看不出哪块是信息。
      ④ 重点色滥用——一个容器里三颗 blue primary 并排,等于没有主次。
      另有一批残留:裸 <h2> 当页头、页签条独立一行漂在底色上、全选条是列表上方
      一整个只装一颗勾选框的虚线盒、侧栏里的指标卡按整页宽度选了 4 列、
      档位写成「≤1600 三列」结果 1440 上 5 张卡排成 3+2、手册 31 遍自绘卡片。
做法:① 筛选/工具条一律 Ctlbar + <Field inline>(标签在左、控件在右、同一行,
        放不下整条折行),全站 19 条 Ctlbar 内 27 个字段全部 inline,0 例外;
        筛选条按 antd 列表页口径从卡头右端移到卡头下方的正文里,卡头只留计数。
      ② 每颗按钮一只语义图标(icon={<IconX/>}),FilePick / RecordAudio 这类
        自绘控件也走 icon 槽;扫描脚本 inv2 复扫,页面侧 0 处纯文字按钮。
      ③ 统计与回显块统一带底纹(Stat / Block 默认档 / 中性 Tag),
        漂在底色上的裸标题、裸页签条收进 Card 的 title / sub / extra。
      ④ 一个容器只留一颗 primary:AI 生成、入队所选、保存资料、修改密码、
        新建长视频项目;其余降级为默认/text,危险动作用 text danger。
      ⑤ 版式残留逐页清:页头交还 PageHead/Toolbar,手册 31 处自绘卡改用
        Panel size="small" + Typography.Title(仍留在本页——规范:被第二个页面
        用到才提上 kit),指标卡按所在栏宽度选列(侧栏 2 列),
        栅格档位改到 1440 这一档,全选条并进卡头右端。
      ⑥ 手册 12 张插图用 helpshots.py 重拍:旧图还是上一套绿色皮肤,
        正文里写的「浅绿色标签」在插图上字面成立。
为什么:控件同价不等于版面同价——同一颗 antd Button,摆在哪儿、有没有图标、
      是不是这一片唯一的重点,才是读者判断「下一步点它」的依据。
      这四条写成规矩容易,只有逐页改完并由扫描脚本兜住,才不会下一轮又长回去。
2026-11-03 17:03:20 +08:00
mula.liu 5383954184 组件层收口到 antd 原生形态:骨架、表格、抽屉、统计块一律不再自绘
症状:前两轮只换了「卡片里面的控件」,容器这一层还是手写的——页头自己拼
      div + 私有字号阶,表格自己写 TableBox/WideTable 与滚动容器,抽屉挂
      getContainer={false}(结果遮罩压不住侧边菜单),标题在站内有四套尺子
      (手册自带 TAG_H1/H2/H3 + 页面各写各的),两栏版式有三套折列宽度。
      另两条是用户直接看出来的:统计块/回显块和页面底色一个颜色,
      「这块是信息」全靠脑补;筛选条两个字段的标签排到了控件上面,
      一条横向扫读的活被排成两行表单。
做法:① 骨架交给 antd——PageHead = Flex + Typography.Title,新增 Heading /
        Paragraph / Code 只留 level 一个参数,字号行高颜色全走 antd 排版档;
        Toolbar 明确「工具条也是一张只有卡头的卡」,左端坐 title 槽;
        Layout/Stack 的两栏换算统一到 grid.splitSpans(主 15 / 侧 9,
        ≤xl 折单列),页面不再各写各的 grid-cols。
      ② Table 改回 antd 标准用法 columns + dataSource,删掉 TableBox /
        WideTable——滚动、吸顶、空态本来就是它的内建能力。
      ③ 抽屉回到 antd 默认形态(portal 到 body),遮罩自然盖住整个视口。
      ④ 统计/回显一律带底纹:Stat 坐在 bg-fill-tertiary 的 Card 上,
        Block 默认档与无色调 Tag/Status 落 --ant-color-fill-tertiary;
        色值仍只在 theme/antd.ts 出现。
      ⑤ Ctlbar 从「贴底」改「垂直居中」,Field 新增 inline(antd horizontal
        布局:标签在左、控件同一行),narrow/wide 的宽度改交给控件列
        --nex-ctl-w——原先写在字段盒子上时,inline 的标签 nowrap + 控件列
        flex:none 一旦大于盒子就把控件捅出工具条(430 档 dispatch 溢出 54px)。
        新增 ActionGroup:按整组 max-content 决定落在哪一行,窄容器给 stack
        竖排等宽,治「一排里少一颗」。
      ⑥ 状态色不再抄派生档:浅色整套删掉,深色只抬亮一档;页面底色导出成
        SHELL_BG 供 index.html 的 theme-color 用,字面量不再抄第二遍。
      ⑦ 图标登记表补 IconTag / IconDragHandle(antd 拖拽排序示例的标准把手),
        media 下四只自绘控件改走 icon 槽。
为什么:容器自绘一处,全站就要为它写一套排版、一套断点、一套深色补偿;
      换到 antd 原生形态后这些补偿可以整段删掉,闸门也才有统一口径可查。
2026-11-03 17:02:27 +08:00
mula.liu be07d9d712 闸门跟着 antd 布局层重新校准:三处检查不再说假话
症状:布局层搬进 antd(Flex / Drawer actions / Tag)之后,四道闸里冒出一批
      「查的是老口径」的误报,逼得人想给闸门加豁免——那是要把闸门关掉的前兆。
      ① visualcheck 侧栏探针只认 .ant-menu-item-selected,可菜单折叠时高亮的是
         父级 SubMenu 标题,antd 给它的是透明底 + colorPrimary(正确长相),
         拿选中项的 controlItemBgActive 去比就必然红:430 档
         projects/13/{delivery,dispatch,timeline} 三页连续报假故障。
      ② 同一支脚本把「行高为 0」当塌陷,而 antd 的图标复位本来就把 .anticon
         写成 line-height:0(盒子由 font-size 撑开),图标一旦带上 text-* 就中枪。
      ③ classaudit 第 4 条用 \b(actions|footer)=\{ 找浮层底部动作条,
         PageHead actions(页头视图开关)和 Toolbar actions(勾选后的批量条)
         名字撞车被一起吞进来,「最后一颗必须是主行动」判到了不该管的地方。
      ④ Tailwind 词表没有 Flex 的 wrap / space-between 与 cursor 的 not-allowed,
         这三个 props 值天天出现,逐行切词分不清引号内外,只能点名放行。
做法:①探针多输出一个 kind(item / submenu),Python 侧只在 kind=item 时比色板,
        submenu 交给原有的浮层复核分支;②行高断言排除 .anticon;
      ③先定位 prop 挂在哪个元素上,只有 Drawer / Modal(含 kit 转发的 AntDrawer /
        AntModal)才算底部动作条——实测全站 25 处里受管 12 处,另 12 处归 §7 控件栏;
      ④三个词进白名单,并在注释里写清「当类名写出来仍是笔误」;
      顺带删掉临时探针 nexprobe.cjs / nexprobe.tsx(能力已并进 visualcheck),
      新增 scripts/ui/helpshots.py:手册的 12 张插图是静态 PNG,不参与构建,
      UI 每换一次皮肤就整批过期,拍摄口径(视口/dpr/主题/主角项目/先收概况)写进脚本头。
为什么:闸门报一次假,人就多写一次豁免;豁免写满,真故障就混在里面没人看。
      所以这一轮修的是检查本身的口径,而不是给页面加特例。
2026-11-03 17:02:03 +08:00
mula.liu 5ce8f4a207 检查点:布局层迁入 antd 原生(Panel/Controls/grid/Input + app.css 清理) 2026-11-03 14:37:22 +08:00
mula.liu 5f294c9ccb 补上 R8 这道闸并让文档说真话:classaudit 第五道检查 + README/工程规范回到 antd 版现状
症状:README 还在讲 metrics.ts / palette.ts / css-vars.ts 三把尺子、33 组 ComponentToken、
--ctl-h* 变量、ToolButton/IconSpot/MenuRow 这些本轮已经删掉的东西;R8「谁可以 import 'antd'」
只写在文档里,没有任何机器拦着——文档一漂,规范就退化成建议。

做法:
- classaudit.mjs 加第 5 道闸:`from 'antd'` 逐行扫,白名单只有 theme/ · app/ ·
  components/{ui,forms} · stores/notice.ts,退出码并入违规总数;已反向验证
  (pages/Account.tsx 临时插一行 import 后探针点名并报 exit=1,撤掉复绿)。
- README 分层表与两段口径重写:theme/ 只剩 antd.ts(buildAntdTheme + applyRootVars + HEADER_HEIGHT)、
  styles/ 的 --radius-* 只是 --ant-* 的别名、裸 <button> 白名单换成 CUSTOM_SURFACES 真实的 7 个文件、
  两道探针的描述换成它们各自真正查的东西(五道 / 八类)。
- 工程规范:theme/ 目录行、--ctl-h 档位、§0.5 与「§6 自绘区边界」这些失效指针改到
  R8 / §1 四层分工 / §5.2 自定义表面族;stores 补 recording;app/ 行写明 nav.tsx 是两级菜单唯一来源。
- kit 注释里的 §0.6 指针改指 R8 与 §5.2(那一节已随手写规范退场)。

验收:typecheck + build 通过;classaudit 五道全绿 exit=0;visualcheck 1440/768/430 × dark/light
(含登录页在登录前先量一趟)console 0 条、HTTP 失败 0 条、断言 0 条。
2026-11-03 12:59:59 +08:00
mula.liu 85a95a9ba3 登录页接入常驻探针并改用 kit 用词:「页签」一词收口到页面内部
产品口径落地复查(内容页不做多 Tab / 菜单只到两级 / 页签=页面内部页面)时发现两处该修的:

1) 常驻探针压根量不到登录页:登录之后再访问 /login 会被守卫回落首页,
   第 4 条的 URL 比对只能报「路由不存在」(实测退出码 1),而默认路由表里
   干脆没有 /login。改成**登录之前**先按 逐档宽度 × 明暗把 chromeless 的
   登录页量一遍并截图,尺子检查从主循环抽成 audit() 由两处共用(同一份断言,
   不给登录页开第二条口径);/login 进默认路由表,主循环跳过它。
   实测 430 / 768 / 1440 × 明暗:断言 0、console 0、HTTP 失败 0。
2) 登录页还留着手写用词:两个 <label><span> 字段换成 FieldBlock(标签在上,
   与全站同尺),三条自己拼「描边 + 底色」的提示条换成 Notice。截图逐像素对过,
   版面没动,只是不再各写一份。

顺带把词收口:ProjectDetail 注释里的「各业务页签」改成「各业务子页」——
「页签」从本轮起只指页面内部页签(§6.4),外壳没有页签条(§6.1);
§6 表格里 Header 那一行按真实三块(折叠开关+品牌簇 / PipelineConsole / 状态+手册+主题+UserMenu)重写,
§15.2 登记探针的登录前置一趟。
2026-11-03 12:52:42 +08:00
mula.liu 62c356952c UI 规范与两道常驻探针同步到 antd 版:classaudit.mjs + visualcheck.py,旧探针归档
docs/UI规范.md 按 antd 重写(16 章 / 十四条硬规矩 R1–R14):
- §6 外壳(Header 56 + 两级 Sider + Content)、内容页不做多页签、页签只在页面内部,
  Tabs vs ViewSwitch 的判据;§9.3 值型控件的宽度归控件而非「标签+控件」+ nex-prose-value 豁免登记;
  §10 下拉面板「至少同宽」与折行、标记类全集 18 只;§5.1 按钮上的字必须整颗放得下;
- §15 两道闸的判定口径写死,退出码都必须为 0。

scripts/ui/classaudit.mjs:四道判定(死类名 / 绕过登记表的图标 import / 裸 <button> /
浮层底部动作口径),基线 3912 个候选,必须在仓库根跑。
scripts/ui/visualcheck.py:登录 → 逐路由 × 逐档宽度 × 明暗截图,钉死八件事——
:root 尺子、行高、侧栏选中态(窄屏折叠时展开浮层复核二级项)、路由没被 path:'*' 静默吞掉、
display utility 被组件样式盖掉(R13 闸门)、横向溢出与切字、
控件标签**含下拉当前值**不许被省略号截断(散文型选项值按 nex-prose-value 放行)、
4xx/5xx 按 URL 分诊(素材缺文件单独计数,接口 404 点名发出它的路由)。
新增的 4xx/5xx 一条顺带治好了时间线 / 交付页「空状态对、代价是两条 404」的假绿。

旧的 audit.py / metrics.py / vocab.py 量的是已删的那套自造尺子,移进 scripts/ui/legacy/ 并标注作废。
README 与 docs/工程规范.md 同步:theme/ 只剩 antd.ts 一把尺子,导航与页签口径改为两级菜单 + 内部页签。

本轮验证:tsc 0 错 / classaudit 四道全 0 / vite build 通过 /
visualcheck 两轮各 104 张(1440·992·768·430 × dark·light,空项目与数据齐全项目各一轮)
console 0 条、HTTP 失败 0 条、断言 0 条。
2026-11-03 12:42:28 +08:00
mula.liu d853560fa7 前端按 Ant Design 规范重写:Header + 两级侧栏 + 页面内部页签,手写规范整体退场
外壳三段交还 antd:Layout.Header(56) / Layout.Sider 两级 Menu / Content。
全局多页签条(PageTabs + stores/tabs)删掉——内容页不做多 Tab,菜单只到两级,
指定项目的二级挂在「当前项目」下;页签回到页面内部:
资产 3 类、项目资产 4 面板、模型 4 能力、分镜 4 检查器。
Tabs(换看不同内容)与 ViewSwitch(同一批数据换排法)的判据写在 components/ui/Tabs.tsx。

删:theme/{metrics,palette,css-vars}.ts、icons/{Icon,glyphs}.ts、hooks/use-narrow.ts、
app/layout/{AppBar,SideNav,PageTabs,NoticeToast}.tsx、nav.ts、components/ui/Rail.tsx。
尺子只改三类(品牌色 / 表面色 / 少量结构性 token),几何、字阶、圆角、间距、断点
一律等于 antd 默认;图标全站唯一入口 components/icons/index.ts(语义登记表)。

一并收进本轮与并行线程查出的静默故障(tsc/build 全绿但页面是坏的):
- frontend/package.json 结尾的字面量 \n;line-height 被写成 px 让全站文字塌陷;
  Tailwind v4 @layer 层叠反转(preflight 与 antd 收进同一层,R13)
- 值型控件的宽度预算错给了「标签 + 控件」整字段,23 处下拉当前值被省略号咬
  (91>70 / 77>70 / 77>46)::has 规则把 flex-basis 交回内容 + 面板按内容加宽折行;
  整句型选项值(时间线字幕/语音来源/原声策略、交付字幕)挂 nex-prose-value 显式登记
- ViewSwitch 传 block 把「全部素材」最后一个字裁掉半格;AgentConsole 一键指令双重省略号;
  总览「下一步建议」按钮在 430 档捅出视口
- 时间线 / 交付页在没有版本时白调 /timeline 与 /timeline/report,两条 404 换来一片假绿
  (先拿版本清单,清单为空就别问)

注:并行线程「迁移前端到React+Tailwind」在同一份工作区落了下拉档宽、下拉面板加宽折行、
上述时间线 404 闸门与浮层底部动作口径(R14),本 commit 一并收进,不代表那条任务已收尾。
2026-11-03 12:42:16 +08:00
mula.liu c90a2c4446 检查点:保留手写图标体系与尺子,作为 antd 重写的对照 2026-11-03 10:15:14 +08:00
mula.liu 4521c9f926 前端统一到 React 18 + Ant Design 5 + Vite + Zustand + React Router 6:控件不再在原生件上缝皮,Radix 那一层整体换成 antd 标准件 + 一层自有 kit,并把「谁定义控件」收口成词汇表。
用户连着三轮指出「字段标题、控件不对齐」「下拉控件的样式不对」,最后点名技术栈。真正的病不在
antd 还是 Radix,而在同一件事有三千种写法:左导航内边距一页 11px 一页 12px,白名单要从页面
className 上抄切片才能命中。上一轮 Radix 只外包了行为,皮肤仍由 30 多个页面自己拼,且没有任何
机制阻止分叉长回来。这一轮改的是词汇表:页面只准说业务,控件怎么长由 kit 层 + 一份令牌说了算。

底座(读数见报告 26.2):react 19.3.1→18.3.1、react-router-dom 7.18.5→6.30.6(点名为 18/6,是
降级,代价见 26.6)、新增 antd 5.29.3 + @ant-design/icons 6.3.4,@radix-ui/* 5 包与
class-variance-authority 清零;zustand/vite/tailwindcss 4.3.3 不变,Tailwind 留作皮肤 utility。
删 components/primitives/(11 文件 1133 行)与 styles/{base,tokens}.css;净 +488 行不是「少一千行」,
是同样面积的代码从三十个页面挪进两个目录——省的不是字节,是分叉次数。

新增:
- app/providers.tsx:ConfigProvider + <App> 唯一入口(主题、zh_CN、button.autoInsertSpace:false、cssVar),
  命令式 message/notification/modal 挂 antdApi 供 stores/ 使用;React Router 的 v7 future flag 一处收口。
- theme/{palette,antd,css-vars,metrics}.ts:数字只有一个来源 metrics.ts → 同时喂 antd ThemeConfig 与
  --ctl-h-*/--radius-*/--text-*,antd 控件与自绘区读同一把尺子,结构上长不歪了。
- components/ui/{Input,Checkbox,Menu,Rail,Tile,Overlay,field-labels};lib/layers.ts(Esc 先看有没有 antd
  浮层压着,否则分镜检查器里关一个下拉整层抽屉一起没)、lib/ref.ts、hooks/use-narrow.ts(触摸档必须
  同时喂给 antd 的 JS 数字,否则 560/430 一屏混着 31/38 与 36/40 两把尺子——首跑量出的 61 项就这么来的)。
- styles/app.css 接替 base+tokens,只留元素默认值与三处必须靠 CSS 的 antd 集成。
- scripts/ui/ 三件套首次入库:audit.py 七项机器判据 × 14 视图、vocab.py 六条源码词汇表闸、metrics.py。

修掉四个探针全绿也看不见的静默 bug:
1) 探针会假绿:浮层用例找不到抽屉时兜底 scope=main 把页面重量一遍,分镜「检查器」29 字段/57 输入
   /35 按钮(在 main 外面的 aside 里)一条都没测过。
2) Select 选中 null 回显成灰色 placeholder:antd 把 null 当无值,而「不绑定/无台词/未指定」的真实值
   就是 null(接口收 null,10 处)。kit 内折哨兵 nex-null,出入口各折一次,页面 API 一字未改。
3) JSX 子节点上的 /* */ 不是注释而是文本,挂在应用外壳之上把整站下推约 30px;移到 JSX 外并立词汇表规则 6。
4) 抽屉可以整块开在屏幕外面:Overlay 用 getContainer={false} 让 antd 就地渲染,rootStyle 的 absolute
   于是相对文档定位——入口按钮在折叠线以下时抽屉 y=-scrollY(1440 lib_edit 只剩 201px,430 assets_gen
   完全不可见,用户点了「AI 生成」像没反应)。改 fixed 后四档 10 个浮层全部 y=0 完整可见。为此给 audit
   加第 7 项判据 surface(浮层完整落在视口内 + 中心点 elementFromPoint 命中自己),反向验证:改回
   absolute 后 430 下 4 红 exit=1;判据取「有交集」太松(42px 也算过),收紧为「完整在视口内」才对。

验收(复跑读数):audit --only page 1440/1280/900 × 明暗 6 组 84 行视图全 0、exit=0;--only overlay
1440/900/560/430 × 明暗 8 组 exit=0,surface 80/80 绿,72 个下拉样本 popW==trigW、inViewport、
optClipped=false、popOnTop=false 计 0;vocab 85 文件/皮肤常量 79(账实相符)exit=0;
npm run build(tsc+vite)exit=0(ui chunk 881.94 kB / gzip 278.63);probe_nullopt CLEAN、probe_secretref PASS。

文档同步:UI规范 §8 判据清单五项→七项(补 surface)、§1.3 新增「抽屉可以整块开在屏幕外面」;
工程规范 §1.1 体检器职责改为 10 浮层 × 4 宽度 × 七项;README 六项→七项判据;报告补第二十六章
26.1–26.9(选型换向、版本读数、四条根因、改法、逐项验收、降级代价、注释泄漏、仍未做、抽屉开在屏外)。
2026-11-02 21:57:13 +08:00
mula.liu 83d262a199 文档把选型决策、R7 与探针口径写死:UI规范新增 §0.6「标准控件组 = Radix primitives + 自有皮肤」,报告补第二十五章。
UI规范.md:§0.6 一次讲清四层分工(尺子 tokens.css / 行为 primitives / 皮肤 layers.ts / 语义 ui+forms)、
否掉 antd-MUI-Arco 的三条量化理由(两套尺子、preflight 抢深浅主题、深色皮肤要覆盖八成)、
以及规矩(页面与 ui/ 不许直接 import @radix-ui/*、新浮层必须先在 primitives 落原语再登记、
层级只用一套、Esc 先看 floatingLayerOpen()、Content 上写 fixed 会让 Radix 量到 0 高)。
另立「两个咬过人的陷阱」:① [&>*]:min-w-0 与 min-w-(--label-w) 特指度平票会无声清零标签下限;
② Playwright 的 locator.click() 先做 DOM.scrollIntoViewIfNeeded 把目标居中,
「开抽屉把页面顶回顶部」就是这么造出来的假 bug——量滚动位移前基线必须在 scroll_into_view_if_needed() 之后取。
硬规则从六条升到七条(R6 从「不用裸 select」扩成「控件不用浏览器原生外观」,新增 R7 字段形态唯一);
§0.5 对照表补 Checkbox/Slider/Popup/Menu/Dialog 与 floatingLayerOpen 六行;§3 的 hint 栅格写法
从 grid-cols-[auto_minmax(0,1fr)] 更新成 minmax(var(--label-w),max-content)_minmax(0,1fr);
§8 登记 align4(五判据各 0 组)与 ctl4(31 项)为新口径。

工程规范.md:§1.1 依赖链插入 components/primitives/ 这一层(附「一个用户就进,不等第二个用户」的例外),
扩展点加「加一类控件行为」一行,§4 补依赖卫生判据:grep 出的 import 集合必须等于 package.json。
README:分层表加 primitives/ 一行,并写清「不引成套组件库」的结论与 5 个 radix 包全部有 import。
报告第二十五章:现象归因表(对齐是 CSS bug、下拉与原生外观才是组件库该管的)、选型对照表、
三个根因的读数、逐项验收表(30 字段五判据 0 组、31/31、原生残留 0、13 装 6 用 → 5 装 5 用),
以及仍然没做的四条(MediaLightbox/RecordAudio 自绘 overlay、检查器刻意非模态、Tabs/tooltip 无用户先卸包、
日期与命令面板按需再补)。
2026-11-02 16:17:20 +08:00
mula.liu b0086fb487 审核台两列统一成「标签在上」,立第 7 条硬规则 R7:同一个容器只用一种字段形态。
症状:/review 人工审核那列,审核人 的输入框比 问题描述 的文本框右移 47.3px,同一列量出三种控件左缘
(1353/1425/1472)。根因不在 CSS——那一列本身混了两种形态:审核人/任务优先级 走行内 Field(标签在左,
标签 66px 或 190px),问题描述/覆盖提示词 走 FieldBlock(标签在上),两种形态的控件左缘天生差整个标签列宽,
谁都对不齐谁;标签宽还随字数漂(覆盖负面提示词(可选)实测 113.3px)。

改法:合格 / 不合格 两列 4 处 FormRow 全部加 stack,容器级统一到底,不再逐字段挑形态。
豁免两类并由探针按 role 跳过:滑杆行与勾选行——Temperature 这种「标签即说明、轨道即整行」,
本来就没有「控件左缘」这个概念,混排判据对它们是误报(第一轮 nex_align4 就把 models 抽屉报成混用)。
2026-11-02 16:17:20 +08:00
mula.liu 670f4973e5 控件行为层选型落地:Radix primitives(headless)+ 自有皮肤,原生控件清零,字段标题同时被对齐。
用户问「要不要换一套标准控件组」。答:要,但只买行为不买皮肤——antd/MUI/Arco 自带 token(控件高 32px)
与我们的 --ctl-h-main(38px)并存就是两套尺子,再加一份 preflight 跟 Tailwind v4 base 层抢深浅主题,
而深色 studio 视觉本来就得覆盖八成,省下的工时会全数还回去。选定 Radix primitives + CVA 皮肤
(即 shadcn 架构,源码 vendored 在 components/primitives/),Radix 管 portal/定位/翻边/视口避让/焦点圈定与归还/
键盘/Esc 分层/锁滚动,尺寸配色仍只来自 tokens.css。

症状一:字段标题与控件不对齐,/review 同一列里控件左缘出现 1353/1425/1472 三种,最大右移 47.3px。
根因不是排版:Field 同时带 [&>*]:min-w-0(让长控件能收缩)与 min-w-(--label-w)(撑住标签列),
两条特指度都是 0-1-0,Tailwind 把 min-w-0 排在自定义值之后 → 66px 下限被无声清零,控件左缘跟着中文标签字数漂。
改法:下限换到压得住的选择器 [&>span:first-child]:min-w-(--label-w)(0-2-0),hint 栅格的标签列
从 auto 换成 minmax(var(--label-w),max-content);尺子补 --field-label-w:66px(全站 193 个行内标签的 p90)
与 --label-w 作用域开关(FormRow 抬起、Ctlbar/ChipBar/CardActions/Pager 压回 0,工具条不参与表单对齐;
≤560px 一行一个字段没有对齐对象,直接归 0)。

症状二:勾选框是 macOS 系统绿圆角块、滑杆是系统 range、分页还有个裸 select,深浅两版主题各长一个样;
「按一次 Esc,下拉连背后的抽屉一起没了」。改法:checkbox/range/menu/dialog 全部接进 primitives
(Checkbox 尺寸收成 --check-size 14px、触摸档 18px),每层浮层带 data-nex-layer,
页面级快捷键第一行 if (floatingLayerOpen()) return,层级只用一套(遮罩 100/抽屉 101/模态 111/下拉 400);
手写的 use-outside-click 删掉,外点关闭交给 Radix。依赖清单同步等于实际 import:卸载 8 个装了没在用的
@radix-ui/*(tabs/tooltip/label/separator/progress/radio-group/switch/visually-hidden),
顺带删掉这条死链上唯一消费它们的 ui/Toggle.tsx(0 个用户),现在 5 个 radix 包全部有 import。

实测:nex_align4.py 全站 30 个表单字段,五项判据(同列控件左缘不一致 / 标签压控件 / 控件溢出字段盒 /
行内标签与控件中心不齐 / 同列 stack-inline 混用)全 0 组、0 console error;nex_ctl4.py 31 项控件行为回归
31/31(抽屉+下拉叠加、Esc 只关一层、锁滚动不横跳、点文字切勾选、滑杆键盘可调、菜单方向键与焦点归还、
真实鼠标开关抽屉滚动全程守恒 101→101→101);源码里裸 select/checkbox/range 残留 0(grep 仅剩 3 条注释);
tsc --noEmit 与 npm run build 均 EXIT=0。
2026-11-02 16:17:09 +08:00
mula.liu e70c508044 修掉下拉浮层被自己 layer 上的 fixed 废掉避让:Radix 的 translate 在它外层 wrapper 上,面板再写 position:fixed 就脱离文档流、wrapper 量到的高度是 0,flip/size 全按 0 高算——1280x720 贴近视口底边的下拉要么该翻不翻被压成 35px,要么翻了不减高度掉出屏幕 125px,右侧还会溢出视口 45px;去掉 fixed 后 19 个下半屏下拉全部完整落在视口内、三个宽度下无横向裁切。顺手把 /account 两列与三列两张卡也接进 FormGrid 基准栅格,多栅格容器错位归零。 2026-11-02 15:20:16 +08:00
mula.liu 139db20320 新增 FormGrid 表单级 12 列基准栅格:列边界从每条 FormRow 上收到表单作用域统一定义一次,FormRow 的 cols 退化为「这行几个字段」= 每字段跨 12/cols 格,横向间距也归表单管(基准栅格里换列间距会让整条列线漂 1.7px),一行一项与 width=full 用 :only-child/data-full 铺满;模型抽屉、分镜检视器、素材抽屉等 7 个多行表单容器接入,字段标题错位从 110px 降到 0;Slider 标签并入 LABEL_CLS 与 Field 同尺;孤立 FormRow 保留原 auto-fit 路径零改动。 2026-11-02 14:59:35 +08:00
mula.liu c5edd65d82 下拉控件迁入 Radix primitives:新建 components/primitives(Popup + CVA 尺子 + 共用 listbox 键盘 hook),Select/MultiSelect 全部改由 Radix Popover 接管浮层行为——面板宽度至少等于触发器、按最长选项展开到 440px 不再换行,两档触发器同字号同圆角,翻边/滚动/外点关闭交给 Radix;顺手修掉「点触发器自身关不掉面板」的 anchor 误判(Radix 把 handler 挂在真实被点元素上,原先的 currentTarget 比较恒真),并补上多选的首字母定位。表单公共 API 一字未改,页面 87 处调用零改动;旧的 use-popup/parts 手工定位已归档。 2026-11-02 14:46:44 +08:00
mula.liu 34f8862cfe UI 规范补上标签章节与 React 量法:§2 写清两族胶囊的分工、--tag-* 两档挂在容器上、TagGroup 的 6px/12px、min-height 与 font-size 两个 tailwind-merge 陷阱;§3 补 Field hint 的栅格写法与「一个容器只有一个 --ctl-h 档位」;§0.5 对照表按真实签名重写并登记已废弃的英文眉标;§1.3/§8 换成 React 时代的四条探针 2026-11-02 10:51:18 +08:00
mula.liu 7fcfd2932b 标签统一收尾:调度中心页头的队列计数与总控台的镜头状态计数不再借 Chip 的 31px 胶囊皮肤,改成和旁边标签同档的 TagGroup,只读回显全部归到标签族 2026-11-02 10:50:56 +08:00
mula.liu 19db4ef3a0 我的账号与用户管理:表单改成明确的列栅格、规则说明落到字段下方而不是塞进 placeholder,登录设备标题把原始 UA 解析成「Chrome 155 · macOS」并限高滚动,用户管理的筛选条从面板头挪回列表上方、详情字段竖排、允许登录独立成行 2026-11-02 10:33:11 +08:00
mula.liu 72afec93fc 标签统一:Tag/Status/Badge 合并成一个壳(同一份度量 + 同一张色板),尺寸改成挂在容器上的 --tag-* 两档令牌(表格自动降 sm),新增 TagGroup 管住组内 6px / 组下 12px,只读回显不再用 31px 胶囊、页面手抄的标签皮肤全部收编;Field 的 hint 真正落地、FormRow 子项贴顶对齐 2026-11-02 10:32:48 +08:00
mula.liu 8614360ab7 控件几何统一:字段不再被 flex 拉伸、表单容器独占主尺寸档位、多行文本按 --ctl-h 倒推 padding、数字框去 UA spinner、裸 select 补主题化箭头、密钥眼睛贴回右缘 2026-11-02 10:04:57 +08:00
mula.liu ca73bda68f 去掉中英并列的眉标:页面/面板/抽屉标题只保留中文一层 2026-11-02 10:00:00 +08:00
mula.liu 889c6d113a UI 规范:删掉最后一处「全局 :has 兜底」的过时说法,与 §3 的 React 现状保持一致 2026-11-01 19:48:52 +08:00
mula.liu 5288f52b86 前端去重复:抽屉三段皮肤与浮层关闭钮收进 ui/Overlay(分镜检查器改为复用常量),长文本字段高度收进 TEXTAREA_TALL;UI 规范把星号/说明文字/抽屉三条改成 React 现状并删掉已随旧 CSS 删除的全局兜底,清掉空的 components/layout 2026-11-01 19:48:04 +08:00
mula.liu e4715cf967 修复 React 迁移遗留:分镜检查器改文案用 ref 取代失效的 .sb-insp 选择器、受控勾选框补 onChange 消除只读告警、seed 回落空串保持受控、登录用户名补回 #login-user;同步用例计数 2026-11-01 19:38:59 +08:00
mula.liu 20e8f19eca 前端统一收尾:图文手册从 public/help.html 搬成站内 React+Tailwind 页面 /help,SPA 深链回落与未知接口 404 拆成纯函数补自检,新增 ErrorBoundary 兜住分包加载失败 2026-11-01 19:25:47 +08:00
mula.liu e8e5a1cd2b 文档与脚本同步 React+Tailwind:UI 规范增加词汇→原语对照,工程规范补 frontend/src 分层与扩展点,README 目录/构建口径更新 2026-11-01 19:01:03 +08:00
mula.liu e677d891d4 项目页签表从 zustand 切片移入 app/layout/nav.ts:导航是静态表不是状态 2026-11-01 18:59:46 +08:00
mula.liu 816cdc25b7 修复 media/ 忽略规则误伤前端组件:补回 components/media 六个组件、部署体检增加前端源码完整性计数 2026-11-01 18:59:46 +08:00
mula.liu 13e1990888 迁移平台资产库:三类母版网格/列表/素材墙 + AI 生成抽屉;Drawer 宽度可传类、Pager 支持自定义每页档位 2026-11-01 18:54:46 +08:00
mula.liu 569f4c2f1d 迁移项目总控台与流程概览:LLM 指令台(折叠执行过程/规划计时/阻塞解释)+ 节点明细/预检/项目设置/统计/事件流;Grid 支持两段式降列 steps 2026-11-01 18:19:43 +08:00
mula.liu 5e641ffe46 迁移分镜与脚本页签:看板/分镜表双视图 + 常驻检查器(文案/资产/提示词/产物)+ 脚本导入与预检;修正 FormRow 非 tight 行缺列间距 2026-11-01 18:00:44 +08:00
mula.liu 8d5e1b59af 迁移资产管理页签:三类资产卡/搜索筛选批量/AI 生成台抽屉;CardRow 皮肤抽为 CARD_ROW,SectionTitle/FilePick 支持 title 2026-11-01 17:34:14 +08:00
mula.liu 1ea2c97827 迁移模型控制台:能力左栏/模型卡/密钥明文/探测/高级 JSON 抽屉 2026-11-01 17:20:28 +08:00
mula.liu 733f2e9fe5 迁移时间线合成页签:片段卡/字幕/混音设置/音轨/版本表;Field 支持 title、新增 FilePick 原语 2026-11-01 17:14:00 +08:00
mula.liu f382b0113e 迁移项目总览:新建项目表单 + 资源库母版勾选 + 项目列表(窄屏卡片);修正表头右对齐被子选择器压掉 2026-11-01 17:07:19 +08:00
mula.liu 8b9f8ebaa5 迁移质检与审核页签:质检清单/画面质检面板/审核表单/留痕 2026-11-01 17:01:35 +08:00
mula.liu 88a05eb189 迁移调度中心页签;Button 抽出 buttonCls 供站内链接复用、Chip/Check 支持只读与 title 2026-11-01 16:59:48 +08:00
mula.liu da679e135e 迁移导出与成本页签;Grid 改为 CSS 变量列宽、补充 MONO/TabStack 原语 2026-11-01 16:57:10 +08:00
mula.liu c2bdd6e070 迁移用户管理页;Table 支持整行选中、StatGrid 支持自定义降列节奏、Select 支持 title 2026-11-01 16:54:51 +08:00
mula.liu b8734c9adc 迁移页面骨架原语(PageHead/Layout/Stack)+ 登录、我的账号、项目工作台 2026-11-01 16:52:45 +08:00
mula.liu 93abe0ce7b 迁移应用外壳:AppBar / SideNav / AuthGate / 路由 + 页面占位,全量 typecheck + build 通过 2026-11-01 16:48:29 +08:00
mula.liu 9467e1bb97 v 0.1.0 2026-11-01 16:18:07 +08:00