补充图片画布安全恢复功能

增加撤销与恢复双向历史栈并在新编辑后清空恢复记录

增加恢复按钮和 Ctrl+Shift+Z 快捷键

阻止可能导致图片、素材或生成结果消失的恢复操作

增加恢复成功及恢复阻止提示并在三秒后隐藏

补充历史模型、快捷键、组件和页面集成测试

更新图片画布撤销与恢复规则文档

docs/【图片画布】撤销范围与操作提示方案-2026-07-17.md

@@ -1,26 +1,31 @@
-# 图片画布撤销范围与操作提示方案
+# 图片画布撤销、恢复范围与操作提示方案
 
 更新时间：`2026-07-17`
 
 ## 产品规则
 
-- 用户通过画布“撤销”按钮或 `Ctrl+Z` 触发撤销。
-- 撤销成功后，在画布工作区顶部居中显示 `已撤销：XX操作`，3 秒后自动消失。
-- 如果目标快照会删除当前图层、把当前可见图层重新隐藏，或者用旧素材替换当前素材，则不得恢复快照，并显示 `无法撤销：XX操作，可能会使图片消失`，3 秒后自动消失。
-- 被阻止的历史记录不得出栈，也不得自动跳过到更早记录；画布状态不变，因此不会触发项目自动保存。
-- 图片画布不提供重做按钮、重做快捷键或重做历史栈。
+- 用户通过画布“撤销”按钮或 `Ctrl+Z` 触发撤销，通过“恢复”按钮或 `Ctrl+Shift+Z` 恢复最近一次成功撤销的操作。
+- 撤销成功显示 `已撤销：XX操作`，恢复成功显示 `已恢复：XX操作`；提示位于画布工作区顶部居中，3 秒后自动消失。
+- 如果目标快照会删除当前图层或生成结果、把当前可见图层重新隐藏，或者用其它素材替换当前素材，则不得恢复快照。
+- 撤销被阻止时显示 `无法撤销：XX操作，可能会使图片消失`；恢复被阻止时显示 `无法恢复：XX操作，可能会使图片消失`。
+- 被阻止的记录不得出栈，也不得跳过到更早记录；画布状态不变，因此不会触发项目自动保存。
+- 成功撤销会生成一条恢复记录；成功恢复后仍可再次撤销。撤销后发生新的画布编辑时，清空恢复历史。
 
 ## 操作边界
 
-允许撤销的典型操作包括移动图片、移动生成结果、调整层级、组合与取消组合、删除或剪切图片、隐藏图片、锁定与解锁、翻转、修改素材类型和调整工具栏视口。删除与剪切允许撤销，是因为恢复目标只会让内容重新出现。
+允许撤销的典型操作包括移动图片、移动生成结果、调整层级、组合与取消组合、删除或剪切图片、隐藏图片、锁定与解锁、翻转、修改素材类型和调整画布视图。删除、剪切和隐藏允许撤销，是因为目标只会让内容重新出现。
 
-添加素材、上传到画布、粘贴、创建副本、生成图片、扩图新增结果、显示隐藏图片、替换图片以及其它会让当前结果消失的操作必须被撤销安全检查阻止。`Ctrl+C`、选择变化、滚轮或抓手视口移动、导出下载、项目重命名、素材库后端删除和生成任务副作用不进入画布撤销历史。
+添加素材、上传到画布、粘贴、创建副本、生成图片、扩图新增结果、显示隐藏图片、替换图片以及其它会让当前结果消失的撤销必须被安全检查阻止。`Ctrl+C`、选择变化、滚轮或抓手视口移动、导出下载、项目重命名、素材库后端删除和生成任务副作用不进入画布历史。
+
+恢复同样执行动态安全检查。移动、层级、分组、锁定、翻转和视图等不会减少内容的操作可以恢复；重新执行删除、剪切、隐藏、删除生成结果或替换当前素材时必须被阻止。
 
 ## 技术实现
 
-- 每条历史记录保存操作类型、操作前 `CanvasHistorySnapshot` 和创建时间，最多保留 60 条。
-- 操作类型只负责生成用户提示；能否恢复由当前快照与目标快照的差异检查决定。
-- 图层安全检查以稳定的 `layer.id` 判断当前图层是否仍存在，以媒体地址、对象存储标识和序列帧等字段组成内容签名，识别同 ID 图层的素材替换；仅刷新内部资源 ID 不视为图片消失。
+- 撤销栈和恢复栈均保存操作类型、目标 `CanvasHistorySnapshot` 和创建时间，分别最多保留 60 条。
+- 新画布操作把操作前快照写入撤销栈并清空恢复栈；成功撤销把当前快照写入恢复栈，成功恢复把当前快照写回撤销栈。
+- 操作类型只负责生成用户提示；能否应用快照由当前快照与目标快照的差异检查决定。
+- 安全检查以稳定的 `layer.id` 判断当前图层是否仍存在，以媒体地址、对象存储标识和序列帧等字段组成内容签名，识别同 ID 图层的素材替换；仅刷新内部资源 ID 不视为图片消失。
+- 当前生成对话框和非活动生成结果按稳定 ID 纳入内容存在性检查，避免恢复操作删除当前生成结果。
 - 位置、尺寸、层级、分组、锁定、翻转、标题和素材类型不进入内容签名，避免误拦截普通编辑。
 - 鼠标拖动在按下时暂存操作前快照，位移超过点击阈值后只提交一条历史；单击不产生历史记录。
 - 顶部消息复用 `PlatformRuntimeStatusToast`，成功使用中性色，被阻止使用警告色；连续触发会替换消息并重新开始 3 秒计时。
@@ -29,7 +34,10 @@
 
 1. 添加、上传、粘贴、复制、生成和替换图片后撤销，当前图片不消失且出现准确警告。
 2. 删除、剪切、隐藏、移动、分组和层级调整可以正常撤销，并出现成功提示。
-3. 被阻止后历史记录仍位于栈顶，连续撤销不会越过保护边界。
-4. 一次鼠标拖动只产生一条历史，单击不产生历史。
-5. 页面不存在重做按钮和可用的 `Ctrl+Shift+Z` 重做入口。
-6. 提示在 3 秒后消失，连续提示按最后一次触发重新计时。
+3. 移动、层级、分组、锁定、翻转和视图等安全操作可以恢复，并可再次撤销。
+4. 删除、剪切、隐藏、删除生成结果和替换素材的恢复会被阻止，当前内容保持不变。
+5. 被阻止的记录仍位于栈顶，连续撤销或恢复不会越过保护边界。
+6. 撤销后发生新编辑会清空恢复栈；恢复按钮随栈状态正确启用或禁用。
+7. 一次鼠标拖动只产生一条历史，单击不产生历史。
+8. `Ctrl+Z` 与 `Ctrl+Shift+Z` 分别触发撤销和恢复，在可编辑输入区域内不拦截原生行为。
+9. 提示在 3 秒后消失，连续提示按最后一次触发重新计时。