UTUVO Catalog － 使用手册

适用版本：0.1.0-beta 邀请制测试版 读者：初次拿到 UTUVO Catalog 的混音师与母带工程师 怎么读：从「What Catalog is and is not」到「Sources and scanning」请按顺序读完，那几章不读就容易误判；「Search」之后可以当字典查。

What Catalog is and is not（这个 app 是什么、不是什么）

UTUVO Catalog 是给 Atmos 母带用的资产目录。你硬盘上那几百个 ADM BWF，它负责整理、找出来、验过，再把可以交给别人的证据输出来。整个 app 就做这四件事：整理、找、验、交出证据。

先说它刻意不做的四件事，免得你在界面上等一个根本不存在的按钮：

• 不做空间音频渲染，也不做 binaural 监听。你在这里听到的一律是 Stereo Downmix。
• 不做 mastering 建议，也不做批量响度校正。它只测量、只报告，不动手改。
• 不自动删除重复文件。重复的证据它会摊开给你看，按下删除永远是你在 Finder 里的决定。
• 不自动上传，没有云端协作。默认完全不联网。

最后还有一条，是上面所有设计的地基：Catalog 绝不改写你的原始 ADM／WAV。扫描只读文件头与内容指纹，不解码音频、不搬文件、不改文件。你在 Catalog 里填的每一个字段、贴的每一张封面、做的每一次核准，都写在 Catalog 自己的 overlay 数据库里，跟音频文件本身是两回事。就算你把整个 Catalog 数据库删掉，原始母带还是原封不动躺在原地。

Catalog、QC 与 Player 的分工

UTUVO 家族有好几个 app，职责分得很开：

所以「我想在大音箱上听这个 Atmos 母带」这件事不在 Catalog 里，那是 Player 的职责。Catalog 的试听是给你确认「这个文件是不是我以为的那个」用的。

三条先记住的原则

1. 只读不写：原始 bytes 永远不变。
2. 证据分级：界面上永远分得清「这是正式规范」和「这是行业建议阈值」。
3. 不假装知道：Catalog 不猜。看到未测量、来源未记录，代表那件事真的还没发生，或者那个文件的 header 里本来就没写，不是 app 坏了。

Installation and setup（安装与初次启动）

1.1 安装

请使用随邀请一起收到的安装程序。打开安装程序，将 UTUVO Catalog 拖入「应用程序」，再从「应用程序」启动。该版本的安装注意事项会随邀请提供。

1.2 初次启动会发生什么

初次启动会自动开始一段手把手教学，一共 25 步。它分成 7 章（欢迎、入库、找文件、看细节、交付、试听与整理、保命），会把工具栏、侧边栏、Inspector、交付检查一路指给你看。

教学有两种步骤：

• 要你动手的：例如「选一个放 ADM BWF 的文件夹」「打开来源健康度」。这种步骤要等你真的做了才会前进。
• 纯讲解的：只是把界面上某个区域圈起来说明，按下一步或键盘右方向键即可继续。

随时可以按 Esc 或卡片上的跳过教学结束。教学里用键盘左右方向键可以前后翻。

想重看的时候：工具栏最左边那个滑块图标就是设置菜单，里面有「重新打开手把手教学（共 25 步）」。它会从第一章重来；如果你已经登记过来源文件夹，第一个动手步骤会自动跳过，直接带你到下一步。

1.3 macOS 的文件夹授权

Catalog 是 sandbox app，只能读你明确选给它的文件夹。初次选取来源文件夹时 macOS 会弹出授权窗口，点「允许」。

实用建议：移动硬盘直接选盘的根目录最省事。选了根目录，整块盘的授权就一次拿到，之后在盘里新建子文件夹也不用再授权一次。如果你只授权了某个子文件夹，之后要扫旁边那个文件夹就得再选一次。

授权失效（例如换了 USB 口、系统更新、重新格式化）时，来源健康度会显示受阻，重新用选择来源文件夹选一次那块盘就会恢复。

The interface（操作界面）

这一章用图说明每个区域长什么样、在哪里。每张图下面都写了展开说明的章名，细节请看那一章。图是在一个只有四条母带的测试库里拍的，所以数字会比你的小。

主界面

三栏从左到右是侧边栏、卡片墙、Inspector。最上面是工具栏与搜索框。逐区说明在「The screen map（界面分区）」章。

设置菜单

工具栏最左边的滑块图标打开设置菜单，里面有语言、外观、界面字体、重新打开手把手教学，以及最下面的危险区域。界面字体五选一，换了不影响数据。主题见「Appearance（外观）」章，危险区域见「How safe your data is（你的数据有多安全）」章。

搜索选项

搜索框旁边的搜索选项展开后可以不打字就拼出条件。字段键、is: 能填什么、数值比较怎么写，都在「Search（搜索完全指南）」章。

Inspector

选一张卡片，右边的 Inspector 就会显示这条母带。三个标签页的每一行在「Inspecting one master（查看一条母带）」章逐项说明。

来源健康度

侧边栏的来源可以打开健康度面板。五个数字各代表什么、什么时候该重新扫描，见「Sources and scanning（添加来源与扫描）」章。

交付检查

交付检查用配置文件对一条母带执行检查并列出结果。五个配置、四种状态与证据等级在「Delivery Gate（交付检查）」章。

试听

Quick Look 用来快速听一条母带。你听到的是什么，以及文件在却播不出来的情况，见「Audition（试听）」章。

数据库与备份

数据库与快照的状态在这里。自动快照的频率、份数与体积上限，还有手动防线，见「How safe your data is（你的数据有多安全）」章。

The screen map（界面分区）

Catalog 的主界面分成四块：上面一条工具栏、左边侧边栏、中间卡片墙或列表、右边 Inspector。

2.1 工具栏

工具栏最左边那个滑块图标是设置菜单，它管四件事：

• 外观：主题（见「Appearance（外观）」章）
• 工具栏设置：preset 与逐项自定义（见「Collections, smart folders, tags and the toolbar（收藏集、智能文件夹、标签与工具栏个性化）」章）
• 工具显示方式：图标不带名字，或者图标加名字
• 重新打开手把手教学（共 25 步），以及危险区域里的删除整个 Catalog 数据库

滑块图标右边才是各种工具按钮。工具栏默认不会显示全部 28 个工具，所以你在手册里看到某个按钮、界面上却找不到，多半是被当前 preset 藏起来了。到设置菜单选完整工具就会全部出现。

2.2 搜索框与搜索选项

工具栏下面那条是搜索工作台。左边是搜索标签页，中间是搜索框，右边有一个搜索选项可以展开／收起。展开后里面有：

• 历史：你最近打过的查询
• 字段 preset：搜索结果表格要显示哪几列
• 本机搜索语言包：纯本机的搜索词对照，选了不会自动开启翻译
• 锁定当前结果，把这批结果冻结成子集
• 声音 facets，本机声音特征筛选
• 收藏集筛选，只看某个收藏集里的母带

搜索框在任何时候按 ⌘K 都会跳回来并全选。按 ⌘T 开一个新的搜索标签页。

2.3 侧边栏

侧边栏由上而下分成五区：

1. 曲库：八个自动计算的分类（下一段细讲）
2. 收藏集：你手动放进去的一袋母带
3. 已保存搜索／智能文件夹：存起来的查询条件
4. 来源：你登记过的来源文件夹，以及每一个的在线／离线状态
5. 标签：你自己建立的分类轴

最下面的 footer 会写本机数据库的版本号，那是数据库的 schema 版本，反馈问题时附上很有帮助。

曲库的八个分类是实时算出来的，不是你手动维护的清单：

2.4 卡片墙与列表

中间区域有两种看法，用工具栏的 Grid／List 切换：

• Grid 是卡片墙，适合看封面与快速扫视。
• List 是表格，适合一次横向比较很多技术字段。

两边的选中状态是共用的，切过去不会丢。

卡片下缘那排小标签是这个文件的技术指纹：对象数、采样率与声道配置、Downmix Trim 状态、是否就绪。标题如果不是从 ADM 读来的，会多一个文件名或人工的小标。封面右上角会浮出离线、文件损坏，以及 EXACT、CAND、NEAR 的重复徽章。

2.5 Inspector 三个标签页

右边的 Inspector 要先选中一张母带卡才有内容。它有三个标签页：

• 摘要：标题与艺人、版本覆盖、解析问题（如果有）、交付规格 metadata、Catalog metadata 字段、标签、ADM 响度摘要
• ADM 结构：这个文件的 ADM 对象树。每种 entity 有显示上限，完整内容请看下一个标签页
• 原始 XML：ADM 的 axml 原文，可以直接下载成文件

Sources and scanning（添加来源与扫描）

3.1 选文件夹

按工具栏的选择来源文件夹（空白界面上也有一个大的），挑一个装着 ADM BWF／WAV 的文件夹。macOS 弹权限就授权。

扫描开始后：

• 它只读 header 与内容指纹，不解码音频。
• 它不会移动、改名或改写任何文件。
• 完成时会告诉你扫了几个 WAV、导入几条 ADM 母带、跳过几个。

也可以用工具栏的导入 ADM／BWF 直接选一个或多个单文件。

3.2 来源健康度的五个数字

打开工具栏的来源健康度，每个来源文件夹都有五个关键数字：

这里最容易误判：**非 ADM（跳过）**有几百上千条完全正常，那些是 stems、sidecar、普通立体声文件，它们本来就不该进库，也不代表扫描只扫了一半。真正要归零的是前四个，四个都是 0 才叫干净。

另一个常见误会：「我看到 200 条母带了」不等于整块盘扫完了；某个来源显示在线也不等于里面每个文件都读得到。以五个数字为准，不要以卡片数量为准。

3.3 针对问题重新扫描

健康度面板里有一个针对问题重新扫描的按钮。它只重试已知的问题路径，上限 256 条，不会假装重扫整块盘。修完权限、NAS 重新连上之后按它最有效率。

面板里还可以把问题清单导出成 JSON 或 CSV，以及把扫描记录导出成 JSON 或 CSV。这两份是你反馈问题时最有用的东西。

3.4 什么时候该按重新扫描

工具栏的重新扫描是整批重走一次 header scan。下面这些情况按它：

• 文件夹内容在 Catalog 外面被改过（加了文件、换了目录）
• NAS 或移动硬盘重新连上
• 健康度出现受阻，而你刚刚修好权限

日常不用一直按。Catalog 本来就有 watcher 在盯你登记过的来源。

3.5 移动硬盘与 NAS 掉线的时候

拔掉移动硬盘或 NAS 断线时，那些母带不会消失，它们会变成离线。离线的意思是「文件现在读不到」，不是「文件没了」。

• 卡片会浮出离线徽章，侧边栏的离线／丢失会把它们集中起来。
• 离线的文件不能试听，也不能跑交付检查。这是诚实状态，不是 bug。
• 重新接上之后按重新扫描，Catalog 会用内容指纹把它们对回去。它认内容不认磁盘 UUID，所以换一个 USB 口、换一台 Mac 接同一块盘，都能对回原来那条。

工具栏的外接盘诊断打开的是外接硬盘诊断面板，可以看每块盘的卷名、授权书签状态与 watcher 状态。卡住的时候先看这里。

3.6 NAS 与整块工作盘

直接把整个 NAS share 或整块工作盘登记成来源，扫描会连 session、快照与回收站的文件夹一并走进去，跑很久却只入库几个母带。只登记放 ADM 母带的那个文件夹；躲不开的 session 或快照文件夹，把它们的目录名称加进排除名称即可。

NAS 机器自己写的快照与回收站目录（例如 @Recently-Snapshot、@Recycle、.snapshot）Catalog 默认就会跳过，不需要你另外排除。

Search（搜索完全指南）

搜索是 Catalog 用得最狠的功能，值得花十分钟把语法看完。

4.1 基本规则

• 直接打字＝全文搜索。
• 加冒号＝字段查询，例如 title:mix。
• 空格等于 AND。artist:kaya title:mix 两个条件都要成立。（AND 这个词打出来会被忽略，因为空格已经是 AND。）
• OR 大写小写都行，用空格隔开：artist:a OR artist:b。
• NOT 否定紧跟着的那一个条件：NOT is:offline。
• 在条件前面加减号 - 也是否定：-is:offline。
• 值里有空格就用引号包起来：artist:"Artist 007"。
• 大小写不敏感。
• 你打进去的原始字符串永远留在界面上，app 怎么解读你的输入是透明的。
• 结果默认按导入时间由新到旧排序。

4.2 字段键一览

下面每一个都是可以直接打的字段键。斜线隔开的是同一个字段的别名，用哪个都一样。

打错字段名不会报错，它会悄悄退回成全文搜索。所以搜不到东西时，先确认字段名有没有拼错。

4.3 is: 可以填什么

is: 和 status: 是同一个东西，可以填：

• offline／missing：文件当前读不到
• online／ready：文件读得到
• manual：有人工填过的字段
• unknown：关键字段还没有值
• unassigned-album／unassigned／missing-album：还没有 album metadata
• unparsed：解析不出来
• corrupt：文件结构损坏
• unreadable：读不到
• permission／permission-denied：权限被拒
• final／mastered：版本标签是完成版

4.4 重复类的写法

重复有两种写法，效果一样：

• is:duplicate、is:exact、is:exact-duplicate、is:candidate、is:candidate-duplicate、is:near、is:near-duplicate
• duplicate:any、duplicate:exact、duplicate:candidate、duplicate:near

三级的意思见「Versions and duplicates（版本与重复）」章。

4.5 数值比较：不要加冒号

这是整份手册最容易踩的一条，请务必记住。

数值字段要做「大于、小于、不等于」的时候，比较符号直接接在字段名后面，中间不能有冒号：

objects>8          对象数大于 8
sr>=48000          采样率大于等于 48 kHz
ch!=12             声道数不等于 12
duration<180       长度短于 3 分钟
bit>=24            位深 24 以上

支持的符号是 >、<、>=、<=、!=。

写成 beds:>0 是无效的。 只要出现冒号，Catalog 就把后面整串当成「要完全等于这个值」，而没有任何一条母带的 bed 数量会等于字符串 “>0”，所以这个查询永远是零条结果，而且不会给你任何错误提示。同理 objects:>8、sr:>=48000 也都是零条。要比大小就写 beds>0、objects>8、sr>=48000。

用冒号的时候只有「等于」一种意思：objects:8 就是对象数刚好 8，这是对的写法。

4.6 搜索标签页与历史

⌘T 开新标签页。每个标签页各自记住自己的查询、分类、字段 preset 与视图模式，适合「一边查交付清单、一边查重复」这种并行工作。

搜索选项展开后的历史下拉菜单会列出你最近打过的查询，选一个就套用。

4.7 字段 preset

搜索结果的表格要显示哪些列，由字段 preset 决定。内置四个：

• 曲库总览：标题、艺人、版本、技术、健康
• 交付复核：标题、艺人、版本、来源、技术、审核
• 整理工作：标题、艺人、标签、健康、审核
• 聆听与使用：标题、艺人、来源、技术、使用

你也可以自己勾要哪几列，然后在**另存字段 preset…**里打一个名字存起来。

4.8 语言包

本机搜索语言包是纯本机的词汇对照表，让你用另一种语言的词去搜中文或英文的字段。选了语言包不会自动开启翻译展开，那是另一个开关。它不联网。

4.9 锁定结果

锁定当前结果，就是把这一批结果冻结成一个子集，之后所有的缩小都在子集里进行，不会偷改你原本的查询。适合「从 200 条里先挑出 20 条候选，再继续筛」的工作流。再按一次解除锁定。

4.10 声音 facets 的边界

声音 facets 是一个 opt-in 的工作区：按一次分析，它会对当前结果里最多 32 条做本机声音特征计算，然后让你用 RMS 与高频段比例去筛。

它的边界要说清楚：

• 没被分析到的、离线的、读取失败的，不会被猜成符合。
• 它不会偷偷重排你的结果。
• 它算的是本机 proxy 数值，不是「明亮度」这种主观判断，更不是交付合格与否的裁决。
• 缓存只留衍生数值，不含音频，也不会改 ADM／WAV。

4.11 收藏集筛选与导出搜索证据

搜索选项里可以指定一个目标收藏集，把当前选中的母带整批加进去，也可以只看某个收藏集里的结果。

同一区有一个导出按钮，可以把这次搜索的证据（查询字符串、结果、来源绑定）导出成文件。要跟别人解释「我是怎么挑出这批的」时用它。

Inspecting one master（查看一条母带）

选中一张卡片，右边 Inspector 就会带出这个文件的全部细节。

5.1 摘要标签页由上而下

标题与艺人：最上面是显示用的标题与艺人，旁边那行小字写着它是从 ADM 读到的、还是从文件名猜的。下面那串是这个文件在你硬盘上的完整路径，复制出去就能粘进 Finder 或终端。

版本覆盖：同一首曲子有多个导出时，Catalog 会按名称自动归成一组。名称不规则导致分错组时，用这两个字段手动指定版本标签与分组键；留空就恢复自动分组，不会留下残影。

交付规格 metadata：两行，两行都不是猜的。

• Downmix Trim：显示 Auto 或 Manual，值是从 Dolby 私有的 dbmd chunk 读出来的。
• Binaural Render：显示 Off、Near、Mid 或 Far。优先读 ADM axml 里的 binauralRenderMode；axml 没写的时候才退回去读 dbmd。

两行都可能显示灰色的来源未记录。Binaural 那一行在有空间的地方会写得更完整：来源未记录（ADM 与 dbmd 都没有写）。这句话的意思是「这个文件的 header 里本来就没写这个字段」，不是 Catalog 读不到，也不是交付风险。它是灰色的，因为它不是坏消息。

Catalog metadata 字段：这一区是你自己填的事实，跟扫描读到的来源字段分开存、分开显示可信度。规则如下：

• 你手动保存的字段会自动锁定并记成 100％ 置信度。
• 锁定之后，metadata 导入、离线 metadata 助手、封面匹配都不会覆盖它。
• 点字段旁边的徽章可以解锁；解锁之后那些来源才写得进来。
• 百分比是这个值的来源置信度：从 ADM 读到的是 90，从文件名猜的是 70，人工填的是 100。

标签：标签跟 ADM 里的任何字段都无关，适合放项目代号、客户或进度这种只有你懂的分类。标签在侧边栏建立，在 Inspector 里勾给单条母带。它只存在这台 Mac 的 overlay 数据库里，不会写回音频文件。

ADM 响度摘要：这张卡列出 Programme 数量、Bed 数量、Object 数量、集成 LUFS、True Peak、响度范围。

响度这部分要特别说明：header scan 本身不测量响度，所以刚扫进来的时候集成 LUFS、True Peak、响度范围都是未测量。但你一选到这张卡，Catalog 就会在后台自己测一次，中途你会看到分析中。停在未测量通常代表两件事之一：文件离线读不到，或者测量超时了。

卡片下方的用 Delivery Gate 测量此文件，是把这个文件直接带进交付检查，顺便留下一份正式报告。

5.2 ADM 结构标签页

这里是这个文件的 ADM 对象树。为了不让界面爆掉，每种 entity 有显示上限，超过时会提示你完整来源仍可从原始 XML 取得。

5.3 原始 XML 标签页

ADM 的 axml 原文。有一个下载按钮可以把它存成文件，拿去跟别人对规范时很好用。

Versions and duplicates（版本与重复）

6.1 三个等级

Catalog 把「这两个文件很像」拆成三个严格程度不同的等级，因为它们该有的处理方式完全不同：

Catalog 永远不会自动删文件。 这三个等级是给你判断用的证据，删除永远是你在 Finder 里的决定。

6.2 离线成员与上次已知

NAS 拔线的时候，exact 分组不会把离线成员藏起来，它会保留并标成上次已知。这句话的意思很精确：离线之前，这几条的完整文件内容相同，不是声称它们现在还相同。

上次已知的 hash 只当提示用。交付检查与 Release 工作区一律不采信它。重新连上并重扫之后会自动重新验证，标记消失才算回到「已验证相同」。

6.3 比较版本

选中一条母带后，工具栏的比较版本会把同一个版本组的成员并排。可以比 object 名称、XYZ 位置、gain、keyframe 这些技术差异。

响度不在版本比较里。header scan 不测量响度，比较面板会诚实显示未测量。要比响度就对两个版本各跑一次交付检查。

6.4 重复证据工作区

从侧边栏的重复／候选进去，就是重复证据的工作区。三个等级分开列，每一组都可以整组选中，也可以把整份证据导出成 JSON 或 CSV。

Audition（试听）

7.1 打开 Quick Look

选中一张卡片后按 Space（焦点不在输入框、按钮、滑块上的时候），或者把鼠标移到卡片上，封面下缘浮出的那排小按钮里也有试听。

Quick Look 里有：

• 波形：可以直接拖动定位
• 播放／暂停
• 循环播放
• A／B 循环：在同一个文件里设 A 点与 B 点，反复听那一段。设好之后还可以把这个片段连同备注与来源 fingerprint 一起存成证据，并导出 JSON。它永远不会编辑或复制音频。

7.2 你听到的是 Stereo Downmix

初次播放会提醒你一次：您听到的是 Stereo Downmix，不是 Atmos 渲染；音质评估请以原文件环境为准。

这句话请认真看待。Quick Look 是用来确认「这是不是我要的那个文件」与做 A／B 定位的，不是用来下音质判断的。真正的空间音频监听在 Player Pro 与 Audiophile。

7.3 文件在，不等于播得出来

Quick Look 会分开显示文件存在与可播放。NAS 离线的时候文件「在目录里」但播不出来，这是诚实状态。

7.4 按声音查找相似

卡片浮出的那排小按钮里，第一个是按声音查找相似，工具栏上也有同名的按钮。它拿这个文件的声音与技术特征去找像的，结果一样是候选，不是结论。

7.5 试听清单

工具栏的试听清单可以把要听的母带排成一张清单，一边听一边评分与写备注。适合「这批交件前我要全部听过一次」的场景。

Albums and releases（专辑与 Release）

8.1 专辑浏览

从侧边栏的专辑进去，Catalog 会按 album 与 artist 把母带分组，列出曲目、版本与离线状态。

每个专辑卡上有一块不可编辑的技术摘要：采样率、位深、声道配置、总时长，以及格式是否一致。它明确标示：只读摘要；不代表 loudness delivery pass，也不会改写来源文件。

没有 album metadata 的母带会被收进未设定专辑那一组，可以先浏览曲目，再到 Inspector 补上。要用搜索抓出它们就打 is:unassigned-album。点进某个专辑就会回到可追溯的 album: 字段搜索。

8.2 读取响度

专辑卡上有一个读取响度。它读的是已经缓存的响度证据，不会去启动整文件重新测量，所以很快。有些曲目还没测过的时候，它会诚实告诉你可用数据不足，而不是给你一个凑出来的平均值。结果可以导出 JSON 或 CSV。

8.3 Release 工作区

工具栏的 Release 工作区处理的是交件层级的结构：Release、Recording、Master 与版本的层级，曲序，UPC 与 EAN。每个 track 指派都绑定来源 fingerprint。

8.4 Release 连续试听

Release 工作区里可以把整张 release 连着听过去，上一首、下一首、暂停都在同一排。这里有一条硬规则：来源离线、路径不可用，或者来源 fingerprint 已经变了的时候，试听会直接停在 Catalog 边界，并告诉你原因，不会播一个它不确定的文件给你。

Delivery Gate（交付检查）

这是整个 app 最重要的一步：它把「我觉得应该没问题」换成「有证据说没问题」。

9.1 五个配置

目前有五个可追溯的平台配置，名称逐字如下：

• Apple Spatial Audio
• Amazon Music HD (Atmos)
• TIDAL (Atmos)
• UMG Delivery (Atmos)
• Sony Music (Atmos)

每个配置背后都有可以指出来源的规范文件。Catalog 刻意不猜测没有规范依据的平台。

9.2 四种状态

报告的每一行有一个状态：

跳过绝对不等于通过。 面板下方写得很清楚：跳过代表证据不完整，整体结果不会通过。所以一份满是跳过的报告不是好消息，是「这个文件还没被真的验过」。

即使整体显示通过，仍然要结合证据等级与来源 fingerprint 判读。

9.3 证据等级只在六行

报告里有一列叫证据等级，值是 confirmed 或 advisory：

• confirmed：有官方规范文件依据，违反了就是硬伤。
• advisory：行业惯例或建议阈值，违反了只会给你注意。

证据等级只出现在受配置管的那六行，其余的行会显示破折号。看到破折号不是缺漏，是「这一行本来就不在当前配置的管辖范围内」。

9.4 表头那一排

每份报告的表头有五格：

• 来源 fingerprint：这份报告绑在哪一个确切的文件上
• QC 规则：用的是哪个版本的规则
• 分析依据：响度是用什么基准测的
• 格式探测：采样率、位深、声道数、对象数
• Binaural：这个文件的 binaural 模式分布，以及那个值是从哪里读来的

来源 fingerprint 是整份报告的锚。同一个文件内容改过，fingerprint 就变了，旧报告自然就不能拿来当这一版的证据。

9.5 导出

报告右上角可以导出 CSV 或 HTML。HTML 那份是可以直接发给客户看的完整表格。

9.6 一次跑一批

从 Inspector 底部那个按钮跑，是对这一个文件跑。从工具栏的交付检查跑，是对当前筛选出来的母带整批跑，最多 32 条。所以先用搜索把要验的那批筛出来，再按工具栏那个按钮。

大容量移动硬盘或 NAS 来源可能需要时间。安全关闭窗口不会中止作业，也不会丢失进度。

Metadata（整理 metadata）

10.1 Metadata 规则

工具栏的 Metadata 规则是批量改字段的地方。可以做的动作包括去掉首尾空格、合并多余空格、转换大小写、Unicode 规范化（NFC）、规范化 ISRC、规范化 Catalog 编号、正则提取与正则替换。

流程永远是同一条：预览 → 看冲突 → 套用 → 可以撤销。预览会逐条告诉你每一条是可套用、冲突、错误、跳过还是未变更；确认没问题再套用；套用后留下 receipt，随时可以整批撤销。

10.2 CSV／XLSX 导入

工具栏的导入 metadata 走的是同一条安全流程。它分四步：选取文件、映射字段、预览、结果。

匹配母带的方式有五种可以选：Master ID（完全匹配）、路径（已规范化）、文件名（不分大小写）、ISRC（已规范化）、Catalog 编号（去空格＋小写）。

面板里有一份导入记录，是不可编辑的历史，已经撤销的批次也会保留在里面。原始 ADM／WAV 的 bytes 不会出现在这份记录里，因为它们根本没被动过。

10.3 离线 metadata 助手

工具栏的离线 metadata 助手产生的是不联网的 metadata 候选。它只看你本机已经有的东西。产生出来的是候选，明确接受之前不会生效。

10.4 分类候选与受控词表

工具栏的分类候选是受控词表的工作区。它加载一份分类 pack，pack 里带着多个 schema profile（字段范围不同）；换 profile 之后要重按生成候选，已有候选会保留原本的 profile 来源标记。

候选有六种状态：待处理、已接受、已拒绝、冲突、已套用、已撤销。套用被挡下来的时候它会告诉你为什么，例如候选生成后来源 fingerprint 已变更，或者来源目前丢失；请先修复或重新链接，再套用。

导出的词表 pack 带版本号，而且会注明它仍是本机 crosswalk，不代表官方 UCS。

10.5 封面候选

工具栏的封面候选列出本机找到的 artwork 候选，一样是先看再逐条采用。也可以直接把图片文件拖到卡片上换封面。封面存在 Catalog 的 overlay 里，不会写进音频文件。

Review, handoff and export（审核、交接与导出）

11.1 审核

工具栏的审核是逐字段核准的地方。核准记录会进入证据，之后交接时一起带走。

11.2 交接中心

工具栏的交接中心交出去的是路径与清单，不是媒体。它先验证来源，然后给你几条路：

• 在 Finder 中显示
• 交给 Player
• 交给 QC
• 生成 DAW 的 spotting manifest（绑定来源 fingerprint）
• 生成证据包：manifest ＋ 审核证据 ＋ anchors ＋ BLAKE3 checksums。里面内嵌的路径已经把你的用户目录遮蔽掉。之后可以用用路径验证证据包随时重验。

验证结果有五种：已验证、来源丢失、来源已变更、权限不足、待验证。来源已变更的意思是文件内容跟当初留证据的时候不一样了，这时候就不该把旧证据当成这一版的证据。

11.3 导出

• 复制路径：把当前选中来源的完整路径复制到剪贴板。
• 在 Finder 中显示：直接跳到 Finder 里那个文件。
• 导出 Catalog 报告：把当前这个视图的 metadata 导成 CSV。
• 导出交付清单：把当前这个视图导成交付清单。

导出目的地如果落在已经登记的来源文件夹里面，Catalog 会弹出警告要你再确认一次。它不会改写已有文件，但来源盘本来就应该保持干净。

11.4 DAMF／IMF-IAB 检查

工具栏的 DAMF／IMF-IAB 检查只读不写，检查的是交换格式本身。请注意它的定位：通过它不代表交付合格。交付合格与否请看「Delivery Gate（交付检查）」章。

11.5 DDEX ERN 桥接

工具栏的 DDEX ERN 桥接可以预览 DDEX ERN 交换数据，供你跟发行方对接时参考。

Collections, smart folders, tags and the toolbar（收藏集、智能文件夹、标签与工具栏个性化）

12.1 收藏集

收藏集是你手动放进去的一袋母带，适合「这次要交的十首」这种清单。先在中间选中，再到侧边栏建立或加入。删掉收藏集不会删到任何文件，也不会动到数据库里的母带本身。

12.2 已保存搜索与智能文件夹

这里把你当前的搜索条件或整个视图存成一个常驻入口，重开 app 还在。它存的是条件不是结果，所以之后新扫进来、符合条件的文件会自己出现。配合锁定结果就是你自制的工作队列。

12.3 标签

标签在侧边栏建立，在 Inspector 里勾给单条母带。它是你自己的分类轴，跟 ADM 完全无关。

12.4 工具栏 preset

设置菜单（工具栏最左边的滑块图标）里有五个 preset：

在自定义工具区逐项勾选之后，preset 名称会变成自定义工具栏，以你刚才所在的 preset 为起点。

面板右上角有一个重置按钮，按下去会回到日常工作。

12.5 工具显示方式

同一个菜单里的工具显示方式有两个选项：

• 图标不带名字：省地方，鼠标划过或用键盘聚焦时会出 tooltip。
• 图标＋名称：每个按钮旁边都写着中文名字。初次使用或做 demo 的时候强烈建议切到这个，因为有几个图标长得很像。

12.6 二十八个工具速查

Appearance（外观）

设置菜单的外观区有十个选项：九个主题加上跟随系统。

第十个选项是跟随系统，它会随 macOS 在 Daylight 与 Midnight 之间切换。跟随系统就是默认值。

主题是这台 Mac 上的个人偏好，跟 catalog 数据完全无关，换主题不会动到任何一条母带。前八个主题与 Player Pro 使用同一组配色；Studio 与 UTUVO Monitor 的 Studio 主题使用同一组配色。

How safe your data is（你的数据有多安全）

14.1 原始音频文件

永远不写。 这一条没有例外。扫描只读 header 与内容指纹，交付检查只读，试听只读，导出只写到你自己选的目的地。

14.2 overlay 数据库

你在 Catalog 里做的所有事，都存在一个 SQLite 数据库里，位置在 app 自己的数据目录。数据库恢复面板顶端就会告诉你，自动快照存在本机 app 目录，而且不含原始媒体与 artwork。

这个数据库是你唯一无法重建的资产：母带可以重扫，指纹可以重算，但你手动填的 metadata、核准记录与 release 结构只存在这里。所以它有两层保护。

14.3 自动快照

Catalog 每 10 分钟自己做一次 rolling 快照，保留最近 10 份，总量上限 4 GiB，超过就从最旧的开始淘汰。状态在数据库恢复面板顶端一目了然，包括最近一次的时间、有没有通过完整性验证，以及最近一次失败的原因（如果有的话）。

自动快照存在本机 app 目录，不含原始媒体与 artwork。它只是数据库的还原点，不是你的母带备份。

14.4 手动防线

工具栏的数据库恢复或保存数据库都会打开同一个面板，里面有三个按钮：

• 保存整个数据库：另存一份完整的 SQLite 状态。
• 从 SQLite 快照恢复：先验证单文件快照，再恢复。
• 建立恢复套件：SQLite ＋ manifest ＋ checksum。

恢复有一条铁律：一律恢复到新的或空的文件夹。Catalog 不会覆盖当前使用中的数据库，不会偷偷切换正在运行的 app，也不会把物理离线的来源盘说成已经恢复。

面板下半部有保存与恢复的历史记录。

14.5 危险区域：删除整个数据库

设置菜单最下面的危险区域里有删除整个 Catalog 数据库…。它要走三页确认：

1. 第 1 页（步骤 1 / 3）：告诉你会删掉什么（母带条数、审核记录、交付检查快照…），以及不会动到的部分：原始音频文件、NAS 与移动硬盘、自动快照目录。
2. 第 2 页（步骤 2 / 3）：确认你手上有快照。删除前它还会再留一份。 万一数据库已经损坏到做不出最终快照，它会直接说出来，并要你勾选我了解这次删除不会留下任何快照才能继续。
3. 第 3 页（步骤 3 / 3）：要你输入当前的母带数量当确认码，数字就写在旁边。按下永久删除之后就无法在 app 内撤销，只能从快照恢复。

14.6 不联网

Catalog 默认不联网。在线查询是双层 opt-in，默认关闭。

Keyboard shortcuts（快捷键一览）

Frequently asked questions（常见问题）

Q：刚开 app，母带都在了，但来源那一区写着来源健康度正在加载。 正常。Catalog 先把上次存下来的母带缓存显示给你，来源状态在后台探测。等一下就会出现，不是来源丢失。

Q：我明明扫了整块盘，数字却对不上。 先看来源健康度的五个数字。非 ADM（跳过）那一栏有几百上千条是正常的，那些本来就不该进库。真正要归零的是待处理、受阻、错误、未解析。

Q：移动硬盘换了一个 USB 口，全部变离线。 Catalog 用内容指纹认文件，不认磁盘 UUID。重新授权那块盘再按重新扫描就会全部对回去。

Q：beds:>0 搜不到东西。 那个写法本来就不会动，见「Search（搜索完全指南）」章的比较式一节。要写 beds>0。

Q：响度一直是未测量。 选中卡片后 Catalog 会在后台测。如果一直长时间未推进，多半是文件离线，或测量超时。可以按用 Delivery Gate 测量此文件强制跑一次。

Q：Downmix Trim 写着来源未记录，是不是我的文件有问题？ 不是。那代表这个文件的 header 里本来就没写这个字段。它显示成灰色就是为了让你知道它不是坏消息。

Q：交付检查整份都是跳过，算通过吗？ 不算。跳过代表证据不完整，整体结果不会通过。要看到实质项目显示通过才有意义。

Q：可以让它帮我删重复文件吗？ 不可以，也不会。重复面板给你证据，删除是你的决定。

Q：两台 Mac 可以共用同一个 catalog 吗？ 目前不行。各自建自己的 catalog，靠证据包交换结论。

Q：试听听起来不像 Atmos。 没错，那是 Stereo Downmix。空间音频监听请用 Player Pro 或 Audiophile。

Q：我把工具栏弄乱了。 设置菜单面板右上角有重置按钮，按下去回到日常工作。

Q：我不小心把 Catalog 数据库删了。 自动快照目录不会被删库动到，从数据库恢复的从 SQLite 快照恢复恢复到一个新文件夹即可。原始音频文件一直都在。

Glossary（术语表）