# 新手引导流程 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. 首屏右上角展示跳过按钮；点击后本次和后续访问不再自动展示新手引导。
4. 用户输入内容并点击生成后，系统生成 1 关拼图。
5. 若临时生成接口返回 `404 / 资源不存在`，前端使用本地临时拼图兜底继续进入试玩，不把错误直接展示给用户。
6. 生成完成后，用户可以进入该拼图并完成第 1 关。
7. 第 1 关完成后，页面展示注册/登录引导文案和登录模块。
8. 用户完成注册或登录后，进入产品首页。

## 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. 保存完成后清空新手引导临时态，刷新拼图作品架，并回到产品首页。
6. 跳过新手引导只更新本地首次访问标记和界面状态，不创建临时作品、不调用保存接口。