用途：把一条成片拉片为逐镜头分析表，供仿写参考、剪辑节奏分析或投放素材盘点。镜头边界与时长由代码实测（ffmpeg 场景检测、ffprobe，两位小数），运动量取逐帧差分区间中位数；景别、类别、运镜、画面、节奏由模型看关键帧判断。
主要能力：seed 生成底稿；frames 抽每镜起手/收尾两张关键帧；sheet 拼联系表；逐批填写字段；recut 补刀并刀并自动重编号；validate 跑 15 道质量门（时间轴连续、时长自洽、词表、运镜实测对账、类别证据等）；render 输出 Markdown 与单文件交互报告（播放器同步高亮、节奏带、镜头表、统计与人物卡）。支持中英双语 --lang zh|en。
使用方式：脚本零依赖，node 直接运行。常用命令：node {baseDir}/scripts/video-shots.mjs seed <video> --track track.json --title "<片名>" > shots.json；frames shots.json --video <video>；sheet shots.json --cols 4 --rows 6；recut shots.json --track track.json --split 63.5 --merge 45.97；validate shots.json --track track.json --frames frames；render shots.json --md/--html --track track.json。跨批次建议先看联系表再看单帧。仅 seed/recut/validate/render 覆盖机器字段，手工只改模型判断字段。
适用场景：短片或成片的分镜拉片、节奏与景别统计、镜号清单与关键帧对照。限制：不做语音转写（台词仅来自画面烧录字幕）、无人脸识别与人物自动归并、不评价片子好坏、不剪辑导出、不做镜头内物体检测；场景检测不认叠化，实测运动不区分机位动与主体动；报告不含视频数据，需 --video 指路或页面现场选文件。部分细节暂未提供。