1

docs/prd/FIRST_LAUNCH_PUZZLE_ONBOARDING_PRD_2026-05-05.md

@@ -37,7 +37,7 @@
 
 ## 5. 范围边界
 
-1. 不增加跳过入口。
+1. 首屏右上角提供 `跳过` 入口，点击后写入首次访问标记并回到产品首页。
 2. 不定义额外功能说明文案。
 3. 不扩展拼图为多关。
 4. 不调整注册/登录后的去向，当前进入产品首页。
@@ -47,10 +47,12 @@
 
 1. 未登录首次访问产品时，进入新手引导首屏。
 2. 首屏展示确认文案、输入框和生成按钮。
-3. 用户输入内容并点击生成后，系统生成 1 关拼图。
-4. 生成完成后，用户可以进入该拼图并完成第 1 关。
-5. 第 1 关完成后，页面展示注册/登录引导文案和登录模块。
-6. 用户完成注册或登录后，进入产品首页。
+3. 首屏右上角展示跳过按钮；点击后本次和后续访问不再自动展示新手引导。
+4. 用户输入内容并点击生成后，系统生成 1 关拼图。
+5. 若临时生成接口返回 `404 / 资源不存在`，前端使用本地临时拼图兜底继续进入试玩，不把错误直接展示给用户。
+6. 生成完成后，用户可以进入该拼图并完成第 1 关。
+7. 第 1 关完成后，页面展示注册/登录引导文案和登录模块。
+8. 用户完成注册或登录后，进入产品首页。
 
 ## 7. 落地接口与状态
 
@@ -59,3 +61,4 @@
 3. 登录后保存入口为 `POST /api/runtime/puzzle/onboarding/save`，要求登录；服务端为当前用户创建拼图 agent session，并把临时 1 关拼图保存为当前用户作品草稿。
 4. 新手引导游玩阶段复用现有本地拼图运行时，不新增 SpacetimeDB 表、reducer 或运行时真相。
 5. 保存完成后清空新手引导临时态，刷新拼图作品架，并回到产品首页。
+6. 跳过新手引导只更新本地首次访问标记和界面状态，不创建临时作品、不调用保存接口。