diff --git a/frontend/src/components/media/RecordAudio.tsx b/frontend/src/components/media/RecordAudio.tsx index 343da43..6cb5fbc 100644 --- a/frontend/src/components/media/RecordAudio.tsx +++ b/frontend/src/components/media/RecordAudio.tsx @@ -329,7 +329,7 @@ export function RecordAudio({ label = '录制', target = '新版本', disabled = {blocked ? : supported && ( <>

+ micOk ? 'border-border-secondary bg-fill-tertiary text-success' : 'border-warning-border bg-warning-bg text-warning')}> {micOk ? : }{micStatusText} void recheck()}>重新检测 diff --git a/frontend/src/components/ui/Controls.tsx b/frontend/src/components/ui/Controls.tsx index e2bb968..c8b42ef 100644 --- a/frontend/src/components/ui/Controls.tsx +++ b/frontend/src/components/ui/Controls.tsx @@ -57,19 +57,64 @@ export function Dense({ children, className }: { children: ReactNode; className? * 放不下时才折行(Flex wrap)。字段仍不带下边距(app.css 归零)。 * 为什么还给 Ctlbar 而不是新建一只组件:它表达的语义就是「含字段的横条」, * 要改的是「字段这一横条里该长成什么样」,不是多出第八种容器。 + * + * `cols={N}`(2026-11 第七轮):**三个以上同类字段并排时必须是栅格**,不再是 flex-wrap + * 自然排列。自然排列下每个 inline 字段按「标签宽 + 控件宽」定尺,标签字数不一样 + * (状态 / 素材情况 / 排序)盒子就参差,同排控件的右边缘各在一个位置上—— + * 资产库那条筛选条实测 330 / 170 / 170 / 142 / 177。铺成 Row·Col 之后 + * 列边界由栅格给,控件列跟着格子伸缩,同排右边缘必然对齐。 + * 只有「几颗按钮 / 一个字段 + 动作」这种杂项横条才留在自然排列。 */ -export function Ctlbar({ children, className, as = 'div' }: { +export function Ctlbar({ children, className, as = 'div', cols }: { children: ReactNode; className?: string; as?: 'div' | 'nav' | 'section' + /** 这一条铺成 N 等分栅格(窄屏按 ROW_STEPS 自动降列);不写=按钮/杂项横条,自然排列 */ + cols?: 2 | 3 | 4 | 5 | 6 }) { return ( - - {children} - + {cols ? ( + + {toCols(children, colSpans(cols, undefined, ROW_STEPS[cols] || []), 'min-w-0')} + + ) : ( + + {children} + + )} ) } +/** + * 同一组的**可枚举选项**(出片预设、画质档位…)=等宽格子,不是 chip 流。 + * + * 症状:出片预设用 ChipBar,6 个预设宽度 59–168 全凭文案长短,折行点随文案漂移, + * 第二行右侧空出一段,读者没法用「第几行第几个」定位,也数不清选了几个。 + * 做法:选项是有限集合就是栅格——标签在上、每格等宽、胶囊撑满格子, + * 选中态(CheckableTag)保持不变,只是坐在格子里。 + * 与 ChipBar 的分工:**筛已有内容**(标签云、状态快切)用 ChipBar 的胶囊流; + * **从一组固定值里挑**(预设 / 档位 / 模板)用 OptionGrid。 + */ +export function OptionGrid({ children, cols = 3, label, className, hint }: { + children: ReactNode; cols?: 2 | 3 | 4; label?: ReactNode; className?: string; hint?: ReactNode +}) { + return ( +

+ {(label || hint) && ( +
+ {label && {label}} + {hint && {hint}} +
+ )} + + + {toCols(children, colSpans(cols, undefined, ROW_STEPS[cols] || []), 'min-w-0 nex-opt-cell')} + + +
+ ) +} + /** * 卡片 / 列表行 / 抽屉段落末尾的动作行:横排、换行、间距 8,档位由容器下发(24)。 * @@ -210,9 +255,15 @@ export function FormGrid({ children, className }: { children: ReactNode; classNa return
{children}
} -/** 每行 N 个字段时的降列节奏:档位名就是 antd Grid 的断点,站内不再有 900/1100 这种私有宽度 */ +/* 每行 N 个字段时的降列节奏:档位名就是 antd Grid 的断点,站内不再有 900/1100 这种私有宽度。 + ⚠ 档位按**正文宽**取,不是按视口宽:侧栏占 224(≤md 折叠成 64)+ 内容内边距 32, + 768 视口的正文只有 512。原先 5 等分在 md 档给到 3 列,实测每格 158—— + 「素材类型」的标签 69 之后只剩 69 给下拉,选中值「全部类型」77px 被省略号裁成 53px + (visualcheck 768 档 /assets 三条红灯)。整体降一档后 ≤1600 四列、≤1200 三列、 + ≤992 两列、≤576 单列,最窄的一格也有 231px。 */ const ROW_STEPS: Record = { 2: [{ at: 'sm', cols: 1 }], + 5: [{ at: '2xl', cols: 4 }, { at: 'xl', cols: 3 }, { at: 'lg', cols: 2 }, { at: 'sm', cols: 1 }], 3: [{ at: 'md', cols: 2 }, { at: 'sm', cols: 1 }], 4: [{ at: 'lg', cols: 3 }, { at: 'md', cols: 2 }, { at: 'sm', cols: 1 }], 6: [{ at: 'xl', cols: 4 }, { at: 'lg', cols: 3 }, { at: 'md', cols: 2 }, { at: 'sm', cols: 1 }] diff --git a/frontend/src/components/ui/Page.tsx b/frontend/src/components/ui/Page.tsx index d70ae9c..1a1c446 100644 --- a/frontend/src/components/ui/Page.tsx +++ b/frontend/src/components/ui/Page.tsx @@ -17,9 +17,12 @@ * (26 处调用),antd Row 是 24 等分栅格,两者不是一个东西; * 这里把 antd 的那对引进来叫 AntRow/AntCol,铺列由本文件的 Layout 负责。 */ -import type { CSSProperties, ReactNode } from 'react' -import { Avatar, Col as AntCol, Divider, Flex, Row as AntRow, Typography } from 'antd' +import { type CSSProperties, type ReactNode } from 'react' +import { useNavigate } from 'react-router-dom' +import { Avatar, Breadcrumb as AntBreadcrumb, Col as AntCol, Divider, Flex, Row as AntRow, Typography } from 'antd' import { cn } from '../../lib/cn' +import { ActionGroup } from './Controls' +import { Clamp } from './Table' import { Panel } from './Panel' import { splitSpans, type GridCollapse } from './grid' @@ -122,23 +125,73 @@ const WRAP_ACTIONS = 'max-lg:w-full max-lg:[&>button]:flex-1' * 标题只有一层中文——旧站在标题上方另加一行全大写英文眉标,切不到英文, * 只是装饰,现在整层删掉(见 UI规范 §1)。 */ -export function PageHead({ title, meta, actions, className }: { - title?: ReactNode; meta?: ReactNode; actions?: ReactNode; className?: string +/** + * 页头 = 页面身份 + 页面级主操作。 + * + * 口径(2026-11 第四轮 · 用户第 1 条):**内容页的标题和主按钮只在这里出现一次**。 + * 以前项目子页没有页头,标题写在第一张卡的卡头里(「资产管理」「分镜工作台」), + * 主按钮又写在页签条右端或某张卡的卡头右端,读者要在一堆卡头里找那颗主按钮; + * 于是同一个动作在两个页面分别位于「页签右侧 / 卡头右侧 / 表单末尾」三处。 + * 分工(写进 UI规范 §2): + * PageHead 只放**整页成立**的动作(新建、入队、批量放行、开始导出); + * PanelHead 只放**离开这一块就不成立**的动作(某张表的导出、某个表单的保存); + * Tabs 的右端不再放按钮(页签是「看哪一份」,按钮是「做一件事」,两者同排必然打架)。 + * sub:一句话说明这一页的职责,替代以前写在卡头里的长段说明文字。 + * 宽度限 72ch:整屏宽的次要说明在 2560 上会拉成一条读不回行的横线。 + */ +export function PageHead({ title, sub, meta, actions, className }: { + title?: ReactNode + /** 标题下方的一句话职责说明(12px 次要色) */ + sub?: ReactNode + /** 标题上方一行:返回链接 / 只读状态(渲染在标题之前) */ + meta?: ReactNode + actions?: ReactNode + className?: string }) { return ( - + className={cn('mb-5 min-w-0 max-lg:items-start', className)}> + {meta && {meta}} {title && ( {title} )} + {sub && ( + {sub} + )} - {actions && {actions}} + {actions && {actions}} ) } +/** + * 面包屑 = antd Breadcrumb(层级导航的唯一实现)。 + * + * 症状:项目子页顶部写着「← 项目总览 + 状态 Tag + 当前节点 Tag」, + * 这三样在应用顶栏的流程控制台里全都有,等于同屏两遍项目信息。 + * 做法:外壳只留一条面包屑(项目总览 / 项目名)表达「我在哪个项目里」, + * 状态、进度、当前节点交给顶栏那一条,页面不再重复。 + * 为什么 items 收字符串/对象而不是 ReactNode:页面不能 import antd(规范 R8), + * 跳转由组件内部 useNavigate 完成,页面只给 { label, to }。 + */ +export function Breadcrumb({ items, className }: { + items: { label: ReactNode; to?: string }[] + className?: string +}) { + const navigate = useNavigate() + return ( + ({ + key: String(it.to ?? it.label), + title: it.to + ? { e.preventDefault(); navigate(it.to!) }}>{it.label} + : {it.label} + }))} /> + ) +} + /** * 页面级工具条 = **只有卡头的那张 Card**(antd Card title + extra)。 * @@ -195,11 +248,17 @@ export function Between({ children, className, tight }: { children?: ReactNode; } /** 行内错误回显(.error):12px 红字,紧贴它说明的那个控件,不占提示条的位置 */ -export function ErrorText({ children, className }: { children?: ReactNode; className?: string }) { +export function ErrorText({ children, className, lines, title }: { + children?: ReactNode; className?: string + /** 表格单元格里必须给(R17 表格行高纪律):一条 60 字的报错能把整行顶到 100px 以上 */ + lines?: 1 | 2 + /** 配合 lines 的悬停全文:传拼接好的纯文本 */ + title?: string +}) { if (!children) return null return ( - {children} + {lines ? {children} : children} ) } @@ -220,7 +279,7 @@ export function Sub({ children, className }: { children?: ReactNode; className?: * 页签只存在于页面内部(kit 的 ),这一层就是普通的正文纵排。 */ export function PageStack({ children, className }: { children?: ReactNode; className?: string }) { - return {children} + return {children} } /** diff --git a/frontend/src/components/ui/Panel.tsx b/frontend/src/components/ui/Panel.tsx index 7674ad1..b52e7b5 100644 --- a/frontend/src/components/ui/Panel.tsx +++ b/frontend/src/components/ui/Panel.tsx @@ -7,6 +7,7 @@ * 卡头没有分隔线、指标卡数字与 antd 的 Statistic 差 6px、栅格按私有断点降列。 * 做法:**布局也交给 antd**。Panel=Card(卡头用 Card 自己的 title/extra)、 * Stat=Card+Statistic、Grid/StatGrid=Row+Col(断点用 antd Grid 的 xs…xxl)、 + * Info=Descriptions(只读回显:标签列 + 值列,替代「灰盒 + 标签在上」那种假输入框)、 * Notice=Alert、Empty=Empty、ProgressBar=Progress、Divider=Divider。 * 页面继续写 正文:Panel 会把作为第一个子节点的 * PanelHead **吞进 Card 的 title/extra**,所以 52 处调用一行不用改, @@ -17,7 +18,7 @@ */ import { Children, isValidElement, type CSSProperties, type ReactNode } from 'react' import { - Alert, Card, Divider as AntDivider, Empty as AntEmpty, Flex, + Alert, Card, Descriptions, Divider as AntDivider, Empty as AntEmpty, Flex, Progress, Row, Spin, Statistic, Typography } from 'antd' import { cn } from '../../lib/cn' @@ -140,6 +141,10 @@ export function SectionTitle({ children, action, className, title }: { * 病灶:同一个统计数字长出过三套皮肤——概览/仪表盘用自绘卡、资产库自己写了 * 一张带渐变的 MetricCard、分镜顶栏又写了一套更小的 Metric。 * 做法:数字与标题的度量交还 antd(.ant-statistic 的 title 14 / content 24)。 + * 2026-11 第六轮(用户第 2 条):**卡面不再有任何底纹**。上一轮压在卡面上的 + * 径向渐晕 + 135° 斜纹 + 84px 水印,四张并排时连成一片脏灰,数字反而不显眼; + * 识别度改由数字左侧那只 32px 色块承担(底色与图形同取本卡语义色,见 app.css + * `.nex-stat-mark`)——「配套的色块和图标」就是它的唯一装饰。 * 2026-11 整删 inline 档:sticky 工具条里的「一列小数字」只活过分镜顶栏一处, * 它和同一排里的 antd 按钮高度打架,现在那一排改用 的一行摘要。 * 指标数字从此只有 card 一种皮肤(栅格用 StatGrid)。 @@ -153,18 +158,30 @@ const STAT_TONE: Record = { warn: 'var(--ant-color-warning)', bad: 'var(--ant-color-error)' } -export function Stat({ label, value, hint, className, style, tone, active, onClick, title, valueSize = 'num' }: { +export function Stat({ label, value, hint, className, style, tone, active, onClick, title, icon, valueSize = 'num' }: { label: ReactNode; value: ReactNode; hint?: ReactNode; className?: string; style?: CSSProperties + /** + * 这一张卡的语义色:数值、左侧色块、色块底三处同源。 + * 不写 = 主色;ok/warn/bad = antd 对应的语义色族(app.css `.nex-stat`)。 + */ tone?: StatTone /** 命中当前筛选:点亮描边 + 标题 */ active?: boolean /** 整张卡是筛选入口 */ onClick?: () => void title?: string + /** + * 识别图形(R16.2 改口径):渲染成数字左侧那只 32px 色块里的图标, + * 「这格数的是镜头 / 任务 / 成本」先由图形说一遍,读者扫一眼就定位到要的卡。 + * 必须是 components/icons 登记表里的图形(规范 §11);不传就没有色块,正文满宽。 + */ + icon?: ReactNode /** `num`(默认)=纯数字;`title`=放的是一段名字(模型控制台的「当前默认大模型」) */ valueSize?: 'num' | 'title' }) { const color = tone ? STAT_TONE[tone] : undefined + /* 色块主色:没有 tone 的统计卡用主色,有 tone 的用同一条语义色(数值 / 色块 / 色块底同源) */ + const tint = tone ? STAT_TONE[tone] : 'var(--ant-color-primary)' const labelNode = {label} /* value 里的 是「次要的一半」(9/47 里的分母、/ 未设置),样式只在这里定义一次 */ const valueStyle: CSSProperties = { @@ -191,14 +208,23 @@ export function Stat({ label, value, hint, className, style, tone, active, onCli formatter={isText ? undefined : () => value} valueStyle={valueStyle} /> ) return ( - - {stat} - {hint && ( - {hint} - )} + + {/* 色块与正文并排:色块顶对齐标题(它标的是「这一格是什么」,不是数字), + 说明文字缩进到正文列里,不许钻到色块底下。 */} + + {icon ? {icon} : null} +
+ {stat} + {hint && ( + {hint} + )} +
+
) } @@ -226,14 +252,27 @@ export function Grid({ children, cols = 4, gap = 12, min, oneAt, steps, classNam } /** - * 指标卡栅格:列数与降列节奏都由容器声明,页面不写 @media。 - * 默认 4 列 → ≤992 两列 → ≤576 一列(antd 断点,不再用私有的 900/560)。 + * 指标卡栅格:**列数默认等于实际卡片数**(第 2 条「不同页面不需要固定的统计卡片数量」)。 + * + * 症状:`cols` 以前固定 4,页面只有三张卡时右边空出一格,五张卡时第五张孤零零掉到 + * 第二行——同一站内的指标区因此有三种「数不完的最后一片空白」。 + * 做法:不写 cols 就按子节点数排布(除不尽 24 的列数由 grid.tsx 的 colSpans 转成 + * flex 百分比,五张卡就是五等分一行),最多 6 列,超出的自己折行; + * 卡片在窄屏按比例降列(≤992 两列 → ≤576 一列)。 + * 为什么要保留 cols 参数:侧栏里的指标区(导出与成本那张半宽卡)必须写死 2 列—— + * 那里满屏断点量出来的是视口宽度,不是容器宽度。 */ -export function StatGrid({ children, cols = 4, steps, className, gap = 12 }: { +export function StatGrid({ children, cols, steps, className, gap = 12 }: { children: ReactNode; cols?: number; steps?: StatStep[]; className?: string; gap?: number }) { + const count = Children.toArray(children).filter(Boolean).length const merged: StatStep[] = steps || [{ at: 'lg', cols: 2 }, { at: 'sm', cols: 1 }] - return {children} + /* 同排统计卡必须等高:卡片自己 120、旁边那张因为多一行说明 136, + 一排四种底边就是肉眼可见的参差(第 4 轮体检 /models 实测)。 */ + return ( + .ant-col>*]:h-full', className)}>{children} + ) } /** 进度条:antd Progress(站内只有这一条;bad=异常态用 antd 的 exception 色) */ @@ -303,9 +342,13 @@ export function Notice({ children, description, danger, className, onClose, type } /** 数据回显(.val)与条件告警(.linehint):规范 §7 G2 —— 版面不放成段解释文字 */ -export function Value({ children, muted, className }: { children: ReactNode; muted?: boolean; className?: string }) { +export function Value({ children, muted, className, title }: { + children: ReactNode; muted?: boolean; className?: string + /** 悬浮说明:口径 / 数据来源这种「不该占版面但读者会问」的第二层,走原生 title(G2) */ + title?: string +}) { return ( - {children} ) @@ -354,7 +397,10 @@ export function ExtLink({ href, children, className, download }: { export const BLOCK_TONE: Record<'default' | 'info' | 'ok' | 'warn' | 'bad', string> = { default: 'border-border-secondary bg-fill-tertiary', info: 'border-info-border bg-info-bg', - ok: 'border-success-border bg-success-bg', + /* 「ok」这类信息块以前铺 antd 的 success 浅绿底——第 4 轮用户点名「浅绿色标签全部 + 换到新的颜色设计」。新口径与 一致:中性底纹 + 语义描边, + 绿色只作为「这条信息是好消息」的线索,不再当大面积底色用。 */ + ok: 'border-success-border bg-fill-tertiary', warn: 'border-warning-border bg-warning-bg', bad: 'border-error-border bg-error-bg' } @@ -380,6 +426,101 @@ export function Block({ children, tone = 'default', align = 'center', vertical, ) } +/** + * 只读回显(.nex-info)= antd Descriptions:**站内所有「这条记录长什么样」的 + * 属性回显只有这一种写法**(规范 R16.3)。 + * + * 症状(用户截图指的那类块,原话「这种设计都是有问题的」):回显写成 + * `Block tone=default vertical` 的灰盒——label 在上、值在下、四周描边, + * 和它旁边真正的输入框长得一模一样;用户去找可点的框,框里却没有可改的东西。 + * 同一屏里另一批回显写成「label:值」的裸文本行,两种读法各占一半。 + * 做法:一律 Descriptions(bordered + size=small + colon=false): + * label 列由 antd 上 colorFillAlter 底纹(底纹来自语义色,不新增色值), + * 值列左对齐长值折行,多属性并排走 column 分栏——一屏放得下的绝不多占一行。 + * 为什么不用灰盒:灰盒在 antd 语言里是「输入区的底色」,回显用它是借错了语义; + * Descriptions 就是 antd 为「详情回显」准备的组件,明暗两档、圆角、分隔线 + * 全都跟主题走,不需要再养一套私有皮肤(度量集中在 app.css `.nex-info`)。 + */ +export type InfoItem = { + key?: string + label: ReactNode + value: ReactNode + /** 等宽回显(路径 / id / 枚举码 / 密钥),走 kit 的 Mono */ + mono?: boolean + /** 跨几列(与 antd Descriptions 的 span 同名同义):长地址、一段说明用 span 顶满 */ + span?: number +} + +/** 分栏数:固定几列,或按断点降列(窄屏/抽屉里 3 列会挤成竖排,交给 antd 自己降) */ +export type InfoColumns = number | Partial> + +const INFO_BP: ('xs' | 'sm' | 'md' | 'lg' | 'xl' | 'xxl')[] = ['xs', 'sm', 'md', 'lg', 'xl', 'xxl'] + +/** + * 档位向上补齐:写到的那一档=它右边所有档的值。 + * + * 症状:antd Descriptions 内部把 column 与内置 {xs:1,sm:2,md:3,lg:3,xl:3,xxl:3} 合并, + * 再由宽到窄取第一个命中的档位。于是只写 `{ xs: 2, sm: 3, lg: 5 }` 的回显, + * 1440 命中的是内置的 xl=3——**声明的 5 列在桌面上永远不生效**; + * 卡片里的 `{ xs: 1, sm: 2 }` 同理,宽屏变成没声明过的 3 列,挤成竖排。 + * 做法:把没写的右档填成最近一次声明的值,页面只需要写「从哪一档开始降到几列」。 + * 为什么在容器补:12 个页面写的都是「窄屏少列、宽屏多列」这一个意图, + * 让每个页面记住 antd 的默认表并要求它写满六档,是规范在给自己找麻烦。 + */ +export function fillInfoColumns(column: InfoColumns): InfoColumns { + if (typeof column === 'number') return column + const out: Partial> = { ...column } + let last: number | undefined + INFO_BP.forEach((bp) => { + if (out[bp] !== undefined) last = out[bp] + else if (last !== undefined) out[bp] = last + }) + return out +} + +export function Info({ items, column = 1, className, title, extra }: { + items: (InfoItem | null | undefined | false)[] + column?: InfoColumns + className?: string + /** 这一组回显的标题(antd Descriptions 的 title,走主题字号,不用页面自己写 h4) */ + title?: ReactNode + /** 标题行右端动作(antd 5.29 Descriptions.extra):与标题同一行,不再另起一排 */ + extra?: ReactNode +}) { + const real = items.filter(Boolean) as InfoItem[] + if (!real.length) return null + return ( + ({ + key: it.key ?? String(i), label: it.label, span: it.span, + children: it.mono ? {it.value} : it.value + }))} /> + ) +} + +/** + * Info 里的计数值(.nex-info 的 number 档):等宽数字 + 可选单位。 + * + * 症状:回显表里的 0 和 3 一样粗一样亮,一屏八个数字读不出哪个要管; + * 这套「非零才上语义色」的口径原先写在调度中心页面里(局部函数 cnt), + * 质检页要做同一个块只能再抄一遍——规范 §13.1 要求口径只有一份。 + * 做法:0 一律降到 colorTextTertiary(「没有要处理的」),非零才按 tone 上 + * success / warning / error;单位(条 / 次)比数字小一档、跟着降灰。 + * 为什么是组件不是常量函数:它出现在 12 个页面的 items 里,JSX 写法与 Info 一致。 + */ +const COUNT_TONE: Record<'ok' | 'warn' | 'bad', string> = { ok: 'text-success', warn: 'text-warning', bad: 'text-error' } + +export function Count({ n, unit, tone }: { n?: number; unit?: string; tone?: 'ok' | 'warn' | 'bad' }) { + const num = Number(n) || 0 + return ( + + {num} + {unit ? {unit} : null} + + ) +} + /** * 卡片行(.cardrow):标题 + 说明 + 右侧动作,列表里重复项的统一骨架。 * diff --git a/frontend/src/components/ui/Status.tsx b/frontend/src/components/ui/Status.tsx index a3ec4de..2fb6c24 100644 --- a/frontend/src/components/ui/Status.tsx +++ b/frontend/src/components/ui/Status.tsx @@ -20,9 +20,24 @@ export type TagSize = 'sm' | 'md' export const TAG_DENSE = 'nex-tag-dense' /** - * 语义色调:一一对应 antd 的四个语义色(success / error / warning / info + colorPrimary), - * 每一档取「底纹 -bg / 描边 -border / 文字」三个 token,页面不许自己上色。 + * 语义色调:一一对应 antd 的四个语义色(success / error / warning / info + colorPrimary)。 * 旧规范里的 pink / sky 没有任何调用点,跟着 palette.ts 一起删了。 + * + * 2026-11 第七轮 · 用户「项目中的浅绿色标签都要处理到新的颜色设计上」: + * 症状:整站的「完成 / 已交付 / 合格 / 已启用」标签铺满 antd 的 success 浅绿底 + * (light #f6ffed 底 / #52c41a 字)。项目列表 12 行里有 9 行是绿块, + * 质检页一排六个计数也是绿块——绿色本来是「成功」的语义,量一大就变成 + * 整屏的品牌残留色,和新主色(antd 出厂蓝)打架,也把真正要看的数字压住了。 + * 做法:**标签不再用语义色铺底**。底色全站只有一档中性 fill-tertiary(= antd + * 自己 Tag bordered=false 的默认底),文字用正文色,语义只留在**标签头部 + * 那颗 6px 圆点**上(Linear / GitHub / Vercel 的状态点同一套读法): + * 扫表时靠点的颜色分「绿=完成 / 红=失败 / 橙=需注意 / 蓝=进行中」, + * 面积上不再有任何彩色块。 + * 为什么语义底块( / Alert 那类整段提示)不改:那是 antd Alert 的语义, + * 一条屏最多一个,铺底是它表达「这是一条通知」的方式;标签是行内小构件, + * 一屏十几个,只能靠点。 + * 上色口径不变:色值仍只有 `--ant-color-<语义>` 一个来源(CSS 变量在 app.css + * `.nex-tag-dot`),页面依旧不准自己写颜色。 */ export type TagTone = 'default' | 'ok' | 'bad' | 'warn' | 'info' | 'accent' | 'mono' @@ -40,14 +55,15 @@ export function Tag({ tone = 'default', size = 'md', icon, children, className, title?: string }) { const v = TONE_VARS[tone as keyof typeof TONE_VARS] - // 默认档也要有底纹:统计信息块「有底」才读得出「这是一块回显」而不是一个待点的按钮; - // 语义色档走各自的 -bg / -border,两层互不影响(Tag 与 Badge 同一套尺子)。 - const style = v - ? { background: `var(--ant-color-${v}-bg)`, borderColor: `var(--ant-color-${v}-border)`, color: `var(--ant-color-${v})` } - : { background: 'var(--ant-color-fill-tertiary)', borderColor: 'var(--ant-color-border-secondary)' } + // 只读标签一律无边框(R16.3):底纹负责「这是一块回显」,描边负责「这可以点」, + // 两者不能同时出现在一个不能点的东西上。 + // 语义档只把颜色交给 --nex-tag-tint,由 .nex-tag-dot 上的一点承载(见上面的口径注释)。 + const style = v ? { ['--nex-tag-tint' as string]: `var(--ant-color-${v})` } : undefined return ( - + + {v ? : null} {icon && {icon}} {children} @@ -97,13 +113,11 @@ export function Badge({ children, tone = 'default', size = 'md', className }: { className?: string }) { const v = TONE_VARS[tone as keyof typeof TONE_VARS] - // 默认档也要有底纹:统计信息块「有底」才读得出「这是一块回显」而不是一个待点的按钮; - // 语义色档走各自的 -bg / -border,两层互不影响(Tag 与 Badge 同一套尺子)。 - const style = v - ? { background: `var(--ant-color-${v}-bg)`, borderColor: `var(--ant-color-${v}-border)`, color: `var(--ant-color-${v})` } - : { background: 'var(--ant-color-fill-tertiary)', borderColor: 'var(--ant-color-border-secondary)' } + // 数字气泡与标签同一套皮肤:中性底 + 语义色只给文字(计数本身就是要读的东西, + // 不再补一颗点,否则「12」前面多个圆点会被读成状态)。 + const style = v ? { color: `var(--ant-color-${v})` } : undefined return ( - + {children} ) diff --git a/frontend/src/components/ui/Steps.tsx b/frontend/src/components/ui/Steps.tsx index 904e337..187145d 100644 --- a/frontend/src/components/ui/Steps.tsx +++ b/frontend/src/components/ui/Steps.tsx @@ -35,9 +35,11 @@ export function nodeHint(node: any): string { } /* 序号圆点的填色:实心主色 + 白字(4.6:1)成立,实心 success + 白字不成立 - (light #52c41a / white = 2.3:1,dark #95de64 / white = 1.8:1), - 所以「完成」这一档取绿色族的浅底 + 主色字——正是 antd Tag color="success" - 与站内 用的那三个 token,不新造档位。 + (light #52c41a / white = 2.3:1,dark #95de64 / white = 1.8:1)。 + 2026-11 第七轮:「完成」这一档也不再铺 success 浅底——用户要求全站的浅绿标签 + 收进新配色,12 格的流程条如果每格底上都是一块浅绿,等于把这条 rail 刷回旧品牌。 + 现在底是中性 fill-secondary,绿只留给**对勾本身与 done/total 的数字**(字形级着色, + 和 的「中性底 + 语义点」是同一条规矩)。 「进行中」是实心主色(antd 的 processing 就是主色蓝),和完成一眼分得开。 整卡的底色口径(2026-11 第四轮改的,别再改回「完成=整块绿」): @@ -50,7 +52,7 @@ export function nodeHint(node: any): string { · **failed** = 容器底 + 红边;**pending** = 容器底 + 更淡的边 + 70% 不透明度。 「完成了多少」由一串绿勾 + 下面的 `FlowCaption`(已完成 x / y)负责,不靠铺面积。 */ const NUM: Record = { - done: 'bg-success-bg text-success', + done: 'bg-fill-secondary text-success', active: 'bg-primary text-on-primary', failed: 'bg-error text-error-bg', pending: 'bg-fill-secondary text-text-tertiary' diff --git a/frontend/src/components/ui/Table.tsx b/frontend/src/components/ui/Table.tsx index 8e125b9..545b8a5 100644 --- a/frontend/src/components/ui/Table.tsx +++ b/frontend/src/components/ui/Table.tsx @@ -33,9 +33,41 @@ export type Columns = NonNullable['columns']> /** * 长文本列:允许折行而不是把整张表顶宽(旧 cellWrap)。 * 用法是 column.className——antd 会把它落到该列的每个单元格上。 + * + * 但它只解决「不顶宽表格」,不解决「不撑高行」:一句 90 字的质检结论 + * 在 464px 的列里仍要折 7 行,整张表一屏只剩 4 行可读。封顶交给 。 */ export const cellWrap = 'max-w-[340px] whitespace-normal leading-normal wrap-anywhere' +/** + * 单元格里读不完的长文案:最多折两行,剩下的收进原生 title。 + * + * 症状(第 27 轮全站表格体检):审核留痕「说明」464px 被一条质检长文顶到 255px 行高, + * 调度清单「说明」只剩 112px 时同一句话折成 8 行(行高 168px)—— + * 列宽和文案长度是两头堵,只调列宽永远调不完。 + * 做法:列宽先按「长文列 ≥ 200px」分配,文案本身用本组件封顶两行, + * 完整内容挂原生 title,悬停看全。 + * 为什么不用 antd 的 column.ellipsis:它只支持单行,长说明折成一行等于没显示; + * 也不为这一点事再包一层 Tooltip(R8:页面不 import antd,包组件要给全站用才值)。 + */ +export function Clamp({ children, title, lines = 2, className }: { + children?: ReactNode + /** 悬停看全文:传拼接好的纯文本(组件猜不到调用方拼了什么) */ + title?: string + /** 封顶行数:1 = 单行省略(标题类),2 = 两行省略(说明/错误类) */ + lines?: 1 | 2 + className?: string +}) { + if (children === null || children === undefined || children === '') return null + return ( +
+ {children} +
+ ) +} + type TableExtra = { /** 列定义(antd Columns) */ columns: Columns diff --git a/frontend/src/components/ui/grid.tsx b/frontend/src/components/ui/grid.tsx index 03bd69f..1e13f5f 100644 --- a/frontend/src/components/ui/grid.tsx +++ b/frontend/src/components/ui/grid.tsx @@ -10,7 +10,7 @@ * 为什么单独一个文件:Panel(Grid/StatGrid)、Page(Layout/Stack)、Controls * (FormRow)都要铺列,共用一份换算才不会三处三种降列节奏。 */ -import { Children, type ReactNode } from 'react' +import { Children, Fragment, isValidElement, type ReactNode } from 'react' import { Col } from 'antd' export type Bp = 'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'xxl' @@ -25,28 +25,46 @@ export type GridStep = { at: GridCollapse; cols: number } /** 指标卡的降列档位与通用栅格同一套 */ export type StatStep = GridStep -/** 列数 + 降列档位 → antd Col 的六个断点值 */ -export function colSpans(cols: number, oneAt?: GridCollapse, steps?: GridStep[]): Partial> { - const base = Math.max(1, Math.round(24 / Math.max(1, cols))) - const out: Partial> = {} - BP_ORDER.forEach((bp) => { out[bp] = base }) +/** + * 一个断点上怎么铺:能整除 24 就照旧给 span(和站内其它栅格同一把尺子); + * 除不尽(5 张统计卡这种「一行就得放完」的)必须改用百分比 flex—— + * span 只能取整数,24/5 取整成 5,5×5=25 > 24,第 5 张会被整张挤到下一行, + * 页面就多出一个孤零零的半行(用户说的「能一行放完的别分两行」正是这一枪)。 + */ +export type ColAt = { span?: number; flex?: string } + +/** 列数 → antd Col 的六个断点值(值可以是 span 数,也可以是 flex 声明) */ +export function colSpans(cols: number, oneAt?: GridCollapse, steps?: GridStep[]): Record { + const at = (n: number): ColAt => { + const c = Math.max(1, Math.min(24, Math.round(n))) + const span = 24 / c + return Number.isInteger(span) ? { span } : { flex: `0 0 ${(100 / c).toFixed(4)}%` } + } + const out = {} as Record + BP_ORDER.forEach((bp) => { out[bp] = at(cols) }) const rules = [ ...(steps || []).map((s) => ({ at: s.at as string, cols: s.cols as number })), ...(oneAt ? [{ at: oneAt as string, cols: 1 }] : []) ].sort((a, b) => (AT_MIN[b.at] ?? 0) - (AT_MIN[a.at] ?? 0)) // 由宽到窄,窄档后覆盖 for (const r of rules) { const limit = AT_MIN[r.at] ?? 0 - const span = Math.max(1, Math.round(24 / r.cols)) - BP_ORDER.forEach((bp) => { if (BP_MIN[bp] < limit) out[bp] = span }) + BP_ORDER.forEach((bp) => { if (BP_MIN[bp] < limit) out[bp] = at(r.cols) }) } return out } /** 把 N 个子节点铺进一行栅格(Grid / StatGrid / FormRow / Layout / Stack 共用) */ -export function toCols(children: ReactNode, spans: Partial>, colClass?: string): ReactNode[] { - return Children.toArray(children).map((child, i) => ( - {child} - )) +export function toCols(children: ReactNode, spans: Record, colClass?: string): ReactNode[] { + /* Fragment 必须先摊平:`{cond && <>字段A 字段B}` 在 Children.toArray 里只是**一个**孩子, + A、B 会被塞进同一格竖排,这一行栅格当场少一列(模型抽屉的 3+1 换行就是这么来的)。 + 条件分组要按「每个字段各占一格」算,所以这里递归展开 Fragment 再铺列。 */ + const cells: ReactNode[] = [] + const walk = (node: ReactNode) => Children.toArray(node).forEach((child) => { + if (isValidElement(child) && child.type === Fragment) walk((child.props as { children?: ReactNode }).children) + else cells.push(child) + }) + walk(children) + return cells.map((child, i) => {child}) } /** diff --git a/frontend/src/styles/app.css b/frontend/src/styles/app.css index b2de3c0..d240fab 100644 --- a/frontend/src/styles/app.css +++ b/frontend/src/styles/app.css @@ -135,7 +135,16 @@ textarea) { width: 100%; min-width: 0 } /* ── 卡片(Panel = antd Card):标题与副标题是中文短语,默认 ellipsis 会裁掉半句 ── */ .nex-panel .ant-card-head-title { white-space: normal; overflow: visible; text-overflow: clip } -.nex-panel .ant-card-extra { white-space: normal } +/* 标题条同理:中文短语不许被 ellipsis 裁掉半句,right 那一块也按内容折行。 + 卡头的 right 只是「一个计数 / 一句下一步」,长起来时不许把标题压成竖排。 + 症状(430 档 /projects/10 的「流程进度」):right 那句「下一步:时间线合成 + 配音/字幕/混音 — …」 + 要 400px 以上,而 antd 的 head 是不换行的 flex,标题只剩 30px ⇒ 「流程进度」一个字一行。 + 做法:head 允许 wrap、right 最宽 100%——宽屏照旧同一行读完,窄屏整句掉到第二行。 */ +/* ⚠ 卡头的 flex 容器是 .ant-card-head-wrapper,不是 .ant-card-head(后者只是块级壳), + 写在壳上等于没写。extra 默认 flex-shrink:1 会被压成一条竖河,这里让它按内容定尺、 + 放不下就整块掉到第二行。 */ +.nex-panel .ant-card-head-wrapper { flex-wrap: wrap; row-gap: var(--ant-margin-xxs) } +.nex-panel .ant-card-extra { flex-shrink: 0; max-width: 100% } /* Card 的 body 不是 flex 子项,里面的 Row/Col 想收缩必须先从 min-width:auto 解放出来 */ .nex-panel .ant-card-body { min-width: 0 } .nex-panel .ant-card-body > * { min-width: 0 } @@ -148,6 +157,12 @@ textarea) { width: 100%; min-width: 0 } 自绘的那几处(checkable tag 的高度)读不到 ConfigProvider,只能靠它对齐 到同一个 controlHeightSM。 */ .nex-ctlbar { margin-block-end: var(--ant-margin-sm) } +/* 工具条铺成栅格之后,宽度归格子管:控件列吃掉标签以外的全部宽度, + inline 字段上写的 width="narrow|wide"(--nex-ctl-w)在这里让位给列宽, + 同一行的控件右边缘因此必然对齐;胶囊选项铺进格子时同理要撑满。 */ +.nex-ctlbar-grid > .ant-col { display: flex; align-items: center; gap: var(--ant-margin-xs); min-width: 0 } +.nex-ctlbar-grid > .ant-col > .ant-form-item { flex: 1 1 auto; min-width: 0 } +.nex-ctlbar-grid .nex-field-inline .ant-form-item-control { flex: 1 1 auto; width: auto; min-width: 0 } /* ── 下拉面板:宁可临时压住右边内容,也不让用户盲选 ──────────────────── 症状:时间线 / 交付页的字幕模式、配音来源这些选项,文案本身就是说明 @@ -190,6 +205,10 @@ textarea) { width: 100%; min-width: 0 } /* 禁用:5.29 的 CheckableTag 没有 disabled,语义由 Controls.Chip 贴 inline style, 这里只负责把「点不动」这件事在光标上也说一遍 */ .nex-chip.is-off.ant-tag { cursor: not-allowed } +/* 胶囊铺进 OptionGrid 的等宽格子:宽度交给格子,文字居中。 + 这条必须排在 .nex-chip.ant-tag 之后——两条特异度相同(类+类), + 写在前面会被上面的 display:inline-flex 覆盖回 inline-block,图标与文字的间隙就散了。 */ +.nex-opt-cell .ant-tag { margin-inline-end: 0; width: 100%; justify-content: center } /* 多选回显 = antd Tag(closable):与 Tag 同度量,色调走 primary 那一族 */ .nex-tag-chip.ant-tag { @@ -228,6 +247,22 @@ textarea) { width: 100%; min-width: 0 } vertical-align: middle; box-sizing: border-box; } +/* 标签的底色只有一档:中性 fill-tertiary(= antd Tag bordered=false 的默认底)。 + 语义色不再铺底(用户第七轮「浅绿色标签都要处理到新的颜色设计上」)——整屏的 + 「完成 / 已交付 / 合格」如果各是一块浅绿,绿色就从语义色变成了第二个品牌色, + 和新主色(antd 出厂蓝)打架,也把数字压住。语义改由头部那颗 6px 圆点承载。 + 色值仍然只有 --ant-color-* 一个来源:点用 --nex-tag-tint(由 Status.Tag 按 tone + 写成 var(--ant-color-success) 等),明暗两档自动跟主题。 */ +.nex-tag.ant-tag { background: var(--ant-color-fill-tertiary); color: var(--ant-color-text) } +.nex-tag-dot { + inline-size: 6px; + block-size: 6px; + flex: none; + border-radius: 9999px; + background: var(--nex-tag-tint, var(--ant-color-text-quaternary)); +} +/* 深色档:fill-tertiary 只有 4% 白,标签在容器上分不出来,抬到 8% */ +html[data-theme='dark'] .nex-tag.ant-tag { background: color-mix(in srgb, var(--ant-color-text) 8%, transparent) } /* 密集档:挂在容器上,不挂在单个标签上 */ .nex-tag-dense { --tag-h: var(--tag-h-sm); @@ -319,3 +354,89 @@ textarea) { width: 100%; min-width: 0 } .anticon 由 antd 自己管尺寸与对齐;这里只兜住一件事——图标被塞进一排 flex 控件时不要当行内盒参与基线计算(老手写 Icon.tsx 时代就靠这条)。 */ .anticon { display: inline-flex; flex: none } + +/* ── 统计卡(Stat = Card + Statistic):纯色卡面 + 配套色块图标 ──────────────── + 症状(2026-11 第六轮 · 用户第 2 条原话「大的统计标签卡还是不美观,不要底纹, + 用配套的色块和图标区分」):上一轮在卡面上压了右上径向渐晕 + 135° 斜纹 + + 右下角 84px 水印图形。四张卡并排时那层纹理连成一片灰,斜纹和水印叠在一起 + 像印刷错位,最该跳出来的数字反而被压住了。 + 做法:卡面就是 antd Card 自己的 colorBgContainer——没有底纹、没有渐变、没有水印。 + 识别度全部交给数字左侧那只 32px 圆角色块:底色 = 本卡语义色 12% 混合, + 图形 = 同一条语义色(--nex-stat-tint 由 Stat 的 tone 决定,默认主色)。 + 四张卡并排时先由色块分出四类,数字回到唯一的视觉重心。 + 为什么深色档单独提一档:12% 的饱和色压在 #141414 上几乎读不出来,提到 18%。 + 为什么用 color-mix 而不是新色值:站内 `#hex` 只许出现在 theme/antd.ts(§2), + 这里按语义色变量比例混合,明暗两档自动跟着主题走,不产生第二套色板。 */ +.nex-stat { --nex-stat-tint: var(--ant-color-primary) } +.nex-stat-mark { + display: flex; + align-items: center; + justify-content: center; + inline-size: 32px; + block-size: 32px; + flex: none; + border-radius: var(--ant-border-radius-lg); + background: color-mix(in srgb, var(--nex-stat-tint) 12%, transparent); + color: var(--nex-stat-tint); + font-size: 17px; +} +html[data-theme='dark'] .nex-stat-mark { + background: color-mix(in srgb, var(--nex-stat-tint) 18%, transparent); +} + +/* ── 只读回显(Info = antd Descriptions):R16.3 ────────────────────────────── + 症状(用户截图:模型卡里「资源地址 / 参考」那只灰盒):回显写成灰底圆角盒 + + label 在上,外面再描一圈边,看着就是一只禁用输入框;而它旁边真有输入框时, + 两者分不清哪个能填。 + 做法:容器换成 antd 为详情回显准备的 Descriptions,皮肤只调三件事—— + ① label 列降一档字号并用 text-tertiary,值列用正文色:主从一眼分得开; + ② label 列给一个最小宽度(可用 --nex-info-label-w 覆盖), + 两列/三列并排时列宽不随字数跳动,扫读才有列感; + ③ 值列 overflow-wrap:anywhere——长地址、长密钥不许把表格顶宽。 + 底纹(label 列的 colorFillAlter)、圆角、分隔线全部沿用 antd,明暗两档自动跟主题。 + 为什么写在 app.css:页面不准 import antd(R8),`.ant-*` 也只准出现在这一层; + 组件级皮肤集中在这里,19 个页面共用一把尺子。 */ +.nex-info.ant-descriptions { width: 100%; min-width: 0 } +.nex-info .ant-descriptions-item-label, +.nex-info .ant-descriptions-item-content { + padding-block: var(--ant-padding-xxs); + padding-inline: var(--ant-padding-sm); +} +.nex-info .ant-descriptions-item-label { + width: var(--nex-info-label-w, auto); + min-width: 5.5em; + color: var(--ant-color-text-tertiary); + font-size: var(--ant-font-size-sm); + font-weight: 400; + white-space: nowrap; +} +.nex-info .ant-descriptions-item-content { + color: var(--ant-color-text); + overflow-wrap: anywhere; +} +/* 深色档:antd 的 colorFillAlter 只有 4% 白,压不出「这一列是标签」的分界,抬到 7% */ +html[data-theme='dark'] .nex-info .ant-descriptions-item-label { + background: color-mix(in srgb, var(--ant-color-text) 7%, transparent); +} +/* 卡内的回显表:卡本身已有描边,表格再描一圈就成了双层框,只留内部网格线 */ +.nex-info-in-card.ant-descriptions .ant-descriptions-view { border: 0; border-radius: 0 } +.nex-info-in-card.ant-descriptions .ant-descriptions-item-label, +.nex-info-in-card.ant-descriptions .ant-descriptions-item-content { border-color: var(--ant-color-fill-secondary) } +.nex-info.ant-descriptions .ant-descriptions-header { margin-block-end: var(--ant-margin-xs) } +.nex-info.ant-descriptions .ant-descriptions-title { font-size: var(--ant-font-size); font-weight: 600 } + +/* ── 正文纵向节奏(PageStack):块与块之间的距离只由父级 gap 给一把尺子 ────── + 症状(2026-11 第五轮 · 用户第 3 条「组件之间的上下、左右边距要合理」): + 同一列里页头自带 mb-5(20)、统计卡自带 mb-4(16)、提示条自带 mb-4(16), + 外层容器又要么不排间距、要么再排一次。实测量出来同一屏里同时存在 + 0 / 8 / 16 / 20 / 36 五种值:用户管理的统计卡与下面的表格卡贴成一块 + (gap 0),质检页页头与下面的计数工具条之间空出 36px 的大空洞。 + 做法:正文列一律走 (antd Flex vertical gap=16),这一条把 + **直接子块**自带的下边距归零——父级 gap 成为这一列唯一的纵向尺子。 + 只管直接子级:块内部(表单、卡身、手册正文)的间距仍归各自的栅格与 Form.Item。 + 为什么用 CSS 而不是从每个页面上删掉 mb-*:同一块内容还要在抽屉、手册正文里复用, + 那些地方没有 gap;「间距归容器」这件事由容器自己声明才收得干净。 */ +.nex-stack > * { margin-block-end: 0 } +/* 页签条自带 16px 下边距(antd .ant-tabs-nav):它在 PageStack 里就是「和下一块的距离」, + 与父级 gap 重复会空出 32px。归零之后页签与正文之间仍是站内那一档 16。 */ +.nex-stack > .ant-tabs > .ant-tabs-nav { margin-block-end: 0 }