aibis-dream/Docs/帧动画系统第五阶段手动测试.md

帧动画系统第五阶段手动测试

1. 测试准备

1. 在 Unity 执行 Tools > Frame Animation > Create Phase 5 Preview Sample。
2. 打开 Assets/GameContent/Test/FrameAnimation/Preview/PreviewSampleGraph.asset。
3. 确认通过 Inspector 的 Open Graph Editor 进入工作台。
4. 首次测试前将 Node Preview Policy 设为 SelectedOnly、速度设为 1×、背景设为 Checkerboard。

样例构建器只在资产不存在时创建，不会覆盖已经存在的 Preview Sample 或其他测试 Graph。

2. Clip 独立预览

依次选中 PreviewAction、PreviewEmpty 和 PreviewIdle。

• 右侧显示 Clip Preview，顶部与右侧的 Play/Pause、Stop、Restart、Previous、Next 和时间轴保持同步。
• Pause 保留当前帧；Stop 回到实际第 0 帧；Restart 从第 0 帧开始播放。
• 拖动时间轴后保持 Paused，Previous/Next 定位到帧边界。
• PreviewEmpty 的空帧显示棋盘格并停留约 300 ms，不跳帧。
• PreviewIdle 展示一轮时间轴，总时长显示 ∞，播放时持续循环。
• 切换 Dark、Light、Checkerboard 后画面背景立即更新，Graph 和 Clip 不变 dirty。
• 测试 Fit、1×、2×、3×、4×、8× 和 Manual；非 Fit 放大后可拖动画面。

3. Node 内嵌预览策略

1. 选择 Finite Action Node。
2. 在 SelectedOnly 下确认只有主选中 Node 自动播放。
3. 点击 Stop，确认该 Node 停在第 0 帧且不会立即自动重启；重新选择或点击 Play 后恢复。
4. 切换 Static，确认所有 Node 显示第一个非空代表帧，选中 Node 仍可使用顶部控制器手动播放。
5. 切换 AllVisible，确认视口内 Node 播放；平移使 Node 离开视口后停止更新，移回后重新开始。
6. 框选多个 Node，确认只有主选中 Node成为顶部上下文目标。

4. 有限 Flow 与跨节点时间轴

1. 在 Flows 选择 PreviewFiniteFlow 并播放。
2. 确认画布当前 Node、已经过路径和后续路径状态不同。
3. 播放跨过 Finite Action -> Finite Empty 时，当前 Node 和 Clip 信息随之切换。
4. 拖动顶部时间轴跨越节点边界，确认对应 Node 与内嵌 Sprite 同步定位。
5. Previous/Next 可以跨节点逐帧。
6. 播放自然结束后保留终点末帧；Stop 回到入口第 0 帧。

5. Loop、零速与结束行为

• PreviewLoopFlow：时间轴显示前缀加终点一轮，总时长为 ∞；进入终点后进度只在终点循环段内循环。
• PreviewBlockedFlow：显示零速度阻塞位置，播放状态保持但不推进，时间轴不能越过阻塞点。
• PreviewClearFlow：自然结束后显示透明棋盘格并标记 Clear。
• PreviewHideFlow：自然结束后同样显示透明内容，但状态标记为 HideTarget。
• 将预览速度依次设为 0.25× / 0.5× / 1× / 2× / 4×，确认只改变播放快慢，不改变时间轴总长度。

6. Flow 预览与聚焦

1. 播放任意 Flow，按 Esc 或点击 Exit Focus。
2. 确认全部节点恢复正常亮度，但 Flow 预览继续运行。
3. 选择当前 Flow 内 Node/Edge，确认 Flow 继续播放且顶部仍显示 Flow 目标。
4. 选择 Flow 外 Node、Graph、Clip、Source 或其他 Flow，确认当前 Flow 预览停止并切换上下文。
5. 停止 Flow 后确认原 NodePreviewPolicy 恢复。

7. 修改、刷新与错误

• 播放 Clip/Node 时修改 Sprite、duration、speed 或结束行为，确认预览重建且不使用旧帧引用。
• 播放 Flow 时修改入口、Edge 或 Node Clip，确认 Flow 安全停止，重新 Play 后使用新路径。
• Preview/Refresh ImportSource 后确认活动预览失效并可使用刷新后的 Sprite 重新播放。
• 空 Clip、Missing Clip、负速度和非法 Flow 显示结构化错误，不抛异常、不修改资产。
• 预览期间观察 dirty 状态和 Undo 历史，确认单纯播放、拖动与缩放不产生资产修改。

8. 工作区恢复

1. 修改左右宽度、底部高度、搜索、筛选、排序、选择、画布 pan/zoom 和预览偏好。
2. 切换到其他 Graph 再切回，确认各 Graph 状态独立恢复。
3. 关闭并重新打开窗口，确认状态恢复。
4. 触发脚本重编译或 Domain Reload，确认状态恢复但播放进度不恢复。
5. 确认 Flow 聚焦始终从 Show All 开始，不恢复旧 focusedFlowId。

9. 第一版完整回归

• 按第一至第四阶段文档回归资产管理、导入刷新、节点编排、Flow 聚焦、Undo/Redo 和运行时播放。
• 在 FrameAnimationRuntimeTest.unity 验证 SpriteRenderer 与 Image 运行时结果和编辑器预览一致。
• 运行 EditMode、PlayMode、批处理编译和 git diff --check。
• 对照 Docs/动画系统需求整理.md 第 9 节逐项确认第一版验收标准。