SuperAPI AI 工具集

mc-stream-pack

设计与创作

查看项目

更新于 10-29 21:17

技能介绍

mc-stream-pack 是 bmad-manticore 项目下的一项技能,用于为 OBS 构建品牌化直播素材包(livestream asset pack)。其核心工作流是“品牌 tokens 输入,完整素材包输出”:以 livestream-pack 格式配置为规范,执行生成流程,最终产出一个 graphics/ 文件夹,创作者可直接加载到 OBS 中开播,无需额外协助。验收标准是每个素材都经过验证,并附有 HANDOFF.md 说明每个素材的放置位置。

【用途】 该技能适用于 livestream-pack 格式任务,或当用户提到“stream assets”、“OBS pack”、“scenes and stinger”时使用。目标是为直播场景、下三分之一字幕条、话题卡、转场动画等提供品牌化视觉素材,并配套音频。

【主要能力】

  • 读取品牌配置:从 {brand-path}/tokens.json 读取品牌设计令牌,从 {brand-path}/production-bible.md 读取生产规范(包括覆盖层和弹窗美学、按系列模板部分、CTA 部分)。缺少任一文件则停止并引导至 mc-setup。
  • 构建素材包:根据格式配置中的场景列表、响应性、渲染格式和时长生成场景、下三分之一字幕条和话题卡,均为 graphics/scenes/ 下的自包含本地 HTML,完全由 tokens.json 样式化。转场动画为一个 HyperFrames 合成,位于 {engines-path}/hyperframes/,渲染为配置指定的两种格式。
  • 透明通道交付:对于 OBS 浏览器源或转场使用的烘焙 Alpha 交付物,通过 render_verify.py 一步生成并验证 WebM VP9 Alpha 变体,命令示例:uv run {skill-root}/scripts/render_verify.py graphics/<asset>.mov --transcode-webm graphics/<asset>.webm,默认检查 yuva420p,可附加 --expect-res/--expect-fps/--expect-dur。
  • 平台适配:当 [live] 工具为 vmix 或其他时,跳过 WebM:vMix 拒绝 MP4 转场,偏好 PNG 序列,因此交付 PNG 序列(ffmpeg -i <master>.mov -pix_fmt rgba graphics/<asset>-png/%04d.png)或 ProRes 4444 MOV;Wirecast 直接接受 ProRes 4444 MOV。
  • 音频:转场 whoosh 音效、Starting Soon 音乐床等通过 mc-audio 服务技能路由,交付 wav 文件并与场景一起提供,在 HANDOFF.md 中注明 OBS 接线。

【使用方式】 激活时加载 studio 配置(uv run {project-root}/_bmad/scripts/resolve_config.py --project-root {project-root} --key modules.manticore),若为空则停止并引导至 mc-setup。然后读取 project.json(阶段 stream-pack)和 livestream-pack 格式配置,读取品牌 tokens 和生产规范。路径解析规则:裸路径基于 {video-path}(当前视频项目位于 {projects-path}/<slug>/);{skill-root} 为本技能安装目录;{project-root} 为项目工作目录。构建完成后,运行格式配置中的验证部分:场景截图保存至 graphics/_verify/;转场渲染通过 render_verify.py 检查,WebM 变体需 --pixfmt yuva420p 或已通过 --transcode-webm 验证。最后编写 graphics/HANDOFF.md,包含每个素材的 OBS 设置步骤(浏览器源 URL 和尺寸、转场设置),更新 project.json 产物并按阶段列表推进(stream-pack 之后通常为 final),由创作者在 OBS 中加载并现场确认外观。

【适用场景】 适用于需要为 OBS 直播快速生成品牌化视觉素材包的场景,特别是创作者希望获得可直接使用的场景、字幕条、话题卡、转场动画和音频,并附带清晰配置说明的情况。也适用于使用 vMix 或 Wirecast 等其他直播工具时需要特定格式适配的情况。

【限制】 需要品牌 tokens.json 和生产规范 production-bible.md 存在,否则无法进行样式化并会停止。需要 mc-setup 已运行。验证清单要求每个场景截图都经过视觉检查,倒计时在场景重新激活时确实重置(通过 obsstudio 事件测试,或记录为 OBS 专有行为)。具体收费、价格、平台支持范围等暂未提供。