- name
SKILL.md
스킬 파일은 게시자의 저장소에 그대로 있습니다.
복사한 명령을 터미널에 붙여넣습니다. 이 SKILL.md가 해당 에이전트에 설치됩니다.
npx skills add ZJU-REAL/Easel --skill multi-voice-dubbing -a cursor -y복사한 명령을 터미널에 붙여넣습니다. 이 SKILL.md가 해당 에이전트에 설치됩니다.
npx skills add ZJU-REAL/Easel --skill multi-voice-dubbing -a claude-code -y복사한 명령을 터미널에 붙여넣습니다. 이 SKILL.md가 해당 에이전트에 설치됩니다.
npx skills add ZJU-REAL/Easel --skill multi-voice-dubbing -a codex -y복사한 명령을 터미널에 붙여넣습니다. 이 SKILL.md가 해당 에이전트에 설치됩니다.
npx skills add ZJU-REAL/Easel --skill multi-voice-dubbing -a grok -y복사한 메시지를 Grok Bot 채팅에 보냅니다. Bot이 GitHub에서 이 SKILL.md를 가져와 모든 Bot이 공유하는 스킬에 추가합니다.
Install this skill: https://github.com/ZJU-REAL/Easel/tree/HEAD/skills/builtin/multi-voice-dubbing게시자 제공
把「多人对话 / 多角色脚本」合成为多声线音轨——每个角色一个符合其人设的声音,
不再是「全程一个声音」。核心引擎 skills/shared/scripts/multivoice.py:
逐行调 tts.py(edge-tts 免费多音色)或 voice_clone.py(云端表现力 provider / 克隆音色)合成,
把每行 emotion 喂进 provider 的真情感通道,ffmpeg 拼成一轨 + 生成对齐的说话人字幕。
创意(谁说什么、什么情绪)由你 LLM 产出;音色映射在 cast。确定性 IO(逐行合成/拼接/字幕)走引擎。 产物
voice.mp3可直接当 narration 喂auto-short-video/assemble.py或加进任意视频;voice.srt是带角色名的字幕。
edge-tts 没有情感引擎,只能变速变调,再怎么调也像机器平读。要"像人"必须用有情感通道的云 provider(用户自备 key,无需 GPU):
推荐 SiliconFlow(云端 CosyVoice2、无需 GPU、中文最稳)配置落 .env:
VOICE_PROVIDER=openai-compatible
VOICE_BASE_URL=https://api.siliconflow.cn/v1
VOICE_API_KEY=<你的key>
VOICE_MODEL=FunAudioLLM/CosyVoice2-0.5B
VOICE_INSTRUCT_MODE=inline
cast 里角色:--engine clone --provider openai-compatible --voice-id FunAudioLLM/CosyVoice2-0.5B:alex(8 音色 alex/anna/benjamin/…)。
lines.json 每行的 emotion(愤怒/崩溃大哭/冷笑/温柔…)→ 引擎按 provider 转成对应情感参数。写具体越贴戏越好。engine=clone);配了 key 才有情绪,没 key 自动回退 edge(平)并告警。voice_clone.py 头部(各家 env);voice_clone.py check --provider <名> 离线校验 key 是否齐。短剧对白(short-drama 已内部委派)、论文双人问答讲解(paper-explainer:主讲+提问者)、 访谈/播客脚本、有声剧、任何「多个说话人」的口播。单人整段口播用 tts-voiceover 即可。
先读 skills/shared/references/voice-casting.md(音色→人物原型对照 + 同性别区分 + 旁白独立 + 情绪韵律)。
为每个说话人定一个符合其性别/年龄/气质/身份的音色,旁白/主讲单列且与所有角色不同:
python skills/shared/scripts/multivoice.py cast init --cast <路径>/cast.json
python skills/shared/scripts/multivoice.py cast add --cast <路径>/cast.json \
--name 林策 --role male_lead --voice zh-CN-YunxiNeural --rate=-5% --pitch=-3Hz --note "冷峻男主" # 负值参数用等号
python skills/shared/scripts/multivoice.py cast add --cast <路径>/cast.json \
--name 苏晚 --role female_lead --voice zh-CN-XiaoxiaoNeural --note "温婉女主"
python skills/shared/scripts/multivoice.py cast check --cast <路径>/cast.json # 校验:音色有效/旁白独立/无撞音色
cast.json 也可直接写(就是 JSON)。想让某角色像真人有情绪(治 AI 平读)→ 该角色用云 provider:
python skills/shared/scripts/multivoice.py cast add --cast <路径>/cast.json \ --name 霸总 --role male_lead --engine clone --provider minimax --voice-id <你的音色id> --note "克隆/表现力音色"需在
.env配对应 provider 的 key(voice_clone.py check --provider minimax);缺 key 该角色自动回退 edge(平)并告警。
把脚本 / 对话稿拆成有序逐行:
{"lines":[
{"speaker":"主讲","text":"这篇论文解决了一个关键问题。","emotion":"平"},
{"speaker":"提问","text":"等等,为什么现有方法不行?","emotion":"惊"},
{"speaker":"主讲","text":"因为它们忽略了时序依赖。","emotion":"坚定"}
]}
speaker 必须与 cast 里的名字一致(不一致会回退旁白音色并告警);emotion 可选。
python skills/shared/scripts/multivoice.py dub \
--cast <路径>/cast.json --lines <路径>/lines.json -o <路径>/voice.mp3
产出 voice.mp3(每角色独立声线、情绪自动调韵律)+ voice.srt(带角色名,时序按逐行实测时长对齐)。
dub 会打印用了几种声线——确认 ≥2 种(多人对话不该只有一个声音)。
voice.mp3 作 narration + voice.srt 作字幕,喂 auto-short-video/scripts/assemble.py(图/视频合成)。style.md 融进音色气质选择(角色气质→音色);preferences.md 红线过滤台词。cast check + dub 声线数把关)。engine=clone+provider(有真情感通道),无需 GPU。dub 即可,不必重来。见 EASEL-META.md。多声线配音(cast + 逐行 lines + 按角色音色逐行合成 + ffmpeg 拼接 + 说话人字幕)为 Easel 自研;
底层封装 edge-tts(tts.py)与云端克隆(voice_clone.py)。
>
---name: multi-voice-dubbingdescription: >---# skills/builtin/multi-voice-dubbing/SKILL.mdFAQ
게시자에게서 skills/builtin/multi-voice-dubbing/SKILL.md를 다운로드하거나 경로를 복사해 저장소를 엽니다. PlugMCP는 스킬을 목록에 올릴 뿐 파일을 호스팅하지 않습니다.
게시자가 https://github.com/ZJU-REAL/Easel에서 관리합니다.
Claude, Cursor, Codex, Grok Build는 게시자의 저장소에서 추가한 SKILL.md를 읽을 수 있습니다. Grok Bot은 채팅에서 스킬의 GitHub 폴더 링크를 보내면 설치합니다.