From ae4dd7f68e9f9b82a838aafc3b0d603b2186edf3 Mon Sep 17 00:00:00 2001 From: "mula.liu" Date: Sat, 7 Nov 2026 23:36:48 +0800 Subject: [PATCH] =?UTF-8?q?NEX=20=E9=98=B6=E6=AE=B5=208=C2=B7D17/N7?= =?UTF-8?q?=EF=BC=9A<768=20=E5=AF=BC=E8=88=AA=E6=94=B9=E5=B7=A6=E6=8A=BD?= =?UTF-8?q?=E5=B1=89=EF=BC=8C=E5=90=8C=E4=B8=80=E5=B1=8F=E5=8F=AA=E5=89=A9?= =?UTF-8?q?=E4=B8=80=E4=B8=AA=E5=AF=BC=E8=88=AA=E5=85=A5=E5=8F=A3=EF=BC=8C?= =?UTF-8?q?=E9=A1=B6=E6=A0=8F=E8=83=B6=E5=9B=8A=E6=BA=A2=E5=87=BA=E5=BD=92?= =?UTF-8?q?=E9=9B=B6?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 用户批准「移动端导航采用抽屉式 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 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 并校正四条尺寸的实现行号。 --- docs/NEX-对照与例外.md | 9 +- docs/UI规范.md | 19 ++++- frontend/src/app/App.tsx | 26 ++++-- frontend/src/app/layout/AppHeader.tsx | 42 +++++++-- frontend/src/app/layout/AppSider.tsx | 94 ++++++++++++++++----- frontend/src/app/layout/PipelineConsole.tsx | 11 ++- frontend/src/components/ui/Overlay.tsx | 29 ++++++- nex.config.yaml | 9 +- scripts/ui/visualcheck.py | 71 +++++++++++++++- 9 files changed, 260 insertions(+), 50 deletions(-) diff --git a/docs/NEX-对照与例外.md b/docs/NEX-对照与例外.md index d27d2b6..6092d0a 100644 --- a/docs/NEX-对照与例外.md +++ b/docs/NEX-对照与例外.md @@ -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`(`
`)、`ui/Rows.tsx:11`(`
`)、`AppHeader.tsx:60,70`(`Avatar`/`Text` 当链接)——**行号为阶段 0 记录值**;阶段 2 之后三处已分别变为 `Storyboard.tsx:1915+`(带 `tabIndex`/`onKeyDown`)、`ui/Rows.tsx:27`(`clickable` 分支)、`AppHeader.tsx:70`(已是真 ``) | 原则完全接受;存量违规仅这 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', …)` 没并进去 → 页面写 `` / `` 全部空转。**修好后查实真实边界与最初推测不同**:① `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-: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` 撤掉 `` 包装(角标此前被 `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 → 项目名 `` 从 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 → 项目名 `` 从 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 三处非语义热区可键盘化:分镜卡 `
` 加 `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` 改为真实 ``,头像与平台名合并为**一个**焦点站点(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`;三处首屏 `` 换成骨架后旧导出连同其 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(` 放宽为 `/(? s.error) const pollRef = useRef(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 ( setBriefOpen((v) => !v)} briefOpen={briefOpen} /> + onOpenBrief={() => setBriefOpen((v) => !v)} briefOpen={briefOpen} + narrow={narrow} navOpen={navOpen} onToggleNav={() => setNavOpen((v) => !v)} /> - + {/* <768 不渲染常驻侧栏:窄屏的导航入口只有顶栏那颗汉堡(点开左边的抽屉)。 + 以前是 Sider 的 breakpoint 自动收成 64px 图标轨 + 汉堡仍在——同一屏两个导航入口, + 图标轨还白吃正文 64px(430 实测正文盒子 430→366,扣掉 12×2 内距可用 342)。NEX 04 §8.2:只留一个入口。 */} + {!narrow && } {/* 系统级异常:kit Notice(R19 反馈表面唯一实现)。 @@ -196,6 +210,8 @@ export default function App() { {/* 项目层(身份 / 指标 / 流程 / 七站跳转 / 归档 / 删除)只在这里说一遍 */} setBriefOpen(false)} projectId={projectId} /> + {/* 只在窄屏挂:≥768 有常驻侧栏,抽屉里那份菜单就是重复的第二套导航 */} + {narrow && setNavOpen(false)} projectId={projectId} />} ) } diff --git a/frontend/src/app/layout/AppHeader.tsx b/frontend/src/app/layout/AppHeader.tsx index 47dc312..5a37d46 100644 --- a/frontend/src/app/layout/AppHeader.tsx +++ b/frontend/src/app/layout/AppHeader.tsx @@ -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 (