SuperAPI AI 工具集

notes-export

办公与效率

查看项目

更新于 10-16 08:43

技能介绍

用途:把 macOS 备忘录中所有账户、所有文件夹的笔记一次性导出为带时间戳的本地快照,作为整理笔记前的安全网。

主要能力:每条笔记生成一个 Markdown 文件,按 <account>/<folder>/ 层级镜像备忘录结构,文件含 YAML frontmatter(account、folder、id、modified),正文为纯文本,经 textutil 解码,UTF-8 与中日韩字符安全。同时生成 manifest.json,记录每个文件夹(含计数)和每条笔记(id、名称、修改时间、相对路径、字符数),便于审计与差异比对。文件名经 safeFilename 处理并附加笔记的 core-data id(如 .p1234.md),避免同名冲突。

使用方式: NC="$HOME/.claude/plugins/marketplaces/cc-skills/plugins/notes-commander/scripts/notes.ts" bun "$NC" export # → ~/.local/share/notes-commander/export/<stamp>/ bun "$NC" export --out /path/to/dir # 指定目标目录

若 PATH 中存在 mempalace,导出成功后可把快照重新写入本地 MemPalace 语义索引,支持按语义检索(多语言,已验证中文内容): command -v mempalace >/dev/null && mempalace mine "<snapshot-dir>" --wing apple-notes --agent terry 该步骤幂等,未安装 mempalace 时静默跳过,属于增强而非依赖。

适用场景:在 notes-organize 等整理操作前做备份;需要机器可读索引做审计或差异比对;希望笔记可按语义搜索。

限制与注意:快照为全量而非增量,每次运行生成新的时间戳目录,旧快照需手动删除。默认根目录刻意放在任何 git 仓库之外,避免笔记内容被误提交,不要把 --out 指向仓库。Recently Deleted 会被跳过,如需捕获请先在备忘录界面恢复。大库耗时较长(实测 400 条约 2.5 分钟),正文按 20 条分块获取以规避 Apple Event 大小上限(-1741);分块失败会降级为逐条获取,仍失败的笔记产生警告并以退出码 3 结束(部分导出会明确提示,不会静默)。瞬时 -600/-1712 启动竞争会自动重试。导出后应检查退出码为 0 且笔记数接近实际总量,抽查一个中日韩或 emoji 标题文件确认无乱码。