SuperAPI AI 工具集

apple-notes-migration-deep-dive

通用与其它

查看项目

更新于 10-15 22:42

技能介绍

用途:指导在 Apple Notes 与 Obsidian、Notion、Evernote、OneNote 等平台之间迁移笔记。因 Apple Notes 以专有 HTML 存储内容且无批量操作 REST API,所有自动化都通过本地 Mac 上的 JXA/osascript 完成。

主要能力:覆盖四条常见迁移路径——Apple Notes 到 Obsidian(JXA 导出 HTML,转 Markdown 入 vault,附件用 Shortcuts 手动处理)、Apple Notes 到 Notion(JXA 导出 JSON,经 Notion API 导入,附件需重新上传)、Obsidian 到 Apple Notes(读取 .md 转 HTML 后经 JXA 创建,JXA 不支持附件)、Evernote/OneNote 到 Apple Notes(走内置导入,附件保留程度不同)。

使用方式:分导出、转换、导入三个可检查阶段执行,不将未审阅的笔记正文直接写入目标。先做小批量试点,比对源与目标清单,获得所有者批准后再分批导入;导入需幂等,遇超时、冲突或附件保真缺口即停止。提供了预备份脚本、Apple Notes 到 Obsidian 转换脚本、Obsidian 到 Apple Notes 导入脚本示例,均使用 osascript -l JavaScript。

适用场景与限制:适合受控的本地 Mac 笔记迁移项目。限制包括:需 Mac 环境;JXA 无法直接导出或写入二进制附件;iCloud 同步延迟会影响批量导入时间,需等待 5-10 分钟并节流;HTML 与 Markdown 转换存在保真损失;标题特殊字符需用 JSON 编码经 jq 处理;重复运行可能产生重复笔记,需用清单文件去重。

其他:迁移需在书面范围、迁移负责人、加密备份、回滚决策与保留策略就绪后启动,并使用不含生产数据的合成试点语料。