第一次使用：
完成一次测试

先看本次要完成什么

确认版本与权限 → 配置 AI 和工程位置 → 在 Pro Tools 打开测试工程 → 扫描模版并核对 → 建立 4 个 AI 占位 → 保存并关联原生模板 → 加载 6 条素材并分析 → 开启六个模块 → 注入并检查结果。

本次使用 3 条鼓、2 条贝斯、1 条吉他素材，故意不放人声。完成后，应得到一个新的 Pro Tools 工程：6 条素材分到对应位置，测试轨名称和分类颜色正确，音频接入对应 Aux，Drums 编组包含 3 条鼓轨，没有素材的 Vocal AUX 按规则隐藏。AI 占位本身不计入 6 条真实音频轨。

准备工作通常只需做一次；以后使用同一套模板时，可从“加载素材、分析并人工确认”开始。

1. 使用前准备

首次运行时，在 macOS“系统设置 → 隐私与安全性 → 辅助功能”中允许 LY Prep。若系统随后请求 LY Prep 控制 Pro Tools 或 System Events，请按提示授予本流程所需权限。授权后若软件仍提示权限未开启，退出并重新打开 LY Prep。

先使用测试工程和已保存的模板副本。主页“注入”会进入新建 Pro Tools 工程的流程；如果当前已有工程，流程会尝试保存并关闭它。扫描时打开的工程并不等于最终接收音频的新工程。

2. 在 LY Prep 中完成初始设置

2.1 配置 AI

打开设置中的 AI 页面，在“AI API”区域填写：

1. 名称：用于自己辨认服务，例如服务商名称。
2. Base URL：填写服务商提供的 API 地址。
3. API Key：填写自己的有效密钥。
4. API 格式：与服务商的接口格式匹配。
5. 获取模型：点击“获取模型”，成功后从“模型列表”中选择要使用的模型。
6. 保存模型：点击“保存模型”，确认页面上方“已保存模型”中出现了这条配置；若显示保存失败，先按提示处理。修改 API Key、Base URL 或 API 格式后，需要重新获取模型再保存；获取失败时，先检查提示并解决问题。

返回主页后，在“AI 分析”旁的下拉菜单确认选中了刚保存的模型。首次测试使用现有默认提示词即可，不需要同时修改提示词、分析策略等高级设置。

本指南使用在线 API 分类流程，需要联网。后面的首次“AI 分析”同时用于检查密钥、接口与模型配置是否可用；若调用报错，应先解决报错再继续。

2.2 配置工程

打开“设置 → 工程”：

• 工程保存位置：选择第 1 步准备的测试目录。
• 模版位置：确认包含要使用的 Pro Tools 原生模板。默认位置为用户文稿目录下的 Pro Tools/Session Templates；若使用自定义位置，请选对目录。
• 采样率、位深、音频格式：与本次测试素材和目标工程保持一致。例如素材为 48 kHz／24 bit WAV 时，可使用相应设置。
• 精简轨道方式：选择 “按模板设置”，以便测试下文的“无音频时隐藏”规则。

其余高级开关先保持现有默认值。本次使用原生模板时，先在 Pro Tools 中把四条测试 Bus 和 Aux 输入输出配置完整，再扫描。

3. 打开 Pro Tools，扫描并核对模板

如果没有现成模板，可先在 Pro Tools 中新建一个测试工程，建立四条 Aux，并分别配置鼓、贝斯、吉他、人声的输入 Bus 与可用输出，再保存为原生会话模板（.ptxt）。如果对已有模板的结构或路由做过修改，也要同步保存相应的原生模板；只保存当前 .ptx 工程，不会让关联的旧模板自动包含这些改动。

从零准备时，可以使用下面这组名称。这里的 Aux 是轨道，Bus 是传递声音的 I/O 路径，两者不是同一个东西。有现成模板时，沿用自己的对应名称即可。

这组小样可以统一使用立体声 Aux 和立体声 Bus。若沿用现有模板，则以模板实际声道格式为准，避免同名 I/O 一边是 mono、另一边是 stereo。以上名称是准备示例，不表示安装包已经附带这些模板或素材。

1. 启动 Pro Tools，从准备好的原生模板打开一个用于扫描的测试工程。等待工程完全载入，关闭会遮挡操作的对话框，停止播放。
2. 在 Pro Tools 中确认四条测试 Aux 的输入分别连接到对应 Bus，输出连接到可用的主输出或上级混音总线。确认没有缺失或失效的 I/O。
3. 切回 LY Prep，打开 “设置 → 模版”，点击 “扫描模版”。
4. 等待扫描完成。对照 Pro Tools 核对：轨道名称、类型、声道格式、顺序与文件夹层级，以及输入、输出和 I/O 路径。
5. 点击 “查看 I/O”，确认四条测试路径存在；再核对四条 Aux 的输入和输出。
6. 如出现“扫描说明”，先看轨道名、读取到的输入名称和状态。未启用的轨道、未启用的输入或本次不用的声卡端口，可能只保留说明而不自动填入连接，不等于整个扫描失败。本次不用的项目可以保留；若涉及本次要用的 Drum、Bass、Guitar 或 Vocal 路径，再用“软件内定位”或“Pro Tools 定位”核对并补齐。若提示扫描未完成或显示状态恢复失败，先处理该错误，再继续。

