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