SuperAPI AI 工具集

edgespeak-karaoke

设计与创作

查看项目

更新于 10-15 23:49

技能介绍

用途:从一次 EdgeSpeak 转录请求生成逐词高亮的卡拉OK ASS 字幕,可选双语(第二行为翻译),并用 FFmpeg 把字幕硬烧录进本地视频。附带零依赖 Node.js 脚本,用于确定性的 ASS 生成、真实帧样式预览和 FFmpeg 渲染。

主要能力:提供 classic、minimal、boxed、high-contrast 四种预设,可用 --font、--font-size、--margin-v、--primary、--secondary、--outline、--back 微调(ASS 颜色用 &HAABBGGRR)。支持 --preview-media 在真实源帧上渲染全部预设 PNG 供用户选择;双语时每段生成两行,用 \N 分隔,--layout translation-top(默认)/source-top/source-only 控制布局,仅源语言行做扫词高亮。脚本按文字脚本自动选择合适字体,避免 CJK 显示为方框。

使用方式:先确认源文件并用 ffprobe 检查时长、尺寸、容器;调用 edgespeak_transcribe_file 一次,timestamps 设为 word,start_margin 与 end_margin 为 0。生成 ASS:node <skill-dir>/scripts/karaoke-ass.mjs /path/to/transcript.json -o /output/source.karaoke.ass --style classic --title "Source title"。硬烧录:node <skill-dir>/scripts/render-hardsub.mjs /path/to/source-video /output/source.karaoke.ass。MCP 不可用时回退 CLI:edgespeak-cli transcribe /path/to/source-media -o /output/transcript.json --start-margin 0 --end-margin 0。

适用场景:本地视频的卡拉OK字幕制作、双语字幕、硬字幕交付。

限制:需 Node.js 18+、带 libass 的 FFmpeg 与 ffprobe,烧录 MP4/MOV/MKV/TS 需 libx264,WebM 需 libvpx 与 libopus;转录需 edgespeak-cli 或 EdgeSpeak 应用(macOS Apple Silicon、Linux x86_64、Windows x64)。硬字幕必须重编码视频。部分翻译的转录会被拒绝。字体覆盖无法检查时会报告 source_font_verified: false。其他细节暂未提供。