native-subtitle-quote-image

native-subtitle-quote-image 是面向Agent的技能（Skill），核心能力是从视频精准截取画面，生成3:4比例适合社交平台的字幕长图。项目最大特点是严格区分原生字幕和脚本字幕两种模式，绝不混用，避免后期绘制字幕冒充视频原本烧录字幕。

支持本地视频文件，也可直接传入YouTube链接。完整链路包含语句定位、精确帧提取、图片拼接、自动质检，输出JPG成品。既可以在Codex、Claude Code这类智能体中一句话调用，也能独立运行Python脚本。

两种字幕模式对比

不指定模式时，Agent会主动询问用户，解释两种模式差异后再执行。

安装部署流程

1. 部署Skill目录

# Mac / Linux
git clone https://github.com/chengyi-ai/native-subtitle-quote-image.git
cd native-subtitle-quote-image
mkdir -p ~/.codex/skills && cp -R skills/native-subtitle-quote-image ~/.codex/skills/

Windows PowerShell：

New-Item -ItemType Directory -Force "$HOME\.codex\skills" | Out-Null
Copy-Item -Recurse skills\native-subtitle-quote-image "$HOME\.codex\skills\"

Claude Code 用户：替换路径为 ~/.claude/skills。升级前需要删除旧目录，防止残留旧文件。

2. 安装依赖与环境自检

python3 -m pip install -r skills/native-subtitle-quote-image/requirements.txt
python3 skills/native-subtitle-quote-image/scripts/check_environment.py

如需解析YouTube链接，额外安装yt-dlp并执行带url模式的环境检测；脚本字幕渲染中日韩文字，可通过自检命令校验字体。
环境自检仅做检查，不会自动修改系统，缺少组件时Agent会先说明用途，征得用户同意再安装。

3. Agent调用示例

• 本地烧录字幕视频：使用 $native-subtitle-quote-image，把这个带内嵌中文字幕的视频做成原生字幕拼图。
• YouTube链接：使用 $native-subtitle-quote-image，读取这个YouTube链接，先检查下载权限和烧录字幕，再选3个适合传播的主题，做成原生字幕拼图并逐张质检。
• 脚本字幕模式：使用 $native-subtitle-quote-image 的脚本字幕模式，把这份带时间点的中文台词画到真实视频帧上，做成紧凑3:4长图并逐张质检。

Codex 使用 $native-subtitle-quote-image；Claude Code 使用 /native-subtitle-quote-image，也可直接自然语言描述需求。

输出产物

• 多张成品JPG（3:4社交长图）
• 配套JSON文件：原生字幕输出时间点记录；脚本字幕保留台词lines信息
• 批量任务额外输出 final_contact_sheet.jpg 总览图