Genarrative/docs/technical/PUZZLE_RUNTIME_FIRST_EXIT_REMODEL_PROMPT_2026-05-02.md

拼图运行时首次退出改造引导 2026-05-02

背景

玩家从公开拼图作品进入运行态后，左上角返回会直接离开玩法。若玩家因为体验不佳准备退出，需要在首次退出时给出改造入口，让玩家可以把当前作品复制为自己的草稿继续调整。

本轮只改拼图运行时前端交互与既有改造链路，不新增后端表，不改变拼图存档投影规则，不接入旧 server-node。

交互规则

1. 触发点只限拼图运行态左上角返回按钮。
2. 对同一浏览器里的同一拼图 profileId，首次点击返回时不直接退出，而是弹出独立面板。
3. 面板标题固定为两行：
   • 体验不佳？
   • 试试改造功能!
4. 面板主按钮为 作品改造，点击后复用公开详情页已有的拼图改造链路：
   • 使用当前运行关卡的 currentLevel.profileId 调用 remixPuzzleGalleryWork(profileId)，避免下一关或相似作品运行态误用旧详情页作品。
   • 成功后写入 puzzleFlow.session。
   • 进入 puzzle-result，即游戏作品改造页。
5. 面板次按钮为 保存并退出，点击后关闭面板并执行原返回逻辑。
6. 非首次点击返回不再弹出面板，直接执行原返回逻辑。

UI 布局

1. 面板保持居中独立弹层，移动端宽度不超过屏幕安全边距，桌面端保持紧凑。
2. 面板只展示标题与两个行动按钮，不增加说明性文案。
3. 标题使用两行居中排版，顶部可以放无文字图标强化游戏感。
4. 作品改造 为主按钮，视觉权重高于 保存并退出。
5. 两个按钮纵向排列，固定触控高度，确保移动端易点击。

首次状态

首次曝光是浏览器侧 UI 引导状态，不是业务真相态：

1. 以 currentLevel.profileId 作为作品粒度。
2. 使用 localStorage 记录已展示状态。
3. localStorage 不可用时，使用当前组件生命周期内的内存集合兜底，避免同一挂载周期重复弹出。
4. 点击 作品改造 或 保存并退出 都视为已经完成本次引导曝光。

验收

1. 首次点击拼图运行态左上角返回，出现标题为 体验不佳？试试改造功能! 的独立面板。
2. 点击 作品改造 后进入拼图结果页改造草稿。
3. 点击 保存并退出 后返回原目标页面。
4. 同一作品再次点击左上角返回，不再出现面板。
5. 不影响设置面板里的返回按钮、失败续时、通关结算和下一关入口。