mac-notes-agent

Mac Notes Agent 是一款专为 macOS 生态系统设计的本地笔记自动化工具，通过 Node.js CLI 桥接 AppleScript 技术，实现与 Apple Notes 应用的无缝集成。该工具支持完整的笔记生命周期管理，包括创建、读取、更新、删除和搜索等核心操作，所有功能均通过本地命令行接口完成，无需依赖外部网络服务。

该 Skill 的核心用法十分直观。用户通过 node cli.js 命令配合不同子命令（add、list、get、update、append、delete、search）即可操控 Notes 应用。工具采用 (folderName, title) 作为主键识别机制，并生成合成 ID 便于精确定位。值得注意的是，它支持自动创建不存在的文件夹，并将换行符自动转换为 HTML 的 <br> 标签以适应 Notes 的渲染格式。

显著优点体现在其极简的架构设计。首先，零外部 npm 依赖，仅使用 Node.js 内置的 child_process 模块，极大降低了供应链攻击风险。其次，所有数据操作完全在本地完成，通过 AppleScript 直接与系统 Notes 应用交互，不存在数据外传或云端同步的隐私隐患。此外，轻量化的实现使其启动迅速，资源占用极低，适合作为自动化工作流的核心组件。

然而，该工具也存在若干局限性。平台独占性是最主要的限制——仅支持 macOS 系统，且依赖系统自带的 osascript 工具。功能层面，由于 Apple Notes 本身不暴露稳定 ID，工具采用标题+文件夹的复合键机制，当存在重名笔记时只能操作最近创建的一条，这可能引发误操作。更重要的是，delete 命令执行即时删除且不提供二次确认机制，存在误删风险。

该 Skill 最适合 macOS 生态的重度用户，特别是需要批量处理笔记、自动化记录工作流或将 Notes 作为知识库管理的个人用户。对于开发者而言，其简洁的 JSON 接口也便于集成到更复杂的自动化脚本中。

使用风险主要包括：系统权限依赖（首次使用需授予自动化权限）、误删不可逆（建议重要笔记提前备份）、以及 AppleScript 执行的性能瓶颈（处理大量笔记时可能出现延迟）。此外，由于直接操作系统级应用，macOS 版本更新可能导致 AppleScript 接口行为变化，存在兼容性维护风险。