视频生成器 是做什么的?
请用葡萄牙语回复。屏幕文字和旁白避免使用行话。在制作新视频之前,请阅读 docs/04_VIDEO_ANIMADO.md(动画模式)或 docs/01 和 docs/02(教程模式),以及 docs/03_QUALIDADE_E_CHECKLIST.md。
动画视频工作流(最常用)
- 脚本已批准。 如果没有脚本,请使用
roteirista技能,并在录制前向用户展示脚本 + 故事板。 - 复制模板:将
videos/exemplo-bolinha-vermelha复制到videos/<视频短名称>(新文件夹;切勿修改示例)。 - roteiro.py:替换
FALAS(一段话 = 一个场景,cena="名称")、MARCA(频道名称、头像),以及可选的PERSONAGEM(包含 PNG 姿势的文件夹)。调整saida和saida_so_voz。 - pagina.html:为每个场景创建一个在
MONTA中注册的函数cNome(r, c)。复用模板中的组件:quando(cena, "palavra")(语音说出该词的时刻)、entra()(同步入场)、sai()、anim()、personagem()(在正确词语时切换姿势;通过.extra对象持有物品)、bola()/bolaDiv()、jardim()、cachorro()、som()、结束卡片(montarFim)和封面(montarCapa,在render(t < 0)中绘制)。颜色使用--fundo、--tinta、--destaque。 - 在完全录制前进行检查:运行
py motor/animar.py videos/<文件夹> --fotos 0,3,8,15(以实际分辨率生成 PNG 到saida/fotos),并制作一张检查表逐场景查看。用声音测试:运行--ate 12。 - 录制:运行
py motor/animar.py videos/<文件夹>。将生成带音乐的 MP4、仅语音版本以及saida/controle_de_qualidade.json(自动质量检查:分辨率、FPS、静止画面 > 1 秒、重复帧、黑屏、音量 -14 LUFS、峰值)。 - 封面:运行
py ferramentas/capa.py videos/<文件夹>→ 生成saida/Capa.png。 - 文字:运行
py ferramentas/verificar_textos.py videos/<文件夹>(检查文字被裁剪、超出屏幕或位于 Instagram 按钮下方)。 - 交付文件路径,并告知用户需要聆听确认的内容(你无法听到音频)。切勿自行发布。
- 预发布(可选,在 QA 通过后):按维度进行编辑质量检查(运行
py creative-intelligence/ci.py avaliacao modelo ...)、版本间钩子对比(ci comparar)和预测性评估(Higgsfield),但需经成本批准和素材所有者授权(ci prever ... --modelo-autorizacao)。参见engenharia-reversa技能第 5 节。这不是录制或教程模式的必要步骤;引擎不依赖于此。
帧缩略图(每 2 秒一张):运行 ffmpeg -i saida/<视频>.mp4 -vf "fps=1/2,scale=240:427,tile=9x3" -frames:v 1 folha.png。
教程模式(真实网页)
将 modelos/roteiro_modelo.py 复制到 videos/<文件夹>/roteiro.py;操作说明参见 docs/02_ACOES_DO_ROTEIRO.md。先测试 py motor/gravar.py videos/<文件夹> --so 02-04;然后录制完整视频。
曾付出昂贵代价的规则(不得再犯)
render(t)只依赖于t(不保留前一帧的任何数据);渐变停顿必须始终保持有序。- 切勿冻结画面:镜头必须持续运动(缓慢推进 + 漂移);片段结束时从后往前回放;结束卡片要有动画。
- 第一帧就要有动作:第一秒必须展示悬念(不要出现空场景等待)。
- Reels(1080 × 1920):标题位于 150 到 440 px 之间;字幕大约在 1330 px 处,每个区块最多约 16 个字符(宽度限制 860 px);在 1600 px 以下以及右半部分(x > 960)在 1100 到 1750 px 之间不得放置重要内容——这些区域属于 Instagram 按钮和描述。
- 演示对象必须大:拉近镜头;前景的草地/元素只出现在对象底部。
- "之前 × 之后"对比:两帧必须保持相同的取景;两者之间应有可见的过渡(例如扫描效果)。
- 竖屏模式下,中间不得出现水平条带;横屏片段进入竖屏模式时需裁剪(最大放大倍数约 1.2×)。
- 角色 PNG:确保背景真正透明(5% 的颜色会在视频中形成矩形块)。
- 有意识地变焦可以将文字移出屏幕最多 < 0.5 秒;除此之外,文字检查器必须报告干净。
- 不要使用浏览器的屏幕录制或 Playwright 的视频流(会模糊);引擎逐帧拍摄画面。
roteiro.py中的 Windows 路径始终使用r"..."原始字符串。- 语音:句子要简短;
vozes.py会逐句生成,并在句间加入呼吸停顿(voz["respiro"])。自然语速为 2.4 到 3.2 词/秒(引擎会显示时长;词数 ÷ 秒数)。 - 图库素材:仅使用允许使用的许可证(Mixkit "Free" 许可;"Restricted" 禁止用于广告);在
midia/CREDITOS.md中记录。
安全
- 语音文本会发送到外部服务(Edge TTS 或 ElevenLabs):切勿在口语文本中包含姓名、CPF 或客户数据。
- 密钥仅存放在
~/.secrets/中(ElevenLabs:~/.secrets/elevenlabs/.env);切勿打印,切勿复制到仓库中。 - 模拟或虚构角色:必须在屏幕上标注("近似模拟"、"虚构角色")。
- 未经用户批准,不得消耗付费 API 额度。