收口创作流程统一总计划并修复等待页窄屏裁切

docs/planning/README.md

@@ -0,0 +1,13 @@
+# 规划与优先级
+
+本目录保存仍处于推进中的阶段计划、并行任务拆分、可派发任务包和验收顺序。长期稳定的产品与架构口径仍以根部融合文档为准。
+
+## 当前计划
+
+- [【玩法创作】创作流程统一总计划-2026-05-30.md](./【玩法创作】创作流程统一总计划-2026-05-30.md)：创作入口、统一创作页、统一生成页、结果页、发布、作品架、广场和运行态的阶段计划、进度记录、并行波次和可直接派发的任务包。
+
+## 维护规则
+
+- 计划文档只记录可执行阶段、负责人切分、验收门禁和当前状态。
+- 已经稳定为长期约定的内容，应同步沉淀到 `docs/【玩法创作】平台入口与玩法链路-2026-05-15.md` 或 `.hermes/shared-memory/`。
+- 若代码事实与计划冲突，以代码和当前融合文档为准，并回写更新本目录。

docs/planning/【玩法创作】创作流程统一总计划-2026-05-30.md

@@ -0,0 +1,371 @@
+# 创作流程统一总计划
+
+更新时间：`2026-05-30`
+
+## 总览
+
+| 项目 | 当前值 |
+| --- | --- |
+| 总轮次 | 5 |
+| 当前轮次 | Round 4（已收口） |
+| 当前阶段 | Phase 6 |
+| 当前状态 | Phase 0~6 已收口；跨玩法回归、移动端竖屏 smoke、API smoke 和冻结材料已补齐 |
+| 当前并行波次 | 波次 D（验收与冻结） |
+| 当前重点 | 以跨玩法门禁作为后续新增玩法和回归的常规质量基线 |
+
+## 目标与范围
+
+本计划统一 Genarrative 所有玩法的创作链路，不再只跟踪首批的拼图、抓大鹅和敲木鱼。最终目标是让各玩法按同一条平台链路交付：
+
+```text
+创作入口 -> 统一创作页/工作台 -> 统一生成页 -> 结果页 -> 试玩 -> 发布 -> 统一作品详情/作品架/广场 -> 正式 runtime
+```
+
+统一不是把所有玩法 UI 做成同一个表单，而是统一阶段、契约、恢复、生成反馈、错误承接、发布后去向和验收门禁。各玩法工作台仍负责真实输入控件、资产槽位、校验和提交。
+
+## 当前进度
+
+| 阶段 | 状态 | 说明 |
+| --- | --- | --- |
+| Phase 0 总计划与门禁 | 已完成 | 本文档、`docs/planning/README.md`、`docs/README.md` 和 `.hermes/shared-memory/document-map.md` 已补齐入口；后续按 phase 扩展门禁。 |
+| Phase 1 首批统一壳 | 已收口 | `puzzle`、`match3d`、`wooden-fish` 已接入 `UnifiedCreationPage` / `UnifiedGenerationPage`，竖屏滚动和字段契约已回归。 |
+| Phase 2 契约与配置治理 | 已完成 | `creationTypes[].unifiedCreationSpec`、前端 fallback、后台配置校验和文档门禁已按现有测试与 schema 检查收口。 |
+| Phase 3 剩余表单/图片工作台接入 | 已收口 | 跳一跳、宝贝识物、方洞结果页与首批普通工作台回归已通过；方洞、大鱼按当前形态纳入最小回归，后续若迁移工作台再单独立项。 |
+| Phase 4 特殊工作台接入策略 | 已收口 | RPG、视觉小说、汪汪声浪的最小例外/闭环回归已通过，例外口径已落到平台总链路文档。 |
+| Phase 5 结果页、发布、作品架与广场收口 | 已收口 | 结果页、发布、公开详情、推荐 runtime 与公开 read model 最小自动回归已通过，公开详情作者展示口径已统一。 |
+| Phase 6 全链路验收与冻结 | 已收口 | 跨玩法 smoke、移动端优先验收、回归矩阵、长期维护规则和冻结证据已补齐。 |
+
+此表即总进度记录，后续每次 phase 收口、启动或回退时，只更新这里和下方任务状态。
+
+当前已完成 Round 0~4 / Phase 0~6。后续新增玩法或统一链路改动以本文档和 `quality-gates/【玩法创作】跨玩法回归与冒烟门禁-2026-05-30.md` 为常规质量基线。
+
+## 执行轮次
+
+按可交付批次拆成 5 轮（Round 0~4）。当前已完成 Round 0~4，Round 4 / 波次 D 已作为冻结基线收口。
+
+| 轮次 | 覆盖阶段 | 目标 | 状态 |
+| --- | --- | --- | --- |
+| Round 0 | Phase 0 | 补齐总计划、文档入口和并行任务表 | 已完成 |
+| Round 1 | Phase 2 | 契约与配置治理 | 已完成 |
+| Round 2 | Phase 3 + Phase 4 | 普通工作台并行接入，特殊工作台先定例外边界 | 已完成 |
+| Round 3 | Phase 5 | 结果页、发布、作品架与广场收口 | 已完成 |
+| Round 4 | Phase 6 | 全链路验收与冻结 | 已完成 |
+
+## 阶段拆分
+
+### Phase 0：总计划与执行门禁
+
+目标：让团队有一个唯一可查的总计划、进度表和并行任务清单。
+
+状态：已完成。
+
+- 新增本计划文档和 `docs/planning/README.md`，并在 `docs/README.md`、`.hermes/shared-memory/document-map.md` 中补上规划入口。
+- 补齐 `当前进度`、`执行轮次` 和可并行任务表，后续每个 phase 完成后更新本文档的状态、验收命令和风险。
+
+退出条件：
+
+- 文档入口可从 `docs/README.md` 找到。
+- 总计划包含阶段、进度、并行任务、验收和风险。
+
+### Phase 1：首批统一壳收口
+
+目标：用低风险的三条链路验证统一创作/生成壳。
+
+- 范围：`puzzle`、`match3d`、`wooden-fish`。
+- 创作页统一经过 `UnifiedCreationPage`，工作台保留各自真实输入能力。
+- 生成页统一经过 `UnifiedGenerationPage` 和 `CustomWorldGenerationView`。
+- 竖屏滚动由外层 stage 承担，避免内层滚动窗。
+
+状态：已收口。
+
+### Phase 2：契约与配置治理
+
+目标：把统一创作页从前端“能渲染”推进到平台配置“可治理”。
+
+- 明确 `unifiedCreationSpec` 的字段种类、必填语义、阶段映射和兼容 fallback。
+- 后台配置、前台读取和 `api-server` 路由熔断继续以 SpacetimeDB 入口配置为事实源。
+- 前端本地 fallback 只服务旧后端或本地异常，不作为新增玩法事实源。
+- 为字段契约、入口开放状态、阶段映射补自动测试。
+
+退出条件：
+
+- `creation-entry config` 契约在前后端文档中闭合。
+- 新增玩法不能绕过统一入口配置接线。
+
+状态：已完成。
+
+验证：`npm run check:encoding`、`npm run typecheck`、`npm run admin-web:typecheck`、`npm run check:spacetime-schema` 和统一创作页 / 统一生成页相关测试已通过。
+
+### Phase 3：剩余表单/图片工作台接入
+
+目标：把结构相近的玩法先迁到统一创作与生成壳，扩大覆盖面。
+
+候选范围：
+
+- 第一批直接迁移：`jump-hop`、`baby-object-match`
+- 需要先做工作台形态评估：`square-hole`、`big-fish`
+- 其它已经是表单/图片输入工作台、且无复杂多阶段编辑器的玩法
+
+统一要求：
+
+- 继续复用 `CreativeImageInputPanel`、`CreativeAudioInputPanel` 等现有通用输入组件。
+- 不在工作台 UI 中默认写规则说明或功能解释。
+- 自动素材生成走统一生成页；没有自动生成的玩法需要明确跳过生成页的阶段策略。
+- 结果页和 runtime 不因迁移创作页而改业务真相。
+- `square-hole`、`big-fish` 先评估是否保留 Agent 形态还是迁到表单/图片工作台，再决定是否进入直接迁移实现。
+
+退出条件：
+
+- 每个接入玩法都有创作页、生成页或跳过生成页的明确验收。
+- 移动端竖屏能从标题、表单滚动到提交按钮。
+
+状态：已收口。
+
+2026-05-30 回归记录：
+
+- `jump-hop`、`baby-object-match`、`big-fish`、`square-hole` 的核心工作台 / 结果页 / runtime 测试已补齐并通过。
+- `jump-hop` 结果页刷新恢复已补齐 `profileId -> getWorkDetail` 回读；直达 `/creation/jump-hop/result` 且缺少恢复参数时显示“跳一跳草稿未恢复”恢复面板，不再白屏。
+- `square-hole` 结果页的试玩 / 发布路径已补齐服务 mock 回归，确认保存成功后才触发试玩和发布回调。
+- 首批普通工作台回归通过：拼图、抓大鹅、敲木鱼、跳一跳、宝贝识物、方洞结果页。
+- 竖屏浏览器 smoke 已覆盖 `/creation/jump-hop`、`/creation/baby-object-match`、`/creation/square-hole`、`/creation/bark-battle`、`/creation/visual-novel`、`/creation/jump-hop/generating`、`/creation/jump-hop/result`、`/runtime/jump-hop`，截图保存在 `.app/browser-check/phase-flow-20260530/`。
+
+### Phase 4：特殊工作台接入策略
+
+目标：处理不能直接套表单/图片工作台的玩法，先定边界再迁移。
+
+候选范围：
+
+- RPG / 自定义世界
+- 视觉小说
+- 汪汪声浪（`bark-battle`）
+- 其它多阶段编辑器、对话式 Agent 或特殊创作流
+
+统一要求：
+
+- 必须在玩法文档中写明“创作工具模式例外”。
+- 例外只影响工作台内部，不影响入口配置、生成反馈、结果页、发布、作品架、广场和 runtime 的平台主链路。
+- 对话式或多阶段编辑器仍需和统一作品、统一错误、统一生成完成反馈对齐。
+- `bark-battle` 默认按特殊工作台收口；若后续产品决策确认可完全表单化，再单独前移到 Phase 3，不在本轮默认假设里。
+
+退出条件：
+
+- 每个特殊玩法都有例外声明、阶段映射和验收清单。
+- 没有新增平行入口系统、平行作品架或平行公开列表。
+
+状态：已收口。
+
+2026-05-30 回归记录：
+
+- RPG 例外边界指定 interaction 测试通过。
+- Bark Battle 创作入口、结果页试玩/发布和正式 runtime 指定 interaction 测试通过。
+- 视觉小说工作台、生成阶段、结果页和运行态测试通过，`npm run check:visual-novel-vn11` 通过。
+
+### Phase 5：结果页、发布、作品架与广场收口
+
+目标：把“创作页统一”推进到“交付链路统一”。
+
+- 发布成功默认进入统一作品详情或明确的 runtime 去向。
+- 草稿架能恢复生成中、失败、待发布和已发布状态。
+- 公开列表、发现流、详情页优先消费后端 read model 或 BFF 缓存。
+- 跨流程错误统一进入 `PlatformErrorDialog`，异步完成统一进入 `PlatformTaskCompletionDialog`。
+- 私有 generated 图片展示前必须换签。
+
+退出条件：
+
+- 每个可发布玩法都有作品架、公开详情、广场或明确不公开声明。
+- 生成中刷新、失败重试、发布后回读和登录切换都有测试或手测记录。
+
+状态：已收口。
+
+2026-05-30 回归记录：
+
+- 发布到作品详情、已发布作品进入详情、体验按钮直达 runtime、详情 profile 回读指定 interaction 测试通过。
+- 拼图已发布作品进入首页和移动端游戏分类、Big Fish 公开隐藏口径、Match3D 推荐 runtime 资源回读指定 interaction 测试通过。
+- 公开详情作者展示统一为“公开昵称 · 陶泥号”，`PlatformWorkDetailView` 与公共作者展示 helper 测试已回归。
+- 本地 API smoke 已在重新拉起 `dev:spacetime` 和 `dev:api-server` 后通过：`GET http://127.0.0.1:8082/healthz` 返回 `{"ok":true,"service":"genarrative-api-server"}`。
+
+### Phase 6：全链路验收与冻结
+
+目标：形成后续新增玩法可复用的稳定门禁。
+
+- 按玩法输出创作入口、生成页、结果页、试玩、发布、作品架、广场、runtime smoke 矩阵。
+- 增补 `quality-gates/README.md` 与跨玩法回归 / 冒烟门禁，不再只覆盖首批三条链路。
+- 固化移动端竖屏优先验收，桌面端作为兼容验证。
+- 补齐“新增玩法接入 PRD 检查块”和代码评审检查清单。
+
+退出条件：
+
+- 全部计划内玩法均有明确状态：已统一、例外接入、暂不接入。
+- `npm run typecheck`、`npm run check:encoding` 和对应玩法门禁通过。
+
+状态：已收口。
+
+2026-05-30 冻结记录：
+
+- Phase 2 自动回归通过：入口配置、统一字段 spec、统一创作页和统一生成页测试共 11 项。
+- Phase 3 自动回归通过：拼图、抓大鹅、敲木鱼、跳一跳、宝贝识物、大鱼、方洞结果页相关测试共 67 项；跳一跳直达结果页恢复测试通过。
+- Phase 4 / Phase 5 指定交互回归通过：RPG 例外边界、Bark Battle 闭环、作品详情、推荐 runtime、公开 read model 与跳一跳恢复相关 interaction 测试共 18 项。
+- Phase 5 详情 / 弹窗 / 作品架回归通过：公开详情、错误弹窗、反馈弹窗、作品展示 helper、作品架交互测试共 63 项。
+- `npm run check:visual-novel-vn11`、`npm run check:spacetime-schema`、`npm run check:encoding` 均通过。
+- API smoke 通过：`GET http://127.0.0.1:8082/healthz` 返回 `{"ok":true,"service":"genarrative-api-server"}`。
+- 竖屏浏览器 smoke 通过并保存截图：`.app/browser-check/phase-flow-20260530-round5/`，覆盖 `/creation/jump-hop`、`/creation/visual-novel`、`/creation/square-hole`、`/creation/bark-battle`、`/creation/baby-object-match`、`/creation/jump-hop/generating`、`/creation/jump-hop/result`、`/runtime/jump-hop`。
+
+### Phase 6 补充：跨玩法最小验收口径
+
+Phase 6 不再继续拆新波次，当前只把 Phase 2 到 Phase 5 的最小验证集合收束成一份可直接执行的门禁矩阵。建议顺序如下：
+
+| 阶段 | 最小命令 | 说明 |
+| --- | --- | --- |
+| Phase 2 | `npm run check:encoding`、`npm run typecheck`、`npm run admin-web:typecheck`、`npm run test -- src/components/platform-entry/platformEntryCreationTypes.test.ts src/components/unified-creation/unifiedCreationSpecs.test.ts src/components/unified-creation/UnifiedCreationPage.test.tsx src/components/unified-creation/UnifiedGenerationPage.test.tsx` | 校验入口配置、统一字段 spec、统一创作页和统一生成页。 |
+| Phase 3 | `npm run test -- src/components/puzzle-agent/PuzzleAgentWorkspace.interaction.test.tsx src/components/match3d-creation/Match3DAgentWorkspace.interaction.test.tsx src/components/wooden-fish-creation/WoodenFishWorkspace.test.tsx src/components/jump-hop-creation/JumpHopWorkspace.test.tsx src/components/jump-hop-result/JumpHopResultView.test.tsx src/components/jump-hop-runtime/JumpHopRuntimeShell.test.tsx src/components/edutainment-creation/BabyObjectMatchWorkspace.test.tsx src/components/edutainment-result/BabyObjectMatchResultView.test.tsx src/components/edutainment-runtime/BabyObjectMatchRuntimeShell.test.tsx src/components/big-fish-creation/BigFishAgentWorkspace.interaction.test.tsx src/components/big-fish-result/BigFishResultView.test.tsx src/components/big-fish-runtime/BigFishRuntimeShell.test.tsx`；`npm run test -- src/components/rpg-entry/RpgEntryFlowShell.agent.interaction.test.tsx -t "direct jump hop result route"` | 校验普通表单 / 图片 / 音频工作台仍按结构化 payload 提交，跳一跳结果页直达恢复不白屏，并把 BabyObjectMatch / BigFish 一并纳入最小回归。 |
+| Phase 4 | `npm run test -- src/components/rpg-entry/RpgEntryFlowShell.agent.interaction.test.tsx -t "opening RPG agent workspace does not refetch session snapshot in a render loop|create tab resumes agent workspace when draft has no compiled result yet|create tab resumes agent workspace when session has no draft profile even if summary counts look compiled|opening a compiled draft with a missing agent session falls back to draft hub"`、`npm run test -- src/components/rpg-entry/RpgEntryFlowShell.agent.interaction.test.tsx -t "create tab opens bark battle entry form from the template card|bark battle draft result can test before publish and publish to work detail|direct bark battle runtime public code opens published runtime"`、`npm run check:visual-novel-vn11` | 校验特殊工作台例外、Bark Battle 公开闭环和视觉小说负向门禁。 |
+| Phase 5 | `npm run test -- src/components/rpg-entry/RpgEntryFlowShell.agent.interaction.test.tsx -t "agent draft result publishes to gallery from publish panel|creation hub published work enters existing detail view|creation hub published work experience button enters world directly|creation hub published work start uses loaded detail profile instead of library summary"`、`npm run test -- src/components/rpg-entry/RpgEntryFlowShell.agent.interaction.test.tsx -t "published puzzle works appear on home and mobile game category channel|published big fish works stay hidden from platform home and mobile game category channel|home recommendation Match3D runtime keeps profile generated models when card summary is stale|home recommendation Match3D runtime passes top-level UI background assets|home recommendation Match3D runtime reloads detail when card only has UI assets"`、`npm run test -- src/components/platform-entry/PlatformWorkDetailView.test.tsx src/components/platform-entry/PlatformErrorDialog.test.tsx src/components/platform-entry/PlatformFeedbackView.test.tsx src/components/rpg-entry/rpgEntryWorldPresentation.test.ts`、`npm run test -- src/components/custom-world-home/CustomWorldCreationHub.test.tsx src/components/custom-world-home/CustomWorldCreationHub.interaction.test.tsx` | 校验结果页、发布、作品架、公开详情、推荐 runtime 和公开 read model，并补公开详情作者展示口径与作品架恢复矩阵。 |
+
+如果这轮还改了 SpacetimeDB schema，追加 `npm run check:spacetime-schema`；如果还改了 API 路由、BFF、公开列表或 `/works/detail` 回读，追加 `npm run dev:api-server`，并另开终端从 `.app/dev-stack.json` 读取实际 `api-server` URL 后检查 `/healthz`。
+
+## 可并行任务列表
+
+| 任务 ID | 可并行 | 状态 | 任务 | 主要产出 | 依赖 | 建议 Owner |
+| --- | --- | --- | --- | --- | --- | --- |
+| T0-1 | 否 | 已完成 | 总计划与文档入口 | 本文档、`docs/planning/README.md`、文档索引更新 | 无 | 文档 owner |
+| T1-1 | 否 | 已完成 | Phase 1 收口确认 | 三条首批链路验收记录、已知风险 | T0-1 | 前端 owner |
+| T2-1 | 是 | 已完成 | `unifiedCreationSpec` 契约审计 | 字段种类、必填、阶段映射、fallback 规则 | T0-1 | 契约 owner |
+| T2-2 | 是 | 已完成 | 后台入口配置治理 | 后台配置校验与配置说明 | T2-1 | 后台 owner |
+| T2-3 | 是 | 已完成 | 前端入口读取与 fallback 测试 | 入口配置单测、异常兜底测试 | T2-1 | 前端 owner |
+| T3-1 | 是 | 自动回归通过 | 跳一跳统一接入方案与实现 | 创作页/生成页迁移、验收 | T2-1 | 玩法 owner A |
+| T3-2 | 是 | 自动回归通过 | 宝贝识物统一接入方案与实现 | 创作页/生成页迁移、验收 | T2-1 | 玩法 owner B |
+| T3-3 | 是 | 最小回归通过 | 方洞工作台形态评估与迁移方案 | 保留 Agent 形态还是迁表单的决策、边界和风险清单 | T2-1 | 玩法 owner C |
+| T3-4 | 是 | 最小回归通过 | 大鱼工作台形态评估与迁移方案 | 保留 Agent 形态还是迁表单的决策、边界和风险清单 | T2-1 | 玩法 owner D |
+| T4-1 | 是 | 自动回归通过 | RPG 例外边界设计 | 例外声明、阶段映射、验收清单 | T2-1 | 特殊玩法 owner |
+| T4-2 | 是 | 自动回归通过 | 视觉小说例外边界设计 | 例外声明、阶段映射、验收清单 | T2-1 | 特殊玩法 owner |
+| T4-3 | 是 | 自动回归通过 | 汪汪声浪（bark-battle）统一/例外决策 | 接入或例外方案、验收清单 | T2-1 | 特殊玩法 owner |
+| T5-1 | 是 | 最小回归通过 | 统一结果页能力矩阵 | 每个玩法结果页能力与缺口表 | T3/T4 方案稳定 | 结果页 owner |
+| T5-2 | 是 | 最小回归通过 | 作品架恢复矩阵 | 生成中、失败、待发布、已发布恢复验收 | T3/T4 方案稳定 | 作品架 owner |
+| T5-3 | 是 | 最小回归通过 | 公开 read model 对齐 | 广场/详情/分享码缺口与执行清单 | T3/T4 方案稳定 | 后端 owner |
+| T5-4 | 是 | 最小回归通过 | 统一错误与完成反馈回归 | `PlatformErrorDialog`、`PlatformTaskCompletionDialog` 覆盖 | T3/T4 方案稳定 | 平台壳 owner |
+| T6-1 | 否 | 已完成 | 全链路质量门禁扩展 | `quality-gates/README.md`、跨玩法回归 / 冒烟门禁、Phase 2 到 Phase 5 最小验证集合 | T3/T4/T5 完成 | QA owner |
+| T6-2 | 否 | 已完成 | 全量验收与冻结 | 状态表、未接入声明、最终测试记录 | T6-1 | Release owner |
+
+并行原则：
+
+- T2 系列已完成，T3/T4 已进入回归；后续缺口修补仍不得绕过 T2 已固定的入口配置和统一 spec 规则。
+- T3 各玩法可并行，但同一文件同一时间只允许一个 owner，尤其是 `PlatformEntryFlowShellImpl.tsx`、路由和 shared contracts。
+- T5 可以在 T3/T4 各玩法方案稳定后分块并行，不必等所有玩法实现完再开始。
+- T6 必须串行收尾，避免验收矩阵和实际实现漂移。
+
+## 可直接派发的任务包
+
+任务包是执行层最小分工单元。每个包都可以单独开分支、单独验收；如果两个包需要改同一个公共文件，先由公共 owner 合并接口或壳层改动，再由玩法 owner 接入，避免互相覆盖。
+
+| 包 ID | 可并行对象 | 状态 | 目标 | 不做什么 | 交付物 | 验收 |
+| --- | --- | --- | --- | --- | --- | --- |
+| P2-A 契约包 | 可与 P2-B、P2-C 并行 | 已完成 | 固定 `unifiedCreationSpec` 字段类型、必填、阶段映射、fallback 规则 | 不接新玩法，不改 UI 设计方向 | 前后端契约、配置字段文档、契约测试 | `npm run test -- src/components/unified-creation/unifiedCreationSpecs.test.ts src/components/platform-entry/platformEntryCreationTypes.test.ts`；涉及 schema 时追加 `npm run check:spacetime-schema` |
+| P2-B 后台配置包 | 可与 P2-A、P2-C 并行 | 已完成 | 后台入口配置能编辑、校验、保存统一创作契约 | 不做玩法工作台迁移 | 后台表单、保存校验、异常提示、后台单测 | `npm run admin-web:typecheck`；`npm run test -- apps/admin-web/src/pages/AdminCreationEntrySwitchPage.test.tsx` |
+| P2-C 前台读取包 | 可与 P2-A、P2-B 并行 | 已完成 | 前台从 `/api/creation-entry/config` 读取统一 spec，旧后端只走兜底 | 不把 fallback 当事实源，不恢复硬编码入口 | 入口派生、fallback 单测、统一创作/生成页回归 | `npm run test -- src/components/unified-creation/UnifiedCreationPage.test.tsx src/components/unified-creation/UnifiedGenerationPage.test.tsx` |
+| P3-A 跳一跳接入包 | 可与 P3-B、P3-C、P3-D 并行 | 自动回归通过 | `jump-hop` 接入统一创作壳、生成页或明确跳过策略 | 不改正式 runtime 规则真相，不重做作品架 | 入口阶段映射、工作台接入、生成/结果跳转、竖屏验收 | 跳一跳相关单测、统一创作页回归、移动端 `/creation/jump-hop` smoke |
+| P3-B 宝贝识物接入包 | 可与 P3-A、P3-C、P3-D 并行 | 自动回归通过 | `baby-object-match` 接入统一创作壳、生成页或明确跳过策略 | 不复制上传/历史素材逻辑 | 工作台接入、资产槽位复用、结果跳转、竖屏验收 | 宝贝识物相关单测、统一创作页回归、移动端 `/creation/baby-object-match` smoke |
+| P3-C 方洞评估包 | 可与 P3-A、P3-B、P3-D 并行 | 部分回归通过 | 判断 `square-hole` 保留 Agent 形态还是迁表单/图片工作台 | 不直接大改实现 | 例外或迁移方案、字段清单、风险、验收用例 | 文档评审通过；若改代码，补对应工作台测试 |
+| P3-D 大鱼评估包 | 可与 P3-A、P3-B、P3-C 并行 | 部分回归通过 | 判断 `big-fish` 保留 Agent 形态还是迁表单/图片工作台 | 不直接大改实现 | 例外或迁移方案、字段清单、风险、验收用例 | 文档评审通过；若改代码，补对应工作台测试 |
+| P4-A RPG 例外包 | 可与 P4-B、P4-C 并行 | 自动回归通过 | 明确 RPG 对话式工作台如何接入统一阶段、错误、完成、发布去向 | 不把 RPG 当新增玩法默认模板 | 例外声明、阶段映射、刷新恢复和发布验收 | RPG 指定 interaction 测试、作品详情/进入世界回归 |
+| P4-B 视觉小说例外包 | 可与 P4-A、P4-C 并行 | 自动回归通过 | 明确视觉小说特殊生成和结果页边界 | 不迁入外部平台社区、支付、榜单、回放 | 例外声明、上传资产口径、生成/结果/发布验收 | `npm run check:visual-novel-vn11` 和视觉小说相关测试 |
+| P4-C 汪汪声浪决策包 | 可与 P4-A、P4-B 并行 | 自动回归通过 | 判断 `bark-battle` 是特殊工作台例外还是回到表单模式 | 不同时做两套入口 | 决策记录、阶段映射、发布和 runtime 验收 | Bark Battle 创作、发布、runtime 指定测试 |
+| P5-A 结果页矩阵包 | 可与 P5-B、P5-C、P5-D 并行 | 最小回归通过 | 列清每个玩法结果页能力、缺口和最小补丁 | 不在结果页新增无需求的大功能 | 结果页能力矩阵、局部重试/上传/发布边界 | 对应结果页测试和手测记录 |
+| P5-B 作品架恢复包 | 可与 P5-A、P5-C、P5-D 并行 | 最小回归通过 | 生成中、失败、待发布、已发布都能从作品架恢复 | 不只靠前端内存 notice | 作品摘要字段、作品架 adapter、恢复测试 | 作品架相关 interaction 测试；移动端草稿 Tab smoke |
+| P5-C 公开 read model 包 | 可与 P5-A、P5-B、P5-D 并行 | 最小回归通过 | 公开列表、详情、分享和推荐 runtime 对齐后端 read model | 不让前端拼源表当事实源 | 后端 read model/BFF 缺口清单和实现 | 公开列表/详情/API smoke；必要时 `npm run dev:api-server` + `/healthz` |
+| P5-D 统一反馈包 | 可与 P5-A、P5-B、P5-C 并行 | 最小回归通过 | 错误和异步完成统一进入平台弹窗 | 不在页面内重复裸错误 banner | `PlatformErrorDialog`、`PlatformTaskCompletionDialog` 覆盖矩阵 | 平台弹窗测试、跨流程失败/完成手测 |
+| P6-A 门禁包 | 串行，依赖 P3/P4/P5 | 已完成 | 固化跨玩法自动测试、竖屏手测和 API smoke | 不继续接新玩法 | `quality-gates/`、冻结前命令集合 | 跨玩法回归与冒烟门禁通过 |
+| P6-B 冻结包 | 串行，依赖 P6-A | 已完成 | 更新总状态表，标记已统一、例外接入、暂不接入 | 不遗留“状态未知”玩法 | 总进度、风险清单、后续维护规则 | `npm run check:encoding`、关键门禁通过、文档索引有效 |
+
+### 并行执行注意事项
+
+- 公共壳层 owner 统一负责 `PlatformEntryFlowShellImpl.tsx`、`appPageRoutes.ts`、入口阶段类型、共享 contract 和统一生成页主流程；玩法 owner 只接自己的工作台和映射。
+- 后端 schema owner 统一负责 SpacetimeDB 表、`migration.rs`、表目录和 bindings；玩法 owner 不单独改 schema 后跳过生成绑定。
+- 文档 owner 每轮只更新本计划的状态、波次和风险，不把一次性聊天记录写进长期文档。
+- 同一波次内如果发现计划和代码事实冲突，先改计划和对应融合文档，再继续实现；不要在代码里临时绕开统一链路。
+
+### 依赖关系摘要
+
+- 可以并行启动：`T3-1`、`T3-2`、`T3-3`、`T3-4`，其中 `T3-3` 和 `T3-4` 先做形态评估，`T3-1` 和 `T3-2` 可以直接进入实现。
+- 可以并行启动：`T4-1`、`T4-2`、`T4-3`，但它们只做例外边界和决策，不直接扩散到新的玩法实现。
+- `T5-1`、`T5-2`、`T5-3`、`T5-4` 可以并行预研，但最好等至少一批 Phase 3 / 4 方案稳定后再落代码。
+- `T6-1`、`T6-2` 必须串行，且都依赖 Phase 3 到 Phase 5 的验证结果。
+
+## 并行波次
+
+### 波次 A：先定契约
+
+状态：已完成。
+
+- `T2-1` `unifiedCreationSpec` 契约审计
+- `T2-2` 后台入口配置治理
+- `T2-3` 前端入口读取与 fallback 测试
+
+说明：三项可以并行，先把统一创作入口的真值源、后台编辑面和前端兜底一起收紧。
+
+### 波次 B：第一批迁移与例外评估
+
+状态：自动回归已通过，遗留形态评估按缺口任务继续跟踪。
+
+- `T3-1` `jump-hop` 统一接入
+- `T3-2` `baby-object-match` 统一接入
+- `T3-3` `square-hole` 工作台形态评估
+- `T3-4` `big-fish` 工作台形态评估
+- `T4-1` `RPG` 例外边界设计
+- `T4-2` `视觉小说` 例外边界设计
+- `T4-3` `汪汪声浪（bark-battle）` 统一/例外决策
+
+说明：`jump-hop`、`baby-object-match` 已完成最小接入回归；`square-hole`、`big-fish` 的形态评估继续按缺口任务跟踪；特殊工作台例外边界已完成最小回归。
+
+### 波次 C：交付链路收口
+
+状态：最小回归通过。
+
+- `T5-1` 统一结果页能力矩阵
+- `T5-2` 作品架恢复矩阵
+- `T5-3` 公开 read model 对齐
+- `T5-4` 统一错误与完成反馈回归
+
+说明：交付链路已按页面 / read model / 弹窗分块完成最小回归，后续只处理验收发现的真实缺口。
+
+### 波次 D：验收与冻结
+
+状态：已收口。
+
+- `T6-1` 全链路质量门禁扩展
+- `T6-2` 全量验收与冻结
+
+说明：必须串行，先补门禁再冻结状态表。
+
+## 验收矩阵
+
+每个玩法推进时至少记录：
+
+| 验收项 | 要求 |
+| --- | --- |
+| 创作入口 | 从创作 Tab 或直达 URL 能进入对应工作台，入口事实源来自 `/api/creation-entry/config`。 |
+| 创作页 | 统一标题/阶段壳存在，工作台不重复渲染巨大旧标题，移动端可滚动到提交按钮。 |
+| 输入控件 | 图片、音频、文本、选择器复用现有通用组件，不复制上传/历史图逻辑。 |
+| 生成页 | 自动生成玩法使用统一圆环生成页；无生成页玩法有明确跳转策略。 |
+| 结果页 | 能展示草稿、编辑作品信息、处理局部重生成、试玩和发布。 |
+| 恢复 | 刷新、退出登录、生成中、失败、作品架恢复都有可观察行为。 |
+| 发布与公开 | 发布后能进入统一详情或 runtime；公开列表/read model 不靠前端拼源表。 |
+| runtime | 试玩与正式运行态区分清楚，正式业务真相以后端为准。 |
+| 移动端 | 竖屏优先，无按钮遮挡、套滚动、文字溢出或固定底栏遮挡。 |
+
+## 统一约束
+
+- 不恢复前端硬编码入口配置。
+- 不新建平行创作入口系统、平行作品架或平行公开列表。
+- 不把功能说明、规则说明或开发解释默认写进 UI 面板。
+- 不让前端承接发布、计分、胜负、资产持久化或公开状态等业务真相。
+- 后端仍按 `server-rs + Axum + SpacetimeDB` 和 DDD 分层推进。
+- 涉及 SpacetimeDB schema 时必须同步 migration、表目录、生成绑定，并运行 schema 检查。
+
+## 推荐推进顺序
+
+1. 将 Round 4 / Phase 6 作为当前冻结基线，后续只做同口径回归，不再新增波次。
+2. 对 Phase 3、Phase 4、Phase 5 只处理回归发现的真实缺口，不扩新玩法。
+3. 更新冻结状态表，明确每个玩法是已统一、例外接入还是暂不接入。
+4. 后续新增玩法默认遵循本文档和 `quality-gates/【玩法创作】跨玩法回归与冒烟门禁-2026-05-30.md`，无需再补新的总计划轮次。
+
+当前轮次看 Round 4 / Phase 6；Round 0~4 已作为历史完成记录保留。