文档
08_归档04_VOZEB任务卡

VOZEB-UI-MIGRATION-02-F01 — Ant Design Overlay 液态玻璃兼容修复

Task ID: VOZEB-UI-MIGRATION-02-F01
目标用户结果: 登录用户打开确认、取回 Secret 等对话框时看到与 Ocean Foundation 一致的单层液态玻璃表面
Feature ID / Atomic Requirement IDs: HOME-P0-001(共享视觉基础);KEY-P0-001-R03
Base SHA: 28e6a9489952a745fa9b9249c1de48195c1aa35a
必须阅读: VOZEB-UI-FOUNDATION-01.md;VOZEB-UI-MIGRATION-02-M02-KEYS.md;Ant Design 6 Modal DOM contract
允许修改: 本任务包;web/src/components/ocean/overlays/ocean-overlays.module.css;web/src/components/ocean/ocean-component-kit.test.ts
禁止修改: 业务页面、API/BFF、contracts、数据库、导航、其它共享组件、部署文件
范围: 兼容 Ant Design 6 的 ant-modal-container,并保留旧 ant-modal-content 选择器作为安全回退;补充防回退的 CSS contract
非目标: 改变对话框行为、业务确认语义、动画时序或引入新的渲染器
已冻结契约与数据模型: Ocean Glass token、prefers-reduced-transparency、forced-colors 及单边框所有权
安全与数据限制: 仅视觉 CSS 与静态契约测试;不触发真实 API、Key、账务或外部写入
验收命令: pnpm exec vitest run src/components/ocean/ocean-component-kit.test.ts;pnpm exec tsc --noEmit --pretty false;pnpm exec eslint src/components/ocean/ocean-component-kit.test.ts --quiet;pnpm exec prettier --check docs/oceanway/VOZEB-UI-MIGRATION-02-F01-OVERLAYS.md web/src/components/ocean/overlays/ocean-overlays.module.css web/src/components/ocean/ocean-component-kit.test.ts;git diff --check
人工决策点: LOCAL_CANDIDATE / CANDIDATE_EVIDENCE / NOT_FORMAL_TEST;不提升 Foundation 或页面正式状态
交付物: Ant Design 6 overlay glass selector 修复与回归 contract

验收边界

  • OceanDialog 的当前 Ant Design 6 面板节点为 .ant-modal-container;.ant-modal-content 仅作为兼容回退。
  • 对话框仍由一个面板节点拥有背景、边框、圆角和阴影;透明度降级与 forced-colors 继续覆盖两种 DOM 版本。
  • 本任务不改变 Modal 的打开、关闭、确认、取消、焦点或销毁语义。

On this page