关键帧时间点必须手动输入精确值以避免卡顿或跳帧，禁用吸附功能后双击时间数字直接键入如2.0、4.0等带一位小数的值，复制粘贴时需注意位置与覆盖方式。
时间轴关键帧时间点必须手动输入，不能靠拖动对齐
Composer 时间轴默认开启吸附（Snap to Frame），但“吸附”只对帧率取整，不保证逻辑时间点对齐。比如你想要 2.0s、4.0s 的循环节，拖动关键帧时哪怕看起来挨着刻度线，实际可能是 1.998s 或 2.003s——播放时就会在边界卡顿或跳帧。
正确做法是：
- 右键时间轴 → 取消勾选
Snap to Frame（或按Ctrl+Shift+S切换） - 双击关键帧下方的时间数字（如
2.000），直接键入2.0、4.0、6.0等带一位小数的值，回车确认 - 复制关键帧后，不要粘贴到当前滑块位置；先拖动时间栏到空白区域，再
Ctrl+V - 若想覆盖已有关键帧，粘贴前按住
Alt（Windows）或Option（Mac）
时间轴缩放与平移操作直接影响关键帧定位精度
鼠标滚轮缩放时间轴时，不是“放大时间粒度”，而是改变每像素代表的毫秒数。缩得太小（显示范围过大），关键帧会挤在一起，拖动极易错位；缩得太大（只显示几秒），又容易漏掉跨段衔接点。
建议工作流：
- 制作循环动画时，先设好总时长（如循环段 3.0s × 3 次 = 9.0s），把时间轴终点拉到
9.0以上 - 用中键拖动时间轴横向平移，确保关键帧区间完整可见
- 缩放层级以能清晰分辨相邻关键帧间距为准（例如 0.5s 间隔不重叠）
- 调整完关键帧位置后，按
Home键回到起点，逐帧拖动滑块检查衔接是否严丝合缝
预览窗口比例由主窗口像素尺寸决定，和时间轴缩放无关
很多人误以为调时间轴缩放就能“模拟手机横屏”，其实完全无关。预览窗口只是主窗口渲染画布的实时缩放镜像，它的宽高比 = 主窗口客户区像素宽 ÷ 高。
要获得准确的设备比例预览：
- 关闭所有 Fit to View 视口设置（否则内容被强制填满，掩盖真实构图）
- 手动拖拽 Composer 主窗口右下角，拉出目标比例，如手机竖屏用
1080×2400，横屏用2160×1080 - 导出前务必勾选
重新调整应用程序窗口以暂时适合此自定义范围，否则导出尺寸仍是原始窗口大小 - 避免依赖系统 DPI 缩放或第三方窗口管理工具——Composer 不读这些值，只会导致鼠标拾取偏移、关键帧定位不准
WSL2/Docker 环境下关键帧时间异常漂移的根源与对策
在 WSL2 或 Docker 容器中打开 .smg 文件并编辑关键帧后，时间轴上关键帧自动偏移、顺序错乱，甚至报 signature verification failed，这不是 Composer bug，而是宿主机与虚拟环境系统时间不同步所致。
Composer 依赖文件系统时间戳（filemtime()）解析关键帧先后顺序。一旦偏差超过 60 秒，它就无法判断哪个关键帧该在前。
临时修复方式：
- 在 WSL2 中运行：
sudo hwclock -s同步硬件时钟 - 或定期执行：
sudo ntpdate time.windows.com - 更稳妥的做法：所有关键帧编辑都在宿主机原生环境完成，WSL2/Docker 仅用于脚本批处理或格式转换
这个时间同步问题极难复现也极难排查，往往被当成“软件抽风”，但只要涉及跨环境编辑，就必须把它列进 checklist 第一条。
