SuperAPI AI 工具集

mc-graphics

设计与创作

查看项目

更新于 10-29 21:17

技能介绍

mc-graphics 是 bmad-manticore 视频制作技能链中的图形渲染阶段技能,在“gate 3”(节拍点锚定校验)之后运行,也可由用户指令“build the graphics”或“render the overlays”触发。其输入是已批准的 beat table,输出是 graphics/ 目录下的 ProRes 4444 alpha 渲染文件及 graphics/HANDOFF.md。

【激活流程】加载 studio 配置,读取 project.json(确认 approvals.beats 为日期、阶段为 graphics)、beats/beats.md、beats/STORYBOARD.md、格式档案及各引擎说明;读取 {brand-path}/tokens.json 与 production-bible.md,任一缺失即引导至 mc-setup 并停止;读取编辑器名称与 resolve-title-template。还须确认 beats/anchor-check.json 存在且 "ok": true,否则退回 mc-beats。

【引擎工作区】工作区位于 {engines-path}/<engine>/,首次使用时按引擎 README 初始化。HyperFrames 需初始化或刷新 Agent Skills(npx hyperframes init 等)。

【创作来源】优先从 HyperFrames 目录与已安装技能中检索匹配块或效果(npx hyperframes catalog --query、npx hyperframes add);对成片静帧的简单运动偏好 ffmpeg 配方;确有需要才用 html 或 design-prompting 路线从零创作。所有主题均通过 tokens.json 应用,禁止硬编码颜色和字体。

【构建与校验】在项目 graphics/ 文件夹内按引擎构建,循环执行 lint、check(布局、对比度、透明视频后方文字)、snapshot、预览、草稿渲染、单帧校验、最终渲染。内置脚本 html_to_png.py(精确尺寸渲染、指南分离、alpha 校验)与 snug_frame.py(原生比例照片取景)。每个最终渲染须用 render_verify.py 显式传入 --pixfmt、--expect-dur、--expect-fps、--expect-res 或 --meta 校验,并在棋盘格背景上人工查看抽帧。

【音频处理】需要 whoosh、hit、chime 或底音时,通过 mc-audio 服务技能获取,wav 放入 graphics/ 并在 HANDOFF.md 注明时序。

【Resolve 融合标题】当编辑器为 resolve 且模板非空时,逐节拍判断是否做成可在 Resolve 中编辑的 Fusion 标题:内容须仅为文字、类型为文字卡、运动为切换或简单进出。标题节拍只写入 graphics/titles.json,不再渲染为烘焙文件,文本须通过转写事实核查与拼写规则。

【Resolve 放置】最终渲染完成后,若 cut/resolve-import.json 有效,运行 resolve_place.py 把图形放到剪辑上,脚本会复制时间线、新建轨道、嵌套标题时间线并校验。退出码 1 表示放置或标题校验失败(时间线重命名标注 FAILED VERIFY);2 表示计划错误;3 表示找不到模板;4 表示 Resolve Studio 不可达。合成预览由 ffmpeg 渲染,无法绘制 Fusion 标题,因此标题节拍不会出现在其中。

【交接与推进】编写 HANDOFF.md(每节拍的文件、时间线位置、轨道建议、编辑说明);因 graphics/ 有新渲染,需交由 mc-cut 重新渲染合成预览;随后更新 project.json 并推进阶段。

【规则】节拍表为准,不得静默改时序;导出必须为带 alpha 的 ProRes 4444 且透明根;锚定帧须能说明图形为何在场;涉及数字、日期、引述、姓名等声明性图形须对照转写逐字核查;不得猜测外部引用;成片图片不得含占位或辅助文字;QC 时把单点纠正视为一类缺陷全库审查;不得为放图形而缩小或加黑边源视频,照片用原生比例取景;可复用合成提升到引擎工作区并记入格式档案 Templates。

该技能的适用场景包括视频叠加图形制作、字幕卡与姓名条渲染、Resolve 时间线自动化放置。限制是依赖完整的项目配置、品牌令牌与制作圣经,且渲染开销较高;未提供收费、价格或平台支持等信息。