Site Reels 的核心用途是把本地运行的网站或 Web 应用录成可用于演示文稿和上传素材的视频，输出规格为 1920×1080、30fps、x264、小于 100MB 的 MP4；另提供 60fps 的确定性录制方式和高帧率品牌短片工作流。
运行环境要求：Windows、macOS 或 Linux，带 GPU 和可见桌面（Chrome 以有头模式运行）；Node.js 18+；ffmpeg 与 ffprobe 在 PATH 中（或用 FFMPEG 指定完整路径）；系统需安装 Chrome、Chromium 或 Edge，脚本会自动探测。录制依赖 puppeteer-core 与 puppeteer-screen-recorder，snap.mjs 依赖 puppeteer-core 与 timesnap，品牌短片还需 Remotion 项目；可选审计需要 ImageMagick，Figma 上传需要 Figma MCP 及 figma-use、figma-use-slides 技能。
使用方式：新建项目目录并安装依赖，把 record.mjs、find-chrome.mjs 复制到 scripts/，再复制 scenes.example.mjs 为 scenes.mjs 并按需编辑场景；在站点仓库执行生产构建并以指定端口启动，然后用 OUT 指定输出目录运行 record.mjs。场景对象包含 name、path、theme、trim、crf、css，以及 prepare(page, ctx)（录制前滚动到目标区域、等待 3D 加载）和 act(page, ctx)（实际录进视频的动作）；ctx 提供 wait、scrollTo、scrollThrough。环境变量可控制 BASE、输出目录、Chrome 路径、ffmpeg 路径、分辨率、DPR、移动端触摸模拟、保留导航和最低帧率等。
验收要点：脚本退出码不可信，需按视频生成缩略图拼板检查；19 秒仅 1MB 通常意味着空白画面，超过 100MB 则无法进入 Figma，可通过场景级 crf 调整；裁切顶部条带检查导航是否泄漏；开头或结尾长停顿导致的 LOW-FPS 多为假警报，应看拼板确认。已知坑包括后台窗口冻结 rAF 导致画面静止（启动参数已规避）、有头模式是刻意选择、隐藏 UI 的样式会被 React 水合清掉需定时重挂、无效选择器会连累整条规则、懒加载 3D 需要固定等待、投屏约 32 帧/秒故按 30fps 录制、机器负载高时需重录、Cookie 横幅需在 prepare 阶段接受，以及无滚动的工具页需通过交互产生动态。
snap.mjs 用于 60fps 锁定帧率的确定性录制：注入 timeweb 虚拟时钟，每帧推进 1/60 秒并截图，不受机器负载影响；需执行 patch-timeweb 补丁，场景结构包含 dur、wait、pre、start、scroll、frame 等字段。交付脚本 deliver.example.sh 可复制重命名素材并生成循环与干净 3D 片段，必要时逐步提高 crf 以压到 95MB 以内。
Figma Slides 上传有限制：MP4 不能经 MCP 传输，upload_assets 只接受不超过 10MB 的图片。因此先为每个视频抽封面，再用 use_figma 在末尾前创建名为 WIP · Motion (hidden) 的行，为每个视频创建标记为跳过的幻灯片、黑色背景、1920×1080 矩形并以说话者备注写明操作说明，然后用 upload_assets 上传封面；最后由用户把 MP4 拖到矩形上替换封面。
品牌展示片用 Remotion 组合：站点只录不含文字和导航的干净素材，其余版式、字体、调色板、宣言、样机等在设计端生成；视觉规范以演示文稿为准而非站点。渲染建议 --concurrency=3，先以静帧检查，循环片段需检查首尾帧接缝。资料还记录了快节奏品牌片、烟雾叠加片、产品实录片（Playwright 采集 + Remotion 重绘光标）、作品集卡片与工作室片的具体经验与已否决做法。作品集卡片使用 KEEP_UI=1 与手机预设，可输出交叉淡化循环、VP9 WebM 与首帧 WebP 海报，带透明标识可用 VP9 + yuva420p 或 ProRes 4444。
限制与未提供项：价格、收费模式、授权许可、安装包体积、支持团队规模和官方服务等级均暂未提供；录制必须有 GPU 和可见桌面，headless 模式不被采用；Figma 中的视频插入需要人工操作，工具不承诺自动插入视频。