Merge branch 'codex/editor-asset-library' of https://git.genarrative.world/GenarrativeAI/Genarrative into codex/editor-asset-library

2026-06-19 13:05:08 +08:00
parent 991fea965f 8857e36e1a
commit fdcccec385
20 changed files with 2362 additions and 313 deletions
@@ -25,6 +25,8 @@

 `/editor/canvas` 图片画布编辑器的画布素材 ZIP 导出能力，入口放在右上角标题栏下载图标内，第一版采用前端 JSZip 打包画布中有效图层引用的上传图、生成图和修改结果，方案见 [【前端架构】图片画布素材导出方案-2026-06-15.md](./technical/【前端架构】图片画布素材导出方案-2026-06-15.md)。

+桌面端 `/creation` 创作工具主页、顶级“草稿”入口替换为“项目”、最近项目、新建项目和陶泥儿精选素材瀑布流的落地计划见 [【玩法创作】创作主页与项目入口改版计划-2026-06-18.md](./%E3%80%90%E7%8E%A9%E6%B3%95%E5%88%9B%E4%BD%9C%E3%80%91%E5%88%9B%E4%BD%9C%E4%B8%BB%E9%A1%B5%E4%B8%8E%E9%A1%B9%E7%9B%AE%E5%85%A5%E5%8F%A3%E6%94%B9%E7%89%88%E8%AE%A1%E5%88%92-2026-06-18.md)。
+
 本地通过 SSH alias 管理多台服务器、查看硬件 / systemd / HTTP 健康状态并执行受控服务启停的 egui 桌面工具见 [【开发运维】本地SSH服务器管理面板技术方案-2026-06-11.md](./technical/【开发运维】本地SSH服务器管理面板技术方案-2026-06-11.md)。

 生产部署切换到 systemd + Nginx + SpacetimeDB 自托管的总方案见 [PRODUCTION_DEPLOYMENT_PLAN_2026-05-02.md](./technical/PRODUCTION_DEPLOYMENT_PLAN_2026-05-02.md)，该文档也是当前生产 Jenkinsfile 的唯一入口。SpacetimeDB 表结构变更、自动迁移边界和保留旧数据的分阶段迁移流程见 [SPACETIMEDB_SCHEMA_CHANGE_CONSTRAINTS.md](./technical/SPACETIMEDB_SCHEMA_CHANGE_CONSTRAINTS.md)；private 表迁移 JSON 导入导出、HTTP 413 分片导入和旧数据库迁移流水线经验见 [SPACETIMEDB_JSON_STRING_MIGRATION_PROCEDURE_2026-04-27.md](./technical/SPACETIMEDB_JSON_STRING_MIGRATION_PROCEDURE_2026-04-27.md) 与 [JENKINS_SPACETIMEDB_DATABASE_MIGRATION_PIPELINES_2026-04-29.md](./technical/JENKINS_SPACETIMEDB_DATABASE_MIGRATION_PIPELINES_2026-04-29.md)；后台管理独立前端工程技术方案见 [ADMIN_WEB_CONSOLE_TECHNICAL_SOLUTION_2026-04-30.md](./technical/ADMIN_WEB_CONSOLE_TECHNICAL_SOLUTION_2026-04-30.md)。
@@ -32,6 +32,14 @@
 - 验证方式：运行图片画布工具栏 / 图集落层 / 生成提交相关前端测试，`cargo test -p platform-image generated_asset_sheets --manifest-path server-rs/Cargo.toml`，以及 `cargo test -p api-server editor_ui_design_asset_extraction_prompt_is_fixed --manifest-path server-rs/Cargo.toml`。
 - 关联文档：`docs/【编辑器】画板UI设计图生成入口设计-2026-06-17.md`、`docs/【编辑器】画板图标素材生成入口设计-2026-06-15.md`。

