VST3 接入配置

audio-plugin-profile 不是把 VST 打进 Workshop 包，而是发布一份 映射说明：告诉订阅者「本机装某个 VST3 后，在 ECHO 里怎么启用」。索引 → 创意工坊 SDK。

Workshop 不能分发 VST DLL/插件安装包。用户必须自己从正规渠道安装插件。ECHO 只登记 ClassId、厂商、路由等，让声音链路过该插件。

新建项目

node .\bin\echo-workshop-sdk.mjs init .\my-vst-map --kind audio-plugin-profile
cd .\my-vst-map

入口文件：content/audio-plugin-profile.json。

填什么

模板大致如下（务必替换占位符）：

{
  "type": "echo-workshop-audio-plugin-profile",
  "schemaVersion": 1,
  "id": "echo.vst.my-effect",
  "title": "某某混响 · ECHO 接入",
  "description": "订阅者需自行安装厂商 VST3。本条目仅提供 ClassId 与默认参数映射。",
  "format": "vst3",
  "role": "effect",
  "plugin": {
    "classId": "ABCDEF1234567890ABCDEF1234567890",
    "name": "Real Plugin Name",
    "vendor": "Real Vendor"
  },
  "adapter": {
    "api": "echo.audio-plugin-adapter",
    "minimumVersion": 1
  },
  "routing": {
    "placement": "post-dsp"
  },
  "parameters": [
    { "id": 0, "title": "Mix", "kind": "continuous", "defaultValue": 1 }
  ],
  "presets": [
    { "id": "default", "title": "Default", "values": { "0": 1 } }
  ]
}

字段	说明
`plugin.classId`	VST3 的 32 位十六进制 Class ID（从插件文档或扫描工具获取）
`plugin.name` / `vendor`	与安装器里显示一致，方便用户核对
`role`	`effect` 或 `instrument`
`routing.placement`	`pre-dsp` 或 `post-dsp`，相对 ECHO DSP 链位置
`parameters` / `presets`	暴露给用户的参数 id 与默认值

默认模板里的 00000000000000000000000000000000 和 Replace with… 会被 quality 标为 blocker。发布前必须换成真实 ClassId 和名称。

作者工作流

在你自己的电脑上安装目标 VST3，用 DAW 或厂商工具确认 能出声。
查到 ClassId（厂商文档、VST 扫描器或 DAW 插件信息）。
init 项目，填入 classId、vendor、name、routing。
写清楚 description：支持哪些系统、是否需要 Pro、没有安装时 ECHO 会怎样提示。
npm run check — 确认占位符已清掉。
发布；README 里链接厂商官网，不要放破解或网盘。

订阅者会怎样

Steam 订阅并使用此条目
读你写的说明，自行安装 VST3
在 ECHO 里 启用接入配置
若列表仍提示缺本机插件 → 只完成了登记，插件 DLL 还没被系统/ECHO 找到

这与「沙箱插件」「DSP JSON 预设」是不同路径：VST profile 对接用户本机已装二进制。

和 DSP preset 的区别

	DSP preset (`dsp.json`)	audio-plugin-profile
内容	31 段 EQ 曲线	VST3 ClassId + 参数映射
依赖	仅 ECHO 内置 EQ	用户本机必须装 VST
典型用途	作者调好的 EQ	第三方混响、效果器接入

VST3 接入配置

新建项目

填什么

作者工作流

订阅者会怎样

和 DSP preset 的区别

相关文档