用途:该技能用于诊断和修复通过 JXA 或 osascript 自动化 Apple Notes 时遇到的常见错误,适用于错误排查、事件响应与恢复验证场景。
主要能力:将 Apple Notes 自动化错误分为三类——macOS 安全机制的 TCC 权限拒绝、脚本与 Notes.app 之间的 AppleEvent 通信失败、导致数据不一致的 iCloud 同步问题。提供错误码参考表,例如 -1743(TCC 拒绝自动化权限)、-1712(AppleEvent 超时)、-2700(找不到 Notes.app)、-1728(文件夹名不匹配,区分大小写)、-609(连接无效)、-128(用户取消)、-10000(笔记正文 HTML 无效)、-600(应用未运行),并给出对应修复方向。附带诊断脚本检查系统版本、应用运行状态、笔记与文件夹数量,以及针对暂时性故障的重试包装模式。
使用方式:先判断失败属于授权、应用可用性还是同步问题,再决定是否重试;仅记录脱敏后的错误分类和操作标识,避免导出账户、文件夹或笔记内容;仅在受支持的 UI 或 MDM 恢复操作后重新执行有界的只读检查;写入超时须先与操作台账核对再重试,经责任人批准后恢复队列。支持的命令保持原样,例如 osascript -l JavaScript -e 'Application("Notes").defaultAccount.notes.length' 和 brctl status com.apple.Notes。
限制:错误处理不得修改系统级隐私设置;不应重置全部 Apple Events 权限,而应针对具体客户端申请同意;沙盒与 SIP 保护 TCC.db,不能直接查询数据库;cron 无 TCC 上下文,应改用 launchd 并配置 AssociatedBundleIdentifiers。输出不得包含账户名、完整笔记或文件夹列表、TCC 记录或原始任务输入。前提与后续处理要求(如时间戳、操作标识、责任人等)需按资料规定执行。