feat: add puzzle onboarding and match3d entry updates

docs/prd/FIRST_LAUNCH_PUZZLE_ONBOARDING_PRD_2026-05-05.md

@@ -0,0 +1,61 @@
+# 新手引导流程 PRD
+
+## 1. 目标
+
+引导未登录且首次访问产品的用户，快速体验从输入想法、AI 生成拼图游戏、完成拼图、注册或登录保留作品，到进入产品首页的创作闭环。
+
+## 2. 触发条件
+
+1. 用户处于未登录状态。
+2. 用户首次访问产品。
+
+## 3. 流程
+
+1. 用户首次打开产品。
+2. 页面浮现文字：`待定待定待定`。
+3. 文字下方展示文字输入框。
+4. 输入框提示文字：`把你的梦讲给我听吧`。
+5. 用户输入内容后，点击生成按钮。
+6. 系统拉起拼图游戏创作机制。
+7. 系统根据用户输入内容生成一个仅包含 1 关的拼图游戏。
+8. 生成完成后，页面浮现文字：`待定待定待定`。
+9. 用户进入当前生成的拼图游戏。
+10. 用户完成该拼图游戏的第 1 关。
+11. 页面浮现文字：`只差一步，就可以永久保留你的梦`。
+12. 文字下方展示注册账号/登录模块。
+13. 用户完成注册或登录。
+14. 系统进入产品首页。
+
+## 4. 文案
+
+| 位置 | 文案 |
+| --- | --- |
+| 首次启动浮现文案 | `待定待定待定` |
+| 输入框提示文字 | `把你的梦讲给我听吧` |
+| 生成完成浮现文案 | `待定待定待定` |
+| 完成拼图后的注册/登录引导文案 | `只差一步，就可以永久保留你的梦` |
+
+## 5. 范围边界
+
+1. 不增加跳过入口。
+2. 不定义额外功能说明文案。
+3. 不扩展拼图为多关。
+4. 不调整注册/登录后的去向，当前进入产品首页。
+5. 不新增未确认的 UI 动画、样式、奖励、埋点或保存策略。
+
+## 6. 验收标准
+
+1. 未登录首次访问产品时，进入新手引导首屏。
+2. 首屏展示确认文案、输入框和生成按钮。
+3. 用户输入内容并点击生成后，系统生成 1 关拼图。
+4. 生成完成后，用户可以进入该拼图并完成第 1 关。
+5. 第 1 关完成后，页面展示注册/登录引导文案和登录模块。
+6. 用户完成注册或登录后，进入产品首页。
+
+## 7. 落地接口与状态
+
+1. 首次访问判定由前端本地状态承载，未登录用户首次访问平台首页时展示；标记键为 `genarrative.puzzle-onboarding.first-visit.v1`。
+2. 临时生成入口为 `POST /api/runtime/puzzle/onboarding/generate`，不要求登录，只返回本次新手引导使用的 1 关拼图作品摘要与关卡数据。
+3. 登录后保存入口为 `POST /api/runtime/puzzle/onboarding/save`，要求登录；服务端为当前用户创建拼图 agent session，并把临时 1 关拼图保存为当前用户作品草稿。
+4. 新手引导游玩阶段复用现有本地拼图运行时，不新增 SpacetimeDB 表、reducer 或运行时真相。
+5. 保存完成后清空新手引导临时态，刷新拼图作品架，并回到产品首页。