# 聯絡人

聯絡人匯出的運作方式，從連接到排解問題。

## 連接

在聯絡人卡片上按「連接」。面板會在你的 AddressBook 資料夾 `~/Library/Application Support/AddressBook` 中打開：按「選擇此資料夾」。Exporter 只讀取這個資料夾，不會跳出權限提示，你的 iCloud 和 Exchange 卡片也會從這裡讀取。然後按「選擇輸出檔案夾」。

## 檔案存放的位置

每張卡片一個 Markdown 檔案，例如 `Anna Kowalski.md`。兩個同名的人各自會加上簡短的 ID 後綴，兩個檔案都不會覆寫對方。直接位於個人專屬資料夾中的資料夾（例如 `~/Documents`）會在其中建立 `contacts-export` 資料夾；更深層的資料夾（例如 `~/Documents/contacts`）則直接使用。

卡片所在的標籤頁也決定了資料夾配置：

| 標籤頁 | 檔案存放在 |
| --- | --- |
| 「全部」、「最近」 | 匯出資料夾的最上層 |
| 「群組」 | `groups/<group>/`；同時屬於兩個群組的卡片只寫出一次，放在第一個群組下 |
| 「公司」 | `companies/<company>/` |

切換標籤頁會在下一次同步時搬移檔案，卡片也會在標籤頁下方提示。「最近」列出最近變更的 100 張卡片；「群組」和「公司」的樹狀清單最後分別是「未分組」和「無公司」。

## 匯出的內容

卡片上勾選的聯絡人卡片，以及它們所有的欄位。不匯出的內容：Gmail 為你寫過信的每個地址收集而來、只有電子郵件的項目。沒有 vCard 或 CSV 匯出：若要 `.vcf`，請在「聯絡人」中使用「檔案」>「輸出」>「輸出 vCard」。

## 格式

一律是 Markdown。

## 檔案

每個鍵只有在卡片有值時才會出現。清單中的值帶有標籤，例如 `+1 415 555 0123 (mobile)`。

| 鍵 | 內容 |
| --- | --- |
| `title` | 姓名 |
| `aliases` | 暱稱和婚前姓氏 |
| `id`、`source_url` | 卡片的 ID，以及一個可在「聯絡人」中打開它的 `addressbook://` 連結 |
| `created`、`modified` | 卡片的建立時間和上次變更時間 |
| `organization`、`job_title`、`department` | 工作相關的欄位 |
| `birthday` | 生日 |
| `email`、`phone` | 第一個電子郵件和電話，不帶標籤，方便套用範本 |
| `emails`、`phones`、`addresses`、`urls` | 每一個值，連同它的標籤 |
| `social`、`im` | 社群個人檔案和即時通訊帳號 |
| `dates`、`relationships` | 其他日期和相關人名，例如 `father: Tom Kowalski` |
| `groups` | 卡片所屬的聯絡人群組 |
| `conversations` | 也匯出了訊息時，連到這張卡片相關對話的連結 |

內文是姓名、職稱行和卡片上的備註：

```markdown
---
title: "Anna Kowalski"
id: "410FE041:ABPerson"
created: 2019-04-02T10:15:33
modified: 2026-08-30T19:02:11
source_url: "addressbook://410FE041:ABPerson"
organization: "Northwind Studio"
job_title: "Art director"
birthday: 1990-12-10
email: "anna@northwind.example"
phone: "+1 415 555 0123"
phones:
  - "+1 415 555 0123 (mobile)"
groups:
  - "Studio"
---

# Anna Kowalski

Art director · Northwind Studio

Met at the print fair.
```

## 免費與解鎖

在你勾選的卡片中，前 100 張可免費匯出並持續同步，刪除的卡片會讓出它的名額；其餘需要一次性解鎖（[價格](https://exporter.dev/pricing)）。

## 同步與完全重新同步

第一次按「立即同步」之後，只要 Exporter 在執行，編輯過的卡片就會重新寫出它的檔案，刪除的卡片的檔案會在下一次同步時移除。

「完全重新同步」會先詢問，然後只移除 Exporter 寫出的檔案，重新寫出每張卡片，並重新選出免費的 100 張。匯出資料夾中的其他內容都會保留。

## 問題與解決方法

- 「該資料夾中沒有聯絡人資料庫（請選擇 AddressBook 資料夾本身）」：再按一次「連接」，然後選擇面板打開的那個資料夾
- 檔案被搬到其他資料夾：卡片切換到了其他標籤頁。回到你要的標籤頁，然後按「立即同步」
- 少了一張卡片：它超過了免費的 100 張、沒有勾選，或是來自 Gmail、只有電子郵件的項目
- 有卡片失敗：`上次同步` 會顯示紅色的「詳細資訊」連結，列出失敗的卡片，每張都有一個「打開」連結

## Related

- [Contacts](https://exporter.dev/contacts): Every contact card as a Markdown file
- [Contacts guides](https://exporter.dev/guides/contacts): People notes in Obsidian
- [Messages](https://exporter.dev/docs/messages): Conversations, media, fields and fixes

---

human version: https://exporter.dev/zh-hant/docs/contacts
every page: https://exporter.dev/llms.txt