用途：以编程方式自动化 macOS「备忘录」（Apple Notes），支持用 JXA（首选）、AppleScript 发现、PyXA（推荐现代方式）或 PyObjC + Scripting Bridge 操作笔记。
主要能力：按 Application → Accounts → Folders → Notes 的层级解析账户与文件夹（含嵌套文件夹）；显式区分 iCloud 与 On My Mac；自动创建缺失的中间文件夹；用指定名称与 HTML 正文创建笔记并校验是否出现在界面中；用 .whose 过滤条件查询与更新；批量删除/移动；按 meetings/<company>/<date>-<meeting-title>、people/<first>-<last>/ 等约定归档会议与人物笔记。
使用方式：JXA 通过 Application("Notes")、accounts.byName("iCloud")、folders.push、notes.push 操作；PyXA 用 PyXA.Notes() 及 by_name、notes.make("folder")、notes().push 等；PyObjC 用 SBApplication.applicationWithBundleIdentifier_("com.apple.Notes")。使用 PyXA 需参照 automating-mac-apps 技能的 PyXA Installation 部分安装。权限、shell 与 Objective-C/UI 脚本模式可复用 automating-mac-apps 技能。
限制与注意事项：仅适用于 macOS；不支持跨平台笔记（可考虑 Notion API、Obsidian 或 Markdown 文件）；iCloud 同步缺少状态反馈；无多用户协作编辑支持；允许的 HTML 标签限于 h1-h3、b、i、u、ul/ol/li、div/p/br、a，必须清洗输入，避免 script、style 与事件处理器以防 XSS；清单与附件需借助剪贴板/Objective-C 回退方案（清单 Cmd+Shift+L，图片经 NSPasteboard + System Events）。
参考资料：notes-basics.md（说明符）、notes-recipes.md（创建/移动/查询/路径/清单配方）、notes-advanced.md（HTML 正文规则、附件/UI、JSON 导入导出、ObjC 桥）、notes-dictionary.md、notes-pyxa-api-reference.md。