# 메시지

연결부터 문제 해결까지, 메시지 내보내기가 작동하는 방식입니다.

## 연결

메시지 카드에서 “연결”을 누릅니다. 패널이 `~/Library/Messages`에서 열리면 “이 폴더 선택”을 누릅니다. Exporter는 전체 디스크 접근 권한 없이 이 폴더만 읽습니다. 그다음 “내보낼 폴더 선택”을 누릅니다.

처음 훑는 작업은 전체 기록을 앱의 인덱스로 읽어 들이며, 기록이 길면 몇 분이 걸립니다. “인덱싱됨” 행에 진행 상황이 표시되고, 끝날 때까지 “지금 동기화”는 흐리게 표시됩니다.

## 파일이 저장되는 위치

대화마다 Markdown 파일 하나가 모두 내보내기 폴더의 최상위에 놓입니다. 한 사람과의 대화는 `Anna Kowalski.md`입니다. 그룹의 파일 이름에는 `Cabin crew-57.md`처럼 대화 ID가 붙으므로, 새 멤버가 들어와도 이름이 바뀌지 않습니다. 사진, 동영상, 오디오는 대화마다 폴더 하나씩 `attachments/`에 들어갑니다. `~/Documents`처럼 홈 폴더 바로 아래의 폴더를 고르면 그 안에 `messages-export` 폴더가 생기고, `~/Documents/messages`처럼 더 깊은 폴더는 그대로 사용됩니다.

## 내보내지는 것

카드에서 선택한 대화입니다. 탭은 목록을 거르기만 합니다: “전체”, “개인”, “그룹”, “최근”(지난 30일), “자주 본”(메시지가 가장 많은 대화), “안 읽음”.

동기화는 새로운 내용이 있는 대화만 씁니다. 메시지를 잠금 해제하면 다음 동기화에서 모든 대화를 씁니다. 오래된 대화를 선택했다면 지금 쓰려면 “전체 재동기화”를 누르세요. 그렇지 않으면 그 대화에 다음 메시지가 올 때 기록됩니다.

파일 안에는 날짜마다 제목이 있고, 그 아래에 메시지마다 블록 하나가 있습니다. 보낸 사람, 보낸 시각, 메시지에서 해당 대화를 여는 링크가 담깁니다. 답장은 답한 메시지에 연결되고, 편집된 메시지는 이전 버전을 각각 각주로 남기며, 반응은 메시지 아래 한 줄에 표시되고, 모든 메시지 끝에는 링크할 수 있는 블록 ID가 붙습니다. 연락처도 내보냈다면 각 참여자는 자신의 연락처 파일에 연결되고, 연락처에는 거꾸로 대화 목록이 표시됩니다.

## 미디어

사진, 동영상, 오디오는 `attachments/`에 복사되며, 편집기에서 보이도록 iPhone의 HEIC 사진은 JPEG로 변환됩니다. 이 Mac에 한 번도 다운로드되지 않은 미디어는 삽입되지 않고 파일에 이름만 적힙니다.

## 형식

항상 Markdown입니다.

## 파일

| 키 | 담는 내용 |
| --- | --- |
| `title` | 상대방 또는 그룹 |
| `id` | 대화 ID |
| `created`, `modified` | 첫 메시지와 가장 최근 메시지 |
| `source_url` | 첫 번째 참여자로의 `sms://` 링크. 대화를 엽니다 |
| `participants` | 각 사람(연락처를 내보냈다면 연락처 파일로의 링크)과 `Me` |
| `is_group` | 그룹이면 `true` |
| `message_count` | 메시지 수 |
| `service` | 대화의 서비스. 예: `iMessage` |

```markdown
---
title: "Anna Kowalski"
id: "412"
created: 2026-03-09T18:02:11
modified: 2026-03-09T18:04:10
source_url: "sms://+14155550123"
participants: ["[[contacts/Anna Kowalski]]", "Me"]
is_group: false
message_count: 2
service: "iMessage"
---

# Anna Kowalski

## Monday, March 9, 2026

**[[contacts/Anna Kowalski|Anna Kowalski]]** [open](sms://+14155550123) (2026-03-09 18:02:11)
Are we still on for the cabin weekend?
^msg-7C1E2A9B4F30

**[Me]** (2026-03-09 18:04:10)
> replying to [[#^msg-7C1E2A9B4F30]]
Yes! Ferry at 9:40 on Friday (edited) [^e1]
> 👍 Anna Kowalski
^msg-A83D5E6F0B12

[^e1]: was "Yes! Ferry at 9:10 on Friday" (2026-03-09 18:04:10)
```

## 무료와 잠금 해제

선택한 대화 중 최근 대화 10개는 무료로 내보내고 계속 동기화됩니다. 나머지에는 일회성 잠금 해제가 필요합니다([가격](https://exporter.dev/pricing)).

## 동기화와 전체 재동기화

Exporter가 실행 중인 동안 새 메시지는 인덱스에 들어가고, 그 메시지가 속한 대화가 다시 기록됩니다. 메시지에서 삭제한 대화는 다음 동기화 때 내보내기에서 빠집니다.

“전체 재동기화”는 먼저 확인을 요청한 다음, 복사된 미디어를 포함해 Exporter가 쓴 파일만 지우고 인덱스에서 모든 대화를 다시 씁니다. 내보내기 폴더의 다른 것은 그대로 남습니다.

## 문제와 해결 방법

- “해당 폴더에 chat.db가 없습니다 (Messages 폴더 자체를 선택하세요)”: “연결”을 다시 누르고, 패널이 열린 폴더를 선택하세요
- “지금 동기화”가 흐리게 표시됨: 처음 훑는 작업이 아직 진행 중입니다. “인덱싱됨” 행에 진행 정도가 표시됩니다
- 잠금 해제 후에도 오래된 대화가 없음: “지금 동기화”를 누르세요. 모든 대화를 씁니다
- 사진이 없음: 메시지에서 대화를 열어 사진이 다운로드되게 한 다음 다시 동기화하세요
- 이름이 일반 텍스트로 표시됨: 연락처도 내보내세요. 그 뒤에 기록되는 대화는 참여자에 연결되며, “전체 재동기화”를 누르면 지금 모두 다시 씁니다

## Related

- [Messages](https://exporter.dev/messages): Every conversation as a file
- [Messages guides](https://exporter.dev/guides/messages): Backups and Claude
- [Contacts](https://exporter.dev/docs/contacts): Layouts, every field and fixes

---

human version: https://exporter.dev/ko/docs/messages
every page: https://exporter.dev/llms.txt