1

docs/technical/PUZZLE_RUNTIME_FIRST_EXIT_REMODEL_PROMPT_2026-05-02.md

@@ -0,0 +1,38 @@
+# 拼图运行时首次退出改造引导 2026-05-02
+
+## 背景
+
+玩家从公开拼图作品进入运行态后，左上角返回会直接离开玩法。若玩家因为体验不佳准备退出，需要在首次退出时给出改造入口，让玩家可以把当前作品复制为自己的草稿继续调整。
+
+本轮只改拼图运行时前端交互与既有改造链路，不新增后端表，不改变拼图存档投影规则，不接入旧 `server-node`。
+
+## 交互规则
+
+1. 触发点只限拼图运行态左上角返回按钮。
+2. 对同一浏览器里的同一拼图 `profileId`，首次点击返回时不直接退出，而是弹出独立面板。
+3. 面板标题固定为两行：
+   - `体验不佳？`
+   - `试试改造功能!`
+4. 面板主按钮为 `作品改造`，点击后复用公开详情页已有的拼图改造链路：
+   - 使用当前运行关卡的 `currentLevel.profileId` 调用 `remixPuzzleGalleryWork(profileId)`，避免下一关或相似作品运行态误用旧详情页作品。
+   - 成功后写入 `puzzleFlow.session`。
+   - 进入 `puzzle-result`，即游戏作品改造页。
+5. 面板次按钮为 `保存并退出`，点击后关闭面板并执行原返回逻辑。
+6. 非首次点击返回不再弹出面板，直接执行原返回逻辑。
+
+## 首次状态
+
+首次曝光是浏览器侧 UI 引导状态，不是业务真相态：
+
+1. 以 `currentLevel.profileId` 作为作品粒度。
+2. 使用 `localStorage` 记录已展示状态。
+3. `localStorage` 不可用时，使用当前组件生命周期内的内存集合兜底，避免同一挂载周期重复弹出。
+4. 点击 `作品改造` 或 `保存并退出` 都视为已经完成本次引导曝光。
+
+## 验收
+
+1. 首次点击拼图运行态左上角返回，出现标题为 `体验不佳？试试改造功能!` 的独立面板。
+2. 点击 `作品改造` 后进入拼图结果页改造草稿。
+3. 点击 `保存并退出` 后返回原目标页面。
+4. 同一作品再次点击左上角返回，不再出现面板。
+5. 不影响设置面板里的返回按钮、失败续时、通关结算和下一关入口。