用途：这是 Apple Notes 自动化的入门技能，演示如何用 JXA（JavaScript for Automation）经 osascript 从命令行操作 macOS 备忘录，AppleScript 用法亦有对照示例。
主要能力：创建笔记（写入默认文件夹或指定文件夹）、列出笔记（含标题与创建日期）、读取笔记正文（返回 HTML）、按名称关键词搜索笔记、按名称删除笔记（移入最近删除），并列出 name、body、id、creationDate、modificationDate、container 等属性及可写性。
使用方式：在已授权的 macOS 环境通过 osascript 执行，例如创建笔记： osascript -l JavaScript -e ' const Notes = Application("Notes"); const defaultFolder = Notes.defaultAccount.folders[0]; const newNote = Notes.Note({ name: "Hello from Automation", body: "<h1>Hello World</h1><p>This note was created via JXA at " + new Date().toISOString() + "</p>" }); defaultFolder.notes.push(newNote); newNote.id(); ' AppleScript 等价写法使用 tell application "Notes" 与 make new note。
适用场景：学习 Notes 自动化、创建首条自动化笔记、权限与读写冒烟测试。
限制：需 macOS 与 Notes.app，并先完成 apple-notes-install-auth 授权；iCloud 同步中可能响应缓慢；出现“Notes got an error”可先调用 Notes.activate()。官方建议在测试专用本地文件夹中创建一条合成笔记，按返回的 id 读回并在验证后删除，权限测试时不要列出全部笔记、搜索线上账户或隐式创建文件夹。下一步可参考 apple-notes-local-dev-loop。