内容页页头只剩一个实现:门牌卡改成「菜单同款图标 + 一级标题 + 主操作同排」,眉标删掉

症状:用户第 12 轮原话「内容页 Header 重写,只保留节点名(1 级标题)+ 描述说明。
标题前一个和左侧菜单一致的图标。右侧的主功能入口要对齐」。当时站内有两套页头
(`PageHead` 给全局页、`NodeHead` 给项目七站),七站门牌上还压着一行眉标
「项目环节 · 第 N / 7 站 · 名称」——这句话侧栏当前项、顶栏控制台、概况抽屉已经各说
一遍(R18);图标是环节名首字符自拼的色块,和侧栏那只图形只是「碰巧同类」;主操作
挂在**整块页头**的垂直中线上,而七站的职责说明有的两行有的一行,实测同一颗主按钮
在七页的 y 坐标各不相同,概览页没有动作时中线还空着一截。

做法:①`app/layout/nav.tsx` 新增 `navItemAt(pathname)`——先查 `globalNav` 精确路径、
再查 `projectModules`,把菜单项那个 ReactNode 原样交给页头,菜单与门牌读同一份图形,
物理上不可能不一致;②`components/ui/Page.tsx` 删掉 `NodeHead` 与它自带的 `moduleAt`,
`PageHead` 成为全站唯一实现:第一行 `.nex-pagehead-title`(色块图标 + `Title level=3`)
与 `ActionGroup auto={false}` 同排两端对齐,第二行 `w-full` 的 `meta` + `sub`;新增
`icon` 属性(缺省反查菜单、`null` 明确不放),不在菜单里的三页(账号 / 用户管理 /
手册)显式补 `IconUser` / `IconTeam` / `IconBook`;③`app.css` 的 `.nex-nodehead` 改名
`.nex-pagehead`,新增 `.nex-pagehead-title { min-block-size: var(--ant-control-height) }`
——主按钮的 y 由这条几何保证,不靠页面垫 margin;色块从单类扩成一族
`.nex-stat-mark` / `.nex-pagehead-mark` / `.nex-brief-mark`(32 / 32 / 20 共用一套配色
与圆角,`--nex-stat-tint` 缺省落回主色),概况抽屉那七行同步降到 20 档;④七站与规范
(R18 行、§6.5 的四层表 ③ 与那条「`NodeHead` 是 `PageHead` 的一层皮肤」)一起改写。

为什么把「对齐」写成 CSS 而不是逐个页面调:只要中线还挂在整块页头上,任何一句说明
文案变长都会把七页的按钮重新错开;第一行定高之后,改文案只会长第二行。
1440 实测 13 个内容页:门牌唯一、标题行高恒为 32、图标 32×32、主操作右缘一律 1391、
中线一律 109.0(含无动作的概览与账号);430 档主操作折到下方、无 console error。
main
mula.liu 2026-11-03 22:40:16 +08:00
parent 71fbaf0a94
commit e5ccbe0651
16 changed files with 150 additions and 150 deletions

View File

