- name
SKILL.md
技能檔案保留在發布者的儲存庫中。
在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add ZJU-REAL/Easel --skill auto-subtitle -a cursor -y在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add ZJU-REAL/Easel --skill auto-subtitle -a claude-code -y在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add ZJU-REAL/Easel --skill auto-subtitle -a codex -y在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add ZJU-REAL/Easel --skill auto-subtitle -a grok -y在 Grok Bot 聊天中傳送複製的訊息。Bot 會從 GitHub 取得這個 SKILL.md,並加入你所有 Bot 共用的技能中。
Install this skill: https://github.com/ZJU-REAL/Easel/tree/HEAD/skills/builtin/auto-subtitle來自發布者
把音频/视频里的人声识别成字幕。基于共享脚本 skills/shared/scripts/asr.py(faster-whisper 封装),
参数确定、可复现,做中文友好断句。可选把字幕烧录进视频(复用 skills/shared/scripts/video_ops.py / ffmpeg subtitles 滤镜)。
只做"语音 → 字幕文件 (+ 可选烧录)"。通用视频剪辑见 video-editing;纯降噪见 audio-denoise;长视频智能切片+烧字幕见 clipify。
支持:mp3/wav/m4a/aac/flac 等音频;mp4/mkv/mov/webm 等视频。
outputs/主题名/(SRT/ASS/TXT/JSON)*-sub.mp4)EASEL_PROXY 或 http(s)_proxy 环境变量作代理;
都未设则直连。也可先 export https_proxy=... http_proxy=... 指定。--device cpu --compute-type int8 即可。脚本路径(相对项目根):skills/shared/scripts/asr.py、skills/shared/scripts/video_ops.py。
# 视频 → SRT(自动提取音轨 + 自动检测语言)
python skills/shared/scripts/asr.py transcribe \
-i input.mp4 -o outputs/主题名/input.srt --language zh
# 视频 → ASS(带样式,**字号/边距按视频横竖屏自适应**):视频输入自动探测宽高
python skills/shared/scripts/asr.py transcribe \
-i input.mp4 -o outputs/主题名/input.ass --format ass --model small
# 纯音频 → ASS:无法探测尺寸,默认竖屏 1080x1920;横屏加 --res 1920x1080
python skills/shared/scripts/asr.py transcribe \
-i voice.mp3 -o outputs/主题名/voice.ass --format ass --res 1920x1080
PlayRes=真实宽高。视频输入自动探测;纯音频用 --res 宽x高 指定。
要带样式的硬字幕优先烧这份 ASS(下节),比裸 SRT + 手填 force_style 更省心、且自适应。--max-line-chars 可调。-o 时按输入文件名建项目目录,例如 talk.mp4 输出到 outputs/talk/talk.srt;已有项目应显式 -o outputs/主题名/<文件名>.<format>。python skills/shared/scripts/asr.py info。用户要"硬字幕/烧进视频"时,用 ffmpeg 的 subtitles(SRT)或 ass(ASS)滤镜:
# 烧 SRT(可定制样式)
ffmpeg -y -i input.mp4 \
-vf "subtitles=outputs/主题名/input.srt:force_style='FontName=Noto Sans CJK SC,FontSize=20,PrimaryColour=&H00FFFFFF,OutlineColour=&H80000000,BorderStyle=1,Outline=2'" \
-c:a copy outputs/主题名/input-sub.mp4
# 烧 ASS(样式已在 ass 文件里,保真)
ffmpeg -y -i input.mp4 \
-vf "ass=outputs/主题名/input.ass" \
-c:a copy outputs/主题名/input-sub.mp4
subtitles= 的值用单引号包裹并转义冒号。ffmpeg -i in.mp4 -i sub.srt -c copy -c:s mov_text out.mp4。outputs/主题名/。--model/--max-line-chars 重跑。outputs/。base,求准用 small/medium;CPU 用 int8。subtitles / ass 滤镜(字幕烧录)自动字幕 / 语音转字幕:把音频或视频里的语音识别成字幕文件(SRT/ASS/TXT/JSON),可选把字幕烧录进视频。当用户说自动字幕、语音转字幕、视频加字幕、上字幕、转录、听写、字幕文件、生成字幕、烧字幕时使用。
---name: auto-subtitledescription: 自动字幕 / 语音转字幕:把音频或视频里的语音识别成字幕文件(SRT/ASS/TXT/JSON),可选把字幕烧录进视频。当用户说自动字幕、语音转字幕、视频加字幕、上字幕、转录、听写、字幕文件、生成字幕、烧字幕时使用。---# skills/builtin/auto-subtitle/SKILL.md常見問題
從發布者下載 skills/builtin/auto-subtitle/SKILL.md,或複製路徑後開啟儲存庫。PlugMCP 只收錄這項技能,不代管檔案。
發布者將它存放在 https://github.com/ZJU-REAL/Easel。
Claude、Cursor、Codex 和 Grok Build 可以讀取你從發布者儲存庫加入的 SKILL.md。在聊天中傳送技能的 GitHub 資料夾連結,Grok Bot 就會安裝它。