From cceafe4e566e0f09c050c105e45d9c277f78358f Mon Sep 17 00:00:00 2001 From: "mula.liu" Date: Thu, 12 Nov 2026 18:53:28 +0800 Subject: [PATCH] v 0.1.2 --- AGENTS.md | 123 +++------ nex.config.yaml | 150 ++--------- nex_design_system | 1 - scripts/seed/model_secret_keys.json | 15 -- scripts/seed/model_specs.json | 392 ---------------------------- scripts/seed/users.json | 24 -- 6 files changed, 70 insertions(+), 635 deletions(-) delete mode 160000 nex_design_system delete mode 100644 scripts/seed/model_secret_keys.json delete mode 100644 scripts/seed/model_specs.json delete mode 100644 scripts/seed/users.json diff --git a/AGENTS.md b/AGENTS.md index 7f99fc9..6d1cde6 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,94 +1,55 @@ -# Nex Animation Studio — Agent 工作手册(项目级入口) +# NEX Design System — Agent Entry Rules -本项目引入 **NEX Design System 0.1.1** 作为跨项目设计标准。NEX 给的是**原则**, -不是本项目的固定布局模板、技术栈或尺寸表。本项目已经过 20 余轮真实设计与交互 -修正,**已验证成熟的设计、组件和交互优先保留**;不得为了让数字与 NEX 一致而 -反向修改本项目。 +本项目采用 NEX Design System。开始任何前端页面、组件或样式工作前,必须先读取本文件及下列文档: -## 1. 规范优先级(冲突时从上往下) +- `docs/02-design-principles.md` +- `docs/03-design-tokens.md` +- `docs/04-layout-system.md` +- `docs/05-component-system.md` +- `docs/06-interaction-system.md` +- `docs/07-page-patterns.md` +- `docs/08-accessibility-responsive.md` +- 项目根目录的 `nex.config.yaml`(如存在) -| 层 | 文件 | 负责什么 | -|---|---|---| -| 1 | `docs/UI规范.md` | **项目级 UI/UX 权威**:20 条硬规则 R1–R20、§1–§16 全部尺子与口径、14 道常驻探针、十二步改动流程 | -| 2 | `docs/工程规范.md` | 目录职责、脚本准入、代码风格、部署、删除策略、最低验收 | -| 3 | `docs/NEX-对照与例外.md` | NEX 逐条判定(COMPLIANT / ADOPTED / ADAPTED / DEFERRED / NOT APPLICABLE)与**项目级例外登记**;NEX 与本项目冲突时按此文件执行 | -| 4 | `nex.config.yaml` | 项目现状声明(真实尺寸、真实技术栈、真实检查命令)。改了布局尺寸必须同步它 | -| 5 | `frontend/src/theme/antd.ts` → `styles/index.css` | 数值的**唯一实现**;文档与它冲突时以实现为准并回头修文档 | -| 6 | `nex_design_system/docs/02–08` | 跨项目原则层(设计原则 / token 治理 / 布局体系 / 组件系统 / 交互系统 / 页面模式 / 可访问性与响应式) | +读取 `nex.config.yaml` 时,必须同时遵守 `requirements` 与 `rules`:前者定义项目必须达到的设计/体验结果,后者定义具体实现约束。特别是 `maintain_existing_interactions: true`,表示不得在视觉改造中擅自改变既有业务操作路径;确需调整时,必须先说明影响并纳入任务验收。 -开始任何前端页面、组件或样式工作前,至少读取:本文件、`nex.config.yaml`、 -`docs/NEX-对照与例外.md`,以及任务涉及的 `docs/UI规范.md` 章节。 -涉及既有页面时,必须先读该页现有 JSX、CSS 与所依赖的共享组件, -禁止只根据需求描述另造一套样式。 +任务涉及既有页面时,还必须先读取该页面现有 JSX、CSS 和所依赖的共享组件,禁止只根据需求描述重新造一套样式。 -`nex.config.yaml` 的 `requirements` 与 `rules` 都是**实施约束**:前者是必须达到的 -结果,后者是具体实现限制。特别是 `maintain_existing_interactions: true` —— -视觉改造不得改变既有业务操作路径;确需调整时先说明影响并纳入验收。 +## 强制规则 -> ⚠️ 历史坑:NEX 0.1.1 的 `docs/01-project-audit.md` 与 `nex.config.yaml` 样例描述的是 -> **另一个产品 NexDocus**。它的 `Header 64 / Sider 260·80 / Content 16·1280 / -> 控件 34·40 / 无 Tailwind / 204 处硬编码色` 均**不是本项目现状**。 -> 逐条对照见 `docs/NEX-对照与例外.md`。 -> 同理:`.trash/` 与 `.local/` 已被 gitignore,是本地杂物,**不作为现状依据**。 +1. **先复用,后新增。** 先搜索已有 NEX 组件、页面模式和设计令牌;禁止创建功能或视觉重复的组件。 +2. **不擅自改技术栈。** 项目技术栈以项目配置和 `package.json` 为准。不得借 UI 任务升级 React、替换 Ant Design、引入 Tailwind 或改变 JS/TS 方案。 +3. **禁止硬编码设计值。** 颜色、字体、间距、圆角、阴影、层级和布局尺寸必须使用 NEX token。确实属于内容本身的颜色(如 Markdown 语法高亮、第三方品牌标识)可例外,但必须限定作用域并说明原因。 +4. **禁止私自建立视觉变体。** 新增颜色、按钮尺寸、卡片样式、页头样式或交互模式前,先确认是否能映射到既有 token/variant;不能映射时先更新 NEX 规范。 +5. **页面不得绕开共享模式。** 列表页、详情页、表单页、Dashboard、设置页必须采用 `docs/07-page-patterns.md` 对应模板;特殊工作区按 `docs/04-layout-system.md` 选择专用 Shell。 +6. **交互状态完整。** 异步功能必须考虑 loading、success、empty、error、disabled 和权限不足状态;破坏性操作必须二次确认;可点击元素必须键盘可达。 +7. **不破坏工作区滚动结构。** 全屏/嵌套 Flex 或 Grid 工作区必须明确滚动容器;必要时设置 `min-width: 0`、`min-height: 0`,避免页面整体溢出或滚动穿透。 +8. **主题必须成对实现。** 任何表面、文字、边框、选中态、悬停态和状态色变更,都要检查 Light/Dark 两种主题。 +9. **不滥用局部覆盖。** 禁止在业务页用高优先级选择器、`!important` 或深层 Ant Design DOM 覆盖修补本应由 token/组件主题解决的问题。确实需要时应写明原因并尽可能限域。 +10. **先提交计划再改动。** 超过单一组件的小任务,先列出将复用/新增的组件、涉及页面、状态和验收点;不要在未梳理依赖时直接批量修改。 -## 2. 必须保留的资产(改动前先自查) +## 标准工作流 -- **技术栈**:React 18 + TypeScript + Vite + antd 5 + **Tailwind CSS v4**(只做布局)+ zustand。不升级、不换库、不引入第二套 UI 组件包。 -- **单向 Token 流程**:`theme/antd.ts` → `applyRootVars()` → `:root{--ant-*}` → `styles/index.css @theme` → Tailwind 语义类。禁止反向造第二把尺子,**禁止新增 `--nex-*` 全局变量命名空间**(该前缀已被 9 个组件局部变量占用,见对照文档 §4)。 -- **已验证尺寸**:Header 56 / Sider 224·折叠 64 / Content 24(窄屏 16·12)/ 最大宽 1680 / 控件 32·24·40 / 圆角 6·8·4 / 断点 576·768·992·1200·1600 / 主色为 antd 出厂蓝(不覆盖 `colorPrimary`)。 -- **主题机制**:跟随系统 + 手动 + `localStorage` + `` + `color-scheme` + `meta theme-color` + `⌘⇧L`。 -- **共享组件 kit**:`frontend/src/components/{ui,forms}`(25 文件 / 163 导出)。NEX 05 §3 要求的第一批标准组件**已全部存在**,用它们,不要新造。 -- **Empty 三分类**:没数据 / 没匹配 / 引导下一步,文案分开,且能清除筛选恢复默认。 -- **反馈四级表面**(R19):`ErrorText`/`LineHint` → `Notice` → `notify*` 吐司 → `confirmAction`。长任务唯一进度源是顶栏「平台动态」(§13.7),页面内不得再放第二个进度条。 -- **专业工作区交互**:分镜卡拖拽、时间线、录音、素材灯箱、版本面板的既有操作路径。 -- **质量闸门**:14 道常驻探针 + §16 十二步流程。这是 NEX 10「阶段 5 质量门禁」的现成实现,复用而非重造。 -- 本项目**没有**文档阅读 / PDF 预览 / AI Chat 工作区,不要为对齐 NEX 引入相应模板、布局或图表依赖。 +1. 检查现有页面、共用组件和 token。 +2. 明确页面类型、用户任务、关键状态和响应式行为。 +3. 在需要时先更新页面规格(`templates/page-spec.md`)。 +4. 优先修改共享组件/主题,再修改业务页面。 +5. 执行项目已有 lint/build/test;不得虚构项目中不存在的脚本。 +6. 做 Light/Dark、窄屏、键盘和状态检查。 +7. 汇报改动文件、复用组件、规范偏离、检查命令和未完成事项。 -## 3. 强制规则 +## 完成定义 -`docs/UI规范.md` §0 的 **R1–R20 是硬规则,违反任意一条 = 返工**(先读那 20 行)。在其之上再加: +任务只有在以下条件均满足时才可报告完成: -1. **先复用,后新增。** 先在 kit 里找;找不到才新增,且不得与已有件功能或视觉重复。 -2. **不擅自改技术栈。** 不得借 UI 任务升级 React / antd / Tailwind,或引入新组件库、图表库。 -3. **禁止硬编码设计值。** 颜色、字体、间距、圆角、阴影、层级、布局尺寸一律走 token / 语义类(R9)。 -4. **禁止私自建立视觉变体。** 新颜色 / 新按钮尺寸 / 新卡片或页头样式 / 新断点前,先确认能否映射到既有 token;不能映射时先登记例外。 -5. **交互状态完整。** loading / success / empty / error / disabled / 权限不足都要考虑;破坏性操作二次确认;可点击元素键盘可达(用正确的语义元素,不自造 `div + onClick`)。 -6. **不破坏工作区滚动结构。** 嵌套 Flex/Grid 必须明确滚动容器,必要时 `min-width:0` / `min-height:0`。 -7. **主题成对实现。** 任何表面 / 文字 / 边框 / 选中 / 悬停 / 状态色变更都要检查 Light 与 Dark。 -8. **不滥用局部覆盖。** 业务页禁止高优先级选择器、`!important`、深层 antd DOM 覆盖;`styles/app.css` 是全站唯一 `.ant-*` 出口。 -9. **浮层层级不写魔法数。** z-index 走 `frontend/src/lib/layers.ts` 的层级表与 `docs/UI规范.md` §10;浮层叠浮层时页面级快捷键先问 `floatingLayerOpen()`。 -10. **先提交计划再改动。** 超过单一组件的任务,先列将复用/新增的组件、涉及页面、状态与验收点。 +- 视觉层级和布局符合 NEX 对应页面模式。 +- 使用设计 token,而非散落硬编码值。 +- 交互状态完整且行为一致。 +- 不引入重复组件或不必要依赖。 +- 亮暗主题和响应式行为已检查。 +- 可运行的质量检查已执行;无法执行的检查必须明确说明。 +- 文档与实际行为不存在明显冲突。 -## 4. 标准工作流 +## 例外处理 -1. 查现有页面、共享组件、token(`components/{ui,forms}`、`theme/antd.ts`、`styles/`)。 -2. 明确页面类型、用户任务、关键状态、响应式行为;必要时写 `nex_design_system/templates/page-spec.md` 规格的页面版。 -3. 先改共享组件 / 主题,再改业务页面。 -4. 跑项目**真实存在**的检查(本仓库**没有** `lint` 与 `test`,不得虚构): - - ```bash - cd frontend && npm run typecheck && npm run build - node scripts/ui/classaudit.mjs - NEX_BASE=http://127.0.0.1:5199 .venv/bin/python scripts/ui/<按 §15 改动范围选探针>.py - ``` - -5. 按 `docs/UI规范.md` §16 走完十二步;**改过尺子(`theme/antd.ts`、`styles/index.css`、`styles/app.css`)必须全量回归,含 430 / 576 窄屏**(R12)。 -6. 做 Light/Dark、窄屏(1440 / 768 / 430)、键盘与状态检查。基线是 **14 路由 × 3 视口 × 2 主题 = 84 个状态**,新截图必须与之可比。 -7. 汇报:改动文件、复用组件、规范偏离、检查命令与实际结果、未完成事项。 - -## 5. 完成定义 - -- 视觉层级与布局符合 `docs/UI规范.md` 对应页面模式; -- 用 token 而非散落硬编码; -- 交互状态完整且跨页一致; -- 不引入重复组件或不必要依赖; -- Light / Dark / 窄屏 / 键盘均已检查并有截图证据; -- 可运行的质量检查已执行且退出码为 0;跑不了的必须说明原因; -- 文档(含 `nex.config.yaml` 与本文件)与实际行为不冲突;偏离 NEX 的已登记在 `docs/NEX-对照与例外.md`。 - -## 6. 例外处理 - -偏离 NEX 或偏离 `docs/UI规范.md` 时,在 `docs/NEX-对照与例外.md` §3 登记: -偏离项 / NEX 条款 / 本项目值 / 证据位置 / 原因 / 影响范围 / 是否可复用 / 状态。 -**不得把单个业务例外自动推广为全局规范**,也不得复制一份与 `docs/UI规范.md` -大量重复的规范文档。需要修订 NEX 本身的,登记在对照文档 §5 反向清单里。 +业务需求确实要求偏离 NEX 时,先在页面规格中记录:偏离项目、原因、影响范围、是否可复用。不得把单个业务例外自动推广为全局规范。 diff --git a/nex.config.yaml b/nex.config.yaml index c4cd8bb..edd77f4 100644 --- a/nex.config.yaml +++ b/nex.config.yaml @@ -1,159 +1,65 @@ -# ───────────────────────────────────────────────────────────────────────────── -# Nex Animation Studio · NEX 项目配置 -# -# 本文件是「项目现状声明」,不是愿望清单:每个数值都能在前端代码里查到出处。 -# NEX Design System 0.1.1 是跨项目通用设计标准,不是本项目的固定布局模板。 -# NEX 与本文件冲突时,以本文件 + docs/UI规范.md 为准(判定与例外见 -# docs/NEX-对照与例外.md)。 -# -# 维护规则:改了 theme/antd.ts、app/layout/AppSider.tsx、app/App.tsx 里任何 -# 一个布局尺寸,必须同步本文件,否则本文件就失去了「现状声明」的资格。 -# ───────────────────────────────────────────────────────────────────────────── +# NEX 项目配置样例。项目启动时复制为项目根目录 nex.config.yaml 并按实际情况修改。 nex: system: NEX Design System - version: 0.1.1 + version: 0.1.7 compliance: required - # 规范权威顺序(自上而下)。NEX 文档在最下层:它给原则,不给本项目尺寸。 - authority: - - docs/UI规范.md # 项目级 UI/UX 权威:尺子、口径、20 条硬规则、§15 探针清单 - - docs/工程规范.md # 目录职责、脚本准入、测试与部署 - - docs/NEX-对照与例外.md # NEX 逐条判定 + 项目级例外登记(冲突时按此执行) - - frontend/src/theme/antd.ts # 数值的唯一实现 - - nex_design_system/docs/ # 跨项目原则层(02–08)与采纳路线(09–10) project: - name: Nex Animation Studio - type: enterprise-web-app # 长视频编导工作台(流水线型专业工具,非内容站) + name: NexAnimation + type: enterprise-web-app language: zh-CN frontend: framework: react framework_version: "18" - language: typescript # 全站 TS,0 个 .jsx/.js 页面 + language: typescript # 当前项目事实;新项目可配置 typescript build_tool: vite ui_library: antd ui_library_version: "5" - # 注意:NEX 0.1.1 样例写的是 css-variables-and-plain-css,那是另一个产品 - # (NexDocus)的现状。本项目是 Tailwind v4 只做布局、视觉全部交还 antd。 - styling: tailwind-v4-over-antd-tokens - styling_flow: theme/antd.ts → applyRootVars() → :root{--ant-*} → styles/index.css @theme → Tailwind 语义类 - styling_rules: - - 单向:antd token → --ant-* → @theme → Tailwind 语义类;禁止反向在页面里造颜色/字号/圆角档 - - 禁止新增与现有局部变量冲突的 --nex-* 变量命名空间(已占用:见 docs/NEX-对照与例外.md §4) - - styles/app.css 是全站唯一允许出现 .ant-* 选择器的文件 - - 布局 utility 依赖三层层叠声明,见 docs/UI规范.md R13 + styling: css-variables-and-plain-css router: react-router - router_version: "6" state_management: zustand - charts: none # 无图表依赖、无图表组件;Dashboard 的「趋势层」不适用 - icons: "@ant-design/icons,且只在 components/icons/ 目录里的两张表 import:core.ts(首屏外壳可达 54 只)/ extra.ts(只有懒页面要 24 只);index.ts 是桶(只转发 core),_kit.ts 不含图形(R11 · 阶段 25 起,边界由 classaudit 附三守)" - # 应用外壳:以下是本项目**已验证**的尺寸,NEX 的 64/260/80/16/1280 不适用于本项目 + # NEX 0.1 的项目现状对齐基线,后续如经截图验证可调整 shell: default: NexAppShell - header_height: 56 # theme/antd.ts:113 HEADER_HEIGHT - sidebar_width: 224 # app/layout/AppSider.tsx:47 SIDER_WIDTH(窄屏抽屉同宽) - sidebar_collapsed_width: 64 # app/layout/AppSider.tsx:49 SIDER_COLLAPSED_WIDTH(仅 ≥768 手工折叠) - sidebar_narrow: drawer # <768 不渲染 Sider:app/App.tsx:187 + AppSider.tsx:145 AppNavDrawer - content_padding: 24 # app/App.tsx:188(窄屏 16 / 12:max-lg:p-4 max-md:p-3) - content_max_width: 1680 # app/App.tsx:189 - note: 以上尺寸均已验证;要改先登记例外(docs/NEX-对照与例外.md §3) - - # 控件与圆角一律沿用 antd 默认档位;NEX 03 §7/§5 的 34/40 与六档圆角不适用 - controls: { sm: 24, md: 32, lg: 40 } - radius: { xs: 2, sm: 4, base: 6, lg: 8, full: 9999 } - font_sizes: { sm: 12, base: 14, lg: 16 } - breakpoints: [576, 768, 992, 1200, 1600] # = antd Grid xs…xxl;禁止私档断点(R9) - # 登记断点(UI规范 §4 / NEX 04 §8.1):一把尺子只服务一个表面,px 由 16 档视口实测得出,不得随意并入主阶梯。 - # 这五档 + 主阶梯由 classaudit.mjs 第 9 闸 BP 与 styles/index.css 的 --breakpoint-* 逐档对账。 - breakpoints_registered: - insp-lg: 1400 # Storyboard.tsx 检查器宽度第一档 - board: 1240 # Storyboard.tsx 看板卡宽地板 320→288(auto-fill,minmax(地板,1fr),上限不写在轨道上) - insp-md: 1080 # Storyboard.tsx 检查器宽度第二档 - insp-sm: 720 # Storyboard.tsx 检查器整屏 + 素材列表单列 - agent: 620 # AgentConsole.tsx 指令折叠头整行折行 - color_primary: antd-default # 不覆盖 colorPrimary:light #1677ff / dark #1668dc 由算法给 - z_index: 见 docs/UI规范.md §10 与 frontend/src/lib/layers.ts(阶段 3 建立层级表) + header_height: 64 + sidebar_width: 260 + sidebar_collapsed_width: 80 themes: - light - dark - theme_mechanism: # 比 NEX 06 §8 的假设更完整,保留现状 - - 跟随系统 prefers-color-scheme + 手动覆盖 - - localStorage: nex-the - - + color-scheme + - - 快捷键 ⌘⇧L - - 自绘区域与控件读同一批 --ant-*(cssVar: true),切主题不重算样式表 - # NEX 07 的页面模式在本项目的适用性(不适用 ≠ 不符合,见对照文档 §2) page_patterns: - applicable: [dashboard-overview, data-list, detail, settings, auth-standalone, canvas-workspace, review-approval] - not_applicable: [document-workspace, conversation-workspace] # 本项目没有文档/PDF/AI Chat 页面 - project_specific: [canvas-workspace, review-approval] # NEX 尚无对应模板,需在 NEX 侧补 - components: - kit: [frontend/src/components/ui, frontend/src/components/forms] # 25 文件 / 163 导出,NEX 05 §3 已 100% 覆盖 - nex_react_package: forbidden # 不引入第二套 NEX 组件包 - media_kit: frontend/src/components/media # 灯箱/缩略图/录音/版本面板,专业交互,保留 - a11y_focus_owner: frontend/src/styles/app.css 全站 :focus-visible 兜底 + - dashboard + - list + - detail + - form + - settings + - document-workspace + - conversation-workspace - # 项目真实存在的检查命令。没有 lint,也没有 test —— 不得虚构。 - verification: - npm_scripts: [dev, build, typecheck, preview] - ui_gates: - - node scripts/ui/classaudit.mjs # 静态:12 族(9 条 + 附/附二/附三 = 死类名/图标 import/出口形状 ICONA/图标型控件命名 ICNN 四点/两级表边界/裸 button/浮层底部/antd import/反馈表面/标题图形/标签皮肤/断点对账)· 末尾 FAMILY 行是族账与退出码的同源凭据 - - .venv/bin/python scripts/ui/visualcheck.py - - .venv/bin/python scripts/ui/tableaudit.py - - .venv/bin/python scripts/ui/gridcheck.py - - .venv/bin/python scripts/ui/rhythmcheck.py - - .venv/bin/python scripts/ui/tagcheck.py - - .venv/bin/python scripts/ui/btnrowcheck.py - - .venv/bin/python scripts/ui/aligncheck.py - - .venv/bin/python scripts/ui/symmetrycheck.py - - .venv/bin/python scripts/ui/footercheck.py - - .venv/bin/python scripts/ui/btnclustercheck.py - - .venv/bin/python scripts/ui/feedbackcheck.py - - .venv/bin/python scripts/ui/semanticcheck.py # 阶段 8.5 第 4 项:辅助技术语义与行为(AX 名称/热区/Tab/焦点环/ARIA/live/六态/字形名外泄 GLYPH/浏览器原生文件控件文案外泄 FILE/窄屏溢出页签键盘通道 TABKBD/antd 内置文案语言包回落 LOCALE)· 十一条判据(FILE = 阶段 35 · S-3 新增,两条一头一尾:DOM 侧 input[type=file] 必须自带含汉字 aria-label;AX 侧任何未忽略节点名称里不许出现 Choose File / No file chosen) - - .venv/bin/python scripts/ui/projectswitchcheck.py # 阶段 33 第 14 道:换项目时的数据生命周期(① 不残留上一个项目的节点 / ② 详情 404 必须认错且切回能恢复 / ③ 静置跨一轮 6 s 轮询不许闪)· 退出码 = 缺陷条数,凑不出两个节点指纹不同的项目 ⇒ EXIT=2 说「无法判定」,不伪装成绿 · 口径 docs/UI规范.md §15.14、行为 §13.13 - - .venv/bin/python scripts/ui/gateprobe.py # 反向验证:证明闸门真的会红 · 29 条判据(19 条页面判据(18 条 fixture + ⑱ 真组件溢出页签 TABKBD)+ 整名一条 ⑲(两腿算一条)+ 静态八条 ⑰ 图标出口形状 / ㉒ 产物预算 / ㉓ 图标命名 / ㉔ AT 图形中文名 / ㉖ 图标登记表两级表 / ㉗ 归属尺自证空转 / ㉙ S-2 宿主级缺名 / ㉚ 原生文件控件文案)+ 探测器自证一条 ㉘ `projectswitchcheck.matches`(与 docs/UI规范.md §15.12 同口径;条数以末行为准))· 阶段 35 实测 `GATEPROBE_OK 29/29`、`grep -c '^OK'` = 205(阶段 34 的 198 + 7 条 ㉚三坏四好)· ⚠ 末行分母是 `len(checks) + 11` 这个加出来的常数,加判据必须同时抬它(阶段 35 之前它停在 +10,末行连着谎报 28/28)· 阶段 34 实测 `GATEPROBE_OK 28/28`、`grep -c '^OK'` = 198(+ 12 条 ㉙七坏五好)(阶段 32 的 184 + 2 条 ㉘,阶段 31 的 180 + 4 条 ㉓ 第四支)、FAIL 0(阶段 31 是 180 = 阶段 25 165 + 15 条 ㉗) · 实数看末行 GATEPROBE_OK N/N 与 grep -c '^OK' - # 产物级闸(不吃页面、跑在 dist 上):改分包 / 动依赖 / 调预算时必须跑,见 docs/UI规范.md §13.11 - artifact_gates: - - node scripts/ui/chunkbudget.mjs # 逐文件 raw 预算闸(kB=1000B,与 vite 控制台同尺)。上限三层来源:显式 --config > 构建器落盘 dist/.vite/rollup.config.json > 项目登记 frontend/chunk-budget.json;三层都没有才 DEGRADED + 兜底 1500 kB(退化≠放宽)。阶段 24 起真产物走第三层,不再长期挂 DEGRADED - - node scripts/ui/chunkinfo.mjs # 首屏闭包成分与三压缩口径读数(只读,恒退出 0)。⚠ 单位 n/1024 却标 kB,与上一条差 2.4 %,引用数字必须带工具名。归属段(只有带 .map 的产物才跑)自报三行机器可读读数 `ATTRIB_COVERAGE` / `ATTRIB_SUSPECT` / `ATTRIB_VERDICT=OK|SUSPECT|IDLE`(阶段 31:覆盖率 < 60 % ⇒ IDLE = 自证空转,那句「没有伪像」会被撤掉,别引用本轮归属读数);可选 `SOURCE_CHECK_STRICT=1` 把 IDLE/SUSPECT 升级成退出码 1,不设时本尺恒退出 0;`SOURCE_CHECK_MIN_COVERAGE` 可改门槛(默认 60) - - .venv/bin/python reports/ui_evidence/nex-p22/productsmoke.py # 真产物 :4173 上 14 路由 × 明暗冒烟(自带 /api 中继:vite preview 不代理 /api) - - .venv/bin/python reports/ui_evidence/nex-p22/lazyloadcheck.py # 真产物 :4173 上的懒加载结构判据 A/B/C1–C4/D + 录制全流程真点(判据以 DOMContentLoaded 为界,用 FCP 必假红) - # 只读普查,不进串行、无退出码:scripts/ui/census-icons.py(图标字形名现状量级,S-2 立项与收口对账用) - # 阶段 43 待授权(未升常驻,不进上面的串行清单):reports/ui_evidence/nex-p43/n14announce.py - # N14 播报保序尺——量同一次按键里「焦点回到卡片」与「live region 出现该文案」谁先发生; - # `--expect=after` 断言新顺序,`--expect=before` 是反向对照(新码上必须红,否则尺子不会红)。 - # 升 scripts/ui/ 需单独授权(阶段 41 口径:新尺先在证据层跑住,再谈常驻)。本轮读数 rc=0 / rc=1(设计如此)。 - baseline: 15 路由 × {1440,768,430} × {light,dark} = 90 个状态 # 阶段 4 起兜底页 /not-a-page 进 visualcheck 名单(14 → 15);更早的 84 状态基线逐条仍可对照 - flow: docs/UI规范.md §16(十二步改动流程,改尺子必须全量回归含 430/576) - dev_base_url: http://127.0.0.1:5173 # 2026-11-08 实测更正:`vite.config.ts:18` 的 `server.port` 就是 5173,闸门默认值(`semanticcheck.py` 与 `gateprobe.py` 里 `BASE` 的默认值)也是它。 - # 旧口径写的 :5199 / :8010 是当时手工起的实例,不是配置里的端口——:5199 的代理上游此刻已 502,照旧口径起服务会让所有页面闸门拿不到数据。 - dev_backend_port: 8000 # `vite.config.ts:10` 的 proxy target(默认 127.0.0.1:8000,可用环境变量 NEX_BACKEND 覆盖);:4173 是 preview,`vite.config.ts` 没有 preview.proxy,预览页无数据 - -# ── 项目必须达到的设计/体验结果(Agent 视为实施约束,不是参考建议)────────── +# 项目级设计与体验要求。Agent 必须将这些要求视为实施约束, +# 不能仅把它们当作参考建议。 requirements: + # 可复用的布局、组件和页面模式优先使用 NEX/项目现有共享实现; + # 只有在确认没有合适实现后,才允许新增组件。 use_shared_components: true + + # 颜色、字体、间距、圆角、阴影、层级和布局尺寸统一从 Design Tokens 获取; + # 不得在业务页面散落硬编码设计值。 use_design_tokens: true + + # 优化 UI/UX 时必须保留现有业务交互和用户已形成的操作路径; + # 如确需改变,必须先说明原因、影响范围和迁移方案,并通过回归验收。 maintain_existing_interactions: true - # 本项目追加:成熟资产优先保留,禁止为形式统一重写已验证实现 - preserve_validated_design: true - single_token_source: true # antd token 是唯一尺子 - light_dark_pair_review: true rules: hardcoded_design_values: forbidden direct_ant_design_usage: allowed_for_low_level_components - direct_ant_design_usage_scope: [theme/, app/providers.tsx, app/, components/ui/, components/forms/] - reusable_patterns_must_use_nex: true # 含义是「走 kit」,不是「装 NEX 包」 + reusable_patterns_must_use_nex: true require_light_dark_review: true require_responsive_review: true require_keyboard_review: true preserve_existing_stack: true - # 本项目追加 - custom_breakpoints: registered_only # R9:禁止裸 max-[Npx];确需时按 UI规范 §4 / NEX 04 §8.1 登记成命名断点(第 9 闸守护) - new_css_variable_namespace: forbidden # 不新增 --nex-* 全局令牌层 - nex_component_package: forbidden - chart_library_for_alignment_only: forbidden - batch_css_or_token_rewrite: forbidden diff --git a/nex_design_system b/nex_design_system deleted file mode 160000 index 10ccdc1..0000000 --- a/nex_design_system +++ /dev/null @@ -1 +0,0 @@ -Subproject commit 10ccdc164c8fa6ad5d22ff97c0af9c260ebf061b diff --git a/scripts/seed/model_secret_keys.json b/scripts/seed/model_secret_keys.json deleted file mode 100644 index ae67fc8..0000000 --- a/scripts/seed/model_secret_keys.json +++ /dev/null @@ -1,15 +0,0 @@ -{ - "_meta": { - "table": "model_secret_keys", - "count": 1, - "note": "密钥加密主密钥;缺了它 model_specs.api_key_encrypted 解不开" - }, - "rows": [ - { - "id": 1, - "key_value": "JpdlaRwZrycwCP3P2GE5MOrHkdWr3HYI78-1hgBK_yA=", - "created_at": "2026-10-23 08:09:56.881541", - "updated_at": "2026-10-23 08:09:56.881545" - } - ] -} diff --git a/scripts/seed/model_specs.json b/scripts/seed/model_specs.json deleted file mode 100644 index 1b1eddb..0000000 --- a/scripts/seed/model_specs.json +++ /dev/null @@ -1,392 +0,0 @@ -{ - "_meta": { - "table": "model_specs", - "count": 8, - "defaults": [ - "image=comfyui/qwen-image-2.1-turbo", - "llm=qwen/qwen3.7-plus", - "tts=comfyui/indextts2", - "video=comfyui/minimax-h3" - ], - "exported_at": "2026-11-10T14:53:55" - }, - "rows": [ - { - "id": 3, - "provider": "comfyui", - "model": "minimax-h3", - "display_name": "ComfyUI · minimax-h3", - "media_type": "video", - "adapter": "comfyui", - "enabled": true, - "is_default": true, - "status": "ready", - "model_code": "", - "timeout_seconds": 120, - "api_key_encrypted": "", - "max_concurrency": 1, - "requests_per_minute": 6, - "burst": 1, - "modes": [ - "t2v", - "i2v", - "fl" - ], - "resolutions": [ - "480p", - "720p" - ], - "aspect_ratios": [], - "min_duration": 5.0, - "max_duration": 15.0, - "max_reference_images": 6, - "price_per_second": 0.0, - "price_per_1k_chars": 0.0, - "currency": "CNY", - "default_params": {}, - "config_json": { - "base_url": "http://10.100.53.199:9200", - "workflow": "minimax_h3", - "models": { - "unet": "minimax_h3_ref2va_pruned_int8_convrot.safetensors", - "clip": "qwen3vl_32b_minimax_h3_nvfp4_awq.safetensors", - "clip_type": "minimax", - "video_vae": "minimax_h3_video_vae_fp16.safetensors", - "audio_vae": "minimax_h3_audio_vae_fp32.safetensors" - }, - "steps": 4, - "sampler": "res_multistep", - "scheduler": "simple", - "fps": 24, - "megapixels": 0.98, - "multiple": 32, - "input_subfolder": "nex_predator", - "filename_prefix": "nex_predator/1792639651", - "poll_interval": 5, - "timeout": 900, - "use_reference_images": true, - "unet_loader": "UNETLoader", - "clip_loader": "CLIPLoader", - "weight_dtype": "default", - "clip_device": "default", - "lora": "minimax_h3_ref2v_turbo_4step_v0.1_comfyui_bf16.safetensors", - "lora_strength": 1.0, - "max_edge": 1344, - "lora_ref2v": "minimax_h3_ref2v_turbo_4step_v0.1_comfyui_bf16.safetensors", - "lora_i2v": "minimax_h3_fl2v_turbo_4step_v1.0_768p_comfyui_bf16.safetensors", - "ref_image_size": "match", - "resolution_policy": "config" - }, - "notes": "自建 ComfyUI 工作流(MiniMax H3 原生音画同步)。镜头时长需在模型区间内,实际时长按 24fps 的 17 帧网格向上取整", - "created_at": "2026-10-21 04:44:16.134160", - "updated_at": "2026-11-05 08:29:49.727559" - }, - { - "id": 8, - "provider": "comfyui", - "model": "qwen-image-2.1-turbo", - "display_name": "Qwen-Image-2.1-Turbo(本地)", - "media_type": "image", - "adapter": "comfyui_image", - "enabled": true, - "is_default": true, - "status": "ready", - "model_code": "", - "timeout_seconds": 120, - "api_key_encrypted": "", - "max_concurrency": 1, - "requests_per_minute": 6, - "burst": 1, - "modes": [ - "t2i", - "edit" - ], - "resolutions": [ - "1024p", - "2k" - ], - "aspect_ratios": [ - "1:1", - "16:9", - "9:16", - "4:3", - "3:4" - ], - "min_duration": 0.0, - "max_duration": 0.0, - "max_reference_images": 4, - "price_per_second": 0.0, - "price_per_1k_chars": 0.0, - "currency": "CNY", - "default_params": {}, - "config_json": { - "base_url": "http://10.100.53.199:9200", - "workflow": "qwen_image_2_1_turbo", - "models": { - "unet": "qwen-image-2.1-turbo-Q4_K_M.gguf", - "clip": "qwen3vl_8b_int8_convrot.safetensors", - "vae": "qwen_image_2.1_vae_bf16.safetensors" - }, - "sampler": "euler", - "cfg": 1.0, - "sigmas": "1.0, 0.978453, 0.95418, 0.926626, 0.89508, 0.845148, 0.704534, 0.414568, 0", - "encoder_resolution": 1024, - "cache_device": "auto", - "cache_dtype": "default", - "filename_prefix": "nex/asset", - "poll_interval": 2, - "timeout": 1800, - "resource_group": "comfyui:9200" - }, - "notes": "9200 本地 GGUF,8 步蒸馏;支持参考图编辑,与 H3、IndexTTS 共用 GPU 串行调度", - "created_at": "2026-10-23 06:09:38.063862", - "updated_at": "2026-10-27 09:01:03.895660" - }, - { - "id": 9, - "provider": "comfyui", - "model": "indextts2", - "display_name": "IndexTTS2(本地音色克隆)", - "media_type": "tts", - "adapter": "comfyui_tts", - "enabled": true, - "is_default": true, - "status": "ready", - "model_code": "", - "timeout_seconds": 120, - "api_key_encrypted": "", - "max_concurrency": 1, - "requests_per_minute": 12, - "burst": 1, - "modes": [ - "voice", - "voice_clone", - "voice_instruct" - ], - "resolutions": [], - "aspect_ratios": [], - "min_duration": 0.0, - "max_duration": 0.0, - "max_reference_images": 1, - "price_per_second": 0.0, - "price_per_1k_chars": 0.0, - "currency": "CNY", - "default_params": {}, - "config_json": { - "base_url": "http://10.100.53.199:9200", - "workflow": "indextts2", - "model": "IndexTTS-2", - "download_from": "modelscope", - "load_node": "easy downloadIndexTTSAndLoadModel", - "generate_node": "easy indexTTSGenerateSimple", - "reference_audio": "nex_tts_reference.wav", - "input_subfolder": "nex_animation", - "filename_prefix": "audio/nex", - "poll_interval": 1, - "timeout": 900, - "resource_group": "comfyui:9200", - "generate_full_node": "easy indexTTSGenerate", - "instruct_node": "easy indexTTSEmotionText" - }, - "notes": "9200 本地 IndexTTS2;通过声线的参考音频 ID / 本地音频文件做音色克隆", - "created_at": "2026-10-23 06:09:38.064050", - "updated_at": "2026-11-05 08:29:49.727800" - }, - { - "id": 10, - "provider": "qwen", - "model": "qwen3.7-plus", - "display_name": "Qwen3.7", - "media_type": "llm", - "adapter": "http_llm", - "enabled": true, - "is_default": true, - "status": "ready", - "model_code": "llm_qwen3.7", - "timeout_seconds": 300, - "api_key_encrypted": "IpxVxYb3gerkDUXA3W3EfsN67mWk7d3_CYeWkNswH6s_WDoJsZkClmahLUmWP7_3S0h1d60qTu7nDZ7cilKkww6HmwyDgS6etxtWSK7GI2B2Eg==", - "max_concurrency": 4, - "requests_per_minute": 120, - "burst": 2, - "modes": [ - "chat", - "prompt" - ], - "resolutions": [], - "aspect_ratios": [], - "min_duration": 0.0, - "max_duration": 0.0, - "max_reference_images": 0, - "price_per_second": 0.0, - "price_per_1k_chars": 0.0, - "currency": "CNY", - "default_params": { - "temperature": 0.1, - "top_p": 0.97, - "max_tokens": 32768 - }, - "config_json": { - "base_url": "https://coding.dashscope.aliyuncs.com/v1", - "model": "qwen3.7-plus" - }, - "notes": "OpenAI 兼容真实大模型,用于人物/场景提示词补全、文案改写与分镜文本生成;密钥加密存储。", - "created_at": "2026-10-23 08:09:56.883206", - "updated_at": "2026-11-03 10:23:02.083984" - }, - { - "id": 12, - "provider": "mock", - "model": "mock-video-1", - "display_name": "Mock 视频(流水线自检)", - "media_type": "video", - "adapter": "mock", - "enabled": true, - "is_default": false, - "status": "ready", - "model_code": "", - "timeout_seconds": 120, - "api_key_encrypted": "", - "max_concurrency": 2, - "requests_per_minute": 60, - "burst": 1, - "modes": [ - "t2v", - "i2v", - "fl" - ], - "resolutions": [ - "480p", - "720p", - "1080p" - ], - "aspect_ratios": [ - "16:9", - "9:16", - "1:1", - "4:3", - "3:4", - "21:9" - ], - "min_duration": 1.0, - "max_duration": 30.0, - "max_reference_images": 4, - "price_per_second": 0.0, - "price_per_1k_chars": 0.0, - "currency": "CNY", - "default_params": {}, - "config_json": {}, - "notes": "生成模拟运镜片段,用于验证任务编排、质检与合成链路;不是真实 AI 视频", - "created_at": "2026-10-27 08:56:53.507012", - "updated_at": "2026-10-27 08:56:53.507013" - }, - { - "id": 13, - "provider": "mock", - "model": "mock-tts-1", - "display_name": "Mock 配音(占位人声)", - "media_type": "tts", - "adapter": "mock", - "enabled": true, - "is_default": false, - "status": "ready", - "model_code": "", - "timeout_seconds": 120, - "api_key_encrypted": "", - "max_concurrency": 4, - "requests_per_minute": 120, - "burst": 1, - "modes": [ - "voice" - ], - "resolutions": [], - "aspect_ratios": [], - "min_duration": 1.0, - "max_duration": 10.0, - "max_reference_images": 0, - "price_per_second": 0.0, - "price_per_1k_chars": 0.0, - "currency": "CNY", - "default_params": {}, - "config_json": {}, - "notes": "按文本长度生成占位人声,用于验证配音、字幕对齐与混音", - "created_at": "2026-10-27 08:56:53.507303", - "updated_at": "2026-10-27 09:01:00.744652" - }, - { - "id": 14, - "provider": "mock", - "model": "mock-image-1", - "display_name": "Mock 图像(资产自检)", - "media_type": "image", - "adapter": "mock_image", - "enabled": true, - "is_default": false, - "status": "ready", - "model_code": "", - "timeout_seconds": 120, - "api_key_encrypted": "", - "max_concurrency": 4, - "requests_per_minute": 60, - "burst": 1, - "modes": [ - "t2i", - "edit" - ], - "resolutions": [ - "512p", - "1024p" - ], - "aspect_ratios": [ - "1:1", - "16:9", - "9:16", - "4:3" - ], - "min_duration": 0.0, - "max_duration": 0.0, - "max_reference_images": 4, - "price_per_second": 0.0, - "price_per_1k_chars": 0.0, - "currency": "CNY", - "default_params": {}, - "config_json": {}, - "notes": "按提示词生成真实可打开的构图 PNG,用于验证角色定妆图、场景图与资产生成链路;不是真实 AI 绘图模型", - "created_at": "2026-10-27 08:56:53.507591", - "updated_at": "2026-10-27 09:01:03.895193" - }, - { - "id": 15, - "provider": "mock", - "model": "mock-llm-1", - "display_name": "Mock 大模型(离线自检)", - "media_type": "llm", - "adapter": "mock_llm", - "enabled": true, - "is_default": false, - "status": "ready", - "model_code": "", - "timeout_seconds": 120, - "api_key_encrypted": "", - "max_concurrency": 4, - "requests_per_minute": 60, - "burst": 1, - "modes": [ - "chat", - "prompt" - ], - "resolutions": [], - "aspect_ratios": [], - "min_duration": 0.0, - "max_duration": 0.0, - "max_reference_images": 0, - "price_per_second": 0.0, - "price_per_1k_chars": 0.0, - "currency": "CNY", - "default_params": {}, - "config_json": {}, - "notes": "离线大模型:仅验证结构化文本与提示词链路;图像生成请使用独立图像模型", - "created_at": "2026-10-27 08:56:53.507793", - "updated_at": "2026-10-27 09:00:42.558507" - } - ] -} diff --git a/scripts/seed/users.json b/scripts/seed/users.json deleted file mode 100644 index d63e0a7..0000000 --- a/scripts/seed/users.json +++ /dev/null @@ -1,24 +0,0 @@ -{ - "_meta": { - "table": "users", - "count": 1, - "note": "只导管理员;口令是 PBKDF2 哈希,不含明文" - }, - "rows": [ - { - "id": 1, - "username": "admin", - "display_name": "平台管理员", - "email": "", - "password_hash": "pbkdf2_sha256$180000$ZghwyAPJYAZX8HRjQl_2ug$8670f47313bb914be276da20aec41fc15b99dfca98b84adfb9d7df13c5c9ba78", - "role": "admin", - "is_active": true, - "must_change_password": false, - "note": "系统初始化自动创建,请尽快修改默认密码", - "prefs_json": {}, - "created_by_id": null, - "created_at": "2026-10-27 08:56:53.524106", - "updated_at": "2026-11-10 06:53:30.965457" - } - ] -}