# 自动化 Apple Notes（JXA 优先，AppleScript 发现） ## 与 macOS 自动化技能的关系 * 独立的笔记；重用“automating-mac-apps”来获取权限、shell 和 Objective-C/UI 脚本模式。 * **PyXA 安装：** 要使用本技能中的 PyXA 示例，请参阅 `automating-mac-apps` 技能（PyXA 安装部分）中的安装说明。 ## 核心框架 * Notes 使用 AEOM 层次结构：应用程序 → 帐户 → 文件夹 → Notes（带有嵌套文件夹）。 * **加载：** `automating-notes/references/notes-basics.md` 以获取完整的说明符参考。 ## 工作流程（默认） 1. 明确解析帐户/文件夹（iCloud 与 On My Mac）；验证存在和权限。 2. 确保目标路径存在（如果需要，创建文件夹）；优雅地处理创建失败。 3. 创建带有显式“name”和 HTML“body”的注释；验证创建成功。 4. 使用`.whose`过滤器查询/更新；根据需要批量删除/移动；检查操作前/后的计数。 5. 对于清单/附件，如果字典支持不足，请使用剪贴板/Objective-C 脚本；测试回退。 6. 对于会议/人员工作流程，请在 `meetings//-` 和 `people/-/...` 下归档注释；验证最终结构。 ## 快速入门（确保路径+创建） **JXA（旧版）：** const Notes = Application("注释"); // 确保文件夹路径存在，根据需要创建中间文件夹函数 EnsurePath(acc, 路径) { const parts = path.split("/").filter(Boolean); 让容器= acc； parts.forEach(seg => { 让 f;尝试{ f = 容器.folders.byName(seg); f.name(); // 验证访问权限 } 捕获 (e) { // 文件夹不存在，创建 f = Notes.Folder({ 名称: seg }); 容器.folders.push(f); } 容器=f； }); 返回容器； } 尝试{ // 获取 iCloud 帐户并确保会议文件夹存在 const acc = Notes.accounts.byName("iCloud"); const 文件夹 = EnsurePath(acc, "会议/Acme/2024-07-01-Review"); // 在文件夹中创建新笔记文件夹.notes.push(Notes.Note({ 名称：“客户评论”， body: "

客户审核

议程...

" })); console.log("笔记创建成功"); } 捕获 (e) { console.error("创建注释失败：" + e.message); } **PyXA（推荐的现代方法）：** 导入PyXA 笔记 = PyXA.Notes() def Ensure_path（帐户，路径）： """确保文件夹路径存在，根据需要创建中间文件夹""" parts = [p for p in path.split("/") if p] # 过滤空部分容器=账户对于部分中的部分：尝试： # 尝试查找现有文件夹文件夹=container.folders().by_name(部分) folder.name() # 验证访问权限除外： # 文件夹不存在，请创建文件夹 = Notes.make("文件夹", {"名称": 部分}) 容器.folders().push(文件夹) 容器=文件夹返回容器尝试： # 获取 iCloud 帐户帐户 = Notes.accounts().by_name("iCloud") # 确保会议文件夹存在文件夹= Ensure_path（帐户，“会议/Acme/2024-07-01-回顾”） # 在文件夹中创建新笔记注释=folder.notes().push({ "name": "客户评价", "body": "

客户评论

议程...

" }) print("笔记创建成功") 除了异常 e： print(f"创建笔记失败：{e}") **带有脚本桥的 PyObjC：** 从 ScriptingBridge 导入 SBApplication 笔记 = SBApplication.applicationWithBundleIdentifier_("com.apple.Notes") def Ensure_path（帐户，路径）： """确保文件夹路径存在，根据需要创建中间文件夹""" parts = [p for p in path.split("/") if p] 容器=账户对于部分中的部分：尝试：文件夹=container.folders().objectWithName_(部分) folder.name() # 验证访问权限除外： # 创建新文件夹文件夹=notes.classForScriptingClass_(“文件夹”).alloc().init() 文件夹.setName_(部分) 容器.folders().addObject_(文件夹) 容器=文件夹返回容器尝试： # 获取 iCloud 帐户账户=notes.accounts() 帐户 = 无对于帐户中的 acc：如果 acc.name() == "iCloud": 帐户 = 帐户打破如果帐户： # 确保会议文件夹存在文件夹= Ensure_path（帐户，“会议/Acme/2024-07-01-回顾”） # 创建新笔记 note = Notes.classForScriptingClass_("note").alloc().init() note.setName_("客户评论") note.setBody_("

客户审核

议程...

") folder.notes().addObject_(注释) print("笔记创建成功") 其他： print("未找到 iCloud 帐户") 除了异常 e： print(f"创建笔记失败：{e}") ## 验证清单 * 帐户访问有效（iCloud 与在我的 Mac 上） * 文件夹创建和路径解析成功 * 使用有效的 HTML 正文完成注释创建 * 注释出现在 Notes UI 中 * `.who` 查询返回预期结果 * 错误处理涵盖丢失的帐户/文件夹 ## HTML 和后备 * 允许的标签：`

自动化笔记

包含技能