# xichu-ai-narrator 全部命令（西楚极客 E025）

工具固定版本 d30a4df：https://github.com/xichugeek/xichu-ai-narrator/tree/d30a4dfaefd86c1458e7eca1815d0126c7a2764d
官网下载与说明：https://xichugeek.com/?name=episode-025-ai-narrator

## 1. 安装（在上期装好 Qwen3-TTS 的 Python 环境里，进入工具目录）

pip install -r requirements.txt

想双击运行：把那个环境 python.exe 的完整路径写进工具目录的 python_path.txt，之后双击 install.bat / run.bat。

## 2. 配置 config.json（只改这几项）

{
  "ref_audio": "my_voice.wav",
  "ref_text_file": "my_voice.txt",
  "model_dir": "（Qwen3-TTS-12Hz-0.6B-Base 模型文件夹）",
  "draft_folder": "（剪映 → 全局设置 → 草稿位置，反斜杠改成 /）",
  "device": "cuda:0"
}

- ref_audio：你自己的参考录音（十几秒、安静、无背景音乐）
- ref_text_file：参考录音的逐字稿，必须一字不差
- model_dir：Qwen3-TTS-12Hz-0.6B-Base 模型文件夹
- draft_folder：剪映专业版 → 全局设置 → 草稿位置，复制过来，反斜杠改成 /
- device：有 N 卡写 cuda:0，没有写 cpu（很慢）

## 3. 写文稿 script.txt（一行一句，图片和 script.txt 放同一个文件夹）

# 井号开头是注释，空行会被忽略
[01.png] 第一句解说词，从这一句开始显示 01.png
第二句，没写图片名就沿用上一张
[02.png] 2026 年｜二零二六年

- 行首 [图片名]：从这一句开始换图；没写就沿用上一张
- 字幕｜读法：竖线左边是字幕显示的文字，右边是让它怎么读

## 4. 运行（先关掉剪映）

python narrate.py examples\demo

或双击 run.bat；把自己的项目文件夹拖到 run.bat 上可以跑自己的文稿。
输出：项目 output\ 里的 narration.wav、subtitles.srt，以及剪映草稿文件夹里的新草稿（项目名 + 时间）。
改了某一句再运行，只重新生成改过的那句。

## 5. 自检测试（可选，不调用模型）

python -m unittest discover -s tests