1

docs/prd/AI_NATIVE_CUSTOM_WORLD_CREATION_HUB_PRD_2026-04-13.md

@@ -468,8 +468,9 @@ interface CustomWorldCoverProfile {
 
 1. 上传后先进入独立裁剪面板
 2. 裁剪框比例固定为 `16:9`
-3. 作者只能平移和缩放，不允许自由改比例
-4. 裁剪完成后，再提交给后端保存
+3. 作者直接在图片上拖拽裁剪框内部移动区域，拖拽四边或四角调整裁剪范围，不再通过参数滑杆调整
+4. 裁剪框调整过程中必须持续锁定 `16:9`，不允许自由改比例
+5. 裁剪完成后，再提交给后端保存
 
 ### 上传大小与格式限制
 

docs/prd/AI_NATIVE_VISUAL_NOVEL_TEMPLATE_PRD_2026-05-05.md

@@ -1536,6 +1536,14 @@ VN-10 实施收口记录（2026-05-07）：
 4. 运行时背景图与角色立绘改用 `ResolvedAssetImage`，私有 generated 路径通过 `/api/assets/read-url` 换签后渲染。
 5. 本阶段未接入可选图片生成 action，保留既有 action 契约；未改 SpacetimeDB schema，未保存 Data URL、二进制对象或外部 R2 路径。
 
+VN-10 音频生成补充（2026-05-08）：
+
+1. 场景编辑器在既有 `musicSrc` / `ambientSoundSrc` 槽位上接入音频生成，不新增视觉小说专属音频表或第二套资产系统。
+2. 背景音乐走 VectorEngine Suno `POST /suno/submit/music` 与 `GET /suno/fetch/{task_id}`，完成后写入 `visual_novel_music` 平台资产并绑定到 `visual_novel_scene / music`。
+3. 场景音效走 VectorEngine Vidu `POST /ent/v2/text2audio` 与 `GET /ent/v2/tasks/{id}/creations`，完成后写入 `visual_novel_ambient_sound` 平台资产并绑定到 `visual_novel_scene / ambient_sound`。
+4. 前端只提交提示词、标题、标签、时长等生成参数；供应商 base URL 和 API key 只在 `api-server` 环境变量中读取。
+5. 生成参数使用独立弹层承载，不在场景面板下方展开规则说明。
+
 ### VN-11：回放删除与外部平台功能负向扫描
 
 负责范围：

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. 跳过新手引导只更新本地首次访问标记和界面状态，不创建临时作品、不调用保存接口。