4. 建立 4 个 AI 占位并保存模板

4.1 AI 占位是什么

AI 占位相当于一个“分类目标＋导入位置”：它告诉软件某一类音频应该放到哪里、采用什么颜色、接到哪个输出，以及是否建立编组。它不是一条需要录音的真实音频轨，也不要求你在 Pro Tools 中建立同名的 AI 轨道。

4.2 建立占位

在 LY Prep 的模板页面，对四条对应的结构轨分别右键，选择 “快捷建立 AI 占位”。也可以点击“新建轨道”，将类型选为 “AI 轨道” 后建立。

将占位命名为有明确含义的分类名称，不要只写“AI 1”“AI 2”。本次建议如下：

上表中的 Bus 名称只是用途说明，请选择实际扫描到的路径。例如 Aux 轨名是 Drum AUX、输入路径是 Drum Bus，AI 占位的音频输出应选 Drum Bus，不能仅凭 Aux 的显示名称判断。

确认各占位的顺序和所属文件夹，是你希望对应音频出现在工程中的位置。快捷创建会复制部分属性，但创建后仍要逐项核对；不要假定后续修改原结构轨时，占位的名称、颜色和输出也会自动跟随。

4.3 设置颜色与编组

• 点击各 AI 占位的色块，或右键选择 “轨道颜色…”，为不同分类选择容易区分的颜色。例如鼓用橙色、贝斯用蓝色、吉他用绿色、人声用紫色。分类后的音频会继承相应占位的颜色，再由主页“调色版”模块应用到 Pro Tools。
• 右键 Drums 占位，选择 “建立编组”。再次打开右键菜单，若显示“取消建立编组”，说明已开启。本轮准备 3 条鼓类素材，稍后要将它们全部分入 Drums；同组至少准备 2 条音频。
• 本轮不必配置 VCA 或兜底占位。后续如果在“AI 占位设置”中分配 VCA，还需要启用主页“编组”模块，并在 Pro Tools 中核对控制关系。

4.4 设置“无音频时隐藏”

1. 右键 Vocal 占位，打开 “AI 占位设置…”。
2. 展开 “无音频时隐藏”。
3. 勾选这条人声分类为空时需要隐藏的实体结构轨，例如本次测试专用的 Vocal AUX。
4. 点击“保存”。

这项设置需要三个条件同时满足：主页“精简轨道”开启＋工程设置选择“按模板设置”＋该 AI 占位没有分到音频。 满足条件后，才会处理这里明确勾选的轨道。

该方式执行的是隐藏，不是删除，也不等同于“自动判断”方式的隐藏并停用。未勾选的轨道不因这个占位为空就自动隐藏；如果同一条实体轨还被其他有音频的占位共用，会保留显示。仅开启主页“精简轨道”开关，却没有设置隐藏名单，本轮就看不到预期的隐藏效果。

4.5 保存并关联原生模板

1. 点击“保存模版”，保存为一个容易辨认的名称，例如 LY Prep Test。
2. 点击 “Pro Tools 模版关联”，在左侧选择刚保存的 LY Prep Test 软件模版。
3. 如果原生模板也叫 LY Prep Test，让中间链条保持连接，检查右侧是否自动显示正确模板。如果两边名称不同，点击链条切换为断开状态，再在右侧手动选择本次扫描对应的 Pro Tools 原生模板。
4. 如果显示“未找到同名模版”，先检查“设置 → 工程”的模版位置，也可以切换为手动选择。关联窗口底部的“不知道模版位置？”可打开模板文件夹；刚保存了原生模板但列表没有更新时，点击“刷新列表”。
5. 确认关联结果正确后点击“完成”。关联选择会自动保存。软件模版保存分类与路由配置，Pro Tools 原生模板保存实际工程结构；关联不会把一边的内容同步写到另一边。
6. 返回主页，通过“模版”菜单加载刚保存的测试模版，核对显示内容。

5. 加载素材、分析并人工确认

1. 在主页点击 “加载音频”，选择第 1 步准备的小样文件夹。
2. 确认本次文件数量正确。使用清楚的乐器文件名；在线 API 分类流程会使用素材文件名和模板目标信息，不应只用“音频 001”之类无语义名称来评价分类效果。
3. 在“AI 分析”旁确认模型选择正确，点击 “AI 分析”，等待完成。
4. 逐项核对：每条素材是否进入正确的占位、显示名称是否合适、输出是否正确、是否有未分配素材。
5. 如有误分配，使用软件现有的分配／输出调整功能修正，再核对位置和编组。本轮为了验证四个分类，请按下一步核对数量；日常使用可以保留暂时未分配的音频，规则见下方说明。
6. 本轮核对为 Drums 3 条、Bass 2 条、Guitar 1 条、Vocal 0 条。其中 Drums 的多条音频用于观察编组，空 Vocal 用于观察精简效果。若使用自己的素材数量，则按真实清单检查，但仍需保留一个空分类和一个至少 2 条音频的编组分类。
7. 为测试重命名，可将一条音频的显示名称手动改为明确不同于原文件名的名称，例如 Kick Test。避免与工程其他轨道重名。
8. 核对主页工程名称，建议填写 LY Prep First Test。可通过“项目”菜单保存本次软件项目，便于重新查看分析与调整结果。

