虚拟补丁线：Windows MIDI Patchbay 完整使用教程，10个技巧快速连接你的MIDI设备

Windows MIDI Services自带的MIDI Patchbay是一款"软件版硬件补丁线（patchbay）"：把 MIDI 键盘、合成器、DAW 等端点拖到画布上，从一台设备的Out拉线到另一台的In，信号即刻连通。支持滤波器、音高移调、通道映射、MIDI 时钟、OSC 网络传输等 8 类处理步骤，一套设备可以同时驱动多个声部。本教程面向新手，带你从零搭好第一条虚拟 MIDI 线路。

一、什么是 MIDI 虚拟补丁线？

想象录音机架上的实体 patchbay：键盘进合成器、鼓机进 DAW、一个控制器分给三台乐器。Windows MIDI Patchbay把这些跳线全部搬进软件：

• Patch（补丁）：一块画布 = 一套完整的信号路由方案，保存为.midipatch文件，存放在Documents\MIDI Patches，可备份、可拷到其他电脑。
• Endpoint（端点）：真实 MIDI 设备或 loopback 虚拟端点，每个端点有In / Out两列接线点。
• Step（处理步骤）：插在连线中间的"信号处理器"，可以过滤、改写、分发 MIDI 消息。
• Routing（路由）：打开开关后信号才开始流动；主窗口磁贴的绿色边框表示正在路由，角落数字是每秒通过的消息数。

⚠️ 重要前提：路由只在Windows MIDI Patchbay 进程运行期间生效。想让路由常驻后台，见 第五节。

二、2分钟快速上手：New quick patch

主窗口顶部的New quick patch是最快的入门方式：选一个源设备 → 选一个目标设备，两步生成一条连线的补丁。

1. 点击New quick patch，依次选择"从哪来"和"到哪去"；
2. 磁贴上打开开关，开始路由——绿色边框亮起即成功；
3. 点选磁贴打开编辑窗口，或悬停磁贴点Edit进入画布。

需要从零自由搭建？点New patch获得空白画布。顶部筛选器All / Routing / Not routing / Needs attention帮你快速定位"缺设备"或"有问题"的补丁。

三、画布接线：In / Out 与 Group 的正确理解

接线三要素：

• All groups 行：默认选择。整台设备的所有 Group 原样透传，"把这台设备发给那台"就选它；
• 指定 Group 对 Group：消息经过时 Group 号会被改写——这是把一台设备的 4 个 Group 合并到另一台设备 1 个 Group 的标准做法；
• 拉线方式：从 Out 点拖到 In 点即可，靠近就会自动吸附；也支持鼠标点一下 Out、再点一下 In（键盘操作同样可用）。

常用编辑操作：

四、8类处理步骤：让一条线路变"聪明"

从左侧Steps面板拖一个步骤丢到连线上，连线会自动从中间断开并插入该步骤。

🎹 经典案例：一个键盘分两个音区

1. 把键盘拖到画布，从Steps拖两个Note filter（音符滤波器）到连线上；
2. 第一个设 C2–C5 通过（Lower keys），第二个设 C3–G8 通过（Upper keys）；
3. 分别连到合成器和 DAW 即可实现中音区分割演奏。

滤波器支持点击琴键选音区，打开Learn还能边弹边学：

其他高频步骤

• Filters 过滤：通道、Group、力度、CC 控制号过滤——比如屏蔽掉刷屏的 Clock 和 Active Sensing；
• Transforms 变换：通道映射、移调（Transpose）、力度曲线重塑、踏板反向（CC 64 勾选Invert一键修复"反了"的延音踏板）、音量踏板校准（输入 10–117 拉到全量程）；
• Message converter：把打击垫的音符转成 DAW 认的 CC，或把循环音符变成 MIDI Clock；
• Generators 发生器：MIDI Clock（24 脉冲/拍，可带 Swing）、Time Code、LFO，一个时钟喂饱整条链路；
• Game controllers：把 Xbox 手柄、摇杆的按键摇杆直接变成 MIDI 控制器，支持Learn学习；
• Gate / Switch / Branch：逻辑门控与分流，脚踩踏板切换键盘目标音源；
• Message throttler：给老设备限速到 31,250 bps 的 MIDI 1.0 线速，防止丢消息。

