DragonianVoice

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

• 支持 C/C++ 的编译环境（仓库以 Lib 形式提供，支持 C/Cpp/C# 调用）
• 自行将模型转换为 ONNX 格式，并自行为每个模型编写 JSON 配置文件
• 自行下载前置模型（如 hifigan、hubert）并放入对应文件夹
• 确认 ONNX Runtime 版本，Cuda 支持需参考 OnnxRuntime 官方 Release
• 使用本项目须先同意 README 中列出的使用条款

安装与启动步骤

1. 1确认项目形态

   本仓库已永久停止 UI 维护，成为纯 Lib 项目，代码已迁至 DragonianLib；但 SVC 与 TTS 的 Release 仍在本仓库发布。

2. 2引入对应头文件

   按需引用 Tacotron、Vits、VitsSvc、DiffSvc、DiffSinger 等头文件，使用 InferClass 下的对应类。

   #include <Modules/Models/header/Tacotron.hpp>
   #include <Modules/Models/header/Vits.hpp>
   #include <Modules/Models/header/VitsSvc.hpp>
   #include <Modules/Models/header/DiffSvc.hpp>
   #include <Modules/Models/header/DiffSinger.hpp>

   复制

3. 3准备模型文件

   模型统一放在 Mods 文件夹下的子文件夹中，模型本体需要你自己转换为 ONNX 格式后放好，不能直接用 Python 权重。

4. 4编写模型配置

   每个模型目录下放一个 xxx.json 配置文件，Folder、Name、Type、Rate、Symbol 等字段需按模板自行编写，必须与训练时参数一致。

   {
     "Folder": "Atri",
     "Name": "亚托莉-Tacotron2",
     "Type": "Tacotron2",
     "Rate": 22050,
     "Symbol": "_-!'(),.:;? ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz",
     "Cleaner": "",
     "AddBlank": false,
     "Hifigan": "hifigan"
   }

   复制

5. 5放置前置模型

   Tacotron2 需把 hifigan 放到 hifigan 文件夹；RVC、SoVits 需把 hubert / hubert4.0 放到 Hubert 文件夹，否则加载失败。

6. 6调用推理接口

   构造函数依次传入配置文件 json、进度条回调、参数回调（TTS 可留空）、设备，随后调用 Inference 函数执行推理。

   InferClass::Tacotron2;
   InferClass::Vits;
   InferClass::VitsSvc;
   InferClass::DiffusionSvc;
   InferClass::DiffusionSinger;

   复制

7. 7参考命令行示例

   仓库未提供安装命令，可参考 README 给出的 RVC Onnx 命令行推理示例工程了解实际调用方式。

关键配置

如何确认成功

README 未给出启动命令；模型能成功加载且调用 Inference 后正常输出音频即视为可用，加载报错多为配置或前置模型缺失。

常见问题

注意事项

• 使用本项目必须先同意 README 中的条款：禁止出售程序，禁止用于商业游戏、低创游戏及 Galgame 制作，禁止制作电子垃圾。
• 开发者主张生成的音频本身不具版权、应划归公共领域，但歌词、乐曲版权仍归原版权方所有。
• 仓库已停止 UI 项目维护，转为纯 Lib，代码仓库地址为 DragonianLib；SVS 支持请查看 MoeVoiceStudio 分支。
• 最新版本已与 fish-speech 联动，用 ggml 重写组成 fish-speech.cpp 子项目。