SuperAPI AI 工具集

motioneyes-animation-debug

设计与创作

查看项目

更新于 10-15 23:34

技能介绍

用途:把 MotionEyes 当作临时可观测工具,用于 SwiftUI 动画调试与回归验证。适用于动画方向错误、开始过晚或结束过早、透明度/偏移/位置时序不符、两个元素在过渡中漂移或失同步、ScrollView 偏移跳变或无法恢复等场景;问题与 SwiftUI 动画或滚动无关、或无法在模拟器/设备复现时不应使用。

主要能力:通过 Trace.value、Trace.geometry、Trace.scrollGeometry 采集数值与几何随时间的变化;区分屏幕可见运动(space: .screen, source: .presentation)、布局关系(space: .swiftUI(.global), source: .layout)、局部容器关系(.local)与滚动几何;分析方向、时序、形状与相对关系;可将轨迹转为 UITest 或回归断言,连续性用 MotionSmoothness,方向/单调性与时序需分开断言。

使用方式:先以可度量方式确认问题与预期,定位驱动动画的状态值;确保 MotionEyes 可用,缺失时自动集成到应用目标;添加最小化的 .motionTrace(...) 埋点,名称对应意图;运行复现;优先用 XcodeBuildMCP 采集日志,不可用时回退 CLI:xcrun simctl spawn booted log stream --style compact --level debug --predicate 'subsystem == "MotionEyes"';分析日志后修复或加断言,重跑验证;最后仅移除本次新增的导入、修饰符与指标,保留原有埋点并确认可编译。

限制:阈值不应全局硬编码,需按用户意图与已知良好基线调整;MotionSmoothness 仅作局部连续性启发,不证明渲染帧率,也不单独拒绝过冲或回退;样本过少或时间戳不规则时应说明并升级为视觉分析。资料未提供具体收费、平台与价格信息。