Vibe 知识大赏制作

将一个知识主题制作成可观看的短视频及发布素材。支持完整制作，也支持只改字幕、节奏、配乐、封面或文案；局部修改时保留已确认内容，只交付用户要求的部分。

已确认的默认偏好

默认值见 assets/defaults.json，用户本次要求和已有项目设置优先：

中文知识内容；横屏16:9，1920×1080、30fps；一般30–45秒，按内容和音乐整拍确定，不强行凑固定秒数。
不添加旁白或配音。用户音乐原有的人声保留；"无额外配音"不等于纯音乐。
大字、短句、较快切换、鲜明视觉重点。暗色＋薄荷绿＋暖橙是可用起点，不把所有题材固定成电路风格。
使用用户给的音乐，保持原速，分析拍点后排切镜。可用4/6/8拍长短交替，但按曲子的实际节拍与阅读时间调整。
完整交付包含MP4、4:3横封面、3:4竖封面、标题、简介、话题及可继续修改的源码。
标题格式默认 Vibe知识大赏｜具体钩子或问题，再按需要加入知识名称。
输出放在当前工作区一个独立项目中，最终给可点击的绝对文件路径。

接手任务

先检查当前项目已有的project.json、分镜、预览、成片及用户已确认意见。不要重新制作已经完成的部分。主题、音乐、规格或授权在对话里已明确时，不重复询问。只在缺失输入确实影响工作时提问，并先推进不依赖回答的部分。

最小输入是主题；音乐可在后续补充。没有音乐时先做文案与分镜，不捏造音乐路径或宣称完成卡点。用户说"按你的理解"时，用默认偏好自主完成常规选择。预览确认与本地导出的既有授权持续有效；已授权的渲染、修复和重试无需反复确认。若用户只要预览则停在预览阶段；若当前尚未授权最终导出，提供可审阅版本后只确认一次。此流程不包含自动发布到平台。

制作流程

建立项目。 用 scripts/create_project.py 创建独立项目、保存主题/音乐/规格；已有项目直接继续。脚本只建工程目录和输入记录，不替代创作、测拍或渲染。
核对知识。 优先一手资料，明确核心结论、适用前提、一个可验证算例和容易误解的边界，保存到 sources.md。隐喻要标明边界，不能把物理定理改写成心理学定律。数学、电路、单位和正负号需要前后一致。
写短文案和分镜。 用具体问题开场，每镜承载一个重点，结尾回扣问题。标题、说明、图形分别承担不同信息，避免一屏多段解释。先确定阅读负担，再安排快慢节奏，不以镜头数量代替冲击力。
音乐与统一时间表。 需要卡点时读取 references/timing-and-render.md。用 scripts/beat_plan.py analyze 测拍，检查BPM、半拍/倍速歧义和强起音；以用户选定片段或试听结果为准。用 plan 将镜头拍数、关键词、公式与纠错等事件转换成统一的帧号与时间表。音乐截取点、场景、字幕和动效全部使用该表，不同时维护多套手填秒数。
制作工程与预览。 默认优先本地可用的 HyperFrames 工程。需要时读取可用的 hyperframes-vibe-169 及其组合契约，遵守子组合和 paused GSAP 时间线要求。使用 assets/hyperframes-clock.js 或等效精度修正，避免GSAP六位小数使切镜晚一帧。换引擎时沿用用户已有工程，不为调用技能而重做。
检查并完成渲染。 运行引擎校验，检查每镜、大字边界、随机跳播、关键拍点前后帧，再按已有授权本地导出。用 scripts/audit_render.py 检查实际成片的规格、帧数、完整解码和音轨偏移；另外逐帧检查所有切镜及关键动效，脚本解码通过不能代替画面检查。发现问题修复后只重跑受影响检查与最终成片验证。详情见时序参考。
封面与发布素材。 读取 references/visual-and-delivery.md。使用 imagegen 或已有明确的封面模板生成4:3、3:4两种独立构图，核对汉字、公式、箭头、边距与实际像素比例。生成与成片一致的标题、简介和少量相关话题。
交付。 确认实际文件存在后给出MP4、双封面、发布文案和项目目录。说明时长与规格、重要限制即可。没有成功导出时明确说"预览/源码已完成"，不能称成片完成。保留project.json、sources.md、storyboard.json、beat-map.json、验证结果及源码，便于后续继续修改。

组合其他技能

hyperframes-vibe-169：选用该引擎时负责组合结构、lint、preview、render。其风格示例不替代本次主题。
lemo-opuscar：用户要求该技能或题材需要其导演/风格方法时使用，读取相应风格即可。已有成片局部修订不自动重走新片风格问卷。
painted-animation / Joker-chichi/claude-mv-skill：仅在手绘动画、歌词MV或需要其测拍工具时读取相应部分。知识片配BGM不要求用户另给LRC。
imagegen：负责生成或修改位图封面。保存最终图片到项目，记录提示词；不把技能说明当作可直接调用的图片API。
openfilm / jianying-editor：用户指定或现有工程确实使用时再走对应流程。

不要求每期同时运行所有技能。工具不可用时，先检查既有本地运行环境和可行替代，不静默安装大型依赖、不替换用户指定产品。保留明确失败信息，不用无限重试掩盖问题。

辅助脚本

脚本以Python 3运行，音频分析与同步检查另需NumPy；FFmpeg/FFprobe可从PATH或显式参数传入。无需API密钥，不附带音乐、渲染器或第三方二进制。用本机已发现的Python/Node，不把旧项目的绝对路径当通用依赖。

python scripts/create_project.py --workspace <工作区> --slug <主题短名> --topic <主题> --music <MP3可选>
python scripts/beat_plan.py analyze --music <音乐> --out <拍点JSON> --offset 0 --seconds 50 --ffmpeg <ffmpeg路径>
python scripts/beat_plan.py plan --grid <拍点JSON> --story <分镜JSON> --out <beat-map.json>
python scripts/audit_render.py --video <MP4> --plan <beat-map.json> --score <最终配乐文件可选> --out <audit.json>

分镜输入格式、人工修正拍点和渲染精度见时序参考。目录模板、封面和文案验收见视觉与交付参考。脚本输出数值是检查证据，不是美术或科学正确性的自动保证。

vibe-video-producer