五、Loopback：把 DAW 接进你的虚拟补丁线

Patchbay 运行在自己的进程里，够不到别的 App 内部——loopback 虚拟端点就是桥梁：DAW 打开 loopback，Patchbay 把信号喂进 loopback。

两种类型：

• MIDI 1.0 basic loopback：单端点，进入什么就原样返回给所有打开它的 App，最通用；
• MIDI 2.0 loopback 对（A/B 双端点）：进 A 出 B、进 B 出 A，互不回流，用于 MIDI-CI responder 等场景。

操作：补丁编辑窗口工具栏点Create loopback，一步到位创建并直接放到画布上。loopback 是系统级端点，关闭 Patchbay 后依然存在。

💡 进阶技巧：有些老 App 按名字记设备。可以先把 loopback 命名为原设备名，再把设备 Out →（滤波器）→ loopback In，App 就会"认"到它并只收到你放行过的消息。

六、OSC 连接：手机平板也能弹你的合成器

把OSC connection从Endpoints面板拖到画布，选择预设（REAPER、TouchOSC、TouchDesigner、Open Stage Control 等），填好收/发端口，再点Test note发送一个中音 C 验证连通。

• 本机 App 发往127.0.0.1；手机/平板用其 IP，或Browse network自动发现（如iPhone (TouchOSC)）；
• 首次跨设备使用前，点顶部提示条的Allow through Windows Firewall，一次放行 UDP + TCP；
• 勾选Virtual MIDI device后，DAW 还能直接按名字打开这个 OSC 连接。

分步配置 REAPER / TouchOSC 的完整流程见知识库文档：docs/kb/using-osc-with-midi-patchbay.md

七、验证线路是否通畅：Test 三件套

选中端点后右键（或点工具栏Test）：

1. MIDI Monitor：实时监视该端点收到的每条消息——docs/tools/midi2monitor/index.md
2. MIDI Keyboard / Scratch Pad：直接向该端点发音符或任意消息——docs/tools/midiscratchpad/index.md
3. Trace messages…：不真正发送，逐条推演消息在画布中的走向，走过的连线变绿、被拦下的步骤标红。设备没插、补丁没在路由也能用。

八、保存、导入与常驻后台

补丁文件管理

• 每个补丁一个.midipatch文件（旧版.midipatch.json会在下次启动时自动重命名）；
• 收到别人分享的补丁：点Import patch…选择文件，或资源管理器中双击（首次选择用 Windows MIDI Patchbay 打开）。导入后默认不路由、不自动启动——先看清内容再开；
• 想保存前先看 AI 帮你生成的补丁长什么样？参考格式规范：docs/kb/midi-patchbay-patches-for-agents.md

保持路由常驻（2个设置）

• Start with Windows：登录即启动 Patchbay；
• Run in notification area：关闭主窗口只最小化到通知区，路由不断。点托盘图标可恢复窗口、列出全部补丁、一键停全部路由。

⚠️ 注意：关闭某个补丁的编辑窗口不会停止路由；但直接退出 Patchbay 会停掉一切路由，有路由进行时退出会先弹出确认。

九、常见问题速查

十、更多资料

• 官方工具文档（含全部设置详解）：docs/tools/midipatchbay/index.md
• Loopback 端点管理工具：docs/tools/midiloopbacksetup/index.md
• MIDI 设备与端口命名设置：docs/tools/settings/index.md
• Patchbay 应用源码：src/in-box/user-tools/midi-patchbay/
• Windows MIDI Services 文档首页：docs/index.md

🎧 现在打开 Windows MIDI Patchbay，用New quick patch把你的第一台键盘连到第一台合成器吧——从一根虚拟跳线开始，你的软件机架会越来越强大。