shortcuts 实现云端文档自动同步的核心是触发 icloud 文件系统级同步，而非直接上传；需先启用 icloud 云盘的“桌面与文稿”同步，将文档存入可见路径（如 icloud 云盘/projects/notes），再用“文件已添加”自动化响应变动，配合跨设备接力实现手机录入、mac 后处理工作流，同时避开深层路径访问、交互操作及权限限制等常见坑。
用 macOS Shortcuts 实现云端文档自动同步，核心不是让 Shortcuts 去“上传文件”，而是让它精准触发、协调和响应 iCloud 已启用的同步机制——真正起作用的是 iCloud 的文件系统级同步能力，Shortcuts 负责在恰当时间、以恰当方式介入流程。
确保 iCloud 同步基础已就绪
iCloud 不会自动同步任意路径。必须先让目标文档所在位置被系统识别为同步区域，否则 Shortcuts 再智能也无文件可操作。
- 打开系统设置 → Apple ID → iCloud → iCloud 云盘 → 选项… → 桌面与文稿，勾选“桌面与文稿文件夹”并点击“完成”
- 确认访达侧边栏中“iCloud 云盘”下出现带云朵图标的“桌面”和“文稿”文件夹
- 把需要自动同步的文档（如会议纪要、待办清单）统一存放在“文稿”或“桌面”里，或直接拖进 iCloud 云盘新建的子文件夹（如 iCloud 云盘/Projects/Notes）
用 Shortcuts 监控并响应文件变动
Shortcuts 的“文件已添加”自动化能实时感知 iCloud 同步目录里的新增动作，适合做归档、格式转换、备份等后续处理。
macOS Local Voice
下载
利用 macOS 原生能力实现本地语音识别与合成。通过 yap (Apple Speech.framework) 进行语音转文字，通过 say + ffmpeg 进行文字转语音。完全离线，无需 API 密钥。具备音质检测与智能选声功能。
- 打开快捷指令 App → 自动化 → 创建个人自动化 → 文件已添加
- 选择目标文件夹，例如 iCloud 云盘/Projects/Notes（注意：必须是访达里能直接看到的路径）
- 关闭“运行前询问”，避免弹窗打断流程
- 添加操作，例如：重命名文件（按日期+标题）、创建 PDF 副本、移动到子文件夹（如“已归档”）
跨设备协同：iPhone 编辑 → Mac 自动处理
利用 iCloud 同步天然延迟极低（通常 10–30 秒），可构建“手机录入、电脑后处理”的轻量工作流。
- 在 iPhone 上用备忘录或微信保存笔记到 iCloud 云盘/Projects/Notes
- Mac 端 Shortcuts 自动化监听该路径，检测到新 .txt 或 .md 文件后，自动：用 MarkEdit 打开、插入当前日期头、添加到 Reminders 待办列表
- 确保两端都开启通用剪贴板和接力，部分操作（如“发送到 Mac”）才可用
避免踩坑的关键细节
看似简单，但几个隐性限制常导致自动化静默失败。
- Shortcuts 无法直接操作 ~/Library/Mobile Documents/ 下的深层路径（系统保护），所有路径必须通过访达可见结构访问
- 不要在自动化里加“等待”或“选择文件”类交互操作，命令行或后台触发时会卡住
- 如果文档由第三方 App（如 Notion、Obsidian）生成并导出到 iCloud，需确认该 App 已获“完整磁盘访问”权限（系统设置 → 隐私与安全性 → 完整磁盘访问）
- 同步延迟不是故障，而是 iCloud 的正常行为；若需强一致性，改用 Automator + launchd 定时轮询更可靠
