UTAU Classic 声库兼容｜oto.ini / prefix.map / append 自动识别

OpenUtau 对 Classic 声库的支持程度

OpenUtau 尽量完全兼容标准 UTAU Classic 声库格式：

和 UTAU 原版的扫描行为差异

UTAU 原版的 Singers 文件夹结构非常死板——所有声库必须直接放在 Singers/ 下，不能建子文件夹分类。OpenUtau 递归扫描解决了这个问题：

OpenUtau/Singers/
├── 日文声库/
│   ├── VCV/
│   │   └── 重音テト SV/     ✅ 能识别
│   └── CVVC/
│       └── XX声库/          ✅ 能识别
├── 英文声库/
│   └── VCCV/
│       └── XX声库/          ✅ 能识别
└── DiffSinger/
    └── XX模型/              ✅ 能识别

用 Additional Singer Path 指向这样一个分类好的大目录，OpenUtau 一次性全扫。

prefix.map 兼容性

UTAU 原版的 prefix.map 是一个文本文件，定义了歌词后缀（[n、[h、[g 等）对应哪个音频子目录（normal / soft / growl）。

OpenUtau 通过两种方式处理：

1. 自动读取 character.yaml 的 voice_colors 定义（推荐）
2. 自动兼容 prefix.map（如果声库没有 character.yaml）

如果声库同时有 prefix.map 和 character.yaml，OpenUtau 优先用 character.yaml（yaml 更现代、信息更丰富）。

声库目录结构要求

OpenUtau 对 Classic 声库目录结构几乎没要求——只要文件夹里有 character.txt 或 character.yaml，并且 oto.ini 里列出的音频文件在声库目录下（任意深度）就能识别。

这比 UTAU 原版宽松太多——UTAU 原版有严格的"音频文件必须在声库根目录"要求。

声库 append 处理

UTAU 原版通过歌词后缀切换 append（声库颜色）：

• 写 あ[n → normal 版
• 写 あ[h → soft 版
• 写 あ[g → growl 版

OpenUtau 通过 CLR 表达式（曲线或固定值）自动切换——不需要手动给歌词加后缀。CLR 表达式里下拉选声库定义好的颜色（normal / soft / growl 等），OpenUtau 自动处理 alias 后缀。

这是 OpenUtau 比 UTAU 原版方便的一处——UTAU 需要手动给每个歌词加 [n [h 后缀，OpenUtau 直接 CLR 参数切换。

已知不兼容的声库类型

OpenUtau 对极少数非常特殊的 Classic 声库格式可能不兼容：

遇到不兼容声库的处理：

1. 用 DEFAULT 音素器 手动输入 alias → 绕过音素器自动展开
2. 用 Classic 引擎 + 老重采样器 → 尽量接近 UTAU 原版行为
3. 手动编辑 oto.ini 修正 alias → 让它符合标准格式

Classic vs DiffSinger vs ENUNU 声库生态位置