整理动画接入文档与调试面板分组

animation-review-checklist.md

@@ -0,0 +1,162 @@
+# 动画接入评审清单
+
+## 1. 用途
+
+这份清单用于在接设计稿或准备开发前，快速判断：
+
+- 这个动画能不能接
+- 应该接到哪一层
+- 有没有性能风险
+- 有没有交付缺口
+
+---
+
+## 2. 设计稿评审
+
+### 2.1 动画目标是否明确
+
+- 这个动画是为了表达什么？
+- 它是状态反馈，还是纯装饰？
+- 用户不看它，会不会影响理解？
+
+### 2.2 触发条件是否明确
+
+- 由哪个事件触发？
+- 是否会高频触发？
+- 是否允许重复触发？
+
+### 2.3 交付是否完整
+
+- 是否有参数规格？
+- 是否有资源文件？
+- 是否有尺寸 / 比例说明？
+- 是否有 `lite` 降级说明？
+
+---
+
+## 3. 技术评审
+
+### 3.1 该动画属于哪一层
+
+- 地图空间
+- HUD
+- UI反馈
+- 过场
+
+### 3.2 最合适的实现方式是什么
+
+- 程序动画
+- Lottie
+- 序列帧
+- 视频
+
+### 3.3 是否真的需要资源文件
+
+很多动画其实可以纯程序实现，不需要额外资源。
+
+如果只是：
+
+- pulse
+- 渐隐
+- 平移
+- 数字过渡
+
+优先用程序动画。
+
+---
+
+## 4. 性能评审
+
+### 4.1 是否高频
+
+如果是高频事件，不适合做重动画：
+
+- GPS 更新
+- compass heading 更新
+- 拖动 / 缩放
+- telemetry 微小变化
+
+### 4.2 lite 模式怎么处理
+
+必须明确：
+
+- 保留
+- 简化
+- 关闭
+
+### 4.3 是否会增加页面层负担
+
+要判断：
+
+- 会不会引入高频 `setData`
+- 会不会创建大数组
+- 会不会增加持续循环动画
+- 会不会增加桥接成本
+
+---
+
+## 5. 交互评审
+
+### 5.1 是否可中断
+
+- 用户切页面怎么办？
+- 状态瞬间变化怎么办？
+- 连续触发怎么办？
+
+### 5.2 是否会和现有动画冲突
+
+- 同一事件是否已有动画？
+- 是否会重复表达同一个信息？
+- 是否和现有地图 pulse / HUD 动效叠加过重？
+
+---
+
+## 6. 当前项目特别注意项
+
+### 6.1 地图过程中的动画必须克制
+
+因为当前项目：
+
+- 地图是主舞台
+- 低端机性能敏感
+- 页面桥接成本高
+
+所以：
+
+- 地图上的高频动画必须轻量
+- 尽量减少页面层大范围动画
+
+### 6.2 优先动画化高价值节点
+
+优先做：
+
+- 打点成功
+- 目标切换
+- 跳点
+- 危险 / 高压反馈
+
+延后做：
+
+- 纯装饰性微动效
+- 复杂长演出
+
+---
+
+## 7. 验收清单
+
+动画接入完成后，至少确认：
+
+- 触发时机正确
+- 结束时机正确
+- 多次连续触发稳定
+- `standard / lite` 都可用
+- 低端机可接受
+- 不破坏现有状态链
+
+---
+
+## 8. 结论
+
+动画接入前，只要这份清单里有明显回答不出来的问题，就不应该直接开做。  
+先补规格，再接程序。
+