apple-notes

在执行自动写入或绑定新项目之前，请先阅读项目契约。目标和回执应归项目所有。

1. 确认请求的账户／文件夹；如果是编辑，还要确认现有笔记 ID。标题和文件夹名称可能重复。请核实 ID 和容器层级，不要选择第一个匹配项，也不要依赖默认账户。如果项目已有适配器，请复用。
2. 对于新调用方，请先运行 apple-effects-reliability 中的 Notes 探测，然后读取实际请求的文件夹／项目。账户计数成功只能证明可访问，并不能证明可以访问目标或已交付内容。
3. 对于受支持的操作，请使用范围受限的 AppleScript；对于富文本内容、锁定的笔记或不受支持的功能，请使用原生电脑操作。使用 AppleScript 时，请阅读 Notes 脚本编写详情。 仅在已确认的文件夹中创建请求的笔记；只有在请求或项目政策授权时，才创建缺失的文件夹。
4. 对于追加／编辑，先读取当前正文，并保留请求修改范围之外的现有内容、附件和格式。如果无法在完整替换正文时保留这些内容，请通过 GUI 执行请求的编辑。
5. 按提供方 ID 读取生成的笔记，并确认其账户／文件夹及请求的文本。对于带标记的创建操作，还要核对操作标记。保存项目的回执。如果输出不确定，请先使用可靠性技能，再重复写入。

只有当请求的内容显示在正确的笔记／目标中，且回执记录了该检查，才算完成。脚本退出码、提供方 ID 或打开的窗口本身都不能证明已完成交付验证。