文档
08_归档04_VOZEB任务卡

VOZEB-UI-MIGRATION-02-M10-WORKS — 作品发布列表页

Task ID: VOZEB-UI-MIGRATION-02-M10-WORKS
目标用户结果: 用户能在统一 Ocean Air 壳层中查看、筛选、编辑、提交、下架、上架和删除自己的发布作品
Feature ID / Atomic Requirement IDs: EXEC-P0-003;HOME-P0-001(仅承载作品列表视觉与既有交互)
Base SHA: dee4a179316166dfe2d6f9ddbad0ee7907afc8a1
必须阅读: VOZEB-UI-FOUNDATION-01.md;VOZEB-UI-MIGRATION-02.md;work-publications.ts;work-publication-values.ts;现有发布编辑器契约
允许修改: 本任务包;web/src/app/(user)/works/page.tsx(含本页直属作品卡);web/src/app/(user)/works/works-page.module.css;web/src/app/(user)/works/works-list-layout.test.ts
禁止修改: work-publication-editor.tsx;work-publication-values.ts;services/api/**;lib/server/**;发布状态机、公共作品页、作品详情、社区、API/contracts/Go/migrations;共享 Ocean/UI 组件;layout/navigation;其它页面
范围: 将作品列表页接入 OceanGlassCard、OceanContentCard、OceanLoadingShell、OceanStatusCluster、OceanUtilityControl、OceanReveal 和 OceanDialog;统一标题、筛选、作品媒体预览、状态徽标、操作栏、加载/错误/空态、分页与申诉弹层的 Ocean Air 视觉
非目标: 不改变发布/审核/治理状态机、请求参数、分页/防抖、来源选择、媒体 URL、权限、分享链接、复制/预览、创建/编辑编辑器或任何后端语义;不新增页面级背景、WebGL 或真实上游调用
已冻结契约与数据模型: WorkPublication、WorkPublicationVersion、WorkPublicationAsset、listWorkPublications、submit/revoke/relist/deleteWorkPublication、submitWorkAppeal、WorkPublicationEditor callbacks、/works?sourceType=&sourceId= 与 /share/:slug 路由保持不变
安全与数据限制: 仅使用现有登录会话和服务端返回的短期媒体预览;不读取或输出 Secret,不写浏览器业务持久化,不触发真实上游、账务或生产写入
验收命令: pnpm exec vitest run src/app/(user)/works/works-list-layout.test.ts;pnpm exec tsc --noEmit --pretty false;pnpm exec eslint src/app/(user)/works/page.tsx src/app/(user)/works/works-list-layout.test.ts --quiet;pnpm exec prettier --check docs/oceanway/VOZEB-UI-MIGRATION-02-M10-WORKS.md src/app/(user)/works/page.tsx src/app/(user)/works/works-page.module.css src/app/(user)/works/works-list-layout.test.ts;pnpm run build;git diff --check
人工决策点: LOCAL_IMPLEMENTATION_CANDIDATE / CANDIDATE_EVIDENCE / NOT_FORMAL_TEST;公共作品页、社区和作品详情另行迁移
交付物: Ocean Air 作品发布列表、直属媒体优先作品卡、状态/加载/错误/空态、申诉玻璃弹层、响应式视觉契约测试和任务包

验收边界

  • 列表页继续复用 AppWorkspaceShell 提供的单一背景,不新增 OceanAmbientBackground、WebGL renderer 或每卡独立的 Liquid Glass renderer。
  • listWorkPublications 的 page/pageSize/status/keyword、300ms 防抖、来源自动打开、发布编辑器、 提交/下架/上架/删除/申诉回调与分享链接行为保持不变。
  • 当前版本的媒体预览只读取服务端 currentPreview.previewUrl;图片通过既有 imagePreviewUrl 请求 限宽 WebP,缺失或加载失败时显示中性占位,不改变发布事实。
  • 标题、说明、状态、元信息和按钮使用 Ocean Air 中性文字;主题色只承担主操作、焦点和图形强调, 不出现蓝色正文或仅靠颜色表达状态。
  • 390px、430px、窄桌面无横向溢出;reduced motion/transparency 与 forced colors 下内容仍可读且不依赖动画。
  • 本切片只登记候选实现,不提升正式 Development、Testing 或 Operations 状态。

On this page