红心收藏与 character.yaml｜声库元信息的真相源

红心收藏

轨道头的 Singer 下拉里，每个声库名字左边有一个红心图标：

点一下红心 → 该声库加入 Favourite 分类
再点一下 → 取消收藏
已收藏的声库在下拉里优先显示，排在最上面

适合把常用的声库先标红心，每次新建工程不用翻半天列表找。

Singer 管理窗口

Tools → Singers... 打开完整的声库管理界面，能看到所有已装声库的详细信息：

列表（按名称 / 红心 / 语言分类）
选中声库后显示：character.yaml 预览、oto.ini 条目统计、音频文件列表、声库颜色定义
可以编辑 character.yaml（但建议用文本编辑器改更安全）
可以点 Oto 按钮查看和手动编辑 oto.ini（高级功能）

character.yaml 是什么

character.yaml 是 OpenUtau 用来替代 UTAU character.txt + prefix.map 的元信息真相源。每个声库目录里可以同时有：

character.txt（UTAU 原版格式，OpenUtau 兼容读取）
character.yaml（OpenUtau 推荐格式，信息更丰富）

OpenUtau 优先读 yaml，没有才读 txt。yaml 里可以定义：

# 基础信息
name: 重音テト SV
author: 重音P / Studio VOILA
language: ja          # zh / en / ja / kr / other
singer_type: UTAU     # UTAU / DiffSinger / ENUNU / VOICEVOX
version: 1.0.0

# 默认音素器
phonemizer: JA VCV

# 默认重采样器（Classic 引擎时生效）
resampler: worldline64.exe
wavtool: convergence

# 声库颜色（append）定义
voice_colors:
  - name: normal
    prefix: ""         # 对应歌词无后缀
    resamplers: []
    wavtools: []
  - name: soft
    prefix: "[h"       # 对应歌词加 [h 后缀
    resamplers: []
  - name: growl
    prefix: "[g"

# DiffSinger 专属
data_augmentation:
  genc: true
  velc: true
  ene: true
  vbre: true
  tenc: false
  voic: false
  pexp: true
  shfc: true

# 模板工程路径
template_project: default.ustx

关键字段说明

字段	作用	谁来设
`phonemizer`	装完声库后轨道头自动选中的音素器	声库作者设置；你也可以在 Install Singer 时手动选一个覆盖
`voice_colors`	定义声库有哪些 append 颜色、分别对应什么后缀	声库作者
`data_augmentation`	DiffSinger 声库支持哪些曲线参数	训练时确定，用户无法后加
`template_project`	选这个声库新建 USTX 工程时自动加载的模板	用户自己设

自建模板工程

在 OpenUtau 里：

新建一个空工程
选好声库、音素器、重采样器
写好速度/拍号、轨道头设置
File → Save As 存到声库目录下，命名为 default.ustx
在 character.yaml 里加 template_project: default.ustx

下次选这个声库新建工程时，自动加载这个模板，不用每次重复设置。

编辑 character.yaml

不建议在 OpenUtau 内部编辑——如果 OpenUtau 正在运行时你用文本编辑器同时改同一个 yaml，可能有冲突。稳妥做法：

关掉 OpenUtau
用 VS Code / Notepad++ 打开声库目录下的 character.yaml
改完保存
重开 OpenUtau

yaml 格式注意缩进（必须空格，不能 tab）。写错缩进 OpenUtau 可能读不到 yaml，降级用 character.txt。

声库分享

带 character.yaml 的声库可以直接分享给其他 OpenUtau 用户——对方解压后，OpenUtau 会自动读取 yaml 里的所有设置，不需要手动配置。这比 UTAU 原版需要手动配 oto.ini / prefix.map / flags 方便得多。

DiffSinger 声库的 data_augmentation 字段很关键——它告诉 OpenUtau 这个声库支持哪些曲线参数。如果有人给你分享一个声库但你发现某个曲线不起作用，先检查 yaml 里那个开关是不是 true。