From b6a1df6dfda8925da851a54bd69d8089fa431854 Mon Sep 17 00:00:00 2001 From: "mula.liu" Date: Tue, 3 Nov 2026 23:43:48 +0800 Subject: [PATCH] =?UTF-8?q?=E5=8F=8D=E9=A6=88=E5=9B=9B=E7=BA=A7=E8=A1=A8?= =?UTF-8?q?=E9=9D=A2=E5=85=A8=E9=83=A8=E8=87=AA=E7=BB=98=EF=BC=9A=E5=90=90?= =?UTF-8?q?=E5=8F=B8=E3=80=81=E7=A1=AE=E8=AE=A4=E6=A1=86=E3=80=81=E6=8F=90?= =?UTF-8?q?=E7=A4=BA=E6=9D=A1=E3=80=81Tooltip=20=E4=B8=8D=E5=86=8D?= =?UTF-8?q?=E7=94=A8=E5=87=BA=E5=8E=82=E4=BB=B6?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 症状(用户原话「整体修改系统中的所以提示窗、完成后的反馈 tips 等。不要使用默认组件」): ① 55 处 `notify()` 落的是 antd 出厂 ``——页面顶部正中一颗纯黑药丸,只有 「一个图形 + 一行白字」:说完了「保存成功」却说不完后果(哪个版本、几个镜头、 能不能撤销);3 秒准时消失且**悬停不停**,错误里那句长文案根本读不完;同一次 批量操作连点五次就在原地叠五颗一模一样的胶囊;站内每一张卡、每一个信息块都有 描边、圆角、色块图标,只有它是另一家的长相。 ② 12 处 `window.confirm()` 弹的是**操作系统**的窗口:主题、字号、按钮、层级、语言 全由 Chrome/macOS 决定,「会删掉什么、影响哪些产物」整段挤成一行灰字,不可恢复 的删除和有代价但可逆的切换长得一模一样,用户只能条件反射点确定;它还是同步阻塞 的,页面脚本停在原地,动画和轮询全冻住。 ③ 页面里的提示条是 antd `Alert` 直封装,跟 R16.3 那把唯一的语义底纹尺(`BLOCK_TONE`) 是两套皮肤,同页并存;而且它没有 action 位——App.tsx 那条「后端连接异常」要挂 「重试」,只能绕过 kit 直接 import antd 的 Alert,R8 那道墙就是这么被自己的兜底 页凿穿的。 ④ 纯图标按钮的说明(R11 的唯一出口)仍是 antd 出厂 Tooltip:`colorBgSpotlight` 走 反色文字基准,浅色下是一块死黑、深色下比正文还亮,跟站内浮层没有共同语言。 做法(四级从同一张语义表出发,`components/ui/tone.tsx` 是唯一的色调与图形来源): · 语气表 `tone.tsx`:`ok/bad/warn/info/loading` 五档 → 底纹 `TONE_TINT`、图形 `TONE_ICON`、朗读名 `TONE_LABEL`、antd 词汇映射 `NOTICE_TONE`,色值全部取 antd 语义 token,页面里不出现新色。 · 吐司:状态留在 `stores/notice.ts`(**55 处调用点一个都没改**),皮肤换到 `components/ui/Toast.tsx`——右下角堆叠卡片、语义色块、标题 + 明细两层、底部倒计 时条、悬停/聚焦时动画与计时器同时暂停、同文案同语气去重成「×N」、同屏最多 5 颗 (超出挤掉最旧);`notifyLoading()` 改成 `startLoading()` 返回 `done()` 句柄, 进行中的那颗原地换语气换文案,不再「消失一下再弹一颗」。 · 确认框:新增 `stores/confirm.ts` 的 `confirmAction(): Promise` + `components/ui/Confirm.tsx`(浮层唯一实现 kit `Modal` + 语义色块 + 两层文案 + 图标按钮)。12 处原生调用清零,问话只留一句、后果写进 `desc`、主按钮把动作写成 动词(「删除 / 继续切换 / 仍然关闭 / 归档」),`danger` 给红描边。外层函数本来就 全是 `async`,一行 `await` 读起来和原来的 `if` 一样顺。已有一张开着时后来的请求 直接判取消——连按 Esc 不会排出一串窗口。 · 提示条:`Notice` 不再借 `Alert` 的皮肤,改读 `BLOCK_TONE`(与 `` 同一把 尺),左 20px 档色块、两行文案,新增 `action` 位与标准图标按钮关闭键;props 与 原来完全一致(含 antd 词汇的 `type`),32 处调用点零改动。App.tsx 的系统异常条与 ErrorBoundary 的兜底条从裸 antd `Alert` 收回 kit,并补上「重试」按钮。 · Tooltip:`theme/antd.ts` 只换两个 token(`colorBgElevated` 底 + `colorTextBase` 字),明暗自动跟主题、不引入新色值,描边与阴影那一圈在 `app.css` 的 `.ant-tooltip-inner` 补。不换自绘件:定位、延迟、触屏、aria-describedby 是它的 本职,「不要用默认组件」指的是那几张**反馈表面**。 · 两个宿主 `` / `` 挂在 `app/providers.tsx` 而不是 App.tsx:反馈队列是跨页面的全局状态(换页要清空、灯箱与抽屉之上也要显示),而 App.tsx 只画工作台,登录页走另一棵子树——挂在 Provider 层两边才是同一个长相。 · `app.css` 新增 38 条规则(`.nex-toast*` 17 / `.nex-confirm*` 12 / `.nex-notice*` 9),尺寸全部读 `--ant-*`;确认框的描边用 `:has([data-tone=…])` 落在 `.ant-modal` 上,为此给 kit `Modal` 加了 `className` 形参。抽屉/弹窗的吸底动作条交给 `ActionGroup`(同一套自动竖排量法),窄屏不再折成 2 + 1。 验证:`npm run typecheck` / `build` 绿;`scripts/ui/feedbackcheck.py`(本轮起的反馈表面 探针)明暗两档 0 违规——出厂 `message`/`Alert`/`window.confirm` 在 DOM 里已全部查不到, 吐司只有右下角一个 region、每颗都有色块与倒计时。反向验证:临时把一颗吐司换回 `message.success`,探针当场点名。 ⚠ 本笔同时携带并行会话在途的改动,如实记账:`styles/app.css` 是整文件提交的,其中 `nex-head-stack`(4 行,配套 `Panel.tsx` 的 `<576` 卡头换行,本轮一起才自洽)、 `nex-steps` / `nex-opt-cell` / `nex-tag-text`(5 行,选择器暂时悬空,调用方在 `components/ui/{Steps,Status}.tsx`,那些文件留在他们那笔)共 9 行不是本轮主题。 --- frontend/src/app/App.tsx | 16 +- frontend/src/app/ErrorBoundary.tsx | 27 +- frontend/src/app/providers.tsx | 40 +-- .../src/components/media/VersionPanel.tsx | 13 +- frontend/src/components/ui/Confirm.tsx | 80 +++++ frontend/src/components/ui/Overlay.tsx | 32 +- frontend/src/components/ui/Panel.tsx | 72 +++- frontend/src/components/ui/Toast.tsx | 100 ++++++ frontend/src/components/ui/index.ts | 4 + frontend/src/components/ui/tone.tsx | 48 +++ frontend/src/pages/AssetLibrary.tsx | 8 +- frontend/src/pages/Dashboard.tsx | 21 +- frontend/src/pages/ModelCenter.tsx | 8 +- frontend/src/pages/UserAdmin.tsx | 10 +- frontend/src/pages/project/Storyboard.tsx | 51 ++- frontend/src/pages/project/Timeline.tsx | 40 ++- frontend/src/stores/confirm.ts | 67 ++++ frontend/src/stores/notice.ts | 173 +++++++-- frontend/src/styles/app.css | 334 ++++++++++++++++-- frontend/src/theme/antd.ts | 16 + 20 files changed, 1009 insertions(+), 151 deletions(-) create mode 100644 frontend/src/components/ui/Confirm.tsx create mode 100644 frontend/src/components/ui/Toast.tsx create mode 100644 frontend/src/components/ui/tone.tsx create mode 100644 frontend/src/stores/confirm.ts diff --git a/frontend/src/app/App.tsx b/frontend/src/app/App.tsx index a8cd06a..0713eba 100644 --- a/frontend/src/app/App.tsx +++ b/frontend/src/app/App.tsx @@ -8,7 +8,7 @@ * 顶栏高度与底色来自 Layout 的组件 token; * · 折叠与断点来自 Sider 的 breakpoint + collapsedWidth(值 = antd Grid 的 md); * · 主区不再算减法:antd 的 Layout 本身是 flex,Sider 让位后 Content 自然撑开; - * · Content 内自上而下是「系统异常 Alert → 页面」。**内容页不再有多页签条**—— + * · Content 内自上而下是「系统异常提示条(kit Notice)→ 页面」。**内容页不再有多页签条**—— * 页签属于页面内部的分区切换(见 §6 与 `components/ui/Tabs.tsx`),不属于外壳。 * * · 登录页这类 chromeless 页面不套顶栏/侧栏,也不去拉需要鉴权的系统状态。 @@ -18,7 +18,9 @@ */ import { Suspense, useEffect, useRef, useState, type ReactNode } from 'react' import { Navigate, Outlet, useLocation, useMatches } from 'react-router-dom' -import { Alert, Button, Flex, Layout, Spin } from 'antd' +import { Button, Flex, Layout, Spin } from 'antd' +import { Notice } from '../components/ui' +import { IconReload } from '../components/icons' import { authState, refreshState, useAuthStore, useIsAuthenticated } from '../stores/auth' import { loadSystem, useSystemStore } from '../stores/system' import { toggleTheme } from '../stores/theme' @@ -144,11 +146,13 @@ export default function App() { + {/* 系统级异常:kit Notice(R19 反馈表面唯一实现)。 + 后端连不上是「可以继续用但要知道」的状态,条上给一颗重试按钮就地善后。 */} {systemError && !auth.offline && isAuthenticated && ( - void loadSystem(true)}>重试} /> + } onClick={() => void loadSystem(true)}>重试}> + 后端连接异常 + )} {/* 换顶级路由时整块重挂:避免上一个页面的本地状态(筛选条件、抽屉) diff --git a/frontend/src/app/ErrorBoundary.tsx b/frontend/src/app/ErrorBoundary.tsx index b87ff28..3ed4fec 100644 --- a/frontend/src/app/ErrorBoundary.tsx +++ b/frontend/src/app/ErrorBoundary.tsx @@ -14,7 +14,9 @@ * 不需要额外的「清除错误」状态。 */ import { Component, type ErrorInfo, type ReactNode } from 'react' -import { Alert, Button, Result, Typography } from 'antd' +import { Result, Typography } from 'antd' +import { Button, Notice } from '../components/ui' +import { IconProjects, IconReload } from '../components/icons' /** 自动重刷只允许发生一次:记时间戳而不是布尔值,隔一阵子的问题还能再自愈一回 */ const RELOAD_KEY = 'nex.chunk.reload.at' @@ -68,22 +70,21 @@ export default class ErrorBoundary extends Component { ? '多半是服务端刚重新部署过,浏览器还在用旧版页面清单。重新加载通常就好了;一直不好就把本页地址发我。' : '页面在渲染时抛了异常。先重新加载一次;如果每次进来都这样,请附上下面这行提示。'} extra={[ - , - + ]} > - - 兜底页由 ErrorBoundary 渲染;具体堆栈在浏览器控制台的 [nex] 页面渲染失败。 - - } - /> + {/* 兜底页里的异常回显也是反馈表面(R19):与工作台其它提示条同一个长相 */} + + 兜底页由 ErrorBoundary 渲染;具体堆栈在浏览器控制台的 [nex] 页面渲染失败。 + + }> + {(chunk ? '分包加载失败' : '渲染异常') + ':' + (error.message || String(error))} + ) } diff --git a/frontend/src/app/providers.tsx b/frontend/src/app/providers.tsx index c351778..42365ae 100644 --- a/frontend/src/app/providers.tsx +++ b/frontend/src/app/providers.tsx @@ -1,12 +1,15 @@ /** - * 全局 Provider:Ant Design 5 的主题与命令式 API 的唯一入口。 + * 全局 Provider:Ant Design 5 的主题与反馈表面的唯一入口。 * * 三件事都在这里,别在页面里重复: * 1) ConfigProvider —— 读 theme store 的 applied(dark/light)切换 antd 算法, * 皮肤全部来自 src/theme/antd.ts,页面里不许出现第二个 ThemeConfig; - * 2) —— 提供 message / notification / modal 的 context 实例, - * 这样它们也吃同一套主题(直接 import 的静态方法在 antd v5 里会丢主题); - * 3) 把 context 实例挂到模块级,让 stores/notice.ts 这类非组件代码也能弹提示。 + * 2) —— antd 的 cssVar 落点(它渲染的 .ant-app 带着主题变量类); + * 3) 反馈表面的两个宿主 与 。 + * + * 反馈为什么挂在这里而不是 App.tsx(2026-11 第十三轮):吐司队列与确认框是**全局**的, + * 而 App.tsx 只画工作台——登录页这类 chromeless 页面走的是另一棵子树。 + * 挂在这一层,两边共用同一条队列、同一张确认框,登录失败的提示也才是同一个长相。 * * cssVar 打开后 antd 会把 token 落成 --ant-* 变量,自绘区域(时间线、素材墙、灯箱) * 与 styles/app.css 直接读这些变量,和控件共用一把尺子。 @@ -19,7 +22,7 @@ * 让 antd 也进层(层序见 styles/index.css 的 @layer 声明:utilities 在最后), * 这类「探针不报错、页面却是坏的」的坑一次性填掉。 */ -import { useEffect, type ReactNode } from 'react' +import type { ReactNode } from 'react' import { App as AntdApp, ConfigProvider } from 'antd' import { StyleProvider } from '@ant-design/cssinjs' import zhCN from 'antd/locale/zh_CN' @@ -27,30 +30,11 @@ import dayjs from 'dayjs' import 'dayjs/locale/zh-cn' import { buildAntdTheme } from '../theme/antd' import { useThemeStore, type ThemeMode } from '../stores/theme' +import { ConfirmHost } from '../components/ui/Confirm' +import { ToastHost } from '../components/ui/Toast' dayjs.locale('zh-cn') -/** 提供的命令式实例;组件外用 notify() / confirmAction() 走这两个对象 */ -let messageApi: any = null -let notificationApi: any = null -let modalApi: any = null - -export const antdApi = { - get message() { return messageApi }, - get notification() { return notificationApi }, - get modal() { return modalApi } -} - -function BindAntdApi() { - const app = AntdApp.useApp() - useEffect(() => { - messageApi = app.message - notificationApi = app.notification - modalApi = app.modal - }, [app]) - return null -} - export function ThemeProviders({ children }: { children: ReactNode }) { const applied = useThemeStore((s) => s.applied) as ThemeMode return ( @@ -66,8 +50,10 @@ export function ThemeProviders({ children }: { children: ReactNode }) { getPopupContainer={(node) => (node?.closest('.ant-drawer-body, .ant-modal-body') as HTMLElement) || document.body} > - {children} + {/* 反馈表面的两个宿主:吐司在右下角、确认框居中,都在主题子树之内 */} + + diff --git a/frontend/src/components/media/VersionPanel.tsx b/frontend/src/components/media/VersionPanel.tsx index 9bbc7cf..ca6e675 100644 --- a/frontend/src/components/media/VersionPanel.tsx +++ b/frontend/src/components/media/VersionPanel.tsx @@ -20,6 +20,7 @@ import { viewedVersion } from '../../stores/preview' import { Button, MUTED, Tag } from '../ui' +import { confirmAction } from '../../stores/confirm' import { IconClose, IconDelete, IconEye, IconStar } from '../icons' /** 新版本在上,和下拉里的顺序一致 */ function rowsOf(item: MediaItem): MediaVersion[] { @@ -55,12 +56,18 @@ export function VersionPanel({ onClose }: { onClose: () => void }) { void setCurrentVersion(row.version_no) } - function remove(row: MediaVersion) { + /* 删除版本是不可逆的:问话(删哪个)与后果(文件删不删、当前版本怎么办) + 分两层写进站内确认框,不再挤成原生 confirm 的一整句(R19)。 */ + async function remove(row: MediaVersion) { if (onlyOne) return const fileNote = row.exists === false ? '该版本的文件已经不在磁盘上,这次只清理记录。' : '该版本的记录与文件会一并删除,不可恢复。' const tail = row.current || row.version_no === currentNo ? '它正是当前默认版本,删除后自动回落到剩余最新版本。' : '' - const ask = `确认删除「${item!.title}」的 v${row.version_no}?${fileNote}${tail}` - if (window.confirm(ask)) void deleteVersion(row.version_no) + const ok = await confirmAction({ + title: `删除「${item!.title}」的 v${row.version_no}?`, + desc: fileNote + tail, + tone: 'danger', confirmText: '删除', confirmIcon: + }) + if (ok) void deleteVersion(row.version_no) } return ( diff --git a/frontend/src/components/ui/Confirm.tsx b/frontend/src/components/ui/Confirm.tsx new file mode 100644 index 0000000..0c3bc24 --- /dev/null +++ b/frontend/src/components/ui/Confirm.tsx @@ -0,0 +1,80 @@ +/** + * 确认框:破坏性操作的第二道闸,自绘表面,**不用 `window.confirm`**(2026-11 第十三轮)。 + * + * 症状(用户原话「整体修改系统中所有提示窗、完成后的反馈 tips 等。不要使用默认组件」): + * 全站 13 处 `window.confirm()` 弹的是**操作系统**的窗口—— + * ① 主题、字号、按钮、语言全由 Chrome/macOS 决定,深色工作台里突然插进一块白色系统框; + * ② 只有一行灰字 + 两颗灰按钮,「删除不可恢复」和「继续切换」长得一模一样; + * ③ 问话与后果挤成一句("删除 v3「正片」?\n只删除编排记录,已导出成片不受影响。"), + * 原生框把它当一行文本折行,`\n` 甚至只是某些浏览器才认的运气; + * ④ 同步阻塞:脚本停在原地,进度条、轮询、动画全部冻住。 + * 做法:状态在 `stores/confirm.ts`(`confirmAction(): Promise`),皮肤在这里—— + * 浮层唯一实现 kit `Modal`(遮罩 / Esc / 焦点陷阱 / 滚动锁交给 antd,与抽屉同源) + * + 32px 语义色块 + 「一句问话 / 一层后果」两行文案 + 图标按钮, + * 底部沿用全站口径「取消 → 主行动」右对齐、最多一颗 primary、危险档 primary danger。 + * 为什么回车=确认而 Esc=取消:原生 confirm 就是这个映射,肌肉记忆不用重建; + * 但焦点落在按钮上时不许接管(否则 Tab 到「取消」按回车会误删)。 + * 为什么整站只可能有一张:`confirmAction` 在已有确认框时直接 resolve(false), + * 键盘连按不会排出一串窗口(原生 confirm 会)。 + */ +import { useEffect } from 'react' +import { useConfirmStore } from '../../stores/confirm' +import { Button } from './Button' +import { Modal } from './Overlay' +import { TONE_TINT, type FeedbackTone } from './tone' +import { IconCheck, IconClose, IconInfo, IconWarn } from '../icons' + +/** 确认框的三档语气 → 反馈语义(色块与色值仍从 tone.tsx 那张唯一的表里取) */ +const CONFIRM_TONE: Record<'danger' | 'warn' | 'info', FeedbackTone> = { + danger: 'bad', warn: 'warn', info: 'info' +} + +/** 挂在 app/providers.tsx 上(唯一一处),任何页面调用 confirmAction 都由这一颗应答 */ +export function ConfirmHost() { + const req = useConfirmStore((s) => s.req) + const answer = useConfirmStore((s) => s.answer) + const open = !!req + const o = req?.options + + /* 回车 = 确认。挂在 document 上而不是内容区上:antd 打开模态时把焦点落在 + `.ant-modal`(tabIndex=-1)那层,keydown 只会向上冒泡,落在 body 上的监听收不到。 */ + useEffect(() => { + if (!open) return + const onKey = (e: KeyboardEvent) => { + if (e.key !== 'Enter' || e.isComposing) return + /* 焦点在按钮 / 输入框上时交给它们自己处理(Tab 到「取消」按回车不该确认) */ + const t = e.target as HTMLElement | null + if (t && (t.tagName === 'BUTTON' || t.tagName === 'INPUT' || t.tagName === 'TEXTAREA' + || t.tagName === 'SELECT' || t.isContentEditable)) return + e.preventDefault() + answer(true) + } + document.addEventListener('keydown', onKey) + return () => document.removeEventListener('keydown', onKey) + }, [open, answer]) + + const tone = CONFIRM_TONE[o?.tone ?? 'danger'] + return ( + answer(false)} width={460} className="nex-confirm" + label={typeof o?.title === 'string' ? o.title : '请确认操作'} + footer={<> + + + }> +
+ + {/* 问话用的图形:危险与注意都是「先停下看一眼」,信息档才是普通的 i */} + {tone === 'info' ? : } + +
+
{o?.title}
+ {o?.desc &&
{o.desc}
} +
+
+
+ ) +} + +export default ConfirmHost diff --git a/frontend/src/components/ui/Overlay.tsx b/frontend/src/components/ui/Overlay.tsx index ac63ab6..9ed7d17 100644 --- a/frontend/src/components/ui/Overlay.tsx +++ b/frontend/src/components/ui/Overlay.tsx @@ -2,6 +2,7 @@ import { useId, type ReactNode } from 'react' import { Drawer as AntDrawer, Modal as AntModal } from 'antd' import { cn } from '../../lib/cn' import { Button } from './Button' +import { ActionGroup } from './Controls' import { IconClose } from '../icons' /** * 浮层:Ant Design 5 Drawer / Modal 的唯一封装。 @@ -26,7 +27,20 @@ export const DRAWER_TITLE = 'block text-lg font-bold min-w-0' * (它用 DRAWER_* 自拼外壳),探针原来的兜底 scope 是 `main`,而 `