用途：帮助在 macOS 大版本升级（如 Ventura 到 Sonoma）前后，迁移并验证 Apple Notes 自动化脚本，应对 JXA API 行为、NoteStore 数据库结构、Apple Events 处理及 TCC 权限变化。
主要能力：提供各 macOS 版本的 Notes 功能与 JXA 影响对照（Monterey 至 Sequoia）；升级前用 osascript 导出含元数据的完整备份并记录校验和；升级后执行只读冒烟测试，比对笔记与文件夹数量；列出常见问题及处理方式，如 TCC 重置、数据库迁移延迟、launchd 代理重载、命令行工具重装等。
使用方式：升级前暂停计划写入，运行备份脚本生成 full-backup.json 并记录系统信息；升级后在系统设置或 MDM 中确认客户端权限，先运行只读检查，与备份回执比对；确认无误后再恢复写入，写测试仅限专用测试文件夹。相关命令包括 osascript -l JavaScript、launchctl unload/load、xcode-select --install、tccutil reset AppleEvents、plutil -lint。
适用场景：macOS 升级前后的 Notes 自动化维护、脚本兼容性排查、生产环境变更验证。
限制：需准备受支持设备清单、加密备份与回滚负责人；常规验证为只读，写操作须在非生产测试文件夹进行；兼容性表为示意，应以实际版本发布说明为准；输出记录不含原始笔记导出、账户名与 TCC 数据库数据。跨平台迁移与升级后生产就绪检查分别参见 apple-notes-migration-deep-dive 与 apple-notes-prod-checklist。