用途:该技能面向通过 Apple Events(osascript/JXA)自动化 Apple Notes 的场景,帮助避免因写入过快导致的超时、同步滞后或数据丢失。
主要能力:说明三类实际瓶颈——Apple Events IPC 桥、处理每次写入的 iCloud 同步守护进程(bird/cloudd)、以及处理并发访问的 Notes.app SQLite 数据库;给出各操作的建议安全速率(如创建笔记 1/秒、读取 10/秒、搜索 2/秒、移动或删除笔记 1/秒、批量列举 1/10 秒、附件操作 1/5 秒)及超限后果;提供限速队列配置(读 100ms、写 1000ms、删除 1000ms、搜索 500ms 的最小延迟与退避重试策略);给出带 sleep 的批量创建脚本示例与 iCloud 同步积压监控命令。
必要用法:从低于建议速率开始,观察所有目标设备同步成功后再提高;串行化写入与删除;超时的变更需先通过持久化幂等校验判断是否已成功,再决定是否重试;批量操作需维护有界队列、幂等键或持久化操作账本,并提前备份。
限制与注意:Apple Notes 没有正式的云服务式 API 速率限制,上述速率是保守起点而非厂商保证;不要通过终止 iCloud 进程来恢复吞吐;删除后笔记重现多因 iCloud 在删除传播前恢复;重复笔记多因超时重试重复执行了成功的创建。日志不应记录笔记标题、正文、账户标识或原始 Apple Event 负载。缺失事实(如具体平台版本、官方支持范围)暂未提供。