From 687bf5a64dd3a2ac82ee85426fb59ab08eff65e1 Mon Sep 17 00:00:00 2001 From: "mula.liu" Date: Sun, 8 Nov 2026 00:16:30 +0800 Subject: [PATCH] =?UTF-8?q?NEX=20=E9=98=B6=E6=AE=B5=208=C2=B7N14=EF=BC=9A?= =?UTF-8?q?=E5=88=86=E9=95=9C=E6=8E=92=E5=BA=8F=E8=A1=A5=E4=B8=8A=E9=94=AE?= =?UTF-8?q?=E7=9B=98=E6=9B=BF=E4=BB=A3=20=E2=8C=A5=E2=86=91/=E2=8C=A5?= =?UTF-8?q?=E2=86=93=EF=BC=8C=E6=94=B9=E9=95=9C=E5=BA=8F=E4=B8=8D=E5=86=8D?= =?UTF-8?q?=E6=98=AF=E9=BC=A0=E6=A0=87=E4=B8=93=E5=B1=9E?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 阶段 2 把分镜卡做到「点得开」,但排序仍然只有两条鼠标路(HTML5 拖拽 + 分镜表两颗按钮): 键盘能走到卡片,却走不动卡片。用户批准 N14 后按「不加新控件」的口径补齐第二条路。 实现(frontend/src/pages/project/Storyboard.tsx): - move() 回传 Promise(越界 false,其余走 run() 的既有返回值)。三个 void move(...) 调用点一字未改,行为不变——run() 本来就返回布尔,只是没人接。 - 新增 moveByKey():越界报「镜头 N 已经在第 M 位,无法继续前移/后移」,成功报 「已后移到第 M 位」;随后 refocusShotCard()(rAF 最多 8 帧找回 [data-shot-card]) 把焦点还给同一张卡——列表整体重排会把卡片重挂、焦点掉回 , 不归还的话第二下按键根本没有落点,等于「只能移一格」。拿不到就不抢焦点。 - ShotCard.onKeyDown 先接 Alt+↑/↓(preventDefault + stopPropagation)再走 Enter/Space: 卡片正处在 window 那条「方向键切镜」监听的冒泡路径上,不拦一次按键会既移镜又切镜; window 侧同步加 if (ev.altKey && Arrow) return 兜底,焦点不在卡上时宁可不响应。 - 可达性:aria-keyshortcuts="Alt+ArrowUp Alt+ArrowDown" + 全站一份 sr-only 说明 (卡片用 aria-describedby 指过去)。不给整块热区加 title——原生 tooltip 会盖住 卡内每一处;也不给每张卡的 aria-label 各念一遍——30 张卡念 30 遍同样的话。 aria-label 逐字未改,阶段 2 的口径与探针定位都不受影响。 - 反馈的不对称是刻意的,写进 UI规范.md §13.3 ⑤ 第 3 条:拖拽时卡片跟着手走、落点 由卡片自己说,键盘时手没在版面上、必须由文字说出「成到哪」;判据从「输入方式一致」 改成「用户能不能自己看见落点」。播报走 notify()(Toast 容器本身是常驻 aria-live), 不另起第二条 live region(R19)。 - 不新增卡脚按钮:224 档实测那一行会劈成 2+1(正是 btnclustercheck 拦的形状), 补按钮就得缩控件或加行,两者都属本轮排除的视觉改动。看板/表格像素零变化, 新插入的 sr-only

