Communitygithub.com

OscarCode9/style-video-captions-skill

Codex 技能:转录并生成具有精美设计风格的字幕视频。

style-video-captions-skill 是什么?

该技能为开发者提供了一种自动化的视频字幕处理流程,能够将原始视频与字幕(SRT 或 VTT)结合,生成一个带有专业排版风格的全新视频文件。它集成了基于 faster-whisper tiny 的语音转录功能,仅在缺少时间轴字幕时自动调用,保证了效率。最终输出包括经过样式渲染的 ASS 字幕文件、合成的 MP4 视频以及预览图,适用于需要高质量、一致性视觉风格的字幕制作场景,如社交媒体短片、技术演示或教育培训内容。技能支持 Windows PowerShell 环境,并依赖于包含 subtitles/libass 过滤器的完整 ffmpeg 构建。

兼容平台~Claude Code✓Codex CLI~Cursor
npx skills add OscarCode9/style-video-captions-skill

在你喜欢的 AI 中提问

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

文档

样式视频字幕

创建一个新字幕视频,同时保留源文件。优先使用现有的 .srt 文件;仅在无时间轴转录文件时,才使用 faster-whisper tiny 进行转录。

默认设计方向

使用捆绑的 Archivo 可变字体,搭配以下编辑-技术风格系统:

  • 白色主文本:#FFFFFF
  • 电蓝色关键词:#2F80FF
  • 蓝色关键词使用轻量级 Barlow Condensed 斜体,字号大约增大 16%
  • 墨蓝色半透明盒子/轮廓:#071A33
  • 最多两行,使用短词组
  • 底部居中放置,位于移动端 UI 安全区上方
  • 短入场弹入和淡出效果,避免持续弹跳或逐字混乱

更改视觉方向时,请阅读 references/design-guidelines.md。

工作流程

  1. 检查视频尺寸和时长。
  2. 寻找匹配的 .srt 或 .vtt 文件。如果找不到,使用 scripts/transcribe_tiny.py 生成 SRT。
  3. 使用 scripts/make_styled_ass.py 生成样式化 ASS 字幕。
  4. 使用包含 subtitles/libass 过滤器的完整 ffmpeg 构建进行渲染;CapCut 捆绑的 ffmpeg 可能不包含这些过滤器。
  5. 验证最终时长、视频流、音频流以及从捕获帧中的可读性。
  6. 保留输入视频和转录文件。

标准命令

powershell -NoProfile -ExecutionPolicy Bypass -File "<skill-dir>\scripts\style-video-captions.ps1" `
  -InputVideo "C:\path\video.mp4"

使用现有 SRT:

powershell -NoProfile -ExecutionPolicy Bypass -File "<skill-dir>\scripts\style-video-captions.ps1" `
  -InputVideo "C:\path\video.mp4" `
  -SubtitleFile "C:\path\captions.srt"

输出文件:

  • <video>_subtitulos_estilo.ass
  • <video>_subtitulos_estilo.mp4
  • <video>_subtitulos_preview.jpg

设计判断

蓝色仅用作强调色,而非唯一的文字颜色。在变化的画面中,白色仍然更可靠。保持深色轮廓/盒子对比度,因为字幕位于亮度不可预测的图像之上。

不要高亮填充词。优先选择名词、动词、数字和较长的有意义的术语。动画效果应服务于阅读体验,而非喧宾夺主。

相关技能