未分配音频也会导入

开启“导入音频”并执行完整注入时，未分配、没有设置输出的真实音频仍会导入到 Pro Tools 轨道列表顶部，也就是模版第一条轨道之前。 它们按软件中的顺序排列，方便后续手动整理，不会因为没有分类而被丢弃。

LY Prep 不为这批未分配音频额外设置输出路由、编组或 VCA。导入后的实际输出以 Pro Tools 为准，需要使用时再核对连接；“未设置输出”不能理解为保证静音。

已分配到 AI 占位、只是采用默认主输出的音频，是另一种情况： 它仍按该占位的位置导入，不属于顶部的未分配区块。不能只凭输出字段为空判断音频是否未分配。

6. 开启六个模块并执行注入

本次只开启：导入音频、重命名、调色版、IO 路由、精简轨道、编组。

“去除静音”先关闭，让首次测试集中验证工程整理。

主页开关决定该模块是否参加本次完整注入。旁边的 ▶ 是单独执行按钮，适合在对应工程已经建立后补做某项操作；首次测试请设置好开关后，点击底部 “注入”，不要把六个 ▶ 依次点击当作完整流程。

执行时：

1. 最后核对工程保存位置、工程名称、模板关联与六个模块开关。
2. 确保 Pro Tools 当前测试工程已保存，点击主页底部“注入”。
3. 软件会进入新建工程及导入整理流程。期间请等待自动化操作完成，不同时切换 Pro Tools 工程或手动改动路由。
4. 如果提示找不到 Pro Tools 原生模板，本轮先取消，修正模板关联后再运行，避免临时切换到另一条测试流程。
5. 如果任务完成后出现提醒，先查看涉及哪条轨道、哪条 I/O 和哪个步骤。可以跳过的小问题会保留在提醒中，不代表整个工程没有建立；但被跳过的项目也不算已完成。可以用提醒里的“Pro Tools 定位”查找相关轨道；若提醒涉及临时定位轨残留，确认确实是本次临时轨后再手动删除。
6. 如果出现取消、失败或“未完整完成”提示，保留错误详情，并核对 Pro Tools 实际执行到哪一步，再决定是否补做对应模块；不要直接连续点击完整“注入”。

补充区别：关闭“IO 路由”会跳过相应 I/O 处理，但并不等于关闭建轨、改变 AI 导入落点或关闭精简轨道；这些行为不能仅靠一个开关推断。

7. 在 Pro Tools 中验收

完成后逐项检查，并记录“通过／未通过／未测”：

• □ 工程位置：新工程保存在指定目录，名称可辨认。遇到同名目录时，软件可能使用带后缀的新名称，以实际生成的目录为准。
• □ 导入音频：与本轮素材清单逐项核对，未出现缺失或意外重复。
• □ 摆放位置：鼓、贝斯、吉他等音频处于对应的模板位置／文件夹。
• □ 重命名：测试轨已使用 Kick Test 等确认后的名称。
• □ 颜色：分类轨道颜色与 LY Prep 中的配置一致。
• □ 输入输出：音频轨输出到正确 Bus，Aux 从同一 Bus 接收，并最终通向可用的主输出。
• □ 编组：Drums 编组包含预期鼓轨，成员数量与名称正确。
• □ 精简：无音频的 Vocal 占位所勾选的结构轨已隐藏；有素材分类的相关结构轨仍可见；隐藏轨仍存在。
• □ 播放：播放测试片段，确认音频轨、对应 Aux 与主输出都有预期电平，实际能够听到声音。
• □ 重新打开：保存并关闭新工程，再重新打开，核对音频、路由、颜色和编组仍然正确。

只有软件状态和 Pro Tools 实际结果都符合预期，才能把本轮记为通过。主界面返回“就绪”本身不能代替上述检查。

可选复测：换一组包含人声的小样，重新加载原测试模版并分析，然后建立另一个测试工程；确认 Vocal 分到音频后，该占位对应的结构轨不再按“无音频时隐藏”处理。

可选复测：保留一条未分配音频

另做一轮测试，保留 1 条真实音频为“未分配”，不设置它的输出；保持“导入音频”开启，执行完整注入。在新工程中核对：该音频已经导入，位于模版第一条轨道之前；它没有被自动接到某个分类 Bus，也没有加入该分类的编组或 VCA。其余已分配音频仍应出现在各自占位的位置。此复测的素材数量按本轮实际清单验收。

常见情况

反馈时请附上 LY Prep、Pro Tools、macOS 的版本，执行到哪一步、哪个模块、预期与实际结果，以及不含 API Key 的错误截图或日志片段。