用途:该参考架构面向在 macOS 上构建 Apple Notes 自动化系统的开发者,定义分层标准做法:Node.js 应用层经 osascript 调用 JXA 脚本,配合本地 SQLite 缓存加速查询、基于轮询的变更检测,以及可选的 Shortcuts 跨应用自动化。触发词为 "apple notes architecture"。
主要能力与结构:项目分为 notes-client(JXA 包装类)、cache(SQLite 缓存)、templates(HTML 片段模板)、export(导出 MD/JSON/SQLite/CSV)、events(轮询变更检测)与可选 server(本地 HTTP API);脚本目录含 CLI 包装、健康检查、全量备份导出与 launchd 部署安装器。
使用要点:授权、输入校验、幂等与审计日志置于 JXA 适配器之上,适配器只接收已校验的限定命令;本地服务默认绑定 loopback;缓存与事件数据视为敏感副本,最小化字段、静态加密、限制访问并按策略轮换删除,不得直接读取 NoteStore。
限制:仅支持 macOS,无 REST API、无 webhook,iCloud 同步有 5–30 秒延迟,正文仅支持 HTML 不支持原生 Markdown,JXA 无法导出附件。需自有可交互 macOS 主机、TCC 授权与声明的账户/文件夹范围。未提供具体价格与商业条款。