用途：对屏幕录制做类似 Screen Studio 的后期处理，全程无头运行，适合制作演示、教程和面向社交平台的竖屏视频。
主要能力：events-log（Swift）在录制时以 60Hz 记录光标、点击和按键（macOS 安全输入期间会丢弃按键），需为终端开启辅助功能/输入监控权限；这些数据无法从像素中事后恢复。polish.py（Python，依赖 ffmpeg 与 PIL）执行后期：--speedup 压缩空闲（输入间隔与冻结像素交集，动画保持 1x，无事件时仅用 freezedetect 也可用）、--zoom 对点击簇做缓动自动缩放、--keys 叠加累积按键提示、--smooth-cursor 生成平滑合成光标、--vertical 额外输出 1080x1920 竖屏。render.py 是首选的高质量非破坏渲染器：对原始高分辨率帧做单遍弹簧物理相机运动，LANCZOS 缩放到较小目标，60fps，输出横屏与 9:16 竖屏，可调 --freq/--zeta、--fps、--target-w，并接受显式 --regions。studio.py 提供本地网页 UI，采用固定标尺时间线，缩放区域可拖动、可加结束关键帧形成平移，空闲段可调速率，导出走 render.py。
使用方式：python3 src/polish.py in.mp4 --events in.events.jsonl 加相应开关；screencast.sh --demo 可一键完成记录、后期并自动输出竖屏。
限制与注意：本机 ffmpeg 缺少 drawtext，文字与光标叠加均用 PIL 渲染 PNG 再 overlay；ffmpeg 无法做动画 scale=eval=frame，故缩放使用 zoompan。文字标注不得重叠、需留约 0.3 秒以上间隔、在加速段要延长显示窗口。不要用 Playwright recordVideo 录制演示，应使用 test/record-demo.js。建议将渲染结果交给视频理解模型做客观评审。具体收费、平台支持等信息暂未提供。