用途:在已完成语义理解的视频项目中,把经审阅的语义时刻转成统一的 HyperFrames 图形叠加卡片。不重新转写或分析素材,只使用共享证据与规范时间线。
依赖与限制:/video-understand 为前置技能,须先运行并确认已安装,否则警告并停止。需要 PATH 中有 ffmpeg、Python、Node.js >= 22(npx hyperframes 按需获取);hyperframes 渲染/截图使用无头 Chrome,自管 chrome-headless-shell,缓存不可用时回退系统 Chrome(可用 CHROME 覆盖)。无剪辑或调色时技能仍有效;有字幕时先运行字幕并以其占位区为硬排除区;内容卡片须先于动态图形。所有人脸与头部轮廓为硬排除区,不可覆盖演讲者与字幕,无合规位置时跳过该卡片。
主要能力与用法:先用 build_cards_plan.py 从 understanding.json、timeline.json 生成计划,支持 --target-card-count、--theme(almanac、teal、editorial、dotgrid、apex、air)、--must-include-type、--notes。五种规范卡片类型映射:hook→intro、key-point/quote/question→key-quote、stat→stat、list→list、cta→outro;布局含默认、metric-spotlight、bar-chart、pie-chart、line-chart、side-by-side、parallel-columns。图表仅在转录提供完整证据数据时使用,须手写维度、指标、单位、周期、有序点及证据。用 build_review_page.py 生成浏览器审查页,人工选择后用 apply_cards_review.py 应用。最后编写单个 index.html 与暂停的 GSAP 时间线,每张卡片一个 .clip,按 program_start_s 与 duration_s 定位;用 npx.cmd hyperframes check 校验,显式传入源 FPS(保留 24000/1001 等分数帧率),不依赖远程字体、图片、脚本。计划须保留样式与运动参数并可复现。
适用场景:成片视频的标题、下三分之一、数据强调、列表对比、引用与章节卡片制作。限制:不重新分析素材;无剪辑、字幕、调色时按相对规则处理;事实性细节(如价格、平台)暂未提供。