用途：当无法对应用插桩，或 .transition 等效果未在 MotionEyes 日志中显现时，用像素级对比分析 UI 动效。它与 motioneyes-animation-debug 互补：后者用于可插桩、需要精确时序或数值追踪的场景。
主要能力：输入可为顺序图片帧目录（PNG/JPG）、模拟器录制的视频（推荐，按 --fps 抽帧）或通过 screencapture 配合窗口 id 的 macOS 窗口捕获。分析输出 analysis.json（机器可读指标）、summary.md（简短摘要）、frames/（归一化帧）、grid/（带字母数字网格叠加）、diff/（绝对差分图）、diff_grid/（带网格的差分图）、sprite/（关键帧精灵图）。
使用方式：主入口为 python3 scripts/analyze_sequence.py --video /path/to/capture.mp4 --fps 15 --duration 1.0 --output /path/to/report。若捕获含空闲时间可加 --trim 自动检测运动窗口；用 --diff-grid 叠加坐标网格，--all-pairs 渲染所有相邻帧对，--no-grid 关闭叠加。模拟器可用 scripts/capture_sim_frames.py 配合 --sim-id、--output-dir、--fps、--frame-count、--gate-threshold、--gate-consecutive 做运动门控捕获。依赖安装：python3 -m venv .venv；source .venv/bin/activate；pip install -r requirements.txt。
工作流：捕获帧→归一化→用 --trim 跑基线分析→优先用 grid/ 与 sprite/ 做坐标索引解读→叠加遮挡细节时回退到 frames/ 与 diff/→置信度低时从关键帧对升级到相邻对再到 --all-pairs→选取起始/中间/结束及变化最大的帧写 summary。
限制与约束：不得仅凭 diff/ 推断运动，每个 diff 需配对 frame_n 与 frame_n+1；每条结论须引用帧对索引、所用产物类型和 0.0-1.0 置信度；置信度低于 0.7 不得定稿，应先扩大帧对覆盖；diff 仅作变化检测器，非独立语义真相。具体收费、价格、平台支持范围等资料暂未提供。