用途:Apple Notes 没有内置指标 API 或健康端点,因此该技能从外部搭建轻量监控,用 bash 脚本、结构化 JSON 日志和 macOS 通知来观测自动化健康与性能。触发词为“apple notes monitoring”。
主要能力: 1)通过 JXA/osascript 轮询默认账户的笔记数、文件夹数、账户数,并测量调用延迟; 2)检查 Notes 进程与 iCloud 同步守护进程(bird、cloudd)是否运行; 3)按运行状态、读取是否失败、延迟是否超过 10000ms 判定健康; 4)将结果以 JSONL 追加写入受限日志目录,并在不健康时发出 macOS 通知; 5)提供 CLI 仪表盘,用 jq 查看最近记录、趋势与历史告警。
使用方式:将健康检查脚本通过 launchd 定时部署(示例为每 5 分钟)。日志路径由 NOTES_LOG_DIR 指定,默认为 /tmp。核心采集逻辑可封装为 TypeScript 指标采集函数,包含 timestamp、noteCount、folderCount、accountCount、latencyMs、healthy、icloudSyncActive 等字段。仪表盘脚本用 tail、jq、awk、grep 读取同一 JSONL 文件展示最近 10 次检查、24 小时笔记数趋势与不健康记录。
适用场景:需要确认 Notes 自动化是否可正常读取、跟踪响应延迟、观察同步守护进程状态,并为告警与事件响应提供证据时。
限制与注意:输出需脱敏,不得将账户名、笔记标题、正文或原始错误写入通知;计数属于敏感运营元数据,不应发送到广泛遥测;监控范围限于获批账户/文件夹;应配置日志轮转与保留上限,并定期审查访问;仅在达到约定的连续失败阈值后告警;监控绝不能重启 iCloud 进程或修改 Notes 状态。延迟尖峰可能由索引或大同步引起,连续 3 次超阈值才告警;笔记数归零可能因账户登出或 TCC 被撤销;osascript 调用可加 timeout 15 前缀。具体价格、平台范围等事实暂未提供。