用途:为 Apple Notes 的 JXA 自动化脚本搭建本地迭代开发环境,通过文件监听实现热重载,并配合测试辅助函数进行本地验证。
主要能力:使用 chokidar 监听 scripts/*.js 的变化并自动用 osascript 执行;提供 runJxa、getNoteCount、createTestNote 等测试辅助;可通过 npm scripts 启动开发与测试。
使用方式:先创建项目并安装依赖:
mkdir apple-notes-automation && cd apple-notes-automation npm init -y npm install -D chokidar tsx typescript
再按资料提供的 watch-runner.ts 与 test-notes.ts 编写 JXA 运行器与测试辅助,并在 package.json 中配置 "dev": "tsx src/dev/watch-runner.ts" 与 "test:notes": "tsx src/dev/test-notes.ts"。
适用场景:在 macOS 上以单元测试配合 mock 客户端进行脚本编辑;必要时用合成标题指向指定本地测试文件夹做 JXA 冒烟测试,校验结果标识并在测试夹具生命周期内清理。
限制:需本地 macOS 开发机和仅用于测试的 On My Mac 文件夹,或完全 mock 的 Notes 适配器;测试夹具不得包含生产笔记内容、账户名或凭据;脚本需纳入源码控制的允许清单。脚本失败时应停止监听,仅输出退出状态和脱敏错误分类;禁止对生产或同步的默认账户热跑编辑后的脚本,也不得对 defaultAccount 运行监听。其他细节暂未提供。