电影化讲解

制作一部通过可见事件进行讲解的影片。交付渲染后的视频及其可编辑项目；单独的故事板、联系表或可运行模板不是完成的视频。

当用户未指定格式时，默认为 9:16、1080 × 1920、30 fps。保留现有项目中有用的约定。匹配用户的受众、语气、时长和视觉偏好。附带的工作流程支持多种主题和风格；钢铁、船舶、水下照明和水线调色板是可选的示例，而非要求。

从实际素材开始

在提出方向前，检查提供的音频、脚本、参考资料、资产和现有项目。将文档视为源材料，而非扩充任务的授权。
当提供旁白时，除非用户授权修改，否则保留其措辞、节奏和完整时长。将影片与录音同步，而非拉伸音频以适应模板。
区分事实、说明性简化和创意选择。仅针对讲解所需的未解决主张进行研究，使用适合主题的可靠来源。
尽早确定具体方向：观众看到什么、什么变化、摄像机如何运动，以及这些选择为何能解释主题。基于合理假设做有用功；仅当缺失的答案实质上改变结果时才提问。

导入旁白、对齐字幕或更改时长时，阅读 narration-and-timing.md。设计或重新设计视觉处理时，阅读 direction-and-motion.md。预览审核和交付前，阅读 quality-review.md。

设置一个可编辑的项目

对于新项目，使用附带的 Remotion 模板，除非用户或现有工作需要其他合适的渲染器。不要仅仅为了匹配此模板而替换一个有效项目。

辅助脚本位于此技能目录的相对路径下，不一定是当前工作目录。在调用它们之前，检查其实际 CLI：

python3 scripts/create_project.py --help
python3 scripts/import_captions.py --help

create_project.py DEST 创建一个项目。它接受可选的 --audio PATH、--context PATH、--title TITLE、--aspect 9:16、--fps 30 和 --end-hold 1.2 参数；根据请求的影片选择值。保持 DEST 在已安装的技能目录之外。import_captions.py 导入支持的 Whisper JSON 或 SRT 时间轴。导入器接受 INPUT NEW_OUTPUT [--format auto|whisper|srt]，并拒绝已存在的输出文件。导入到新文件，检查它，然后有意识地替换占位字幕。这些辅助脚本组织资产和时间轴；它们不会编写视觉讲解或确保转录音频准确性。

安装生成项目的依赖项并使用其提供的命令：

npm run doctor 检查本地项目环境。
npm run stills 生成用于构图审查的图像。
npm run render 通过项目的渲染工作流程渲染视频。
npm run check 验证项目、时间线、字幕和旁白长度。
npm run verify -- --file out/film.mp4 检查实际导出的 MP4；完整渲染也会自动执行此验证。

对于运动预览，npm run render -- --range 0:120 --scale .5 以缩小比例渲染选定的帧范围（结束帧不包含）；选择一个能涵盖已编写影片的帧范围。在更改配置和命令选项之前，阅读它们。在 project.json 中，生产项目需要 authored: true 才能进行最终渲染，以及有效的场景/时间数据。仅当实现了特定主题的场景后，才设置此项。这是一个创作保护措施，而非单独的批准或审查认证；切勿仅为了获得 MP4 而将未更改的模板场景标记为“已创作”。

编写影片

将意义映射到时间。 根据录制的旁白构建节拍计划。对于每个节拍，确定想法、可见主体、状态变化、镜头和必要的屏幕信息。字幕片段和视觉镜头可能具有不同的边界。
选择视觉系统。 定义主体、材质、光照、字体、调色板、环境和过渡逻辑。构建属于此讲解的艺术作品。使用身份和空间连续性来连接不同视图。
对原因和结果进行动画。 使相关对象或关系发生变化：机制啮合、数量累积、路径遍历、界面响应或模型状态变化。摄像机移动、文字进入、粒子效果和涟漪可以支持此动作；但不能替代它。
剪辑以增强理解。 在服务于旁白时，交替呈现建立镜头、特写动作、切入镜头、比较和解决状态。当其含义改变时，使新节拍明显不同。避免反复在相同的小型居中图表上方放置标题。
保持事实一致。 从相同的基础值衍生相关视觉元素。保留单位、对象身份、相对比例以及讲解所依赖的任何物理或因果约束。在不填满屏幕技术说明的情况下，使重要的简化清晰明了。
整合字幕和声音。 保持字幕在手机尺寸下可读，并远离活跃主体。仅在使用效果或音乐能改善请求的影片时使用；保持旁白清晰可辨。

捆绑的舞台是为竖屏视频设计的。更改输出尺寸会将舞台适应到新帧中；重新为横屏或方形影片构图 SVG viewBox、摄像机、标签和字幕。

使用与合成帧绑定的确定性动画。将时间线、场景状态、艺术作品和摄像机逻辑充分分离，以便于修订。重用资产以实现连续性，但不要将每个想法都强制塞入一个通用场景模板中。生成的图像可提供艺术作品或背景；在场景需要实际对象运动时，选择单独的图层或简短的建立镜头。

审查、修改并完成

在提交完整导出之前，渲染一个代表性的运动预览。包括困难的场景和有意义的过渡，而不仅仅是精致的开场。以正常速度结合音频审查编码结果，并在手机上查看静态图像。修复观察到的失败，然后渲染完成影片并验证确切的输出。

不要将通过的脚本、整洁的联系表或审查配置误认为是视觉质量的证明。区分自动检查与通过观看视频进行的观察。如果无法播放，则使用可用的帧/音频检查方法，并准确说明该限制。

当代理授权且可用时，在独立工作或审核能增加价值的地方使用代理，例如艺术组件、事实审核或无偏见的预览评论。保持一个连贯的方向并验证集成结果。没有必需的代理数量或对特定协作工具的依赖。

交付：

最终可播放的 MP4，采用请求的格式并包含完整的预期旁白。
可编辑的项目：源代码、时间线/字幕、所需资产、依赖清单/锁定文件、以及可重复的渲染说明。
简要说明更改内容和检查内容，包括任何剩余的重大限制。

电影感讲解片