SuperAPI AI 工具集

create-storyboard-html

前端与建站

查看项目

更新于 10-15 21:54

技能介绍

用途:为视频项目生成唯一的审阅页面 <video_folder>/storyboard.html,操作者打开一次即可看到各阶段(创意简报→歌词/脚本→关键帧→动画→成片)的最新状态。它用“片段+渲染”契约替代手工编写 HTML:每个状态在 <video_folder>/_state/NN-<slug>.json 写入 JSON 片段,再由脚本汇总渲染。

主要能力:支持多种片段类型——html(可信原始 HTML 块)、lyrics(歌词行,可标注重音词)、scenes(场景网格,含 id、歌词、关键帧、动画、提示词、备注、时间码,mp4 缺失时自动回退到关键帧)、metrics(键值表)、video(内嵌 9:16 视频)、audio(内嵌音频)、image(内嵌图片)。缺失资源会渲染为橙色占位符。页面顶部有各状态章节的目录,按片段文件名前缀排序,无需服务器即可在浏览器打开。

使用方式:状态 N 产出素材后,写入或重写对应 JSON 片段,然后运行: python3 skills/atoms/planning/create-storyboard-html/scripts/render_storyboard.py
--video-folder <video_folder>
[--title "Brand · Format"]
[--accent-color "#0052FF"]

适用场景:新建广告时写 State 0 片段并渲染外壳;每次状态推进后追加片段并重新渲染;审阅时打开 storyboard.html。该技能被 music-video-ad、create-cartoon-music-video 等分子作为后置步骤调用,也有独立的 video-orchestrator/create-storyboard 入口。

限制:片段文件名前缀需与编排器状态编号一致,否则排序错乱;资源路径相对 <video_folder>,未做沙箱限制;不要手工编辑 storyboard.html,否则下次渲染会被覆盖,一次性插入应使用 kind:"html" 片段;JSON 格式错误会被跳过并警告。仅适用于音乐视频、卡通音乐视频、连环画及多数旁白驱动广告,一次性项目或片段类型不覆盖时可用旧的手工编写方式。