NEX 阶段 8·D17/N7:<768 导航改左抽屉,同一屏只剩一个导航入口,顶栏胶囊溢出归零
用户批准「移动端导航采用抽屉式 Drawer」。改前三条实测决定了必须怎么改:
① Sider 的 breakpoint="md" 把侧栏自动收成 64px 图标轨,而汉堡同时还在,
label 写着「展开导航菜单」——点它只把图标轨撑回 224,随即又被 breakpoint 收回,
同一屏两个导航入口且行为自相矛盾(NEX 04 §8.2 明令消掉的状态);
② 那 64px 是真金白银的正文宽度:430 实测正文盒 366(可用 342)、576 实测 512;
③ D17 那 33–38px 溢出正是被它逼出来的:流水线台那颗 Button 内容居中,
装不下就两端一起往外溢——430 胶囊盒子 x=100 w=172、内容 sw 203,
项目名从 x=63 起画(比胶囊左沿还偏左 37px),箭头画到 x=305(胶囊右沿 272)。
实现:
- kit Drawer 加 placement(默认 right,站内既有 10 处调用点一个都不传,行为逐字不变)
与 flushBody。flushBody 只能是 prop:.ant-drawer-body 的 padding 是 antd CSS-in-JS 的
未层声明,页面写 p-0 在 @layer utilities 里,层外压层内(同 §1.1.1 的 .nex-tag 实测)。
左右默认宽分档(左 min(288px,100vw−48px) / 右 DRAWER_WIDE):抽屉宽度取决于它是
「替换主内容的位置」还是「压在主内容上的一块面板」。
- AppSider 拆三导出:AppNavMenu(菜单本体)/ AppSider(≥768 常驻,撤 breakpoint)/
AppNavDrawer(<768 左抽屉,宽 = SIDER_WIDTH 224 + flushBody)。抽屉宽不取 antd 默认 378:
里面是同一份菜单,宽度一换折行、缩进、选中底色宽度全都换,等于凭空多出第二个导航形态。
- App 测一次 narrow(Grid.useBreakpoint().md === false,undefined 当桌面否则 1440 会闪一帧
「没侧栏只有汉堡」)往下传:侧栏在不在、汉堡点哪儿,两处必须同一个答案。navOpen 换页自动关。
- 同一颗汉堡换语义:≥768 折叠侧栏(原文案),<768 开合抽屉(打开/关闭导航菜单),
aria-expanded 只在抽屉形态给(折叠侧栏是布局尺寸,不是被展开的面板);图标改按
「导航现在露没露」选,≥768 时 navShown === !collapsed 与改前逐字同值,<768 抽屉关着时
画的正是改前那颗 Expand → 顶栏像素没动。
- PipelineConsole 的项目名只在 <768 恢复收缩权(max-md:min-w-0 max-md:flex-[0_1_auto])。
第十三轮给的 flex-none 是为了「名字不许被散文吃掉」,那条在 ≥768 依然成立;手机档没有
散文可吃(cur <lg 隐、rail <xl 隐、status <md 隐),只剩「名字 vs 百分比+箭头」一道减法,
折出来的是省略号 + tooltip(§15.2 第 7 条:省略号可以,残字不行)。
探针:visualcheck 补 probe.sider;菜单断言先问侧栏在不在,<768 真点一下汉堡,量
.ant-drawer-content-wrapper(外层 .ant-drawer 是 inset:0 的遮罩容器,宽恒等视口,拿它比 224
会全线误报)并断言左贴边 / 宽 224 / 选中态底色等于桌面同一份 token / Esc 必须关。
顺手修掉一处从阶段 0 就存在的失配:menu_required 用 `path in NAV_ROUTES` 比的是**模板**
(/projects/{id}/overview),主循环早已换成真实 id,七条项目路由从没进过菜单断言——
新增 in_nav() 后覆盖 3 → 10 条路由。
未做(授权 §六):卡片没扩大、栅格没改、56/224/64 与控件三档一字未动、430 的表格仍横向
滚动而没有顺手改堆叠单栏。
验证:typecheck 通过 · build 通过(仅既有 chunk>1200kB 告警)· classaudit 九道全 0 exit 0 ·
visualcheck 120 状态(15 路由 × 4 视口 × 明暗)0 断言 / 0 HTTP / 0 console ·
常驻 11 道探针 EXIT=0 ×11(GATEPROBE_OK 11/11)· 第 9 闸反证 BP_PROBE_OK 10/10 ·
navprobe 几何 FAIL 4/10 → PASS 0/10(430 溢出 33→0、正文 366→430)·
drawercheck 行为账 after PASS 0 条,对 HEAD 反证 FAIL 10 条 ·
tableaudit 逐视口前后:1440 两态 0 违规、768 两态逐字相同、576 溢出量各 −64、430 违规 9→6 ·
≥768 像素疑点定性为 Noto Sans SC 异步 swap 竞态 + 活动角标漂移:document.fonts.ready 后
before/after 顶栏强差 0(1440 与 768),1440 两态 DOM 几何逐字相同。
证据 reports/ui_evidence/nex-p8/d17/。
规范同步:UI规范 §6 外壳表补 AppNavMenu/AppNavDrawer 两行并写清撤 breakpoint 的理由、
§15 第 3 条改抽屉口径 + 登记 NAV_ROUTES 事故、§4 insp-sm 同步复核结论;
NEX-对照与例外 §2.4 <768 DEFERRED → ADOPTED、§5 N7 → 已采纳、§6 D17 → 已修、§7 变更记录;
nex.config.yaml shell 段加 sidebar_narrow: drawer 并校正四条尺寸的实现行号。
main
parent
0b9ea0a430
commit
ae4dd7f68e
|
|
@ -92,7 +92,7 @@ NEX 与本项目差异用「项目适配」解决,**不得反向修改本项
|
|||
| §7 面包屑要求 | **ADAPTED**(E5) | `UI规范.md` §0 R18 | 本项目**不用**面包屑:R18 要求「每级身份只说一遍」,门牌 + 侧栏已表达归属;kit 导出的 `Breadcrumb` 实测 0 个页面使用 |
|
||||
| §8 响应式断点(576/768/992/1200) | COMPLIANT + **ADAPTED**(E9) | `styles/index.css:166-170` | 五档与 antd Grid 全等(含 1600 = antd `xxl`),主阶梯未造私档 |
|
||||
| §8 「不允许私有断点」 | **ADAPTED**(E9,阶段 7 已收口) | `styles/index.css:171-175`、`UI规范.md` §4「登记断点」 | 原则接受并已收口:页面里 5 个私档(`max-[620px]`×10、`max-[720px]`×2、`max-[1080px]`、`max-[1240px]`、`max-[1400px]`)改名为 `--breakpoint-*` 命名变体,`grep -rn "max-\[" frontend/src` = 0,**px 一字未改**(归到相邻档位会让已验证的看板列数 / 检查器宽度回退,实测见 §4 表)。机制本身已被 NEX 采纳(**N16 已闭**:`04-layout-system.md` §8.1「命名断点登记出口」四条口径),并且四条全部由 `classaudit.mjs` **第 9 闸 BP** 机器对账(裸 `max-[…]`、未登记名、一名多使用者、0 使用者、`UI规范.md` §4 缺行、`visualcheck.py` 的 `BP`/`BPORDER` 失同步、`.css` 里未登记的 `@media` 像素) |
|
||||
| §8 工作区 <768 降级 | **DEFERRED(待产品决策)** | `AppSider.tsx:80`(`breakpoint="md"` + `collapsedWidth=64`) | 现状:窄屏侧栏自动收成 64 图标轨(可用,不是隐藏)。是否改抽屉化**暂缓**(阶段 5 已用于反馈预算 N10;导航形态需产品决策,方案 A/B 见实施报告);NEX 侧缺降级范式 → **N7** |
|
||||
| §8 工作区 <768 降级 | **ADOPTED**(阶段 8 · 用户批准 N7) | `app/layout/AppSider.tsx`(`AppNavMenu` / `AppSider` / `AppNavDrawer` 三导出)、`app/App.tsx:187`(`narrow`)、`app/layout/AppHeader.tsx`(同一颗按钮换语义) | <768 **不渲染侧栏**,导航只剩顶栏汉堡一个入口,点开的是 kit `Drawer placement="left"`(宽 = `SIDER_WIDTH` 224、`flushBody` 贴边、换页自动关)。改前三条已实测:图标轨 + 汉堡**同屏两个入口**语义重叠、正文白吃 64px(430 档正文 366、顶栏胶囊 `sw203>cw170` 溢出 33px)。菜单本体是**同一份组件**,不是第二套导航。NEX 侧的范式已由 **N7** 落到 `04-layout-system.md` §8.2「导航形态在同一视口内只留一个入口」;≥768 的手工折叠(64 图标轨)保留不动 |
|
||||
|
||||
### 2.5 `docs/05-component-system.md` — 组件系统
|
||||
|
||||
|
|
@ -144,7 +144,7 @@ NEX 与本项目差异用「项目适配」解决,**不得反向修改本项
|
|||
| §1 语义化交互(不用 `div + onClick`) | **ADOPTED(原则)**;3 处热区 **本轮阶段 2 修** | `Storyboard.tsx:1915`(`<article onClick>`)、`ui/Rows.tsx:11`(`<div onClick>`)、`AppHeader.tsx:60,70`(`Avatar`/`Text` 当链接)——**行号为阶段 0 记录值**;阶段 2 之后三处已分别变为 `Storyboard.tsx:1915+`(带 `tabIndex`/`onKeyDown`)、`ui/Rows.tsx:27`(`clickable` 分支)、`AppHeader.tsx:70`(已是真 `<Link>`) | 原则完全接受;存量违规仅这 3 处(已核实:`MediaThumb.tsx:106`、`AudioPlay.tsx:68`、`MediaLightbox.tsx:186` 均已带 role/tabIndex/aria-modal,**不是**问题) |
|
||||
| §2 焦点与键盘 | COMPLIANT(+ 阶段 2 增补拖拽替代) | `app.css` 全站 `:focus-visible` 兜底;`ui/Table.tsx`、`MediaThumb.tsx`、`AgentConsole.tsx` 键盘处理;`lib/layers.ts::floatingLayerOpen` 分层 Esc | 拖拽排序的键盘替代 NEX 未覆盖 → **N14**,阶段 2 一并补 |
|
||||
| §3 对比度 / 状态不只靠颜色 | COMPLIANT | `UI规范.md` §2.1(标签=点+文字,非仅颜色)、`Status` 文案来自 `lib/format.ts::statusLabel` | 状态一律「点 + 文字」双通道 |
|
||||
| §4 响应式(明确滚动容器) | COMPLIANT;侧栏 <768 **DEFERRED(待产品决策)** | `UI规范.md` §0 R13/R15;`LogBox`/`Drawer` 滚动容器在组件内 | — |
|
||||
| §4 响应式(明确滚动容器) | COMPLIANT;侧栏 <768 **ADOPTED(阶段 8 · N7,见上 §8 行)** | `UI规范.md` §0 R13/R15、§6 外壳表;`LogBox`/`Drawer` 滚动容器在组件内 | 导航抽屉的滚动与焦点行为走 kit `Drawer`,页面侧没有新滚动容器 |
|
||||
| §5 内容与长文本(截断须给完整文案) | COMPLIANT(标签一处破口 **本轮阶段 1 修**) | `ui/Table.tsx::Clamp`、`min-w-0` 约定、`app.css:425-430`(`.nex-tag-text` 省略)| 分镜卡状态标签截断后**取不到完整文案**(缺 `title`)→ D1,阶段 1 修并补探针 |
|
||||
| §6 动效与性能 | COMPLIANT | 路由懒加载 + 空闲预取(`app/App.tsx`) | 大数据虚拟化列 **DEFERRED** 为观察项(实测最大列表受 `page_size` 约束) |
|
||||
|
||||
|
|
@ -263,7 +263,7 @@ cd frontend/src && grep -roh -- '--nex-[a-z0-9-]*' . | sort | uniq -c | sort -rn
|
|||
| N4 | `--nex-*` 令牌层与既有局部变量同名 | 本表 **E8/§4** 别名表 | 已登记(本项目已解法) |
|
||||
| N5 | 控件档位 34/40 无选择依据 | 本表 **E3** | 已登记 |
|
||||
| N6 | 03 §10 要求层级表但**没给表** | 阶段 3 已产出 `lib/layers.ts::LAYER` + `UI规范.md` §10 十三行表;建议 NEX 同样只给「关系」而非固定数字 | ✅ 阶段 3 已解决 |
|
||||
| N7 | 04 §8 缺「专业工作区 <768 降级范式」 | 本项目暂缓(导航形态需产品决策,A/B 方案见实施报告)+建议 NEX 补 | 待议(未纳入阶段 4–7) |
|
||||
| N7 | 04 §8 缺「专业工作区 <768 降级范式」 | 阶段 8 用户批准采纳抽屉化,本项目已落地(§2.4 的 <768 行);NEX 侧同步补 `04-layout-system.md` **§8.2**(导航只留一个入口 + 内容按数据密度三选一:横向滚动 / 堆叠单栏 / 抽屉化) | ✅ 已采纳(本项目阶段 8 · D17/N7 提交落地 · NEX 子仓库 `63e36ec`) |
|
||||
| N8 | 04 §5 对「画布型工作区」无规范 | 建议 NEX 增补 Canvas Workspace;本项目先在 `page_patterns.project_specific` 声明 | 已声明 |
|
||||
| N9 | 05 §3.6 未要求 Skeleton / 未定字段级 busy 规则 | 本项目已在 `UI规范.md` §13.8 自定「首屏用骨架 / 局部用 Spinner / 一屏只播一句进度」三条判据(阶段 4);建议 NEX 补进 05 §3.6 | ✅ 本项目已解决;待 NEX 侧采纳 |
|
||||
| N10 | 06 §7 未给「页内状态 vs Toast」量化门槛 | 本项目自定 `UI规范.md` §13.3 ⑤(两条预算 + 一句话判据 + 十一例正则自查)+建议 NEX 补 | ✅ 本项目已解决(阶段 5);待 NEX 侧采纳 |
|
||||
|
|
@ -283,7 +283,7 @@ cd frontend/src && grep -roh -- '--nex-[a-z0-9-]*' . | sort | uniq -c | sort -rn
|
|||
| ~~R8 文档白名单口径~~ | ✅ **阶段 6 已解决(采纳 ①)** | 文档与探针原本各说各话:`UI规范.md` R8 只放行到 `app/layout/`,第 5 闸实际放行整个 `app/`(`app/App.tsx:21` 裸用 `Button/Layout`、`app/ErrorBoundary.tsx:17` 裸用 `Result/Typography`) | R8 改写为「`theme/` · **`app/` 整个外壳层** · `components/{ui,forms}`」并与 §15.1 同一口径。理由:外壳只此一份、不往 `pages/` 扩散,包一层只会多一个名字;真正要拦的是**页面** import 组件库。② 收紧探针被否——那会把 `App.tsx` 的首屏骨架与错误边界再包一层空壳 |
|
||||
| kit 里两个 0 调用但**故意保留**的名字 | `ui/Page.tsx::Breadcrumb`(antd `Breadcrumb` 的薄封装)与 `ui/Controls.tsx`→`ui/Ctlbar.tsx::RadioGroup`(antd `Radio.Group` 封装)当前 0 处调用 | 阶段 6 决策:**不删**。`Breadcrumb` 是 NEX 04 §7 详情/层级导航的唯一落点,删了下次做层级页就得重造;`RadioGroup` 是 R19/§9 里「互斥选项」的唯一名字(分段切换用 `Segmented`,二选一互斥表单用 `RadioGroup`)。复核口径:下一个用到它的页面必须同时删掉本行;若连续两轮仍未被使用,转删除 |
|
||||
| ~~**D16 kit `Tag` 吞 className**~~(阶段 1 发现) | ✅ **阶段 8 已修**(`components/ui/Status.tsx::Tag` 的 `className` 并进 `cn()` 且放在最后,学同文件 `Badge` 先例) | 原缺陷:形参收了 `className` 但 `cn('nex-tag', …)` 没并进去 → 页面写 `<Tag className=…>` / `<Status className=…>` 全部空转。**修好后查实真实边界与最初推测不同**:① `styles/index.css:55` 的 `@import "./app.css"` **不带 layer**,未层声明高于任何 `@layer`,`.nex-tag.ant-tag` 独占 13 族属性,页面 utility 压不动;② `.ant-tag` 带 `transition: all .2s`,改完 `className` 立刻读 `getComputedStyle` 拿到的是过渡**起始值**——「utility 大面积失效」一半是读数假象(立即读 `ml=0px`,700ms 后 `ml=8px`)。明暗两档实测能力矩阵:`ml-*` `mt-*` `flex-none` `flex-1` `font-mono` `font-bold` `italic` `absolute`+`inset-*` `truncate` **生效**;`mr-*`/`me-*` `hidden`/`max-<bp>:hidden` `bg-*` `text-*` `rounded-*` `p-*` `leading-*` `min-h-*` `gap-*` `max-w-*` `whitespace-*` `overflow-*` **被壳吃掉** | 站点回归口径:`pages/ModelCenter.tsx:973`「默认」只留 `font-bold`(`bg-*`/`text-*`/`border-*` 属皮肤族点不亮,且 §2.1 已废止语义铺底);`pages/project/Review.tsx:363` 由 `className={MUTED_MONO}` 改走 `tone="mono"`;`pages/project/Storyboard.tsx:1983,1985` 撤掉 `<span className="flex-none">` 包装(角标此前被 `overflow-hidden` 裁掉,`vis` False→True 是本轮唯一真实视觉新增);`app/layout/PipelineConsole.tsx:158-161` 的 wrapper **保留**(`max-md:hidden` 属 display 族,壳吃掉了它)。口径 + 200ms 坑写进 `UI规范.md` **§1.1.1**;`scripts/ui/classaudit.mjs` 新增**第 8 闸 TAGSKIN**拦「给 `ui` 的 Tag/Status 传皮肤类」 |
|
||||
| **D17 窄屏顶栏项目名压到品牌块**(阶段 2 复测新发现) | 430 视口下 `.nex-console` 内容比自己的盒子还宽(改前 `scrollWidth` 214 / `clientWidth` 173 → 项目名 `<strong>` 从 x=57 起,压住品牌块 49..81;阶段 1 收口后 203/170,窄了 11px,**同一处问题改前就存在**) | 不是阶段 1/2 引入的回归;影响 430 一档的顶栏可读性,且让 `elementFromPoint` 类探针在品牌块处拿到错的节点 | **本轮不修**:修法要么缩顶栏内容、要么改窄屏品牌块形态,二者都属「Header 尺寸/移动端导航形态」(授权 §八 明确排除)。留待与 N7 一起决策(阶段 5 已用于反馈预算,未包含导航形态;A/B 方案见实施报告) |
|
||||
| ~~**D17 窄屏顶栏项目名压到品牌块**~~(阶段 2 复测新发现 · **阶段 8 已修**) | 430 视口下 `.nex-console` 内容比自己的盒子还宽(改前 `scrollWidth` 214 / `clientWidth` 173 → 项目名 `<strong>` 从 x=57 起,压住品牌块 49..81;阶段 1 收口后 203/170,窄了 11px,**同一处问题改前就存在**);阶段 8 改后 `sw == cw`(430 实测 ovf=0,子元素全在盒内) | 不是阶段 1/2 引入的回归;影响 430 一档的顶栏可读性,且让 `elementFromPoint` 类探针在品牌块处拿到错的节点 | 当时不修的理由成立:修法要么缩顶栏内容、要么改窄屏品牌块形态,二者都属「Header 尺寸/移动端导航形态」(阶段 0–7 授权 §八 明确排除)。**阶段 8 用户批准 N7 后随导航形态一起修**:① <768 不再渲染侧栏,正文拿回 64px(430 档 366 → 430);② 项目名在 `<768` 恢复收缩权(`max-md:min-w-0 max-md:flex-[0_1_auto]`),溢出 33px 归零、折出来的是省略号 + tooltip 而不是残字(§15.2 第 7 条)。实测见 `reports/NEX阶段8实施-2026-11-07.md` §3 |
|
||||
| 阶段 7 交付项 | 断点归一:页面里 5 把裸 `max-[...]`(10 + 2 + 1 + 1 + 1 处)改成 `--breakpoint-*` 命名变体(`insp-lg` / `board` / `insp-md` / `insp-sm` / `agent`),`grep -rn "max-\[" frontend/src` = 0;px 一字未改,16 档视口探针(`sbprobe` / `agentprobe`)与归一前逐档等值;`visualcheck.py` 的 `BP`/`BPORDER` 同步补名(否则 `wantDisplay` 静默跳过断言) | ✅ 已完成(见 §7) | 明细见 `reports/NEX阶段4-7实施-2026-11-07.md` |
|
||||
| 阶段 6 交付项 | kit 拆分与死代码清理:`ui/Panel.tsx` → `Panel`(容器与栅格)+ `State`(六态表面)+ `Info`(只读回显);`ui/Controls.tsx` → `Ctlbar`(控件栏与胶囊)+ `Fields`(字段);`ROW_STEPS` 并入 `grid.tsx`(等分控件栏与 `FormRow` 共读一张降列表);出口仍是 `ui/index.ts`,**业务页 0 diff**,净代码行 655 → 650。删死代码 7 个:`useAsync`、`usePolling`(连带删两个 hook 文件)、`navItemAt`、`Page.Sub`、`Controls.Req`、`Panel.Meta`、`forms/options.summaryOf`、`forms/Select.SelectOptionList`;`Breadcrumb` / `RadioGroup` **保留待用**(见下一行);`classaudit` 第 6 闸 `FB_IMPL` 白名单同步认出 `State.tsx` | ✅ 已完成(见 §7) | 明细见 `reports/NEX阶段4-7实施-2026-11-07.md` |
|
||||
| 阶段 5 交付项 | 反馈预算(N10)落地:`UI规范.md` §13.3 ⑤ 新增两条预算 + 判据;`ModelCenter` 两颗开关补吐司、「已保存/已删除」从抽屉外的页头 `Notice` 改走吐司(页内 `Notice` 只留错误与故障注入);`Library` 5 处裸 `confirm()` → `confirmAction`,录音链 3 颗 → 1 颗(`lib/versions.ts::keepOrRestoreCurrent` 加 `sink` 出口,默认 `notify` 故平台资产库零改动);`Dashboard` 统计卡 xs 档降列改两列(430 首屏可见第一张项目卡);`classaudit` 第 6 闸正则放宽并修掉「只匹配 `window.confirm(`」的反向漏检 | ✅ 已完成(见 §7) | 明细见 `reports/NEX阶段4-7实施-2026-11-07.md` |
|
||||
|
|
@ -301,6 +301,7 @@ cd frontend/src && grep -roh -- '--nex-[a-z0-9-]*' . | sort | uniq -c | sort -rn
|
|||
| 2026-11-07 | 阶段 1 落地截断兜底:`visualcheck.py` 新增 `tagtitle` 探针、`ui/Status.tsx` 组件级 `title` 兜底、分镜卡状态标签与顶栏流水线台收口;`UI规范.md` §2.1/§15.2 补「信息标签可截断但必须有兜底」口径;登记缺陷 **D16**(见 §6) | Codex(阶段 1) |
|
||||
| 2026-11-07 | 阶段 2 三处非语义热区可键盘化:分镜卡 `<article>` 加 `tabIndex/aria-label/aria-current` + Enter/Space (守卫 `ev.target === ev.currentTarget`,不套 `role=button` 以免抹掉卡内控件);`ui/Rows.tsx::LogRow` 加 `clickable` 分支(role/tabIndex/onKeyDown,保留 `title` 语义与逐字颜色);`AppHeader.tsx` 品牌区由 `onClick + navigate` 改为真实 `<Link>`,头像与平台名合并为**一个**焦点站点(1440 下块宽 138px 与合并前一致)。登记缺陷 **D17**(见 §6) | Codex(阶段 2) |
|
||||
| 2026-11-07 | 阶段 4 补齐六态表面:新增 `ui/Panel.tsx::SkeletonBlock`(阶段 6 起在 `ui/State.tsx`)(antd `Skeleton` + `role=status` + `sr-only` + `.nex-skeleton` 闸门落点,不传 `label` 时整块 `aria-hidden` 以免一屏播两句进度)与两页兜底 `pages/Forbidden.tsx`(`AuthGate` 拦住非管理员时就地解释,权限规则未变)、`pages/NotFound.tsx`(`router.tsx` 的 `path:'*'` 不再静默 `Navigate` 回首页);`Drawer` 新增 `loading` 并接入 `ProjectBriefDrawer`;三处首屏 `<Loading>` 换成骨架后旧导出连同其 antd `Spin` import 一并删除;`UI规范.md` 新增 §13.8 六态表面 + §10 抽屉骨架口径 + §15.2 名单 14→15;`visualcheck.py` 增加 `/not-a-page` 探针(不入 `NAV_ROUTES`)与「页面不存在」文案断言 | Codex(阶段 4) |
|
||||
| 2026-11-07 | **阶段 8(已批准决策 ①–③,逐项一次提交;④ N14 见下一行)**:① **D16** `ui/Status.tsx::Tag` 的 `className` 并进 `cn()`,三处站点按实测能力边界改写,`classaudit` 增第 8 闸 TAGSKIN;② **N16** `classaudit` 增第 9 闸 BP(断点五判据机器对账),NEX 子仓库补 `04-layout-system.md` §8.1「命名断点登记出口」;③ **D17/N7** <768 导航改 `AppNavDrawer`(kit `Drawer` 加 `placement`/`flushBody`,侧栏撤 `breakpoint="md"`,菜单本体 `AppNavMenu` 两处共用),430 顶栏胶囊溢出归零、正文 366→430,`visualcheck` 的菜单断言补窄屏抽屉路径并顺手修掉 `NAV_ROUTES` 模板失配(覆盖 3 → 10 条路由)。`UI规范.md` §4 `insp-sm` 理由同步、§6 外壳表加抽屉行、§15 第 3 条改口径;`nex.config.yaml` shell 段加 `sidebar_narrow: drawer` | Codex(阶段 8) |
|
||||
| 2026-11-07 | 阶段 7 断点归一:`styles/index.css` 增设 5 把**登记断点**(1400/1240/1080/720/620,一名一使用者),`Storyboard.tsx` 4 处 + `AgentConsole.tsx` 10 处裸 `max-[...]` 全部改名,px 与媒体查询一字未动(`@media not all and (width>=…)` 逐条比对);`UI规范.md` §4 新增「登记断点」表 + R9 补登记出口;`visualcheck.py` 断点表同步 | Codex |
|
||||
| 2026-11-07 | 阶段 6 拆 kit 与清死代码:`ui/Panel.tsx` 拆出 `ui/State.tsx`(ProgressBar/Empty/SkeletonBlock/Spinner/Notice)与 `ui/Info.tsx`(Value/LineHint/Mono/ExtLink/Info/Count),`ui/Controls.tsx` 拆成 `ui/Ctlbar.tsx` 与 `ui/Fields.tsx` 后删除原文件,`ROW_STEPS` 移进 `grid.tsx`;`components/ui/index.ts` 出口扩到 5 个模块,业务页 0 改动;删 7 个 0 调用导出与 2 个死 hook 文件;R8 承认 `app/` 为外壳层(解本文件 §6 第一条漂移),`UI规范.md`/`工程规范.md`/`app.css`/`App.tsx`/`Status.tsx` 五处实现路径同步 |
|
||||
| 2026-11-07 | 阶段 5 定反馈预算(N10):`UI规范.md` §13.3 新增 ⑤「一次操作的反馈预算」(实测三页 notify 计数 + 每操作链颗数、两条预算、判据「吐司说成了,页面说成什么样」);`pages/ModelCenter.tsx` 的 `patchRow` 补一颗结果吐司(启用/停用/设为默认此前零反馈),`save`/`remove` 的页头 `Notice` 改 `notify({title,desc})` 并删除 `notice` state(页内 `Notice` 只留 `error` 与故障注入两处持续状态);`pages/project/Library.tsx` 5 处裸 `confirm()` → `await confirmAction({title,desc,tone,confirmIcon})`,`onRecord` / `recordGenerationReference` 经新增的 `speak`/`joinLines` 合成一颗;`lib/versions.ts::keepOrRestoreCurrent` 新增第三形参 `sink`(默认 `notify`,平台资产库两个调用点未改);`scripts/ui/classaudit.mjs` 第 6 闸正则从只匹配 `window.confirm(` 放宽为 `/(?<![\w.$])(?:window\.)?(?:confirm|alert)\s*\(/` 并写入十一例自查(阶段 5 曾把可选前缀写在 lookbehind 之前,导致 `window.confirm(` 反向漏检);`pages/Dashboard.tsx` 统计卡 `steps={[{at:'lg',cols:2}]}` 只改 xs 一档 | Codex(阶段 5) |
|
||||
|
|
|
|||
19
docs/UI规范.md
19
docs/UI规范.md
|
|
@ -330,7 +330,7 @@ Tailwind v4 由同一张表生成 `md:`(≥)与 `max-md:`(<)两向变体
|
|||
| `insp-lg` | 1400 | `Storyboard.tsx` 检查器宽度第一档 | 归到 `2xl`(1600):1440 这个主创作宽度从实测 979px 退回 880px(−99,编辑区被砍掉一格);归到 `xl`(1200):1200–1399 从 880 涨到 900(覆盖式抽屉再多压 20px 看板) |
|
||||
| `board` | 1240 | `Storyboard.tsx` 看板 258→224 卡宽地板 | 归到 `xl`(1200):1204–1239(1200px 笔记本的可视宽度)从实测 4 列 224px 退回 3 列 315px;归到 `2xl`(1600):1280 从 3 列 328→4 列 243、1440 从 4 列 283→5 列 224,同一屏每张卡缩掉 59–85px |
|
||||
| `insp-md` | 1080 | `Storyboard.tsx` 检查器宽度第二档 | 归到 `lg`(992):1024 从实测 760 涨到 880,超过该档内容宽(1024 − 224 侧栏 − 48 padding = 752);归到 `xl`(1200):1080–1199 从 880 掉到 760,白让出 120px 编辑宽度 |
|
||||
| `insp-sm` | 720 | `Storyboard.tsx` 检查器整屏 + 素材列表单列 | 归到 `md`(768):721–767 的检查器由实测 697/716/736(`vw−24`)变 `100vw`,把左侧 64px 图标轨整个盖住;同时放得下两列(2×270 ≤ 697)的素材列表退成单列 |
|
||||
| `insp-sm` | 720 | `Storyboard.tsx` 检查器整屏 + 素材列表单列 | 归到 `md`(768):721–767 的检查器由实测 697/716/736(`vw−24`)变 `100vw`,24px 留白没了;同时放得下两列(2×270 ≤ 697)的素材列表退成单列。**阶段 8 · N7 复核**:这三个数与侧栏无关(宽度写死 `calc(100vw-24px)`),复测 721/740/760 仍是 697/716/736,档位不动;当年理由里的「盖住左侧 64px 图标轨」这一半已失效——<768 现在不渲染侧栏,没有图标轨可盖(§6 外壳表) |
|
||||
| `agent` | 620 | `AgentConsole.tsx` 指令折叠头整行折行 | 归到 `sm`(576):576–619 的指令原文退回 inline 挤放,实测只剩 150–193px 宽、折两行带省略号(行高 71→90),比整行折行更难读;归到 `md`(768):620–767 那段 inline 放得下(实测 166–233px)的也被拖进整行折行 |
|
||||
|
||||
**复核口径(阶段 8 · N16 起改为机器闸)**:这张表不再靠人核对——`styles/index.css` 的
|
||||
|
|
@ -465,8 +465,9 @@ antd 三档(24/32/40)套不进去的,才是自定义表面,允许裸元
|
|||
|
||||
| 文件 | 本体 | 要点 |
|
||||
|---|---|---|
|
||||
| `app/layout/AppHeader.tsx` | `Layout.Header` | 高度 = `theme/antd.ts` 导出的 **`HEADER_HEIGHT`(56)** 唯一出处(Sider 与内容区算 `calc(100vh - HEADER_HEIGHT)` 时引用同一个数);左:折叠开关 + 品牌簇(`Avatar` + `Typography.Text`);中:`PipelineConsole`(唯一的弹性出气口,见下一段;**它是全站唯一的项目身份入口,点击展开 §6.5 的概况抽屉**);右:系统状态 `Badge` + 手册 + 主题开关 + `UserMenu`(antd `Dropdown`)。**没有**接口文档入口、系统信息页脚、「最近刷新」,也**没有**页签条(§6.1) |
|
||||
| `app/layout/AppSider.tsx` | `Layout.Sider` + `Menu theme="light"` | `collapsible` + `breakpoint="md"` + `collapsedWidth={64}`,折叠/浮层/内嵌缩进全部交 antd;导航表在 `app/layout/nav.tsx`(含 `projectIdOf` / `pathOf`),**菜单只到两级**(§6.2),选中态 = `selectedKeys={[pathname]}`,**不在页面里手写** |
|
||||
| `app/layout/AppHeader.tsx` | `Layout.Header` | 高度 = `theme/antd.ts` 导出的 **`HEADER_HEIGHT`(56)** 唯一出处(Sider 与内容区算 `calc(100vh - HEADER_HEIGHT)` 时引用同一个数);左:导航开关(≥768 折叠侧栏 / <768 开合导航抽屉,见下一行)+ 品牌簇(`Avatar` + `Typography.Text`);中:`PipelineConsole`(唯一的弹性出气口,见下一段;**它是全站唯一的项目身份入口,点击展开 §6.5 的概况抽屉**);右:系统状态 `Badge` + 手册 + 主题开关 + `UserMenu`(antd `Dropdown`)。**没有**接口文档入口、系统信息页脚、「最近刷新」,也**没有**页签条(§6.1) |
|
||||
| `app/layout/AppSider.tsx` | `Layout.Sider` + `Menu theme="light"` | **只在 ≥768 渲染**(`app/App.tsx` 的 `narrow` 决定,见下一行):`collapsible` + `collapsedWidth={SIDER_COLLAPSED_WIDTH=64}` + `width={SIDER_WIDTH=224}`,折叠/浮层/内嵌缩进全部交 antd。以前还挂 `breakpoint="md"`(窄屏自动收成 64 图标轨),阶段 8 · N7 起撤掉——顶栏那颗汉堡与这条图标轨是同一件事的两个入口,窄屏留一个就够,而且图标轨白吃正文 64px。导航表在 `app/layout/nav.tsx`(含 `projectIdOf` / `pathOf`),**菜单只到两级**(§6.2),选中态 = `selectedKeys={[pathname]}`,**不在页面里手写** |
|
||||
| `app/layout/AppSider.tsx` 的 `AppNavMenu` / `AppNavDrawer` | kit `Drawer placement="left"` + `Menu` | **<768 的导航形态**(阶段 8 · N7 已采纳):菜单本体 `AppNavMenu` 被侧栏与抽屉**共用同一份**(导航表、两级结构、选中态、进入项目自动展开,两处不许各写一遍),抽屉只是它的容器。抽屉宽 = `SIDER_WIDTH`(224,与侧栏同一个数:换成 antd 默认的 378 等于凭空多出一个导航形态)、`flushBody` 让菜单贴边、`title="导航"`;开合在外壳(`app/App.tsx` 的 `navOpen`),**换页自动关**。键盘与浮层行为不自己实现:Esc 关、遮罩点关、焦点陷阱走 kit `Drawer`(§10 第一条:portal 到 body,挂载点不许页面自己改)——与右侧那三个抽屉同一套 |
|
||||
| `app/App.tsx` 的 `Layout.Content` | `Layout.Content` | 自上而下只有两样:系统异常提示条(kit `Notice`,条上挂「重试」)→ 页面。留白 `p-6 max-lg:p-4 max-md:p-3`,`maxWidth: 1680` 居中;页面自己不再写外壳级 padding |
|
||||
|
||||
**顶栏三块的挤压顺序是定死的**:品牌簇与工具簇都带 `min-w-max`(不许压扁——antd 的 icon-only
|
||||
|
|
@ -1809,7 +1810,17 @@ node scripts/ui/classaudit.mjs frontend/src/pages/Help.tsx
|
|||
|
||||
1. `:root` 上的 `--ant-*` 尺子非空(`applyRootVars` 真的铺下去了,`app.css` 全靠它);
|
||||
2. 文字行高没塌成 px(无单位倍数被误写 px 时肉眼很容易漏,见 §3 的事故登记)。**`.anticon` 不参与这条断言**:antd 的图标复位给所有图标写 `line-height:0`,图标的实高由 font-size 撑开(12px 字图标实高 12px),它量的是「文字行」不是字形;图标类名一旦叠了 `text-xs` 就会被按 class 选中的规则误伤(`ExtLink` 尾部那颗箭头就是这么报的);
|
||||
3. 侧栏选中态跟路由走(`selectedKeys` 没断)。窄屏 ≤768 侧栏是折叠的(`Sider breakpoint="md"`),
|
||||
3. 侧栏选中态跟路由走(`selectedKeys` 没断)。**导航在不在页面里,探针先问 `probe.sider`**:
|
||||
≥768 走常驻侧栏;<768(阶段 8 · N7)侧栏根本不渲染,选中态在汉堡后面那块左抽屉里,
|
||||
抽屉没开时菜单压根不在 DOM(antd Drawer 首次打开前不渲染)——所以这一档必须**真的点一下**:
|
||||
点 `button[aria-label="打开导航菜单"]` → 量 `.ant-drawer-content-wrapper` 的 `x`/`width`
|
||||
(量外层 `.ant-drawer` 拿到的是视口宽,430 档实测报 430,全线假失败)→ 断言左抽屉 + 宽 224
|
||||
+ `.ant-menu-item-selected` 的底色/前景色与桌面档同一套 → 按 `Esc` → 断言真的关了。
|
||||
另外这条断言的**覆盖名单**在阶段 8 才修对:原先写 `path in NAV_ROUTES`,名单里是
|
||||
`/projects/{id}/overview` 这种模板,主循环早就把 `{id}` 换成真实项目 id 了,两边永远对不上,
|
||||
**七条项目路由从阶段 0 起就没进过菜单断言**(只有 `/`、`/assets`、`/models` 三条在测)。
|
||||
现在是 `in_nav(path, pid)`,覆盖 3 → 10 条。
|
||||
窄屏 ≤768 若侧栏是折叠的(手工折叠,不是断点自动收),
|
||||
二级项不在 DOM 里而在 hover 浮层里,此时 antd 把选中态打在父级 `.ant-menu-submenu-selected` 上——
|
||||
这不算断。但只验到父级还不够(`selectedKeys` 传错时父级照样会亮),所以折叠态会**把浮层 hover 开**,
|
||||
确认 `.ant-menu-submenu-popup` 里对应这条路由的二级项真的带 `.ant-menu-item-selected`
|
||||
|
|
|
|||
|
|
@ -18,7 +18,7 @@
|
|||
*/
|
||||
import { Suspense, useEffect, useRef, useState, type ReactNode } from 'react'
|
||||
import { Navigate, Outlet, useLocation, useMatches } from 'react-router-dom'
|
||||
import { Button, Layout } from 'antd'
|
||||
import { Button, Grid, Layout } from 'antd'
|
||||
import { Notice, PageStack, SkeletonBlock } from '../components/ui'
|
||||
import { IconReload } from '../components/icons'
|
||||
import { startActivityFeed, stopActivityFeed } from '../stores/activity'
|
||||
|
|
@ -28,7 +28,7 @@ import { toggleTheme } from '../stores/theme'
|
|||
import { useLocalStorage } from '../hooks/use-local-storage'
|
||||
import MediaLightbox from '../components/media/MediaLightbox'
|
||||
import AppHeader from './layout/AppHeader'
|
||||
import AppSider from './layout/AppSider'
|
||||
import AppSider, { AppNavDrawer } from './layout/AppSider'
|
||||
import ProjectBriefDrawer from './layout/ProjectBriefDrawer'
|
||||
import Forbidden from '../pages/Forbidden'
|
||||
import ErrorBoundary from './ErrorBoundary'
|
||||
|
|
@ -93,8 +93,15 @@ export default function App() {
|
|||
const systemError = useSystemStore((s) => s.error)
|
||||
const pollRef = useRef<number | undefined>(undefined)
|
||||
const [ready, setReady] = useState(() => authState().checked)
|
||||
/* 侧栏折叠:记忆到人,换页不换档;窄屏由 Sider 的 breakpoint 自己收 */
|
||||
/* 侧栏折叠:记忆到人,换页不换档。
|
||||
≥768 交给 Sider 的手工折叠;<768 这一档不存在侧栏了(阶段 8 · N7),见下面 narrow。 */
|
||||
const [collapsed, setCollapsed] = useLocalStorage('nex.sider.collapsed', false)
|
||||
/* 窄屏导航抽屉的开合:只在 <768 有意义,换页自动关(点了菜单项也算换页) */
|
||||
const [navOpen, setNavOpen] = useState(false)
|
||||
/* 断点只认 antd Grid 的 md(768)——与 styles/index.css 的 --breakpoint-md 同一张表。
|
||||
`screens.md === undefined` 是首帧还没测过视口,**必须当桌面**:
|
||||
写成 `!screens.md` 的话 1440 也会先闪一帧「没有侧栏、只有汉堡」的外壳。 */
|
||||
const narrow = Grid.useBreakpoint().md === false
|
||||
/* 「项目概况」抽屉:顶栏流程控制台是唯一入口,开合状态记在外壳,
|
||||
这样控制台那颗胶囊才能同时显示 aria-expanded 与箭头的方向 */
|
||||
const [briefOpen, setBriefOpen] = useState(false)
|
||||
|
|
@ -105,6 +112,9 @@ export default function App() {
|
|||
void refreshState().then(() => setReady(true))
|
||||
}, [])
|
||||
|
||||
/* 换页就关抽屉:点菜单项、点概况里的跳转、浏览器前进后退,全都收 */
|
||||
useEffect(() => { setNavOpen(false) }, [location.pathname])
|
||||
|
||||
/* 文档标题:旧版在 afterEach 里做,这里等价地在 handle 变化时做 */
|
||||
useEffect(() => {
|
||||
if (handle.title) document.title = `${handle.title} · Nex Animation Studio`
|
||||
|
|
@ -168,9 +178,13 @@ export default function App() {
|
|||
return (
|
||||
<Layout style={{ minHeight: '100vh' }}>
|
||||
<AppHeader projectId={projectId} collapsed={collapsed} onCollapse={setCollapsed}
|
||||
onOpenBrief={() => setBriefOpen((v) => !v)} briefOpen={briefOpen} />
|
||||
onOpenBrief={() => setBriefOpen((v) => !v)} briefOpen={briefOpen}
|
||||
narrow={narrow} navOpen={navOpen} onToggleNav={() => setNavOpen((v) => !v)} />
|
||||
<Layout>
|
||||
<AppSider projectId={projectId} collapsed={collapsed} onCollapse={setCollapsed} />
|
||||
{/* <768 不渲染常驻侧栏:窄屏的导航入口只有顶栏那颗汉堡(点开左边的抽屉)。
|
||||
以前是 Sider 的 breakpoint 自动收成 64px 图标轨 + 汉堡仍在——同一屏两个导航入口,
|
||||
图标轨还白吃正文 64px(430 实测正文盒子 430→366,扣掉 12×2 内距可用 342)。NEX 04 §8.2:只留一个入口。 */}
|
||||
{!narrow && <AppSider projectId={projectId} collapsed={collapsed} onCollapse={setCollapsed} />}
|
||||
<Layout.Content className="min-w-0 p-6 max-lg:p-4 max-md:p-3"
|
||||
style={{ maxWidth: 1680, width: '100%', marginInline: 'auto' }}>
|
||||
{/* 系统级异常:kit Notice(R19 反馈表面唯一实现)。
|
||||
|
|
@ -196,6 +210,8 @@ export default function App() {
|
|||
<MediaLightbox />
|
||||
{/* 项目层(身份 / 指标 / 流程 / 七站跳转 / 归档 / 删除)只在这里说一遍 */}
|
||||
<ProjectBriefDrawer open={briefOpen} onClose={() => setBriefOpen(false)} projectId={projectId} />
|
||||
{/* 只在窄屏挂:≥768 有常驻侧栏,抽屉里那份菜单就是重复的第二套导航 */}
|
||||
{narrow && <AppNavDrawer open={navOpen} onClose={() => setNavOpen(false)} projectId={projectId} />}
|
||||
</Layout>
|
||||
)
|
||||
}
|
||||
|
|
|
|||
|
|
@ -24,22 +24,43 @@ import ActivityCenter from './ActivityCenter'
|
|||
import PipelineConsole from './PipelineConsole'
|
||||
import UserMenu from './UserMenu'
|
||||
|
||||
export function AppHeader({ projectId, collapsed, onCollapse, onOpenBrief, briefOpen }: {
|
||||
export function AppHeader({ projectId, collapsed, onCollapse, onOpenBrief, briefOpen,
|
||||
narrow, navOpen, onToggleNav }: {
|
||||
projectId: string
|
||||
collapsed: boolean
|
||||
onCollapse: (next: boolean) => void
|
||||
/** 展开/收起右侧「项目概况」抽屉(项目层唯一入口,实现在 app/App.tsx) */
|
||||
onOpenBrief: () => void
|
||||
briefOpen: boolean
|
||||
/**
|
||||
* <768:这一档外壳里没有常驻侧栏,这颗汉堡是导航的**唯一**入口,
|
||||
* 它点的不再是「折叠/展开」而是左边的导航抽屉(阶段 8 · 用户批准 N7)。
|
||||
* 断点由 app/App.tsx 统一测一次传进来——侧栏在不在、汉堡点哪儿,
|
||||
* 两处必须问同一个答案,不能 Header 用 Grid、App 用 matchMedia 各测各的。
|
||||
*/
|
||||
narrow: boolean
|
||||
/** 窄屏抽屉的开合状态:只有 narrow 时有意义,用来给 aria-expanded */
|
||||
navOpen: boolean
|
||||
onToggleNav: () => void
|
||||
}) {
|
||||
const screens = Grid.useBreakpoint()
|
||||
const isLight = useAppliedTheme() === 'light'
|
||||
const health = useSystemStore((s) => s.health)
|
||||
const error = useSystemStore((s) => s.error)
|
||||
const offline = !!error
|
||||
/* 侧栏收起时折叠按钮是唯一的展开入口,此时不许再隐任何东西 */
|
||||
const wide = collapsed || !!screens.lg
|
||||
/* 侧栏收起时折叠按钮是唯一的展开入口,此时不许再隐任何东西。
|
||||
narrow 也算「要留东西」:<768 没有侧栏了,汉堡换成抽屉入口,同样不能隐。 */
|
||||
const wide = narrow || collapsed || !!screens.lg
|
||||
const md = !!screens.md
|
||||
/* 汉堡这一颗在两种形态下说的是两句话,不能共用一条文案:
|
||||
≥768 改的是常驻侧栏的宽度(展开/收起),<768 开关的是一层浮起来的面板(打开/关闭)。
|
||||
读屏软件会念出 aria-label,写错一个动词,用户就不知道自己刚按下了什么。
|
||||
aria-expanded 只在抽屉形态下有含义——折叠侧栏是布局尺寸,不是被这个按钮展开的面板,
|
||||
给它加 expanded 反而会让读屏以为侧栏是个折叠区。 */
|
||||
const navShown = narrow ? navOpen : !collapsed
|
||||
const navLabel = narrow
|
||||
? (navShown ? '关闭导航菜单' : '打开导航菜单')
|
||||
: (navShown ? '收起导航菜单' : '展开导航菜单')
|
||||
|
||||
return (
|
||||
<Layout.Header style={{
|
||||
|
|
@ -49,10 +70,17 @@ export function AppHeader({ projectId, collapsed, onCollapse, onOpenBrief, brief
|
|||
paddingInline: md ? 'var(--ant-padding-lg)' : 'var(--ant-padding)'
|
||||
}}>
|
||||
<Button type="text" shape={wide ? 'default' : 'circle'}
|
||||
icon={collapsed ? <IconSiderExpand /> : <IconSiderCollapse />}
|
||||
onClick={() => onCollapse(!collapsed)}
|
||||
aria-label={collapsed ? '展开导航菜单' : '收起导航菜单'}
|
||||
title={collapsed ? '展开导航菜单' : '收起导航菜单'} />
|
||||
/* 图标按「导航现在露没露出来」选,而不是按 collapsed 选:窄屏没有 collapsed 这件事
|
||||
(侧栏根本不渲染),抽屉开着的时候还画一颗「展开」箭头就是自相矛盾。
|
||||
≥768 时 navShown === !collapsed,与改造前逐字同值;<768 抽屉关着时
|
||||
navShown === false → IconSiderExpand,也正是改造前 Sider 自动收起后画的那一颗,
|
||||
所以 576 / 430 两档的顶栏像素没动(实测 diff 强差 35px → 归零)。
|
||||
复用同一对 antd 图标,不新增。 */
|
||||
icon={navShown ? <IconSiderCollapse /> : <IconSiderExpand />}
|
||||
onClick={() => (narrow ? onToggleNav() : onCollapse(!collapsed))}
|
||||
aria-label={navLabel}
|
||||
title={navLabel}
|
||||
aria-expanded={narrow ? navOpen : undefined} />
|
||||
|
||||
<Flex align="center" gap="small" className={cn('min-w-max flex-[1_1_0]', !wide && 'flex-none')}>
|
||||
{/* 品牌块整块是「返回项目总览」的入口(阶段 2 收的键盘热区)。
|
||||
|
|
|
|||
|
|
@ -22,21 +22,43 @@
|
|||
*
|
||||
* 侧栏 theme="light":深色观感由 darkAlgorithm 的 token 负责,走 antd Menu 的
|
||||
* dark 分支会把它自己的 navy 默认值混进来(itemColor / subMenuItemBg 各一套)。
|
||||
*
|
||||
* **<768 这一族换形态**(阶段 8 · 用户批准 N7 / D17):这里除了 <AppSider> 还导出
|
||||
* <AppNavMenu>(菜单本体)和 <AppNavDrawer>(左抽屉),三者共用同一张导航表与同一份
|
||||
* 选中/展开逻辑。窄屏不再渲染 <AppSider>:Sider 的 `breakpoint="md"` 会自动收成
|
||||
* 64px 图标轨,可顶栏那颗汉堡按钮同时还在——**同一屏两个导航入口**,语义重叠,
|
||||
* 还白吃掉正文 64px(430 档正文只剩 302)。抽屉化之后窄屏只留汉堡一个入口,
|
||||
* 正文拿回那 64px(NEX 04 §8.2「窄屏降级范式」第一条就是这条)。
|
||||
* 抽屉不是新造的表面:走 kit 的 <Drawer placement="left">,Esc / 遮罩 / 焦点陷阱
|
||||
* 与右侧那三个抽屉同一套行为,差别只有方向、宽度和「正文贴边」(flushBody)。
|
||||
*/
|
||||
import { useEffect, useMemo, useState } from 'react'
|
||||
import { useLocation, useNavigate } from 'react-router-dom'
|
||||
import { Layout, Menu } from 'antd'
|
||||
import type { MenuProps } from 'antd'
|
||||
import { IconFolder } from '../../components/icons'
|
||||
import { Drawer } from '../../components/ui'
|
||||
import { HEADER_HEIGHT } from '../../theme/antd'
|
||||
import { globalNav, pathOf, projectModules } from './nav'
|
||||
|
||||
const PROJECT_KEY = 'project'
|
||||
|
||||
export function AppSider({ projectId, collapsed, onCollapse }: {
|
||||
/** 展开态侧栏宽度:桌面与窄屏抽屉共用同一个数(抽屉里那 224 就是侧栏那 224) */
|
||||
export const SIDER_WIDTH = 224
|
||||
/** 收起态图标轨宽度:只服务 ≥768 的手工折叠(窄屏走抽屉,不再有图标轨) */
|
||||
export const SIDER_COLLAPSED_WIDTH = 64
|
||||
|
||||
/**
|
||||
* 菜单本体:桌面侧栏与窄屏抽屉共用。抽出来的唯一理由是「两份菜单不能各写一遍」——
|
||||
* 导航表、两级结构、选中态、进入项目自动展开,这两处必须永远一样。
|
||||
* `collapsed` 只有侧栏会传 true;抽屉里恒为 false(抽屉宽 224,装得下完整标签,
|
||||
* 收成图标轨反而是把一个已经够窄的抽屉再切掉一块)。
|
||||
*/
|
||||
export function AppNavMenu({ projectId, collapsed = false, onNavigate }: {
|
||||
projectId: string
|
||||
collapsed: boolean
|
||||
onCollapse: (next: boolean) => void
|
||||
collapsed?: boolean
|
||||
/** 选完之后要做的事:抽屉用它关自己,侧栏不传(点了直接换页,没有要关的东西) */
|
||||
onNavigate?: () => void
|
||||
}) {
|
||||
const { pathname } = useLocation()
|
||||
const navigate = useNavigate()
|
||||
|
|
@ -72,21 +94,7 @@ export function AppSider({ projectId, collapsed, onCollapse }: {
|
|||
}, [projectId])
|
||||
|
||||
return (
|
||||
<Layout.Sider
|
||||
collapsible
|
||||
collapsed={collapsed}
|
||||
onCollapse={onCollapse}
|
||||
/* 侧栏折叠交给 antd:breakpoint 用的是 Grid 的 md(768),与全站断点同一张表 */
|
||||
breakpoint="md"
|
||||
collapsedWidth={64}
|
||||
width={224}
|
||||
theme="light"
|
||||
trigger={null}
|
||||
style={{
|
||||
position: 'sticky', top: HEADER_HEIGHT, height: `calc(100vh - ${HEADER_HEIGHT}px)`,
|
||||
overflow: 'auto', borderInlineEnd: '1px solid var(--ant-color-split)'
|
||||
}}>
|
||||
<Menu
|
||||
<Menu
|
||||
mode="inline"
|
||||
theme="light"
|
||||
items={items}
|
||||
|
|
@ -94,11 +102,59 @@ export function AppSider({ projectId, collapsed, onCollapse }: {
|
|||
openKeys={collapsed ? undefined : openKeys}
|
||||
onOpenChange={(keys) => setOpenKeys(keys as string[])}
|
||||
selectedKeys={[pathname]}
|
||||
onClick={({ key }) => navigate(key)}
|
||||
onClick={({ key }) => { navigate(key); onNavigate?.() }}
|
||||
style={{ borderInlineEnd: 0, paddingBlock: 8 }}
|
||||
/>
|
||||
)
|
||||
}
|
||||
|
||||
/** 桌面 / 平板(≥768):常驻侧栏,可手工折叠成 64 图标轨 */
|
||||
export function AppSider({ projectId, collapsed, onCollapse }: {
|
||||
projectId: string
|
||||
collapsed: boolean
|
||||
onCollapse: (next: boolean) => void
|
||||
}) {
|
||||
return (
|
||||
<Layout.Sider
|
||||
collapsible
|
||||
collapsed={collapsed}
|
||||
onCollapse={onCollapse}
|
||||
collapsedWidth={SIDER_COLLAPSED_WIDTH}
|
||||
width={SIDER_WIDTH}
|
||||
theme="light"
|
||||
trigger={null}
|
||||
style={{
|
||||
position: 'sticky', top: HEADER_HEIGHT, height: `calc(100vh - ${HEADER_HEIGHT}px)`,
|
||||
overflow: 'auto', borderInlineEnd: '1px solid var(--ant-color-split)'
|
||||
}}>
|
||||
<AppNavMenu projectId={projectId} collapsed={collapsed} />
|
||||
</Layout.Sider>
|
||||
)
|
||||
}
|
||||
|
||||
/**
|
||||
* 窄屏(<768)导航抽屉。
|
||||
*
|
||||
* 为什么宽度沿用侧栏那 224 而不是 antd 抽屉默认的 378:抽屉里的内容就是那份菜单,
|
||||
* 宽度换了,标签折行、图标缩进、选中底色宽度全都跟着换,等于凭空多出一个导航形态。
|
||||
* 224 + 正文贴边(flushBody)实测装得下最长那两条(「任务调度中心」「模型管理中心」:6 字 + 图标,前者还带子菜单缩进),
|
||||
* `drawercheck` 的 menu-fit 判据逐条量过 scrollWidth ≤ clientWidth。
|
||||
*
|
||||
* 标题写「导航」不写平台名:平台名在顶栏品牌块上(窄屏只有头像,点开抽屉才看到全名),
|
||||
* 抽屉正文第一行就是全局三项,读者不需要第三遍自我介绍。
|
||||
*/
|
||||
export function AppNavDrawer({ open, onClose, projectId }: {
|
||||
open: boolean
|
||||
onClose: () => void
|
||||
projectId: string
|
||||
}) {
|
||||
return (
|
||||
<Drawer placement="left" open={open} onClose={onClose} flushBody
|
||||
width={SIDER_WIDTH} title="导航" label="站点导航"
|
||||
sub="平台与当前项目的全部环节">
|
||||
<AppNavMenu projectId={projectId} onNavigate={onClose} />
|
||||
</Drawer>
|
||||
)
|
||||
}
|
||||
|
||||
export default AppSider
|
||||
|
|
|
|||
|
|
@ -150,8 +150,17 @@ export function PipelineConsole({ projectId, onOpenBrief, briefOpen }: {
|
|||
第十三轮补第二刀:「让位」被执行成了**塌成残字**——实测 1440 状态 Tag 只剩 7px,
|
||||
「审核中」只剩一笔。省略号可以,残字不行(docs/UI规范.md §15.2 第 7 条),
|
||||
所以状态 Tag 同样 flex-none:差额由那句散文吸干,标签要么整条要么按自身宽度折省略号。 */}
|
||||
{/* 第十四轮(阶段 8 · D17):flex-none 在 <768 会把整排内容顶出胶囊。
|
||||
430 实测:胶囊盒子 x=100 w=172,内容 205(sw-cw=33)——Button 的内容是**居中**
|
||||
排的,装不下就两端一起往外溢:项目名从 x=68 开始(比胶囊左沿还偏左 32px),
|
||||
尾部箭头画到 x=305(胶囊右沿 272)。名字整条读得完,可它已经不在自己那颗胶囊里了。
|
||||
flex-none 是第十三轮为了「名字不许被散文吃掉」给的,那条在 ≥768 依然成立;
|
||||
手机档没有散文(cur <lg 隐、rail <xl 隐、status <md 隐),没什么可吃的,
|
||||
只有「名字 vs 百分比 + 箭头」这一道减法,所以只在这一档恢复收缩权:
|
||||
min-w-0 让 flex-shrink 真的能生效(flex item 默认 min-width:auto 顶在内容宽度上),
|
||||
折出来的是省略号 + tooltip(同一行 ellipsis 已给),不是残字。 */}
|
||||
<Typography.Text strong ellipsis={{ tooltip: projectTitle }}
|
||||
className="max-w-[200px] flex-none text-text">
|
||||
className="max-w-[200px] flex-none max-md:min-w-0 max-md:flex-[0_1_auto] text-text">
|
||||
{projectTitle}
|
||||
</Typography.Text>
|
||||
{/* 外面这层 span 是**必需的**,而且 D16 修好之后依然撤不掉,原因换了一个:
|
||||
|
|
|
|||
|
|
@ -72,7 +72,8 @@ function useNames() {
|
|||
/** 默认宽:表单抽屉吃满视野,只放一块面板的抽屉由页面传更窄的 CSS 宽度 */
|
||||
const DRAWER_WIDE = 'min(1360px, calc(100vw - 20px))'
|
||||
|
||||
export function Drawer({ open, onClose, title, sub, children, actions, width, closeOnBackdrop = true, label, loading }: {
|
||||
export function Drawer({ open, onClose, title, sub, children, actions, width, closeOnBackdrop = true, label, loading,
|
||||
placement = 'right', flushBody }: {
|
||||
open: boolean
|
||||
onClose: () => void
|
||||
title: ReactNode
|
||||
|
|
@ -92,6 +93,20 @@ export function Drawer({ open, onClose, title, sub, children, actions, width, cl
|
|||
* Modal 不加这个参数:站内没有「先开弹窗再拉内容」的用法。
|
||||
*/
|
||||
loading?: boolean
|
||||
/**
|
||||
* 抽屉从哪一侧推出。默认 `right`:站内的抽屉都是「主内容不动、旁边来一块辅助面板」
|
||||
* (项目概况 / 资产编辑 / 素材详情),左边留给导航。
|
||||
* `left` 目前只有一个用户:<AppNavDrawer/>(<768 的导航抽屉,阶段 8 · N7),
|
||||
* 它必须跟桌面侧栏同一个方向,否则「导航在右边」这件事没人猜得到。
|
||||
*/
|
||||
placement?: 'left' | 'right'
|
||||
/**
|
||||
* 正文内边距归零:给「整块表面自己就是内容」的抽屉(导航菜单、贴边滚动的列表)。
|
||||
* 只能做成 prop,不能由页面写 `p-0`:antd 的 `.ant-drawer-body { padding }` 是
|
||||
* CSS-in-JS 的**未层**声明,Tailwind 的 utility 在 `@layer utilities` 里,
|
||||
* 层外的永远压层内(同 §1.1.1 那条 `.nex-tag` 实测),页面写了是空转。
|
||||
*/
|
||||
flushBody?: boolean
|
||||
}) {
|
||||
const { titleId, subId } = useNames()
|
||||
return (
|
||||
|
|
@ -99,8 +114,11 @@ export function Drawer({ open, onClose, title, sub, children, actions, width, cl
|
|||
className="nex-drawer"
|
||||
open={open}
|
||||
onClose={onClose}
|
||||
placement="right"
|
||||
width={width || DRAWER_WIDE}
|
||||
placement={placement}
|
||||
/* 左抽屉(导航)默认收成侧栏那一档宽,右抽屉(辅助面板)默认吃满视野。
|
||||
两个默认值差这么远是应该有人的:抽屉的宽度取决于它是「替换主内容的位置」
|
||||
还是「压在主内容上的一块面板」,页面不传时就按这个语义给。 */
|
||||
width={width || (placement === 'left' ? 'min(288px, calc(100vw - 48px))' : DRAWER_WIDE)}
|
||||
closable={false}
|
||||
maskClosable={closeOnBackdrop}
|
||||
push={false}
|
||||
|
|
@ -130,7 +148,10 @@ export function Drawer({ open, onClose, title, sub, children, actions, width, cl
|
|||
}
|
||||
extra={<CloseButton onClose={onClose} label={typeof label === 'string' ? label : '关闭'} />}
|
||||
footer={actions ? <ActionGroup className={DRAWER_ACTIONS}>{actions}</ActionGroup> : null}
|
||||
styles={{ footer: { background: 'var(--ant-color-bg-elevated)', borderColor: 'var(--ant-color-split)', padding: '12px 20px' } }}
|
||||
styles={{
|
||||
body: flushBody ? { padding: 0 } : undefined,
|
||||
footer: { background: 'var(--ant-color-bg-elevated)', borderColor: 'var(--ant-color-split)', padding: '12px 20px' }
|
||||
}}
|
||||
>
|
||||
<div className={DRAWER_BODY}>
|
||||
{loading
|
||||
|
|
|
|||
|
|
@ -52,10 +52,11 @@ frontend:
|
|||
shell:
|
||||
default: NexAppShell
|
||||
header_height: 56 # theme/antd.ts:113 HEADER_HEIGHT
|
||||
sidebar_width: 224 # app/layout/AppSider.tsx:82
|
||||
sidebar_collapsed_width: 64 # app/layout/AppSider.tsx:81
|
||||
content_padding: 24 # app/App.tsx:157(窄屏 16 / 12:max-lg:p-4 max-md:p-3)
|
||||
content_max_width: 1680 # app/App.tsx:158
|
||||
sidebar_width: 224 # app/layout/AppSider.tsx:47 SIDER_WIDTH(窄屏抽屉同宽)
|
||||
sidebar_collapsed_width: 64 # app/layout/AppSider.tsx:49 SIDER_COLLAPSED_WIDTH(仅 ≥768 手工折叠)
|
||||
sidebar_narrow: drawer # <768 不渲染 Sider:app/App.tsx:187 + AppSider.tsx:145 AppNavDrawer
|
||||
content_padding: 24 # app/App.tsx:188(窄屏 16 / 12:max-lg:p-4 max-md:p-3)
|
||||
content_max_width: 1680 # app/App.tsx:189
|
||||
note: 以上尺寸均已验证;要改先登记例外(docs/NEX-对照与例外.md §3)
|
||||
|
||||
# 控件与圆角一律沿用 antd 默认档位;NEX 03 §7/§5 的 34/40 与六档圆角不适用
|
||||
|
|
|
|||
|
|
@ -46,6 +46,17 @@ ROUTES = [r for r in os.environ.get(
|
|||
# 404 也不算:地址压根不在菜单里,侧栏没有选中项才是对的。
|
||||
NAV_ROUTES = [r for r in ROUTES
|
||||
if not any(x in r for x in ("/account", "/users", "/help", "/login", NOT_FOUND_ROUTE))]
|
||||
def in_nav(path: str, pid: str) -> bool:
|
||||
"""这条已解析的路径在不在侧栏导航里(= 必须有选中项)。
|
||||
|
||||
原来写的是 `path in NAV_ROUTES`,而名单里存的是 `/projects/{id}/overview` 这种**模板**:
|
||||
主循环早就把 {id} 换成真实项目 id 了,两边永远对不上,七条项目路由从阶段 0 起
|
||||
就没进过菜单断言(只有 / 、/assets、/models 三条在测)。
|
||||
阶段 8·N7 之后窄屏的导航整个搬进抽屉,量不到项目路由就等于没验——先把口径修对。
|
||||
"""
|
||||
return any(path == (r.replace("{id}", str(pid)) if "{id}" in r else r) for r in NAV_ROUTES)
|
||||
|
||||
|
||||
USER = os.environ.get("NEX_USER", "admin")
|
||||
FORCED_PID = os.environ.get("NEX_PROJECT_ID", "")
|
||||
PWD = os.environ.get("NEX_PASS", "admin1234")
|
||||
|
|
@ -81,6 +92,10 @@ IGNORE = ("findDOMNode is deprecated", "Support for React will be removed")
|
|||
# light 菜单的 #15325b 底 + #1668dc 字只有 2.2:1,选中项比未选中还淡。
|
||||
# 3) 全站不许再出现旧品牌那一族(antd lime-1..10:#a0d911 / #5b8c00 是它的 6/8 档)。
|
||||
ANTD_PRIMARY = {"light": "#1677ff", "dark": "#1668dc"}
|
||||
# 导航抽屉的宽度:必须与常驻侧栏同一个数(AppSider.tsx 的 SIDER_WIDTH)。
|
||||
# 抽屉里那份菜单和侧栏里那份是同一个组件,宽度换了就等于凭空多出一个导航形态。
|
||||
NAV_DRAWER_WIDTH = 224
|
||||
|
||||
MENU_SELECTED = {
|
||||
"light": ("rgb(230, 244, 255)", "rgb(22, 119, 255)"),
|
||||
"dark": ("rgb(22, 104, 220)", "rgb(255, 255, 255)"),
|
||||
|
|
@ -154,6 +169,9 @@ PROBE = """() => {
|
|||
header: bar ? {h: Math.round(bar.getBoundingClientRect().height),
|
||||
bg: getComputedStyle(bar).backgroundColor} : null,
|
||||
theme: document.documentElement.dataset.theme,
|
||||
// 常驻侧栏在不在。阶段 8·N7 之后 <768 这一档**不渲染** Sider(导航改左抽屉),
|
||||
// 菜单断言必须先问这一句,否则 576/430 两档会全线假失败「菜单没有选中项」。
|
||||
sider: !!document.querySelector('.ant-layout-sider'),
|
||||
collapsed: !!document.querySelector('.ant-layout-sider-collapsed'),
|
||||
subSelected: !!document.querySelector('.ant-menu-submenu-selected'),
|
||||
// 行高是无单位倍数:一旦 --ant-line-height-* 被写成 px,每一行文字都会塌成 1px 高
|
||||
|
|
@ -415,7 +433,56 @@ def audit(page, route: str, width: int, theme: str, problems: list[str], *,
|
|||
problems.append(f"{width}/{theme}{route}: 残留旧品牌lime族 {hexv} ×{rec['n']} e.g. {rec['e']}")
|
||||
for bad in probe["text"]:
|
||||
problems.append(f"{width}/{theme}{route}: 行高塌了 {bad}")
|
||||
if menu_required:
|
||||
if menu_required and not probe.get("sider"):
|
||||
# <768(阶段 8·N7):导航不在页面里,在顶栏汉堡后面的左抽屉里。
|
||||
# 抽屉没开时它那份菜单可能压根不在 DOM(antd Drawer 首次打开前不渲染),
|
||||
# 所以这里不能读探针,必须真的点一下:点开 → 量选中态 → Esc 关掉。
|
||||
# 量的是和桌面档同一个数(同一份 token 的选中底色/前景色),
|
||||
# 这条断言顺带看住了两件不该变的事:抽屉确实是左抽屉宽 224、Esc 确实能关。
|
||||
btn = page.locator('button[aria-label="打开导航菜单"]')
|
||||
if not btn.count():
|
||||
problems.append(f"{width}/{theme}{route}: 窄屏没有常驻侧栏,也没有「打开导航菜单」按钮(导航没有入口)")
|
||||
else:
|
||||
try:
|
||||
btn.first.click()
|
||||
page.wait_for_selector(".ant-drawer-open", timeout=5000)
|
||||
page.wait_for_timeout(450)
|
||||
got = page.evaluate(r"""() => {
|
||||
const d = document.querySelector('.ant-drawer-open');
|
||||
if (!d) return null;
|
||||
/* 量的必须是 .ant-drawer-content-wrapper:外层 .ant-drawer 是
|
||||
position:fixed; inset:0 的那层遮罩容器,宽度恒等于视口,
|
||||
拿它比 224 会全线误报(实测 430 档它报 430)。 */
|
||||
const panel = d.querySelector('.ant-drawer-content-wrapper') || d;
|
||||
const b = panel.getBoundingClientRect();
|
||||
const it = d.querySelector('.ant-menu-item-selected');
|
||||
const cs = it ? getComputedStyle(it) : null;
|
||||
return {x: Math.round(b.x), w: Math.round(b.width),
|
||||
placement: d.className.includes('ant-drawer-left') ? 'left' : 'other',
|
||||
items: d.querySelectorAll('.ant-menu-item').length,
|
||||
menu: it ? {bg: cs.backgroundColor, color: cs.color,
|
||||
text: it.textContent.trim().slice(0, 12)} : null};
|
||||
}""")
|
||||
if not got:
|
||||
problems.append(f"{width}/{theme}{route}: 点了「打开导航菜单」抽屉没开")
|
||||
else:
|
||||
want_bg, want_fg = MENU_SELECTED[theme]
|
||||
if got["placement"] != "left" or got["x"] != 0:
|
||||
problems.append(f"{width}/{theme}{route}: 导航抽屉不在左边 x={got['x']}")
|
||||
if got["w"] != NAV_DRAWER_WIDTH:
|
||||
problems.append(f"{width}/{theme}{route}: 导航抽屉宽 {got['w']},应为侧栏同宽 {NAV_DRAWER_WIDTH}")
|
||||
if not got["menu"]:
|
||||
problems.append(f"{width}/{theme}{route}: 导航抽屉里没有选中项")
|
||||
elif got["menu"]["bg"] != want_bg or got["menu"]["color"] != want_fg:
|
||||
problems.append(f"{width}/{theme}{route}: 导航抽屉选中态 {got['menu']['bg']}"
|
||||
f"/{got['menu']['color']},应为 {want_bg}/{want_fg}")
|
||||
page.keyboard.press("Escape")
|
||||
page.wait_for_timeout(500)
|
||||
if page.locator(".ant-drawer-open").count():
|
||||
problems.append(f"{width}/{theme}{route}: Esc 没有关掉导航抽屉(会挡住截图与后续操作)")
|
||||
except Exception as exc: # 点开/关掉任一环节抛错都不能把整轮 120 次跑挂
|
||||
problems.append(f"{width}/{theme}{route}: 导航抽屉检查异常 {exc}")
|
||||
elif menu_required:
|
||||
if not probe["menu"]:
|
||||
problems.append(f"{width}/{theme}{route}: 菜单没有选中项")
|
||||
elif probe["menu"].get("kind") != "item":
|
||||
|
|
@ -525,7 +592,7 @@ def main() -> int:
|
|||
if r == NOT_FOUND_ROUTE and not page.get_by_text("页面不存在").count():
|
||||
# 兜底页必须真的说话:只剩空壳或换回跳首页,都算这条兜底没了
|
||||
problems.append(f"{width}/{theme}{r}: 404 页没有给出「页面不存在」说明")
|
||||
audit(page, r, width, theme, problems, menu_required=r in NAV_ROUTES)
|
||||
audit(page, r, width, theme, problems, menu_required=in_nav(r, pid))
|
||||
browser.close()
|
||||
|
||||
print("\n=== :root 尺子 ===")
|
||||
|
|
|
|||
Loading…
Reference in New Issue