+## 2026-06-18 `/creation` 独立为陶泥儿创作工具主页
+
+- 背景：图片画布项目已经成为独立项目资产，旧“创作”站内 Tab 和一级“草稿”入口不能清晰表达桌面端创作工具主页与项目管理入口。
+- 决策：桌面端新增独立 `/creation` 创作工具主页；顶级“创作”入口跳转 `/creation`，原“草稿”入口替换为“项目”并跳转 `/project`。移动端隐藏“创作”和“项目”入口，但不拦截直接 URL。页面文案统一使用“陶泥儿”，外部品牌只作为设计参考，不进入用户可见 UI、测试名、产品文案或验收口径。`陶泥儿精选` 是用户素材瀑布流，不展示玩法入口列表；创作入口事实源继续来自 `/api/creation-entry/config`，项目入口通过 `createEditorProject` 和 `/editor/canvas?projectid=xxx` 链路进入画布。
+- 影响范围：平台入口导航、`SelectionStage` 路由、`/creation` 首页、`/project` 项目入口、`/editor/canvas` 项目打开链路、“我的”页快捷入口和创作入口相关测试。
+- 验证方式：`/creation` 解析为创作主页，`/creation/<play>` 仍进入对应玩法工作台；桌面导航显示“创作 / 项目”且不显示“草稿”；移动端底部不显示“创作 / 项目”；页面不出现外站品牌或 `Discord` 字样；新建项目进入 `/editor/canvas?projectid=xxx`。
+- 关联文档：`docs/【玩法创作】创作主页与项目入口改版计划-2026-06-18.md`、`docs/【玩法创作】平台入口与玩法链路-2026-05-15.md`。
+
 ## 2026-06-18 图片画布 Seedance 2.0 参考媒体提交边界

 - 背景：`/editor/canvas` 生成视频需要严格对齐火山 Seedance 2.0 多模态参考输入；参考视频若继续走 Base64 / `data:video` 会超过请求体并被上游拒绝，参考音频单独输入和非 Seedance 模型携带参考字段也会违反文档契约。
@@ -2326,6 +2326,14 @@
 - 验证：`npm run test -- src/components/common/CreativeImageInputPanel.test.tsx src/components/puzzle-result/PuzzleResultView.test.tsx`。
 - 关联：`src/components/common/CreativeImageInputPanel.tsx`、`src/components/puzzle-result/PuzzleResultView.tsx`、`docs/【玩法创作】平台入口与玩法链路-2026-05-15.md`。

+## 项目画布跳转不要先写无参画布路由
+
+- 现象：从 `/creation` 最近项目或 `/project` 项目卡进入画布时，浏览器先进入 `/editor/canvas`，随后再进入 `/editor/canvas?projectid=xxx`，导致返回来源页需要点两次。
+- 原因：`App` 传给平台壳的 `setSelectionStage` 会按 stage 自动 `pushAppHistoryPath(resolvePathForSelectionStage(stage))`；如果项目入口先 `setSelectionStage('image-editor')` 再写项目 URL，就会把无参数画布路由塞入 history。
+- 处理：项目入口必须先写入最终 `/editor/canvas?projectid=xxx`，再切 `image-editor` 阶段；`App` 的 stage setter 在当前位置已经解析为 `image-editor` 时不要再补写基础画布路由。
+- 验证：`npm run test -- src/App.test.tsx`；浏览器中从最近项目或项目页打开项目后，后退一次应直接回到 `/creation` 或 `/project`。
+- 关联：`src/App.tsx`、`src/components/platform-entry/PlatformEntryFlowShellImpl.tsx`、`docs/【玩法创作】创作主页与项目入口改版计划-2026-06-18.md`。
+
 ## 统一创作页短表单软键盘打开不要露出黑底

 - 现象：小程序 / H5 移动端点击拼图或敲木鱼创作输入框后，输入框和键盘之间出现一大片黑色区域；H5 还会明显弹一下。跳一跳因为按钮区用 `mt-auto` 撑开页面，看起来没有同样问题。
