基于检索的语音转换（RVC），重写为一个完整的应用：**转换**音频文件、通过声卡**实时**变声、从音乐中**分离**人声、**训练**自己的音色，并在同一个**模型库**中管理它们，网页界面和命令行都能完成。
rvc-next 是 [Retrieval-based-Voice-Conversion-WebUI](https://github.com/RVC-Project/Retrieval-based-Voice-Conversion-WebUI) 的重写。数值计算部分（合成器、RMVPE、转换与实时流的计算、训练循环）从原版移植，因此已有的音色听起来完全一样；除此之外的一切都是新的：
- **到处都是同一个音色选择器、同一个参数面板**。每个音色有自己的默认预设，在转换和实时变声中听起来一致。
- **每个耗时操作都是一个任务**，可以查看进度、取消、重试，稍后再回来查看；界面不会被卡住。
- **流水线**：在一个任务里完成分离人声、转换、再混回伴奏。
- **音频设备**按物理设备列出，每个设备只出现一次；输入和输出可以使用任意驱动，可选监听输出，带电平表和测试音，设备重新接入后自动恢复；还可以用回环测试实测真实延迟，而不只是估算。
- **已有模型无需改动即可加载**（`.pth` 和 `added_*.index`），可以直接读取已有的 RVC 安装，新生成的模型也使用同样的格式。
文档（使用教程、命令行与开发文档，中英双语）见项目官网 [rvc-next.netlify.app](https://rvc-next.netlify.app/docs)。其源文件位于 [site/content/docs/](site/content/docs/index.mdx)，是 `site/` 中项目网站的一部分（运行 `python scripts/dev.py site-dev` 可本地预览）。设计记录、约定以及与原计划的差异见 [AGENTS.md](AGENTS.md)。
## 安装
rvc-next 应运行在独立的虚拟环境（或独立的 Python）中：它把依赖固定在测试过的版本范围内，不适合与其他应用共用环境。
1. 创建并激活虚拟环境（Python 3.10 或更新）：
```bash
python -m venv .venv
. .venv/bin/activate # Windows：.venv\Scripts\activate
```
2. 按硬件安装 PyTorch（2.7.1 或更新；不需要 torchaudio）：
```bash
# Windows / Linux，NVIDIA 显卡
python -m pip install torch==2.14.0 --index-url https://download.pytorch.org/whl/cu130
# Windows / Linux，AMD 显卡（AMD 发布的 ROCm 构建；显卡显示为 cuda:N）
python -m pip install "torch[device-all]==2.13.0+rocm10.0.0" --index-url https://stable.repo.amd.com/rocm/whl-next
# Windows / Linux，Intel 显卡（显卡显示为 xpu:N）
python -m pip install torch==2.14.0+xpu --index-url https://download.pytorch.org/whl/xpu
# macOS（Apple 芯片；Metal 支持为实验性）
python -m pip install torch==2.14.0
# 没有 GPU
python -m pip install torch==2.14.0 --index-url https://download.pytorch.org/whl/cpu
```
3. 安装 rvc-next：
```bash
python -m pip install rvc-next
```
在 Windows 上，ROCm 和 XPU 构建不支持的 AMD 和 Intel 显卡可以使用 DirectML：第 2 步安装 CPU 版 PyTorch，再运行 `python -m pip install "rvc-next[directml]"`。
然后下载必需的模型并启动网页界面：
```bash
rvc-next assets download # HuBERT 及音高模型 RMVPE、FCPE（约 400 MB）
rvc-next model download --all # 可选：RVC 官方演示音色
rvc-next webui # http://127.0.0.1:7868
```
`rvc-next doctor` 会报告 torch 的构建版本（CUDA、ROCm 或 XPU）、GPU 规则选中的设备、音频设备访问情况以及资源状态。在 Linux 上，实时变声需要 PortAudio（`libportaudio2`）。
如果要复用已有 RVC 安装中的模型，把 `paths.assets_dir` 指向它的 `assets/` 文件夹，并把该安装添加为原版 RVC 安装（**模型** › **音色** › **原版 RVC 安装**；或运行 `rvc-next model import 