@ -44,7 +44,7 @@
| R15 | **按钮一律是图标按钮**:凡有动作语义的按钮都写 `icon={<IconXxx />}`,`FilePick` / `RecordAudio` 这两个自带触发元素的封装也走 `icon` 槽;一个意思全站只许一只图形(§5.1.1) | 一排纯文字按钮要逐个读完才知道哪颗是什么,图标剪影一眼分得开;用户截图原话「按钮都要使用图标按钮」 |
| R16 | **信息块三件套各有唯一写法**(§13.1):① **统计**=`Stat`/`StatGrid`,自带 `bg-fill-tertiary` 底纹 + 右下角语义水印图形,页面不再手涂 `bg-[#...]`;② **只读回显**=`Info`(antd `Descriptions`),「灰盒 + label 在上」和用 `Input disabled` 装只读值一律废止,只读 `Tag` 不许描边,统计用途的计数不许用无底纹灰胶囊;③ **语义提示**=`Notice`(antd `Alert`),页面不再自拼 `border + warning-bg` 当告警 | 白底数字块与卡片同色,扫不出「这是结论」还是「这是容器」;灰盒回显和旁边的输入框长得一样,用户去找可点的框,框里却没有可改的东西;底纹与告警底色都是 antd 自己的 fill / 语义色层,明暗两档跟主题走,不需要再养一套私有皮肤 |
| R17 | **表格行不许被子元素撑高**(§13.2):① 先做列宽预算——`Table` 默认 `minWidth={false}`,定宽列合计必须回到容器里,长文列**不写 `width`** 吃掉剩余宽度且扣掉内边距后 ≥ 200px;② 单元格里的长文案一律 `<Clamp>` 封顶(标题 1 行 / 说明与报错 2 行)并把全文挂原生 `title`,表格里的 `ErrorText` 同样必须给 `lines`;③ 动作列按「`颗数×32 + (颗数−1)×6 + 16`」算宽、图标化一行放完。一个格子的预算是**正文两行 + 次要元信息一行 ≈ 84px**,超了就是返工。**这条由 `scripts/ui/tableaudit.py` 常驻量,不靠自觉** | 「列宽」与「文案长度」两头堵,只调列宽永远调不完:审核留痕一句质检长文把行顶到 255px、生成记录一条 prompt 顶到 227px,一屏只剩三条记录,表格退化成段落。用户第 28 轮原话「表格行不要被子元素撑高(长文折 8 行 = 设计失败)」 |
| R18 | **每一级的身份与动作只在该级说一遍**(§6.5 四级层次):项目名 / 状态 / 进度 / 归档 / 删除只属于**项目层**(顶栏那颗流程控制台胶囊是唯一入口,点开右侧「项目概况」抽屉);「这是哪一站 + 这一站的主操作」只属于**环节层**(`NodeHead`:一张带底纹描边的独立面板);数据与筛选只属于**内容层**(`Panel`)。工作台外壳 `pages/ProjectDetail.tsx` 除兜底(载入 / 未找到 / 报错)外**不渲染任何可见块** | 用户第 11 轮原话「要进一步把各级的信息归拢并提供交互的层次清晰」:当时同一条项目身份在顶栏、外壳面包屑、概览页页头各说一遍,而**项目级**的「归档」坐在**环节级**页头上 |
| R18 | **每一级的身份与动作只在该级说一遍**(§6.5 四级层次):项目名 / 状态 / 进度 / 归档 / 删除只属于**项目层**(顶栏那颗流程控制台胶囊是唯一入口,点开右侧「项目概况」抽屉);「这是哪一站 + 这一站的主操作」只属于**环节层**(`PageHead`:一张带底纹描边的独立门牌卡);数据与筛选只属于**内容层**(`Panel`)。工作台外壳 `pages/ProjectDetail.tsx` 除兜底(载入 / 未找到 / 报错)外**不渲染任何可见块** | 用户第 11 轮原话「要进一步把各级的信息归拢并提供交互的层次清晰」:当时同一条项目身份在顶栏、外壳面包屑、概览页页头各说一遍,而**项目级**的「归档」坐在**环节级**页头上 |
---
## 1. 谁定尺子:四层,antd 在最上面
@ -509,18 +509,24 @@ items = [
|---|---|---|---|
| ① 项目入口 | `app/layout/PipelineConsole.tsx`(顶栏那颗 `Button.nex-console`) | 项目名 + 状态 + 轨道 + 百分比 + 当前节点,点击 = 展开/收起概况抽屉 | 不再跳「流程概览」;不写按钮以外的动作 |
| ② 项目层 | `app/layout/ProjectBriefDrawer.tsx`(右侧 `Drawer`,宽 `min(620px, calc(100vw - 32px))`) | 项目身份 `Info` + 4 张 `Stat` + 流程进度 + **七站跳转** + 归档 / 取消归档 / 删除(footer 唯一一颗 primary) | 不发第二个请求:全部读 `stores/project.ts` 那份轮询数据 |
| ③ 环节层 | `NodeHead`(`components/ui/Page.tsx` = 一张 `.nex-panel.nex-nodehead`) | 这一站的标题 + 一句话职责 + 这一站的主操作;眉标由路由算出「项目环节 · 第 N / 7 站 · 名称」 | 不写项目名 / 项目状态 / 项目级动作 |
| ③ 环节层 | `PageHead`(`components/ui/Page.tsx` = 一张 `.nex-panel.nex-pagehead`) | 菜单同款图标 + 一级标题 + 一句话职责 + 这一站的主操作(图标由 `navItemAt(pathname)` 反查侧栏菜单,菜单与门牌读同一个 ReactNode,物理上不可能不一致) | 不写项目名 / 项目状态 / 项目级动作;不写眉标「第 N / 7 站」——站次由侧栏、顶栏控制台、概况抽屉三处说(R18) |
| ④ 内容层 | `Panel` / `PanelHead` / `Ctlbar` / `Table` | 这批数据本身 | 不重复上面三层 |
- **外壳 `pages/ProjectDetail.tsx` 只剩数据装载**:按路由 `loadProject` + `startPolling`、
三种兜底(`Loading` / `Empty` / `ErrorText`)、`<Outlet />`。它**不渲染任何可见块**——
「展开概况」这颗按钮连同那条面包屑工具条一起删了,因为入口已经还给顶栏。
别把项目名、状态 Tag、指标卡加回来(那正是 R18 要清的东西)。
- **`NodeHead` 是 `PageHead` 的一层皮肤**:属性完全同 `PageHead`(`title` / `sub` / `meta` /
`actions`),项目七站一律用它,全局页(项目总览 / 平台资产库 / 模型管理中心)继续用 `PageHead`。
皮肤只有 `app.css` 一处:主色 7%(深色 14%)斜向渐变 + `colorPrimaryBorder` 描边 + 体 12/24 内边距,
眉标那颗 20px 色块是 `.nex-nodehead-mark`。站次从 `app/layout/nav.tsx` 的 `projectModules`
反查路由算出,页面不参与,所以七站的眉标算法只有一份。
- **内容页页头只剩 `PageHead` 一个实现**(2026-11 第十二轮把 `NodeHead` 并了进来):
项目七站与全局页(项目总览 / 平台资产库 / 模型管理中心 / 用户管理 / 账号 / 手册)写的是同一个组件,
所以「门牌该多高、图标多大、主操作落在哪个坐标」全站只有一份代码。它只有两行:
第一行 = 标题行(`.nex-pagehead-title` 定高 `controlHeight`=32:32×32 色块图标 + `Title level={3}`)
左侧、主操作 `ActionGroup auto={false}` 右侧,二者同排两端对齐;
第二行 = `w-full` 的 `meta` + `sub`(这一站特有的计数 / 口径 + 一句职责说明)。
旧眉标「项目环节 · 第 N / 7 站 · 名称」整条删除——它和侧栏当前项、顶栏控制台、概况抽屉是同一句话,R18。
图标默认由 `app/layout/nav.tsx::navItemAt(pathname)` 反查菜单项得到(不在菜单里的页显式传 `icon`,
传 `icon={null}` 明确不放);色块几何与统计卡同族:`.nex-stat-mark` / `.nex-pagehead-mark` /
`.nex-brief-mark`(32 / 32 / 20 三档共用一套配色与圆角)。
1440 实测:13 个内容页的门牌标题行高恒为 32、图标 32×32、主操作右缘一律 1391、中线一律 109.0。
- **抽屉里的跳转 = 七站列表**,不是流程条:顶栏那条 12 段轨道已经改成容器自适应网格、
整段不可点(§7.2),抽屉里的「项目环节」七行(`.nex-brief-row`)才是导航入口,
每行右端那个 `Tag` 是这一站的汇总状态(由它覆盖的那几个节点折算,`lib/pipeline.ts::moduleState`)。
@ -562,7 +568,7 @@ event-filter / ai-bar / agent-options` 在 React 里都塌缩成同一个 `<Ctlb
同一个函数)——它下发 sm,并把 `flex-wrap` / `gap:marginXS` / 垂直居中定死。
页面**不许**再用裸 `<div className="flex items-center gap-1 …">` 拼这种行,也不许在里面的按钮上补
`size="sm"`:两套实现并存时,实测素材墙一张卡底同时长出 24 和 32 两种按钮(`AI 生成` 24、`上传` 32)。
反过来,**页面层的 `<Row>` / `PageHead`·`NodeHead` 的 `actions` / `PanelHead right` 是 md 档**,里面一律不写 `size`——
反过来,**页面层的 `<Row>` / `PageHead` 的 `actions` / `PanelHead right` 是 md 档**,里面一律不写 `size`——
档位由「这行坐在哪个容器里」决定;在 md 行里写死 `size="sm"` 就是同排两档的唯一成因(qa 探针的 B 类)。
- `Field`:标签列是 `minmax(var(--label-w), max-content)`——**只给下限不给上限**,
超长中文标题宁可把控件顶右,也不截断标签。

View File

