主题

VST3 实时变声插件 ​

Convbased Bridge 是面向 Windows x64 DAW 的 VST3 效果插件。本地桥接服务是与插件配套运行的 Python 进程：它只监听本机，把 DAW 音频接入 Convbased 实时处理，再将转换后的信号返回同一插入点。这条路径不需要另外打开 Windows 录音或播放设备。

最近发布的测试标签是 v0.1.0-alpha.2；以下源码构建步骤以公开仓库主线为准。仓库未提供预编译二进制文件。

适用范围 ​

项目要求
操作系统Windows 10/11 x64
工具链Visual Studio 2022 或 2026 Build Tools，安装“使用 C++ 的桌面开发”和 CMake
桥接服务环境Python 3.10 或更高版本，以及本地 convbased-sdk 源码
宿主支持 VST3 的 64 位 DAW；实时监听建议使用 ASIO

当前不支持 Windows ARM64、macOS 和 Linux。Logic Pro 不加载 VST3；即使后续增加 macOS 传输层，仍需独立的 Audio Unit 目标。

音频路径 ​

text
DAW 音频块
  -> VST3 实时回调
  -> 预分配环形队列
  -> 本机 127.0.0.1:43127
  -> Python 桥接服务与 Convbased SDK
  -> WebRTC / Convbased 模型
  -> Python 桥接服务与本机环回
  -> VST3 实时回调
  -> DAW 轨道

插件的实时线程不分配内存、不加锁，也不进行套接字 I/O。传输阻塞或转换音频尚未可用时，插件返回干声，不阻塞 DAW 回调。

立体声输入会在发送到桥接服务前混为单声道，转换后的单声道则复制回左右声道。插件同时支持单声道宿主布局。

获取与构建 ​

powershell
git clone https://github.com/Convbased/vst3.git
cd vst3

.\scripts\build.ps1 -Configuration Release
.\scripts\test.ps1 -Configuration Release

首次配置会获取固定在 v3.8.0_build_66 的 Steinberg VST3 SDK。构建脚本不创建系统级插件符号链接。

将 Release 产物安装到当前用户的标准 VST3 目录：

powershell
.\scripts\install-plugin.ps1 -Configuration Release

安装后让 DAW 重新扫描插件，然后在音频轨道上插入 Convbased Bridge。

配置本地桥接服务 ​

默认布局中，vst3 与 convbased-sdk 位于同一父目录。在 VST3 仓库根目录执行：

powershell
.\scripts\setup-bridge.ps1
.\scripts\run-bridge.ps1

如果 SDK 位于其他目录，显式传入 Python 包路径：

powershell
.\scripts\setup-bridge.ps1 -SdkPath 'D:\src\convbased-sdk\packages\sdk-python'

先启动桥接服务，再在插件编辑器的 API Key 字段中粘贴该工作站使用的 API Key 并选择 Apply key。控制台为该 Key 绑定模型、转换参数和“实时服务”开关；插件本机不另行保存模型或音色参数。

重新加载工程后需再次输入 API Key。本机握手未加密，因此传输层固定只连接 127.0.0.1。

如需修改默认端口，在启动 DAW 和桥接服务前为两者设置相同的 CONVBASED_VST_BRIDGE_PORT。

插件控件 ​

  • API Key：遮罩显示，需显式应用。
  • Mix：默认为 100% 转换信号。实时监听建议保持 100%。
  • Bypass：输出干声，同时保持后台传输运行。

延迟语义 ​

插件向宿主报告 0 个延迟样本，因为本地处理不含固定前瞻或可预知的块延迟。这不表示转换链路是零延迟。DAW/ASIO 缓冲、20 ms WebRTC 音频帧、网络往返和模型块大小仍会产生可变延迟，这些值不能正确表示为固定的 VST 延迟补偿。

实时监听时建议使用 48 kHz、有线网络、稳定的小 ASIO 缓冲和 100% Mix。干湿信号混合时，转换信号相对干声的延迟可能引起梳状滤波。

验证与发布边界 ​

离线测试覆盖 C++ 环形队列与本地传输、插件 UI 状态、Python 音频与协议、设备配置解析，以及 Steinberg VST3 validator。构建自包含 Windows x64 测试包：

powershell
.\scripts\package-windows.ps1 -Version 0.1.0-dev
.\scripts\test-package-windows.ps1 `
  -ZipPath '.\out\ConvbasedVST3-0.1.0-dev-windows-x64.zip'

包测试会校验 ZIP 与内部二进制文件的 SHA-256、AMD64 PE 架构、桥接服务启动和 VST3 validator 结果。

离线通过不等于云端实时会话已通过。对外分发二进制包前，还需使用有效凭据、可用模型和实际 DAW 完成端到端试听，并单独记录宿主、音频接口、采样率、缓冲大小、网络条件和模型。

常见问题 ​

现象处理
DAW 找不到插件确认已安装到当前用户 VST3 目录，并在 DAW 中重新扫描。
应用 API Key 后仍只有干声先确认桥接服务正在运行，再检查 Key 绑定的模型、“实时服务”开关、网络和余额。
DAW 与桥接服务无法连接确认两个进程使用相同本机端口，并在修改环境变量后重启两者。
重新打开工程后需要 API Key重新输入后再连接桥接服务。
监听延迟或相位感明显使用 ASIO、有线网络、更小的稳定缓冲和 100% Mix；不要把固定延迟报告为端到端延迟。

最后更新于: