FAQ：macOS（Finder）标签机制与本应用的实现说明
1. macOS 的标签（Finder Tags）是什么？存在哪里？
Finder 标签属于文件的元数据，不写入文件内容本身，而是写在文件的扩展属性（xattr）里，主要键名是：
com.apple.metadata:_kMDItemUserTags
其内容是一个二进制 plist，本质上是“标签数组”。每个标签元素包含标签名与颜色编号，颜色编号范围 0–7（0 无色，1 灰，2 绿，3 紫，4 蓝，5 黄，6 红，7 橙）。
因此：
- “给文件打标签”这件事，本质是“把标签元数据写入 xattr”；
- 与是否能被 Spotlight 搜索到是两回事。
2. 关于旧扩展属性 com.apple.FinderInfo
com.apple.FinderInfo 是较早期 macOS/Finder 的机制之一：
- 旧机制：它只能表示一种颜色，且不包含标签名称。
- 新系统仍可能写入：即使现在主要以
_kMDItemUserTags为准，Finder 仍可能同时写入/更新com.apple.FinderInfo（用于兼容旧系统）。
更具体地说：
- 仅当文件的某个标签名称存在于 Finder 的自定义标签列表中时，Finder 才可能写入/更新
com.apple.FinderInfo的颜色信息； - 当存在多种颜色标签时，会写入“有效列表中最后一种颜色”的那一个。
3. 多语言问题：为什么同一个颜色在不同语言系统会变成“不同标签”？
macOS 写入的是本地化后的标签名称字符串：
- 英文系统写入
Red - 中文系统写入
红色
它们在系统看来是两个不同标签。 本应用通过系统 API 获取默认颜色标签名称，因此返回结果会受系统语言环境影响（“系统设置 → 通用 → 语言与地区 / 界面语言”，选择“自动”时跟随当前系统语言）。如果系统语言与应用语言不一致，就可能出现标签名称不一致。
4. 为什么应用设置中要和 Finder 的标签配置保持一致？
- macOS 限制下，应用通常无法完整读取 Finder 的“自定义标签名称↔颜色”配置列表。
- 读取标签时，系统 API 往往只给“标签名称”，不直接给颜色；若应用未配置该名称对应颜色，颜色显示可能不正确。
- 写入标签时，系统 API 也通常只传“标签名称”，最终颜色由 Finder 对该名称的定义决定。
5. 标签元数据在不同磁盘/网络位置如何保存？（APFS / AppleDouble / NTFS ADS）
5.1 APFS（本机磁盘）——原生保存 xattr（最可靠）
APFS 原生支持扩展属性，标签元数据直接保存在文件自身的 xattr 中。
5.2 不支持/不完整支持 xattr 的位置——AppleDouble（._原文件名）
当目标文件系统或协议无法可靠保存 xattr（常见于 FAT32、exFAT、网络驱动器：SMB/WebDAV/NFS 等），macOS 会把元数据存到 AppleDouble 伴随文件：
._原文件名（例如photo.jpg对应._photo.jpg）
可见性：
- Finder 永不显示（即使开启显示隐藏文件也无法看到）；
- 终端
ls -la可见； - Windows 开启显示隐藏文件可见（因此会看到很多
._小文件）。
重要提示（标签“丢失”的常见原因）：
- 如果你在 Windows 或某些工具中移动/复制文件时只移动了原文件，把
._文件留在原地，那么到新位置后标签会“看起来消失”。 - 只要之后把匹配的
._文件也移动过去，标签通常可以恢复。
5.3 SMB 连接 NTFS：可能使用 ADS（可选数据流）
当通过 SMB 访问 NTFS 且满足服务端/协议配置条件时，macOS 可能不生成 ._ 文件，而是把元数据写入 NTFS 的 ADS（Alternate Data Streams，可选数据流）：
- ADS 是 NTFS 的特性：一个文件除了“主数据”，还可以附带若干“看不见的附加数据流”，用来存放额外元数据。
- 好处：在 NTFS 内部移动/复制时，这些元数据通常能一起保留，对 Windows 用户也相对“干净”（不产生
._文件）。
但注意：
- 当你把文件从 NTFS 移动/复制到 FAT32 或 exFAT时，目标文件系统不支持 ADS/xattr 这类元数据，Windows 往往会弹出类似提示：
“确实要在不复制文件属性的情况下复制文件？” 这表示这些附加元数据将被丢弃；拷过去后标签可能无法保留。
6. 如何查看文件的标签 xattr？
命令行 xattr 不方便：它不支持处理/显示 com.apple.metadata:_kMDItemUserTags 这类二进制 plist属性，必须使用 -px 选项以十六进制方式才能正确输出。
建议使用第三方工具：
- xattred：可直观查看并验证
_kMDItemUserTags、com.apple.FinderInfo等 xattr。
7. Spotlight 与标签是什么关系？标签是否依赖 Spotlight？
- 标签本身不依赖 Spotlight：标签在你打上的那一刻就已写入文件的 xattr，是否被索引不影响标签“存在与否”。
- Spotlight 只是索引引擎：它负责把标签名称等元数据建立索引，用于系统级搜索。
- macOS 通常会在文件移动/重命名等操作后自动维护索引；但外置盘、网络盘、以及被加入“搜索隐私”的目录可能不会被 Spotlight 索引。
8. 本应用的“增强索引”做了什么？
当 Spotlight 无法覆盖（外置盘/网络盘/隐私排除目录等）时，本应用提供增强索引：
- 你在应用内浏览文件夹时，应用会记录该文件夹内文件的标签信息；
- 你在目录树选择查看某个标签的全部文件时，应用会在 Spotlight 结果基础上补充展示增强索引命中的文件；
- 可在文件夹上右键选择“扫描并更新”来刷新该文件夹中内容的标签索引。