Mac快捷指令可主动触发联系人同步，弥补iCloud延迟与功能盲区，支持vCard自动备份、选择性还原及Automator联动处理结构化数据。
Mac 上用快捷指令实现联系人信息的自动化同步，核心是绕过 iCloud 的被动等待机制，主动触发、精准控制、跨设备联动。它不替代 iCloud 同步，而是补足其延迟、覆盖盲区（比如仅同步某群组、带条件过滤、或与第三方服务对接），真正让“同步”变成可调度、可验证、可扩展的动作。
iCloud 同步是基础，但不是全部
iCloud 通讯录同步本身是双向实时的，但实际体验中常有 1–5 分钟延迟，且无法按字段筛选、不能跳过重复项、也不支持添加时间戳或日志记录。快捷指令不能改变 iCloud 底层行为，但可以作为“协调器”：在 iCloud 同步完成后，自动执行校验、归档、导出或通知操作。
- 确保 Mac 和 iPhone 都已开启 iCloud → 通讯录，并使用同一 Apple ID（含双重认证）
- 关闭 Mac 系统设置中「优化 Mac 储存空间」，避免联系人被替换成占位符，影响后续脚本读取
- 首次启用后，手动在 Mac「通讯录」App 中下拉刷新一次，确认基础数据已就位
用快捷指令自动导出/备份联系人到 iCloud 云盘
这是最稳定、最易验证的同步增强方式：将当前通讯录导出为 vCard（.vcf），保存至 iCloud 云盘指定文件夹，所有登录同一 Apple ID 的设备都能立即看到该文件，且支持版本历史回溯。
- 新建快捷指令，添加「获取所有联系人」→「将联系人导出为 vCard」→「存储文件」
- 「存储文件」目标路径设为：
~/Library/Mobile Documents/com~apple~CloudDocs/Backups/Contacts/contacts_$(date +%Y%m%d_%H%M).vcf - 添加「显示通知」操作，内容为“联系人已备份至 iCloud，共 $(count) 条”
- 可设为个人自动化：例如“每天上午 9 点”或“iPhone 解锁后 5 分钟”，实现无人值守备份
从 iCloud 云盘 .vcf 文件一键还原/合并联系人
当需要在新 Mac 或重装系统后快速恢复联系人，或想把某个备份版本“选择性合并”进当前通讯录（而非全量覆盖），快捷指令能一步完成：
- 新建快捷指令，添加「选取文件」→ 过滤类型为 vCard（.vcf）→「导入联系人」
- 关键设置：勾选「合并现有联系人」，避免重复创建；取消勾选「替换已有联系人」，防止误覆盖
- 可配合「访达快速操作」：右键任意 .vcf 文件 → 快速操作 →「导入为联系人」，无需打开快捷指令 App
- 若需过滤，可在「获取所有联系人」后加「过滤联系人」操作，例如只导入公司邮箱不为空的条目
快捷指令 + Automator 工作流联动处理结构化数据
单纯同步原始联系人不够时（比如要提取手机号生成 Excel、按标签分组发邮件、或同步到 Notion），可用快捷指令调用本地 .workflow 文件，发挥 AppleScript 或 shell 脚本的处理能力：
- 先在 Automator 中创建工作流程：「获取所有联系人」→「运行 AppleScript」（写一段提取姓名+电话的脚本）→「导出为 CSV」
- 将该 .workflow 文件保存到 iCloud 云盘 /Workflows/ContactTools/ 文件夹
- 快捷指令中添加「运行 Automator 工作流程」→ 从 iCloud 云盘选取该文件
- 运行后，CSV 自动保存到 iCloud 同步路径，iPhone 上 Numbers 或 Excel 可直接打开编辑
不复杂但容易忽略：所有涉及文件路径的操作，必须确保「访达」中已开启「iCloud 云盘」和「桌面与文稿文件夹」同步，否则 ~/Library/Mobile\ Documents/ 路径不可达。同步状态可在访达侧边栏查看 iCloud 云盘图标是否为实心云朵。
