Mirror 用户手册
适用版本：Mantrika Tools（当前主线）
1. 概述
Mirror 是一个后台自动跟随的工作流功能，定位是"在 Folder Track上，自动生成一排概览块，实时反映这个 Folder 里所有子轨道'有声音的地方'"。
Mirror 的做法是：在 Folder 轨道上，自动放一排"Mirror"（Empty item），每一段正好盖住它下面所有子轨内容的时间范围。子轨里的素材一移动、一增删，这排Mirror就实时跟着变——你不用做任何操作，它自己跟。
Folder「Footsteps」 │ ▓▓▓▓▓▓ ▓▓▓▓ ▓▓▓▓▓▓▓ │ ← Mirror（自动生成、自动跟随）
├ 子轨 A │ ■■■■ ■■ ■■■■■ │
└ 子轨 B │ ■■■ ■■■ ■■ │
└─并集─┘ └并集┘ └──并集──┘它和 "Adaptive Regions" 是互斥的：两者都在接管 Folder 的概览，不能同时开。开 Mirror 时会自动把 Adaptive Regions 关掉。
这是一个没有独立窗口的功能。它没有自己的界面，全部通过 Preferences 里的几个开关启用，启用后就在后台默默工作。所以本手册重点讲两件事：怎么打开它，以及每个开关到底干什么。
2. 如何开始使用
2.1 打开开关
菜单入口：
Extensions -> MantrikaTools -> Mantrika Options -> Preferences...（也可以在 Action List 搜 Preferences...）
打开 Preferences 窗口后，找到 Mirror Segments 这一节，勾上第一个开关：
■ Mirror Segments
☑ Enable Mirror Segment ← 总开关，先勾这个
☐ Auto Sync Segment Names
☐ Auto Track Name from Mirrors
☐ Auto Mirror Large Text Display
☐ Include Automation Items (Experimental)下面那一排是子功能，按需勾选（见第 4 节）。总开关不开时，子功能是灰的。
2.2 让Mirror出现
开关开好后，回到工程：
1. 建一个 Folder 轨道（父轨），下面挂上几条子轨
2. 在子轨上放一些 item（素材）
3. → Folder 轨道上自动出现Mirror，盖住子轨内容的时间范围之后你在子轨里移动、缩放、增删 item，Folder 上的Mirror都会自动跟着调整。不需要手动刷新。
Mirror 现在是"每个工程各自记"的模式：
Enable Mirror Segment设的是当前工程的助手模式（Mirror / Region / 关），跟着工程文件（.rpp）一起保存。新建 / 没配过的工程，则按 Preferences 里Default Assistants Mode下拉的全局默认进入。Mirror item 本身也存在工程里。
3. 核心概念
只有三个概念，理解了就全懂了。
3.1 Mirror
- 它是 Folder 轨道上的一个Empty item，长度 = 它下方所有子轨 item 的时间并集（重叠的会合并成一段）。
- 完全自动：该建的时候建、该伸缩的时候伸缩、内容没了就删。你不用管它。
- 子轨里被 mute 的 item / 整条 mute 的 Track不计入并集（等于"这段没声音"）。
- Mirror item 自身的标签固定显示为
mirror，不随轨道名或 Note 变化。所有"有意义的命名"都只走 Note（见 3.2）——这样你只需要盯住一处。
3.2 Note —— 给Mirror起名字（重点）
Mirror默认是没名字的。你可以给它写一段 Note（文字），方法很简单：
1、点击空 item上的气泡按钮（取决于你用的主题） → 弹出文字编辑框 → 输入文字；
2、或者选中使用Simple Rename 或者 Advance Rename；这段 Note 是整个 Mirror 系统的核心元数据，一处书写、多处复用：
| 你写的 Note | 会被用到哪里 |
|---|---|
| 推导轨道名时 | 当作 Folder 轨道的名字来源（见 4.2） |
| 大字显示时 | 在 item 上放大显示这段文字（见第 5 节） |
| 自动序号时 | 作为序列命名的模板（见 4.1） |
简单说：想让Mirror"有意义"，就给它写 Note。 后面那些自动化功能，几乎都是围着这段 Note 转的； 并且Mirror Note 还能兼顾Render时的file name；
3.3 Mute = 冻结（Freeze）
如果你把某个Mirror mute 掉，它就被"冻结"了：
- 冻结的Mirror不再自动跟随子轨内容（不会被移动、不会被删除）。
- 相当于把这一段"钉死"在当前位置。
- 想恢复自动跟随？取消 mute 即可。
4. 子功能开关详解
下面这些开关，都在 Enable Mirror Segment 下方。默认全部关闭，按需开。
4.1 Auto Sync Segment Names（自动同步段名 / 序号）
勾上后，对于连续的、命名有规律的Mirror，会自动帮你接着编号：
- 数字序列：
footstep_01、footstep_02、footstep_03…（保留前导零的位数） - 字母序列：
swing_a、swing_b、swing_c…
你只要给序列开头的那个Mirror写好 Note（比如 footstep_01），后面同名的就会自动续号，省得一条条手敲。
4.2 Auto Track Name from Mirrors（用Mirror命名轨道）
勾上后，会反过来用Mirror的 Note 给 Folder 轨道起名：
- 取 Note 的"主干"（去掉结尾的数字、字母后缀和分隔符）作为 Folder 轨道名。
- 例：Mirror叫
footstep_01，Folder 轨道就会被命名为footstep。 - 没有 Note 就不动轨道名：这个 Folder 下的Mirror都还没写 Note 时，你手填的轨道名原样保留，不会被清空。换句话说，命名权只在"写了 Note"时才交给Mirror。
- 开着时手动改 Folder 名会被纠正回来：只要该 Folder 下有写了 Note 的Mirror，轨道名就以 Note 主干为准；你手动改成别的名会被立即同步纠回。想自定义轨道名，先关掉这个开关。
💡 反过来的情况：如果你是先把轨道名起好了，想直接拿轨道名去填 Mirror 的 Note，有个一次性 Action 专门干这个——
Assistants - Mirror - Apply Track Name to Mirror Notes（见第 6 节）。它和上面这个自动开关方向相反、互不冲突。
4.3 Auto Mirror Large Text Display（自动大字显示）
勾上后，所有Mirror的 Note 会以放大/拉伸文字的样式显示在 item 上，远看也清楚。详见第 5 节。
⚠️ 这个"自动"模式比较吃性能（每次同步都要处理）。相对来说，更推荐用第 6 节的 Action 手动触发，自动刷一下，而不是常开这个开关。
4.4 Include Automation Items（实验性：纳入自动化 item）
勾上后，子轨上的 Automation Item 的时间范围也会被算进Mirror的并集里（默认只看普通的 media item）。
⚠️ 实验性功能，可能不太稳。不确定要不要用就别开。
5. 大字 Note（拉伸文字显示）
REAPER 默认在空 item 上显示的文字很小。大字显示会把Mirror的 Note 放大铺满整个 item，让你在 Arrange 区一眼就能读到每一段叫什么。
普通显示： │footstep_01 │ ← 文字小，挤在角落
大字显示： │ FOOTSTEP_01 │ ← 文字放大铺满，远看也清楚两个前提：
- 只对写了 Note 的 Mirror生效。空 Note 的 item 设了也没用（REAPER 底层会忽略）。
- 触发方式二选一：
- 常开自动：勾
Auto Mirror Large Text Display（吃性能，见 4.3）。 - 手动触发（推荐）：用下面的 Action，需要的时候点一下就行。
- 常开自动：勾
6. 配套 Actions
这几个 Action 在 Action List 里搜 Mirror 就能找到，也可以绑快捷键。它们是对Mirror的一次性批量操作：
| Action 名称（Action List 里搜） | 作用 |
|---|---|
Assistants - Mirror - Apply Stretched Text to All Mirrors | 给工程里所有Mirror一次性套上大字显示 |
Assistants - Mirror - Apply Stretched Text to Selected Mirrors | 只给当前选中的Mirror套大字显示 |
Assistants - Mirror - Clear All Mirrors | 一键清空所有Mirror及其编组（见第 8 节） |
Assistants - Mirror - Create Static Regions from Mirrors | 把有 Note 的Mirror**"烧录"成静态 Region** |
Assistants - Mirror - Apply Track Name to Mirror Notes | 把选中轨道名反向套给该轨所有 Mirror Note（≥2 个自动加 _01/_02） |
Apply Track Name to Mirror Notes适合「轨道名已经起好了，不想再单独折腾 Mirror 命名」：选中轨道点一下，该轨所有 Mirror 的 Note 直接套用轨道名（≥2 个按位置加_01、_02… 后缀，只支持这种「下划线+数字」形式；轨道名为空则清空 Note）。强制覆盖、顺带套大字、一次 Undo。它也在 Extensions 菜单和轨道右键菜单里。和 4.2 的自动开关方向相反、互不冲突。
关于 Create Static Regions：
- 它根据有 Note 的Mirror，生成一批 Region（Region 名 = Note 第一行）。
- 关键区别：这些 Region 是静态的——不受 Mirror 系统管理、不会再跟着Mirror动。
还有一个相关但不在这组里的 Action：
Assistants - Mark Regions For Adoption——让 Mirror 接管你已经画好的 Region（把命名继承过去）。它的用法单独见 第 7 节。 注意：它在 Action List 里要搜Adopt或Regions，搜Mirror找不到它。
7. Region 收养（让 Mirror 接管已有 Region）
收养解决的是这种情况：你手上已经有一批 Region（自己画的，或用 Action「mantrika : Markers - Create Regions From Items (remove extensions)」批量生成的，命名都对），想让 Mirror 把这些名字接管过来——继承进 Mirror 的 Note，而不是再一条条手敲。
典型场景：游戏音频迭代。先导入一批命名规范的素材 → 用 Action「mantrika : Markers - Create Regions From Items (remove extensions)」一键出一排带名 Region → 现在希望 Mirror 直接继承这些名字，而不是再一条条手敲 Note。
7.1 怎么用
1. 把 Region 命名好
2. 跑 Action：Assistants - Mark Regions For Adoption → 目标 Region 变「橙色」，排进待收养队列
3. 建好 Folder + 子轨素材，让 Folder 上长出 Mirror
4. → 新 Mirror 自动吃掉与它「时间重叠」的橙色 Region：名字写进 Mirror Note，老 Region 退化成普通 Marker第 2 步的 Action（Assistants - Mark Regions For Adoption）做的事：
- 扫描工程里所有不是 Mirror 创建的 Region，把它们标成 橙色，排进"待收养"队列。
- 已经被 Mirror 系统管理的 Region 不动（不会被重复标记）。
- 工程里没有可收养的 Region 时，会弹个提示框告诉你。
第 4 步的"收养"（在 Mirror 新建那一刻自动发生）具体做两件事：
| 步骤 | 动作 |
|---|---|
| 1 | Region 的名字 → 写进 Mirror 的 Note |
| 2 | 原来那个 Region → 变成一个普通空 Marker（位置留着，名字清空） |
7.2 几个关键点
- 靠时间重叠匹配：Mirror 和 Region 只要时间上有任意重叠就算命中，不要求严格对齐。一个 Region 先到先得，被一个 Mirror 收养。
- 收养只在 Mirror「新建」那一刻发生：已经存在的老 Mirror 不会回头去收养。所以正确顺序是先标记 Region，再让 Mirror 长出来。如果 Mirror 已经在了，可以改动子轨内容让它重建，或先
Clear All Mirrors再重新生成。 - 橙色 = "待收养"的视觉标记：标记后 Region 变橙，方便你一眼看出哪些在排队。被收养掉的 Region 已经变成 Marker，不会再被二次收养。
- 不支持 Undo：它是一次性的批量整理操作。
8. 清理
Mirror 大部分清理都是自动的，但也有手动的总闸。
8.1 自动清理（后台默默做）
- 孤立Mirror：如果一条轨道不再是 Folder（比如你解散了文件夹），它上面残留的Mirror会被自动删除。
- 关 Mirror 总开关 → 清掉 Mirror 造成的轨道编组（item grouping）。
8.2 手动清理（一键归零）
想彻底清干净，用 Action：
Assistants - Mirror - Clear All Mirrors它会逆序删除工程里所有Mirror + 清掉相关编组，相当于一次"重置"。当Mirror乱了、或者你想从头来过时用它。
注意：
Clear All Mirrors删的是 Mirror 系统的东西。你手动画的 Region 不受影响。
9. 典型工作流
工作流 A：用 Folder 概览声音结构
1. Preferences → 勾 Enable Mirror Segment
2. 工程里建 Folder，挂子轨，子轨放素材
3. → Folder 上自动出现Mirror，一眼看清"哪段有内容"
4. 折叠 Folder 也不影响——Mirror就是那个折叠后的概览条工作流 B：批量命名 + 大字概览
1. 勾 Enable + Auto Sync Segment Names
2. 给序列第一个Mirror写 footstep_01
3. → 后面同类的自动续号 footstep_02 / 03 …
4. 跑一次 Action：Apply Stretched Text to All Mirrors
5. → Arrange 区每段都大字显示名字，结构一目了然工作流 C：把当前划分"定格"成永久 Region
1. 段落和 Note 都调满意了
2. 跑 Action：Create Static Regions from Mirrors
3. → 得到一批不再变动的静态 Region
4. （可选）之后 Clear All Mirrors / 关掉 Mirror，静态 Region 依然保留工作流 D：把已有的 Region 交给 Mirror 接管
1. 已经有一批命名好的 Region（手画的，或 REAPER「根据 item 名创建 Region」生成的）
2. 勾 Enable Mirror Segment
3. 跑 Action：Assistants - Mark Regions For Adoption → 这些 Region 变橙
4. 建 Folder，挂子轨，在对应位置放上素材 → Folder 上长出 Mirror
5. → Mirror 自动继承重叠 Region 的名字（写进 Note）；老 Region 退化成 Marker（详见第 7 节；注意"先标记、再让 Mirror 长出来"的顺序）
10. 注意事项与排查
| 现象 | 原因 | 解决 |
|---|---|---|
| 勾了开关但 Folder 上没出现Mirror | 子轨里没有 item；或那条轨道其实不是 Folder | 确认是真正的 Folder 轨（有子轨），且子轨上有素材 |
| 子选项开关是灰的 | Enable Mirror Segment 总开关没开 | 先勾总开关 |
| 某个Mirror怎么编辑都不动 / 不跟随了 | 它被 mute 了，处于"冻结"状态 | 取消 mute 即可恢复自动跟随（见 3.3） |
| 大字显示设了没反应 | 该Mirror Note 为空 | 先写 Note，再套大字 |
渲染 Mirror 出来的文件没名字（只有 .wav）；队列里显示 mirror (unnamed) | 该Mirror没写 Note——两种 Mirror 渲染都用 $itemnotes 通配符，Note 为空时文件名也是空的 | 渲染前给Mirror写上 Note（见 3.2）；队列里凡标着 mirror (unnamed) 的就是还没起名的，按提示补上即可 |
| 开 Mirror 后 Adaptive Regions 自己关了 | 两者互斥，开 Mirror 会自动停掉 Adaptive Regions | 正常行为；二选一 |
| 自动大字显示让工程变卡 | 常开的自动大字模式较吃性能 | 关掉 Auto Mirror Large Text Display，改用 Action 手动触发 |
| 解散 Folder 后留下一些空 item | （会自动处理）孤立Mirror会被自动清除 | 等一次同步即可；或跑 Clear All Mirrors |
| Action List 里搜不到 Mark Regions For Adoption | 它不在 Mirror 那一组 | 改搜 Adopt 或 Regions（见第 7 节） |
| 跑了收养 Action，Region 也变橙了，但 Mirror 没继承名字 | 收养只在 Mirror 新建时发生，老 Mirror 不会回头收养 | 先标记 Region，再让 Mirror 长出来；已有 Mirror 可改子轨触发重建，或先 Clear All Mirrors 再重建 |