Communitygithub.com

视频生成器

根据脚本录制清晰、免费的葡萄牙语旁白视频。支持动画模式(1080×1920 Reels/TikTok/Shorts,含角色、逐字字幕、持续移动镜头、配乐和特效、封面及质量控制)和教程模式(录制真实网页,带光标、缩放和高亮,2560×1440)。当用户要求制作、录制、剪辑、调整或审阅视频、Reels、封面,或将脚本转化为视频时使用。

视频生成器 是什么?

该技能是一个功能完备的视频生成工具,专注于创建葡萄牙语旁白动画视频和教程视频。它接受一个脚本(通常由配合的“剧本作者”技能提供),通过一个结构化的流水线生成最终视频,包括脚本解析、场景动画、语音合成(通过 Edge TTS 或 ElevenLabs)、音乐叠加以及自动质量检查。动画模式专为短视频平台优化(1080×1920),支持角色、逐字同步字幕、持续移动镜头、过渡效果和自动封面生成。教程模式则通过程序化截取网页屏幕截图,并模拟光标移动、缩放和高亮操作,生成高质量的讲解视频(2560×1440)。该技能在特定开发环境中运行(使用 Python 脚本和 FFmpeg),并遵循严格的安全和内容指南,如避免在语音文本中包含 PII、管理 API 密钥以及遵守媒体许可。它要求用户在最终输出前进行审核,尤其强调音频审听。

兼容平台~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/scamposgabriel/gerador-de-videos/tree/HEAD/.claude/skills/gerador-de-video

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

视频生成器 是做什么的?

请用葡萄牙语回复。屏幕文字和旁白避免使用行话。在制作新视频之前,请阅读 docs/04_VIDEO_ANIMADO.md(动画模式)或 docs/01 和 docs/02(教程模式),以及 docs/03_QUALIDADE_E_CHECKLIST.md。

动画视频工作流(最常用)

  1. 脚本已批准。 如果没有脚本,请使用 roteirista 技能,并在录制前向用户展示脚本 + 故事板。
  2. 复制模板:将 videos/exemplo-bolinha-vermelha 复制到 videos/<视频短名称>(新文件夹;切勿修改示例)。
  3. roteiro.py:替换 FALAS(一段话 = 一个场景,cena="名称")、MARCA(频道名称、头像),以及可选的 PERSONAGEM(包含 PNG 姿势的文件夹)。调整 saida 和 saida_so_voz。
  4. 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。
  5. 在完全录制前进行检查:运行 py motor/animar.py videos/<文件夹> --fotos 0,3,8,15(以实际分辨率生成 PNG 到 saida/fotos),并制作一张检查表逐场景查看。用声音测试:运行 --ate 12。
  6. 录制:运行 py motor/animar.py videos/<文件夹>。将生成带音乐的 MP4、仅语音版本以及 saida/controle_de_qualidade.json(自动质量检查:分辨率、FPS、静止画面 > 1 秒、重复帧、黑屏、音量 -14 LUFS、峰值)。
  7. 封面:运行 py ferramentas/capa.py videos/<文件夹> → 生成 saida/Capa.png。
  8. 文字:运行 py ferramentas/verificar_textos.py videos/<文件夹>(检查文字被裁剪、超出屏幕或位于 Instagram 按钮下方)。
  9. 交付文件路径,并告知用户需要聆听确认的内容(你无法听到音频)。切勿自行发布。
  10. 预发布(可选,在 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 额度。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相关技能