放 grid 外面,不参与列宽计算。 帮助页同步:pages/Help.tsx 的分镜步骤与快捷键清单加 ⌥↑ / ⌥↓(注明 Win/Linux 用 Alt)。 G3 补「热区不是按钮时快捷键挂在哪」;对照文档 §2.8 更新证据、§5 N14 ⏸→✅、§7 变更记录。 验证:npm run typecheck 通过(中途抓到一处真实 TS1005:普通注释搬进 JSX 子节点)· npm run build 通过(仅既有 chunk>1200kB 告警)· classaudit 九道闸全 0 EXIT=0 · 新写专项探针 sortcheck(明暗各 6 组:顺序变了 / 焦点没丢 / 有播报 / 边界会说话且顺序不动 / 不 Alt 的方向键行为不变 / Enter 仍打开检查器)PASS 0 条,对 HEAD 反证 FAIL 14 条 · 常驻 11 道探针 EXIT=0 ×11(GATEPROBE_OK 11/11,含 feedbackcheck 与 gridcheck)· visualcheck 120 状态(15 路由 × 4 视口 × 明暗)断言 0 / HTTP 0 / console 0, 另跑 1440 单档 30 状态同样全 0。证据 reports/ui_evidence/nex-p8/n14/。 上游:NEX 08 §2 新增「可排序条目的键盘移动方式」五条(子仓库单独提交)。 --- docs/NEX-对照与例外.md | 9 +- docs/UI规范.md | 16 ++- frontend/src/pages/Help.tsx | 4 +- frontend/src/pages/project/Storyboard.tsx | 142 +++++++++++++++++----- 4 files changed, 132 insertions(+), 39 deletions(-) diff --git a/docs/NEX-对照与例外.md b/docs/NEX-对照与例外.md index 6092d0a..02b9aa9 100644 --- a/docs/NEX-对照与例外.md +++ b/docs/NEX-对照与例外.md @@ -142,7 +142,7 @@ NEX 与本项目差异用「项目适配」解决,**不得反向修改本项 | 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 一并补 | +| §2 焦点与键盘 | COMPLIANT(阶段 2 三处热区可键盘化 + **阶段 8 补排序键盘替代 N14**) | `app.css` 全站 `:focus-visible` 兜底;`ui/Table.tsx`、`MediaThumb.tsx`、`AgentConsole.tsx` 键盘处理;`lib/layers.ts::floatingLayerOpen` 分层 Esc;`Storyboard.tsx::moveByKey` + `ShotCard` 的 `aria-keyshortcuts` / `aria-describedby` | 拖拽排序的键盘替代 NEX 原本未覆盖 → **N14**,阶段 2 只做授权内的 3 处热区,**阶段 8 用户批准后落地**(`⌥↑` / `⌥↓`,实测见 `reports/ui_evidence/nex-p8/n14/`),并反向提交给 NEX `08` §2(子仓库提交) | | §3 对比度 / 状态不只靠颜色 | COMPLIANT | `UI规范.md` §2.1(标签=点+文字,非仅颜色)、`Status` 文案来自 `lib/format.ts::statusLabel` | 状态一律「点 + 文字」双通道 | | §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 修并补探针 | @@ -270,7 +270,7 @@ cd frontend/src && grep -roh -- '--nex-[a-z0-9-]*' . | sort | uniq -c | sort -rn | N11 | 07 §1 把图表写成 Dashboard 固定组成 | 本表 **E6** + 配置 `chart_library_for_alignment_only: forbidden` | 已登记 | | N12 | 07 §2 缺卡片网格列表细则 | 阶段 6 +建议 NEX 补 | 待议 | | N13 | 07 无「审批/评审」模式 | `page_patterns.project_specific: [review-approval]` | 已声明 | -| N14 | 08 §1/§2 未覆盖 HTML5 拖拽的键盘替代(分镜排序) | 阶段 2 只做授权内的那 3 处热区,**未**引入 `⌘/Ctrl+↑↓`:改排序交互属产品决策 | ⏸ 待议(不在本轮授权) | +| N14 | 08 §1/§2 未覆盖 HTML5 拖拽的键盘替代(分镜排序) | 阶段 8 采纳:分镜卡加 `⌥/Alt + ↑↓`(`Storyboard.tsx::moveByKey`),**不动鼠标拖拽**、不新增卡脚按钮(224 档实测会劈行);快捷键写进 `aria-keyshortcuts` + 一份 `sr-only` 说明 + 使用说明页清单,结果播报走 `notify()`(吐司容器本身是常驻 `aria-live`,见 `UI规范.md` §13.3 ⑤ 第 3 条) | **✅ 已采纳**(阶段 8):NEX `08-accessibility-responsive.md` §2 新增「可排序列表的键盘替代」条款(子仓库提交);本项目侧口径同步 `UI规范.md` §13.3 ⑤ / G3 | | N16 | 04 §8 只说「不允许私有断点」,没给主阶梯放不下时的登记出口 | 本表 **E9** + `UI规范.md` §4「登记断点」口径(一名一使用者 + 必带视口测量 + 禁止裸 `max-[...]`) | **✅ 已采纳**(阶段 8):NEX `04-layout-system.md` 新增 §8.1 命名断点登记出口 + §8.2 窄屏降级范式;本项目侧同步加 `classaudit.mjs` 第 9 闸 BP 做机器对账(`UI规范.md` §4 复核口径改为「九条判据见 §15.1」) | | N15 | 10 阶段 5 未承认「项目已有质量门禁」应复用 | 本表 §2.10 判定 + 建议 NEX 增补复用条款 | 已登记 | @@ -288,7 +288,7 @@ cd frontend/src && grep -roh -- '--nex-[a-z0-9-]*' . | sort | uniq -c | sort -rn | 阶段 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` | | 阶段 4 交付项 | 六态表面(首屏骨架 / 抽屉正文骨架 / Forbidden / NotFound)已落地,`visualcheck` 名单 14 → 15 | ✅ 已完成(见 §7) | 明细见 `reports/NEX阶段4-7实施-2026-11-07.md` | -| 阶段 1–3 交付项 | 阶段 1(截断兜底 + 探针)、阶段 2(3 处热区可键盘化)、阶段 3(`LAYER` 层级表 + 两处真实遮挡修复)均已落地;N14 拖拽键盘替代除外 | ✅ 已完成(见 §7 三行记录) | 明细见 `reports/NEX阶段0-3实施-2026-11-07.md` | +| 阶段 1–3 交付项 | 阶段 1(截断兜底 + 探针)、阶段 2(3 处热区可键盘化)、阶段 3(`LAYER` 层级表 + 两处真实遮挡修复)均已落地;**N14 拖拽键盘替代当时未做**(不在阶段 0–3 授权内),阶段 8 已补,见本表 N14 行与 §7 最后一行 | ✅ 已完成(见 §7 三行记录) | 明细见 `reports/NEX阶段0-3实施-2026-11-07.md` | | 本地杂物目录 | `.trash/`(27M)、`.local/`(352M)仍在磁盘 | 已 gitignore;`AGENTS.md` §1 已声明「不作现状依据」 | 保持,不参与任何统计 | --- @@ -301,13 +301,14 @@ 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 | **阶段 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(` 放宽为 `/(?`(越界 `false`,三个 `void move(...)` 调用点一字未改),新增 `moveByKey()` —— 越界时报「已经在第 N 位,无法继续前移/后移」、成功时报「已后移到第 M 位」并把焦点还给同一张卡(`refocusShotCard()`:rAF 最多 8 帧找回 `[data-shot-card]`,拿不到就不抢焦点,否则第二下按键没有落点);`ShotCard` 的 `onKeyDown` 先接 `Alt+↑/↓`(`preventDefault + stopPropagation`,卡片就在 window 那条「方向键切镜」监听的冒泡路径上,不拦会一次按键既移镜又切镜),window 侧同步加 `if (ev.altKey && Arrow) return` 兜底;可达性用 `aria-keyshortcuts="Alt+ArrowUp Alt+ArrowDown"` + 全站一份 `sr-only` 说明(`aria-describedby` 指过去),**不新增卡脚按钮**(224 档实测会劈行);`pages/Help.tsx` 快捷键清单与分镜步骤同步 `⌥↑` / `⌥↓`。口径落 `UI规范.md` §13.3 ⑤ 第 3 条(键盘路径必须播报、拖拽路径不播报的不对称)与 G3(热区不是按钮时快捷键挂在哪);NEX 侧 `08-accessibility-responsive.md` §2 新增「可排序列表必须提供键盘移动方式」(子仓库提交)。专项探针 `reports/ui_evidence/nex-p8/n14/scripts/sortcheck.py`:Light/Dark 各跑「顺序变了 / 焦点没丢 / 有播报 / 边界会说话 / 不 Alt 的方向键行为不变 / Enter 仍打开检查器」,PASS 0 条;对 HEAD 反证 FAIL 14 条 | Codex(阶段 8·N14) | **维护约定** 1. 新增/修改一条 E:必须同时给代码证据位置,否则视为未登记。 diff --git a/docs/UI规范.md b/docs/UI规范.md index ceaadf5..2b09abe 100644 --- a/docs/UI规范.md +++ b/docs/UI规范.md @@ -1441,8 +1441,17 @@ antd 的 `Tag.CheckableTag` 未选中态是**完全透明**的。铺进等宽格 2. **需要被阅读、会被复述的内容不许只活在吐司里。** 版本号、被跳过的数量、可复制的标识、 下一步动作,落在页内 `Notice` / 表格行上;吐司只回答「刚才那一下成了没」(本表 ③ 行)。 反过来也成立:页内已经有 `Notice` 说过的事,不再补一颗吐司。 +3. **结果播报跟着「用户能不能自己看见落点」判,不跟着「输入方式统一」判** + (2026-11-07 · 阶段 8 · N14)。同一个动作换了输入方式,反馈预算可以不一样,这不是不一致: + 鼠标拖动分镜卡时卡片跟着指针走,落点它自己就说清楚了,再补一颗「已移到第 3 位」是第 ③ 句废话; + 键盘 `⌥↑` / `⌥↓` 移动同一张卡时手没在版面上,读屏用户更是只剩列表闪一下, + 「它刚从第 4 位来到第 3 位」必须由文字说出来(`pages/project/Storyboard.tsx::moveByKey`)。 + **到头了也要说话**(「镜头 3 已经在第 1 位,无法继续前移」)——静默不动会被当成快捷键没生效, + 这条对鼠标同样成立,只是拖到边界时指针本身给了阻力。 + 播报一律走 `notify()`:`components/ui/Toast.tsx` 的容器本身就是常驻 `aria-live="polite"`, + 给键盘操作另起一条 live region 就是全站第二个播报通道。 -判据一句话:**吐司说「成了」,页面说「成什么样」。** +判据一句话:**吐司说「成了」,页面说「成什么样」;看不见落点的那只手,吐司还得说「成到哪」。** 同一条改动顺手收掉一个静默漏洞:裸调用 `confirm(...)` / `alert(...)` 与 `window.confirm(...)` 是同一个原生对话框,而 `classaudit` 第 6 闸原本只匹配字面量 `window.confirm(`, @@ -1707,6 +1716,11 @@ URL 没变,effect 不再触发。 ### G3 · 快捷键 / 图标含义只在 hover 纯图标或符号按钮必须有 `title` 或 `aria-label`(R11);快捷键(`⌘S` / `J`/`K` / `Esc`) 写在相关按钮的 `title` 里,不再单独占一行文字。 +**热区不是按钮时没有 `title` 可挂**(看板分镜卡是整块 `
` 热区,见 N14 的 `⌥↑` / `⌥↓`): +键位用 `aria-keyshortcuts` 声明,说明文字全站只写**一份** `sr-only` 节点、每张卡用 +`aria-describedby` 指过去(一份而不是每张卡一句:30 张卡念 30 遍同样是要清掉的冗余), +页面级快捷键清单以「使用说明」页为唯一登记处。**不许**为了这条给整块热区补 `title`—— +原生 tooltip 会盖住卡内每一处,鼠标划过就是一片浮字。 ### G4 · 表单内的「增 / 删」:写法见 §5.1,这里只管摆位 自造 `variant` 方言已废(`mapVariant` 也删了),按钮的语义 → antd 轴映射**只在 §5.1 写一次**。 diff --git a/frontend/src/pages/Help.tsx b/frontend/src/pages/Help.tsx index c7d0319..22988f2 100644 --- a/frontend/src/pages/Help.tsx +++ b/frontend/src/pages/Help.tsx @@ -472,7 +472,7 @@ export default function Help() { 用搜索框和状态 / 模式 / 排序筛选定位镜头,或点“仅看阻塞”“仅看缺关键帧”直接清理预检问题。
  • - 拖动卡片即可改镜序(分镜表视图也可拖行或用 ↑↓);勾选多个镜头后可批量复制、移到最前、统一改参数或删除。 + 拖动卡片即可改镜序(不用鼠标也行:Tab 走到卡片上,按 ⌥↑ / ⌥↓ 前移后移,分镜表视图也可拖行或用 ↑↓);勾选多个镜头后可批量复制、移到最前、统一改参数或删除。
  • 选中镜头后在检查器编辑参数与绑定;提示词页可切换“自动组装 / 人工覆盖”,并回填任意历史版本。 @@ -484,7 +484,7 @@ export default function Help() { 需要交给编剧或外部工具时,用右上角导出 Markdown / CSV / JSON,导出的 Markdown 可以直接再导回来。
  • - 快捷键: J / K 或 ↑ ↓ 切换镜头,X 勾选当前镜头, ⌘S 保存检查器改动,Esc 关闭检查器或导入面板。首屏只拉轻量看板数据, 几十上百镜也不会拖慢页面。 + 快捷键: J / K 或 ↑ ↓ 切换镜头,X 勾选当前镜头, ⌥↑ / ⌥↓ 把当前卡片前移或后移一镜(等同拖动,Windows / Linux 用 Alt), ⌘S 保存检查器改动,Esc 关闭检查器或导入面板。首屏只拉轻量看板数据, 几十上百镜也不会拖慢页面。
    05 · 任务调度 diff --git a/frontend/src/pages/project/Storyboard.tsx b/frontend/src/pages/project/Storyboard.tsx index 01457bb..53f6135 100644 --- a/frontend/src/pages/project/Storyboard.tsx +++ b/frontend/src/pages/project/Storyboard.tsx @@ -841,18 +841,44 @@ export default function Storyboard() { })) } /** 上移/下移按镜头 id 定位:筛选或排序后可见序号 ≠ 全量序号,用行号会移动错镜头 */ - async function move(shot: any, delta: number) { + async function move(shot: any, delta: number): Promise { const rows = live.current.shots const at = rows.findIndex((s) => s.id === shot.id) const target = at + delta - if (at < 0 || target < 0 || target >= rows.length) return - await run('调整顺序', () => api.post(`/api/projects/${projectId}/shots/bulk`, + if (at < 0 || target < 0 || target >= rows.length) return false + return run('调整顺序', () => api.post(`/api/projects/${projectId}/shots/bulk`, { action: 'move', shot_ids: [shot.id], index: target + 1 })) } function canMove(shot: any, delta: number) { const at = shots.findIndex((s) => s.id === shot.id) return at >= 0 && at + delta >= 0 && at + delta < shots.length } + /** + * 键盘排序(NEX 08 §2 / N14):卡片能聚焦了,还得能**移动**, + * 否则「键盘可达」只到「点得开」为止,改镜序这件事仍然是鼠标专属。 + * + * 只有键盘路径报结果,拖拽不报:拖的那张卡自己会跟着手走,落点它已经看见了; + * 键盘用户看不见「它刚从第 4 位来到第 3 位」这件事,得由文字说出来。 + * 反馈走 notify() 而不是新的 live region——components/ui/Toast.tsx 的容器 + * 本身就是常驻 aria-live="polite",再造一个就是全站第二条播报通道(R19)。 + * 到头了也要说话:静默不动会被当成「快捷键没生效」。 + */ + async function moveByKey(shot: any, delta: number) { + if (busy) return + const rows = live.current.shots + const at = rows.findIndex((s) => s.id === shot.id) + const to = at + delta + const name = `镜头 ${shot.code || shot.order_index}` + const dir = delta < 0 ? '前移' : '后移' + if (at < 0 || to < 0 || to >= rows.length) { + notify(`${name} 已经在第 ${at + 1} 位,无法继续${dir}`) + return + } + if (await move(shot, delta)) { + notify(`${name} 已${dir}到第 ${to + 1} 位`) + refocusShotCard(shot.id) + } + } /** 卡片上的「⧉」只复制当前镜头,不跟着勾选集走 */ async function duplicateOne(shot: any) { await run('复制镜头', () => api.post(`/api/projects/${projectId}/shots/bulk`, @@ -1094,6 +1120,9 @@ export default function Storyboard() { return } if (typing) return + // Alt+↑/↓ 是卡片自己的排序键(N14):焦点不在卡上时什么都不做, + // 更不能落到下面那两行「方向键 = 切镜」上,否则一次按键同时改镜序又换选中。 + if (ev.altKey && (ev.key === 'ArrowUp' || ev.key === 'ArrowDown')) return if ((ev.metaKey || ev.ctrlKey) && ev.key.toLowerCase() === 's') { ev.preventDefault() if (live.current.selectedId || live.current.creating) void fns.current.saveShot() @@ -1326,34 +1355,44 @@ export default function Storyboard() {
    ) : view === 'grid' ? ( - /* 258px 是「缩略图 + 两行说明 + 脚注三个按钮」不塌的地板; - 降档用登记断点 board=1240(UI规范.md §4):主阶梯的 xl=1200 太晚, - 实测 1204–1239(1200px 笔记本的可视宽度)靠 224 的地板排得下 4 列, - 按 258 排只剩 3 列;邻居 2xl=1600 又太早:1280 会从实测 3 列 328px - 变 4 列 243px、1440 从 4 列 283px 变 5 列 224px,每张卡缩掉 59–85px。 */ -
    - {filtered.map((s) => ( - void select(s.id)} - onCheck={(shift) => toggleCheck(s.id, shift)} - onDragStart={() => startDrag(s.id)} - onDragOverItem={() => overDrag(s.id)} - onDragEnd={() => { setDragOver(null); setDragging(null) }} - onDropItem={() => void dropOn(s.id)} - onPreview={(which) => previewShot(s, which)} - onText={() => void focusText(s)} - onDuplicate={() => void duplicateOne(s)} - onRemove={() => void removeShot(s)} - /> - ))} -
    + <> + {/* 排序快捷键的读屏版(N14):一张卡一句太吵,全站就写这一份, + 每张卡用 aria-describedby 指过来。放 grid 外面而不是里面: + 放进去它就是第一个网格子项,会被列宽探针算进列数。 */} +

    + 聚焦卡片后按住 Alt(macOS 键盘上标的是 Option)加上下方向键,可以把这一镜前移或后移; + 分镜表视图里也有「前移 / 后移」按钮。 +

    + {/* 258px 是「缩略图 + 两行说明 + 脚注三个按钮」不塌的地板; + 降档用登记断点 board=1240(UI规范.md §4):主阶梯的 xl=1200 太晚, + 实测 1204–1239(1200px 笔记本的可视宽度)靠 224 的地板排得下 4 列, + 按 258 排只剩 3 列;邻居 2xl=1600 又太早:1280 会从实测 3 列 328px + 变 4 列 243px、1440 从 4 列 283px 变 5 列 224px,每张卡缩掉 59–85px。 */} +
    + {filtered.map((s) => ( + void select(s.id)} + onCheck={(shift) => toggleCheck(s.id, shift)} + onDragStart={() => startDrag(s.id)} + onDragOverItem={() => overDrag(s.id)} + onDragEnd={() => { setDragOver(null); setDragging(null) }} + onDropItem={() => void dropOn(s.id)} + onPreview={(which) => previewShot(s, which)} + onText={() => void focusText(s)} + onDuplicate={() => void duplicateOne(s)} + onRemove={() => void removeShot(s)} + onMove={(d) => void moveByKey(s, d)} + /> + ))} +
    + ) : ( {/* 分镜表:antd Table。 @@ -1889,6 +1928,30 @@ export default function Storyboard() { 它们的类名是从旧站逐条抄来的,脱离这一页就没有第二个使用者, 提前抽成通用组件只会让 ui 目录变成「什么都往里扔」。 */ +/* N14 键盘排序用的三个标识:id 是页面级唯一的说明文字,卡片用 aria-describedby 指它 */ +const SHOT_MOVE_HINT_ID = 'shot-move-hint' +const SHOT_MOVE_KEYSHORTCUTS = 'Alt+ArrowUp Alt+ArrowDown' + +/** + * 排序之后把焦点还给同一张卡。 + * + * 不这么做的话:move() 里 load() 会整表换掉 rows,卡片重挂,焦点掉回 , + * 键盘用户按第二下 Alt+↓ 时已经没有落点,等于「只能移一格」。 + * 为什么 rAF 重试而不是同步 focus:数据是 await load() 之后才 setState 的, + * 本函数返回时新列表通常还没画完,同步 focus 会作用在旧节点上。 + * 最多 8 帧(约 130ms):拿不到就算了(比如这镜正被筛选条件挡住), + * 不去抢 body 之外的焦点,免得把用户本来就放好的焦点弄丢。 + */ +function refocusShotCard(id: number) { + let tries = 0 + const step = () => { + const el = document.querySelector(`[data-shot-card="${id}"]`) + if (el) { el.focus(); return } + if (++tries < 8) requestAnimationFrame(step) + } + requestAnimationFrame(step) +} + /** * 看板卡(.card):整张卡就是镜头入口, * 所以缩略图预览、勾选框、脚注三处都要各自拦下冒泡,否则点一下会变成「选中镜头 + 打开预览」。 @@ -1910,12 +1973,14 @@ type ShotCardProps = { onText: () => void onDuplicate: () => void onRemove: () => void + /** ±1 = 前移 / 后移一镜(Alt/Option + ↑↓,与拖拽同一个动作) */ + onMove: (delta: number) => void } function ShotCard({ shot: s, projectId, selected, draggedOver, picked, busy, onSelect, onCheck, onDragStart, onDragOverItem, onDragEnd, onDropItem, - onPreview, onText, onDuplicate, onRemove + onPreview, onText, onDuplicate, onRemove, onMove }: ShotCardProps) { const badge = reviewBadge(s) return ( @@ -1937,8 +2002,21 @@ function ShotCard({ tabIndex={0} aria-label={'打开分镜详情:镜头 ' + (s.code || s.order_index)} aria-current={selected ? 'true' : undefined} + /* N14:快捷键既要用 aria-keyshortcuts 声明(读屏软件可查询), + 也要在聚焦时真的念出来(不是所有读屏都会念 keyshortcuts), + 所以再挂一条 sr-only 说明。两者说的是同一串键,不另起名字。 */ + aria-keyshortcuts={SHOT_MOVE_KEYSHORTCUTS} + aria-describedby={SHOT_MOVE_HINT_ID} onKeyDown={(ev) => { if (ev.target !== ev.currentTarget) return + /* Alt+↑/↓ = 移动这一镜。必须 stopPropagation:卡片在 window 那条 + 「方向键切镜」监听的冒泡路径上,不拦的话一次按键既移镜又切镜。 */ + if (ev.altKey && (ev.key === 'ArrowUp' || ev.key === 'ArrowDown')) { + ev.preventDefault() + ev.stopPropagation() + onMove(ev.key === 'ArrowUp' ? -1 : 1) + return + } if (ev.key !== 'Enter' && ev.key !== ' ') return ev.preventDefault() onSelect()