@@ -24,7 +24,7 @@ Genarrative / 陶泥儿是一个 AI 原生互动内容与小游戏平台，把 A
 - 小程序 WebView 外壳：`miniprogram/`。
 - 法律文本：`media/files/user_agreement.md`、`media/files/privacy_policy.md`、`media/files/disclaimer.md`。

-移动端一级 Tab：`推荐 / 发现 / 创作 / 草稿 / 我的`。
+移动端一级 Tab：`推荐 / 发现 / 我的`。桌面端导航保留 `创作` 并新增 `项目`，其中 `/creation` 是独立创作工具主页，`/project` 是画布项目入口。

 ## 当前后端路线

@@ -0,0 +1,191 @@
+# 创作主页与项目入口改版计划
+
+日期：2026-06-18
+
+## 背景
+
+当前平台首页中的“创作”仍偏向站内 Tab 和创作入口列表，“草稿”也仍作为一级入口存在。图片画布项目已经成为独立项目资产，需要在桌面端给用户一个更明确的创作工具主页，并把项目管理提升为一级入口。
+
+本轮改版参考外部创作工具首页的信息组织，但所有用户可见文案、测试命名和产品命名都使用“陶泥儿”。外部品牌只作为设计参考，不进入产品 UI、测试名或文档验收口径。
+
+## 目标
+
+- 新增桌面端独立 `/creation` 创作工具主页。
+- 顶级导航中“创作”进入 `/creation`，“草稿”改为“项目”并进入 `/project`。
+- 移动端隐藏“创作”和“项目”入口，只保留浏览和个人相关入口。
+- 登录后在创作主页展示最近项目，并通过新建项目进入 `/editor/canvas?projectid=xxx`。
+- `陶泥儿精选` 展示真实账号素材瀑布流，不使用 mock 素材。
+- 现有 `/creation/<play>` 玩法工作台、草稿、作品架、生成恢复和发布链路保持不变。
+
+## 页面结构
+
+### 顶部品牌区
+
+- 标题：`陶泥儿 - 开启全民精品游戏创作`
+- 主按钮：`开始创作`
+- 社群入口：原地弹出“玩家社区”二维码弹窗，复用现有社区弹层能力，不跳转或切换到“我的 / 用户中心”。
+- 营销点：`登录即送100泥点，可以免费制作50个素材`
+
+`开始创作` 与“新建项目”使用同一项目创建链路。用户已登录时调用现有 `createEditorProject`，成功后进入 `/editor/canvas?projectid=xxx`；未登录或登录过期时打开登录弹窗，并在登录后重试创建。
+
+该区是页面第一屏的品牌与主操作区域，不使用外站品牌名。桌面端 `/creation` 继续保留现有平台左侧导航栏和上方栏，创作主页只替换中间内容区。
+
+### 九大创作工具能力
+
+创作主页展示九项能力，用于说明陶泥儿创作工具覆盖范围：
+
+1. 游戏视觉规范：轻松约束多类素材视觉一致性。
+2. 游戏角色：整套高完成度 2D / 3D 角色素材及动画。
+3. 游戏 UI：轻松生成高一致性的 UI 素材。
+4. 游戏音乐：轻松制作游戏背景音乐、音效。
+5. 游戏特效：低成本生成精品游戏特效。
+6. 游戏场景：轻松生成各类游戏场景素材。
+7. 游戏美宣：轻松生成游戏上架所需图片和视频。
+8. 游戏功能编码：自然语言驱动游戏生成。
+9. 一键导出：支持一键导出为微抖小游戏、Godot、Unity、UE 工程。
+
+### 最近项目
+
+仅登录后展示。模块位置在“陶泥儿精选”上方。
+
+- 标题：`最近项目`
+- 标题右侧：`查看全部`，跳转 `/project`
+- 左侧第一项：`新建项目`
+- 右侧项目卡：按 `updatedAt` 倒序展示最近 4 个项目。
+- 项目卡点击进入 `/editor/canvas?projectid=xxx`。
+- 项目卡点击必须直接写入最终 `/editor/canvas?projectid=xxx` 历史项，不允许先进入无参数 `/editor/canvas` 再二次跳转，否则浏览器返回需要点两次。
+- 项目缩略图复用 `/project` 项目卡的画布中心封面逻辑，避免两套封面算法。
+
+未登录状态不展示最近项目区，避免空态文案占据首屏。
+
+### 陶泥儿精选
+
+`陶泥儿精选` 是页面底部的用户素材瀑布流，不承载玩法入口列表。瀑布流卡片按真实素材宽高设置预览比例，同一行允许出现不同高度卡片，不使用固定等高网格。创作入口配置仍继续来自 `/api/creation-entry/config`，供旧创作入口和具体 `/creation/<play>` 工作台使用，但不作为本页精选区内容。
+
+精选内容优先使用真实账号级素材和生成结果数据；未登录或账号素材为空时，可使用已公开作品中真实用户生成的图片作为瀑布流素材来源。两种来源都不使用 mock。若现有数据缺少提示词、作者名或成本字段，v1 显示保守占位，不伪造内容。
+
+Tab：
+
+- 素材包
+- 角色
+- UI
+- 音乐
+- 特效
+- 场景
+- 美宣
+- 游戏
+
+展示口径：
+
+- 素材包：每个列表项展示同一规范图生成的规范图和相关素材组合。
+- 角色：每个列表项展示游戏角色图和该角色生成的角色动画素材组合。
+- UI：每个列表项展示游戏 UI 图和该 UI 图拆出的子素材组合。
+- 音乐：展示背景音乐和音效。
+- 美宣：展示美宣类图片和视频素材。
+- 特效、场景、游戏：v1 只在有真实数据时展示，无数据时不造假卡片。
+
+每个列表项需要标注：
+
+- 提示词
+- 作者名
+- 生成总成本，单位为泥点
+
+数据来源：
+
+- 图片类素材优先读取账号级素材库和已落库生成结果。
+- 未登录或账号素材为空时，读取已公开作品中的真实用户生成图片作为精选素材补充，但卡片仍按素材瀑布流呈现，不展示玩法入口卡。
+- 音乐、音效、视频类素材只展示已存在的真实记录。
+- 不为了填满展示区创建假素材、假作者、假泥点成本或假组合关系。
+- 暂无真实数据的 Tab 保留 Tab 入口，但内容区显示简洁空态。
+
+## 数据与状态边界
+
+- `/creation` 是创作工具主页，不承接正式玩法业务真相。
+- 创作入口配置继续从 `/api/creation-entry/config` 读取。
+- 最近项目继续使用编辑器项目接口：`listEditorProjects`、`createEditorProject` 和 `/editor/canvas?projectid=xxx`。
+- 最近项目和项目页打开画布时，浏览器 history 只保留带 `projectid` 的最终画布路由。
+- 项目封面逻辑复用 `/project` 项目卡已有的画布中心缩略图算法。
+- `陶泥儿精选` 读取账号级素材库；若字段缺失，前端只显示空值或隐藏对应元信息，不在前端推导业务真相。
+- `/creation/<play>` 的玩法工作台、草稿、生成页、结果页、发布、运行态和作品架链路保持原状。
+
+## 路由与导航
+
+- 新增 `SelectionStage = 'creation-home'`。
+- `/creation` 映射到 `creation-home`。
+- `/creation/<play>` 现有玩法工作台路由保持原有 stage 映射。
+- 桌面端点击“创作”时调用 `pushAppHistoryPath('/creation')`。
+- 桌面端原“草稿”入口改为“项目”，点击 `pushAppHistoryPath('/project')`。
+- 移动端导航列表不展示“创作”和“项目”。
+- 移动端不拦截用户直接访问 `/creation` 或 `/project`。
+
+## 实施拆分
+
+### 路由与导航
+
+- 增加 `/creation` 路由映射和测试。
+- 调整桌面导航文案与点击行为。
+- 移动端导航移除“创作”和“项目”入口。
+- 保持现有 `/creation/<play>` 工作台、生成页、结果页和运行态路由不回归。
+
+### 创作主页
+
+- 新增 `CreationLandingView`。
+- 实现首屏主视觉、九大功能区、最近项目区和陶泥儿精选素材瀑布流。
+- 桌面端复用现有平台壳层，保留上方栏和左侧导航栏。
+- 主页整体采用浅色布局，避免外站品牌文案。
+- 社群入口复用现有玩家社区弹层，点击后必须停留在 `/creation`。
+- 不在 UI 中放规则说明、实现说明或“暂不实装”提示。
+- 未登录时不渲染最近项目区；需要创建项目时走登录弹窗和登录后重试。
+
+### 项目卡与封面复用
+
+- 从 `ProjectGalleryView` 抽出项目封面模型或组件。
+- `/creation` 最近项目与 `/project` 共用同一封面逻辑。
+- 新建项目复用现有 `createEditorProject`、`listEditorProjects` 和 `/editor/canvas?projectid=xxx` 链路。
+
+### 我的页
+
+- 删除“项目 / 画布项目”快捷入口。
+- 常用功能区稳定为 4 项：泥点充值、兑换码、玩家社区、反馈与建议。
+
+## 测试计划
+
+单元和组件测试：
+
+- `appPageRoutes.test.ts`：覆盖 `/creation -> creation-home`，并确认现有 `/creation/<play>` 不回归。
+- `RpgEntryHomeView.recharge.test.tsx`：桌面显示“创作”“项目”，不显示“草稿”；移动端不显示“创作”和“项目”；我的页不再出现项目快捷入口。
+- `CreationLandingView.test.tsx`：覆盖首屏主视觉、九大功能、最近项目、新建入口、查看全部、未登录隐藏最近项目、素材 Tab。
+- `PlatformEntryFlowShellImpl` 相关测试：点击“创作”进入 `/creation`，点击“项目”进入 `/project`，新建项目进入 `/editor/canvas?projectid=xxx`。
+- `ProjectGalleryView.test.tsx`：封面抽取后项目封面、重命名、删除和选择模式保持通过。
+
+验证命令：
+
+```bash
+npm run test -- src/routing/appPageRoutes.test.ts src/components/project/ProjectGalleryView.test.tsx src/components/rpg-entry/RpgEntryHomeView.recharge.test.tsx src/components/rpg-entry/RpgEntryFlowShell.agent.interaction.test.tsx
+npm run typecheck
+npm run check:encoding
+git diff --check
+```
+
+浏览器回归：
+
+- 桌面打开首页，点击“创作”进入 `/creation`。
+- `/creation` 显示 `陶泥儿 - 开启全民精品游戏创作` 和 `陶泥儿精选`。
+- 页面不出现外站品牌或 `Discord` 字样。
+- 未登录时最近项目区不展示，点击“开始创作”弹登录。
+- 登录后显示最近项目、新建项目、最多 4 个项目和“查看全部”。
+- 点击新建项目进入 `/editor/canvas?projectid=xxx`。
+- 桌面导航显示“项目”，不显示“草稿”。
+- 移动视口底部不显示“创作”和“项目”。
+- “我的”页没有项目快捷入口。
+- 陶泥儿精选素材瀑布流不出现 mock 素材、假作者或假泥点成本。
+- 陶泥儿精选素材卡按真实素材宽高呈现瀑布流，不退化为固定等高网格。
+- 陶泥儿精选不出现玩法入口卡；即使使用公开作品图片补充展示，也必须呈现为用户素材瀑布流。
+
+## 非目标
+
+- 不新增后端接口。
+- 不删除现有玩法草稿、作品架、生成恢复、发布或运行态能力。
+- 不恢复前端硬编码创作入口配置。
+- 不用 mock 素材填充用户素材展示。
+- 不在移动端禁止直接 URL 访问 `/creation` 或 `/project`。