用途
mc-beats 扮演“创作者的图形规划师”角色，产出经审批的节拍表：beats/beats.md 与 beats/STORYBOARD.md。该表是脚本与图形引擎之间的中立契约，在创作者于 gate 3 批准之前，不会存在任何图形代码。
主要能力
- 推导时间而非估算：每个节拍的起始时间都通过锚点词在 transcript/words.json 中的原始时间戳，经 cut/edl.json 重映射到干净剪辑时间线得到。目测时间在表中看似正确，实际渲染时会偏离对应语句，而问题往往在图形工作已经完成后才被发现。
- 按内容升级视觉处理：数字采用统计式呈现，流程采用分阶段图示，对比采用分屏或表格构建；在满足下限前先提出 Production Bible 允许的最具野心的构图。
- 密度与多样性控制：依据 Production Bible 的视觉密度与多样性部分，控制类型多样性、静态文字卡片上限，以及当前层级对应的每分钟节拍数下限（编辑后时长分钟数乘以该下限即为最少节拍数）；前 30–60 秒按节奏曲线约提高一倍密度。
- CTA 规划：读取工作室配置中的 [cta] 清单与偏好，扫描转写中的口播 CTA 与收尾接缝，按分区、数量上限与间距规则规划 CTA 节拍；最后 20 秒不得有叠加节拍，除非其本身就是片尾卡。
- 资产与引擎对齐：引擎由格式档案默认值与 PIPELINE.md 的引擎策略决定；需要采集资产的行走 mc-assets 清单，其余行 asset 为 null。
- 锚点校验：运行 verify_anchors.py 独立重新推导每个节拍时间，凡偏离锚点词超过 0.5 秒、锚点不在转写中、或锚点落在剪辑删除区间内，均判定失败并以非零退出硬性停止。
- Resolve 标记：当编辑器为 resolve 且存在 cut/resolve-import.json 时，可将通过的节拍表作为标记放到创作者的 Resolve 剪辑时间线上：每个节拍一个标记，起始位置对齐、时长等于 dur、命名为“<id> <type>”，备注含构图与口播语句；cta 类型为黄色，其余类型按名称取稳定颜色；同帧节拍合并，与其他标记冲突的节拍最多后移 5 帧，并在报告中说明合并或位移情况。
使用方式
- 激活时加载工作室配置，空值表示 mc-setup 未运行，应停止并引导创作者前往。
- 读取 project.json（确认 approvals.cutplan 为日期且 stage 为 beats）、script.md、cut/edl.json、transcript/、cut/editorial-review.md 与格式档案。
- 读取 production-bible.md 与 tokens.json，缺失则说明影响并引导至 mc-setup 后停止。
- 从格式档案的 frontmatter 确定节拍类型词表与密度预算。
- 先提出最强想法并询问创作者已有构想；editorial-review.md 中的“转节拍”事项属于已定工作，应优先处理。
- 沿编辑后时间线逐条添加节拍行，表中列包括：id、start、dur、end、锚点词、锚点时间戳、口播语句、type、engine、asset、composition；composition 优先在 HyperFrames 注册表中检索并命名区块。
- 写入 beats.md 与 STORYBOARD.md（每个节拍一段短文，描述观众所见、运动特性与锚点语句，并记录超出密度预算的区段、未成行的具体诉求、缺失的 CTA 等表格无对应列的说明）。
- 运行 verify_anchors.py 校验，未通过则修正对应行并重跑，不得将未通过的表呈现给创作者，也不得据此渲染图形。
- 呈现前自查：非分层构图不得有重叠节拍；整套方案视觉系统统一；资产行符合图像类型政策；禁止生成 b-roll 的格式不得出现生成资产行。
- 更新 project.json 产物，设 approvals.beats 为 pending，呈现表格并停止；仅在创作者明确批准后记录 ISO 日期、将 beats 追加至 stages_done，并将 stage 置为下一阶段。
适用场景
适用于视频项目在 gate 2 通过后的节拍规划阶段，或当创作者提出“规划图形”“节拍表”等需求时。
限制
- 必须已有 gate 2 通过的 editorial-review.md，否则交回 mc-cut。
- 缺少 production-bible.md 或 tokens.json 时无法完成主题化与密度控制，需先运行 mc-setup。
- 未通过锚点校验的表不得呈现或用于渲染。
- 资料未提供具体收费、价格、平台支持范围或效果承诺等信息。