主题

Convbased Bridge VST3 ​

Convbased Bridge 是 Windows x64 VST3 效果插件。在 DAW 音频轨道上插入插件后，插件通过本地桥接服务（在本机运行的 Python 进程，下称桥接服务）连接 Convbased 实时服务；转换后的声音回到该轨道。音频输入与输出由 DAW 管理。

支持范围 ​

项目要求
操作系统Windows 10 或 11，x86-64
宿主支持 VST3 的 64 位 DAW；实时监听建议使用 ASIO
构建工具Visual Studio 2022 或 2026 Build Tools，安装“使用 C++ 的桌面开发”和 CMake
桥接服务Python 3.10 或更高版本
服务权限具备 realtime 权限并已绑定设备配置的 API Key

插件不支持 Windows ARM64、macOS 或 Linux。Logic Pro 不能加载此 VST3 插件。

音频输入与输出 ​

还没有收到转换后的声音时，插件输出静音；在宿主中启用 Bypass 时，插件输出未处理的原声。

立体声输入发送到桥接服务前会混为单声道，转换后的单声道会复制到左右声道。插件也支持单声道轨道。

获取源码 ​

powershell
git clone https://github.com/Convbased/vst3.git convbased-vst3

桥接服务使用的 Convbased Python SDK 已包含在仓库的 third_party 目录中，无需另外下载。

构建和安装插件 ​

在 convbased-vst3 根目录运行：

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

首次构建会下载所需版本的 Steinberg VST3 SDK。插件默认安装到当前用户目录。安装后让 DAW 重新扫描插件，并在音频轨道上插入 Convbased Bridge。

配置和启动桥接服务 ​

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

桥接服务默认只监听 127.0.0.1:43127。修改端口时，必须在启动 DAW 前设置插件读取的环境变量，并把同一端口传给桥接服务：

powershell
$env:CONVBASED_VST_BRIDGE_PORT = '43128'
.\scripts\run-bridge.ps1 -Port 43128

保持桥接服务监听地址为 127.0.0.1，仅允许本机插件连接。

连接 ​

  1. 启动桥接服务并保持终端运行。
  2. 打开插件界面，在 API Key 输入框中粘贴密钥，输入内容不会明文显示。
  3. 点击 连接。
  4. 等待界面显示密钥验证结果、设备配置和连接状态。

模型、变声参数和实时服务开关来自该 API Key 绑定的设备配置。设备配置变化后，当前实时会话会结束，桥接服务随后按新配置重新连接。

API Key 只保存在当前插件与桥接服务进程的内存中，不写入磁盘、预设、插件状态或 DAW 工程文件。点击 清除 会清除插件内存中的密钥并断开实时连接。只有 API Key 的权限允许查询余额时，界面才显示账户余额；无法查询余额不影响变声。

延迟 ​

插件向宿主报告的延迟固定为 0 个采样点。实际监听延迟取决于 DAW/ASIO 缓冲、音频传输、网络和模型处理。

实时监听建议使用 48 kHz 采样率、有线网络和能稳定运行的较小 ASIO 缓冲，再根据实际效果调整。

检查安装 ​

启动桥接服务，在 DAW 中插入插件，使用有效 API Key 和可用模型完成试听。确认输出为转换后的声音，延迟满足使用要求。

常见故障 ​

现象检查
DAW 找不到插件确认插件的安装位置在 DAW 的 VST3 扫描路径内，然后重新扫描
连接后持续静音检查桥接服务是否在运行、API Key 权限、设备配置、实时服务开关、模型、余额和网络
DAW 无法连接桥接服务确认插件和桥接服务使用同一个本机端口，并在修改端口后重启 DAW 和桥接服务
重新打开工程后要求输入 API KeyAPI Key 不随工程保存；重新输入 API Key 并点击 连接
监听延迟明显使用 ASIO、有线网络和更小但稳定的缓冲