08_归档04_VOZEB任务卡
VOZEB-UI-MIGRATION-02-M01 — 模型目录 Ocean Foundation 视觉切片
Task ID: VOZEB-UI-MIGRATION-02-M01
目标用户结果: 用户可以在 VOZEB 的 OceanWay 壳层中浏览、筛选和分页查看已发布的公开模型
Feature ID / Atomic Requirement IDs: MOD-P0-001
Base SHA: 1f7d0c2da7d089ac5dde6a9c8af095a33af53f96
必须阅读: VOZEB-UI-FOUNDATION-01.md；VOZEB-RETAIL-NEXT-KEY-MODEL-USAGE-01.md；现有 Retail Portal 模型契约
允许修改: 本任务包；web/src/app/(user)/models/page.tsx；同目录模型页面 contract test
禁止修改: BFF、contracts、服务 API、Foundation/shared components、左侧导航、其它页面、数据库、迁移和部署文件
范围: 以已完成 Ocean Foundation 组件和 Ocean Air token 重构模型目录的布局、状态层级、筛选与模型卡片
非目标: 改变模型数据语义、服务端搜索、分页协议、价格计算、权限、模型发布或任何其它路由
已冻结契约与数据模型: listRetailModels 只接受 capability/limit/offset；模型搜索仅对当前已加载页执行，不向服务端宣称 q 全目录搜索
安全与数据限制: 只展示 RetailPublicModel 的公开字段，不暴露 provider binding、channel、内部 token 或账号信息
验收命令: pnpm exec vitest run src/app/(user)/models/page.test.tsx；pnpm exec tsc --noEmit --pretty false；pnpm exec eslint src/app/(user)/models/page.tsx src/app/(user)/models/page.test.tsx --quiet；pnpm exec prettier --check docs/oceanway/VOZEB-UI-MIGRATION-02-M01-MODELS.md web/src/app/(user)/models/page.tsx web/src/app/(user)/models/page.test.tsx；git diff --check
人工决策点: 本切片为 LOCAL_CANDIDATE / CANDIDATE_EVIDENCE / NOT_FORMAL_TEST；需独立 Testing 与用户确认后方可进入后继页面集成
交付物: Ocean Foundation 模型目录页面候选、页面 contract test、该切片任务包验收边界
- 页面沿用现有 typed Retail API、capability 筛选、当前页客户端过滤、分页、loading/error/empty 语义。
- 页面不把客户端搜索描述为服务端全目录搜索；文案明确“当前页”。
- 页面使用
OceanGlassCard、OceanGlassSurface/Ocean Air token 与OceanReveal，不在页面内复制共享组件实现。 - 桌面、窄桌面和 390/430 移动视口不得产生水平溢出；交互控件保持键盘焦点和 reduced-motion 降级。
- 本候选不提升 Product、Design、Development、Testing 或 Operations 正式状态。