# 面向智能体的 Exporter

五个技能教智能体用 Exporter 导出、备份和搜索。

## 五个技能

上面的命令用 [skills CLI](https://github.com/vercel-labs/skills) 从本站的[技能索引](https://exporter.dev/.well-known/skills/index.json)一次安装全部五个技能。也可以把下面任意一个 SKILL.md 保存到你的智能体的技能文件夹。

- [export-apple-notes](https://exporter.dev/.well-known/skills/export-apple-notes/SKILL.md): 用 `exporter` 把 Apple 备忘录导出为 Markdown 或 HTML 文件，并读取 JSON 摘要。 (`.well-known/skills/export-apple-notes/SKILL.md`)
- [apple-notes-to-obsidian](https://exporter.dev/.well-known/skills/apple-notes-to-obsidian/SKILL.md): 把 Apple 备忘录放进 Obsidian 仓库中的一个文件夹，并安全地保持同步。 (`.well-known/skills/apple-notes-to-obsidian/SKILL.md`)
- [backup-apple-notes](https://exporter.dev/.well-known/skills/backup-apple-notes/SKILL.md): 每晚的镜像、带日期的快照或备份工具的预检步骤，外加检查上一次是否已运行。 (`.well-known/skills/backup-apple-notes/SKILL.md`)
- [notes-as-claude-context](https://exporter.dev/.well-known/skills/notes-as-claude-context/SKILL.md): 通过本地 MCP 服务器搜索和读取备忘录、联系人和对话。 (`.well-known/skills/notes-as-claude-context/SKILL.md`)
- [export-messages](https://exporter.dev/.well-known/skills/export-messages/SKILL.md): 把 iMessage 对话导出为 Markdown，每个对话一个文件，附件一起导出。 (`.well-known/skills/export-messages/SKILL.md`)

## 智能体能做什么

- 导出: `exporter sync --source apple --json --quiet` 导出到应用的导出文件夹，或者 `exporter export --dest <folder>` 导出到这个人在命令行卡片上授权过的任意文件夹。
- 定时备份: `exporter help cron` 会打印带真实路径的 crontab 行：跟随编辑的镜像，或者永不改变的带日期快照。
- 读取结果: sync、export、list、status 和 log 都支持 `--json`。退出码：0 成功，1 有导出失败，2 需要设置，64 用法错误。
- 作为上下文搜索: 通过 MCP：对导出内容使用 `search`、`read`、`list`、`get_recent`、`get_stats` 和 `get_metadata`。[这六个工具](https://exporter.dev/docs/mcp)。
- 了解状态: `exporter status --json` 显示每个来源、它的上次导出、免费额度和已用数量。`exporter list sources --json` 统计有哪些内容。
- 了解免费额度: 超出免费额度的运行仍以 0 退出，并打印一行 `note:`，说明跳过了什么。这个人只需在 Exporter 中把那个应用解锁一次。

## 设置

前两步由人来完成，因为应用运行在沙盒中。其余由智能体完成。

1. 一个人安装应用: 从 Mac App Store 安装 Exporter，并打开一次。连接一个应用、选择它的导出文件夹，都只能在 Exporter 中完成。
2. 一个人粘贴一行命令: 在应用的命令行卡片上点按“复制安装命令”，在终端中粘贴一次。运行在沙盒中的应用无法自己写入你的 PATH。`exporter help install` 会打印适合那台 Mac 的那一行命令。
3. 智能体学会技能: `npx skills add https://exporter.dev` 从本站的技能索引安装上面的五个技能。
4. 智能体检查并运行: `exporter doctor` 会说明缺少什么，每个失败项下面都有一行 `fix:`。然后 `exporter sync --json --quiet` 执行导出，并打印一份 JSON 摘要。
5. 智能体把导出作为上下文读取: 在应用的卡片上启动 MCP 服务器后，`claude mcp add --transport http exporter http://localhost:8744/mcp` 会把 Claude Code 连接到导出内容。

## 常见问题

### 智能体不能做什么？

连接应用、选择导出文件夹、授权文件夹、启动 MCP 服务器或购买解锁。这些都要由人在应用中完成。命令行从不弹出提示：缺少某一步时，运行会以退出码 2 停止，并用一行文字说明该怎么做。

### 智能体可以为解锁付款吗？

不可以。每个应用都通过一次性 App 内购买解锁，由人在 Exporter 内完成。没有网页结账，没有许可证密钥，也没有智能体付款。告诉这个人就行；下次运行时解锁就会生效。

### 哪些智能体可以使用它？

任何能运行 shell 命令的工具都能驱动 `exporter`。任何支持基于 HTTP 的 MCP 的工具都能连接服务器：Claude Code 用一条命令，Cursor 和 VS Code 用应用 MCP 服务器卡片上的按钮，Claude Desktop 用复制的 `mcp-remote` 条目。

### 隐私方面如何？

命令行和服务器在这个人的 Mac 上运行，并在那里读取他的导出；服务器只监听 127.0.0.1。技能会告诉智能体只报告数量和路径，只有在这个人要求时才引用备忘录或信息的内容。[隐私](https://exporter.dev/privacy)。

## Related

- [CLI](https://exporter.dev/docs/cli): Every command, flag and exit code
- [MCP server](https://exporter.dev/docs/mcp): Connect Claude and other agents
- [Apple Notes in Claude](https://exporter.dev/guides/notes/apple-notes-in-claude): Claude searches your notes, on your Mac

---

human version: https://exporter.dev/zh-hans/agents
every page: https://exporter.dev/llms.txt