# 給 AI 代理的 Exporter

五個技能教 AI 代理用 Exporter 匯出、備份和搜尋。

## 五個技能

上面的指令會用 [skills CLI](https://github.com/vercel-labs/skills) 從本站的[技能索引](https://exporter.dev/.well-known/skills/index.json)安裝全部五個技能。你也可以把下面任何一個 SKILL.md 存進你 AI 代理的技能資料夾。

- [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`)

## AI 代理能做的事

- 匯出: `exporter sync --source apple --json --quiet` 匯出到 App 的匯出資料夾，或用 `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:`，說明略過了什麼。那個 App 由人在 Exporter 中解鎖一次即可。

## 設定

前兩個步驟由人來做，因為 App 在沙盒中執行。其餘由 AI 代理完成。

1. 由人安裝 App: 從 Mac App Store 安裝 Exporter，並打開一次。連接 App 和選擇它的匯出資料夾，都只能在 Exporter 中進行。
2. 由人貼上一行指令: 在 App 的命令列卡片上按「複製安裝指令」，在終端機中貼上一次。在沙盒中執行的 App 無法自己寫入你的 PATH。`exporter help install` 會印出適用於那台 Mac 的那一行。
3. AI 代理學會技能: `npx skills add https://exporter.dev` 會從本站的技能索引安裝上面的五個技能。
4. AI 代理檢查並執行: `exporter doctor` 會說明缺少什麼，每個失敗項目下方都有一行 `fix:`。接著 `exporter sync --json --quiet` 會匯出並印出一份 JSON 摘要。
5. AI 代理把內容當作上下文讀取: 在 App 的卡片上啟動 MCP 伺服器後，`claude mcp add --transport http exporter http://localhost:8744/mcp` 就會把 Claude Code 連接到匯出內容。

## 常見問題

### AI 代理不能做什麼？

連接 App、選擇匯出資料夾、授權資料夾、啟動 MCP 伺服器或購買解鎖。這些都要由人在 App 中完成。命令列從不跳出提示：缺少某個步驟時，執行會以結束代碼 2 停止，並以一行文字說明該怎麼做。

### AI 代理可以付費解鎖嗎？

不行。每個 App 都是由人在 Exporter 內以一次性 App 內購買解鎖。沒有網路結帳，沒有授權碼，也沒有 AI 代理付款。請告訴那個人；下一次執行就會套用解鎖。

### 哪些 AI 代理可以使用？

任何能執行 shell 指令的工具都能操作 `exporter`。任何透過 HTTP 使用 MCP 的工具都能連接伺服器：Claude Code 只要一個指令，Cursor 和 VS Code 可從 App 的 MCP 伺服器卡片上的按鈕連接，Claude Desktop 則透過拷貝的 `mcp-remote` 項目連接。

### 隱私有多少保障？

命令列和伺服器都在那個人的 Mac 上執行，並在那裡讀取匯出內容；伺服器只監聽 127.0.0.1。技能會要求 AI 代理只回報數量和路徑，並且只在那個人要求時才引用備忘錄或訊息。[隱私權](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-hant/agents
every page: https://exporter.dev/llms.txt