@ -12,7 +12,7 @@
* 做法:四级层次各归各位——
* ① 顶栏控制台 = 唯一的项目身份入口(点击展开本抽屉,不再跳页);
* ② 本抽屉 = 项目层(身份回显 / 指标 / 流程 / 七站跳转 / 归档 / 删除);
* ③ NodeHead = 环节层页头(每站一张带底纹的卡,见 components/ui/Page.tsx);
* ③ PageHead = 内容层门牌卡(每站一张带底纹的卡,见 components/ui/Page.tsx);
* ④ Panel = 内容层。于是工作台外壳可以一行可见块都不渲染(见 pages/ProjectDetail.tsx)。
* 为什么用右侧抽屉而不是弹窗:这是「随时查一眼项目全局」的辅助面板,
* 遮罩之下正文还在原地,关掉就回到刚才那一站,不需要重新载入。
@ -170,7 +170,7 @@ export function ProjectBriefDrawer({ open, onClose, projectId }: {
<Button key={slug} type="text" block className="nex-brief-row"
title={m.hint} onClick={() => go(pathOf(m, projectId))}>
<Flex component="span" align="center" gap={8} className="w-full min-w-0">
<span className="nex-nodehead-mark">{m.icon}</span>
<span className="nex-brief-mark">{m.icon}</span>
<span className="min-w-0 truncate text-xs font-semibold">
{i + 1}. {m.label}
</span>

View File

@ -60,3 +60,21 @@ export function projectIdOf(pathname: string): string {
/** 菜单项的 key 就是路径:这样 selectedKeys 与 navigate 同一个值,不用再维护第二份 id */
export const pathOf = (item: NavItem, projectId: string): string =>
typeof item.to === 'string' ? item.to : projectId ? item.to(projectId) : ''
/**
* 路由 → 菜单项(页头用它反查图标,见 components/ui/Page.tsx 的 PageHead)。
*
* 症状(2026-11 第十二轮 · 用户第 1 条「标题前一个和左侧菜单一致的图标」):
* 页头如果要显示图形,就得在页面里再 import 一次图标——同一个位置两份登记,
* 换菜单图形时页头必然忘(上一版眉标那枚图标就是这么和侧栏对不上号的)。
* 做法:反查这张导航表本身。菜单和页头读同一个 ReactNode,物理上不可能不一致。
* 不在菜单里的路由(/account、/admin/users、/help)返回 null,页面自己传 icon。
*/
export function navItemAt(pathname: string): NavItem | null {
const clean = pathname.replace(/\/+$/, '') || '/'
const hit = globalNav.find((m) => m.to === clean)
if (hit) return hit
const pid = projectIdOf(clean)
if (!pid) return null
return projectModules.find((m) => pathOf(m, pid) === clean) ?? null
}

View File

@ -19,7 +19,7 @@
*/
import { type CSSProperties, type ReactNode } from 'react'
import { useLocation, useNavigate } from 'react-router-dom'
import { pathOf, projectIdOf, projectModules, type NavItem } from '../../app/layout/nav'
import { navItemAt } from '../../app/layout/nav'
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'
@ -118,108 +118,66 @@ export function CodeBlock({ children, className }: { children: ReactNode; classN
const WRAP_ACTIONS = 'max-lg:w-full max-lg:[&>button]:flex-1'
/**
* 页头(旧 <header>):左边「状态行 + 大标题」,右边整组动作。
* 内容页页头 = **一张带主色底纹的「门牌卡」**,全站唯一实现(旧 NodeHead 已并进这里)。
*
* 标题层级交回 antd 排版:Typography.Title level={3}=24px/600/colorTextHeading,
* 就是 theme 里的 fontSizeHeading3,页面再也调不出第二种"页面大标题"。
* (旧版这里是裸 <h1>,字号靠 preflight 重置后没人管,各页看着一样其实差 2px。)
* 标题只有一层中文——旧站在标题上方另加一行全大写英文眉标,切不到英文,
* 只是装饰,现在整层删掉(见 UI规范 §1)。
* 症状(2026-11 第十二轮 · 用户原话「内容页 Header 重写,只保留节点名(1 级标题)+
* 描述说明。标题前一个和左侧菜单一致的图标。右侧的主功能入口要对齐」):
* ① 页头有三行字——眉标「项目环节 · 第 N / 7 站 · 流程概览」、大标题、职责说明。
* 眉标和标题讲的是同一件事(这一站叫什么),站次在侧栏高亮项、顶栏流程条、
* 项目概况抽屉里又各说了一遍(R18:每一级的信息只在该级说一遍);
* ② 眉标那枚图标孤零零在第一行左端,离标题隔了一整行,对不上「这图形=菜单里那项」;
* ③ 右端动作挂在**整块页头**的垂直中线上,七站的说明有长有短、有的两行有的一行,
* 主按钮在每一页的 y 都不一样,概览页没有动作时那条中线还是空的。
* 做法:页头只留两层,第一行横向排满——
* 第一行 = 菜单同款图标 + 一级标题 +(右端)整页成立的主操作;
* 第二行 = 一句话职责说明(以及 meta 那种只读补充),横跨整行。
* 图标不在页面里 import:由路由反查 `app/layout/nav.tsx` 那张菜单表(navItemAt),
* 菜单换图形当天页头跟着换,两边物理上不可能长得不一样。
* 第一行高度钉在 controlHeight,主操作与它垂直居中、右缘贴卡内边距——
* 七站的「新建 / 入队 / 批量放行 / 开始导出」因此必然落在同一条水平线上。
* 为什么仍然是一张卡(2026-11 第十一轮的口径不变):页头与正文卡之间只有 16px 空白时,
* 它读起来像「正文上面漏了半句话」;主色底纹 + 主色描边让它是全站唯一带主色
* 描边的卡,一眼就是「这一层的门牌」,主次不靠字号硬撑。
* 分工(UI规范 §2):PageHead 只放**整页成立**的动作(新建、入队、批量放行、开始导出);
* PanelHead 只放**离开这一块就不成立**的动作;Tabs 右端不放按钮。
* 窄屏:标题行与动作组各自满宽(WRAP_ACTIONS 让按钮等分),说明仍在最下面一行。
*/
/**
* 页头 = 页面身份 + 页面级主操作。
*
* 口径(2026-11 第四轮 · 用户第 1 条):**内容页的标题和主按钮只在这里出现一次**。
* 以前项目子页没有页头,标题写在第一张卡的卡头里(「资产管理」「分镜工作台」),
* 主按钮又写在页签条右端或某张卡的卡头右端,读者要在一堆卡头里找那颗主按钮;
* 于是同一个动作在两个页面分别位于「页签右侧 / 卡头右侧 / 表单末尾」三处。
* 分工(写进 UI规范 §2):
* PageHead 只放**整页成立**的动作(新建、入队、批量放行、开始导出);
* PanelHead 只放**离开这一块就不成立**的动作(某张表的导出、某个表单的保存);
* Tabs 的右端不再放按钮(页签是「看哪一份」,按钮是「做一件事」,两者同排必然打架)。
* sub:一句话说明这一页的职责,替代以前写在卡头里的长段说明文字。
* 宽度限 72ch:整屏宽的次要说明在 2560 上会拉成一条读不回行的横线。
*/
export function PageHead({ title, sub, meta, actions, className }: {
export function PageHead({ title, sub, meta, actions, icon, className }: {
title?: ReactNode
/** 标题下方的一句话职责说明(12px 次要色) */
/** 标题下方的一句话职责说明(12px 次要色,最宽 72ch) */
sub?: ReactNode
/** 标题上方一行:返回链接 / 只读状态(渲染在标题之前) */
meta?: ReactNode
actions?: ReactNode
className?: string
}) {
return (
<Flex component="header" wrap justify="space-between" align="center" gap={12}
className={cn('mb-5 min-w-0 max-lg:items-start', className)}>
<Flex vertical gap={4} className="min-w-0 max-lg:w-full">
{meta && <Row className={WRAP_ACTIONS}>{meta}</Row>}
{title && (
<Typography.Title level={3} className="!mb-0 !min-w-0">{title}</Typography.Title>
)}
{sub && (
<Typography.Text type="secondary"
className="!mb-0 block max-w-[72ch] text-xs leading-relaxed">{sub}</Typography.Text>
)}
</Flex>
{/* auto={false}:页头的窄屏方案是「整组满宽 + 按钮等分」(WRAP_ACTIONS),
不需要 ActionGroup 再把它翻成竖排一列 */}
{actions && <ActionGroup auto={false} className={WRAP_ACTIONS}>{actions}</ActionGroup>}
</Flex>
)
}
/** 路由 → 这一站(项目环节页专用):算不出(全局页 / 未知段)就返回 null */
function moduleAt(pathname: string): { item: NavItem; index: number } | null {
const pid = projectIdOf(pathname)
if (!pid) return null
const index = projectModules.findIndex((m) => pathOf(m, pid) === pathname.replace(/\/+$/, ''))
return index < 0 ? null : { item: projectModules[index], index }
}
/**
* 环节页头(项目七站专用)= **单独一张带底纹描边的面板**里装的 PageHead。
*
* 症状(2026-11 第十一轮 · 用户第 1 条原话「项目中切到每个节点应该是其对应的
* Header,这部分应该放入一个有样式的单独面板中」):环节页的页头是一行裸
* 浮在页面底色上的字(标题 + 一句说明 + 右端按钮),它和正文第一张卡之间
* 只有 16px 空白,读起来像「正文上面漏了半句话」;而它上面还压着外壳那条
* 同样裸着的面包屑工具条,两层没有边界的东西叠在一起,分不清哪句说的是
* 项目、哪句说的是这一站。
* 做法:页头自己成为一张卡(`.nex-nodehead`:主色浅底渐变 + 主色描边),
* 和下面的正文卡同级同宽;眉标由路由算出「项目环节 · 第 N / 7 站」,
* 这一站在七站里的位置第一次被写在页面上(侧栏只有名字,没有序号)。
* 为什么放在 kit 而不是每个页面自己套 Panel:七站是同一个层级,
* 底纹、描边、眉标算法必须一模一样;页面只该决定标题、说明和主按钮。
* 用法:项目环节页把 `<PageHead>` 换成 `<NodeHead>`,其余属性不变;
* 非项目路由(平台资产库这种全局页)算不出站次,眉标自动不出现,
* 面板皮肤照样成立。
*/
export function NodeHead({ title, sub, meta, actions, className }: {
title?: ReactNode
/** 标题下方的一句话职责说明 */
sub?: ReactNode
/** 标题上方一行(与自动生成的站次眉标同排,追加在后面) */
/** 说明之上再加一排只读补充(手册页的特性标签);没有就不占行 */
meta?: ReactNode
/** 右端主操作:与标题同排、整体右对齐;窄屏整组满宽、按钮等分 */
actions?: ReactNode
/** 覆盖反查结果的图标(账号 / 用户管理 / 手册这种不在菜单里的页);传 null 明确不放图标 */
icon?: ReactNode
className?: string
}) {
const location = useLocation()
const at = moduleAt(location.pathname)
/* 菜单表反查:`icon` 没写就用这一页在侧栏里的那枚图形 */
const mark = icon === undefined ? (navItemAt(location.pathname)?.icon ?? null) : icon
return (
<Panel size="small" className={cn('nex-nodehead min-w-0', className)}>
<PageHead className="!mb-0" title={title} sub={sub} actions={actions}
meta={at ? (
<>
<Flex align="center" gap={6} className="min-w-0">
<span className="nex-nodehead-mark">{at.item.icon}</span>
<Typography.Text className="!text-xs font-semibold">
项目环节 · 第 {at.index + 1} / {projectModules.length} 站 · {at.item.label}
</Typography.Text>
</Flex>
{meta}
</>
) : meta} />
<Panel size="small" className={cn('nex-pagehead min-w-0', className)}>
<Flex wrap align="center" justify="space-between" gap={12} className="min-w-0">
<Flex align="center" gap={10} wrap className="nex-pagehead-title min-w-0 flex-1 max-lg:w-full">
{mark ? <span className="nex-pagehead-mark" aria-hidden>{mark}</span> : null}
<Typography.Title level={3} className="!mb-0 !min-w-0">{title}</Typography.Title>
</Flex>
{/* auto={false}:页头的窄屏方案是「整组满宽 + 按钮等分」(WRAP_ACTIONS),
不需要 ActionGroup 再把它翻成竖排一列 */}
{actions && <ActionGroup auto={false} className={WRAP_ACTIONS}>{actions}</ActionGroup>}
{/* 说明行 w-full:它必然掉到第二行,主操作因此永远和标题同一排 */}
{(meta || sub) && (
<Flex vertical gap={6} className="w-full min-w-0">
{meta && <Row className={WRAP_ACTIONS}>{meta}</Row>}
{sub && (
<Typography.Text type="secondary"
className="!mb-0 block max-w-[72ch] text-xs leading-relaxed">{sub}</Typography.Text>
)}
</Flex>
)}
</Flex>
</Panel>
)
}

View File

@ -97,7 +97,8 @@ export default function Account() {
return (
<PageStack className="min-w-0">
<PageHead title="我的账号"
{/* 这一页不在侧栏菜单里(从右上角头像进入),PageHead 反查不到菜单图形,自己补一枚 */}
<PageHead title="我的账号" icon={<IconUser />}
actions={<Tag tone={isAdmin ? 'info' : 'default'}>{role}</Tag>} />
{mustChange && <Notice>这个账号还在使用初始密码,请先修改密码再开始制作。</Notice>}

View File

@ -20,7 +20,7 @@ import {
Block, Chip, ChipBar, Code, CodeBlock, Divider, ExtLink, Grid, Heading, LinkButton,
Notice, PageHead, Panel, Paragraph, Table, Tag, TagGroup, Value, type Columns, cellWrap
} from '../components/ui'
import { IconApi, IconBolt, IconDashboard, IconImage, IconPlayCircle, IconVoice } from '../components/icons'
import { IconApi, IconBolt, IconBook, IconDashboard, IconImage, IconPlayCircle, IconVoice } from '../components/icons'
/** 正文皮肤:只在手册根上贴一次(行内加粗、链接里的代码色),段落不再各带一套 */
const SHELL = 'min-w-0 [&_b]:font-semibold [&_b]:text-text [&_a_code]:text-primary'
/** 章节:锚点要躲开常驻顶栏(kit 的 HEADER_HEIGHT=56),滚动定位留两档余量 */
@ -194,8 +194,10 @@ export default function Help() {
原先是一整块 primary 底纹的封面卡:整页只有它是彩色的,读者以为那是个提示条;
四张能力标签改成页头眉标,封面卡的底纹与描边一起删掉(§1 一屏最多一个语义底块,
本页后面还有 Notice 在用底纹,封面没有资格再占一次)。 */}
{/* 手册也不在侧栏菜单里:图形自己给(IconBook),门牌卡的样子与其它页一致 */}
<PageHead
title="长视频编导平台使用手册"
icon={<IconBook />}
sub="从模型配置、资产管理、脚本导入,到分镜生成、自动质检、人工审核与长视频合成, 本手册按实际业务流程说明每个页面的用途与关键操作。所有截图均来自正在运行的系统。"
meta={<TagGroup className="!mb-0">
<Tag>四类模型统一管理</Tag>

View File

@ -13,7 +13,7 @@
* `app/layout/PipelineConsole.tsx`);
* ② `app/layout/ProjectBriefDrawer.tsx` = 项目层(身份 / 指标 / 流程 /
* 七站跳转 / 归档 / 删除),所以「展开概况」这颗按钮整颗删掉;
* ③ `NodeHead` = 环节层页头(七站各一张带底纹的卡,见 `components/ui/Page.tsx`);
* ③ `PageHead` = 内容层门牌卡(七站各一张带底纹的卡,见 `components/ui/Page.tsx`);
* ④ `Panel` = 内容层。
* 外壳只剩下:按路由换项目、每 6 秒轮询、三种兜底(载入 / 未找到 / 错误)。
* 为什么数据还挂在这里而不是抽屉里:workflow 与 stats 同时被顶栏控制台、

View File

@ -156,7 +156,7 @@ export default function UserAdmin() {
return (
<PageStack className="min-w-0">
<PageHead title="用户管理" />
<PageHead title="用户管理" icon={<IconTeam />} />
<ErrorText className="text-xs">{error}</ErrorText>
{/* 统计卡一共 5 项:给 5 列,别让第 5 张孤零零掉到第二行 */}

View File

@ -10,7 +10,7 @@ import { fromExport } from '../../lib/media'
import { useAutoRefresh } from '../../hooks'
import { Select } from '../../components/forms'
import { MediaThumb } from '../../components/media/MediaThumb'
import { NodeHead, ActionGroup, Button, Clamp, Value, Chip, ErrorText, ExtLink, Field, FormGrid, FormRow, Grid, IconText, Info, Input, LineHint, OptionGrid, Toolbar, LINK_CLS, MONO, MUTED, MUTED_MONO, NumberInput, PageStack, Panel, PanelHead, Row, Spinner, Stat, StatGrid, Status, Table, Tag } from '../../components/ui'
import { PageHead, ActionGroup, Button, Clamp, Value, Chip, ErrorText, ExtLink, Field, FormGrid, FormRow, Grid, IconText, Info, Input, LineHint, OptionGrid, Toolbar, LINK_CLS, MONO, MUTED, MUTED_MONO, NumberInput, PageStack, Panel, PanelHead, Row, Spinner, Stat, StatGrid, Status, Table, Tag } from '../../components/ui'
import { refresh, useProjectStore } from '../../stores/project'
import { presetLabel, presets as FALLBACK_PRESETS, useSystemStore } from '../../stores/system'
import { notify } from '../../stores/notice'
@ -171,7 +171,7 @@ export default function Delivery() {
<PageStack>
{/* 页头(第 1 条):出片是这一页唯一整页成立的主操作,从「合成导出」的表末尾提到页头;
面板里只剩预设与参数,勾选完直接在最上方按同一颗按钮。 */}
<NodeHead
<PageHead
title="导出与成本"
sub="按预设合成成片,核对成本台账与每一次生成的可复现参数。"
actions={<>

View File

@ -8,7 +8,7 @@ import * as api from '../../api/client'
import { fmtAgo, fmtMoney, statusLabel } from '../../lib/format'
import { useAutoRefresh } from '../../hooks'
import { Select } from '../../components/forms'
import { NodeHead, ActionGroup, Actions, Button, Check, Ctlbar, Divider, Count, ErrorText, ExtLink, Field, Info, Layout, LinkButton, MONO, MUTED, MUTED_MONO, NumberInput, PageStack, Panel, PanelHead, ProgressBar, Row, Spinner, Status, Table, Tag, TagGroup, Toolbar, Value, Clamp } from '../../components/ui'
import { PageHead, ActionGroup, Actions, Button, Check, Ctlbar, Divider, Count, ErrorText, ExtLink, Field, Info, Layout, LinkButton, MONO, MUTED, MUTED_MONO, NumberInput, PageStack, Panel, PanelHead, ProgressBar, Row, Spinner, Status, Table, Tag, TagGroup, Toolbar, Value, Clamp } from '../../components/ui'
import { refresh, useProjectStore } from '../../stores/project'
import { useSystemStore } from '../../stores/system'
import { notify } from '../../stores/notice'
@ -201,7 +201,7 @@ export default function Dispatch() {
<PageStack>
{/* 页头(第 1 条):入队是这一页唯一整页成立的主操作,从「分镜任务清单」的卡头里提出来。
卡头只留「预计成本 · 共 N 行」这句清单自身的口径。 */}
<NodeHead
<PageHead
title="任务调度中心"
sub="按分镜清单入队生成与配音任务,跟踪队列、重试与并发;模型本身的配置在模型管理中心。"
actions={<Button type="primary" disabled={!!busy} onClick={enqueue} icon={<IconPlayCircle />}>入队所选 / 全部待生成</Button>}

View File

@ -21,7 +21,7 @@ import { Select } from '../../components/forms'
import { AudioPlay } from '../../components/media/AudioPlay'
import { MediaThumb } from '../../components/media/MediaThumb'
import { RecordAudio, type RecordPickMeta } from '../../components/media/RecordAudio'
import { ActionGroup, Actions, BarRight, Block, Button, CARD_ROW, CardActions, Check, Chip, ChipBar, Ctlbar, Divider, Drawer, Empty, ErrorText, ExtLink, Field, FieldBlock, FilePick, FormGrid, FormRow, IconText, Info, Input, LINK_CLS, LineHint, LinkButton, MONO, MUTED, MUTED_MONO, Notice, NumberInput, NodeHead, PageStack, Panel, PanelHead, Row, SearchInput, SectionTitle, Spinner, Table, Tabs, Tag, TagGroup, TextArea, Toolbar, Value, cellWrap } from '../../components/ui'
import { ActionGroup, Actions, BarRight, Block, Button, CARD_ROW, CardActions, Check, Chip, ChipBar, Ctlbar, Divider, Drawer, Empty, ErrorText, ExtLink, Field, FieldBlock, FilePick, FormGrid, FormRow, IconText, Info, Input, LINK_CLS, LineHint, LinkButton, MONO, MUTED, MUTED_MONO, Notice, NumberInput, PageHead, PageStack, Panel, PanelHead, Row, SearchInput, SectionTitle, Spinner, Table, Tabs, Tag, TagGroup, TextArea, Toolbar, Value, cellWrap } from '../../components/ui'
import { useSystemStore } from '../../stores/system'
import { refresh, useProjectStore } from '../../stores/project'
import { notify } from '../../stores/notice'
@ -729,9 +729,9 @@ export default function Library() {
return (
<PageStack>
{/* 页头(第 1 条):环节名 + 职责说明 + 这一页的主操作。
主操作是「新建当前面板的资产」——它整页成立,所以进 NodeHead;
主操作是「新建当前面板的资产」——它整页成立,所以进 PageHead;
两个跨页跳转是另一层意思,自成一组并排放左边。 */}
<NodeHead
<PageHead
title="资产管理"
sub="集中维护人物、声音与场景。资产可单独调用模型生成,绑定到分镜后会自动进入视频参考素材与提示词。"
actions={<>

View File

@ -25,7 +25,7 @@ import { refresh, useProjectStore } from '../../stores/project'
import { notify } from '../../stores/notice'
import { useAutoRefresh } from '../../hooks'
import { Select } from '../../components/forms'
import { NodeHead, Actions, Button, CardRow, Chip, Info, Ctlbar, Divider, ErrorText, Field, FieldBlock, FormGrid, FormRow, Grid, IconText, Input, LINK_CLS, Layout, LinkButton, LogBox, LogRow, MONO, Notice, MUTED, MUTED_MONO, NumberInput, PageStack, Panel, PanelHead, Row, SearchInput, Stack, Stat, Table, Tag, TagGroup, TextArea, Value, Clamp } from '../../components/ui'
import { PageHead, Actions, Button, CardRow, Chip, Info, Ctlbar, Divider, ErrorText, Field, FieldBlock, FormGrid, FormRow, Grid, IconText, Input, LINK_CLS, Layout, LinkButton, LogBox, LogRow, MONO, Notice, MUTED, MUTED_MONO, NumberInput, PageStack, Panel, PanelHead, Row, SearchInput, Stack, Stat, Table, Tag, TagGroup, TextArea, Value, Clamp } from '../../components/ui'
import AgentConsole from './AgentConsole'
import { IconBolt, IconCheck, IconChevronRight, IconChevronUp, IconClose, IconFolder, IconGrid, IconImage, IconPass, IconTracks, IconUser, IconVoice } from '../../components/icons'
/**
@ -242,7 +242,7 @@ export default function Overview() {
却坐在**环节级**页头上,和外壳的面包屑、顶栏控制台各说一遍项目信息。
归档/删除现在统一收进顶栏控制台展开的「项目概况」抽屉,这一页只回答
「流程走到哪、下一节点缺什么、在总控台下指令」,所以页头没有动作。 */}
<NodeHead
<PageHead
title="流程概览"
sub="看清流程走到了哪一步、下一个节点还缺什么,并在总控台里下达任务指令。"
/>

View File

@ -13,7 +13,7 @@ import { useAutoRefresh } from '../../hooks'
import { Select } from '../../components/forms'
import { AudioPlay } from '../../components/media/AudioPlay'
import { MediaThumb } from '../../components/media/MediaThumb'
import { NodeHead, ActionGroup, Actions, Button, Check, ChipBar, Ctlbar, Divider, Empty, ErrorText, Field, FormRow, Row, BarRight, SegmentedTabs, Count, IconText, Info, Input, Layout, LineHint, MONO, MUTED, MUTED_MONO, NumberInput, PageStack, Panel, PanelHead, SectionTitle, Spinner, Status, Table, Tag, TagGroup, TextArea, Toolbar, Value, Clamp } from '../../components/ui'
import { PageHead, ActionGroup, Actions, Button, Check, ChipBar, Ctlbar, Divider, Empty, ErrorText, Field, FormRow, Row, BarRight, SegmentedTabs, Count, IconText, Info, Input, Layout, LineHint, MONO, MUTED, MUTED_MONO, NumberInput, PageStack, Panel, PanelHead, SectionTitle, Spinner, Status, Table, Tag, TagGroup, TextArea, Toolbar, Value, Clamp } from '../../components/ui'
import { refresh, useProjectStore } from '../../stores/project'
import { notify } from '../../stores/notice'
import { IconAim, IconDownload, IconEye, IconPass, IconReject, IconReload, IconRetry } from '../../components/icons'
@ -203,10 +203,10 @@ export default function Review() {
return (
<PageStack>
{/* 页头(第 1 条):三个批量动作是这一页的主操作,整页成立 → 进 NodeHead。
{/* 页头(第 1 条):三个批量动作是这一页的主操作,整页成立 → 进 PageHead。
症状(第 6 条):它们以前和六个只读计数挤在同一张卡头里,
左端是一排会折行的表格、右端是三颗长文案按钮,窄屏先把按钮压成两行。 */}
<NodeHead
<PageHead
title="质检与审核"
sub="机器质检给出技术指标与画面判定,人工审核决定放行;驳回会把镜头退回生成环节重做。"
actions={<>

View File

@ -28,7 +28,7 @@ import { refresh, useProjectStore } from '../../stores/project'
import { options, useSystemStore } from '../../stores/system'
import { notify } from '../../stores/notice'
import { openPreview, usePreviewOpen } from '../../stores/preview'
import { NodeHead, ActionGroup, Actions, BarRight, Between, BLOCK_TONE, Button, CARD_ROW, Check, Checkbox, Chip, ChipBar, CloseButton, Ctlbar, DRAWER_ACTIONS, DRAWER_BODY, DRAWER_HEAD, DRAWER_TITLE, Divider, Empty, ErrorText, ExportMenu, ExtLink, Field, FieldBlock, FilePick, FormGrid, FormRow, IconText, Input, LINK_CLS, LinkButton, Loading, MUTED, MUTED_MONO, MaybeNumberInput, Mono, Notice, NumberInput, PageStack, Panel, PanelHead, Row, Scrim, SearchInput, SectionTitle, Spinner, Status, TAG_DENSE, Table, Tabs, Tag, TagGroup, TextArea, Toolbar, Value, ViewSwitch, cellWrap, type Columns } from '../../components/ui'
import { PageHead, ActionGroup, Actions, BarRight, Between, BLOCK_TONE, Button, CARD_ROW, Check, Checkbox, Chip, ChipBar, CloseButton, Ctlbar, DRAWER_ACTIONS, DRAWER_BODY, DRAWER_HEAD, DRAWER_TITLE, Divider, Empty, ErrorText, ExportMenu, ExtLink, Field, FieldBlock, FilePick, FormGrid, FormRow, IconText, Input, LINK_CLS, LinkButton, Loading, MUTED, MUTED_MONO, MaybeNumberInput, Mono, Notice, NumberInput, PageStack, Panel, PanelHead, Row, Scrim, SearchInput, SectionTitle, Spinner, Status, TAG_DENSE, Table, Tabs, Tag, TagGroup, TextArea, Toolbar, Value, ViewSwitch, cellWrap, type Columns } from '../../components/ui'
import { floatingLayerOpen } from '../../lib/layers'
import { IconAdd, IconArrowDown, IconArrowUp, IconAudit, IconCheck, IconChevronUp, IconClose, IconCompose, IconCopy, IconDelete, IconDownload, IconDragHandle, IconEdit, IconEye, IconGrid, IconImage, IconListOrdered, IconMic, IconParams, IconPlayCircle, IconReload, IconRetry, IconSearch, IconSound, IconToTop, IconUpload, IconVideo, IconWarn } from '../../components/icons'
@ -1085,8 +1085,8 @@ export default function Storyboard() {
分隔线全都自己定,于是它是全站唯一「像卡皮、但不是卡」的横条。
现在它就是 <Toolbar>(只有卡头的 Card),指标改成一行摘要文字。 */}
{/* 页头(第 1 条):「导入」和「新建」是同一件事的两种入口(都是往工作台里加镜头),
永远并排,整页成立 → 进 NodeHead,不再混在吸顶工具条的视图切换旁边。 */}
<NodeHead
永远并排,整页成立 → 进 PageHead,不再混在吸顶工具条的视图切换旁边。 */}
<PageHead
title="分镜与脚本"
sub="逐镜维护脚本、关键帧与提示词。看板适合逐镜对照画面,分镜表适合一屏看更多、批量改参数。"
actions={<>
@ -1515,7 +1515,7 @@ export default function Storyboard() {
title="听得见的东西,用名词短语(键盘敲击声、空调底噪),不要写成句子。模型直出声音时它除了给这一镜铺底噪,还能占住台词前后的空闲时间:MiniMax H3 的音轨和画面一样长,空着的地方它不会留静音,而是从提示词里挑一段画面描述念出来(成片开头那句听不懂的话就是这么来的)。没人说话的镜头同样该填。">
<Input value={draft.ambience} placeholder="键盘敲击声,办公室底噪" onChange={(e) => edit({ ambience: e.target.value })} />
</Field>
<Check className="self-center" checked={draft.subtitle_enabled}
<Check checked={draft.subtitle_enabled}
onChange={(next) => edit({ subtitle_enabled: next })}>启用字幕</Check>
</FormRow>
<div className="min-w-0">

View File

@ -16,7 +16,7 @@ import { refresh, useProjectStore } from '../../stores/project'
import { useSystemStore } from '../../stores/system'
import { notify } from '../../stores/notice'
import { openPreview } from '../../stores/preview'
import { NodeHead, ActionGroup, Actions, Button, Check, Chip, ChipBar, Ctlbar, Divider, Empty, ErrorText, ExtLink, Field, FieldBlock, FilePick, FormGrid, FormRow, Grid, Count, IconText, Input, IssueRow, Layout, LineHint, MONO, MUTED, MUTED_MONO, MaybeNumberInput, Mono, NumberInput, OptionGrid, PageStack, Panel, PanelHead, Row, Spinner, Status, Table, Tag, TagGroup, TextArea, Toolbar, Value } from '../../components/ui'
import { PageHead, ActionGroup, Actions, Button, Check, Chip, ChipBar, Ctlbar, Divider, Empty, ErrorText, ExtLink, Field, FieldBlock, FilePick, FormGrid, FormRow, Grid, Count, IconText, Input, IssueRow, Layout, LineHint, MONO, MUTED, MUTED_MONO, MaybeNumberInput, Mono, NumberInput, OptionGrid, PageStack, Panel, PanelHead, Row, Spinner, Status, Table, Tag, TagGroup, TextArea, Toolbar, Value } from '../../components/ui'
import { IconAdd, IconArrowDown, IconArrowUp, IconCheck, IconChevronDown, IconChevronUp, IconClose, IconDelete, IconEdit, IconEye, IconMic, IconPass, IconSound, IconStar, IconTracks, IconWarn } from '../../components/icons'
/**
@ -412,8 +412,8 @@ export default function Timeline() {
(名字 <b>、TagGroup、SectionTitle 当标签用、两颗按钮,四种高度挤一排)。
现在它是「只有卡头的卡」:名字进卡头标题、计数进 sub、版本操作进 extra。 */}
{/* 页头(第 1 条):时间线版本是这一页的全局对象——下拉选中哪一版,
「设为当前 / 删除」就作用于哪一版,三件必须同排,所以整组提进 NodeHead。 */}
<NodeHead
「设为当前 / 删除」就作用于哪一版,三件必须同排,所以整组提进 PageHead。 */}
<PageHead
title="时间线合成"
sub="把有产物的镜头按镜序编排版本,逐段核对画面、配音与字幕,再交给导出。"
actions={<>

View File

@ -149,38 +149,38 @@ textarea) { width: 100%; min-width: 0 }
.nex-panel .ant-card-body { min-width: 0 }
.nex-panel .ant-card-body > * { min-width: 0 }
/* ── 环节页头(NodeHead):项目七站的页头是一张**有底纹描边的卡** ──────────
症状(2026-11 第十一轮 · 用户第 1 条原话「项目中切到每个节点应该是其对应的
Header,这部分应该放入一个有样式的单独面板中」):页头是一行裸浮在页面
底色上的字,和正文第一张卡之间只有 16px 空白,读起来像「正文上面漏了半句
话」;上面还叠着外壳那条同样裸着的面包屑条,两层无边界的东西贴在一起,
分不清哪句说项目、哪句说这一站。
/* ── 内容页页头(PageHead):每一页的门牌是一张**有底纹描边的卡** ──────────
症状(2026-11 第十一轮 · 用户原话「项目中切到每个节点应该是其对应的 Header,
这部分应该放入一个有样式的单独面板中」;第十二轮 · 用户原话「内容页 Header
重写」):页头是一行裸浮在页面底色上的字,和正文第一张卡之间只有 16px 空白,
读起来像「正文上面漏了半句话」;上面还叠着外壳那条同样裸着的面包屑条,
两层无边界的东西贴在一起,分不清哪句说项目、哪句说这一站。
做法:页头坐进自己的 Card,底纹 = 主色 7%(深色 14%)斜向渐变收进卡底色,
描边取主色描边那一族——它是全站唯一带主色描边的卡,一眼就是「这一层的门牌」,
下面的正文卡都是中性描边,主次不再靠字号硬撑。
第十二轮起这条对**所有内容页**成立(七站 + 项目总览 / 平台资产库 / 模型控制台
/ 用户管理 / 账号 / 手册):组件也只剩 PageHead 一个,旧的 NodeHead 并了进来,
「环节页头」和「全局页页头」再也不是两套皮肤。
特异度:antd 5.29 把样式注进 <head> 与 app.css 抢先后,两个类起步,
body 内边距那条堆到三个类才压得住 `.ant-card-small > .ant-card-body`。 */
.nex-panel.nex-nodehead {
.nex-panel.nex-pagehead {
border-color: var(--ant-color-primary-border);
background: linear-gradient(115deg,
color-mix(in srgb, var(--ant-color-primary) 7%, var(--ant-color-bg-container)) 0%,
var(--ant-color-bg-container) 58%);
}
html[data-theme='dark'] .nex-panel.nex-nodehead {
html[data-theme='dark'] .nex-panel.nex-pagehead {
background: linear-gradient(115deg,
color-mix(in srgb, var(--ant-color-primary) 14%, var(--ant-color-bg-container)) 0%,
var(--ant-color-bg-container) 58%);
}
.nex-panel.nex-nodehead > .ant-card-body { padding: var(--ant-padding-sm) var(--ant-padding-lg) }
/* 眉标左侧那枚环节图标:与统计卡那只 32px 色块同族,只是页头这行字矮,降到 20px */
.nex-nodehead-mark {
display: inline-flex; align-items: center; justify-content: center;
inline-size: 20px; block-size: 20px; flex: none;
border-radius: var(--ant-border-radius-sm);
background: color-mix(in srgb, var(--ant-color-primary) 14%, transparent);
color: var(--ant-color-primary);
font-size: var(--ant-font-size-sm);
}
.nex-panel.nex-pagehead > .ant-card-body { padding: var(--ant-padding-sm) var(--ant-padding-lg) }
/* 门牌第一行(菜单同款图标 + 一级标题)定高 = 控件档。
症状(2026-11 第十二轮 · 用户原话「右侧的主功能入口要对齐」):主操作原先挂在
**整块页头**的垂直中线上,七站的职责说明有的两行有的一行,那颗主按钮在每一页的 y
都不一样;概览页没有动作时中线还空着。第一行既然定高,同排右对齐的动作组就必然
七站同高、右缘贴卡内边距——「对齐」由几何保证,不靠页面自己垫 margin。 */
.nex-pagehead-title { min-block-size: var(--ant-control-height) }
/* ── 顶栏流程控制台(PipelineConsole):一颗**打开项目概况抽屉**的按钮 ──────
症状(用户第 2 条):项目身份在站内说了三遍——顶栏这颗胶囊、外壳那条面包屑、
@ -436,20 +436,35 @@ html[data-theme='dark'] .nex-tag.ant-tag { background: color-mix(in srgb, var(--
为什么用 color-mix 而不是新色值:站内 `#hex` 只许出现在 theme/antd.ts(§2),
这里按语义色变量比例混合,明暗两档自动跟着主题走,不产生第二套色板。 */
.nex-stat { --nex-stat-tint: var(--ant-color-primary) }
.nex-stat-mark {
/* 色块族(统计卡 / 内容页门牌 / 概况抽屉的七站行):一套几何两档大小。
门牌那枚(.nex-pagehead-mark)取的是 `app/layout/nav.tsx` 里菜单项的图形本身,
和侧栏同一份 ReactNode——菜单换图当天页头跟着换,不存在「两边长得不一样」。
`--nex-stat-tint` 缺省时落回主色:页头与抽屉行没有 tone,统计卡才有。 */
.nex-stat-mark, .nex-pagehead-mark, .nex-brief-mark {
display: flex;
align-items: center;
justify-content: center;
flex: none;
background: color-mix(in srgb, var(--nex-stat-tint, var(--ant-color-primary)) 12%, transparent);
color: var(--nex-stat-tint, var(--ant-color-primary));
}
.nex-stat-mark, .nex-pagehead-mark {
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);
/* 概况抽屉里的七站行整行只有 34px,色块降到控件小档,不然行高被它顶开 */
.nex-brief-mark {
inline-size: 20px;
block-size: 20px;
border-radius: var(--ant-border-radius-sm);
font-size: var(--ant-font-size-sm);
}
html[data-theme='dark'] .nex-stat-mark,
html[data-theme='dark'] .nex-pagehead-mark,
html[data-theme='dark'] .nex-brief-mark {
background: color-mix(in srgb, var(--nex-stat-tint, var(--ant-color-primary)) 18%, transparent);
}
/* ── 只读回显(Info = antd Descriptions):R16.3 ──────────────────────────────