核心用法
Apple Notes Skill 是一套专为 macOS 设计的本地化工具集，通过 Python 脚本与 AppleScript 桥接，实现对 Apple Notes 应用的全方位数据提取与监控。用户可通过命令行执行三种核心操作：
1. 提取（Extract）：支持简单文本提取或完整提取（含附件），可按文件夹筛选，输出格式包括 JSON、Markdown、HTML、SQLite 等
2. 监控（Monitor）：以守护进程模式运行，检测笔记变更并支持自动导出，轮询间隔可自定义
3. 处理与导出（Process & Export）：提供笔记后处理、Obsidian 知识库直导、以及知识图谱生成能力
配置层面采用 JSON 驱动的设计，configs/extractor.json 控制提取行为与隐私过滤器，configs/monitor.json 管理监控策略与自动处理规则。
显著优点
- 完全本地化：所有处理在本地完成，零云端依赖，符合隐私优先原则
- 多格式生态：原生支持 Obsidian、Logseq、Notion 等主流知识管理工具
- 实时同步能力：守护进程模式可实现准实时的工作流集成
- 元数据完整保留：提取创建/修改时间、文件夹层级等关键信息
- 增量更新机制：避免全量重复提取，提升效率
潜在缺点与局限性
- 平台锁定：仅支持 macOS，无法跨平台使用
- 权限依赖：需用户手动授予 Notes 访问权限，企业环境可能受限
- 非官方 API：依赖 AppleScript 桥接，存在随 macOS 更新失效的风险
- 监控性能：轮询机制（非真正事件驱动）在高频写入场景下存在资源开销
- 附件处理限制：复杂格式附件的完整性依赖 AppleScript 暴露能力
适合人群
- 需要将 Apple Notes 迁移至 Obsidian/Logseq 等第三方知识库的重度笔记用户
- 构建个人知识管理（PKM）自动化工作流的效率工具爱好者
- 对数据主权敏感、拒绝云端同步方案的隐私优先用户
- 开发 AI 处理管道、需要将笔记内容结构化喂给大语言模型的技术用户
常规风险
- 权限撤销风险：macOS 安全更新可能重置隐私权限，导致功能中断
- API 兼容性：AppleScript 接口非公开承诺，存在未来版本不兼容可能
- 数据一致性：监控模式下的轮询间隔若设置不当，可能遗漏快速连续变更
- 敏感内容暴露：虽有隐私过滤器配置，但本地导出文件仍需用户自行管控访问权限
- 依赖维护：Python 3.8+ 及特定包版本要求，长期维护需关注依赖链健康度