# macOS 재설치 후 앱 설정 복원 가이드

백업 작성: 2026-09-16~17 · 가이드 점검: 2026-09-17

이 폴더는 **앱 설정과 일부 사용자 프리셋**의 백업입니다. 앱 설치 파일, 계정 로그인, 작업 문서 또는 시스템 전체 백업은 아닙니다. macOS 27을 새로 설치한 뒤 사용할 수 있도록 복원 순서와 사전 점검 방법을 정리했습니다. 백업 당시 버전의 macOS 27 지원 여부는 보장하지 않으며, **복원하는 날 제조사 공식 안내에서 OS·CPU 호환성을 먼저 확인**합니다.

현재 기본 위치는 `/Volumes/OWC-SSD/__CONFIG__`입니다. 드라이브 이름이나 위치가 달라졌다면 이 README가 있는 실제 폴더를 기준으로 작업합니다. 예전 사용자 이름 `goose`를 새 계정 이름으로 강제하지 않습니다. 다만 설정 내부의 절대 경로는 새 홈·드라이브 경로에 맞게 검토해야 합니다.

## 1. 재설치와 복원의 전체 순서

1. **macOS를 지우기 전에** 이 폴더와 별도로 작업 문서, 사진·영상, 프로젝트, 폰트·플러그인 설치 자료, 라이선스, Docker 볼륨 등 필요한 원본 데이터의 백업을 확인합니다. 이 폴더가 그 자료를 대신하지 않습니다.
2. macOS 27 설치 및 기본 계정 설정을 마칩니다. Python 3.9 이상을 실행할 수 있는 환경과 ChatGPT 데스크톱 앱을 준비합니다. Python은 macOS에 기본 설치되어 있다고 가정하지 않습니다.
3. ChatGPT를 한 번 실행하여 로그인과 초기 설정을 마친 뒤 종료합니다. **macOS 기본 터미널에서 ChatGPT/Codex 설정만 먼저 복원**합니다. 복원 중인 앱의 에이전트에게 자기 설정 복원을 맡기지 않습니다.
4. ChatGPT를 다시 실행합니다. 새 대화에서 이 README를 읽게 하고 **설치 여부와 누락 항목부터 보고**하도록 요청합니다. 이 백업에는 과거 대화가 없으므로 예전 대화 내용을 알고 있다고 가정하지 않습니다.
5. 아래 앱 및 필요한 구성요소를 설치합니다. 호환되는 앱을 먼저 선택하고, 그중 백업과 같은 주요 버전·언어를 우선합니다. 각 앱을 한 번 실행하여 로그인·초기화·필요한 권한을 완료합니다.
6. 에이전트가 다시 사전 점검한 뒤 준비된 앱의 설정을 **앱별로 순차 복원**합니다. 누락·비호환 항목은 해당 앱만 보류하고 이유를 남깁니다.
7. 일반 앱의 설정 쓰기가 끝난 뒤 필요한 로그아웃·재시동을 한 번으로 모을 수 있습니다. 단, 드라이버 설치가 요구하는 재시동은 설치 안내대로 먼저 진행합니다. 재시동은 사용자가 저장 중인 작업을 마친 후 수행합니다.
8. 재실행 후 앱별 동작을 확인하고 완료·보류·실패를 구분한 결과를 남깁니다. 파일 복사가 성공했다는 사실만으로 앱 복원이 완전히 끝났다고 판단하지 않습니다.

## 2. 복원 전에 설치 여부를 확인할 앱

기준 버전은 백업 당시 또는 2026-09-17 점검 시 확인한 값입니다. **설치 권장 버전이나 macOS 27 호환 인증 목록이 아닙니다.** 버전이 다르면 설정 형식과 지원 항목을 검토한 후 진행합니다.

| 설치 대상 | 기준 버전 | 정확한 앱 구분 | 추가 준비 |
|---|---|---|---|
| ChatGPT 데스크톱 / Codex | 26.908.70816 (9275) | `com.openai.codex` | 로그인, 로컬 파일 접근·필요한 컴퓨터 사용 권한, 사용 중인 플러그인 재설치 |
| Obsidian | 1.13.7 | `md.obsidian` | 노트·첨부파일이 포함된 `GoOSe`, `super8-game`, `Archive` 보관소 원본과 Excalidraw 플러그인 |
| 무비스트 프로 | 2.19.0 | `com.movist.MovistPro` — 일반 무비스트와 구분 | 라이선스, 자막 폰트, 미디어 경로 |
| Wacom 드라이버·Wacom Center | 6.4.14-1 | Wacom Center와 실제 타블렛 드라이버 | 타블렛 모델에 맞는 macOS 27 지원 드라이버, 장치 연결, 권한 및 재시동 |
| Adobe Bridge 2026 | 16.0.1 | `com.adobe.bridge` | Creative Cloud 로그인, 사진·컬렉션 원본 경로 |
| Adobe Photoshop 2026 | 27.3.0 | `com.adobe.Photoshop` | Creative Cloud, 사용하던 폰트·별도 플러그인 |
| Adobe Illustrator 2026 | 30.1.0 | `com.adobe.illustrator` | Creative Cloud, 같은 언어의 설정, 폰트·플러그인 |
| 통합형 Affinity | 3.3.0 (4850) | `com.canva.affinity` — 구형 Designer/Photo/Publisher와 구분 | 로그인, 폰트·플러그인, 외부 연결 리소스 |
| Logi Options+ | 2.7.970334 | `com.logi.optionsplus` | 지원 마우스·키보드 연결, 접근성·입력 모니터링 권한 |
| Ghostty | 1.3.1 (15212) | `com.mitchellh.ghostty` | `Monaco`, `Noto Sans CJK KR` 존재 여부, 별도 셸 설정 |
| OBS Studio | 32.2.2 (31845296735) | `com.obsproject.obs-studio` | 사용하던 플러그인, 장면이 참조하는 파일·폰트, 오디오·영상 장치 |
| Typora | 1.14.10 (7786) | `abnerworks.Typora` | 라이선스. 사용자 추가 테마는 백업 당시 없음 |
| Docker Desktop | 4.90.0 (238679) | `com.docker.docker` | 새 Mac의 CPU에 맞는 설치본, 초기 실행·약관·권한. 작업 데이터는 별도 |

Creative Cloud와 Python은 복원 준비 도구이며 자체 설정 백업은 이 폴더에 없습니다. 과거에 사용한 모든 폰트·플러그인의 완전한 목록도 포함되어 있지 않습니다. 에이전트는 백업의 장면·프리셋·설정에서 의존성을 확인하고, 알 수 없는 항목은 확인 필요로 보고해야 합니다.

## 3. 에이전트가 먼저 수행할 사전 점검

### 자동으로 확인할 수 있는 항목

이 폴더에서 아래 명령을 실행합니다. `preflight_restore.py`는 **읽기 전용**이며 앱을 설치·실행·종료하거나 설정을 복원하지 않습니다.

```sh
python3 preflight_restore.py
```

에이전트가 상세 결과를 읽으려면 다음 명령을 사용합니다.

```sh
python3 preflight_restore.py --json
```

이 도구는 macOS·CPU·Python 버전, `/Applications`와 `~/Applications`의 앱 식별자·버전, 백업 파일 해시를 점검합니다. 앱을 다른 위치에 설치했거나 이름·번들 ID가 바뀌었다면 에이전트가 해당 경로를 추가로 확인합니다. 단순히 `.app`이 있다는 것은 초기 실행·라이선스·호환성 검증을 통과했다는 뜻이 아닙니다.

### 에이전트가 추가로 확인할 항목

1. 실제 외장 드라이브와 백업 폴더가 읽히는지, `restore-plan.json`에 나열된 대상과 실제 백업이 일치하는지 확인합니다. 해시가 다르면 그 앱은 복원하지 말고 변경·누락 원인을 보고합니다.
2. 설치된 앱의 정확한 제품·주요 버전·언어와 macOS 27/CPU 지원 여부를 제조사 공식 자료로 확인합니다. 구형 버전 설치를 무조건 요구하지 않습니다.
3. Python 3.9 이상, 초기 실행, 로그인·활성화, 대상 설정 폴더 생성 여부를 확인합니다. 폴더가 없다고 설치·초기화를 건너뛴 채 강제로 생성하여 진행하지 않습니다.
4. 필요한 장치, 글꼴, 플러그인, 외부 파일과 절대 경로를 확인합니다. macOS 권한은 백업 파일로 복원되지 않으며 사용자가 시스템 설정에서 완료해야 할 수 있습니다.
5. 아직 저장하지 않은 작업, 녹화·방송·컨테이너 실행이 있는지 확인하고 대상 앱을 정상 종료합니다. 강제 종료, 서비스 영구 비활성화, 시스템 보안 설정 변경으로 검사를 우회하지 않습니다.
6. 각 `restore_*.py`의 기본 실행은 **검증만** 수행합니다. 스크립트 내용과 적용 경로도 읽고, 새 환경에 맞는지 검토합니다. `--restore`는 실제 설정을 쓰는 단계입니다.

먼저 아래 형식의 요약을 사용자에게 보여줍니다. **확인하지 못한 항목을 완료로 표시하지 않습니다.**

| 앱 | 설치·버전 | 필요한 추가 설치/사용자 작업 | 백업 검사 | 복원 상태 |
|---|---|---|---|---|
| 각 앱별 기재 | 설치됨 / 미설치 / 버전 검토 | 폰트·플러그인·로그인·권한 등 | 통과 / 실패 / 확인 불가 | 준비됨 / 보류 / 선행 복원 완료 |

사용자가 복원을 요청했다면 준비된 앱은 안내 후 순차 진행합니다. 아직 설치가 필요한 앱은 필요한 제품과 이유를 알려줍니다. 새 소프트웨어 설치, 로그인·약관·시스템 권한, 재시동이 필요한 단계는 사용자와 조율합니다. 이번 문서 점검 작업에서는 실제 복원을 실행하지 않았습니다.

## 4. ChatGPT/Codex 설정의 선행 복원

복원 대상은 `com.openai.codex` 앱입니다. 이름이 ChatGPT라고 표시되어도 다른 번들 ID의 앱에 이 파일을 적용하지 않습니다.

1. Python과 앱을 설치하고 초기 로그인까지 완료합니다.
2. ChatGPT/Codex, Codex CLI 및 실행 중인 IDE 에이전트를 종료합니다. 이후 단계는 **macOS 기본 터미널**에서 실행합니다.
3. 백업 폴더로 이동하고 검증합니다. 다른 드라이브 이름이면 경로를 바꿉니다.

```sh
cd "/Volumes/OWC-SSD/__CONFIG__/ChatGPT-Settings-20260916-192323"
python3 restore_settings.py
```

4. 검증이 성공한 경우에만 적용합니다.

```sh
python3 restore_settings.py --restore
```

5. 로그아웃·로그인 후 앱을 실행합니다. 모델 기본값, 테마와 단축키를 확인하고 필요한 플러그인은 다시 설치·연결합니다. 백업된 모델 ID·기능 옵션이 새 앱에서 유효하지 않으면 사용자 설정만 조정합니다.
6. 이미 이 선행 복원을 끝냈다면 뒤의 일괄 복원에서 ChatGPT 설정을 다시 복원하지 않습니다.

이 백업은 설정 5개 파일만 포함합니다. 대화·메모리·생성 이미지·자동화·작업 결과물·로그인은 복원하지 않습니다. 전역 화면 상태와 plist는 일부 키를 병합하고, `config.toml`은 사용자 설정을 복원하면서 새 Mac의 프로젝트 신뢰·도구 정의·기본 플러그인 경로를 보존하도록 작성되어 있습니다. 새 버전의 복잡한 TOML 구문까지 포괄하는 일반 마이그레이션 도구는 아니므로 버전 차이는 검토해야 합니다.

개인 설정 위치와 프로젝트별 설정 구분은 [OpenAI 공식 설정 안내](https://learn.chatgpt.com/guides/best-practices)를 참고합니다. 실제 적용 범위는 이 백업의 `manifest.json`과 스크립트를 기준으로 합니다.

## 5. 준비된 앱의 순차 복원

아래 표의 스크립트는 **해당 백업 폴더로 이동한 뒤** 실행합니다. 먼저 `python3 파일명.py`로 검증하고, 준비된 앱에만 `python3 파일명.py --restore`를 실행합니다. 전체 폴더를 훑어 모든 스크립트를 무조건 실행하는 루프는 사용하지 않습니다.

| 대상 | 백업 폴더/파일 | 복원 방식 |
|---|---|---|
| ChatGPT/Codex | `ChatGPT-Settings-20260916-192323` | 선행 단계에서 완료. `restore_settings.py` |
| Obsidian | `Obsidian-Settings-20260917-011924` | 노트 보관소 3개를 먼저 복원한 뒤 `restore_obsidian.py` |
| 무비스트 프로 | `com.movist.MovistPro.plist` | 대상 앱 종료 후 선택 파일 복사 |
| Wacom | `PREF.wacomprefs` | Wacom Center/Tablet Utility의 공식 가져오기·복원 UI |
| Adobe 3개 앱 | `Adobe-20260916-141800` | 설치된 앱별 경로만 검토하여 선택 복사 |
| Affinity | `Affinity-20260916-145338` | 아래 명시한 4개 위치만 선택 복사 |
| Logi Options+ | `LogiOptionsPlus-Settings-20260917-004346` | `restore_logi.py` |
| Ghostty | `Ghostty-Settings-20260917-004758` | `restore_ghostty.py` |
| OBS | `OBS-Settings-20260917-005208` | `restore_obs.py` |
| Typora | `Typora-Settings-20260917-005514` | `restore_typora.py` |
| Docker Desktop | `Docker-Settings-20260917-005715` | `restore_docker.py` |

수동 복사 대상도 먼저 현재 설정을 날짜별 안전 사본으로 보관합니다. `Home/` 아래는 새 사용자의 홈 디렉터리에 대응합니다. **홈 또는 Library 전체를 덮어쓰지 않습니다.** Adobe의 `Applications/` 아래 파일은 사용자 홈에 복사하는 파일이 아니며, 설치본 전체를 교체하지 않습니다.

스크립트가 만드는 안전 사본은 `~/Documents/앱명-Restore-Safety/날짜-시간/previous` 또는 앱별 가이드에 명시된 폴더에 있습니다. 오류 시 해당 앱만 중단하고 실제 변경 범위와 안전 사본 위치를 확인합니다. 일반 예외에 대한 되돌리기 로직은 있지만 전원 장애·강제 종료까지 자동 복구를 보장하지는 않습니다.

### 무비스트 프로

앱을 종료하고 현재 plist를 따로 보관한 뒤 `com.movist.MovistPro.plist`를 `~/Library/Preferences/com.movist.MovistPro.plist`에 복사합니다. 라이선스와 자막 폰트·영상 파일은 별도 준비합니다. 재로그인 후 단축키·자막·영상·오디오 설정을 확인합니다.

### Wacom

장치 모델과 macOS 27을 지원하는 드라이버 설치 및 요구되는 재시동을 먼저 끝냅니다. Wacom Center의 백업·복원에서 `PREF.wacomprefs` **패키지 전체**를 가져옵니다. 메뉴가 없는 버전에서는 Wacom Tablet Utility의 복원 기능을 확인합니다. 내부 `.prefs`를 사용자 Library에 직접 복사하지 않습니다. 앱별 설정의 대상 앱을 설치한 뒤 펜 압력·버튼·화면 매핑을 확인합니다.

공식 참고: [Wacom Center 백업·복원](https://101.wacom.com/userhelp/en/WCBackupRestore.htm), [Tablet Utility 복원](https://support.wacom.com/hc/en-us/articles/9216314174743-How-do-I-backup-or-restore-my-settings-with-driver-version-6-4-0).

### Adobe Bridge · Photoshop · Illustrator

Creative Cloud에서 macOS 27을 지원하는 앱을 설치하고 로그인합니다. 다음 경로는 **백업 당시 버전** 기준이며, 다른 주요 버전의 폴더 이름만 바꿔 덮어쓰지 않습니다. 새 버전에서는 앱이 지원하는 가져오기·마이그레이션 경로를 확인합니다.

| 앱 | 백업 내 `Home/Library` 기준 주요 위치 |
|---|---|
| Bridge | `Application Support/Adobe/Bridge 2026`, `Preferences/Adobe/Bridge`, `Preferences/com.Adobe.Bridge.16.0.plist`, `Preferences/com.adobe.bridge.plist`, `Preferences/com.adobe.bridge16.plist` |
| Photoshop | `Preferences/Adobe Photoshop 2026 Settings`, `Preferences/Adobe Photoshop 2026 Paths`, `Preferences/com.adobe.Photoshop.plist`, `Preferences/Adobe/PS`, `Application Support/Adobe/Adobe Photoshop 2026` |
| Illustrator | `Preferences/Adobe Illustrator 30 Settings`, `Preferences/com.adobe.illustrator.plist`, `Preferences/Adobe/Adobe Illustrator`, `Application Support/Adobe/Adobe Illustrator 30` |
| 공용 | `Application Support/Adobe/CameraRaw`, `Color`, `XMP`, `Adobe PDF`, `Preferences/Adobe Camera Raw Prefs`, `Preferences/Adobe Save for Web 13.0 Prefs` |

`Color`, `XMP`, `Adobe PDF`는 모두 `Application Support/Adobe/` 아래입니다. 정확한 파일 목록은 `manifest.json`에서 확인합니다. 실제 설치된 앱의 대응 항목만 복원하며, Illustrator는 언어별 하위 구조도 맞춥니다. 백업의 `Applications/`에는 기본 제공 프리셋도 섞여 있으므로 필요한 사용자 추가 프리셋·스크립트만 검토하여 가져옵니다. 설치본 전체 덮어쓰기는 하지 않습니다.

문서·원본 사진·폰트·별도 플러그인·클라우드 라이브러리·라이선스는 포함하지 않습니다. Bridge 컬렉션 경로, Photoshop 스크래치 디스크와 액션·브러시, Illustrator 작업 영역·단축키를 확인합니다.

공식 참고: [Photoshop 환경설정](https://helpx.adobe.com/photoshop/desktop/get-started/settings-and-preferences/backup-and-restore-preferences.html), [Illustrator 환경설정 위치](https://helpx.adobe.com/ee/illustrator/kb/troubleshoot-preference-issues.html).

### Affinity

통합형 `com.canva.affinity`를 설치·초기 실행한 뒤 종료합니다. 백업의 다음 네 위치만 현재 설정의 안전 사본을 만든 뒤 대응 위치로 복원합니다.

- `Home/Library/Preferences/com.canva.affinity.plist`
- `Home/Library/Application Support/Affinity`
- `Home/Library/Group Containers/5HD2ARTBFS.com.canva.affinity/v3/user`
- `Home/Library/Group Containers/5HD2ARTBFS.com.canva.affinity/Library/Preferences`

새 앱의 버전이나 공유 컨테이너 경로가 다르면 먼저 호환성을 확인합니다. `v3/user`에는 에셋·브러시·매크로 등이 있으므로 빠뜨리지 않습니다. 앱에 포함된 일부 폰트·Plugins 폴더가 있어도 시스템 폰트와 외부 플러그인 설치 전체를 대신하지 않습니다.

과거 문서의 “This document contains embedded assets”에서 Yes를 누르면 삭제했던 에셋이 다시 추가될 수 있습니다. 원치 않으면 No를 선택합니다. 앱 설정 복원은 문서 속 내장 에셋을 제거하지 않습니다. 앞서 확인한 배너 파일은 Embed 옵션 변경·다른 이름 저장만으로 문제가 없어지지 않았습니다.

### Obsidian

[개별 가이드](Obsidian-Settings-20260917-011924/README.md)를 확인합니다. 이 백업은 `GoOSe`, `super8-game`, `Archive` 세 보관소의 `.obsidian` 설정만 포함합니다. Markdown 노트, Canvas·Excalidraw 문서, 이미지·첨부파일은 포함하지 않으므로 세 보관소 전체를 별도 데이터 백업에서 먼저 복원해야 합니다.

기본 위치는 `~/local/obsidian`이며 다른 위치에서는 `--vault-parent`로 세 보관소의 상위 폴더를 지정합니다. 전역 보관소 목록은 예전 절대 경로 때문에 제외했으므로, 복원 후 **Open folder as vault**로 세 폴더를 각각 엽니다.

`GoOSe`의 Community Plugins 목록과 Excalidraw 설정은 포함했지만 플러그인 실행 파일과 로그인은 포함하지 않았습니다. 제한 모드·신뢰 여부를 직접 확인한 뒤 Excalidraw를 다시 설치합니다. Sync 충돌 workspace 사본, 브라우저 캐시와 파일 복구 데이터도 제외되어 있습니다.

### Logi Options+

[개별 가이드](LogiOptionsPlus-Settings-20260917-004346/README.md)를 확인합니다. 앱과 `logioptionsplus_agent`를 모두 종료해야 합니다. 서비스 이름은 새 시스템의 `/Library/LaunchAgents/com.logi.optionsplus.plist`에서 다시 확인하고, 기존과 같은 `com.logi.cp-dev-mgr`인 경우에만 다음 명령을 사용할 수 있습니다.

```sh
launchctl bootout "gui/$(id -u)/com.logi.cp-dev-mgr"
```

복원 중 사용자 지정 버튼 동작이 잠시 멈출 수 있습니다. 복원 후 재시동해 에이전트를 다시 시작하고 버튼·스크롤·앱별 설정을 확인합니다. Bluetooth/수신기 페어링, Flow 연결과 시스템 권한은 별도로 설정합니다. `settings.db`와 `macros.db`는 변경하지 않고 보관한 독립 DB이며 복원 시 이전 WAL/SHM이 함께 남지 않도록 스크립트가 처리합니다.

### Ghostty

[개별 가이드](Ghostty-Settings-20260917-004758/README.md)를 확인합니다. Ghostty를 종료하고 **macOS 기본 터미널**에서 복원합니다. Ghostty 내부 터미널에서 자기 복원 스크립트를 실행하면 앱 실행 검사가 복원을 차단합니다.

선택된 `Cyberdyne` 테마가 새 버전에도 있는지, `Monaco`와 `Noto Sans CJK KR`가 설치되어 있는지 확인합니다. `.zshrc`, 셸 플러그인과 별도 폰트는 백업 범위 밖입니다. 예전 루트의 단일 `config.ghostty` 파일은 현재 백업 목록에 없으며, 날짜가 붙은 백업 폴더를 사용합니다.

### OBS Studio

[개별 가이드](OBS-Settings-20260917-005208/README.md)를 확인합니다. 현재 장면 모음·프로필·전역 설정을 복원하며, 장면이 참조하는 이미지·영상·음원·글꼴과 별도 플러그인은 먼저 준비하거나 경로를 다시 연결합니다. 화면·마이크·카메라 권한과 장치 식별자도 새 Mac에서 확인합니다.

스트림 키와 WebSocket 비밀번호는 제외되어 있습니다. 복원 후 로그인·새 비밀번호를 설정하기 전에는 방송이나 외부 제어 연결을 시작하지 않습니다. 브라우저 소스의 쿠키·로그인과 녹화물은 복원되지 않습니다.

### Typora

[개별 가이드](Typora-Settings-20260917-005514/README.md)를 확인합니다. 테마·다크 모드·Markdown 관련 설정 17개만 plist에 병합합니다. 문서·라이선스·최근 파일 기록은 포함하지 않습니다. 백업 당시 현재 테마 파일 36개가 앱 기본 파일과 같아 기본 테마 복사본은 제외했습니다. 새 버전의 기본 테마가 바뀌면 화면 모양까지 동일하다는 보장은 없습니다.

### Docker Desktop

[개별 가이드](Docker-Settings-20260917-005715/README.md)를 확인합니다. **Quit Docker Desktop** 후 앱·백엔드가 종료되었는지 확인합니다. `com.docker.vmnetd`는 앱 종료 후에도 남을 수 있는 별도 보조 서비스이므로, 그것만 보인다는 이유로 제거·영구 비활성화하지 않습니다. 해당 프로세스만으로 복원을 차단하던 조건은 이번 점검에서 수정했습니다. [Docker 공식 설명](https://docs.docker.com/desktop/troubleshoot-and-support/troubleshoot/topics/#comdockervmnetd-is-still-running-after-i-quit-the-app)

백업에는 12GB 메모리와 가상화 관련 **저장 키**가 있습니다. `UseLibkrun` 같은 키가 현재 버전에서 어떤 런타임으로 해석되는지는 설정 화면에서 확인해야 하며, 키 이름만 보고 실제 하이퍼바이저를 단정하지 않습니다. 새 Mac의 CPU·메모리와 지원 버전에 맞게 검토합니다.

JSON 병합은 최상위 키 기준입니다. 다른 최상위 키와 인증 항목은 유지하지만 `plugins`, `features`, `builder` 같은 **중첩 객체는 해당 객체 전체가 백업 값으로 바뀔 수 있습니다.** 새 시스템에서 이미 이 항목을 설정했다면 비교 후 선택 적용합니다. `desktop-linux` 컨텍스트는 Docker Desktop 초기 실행으로 생성되었는지 확인합니다.

이미지·컨테이너·볼륨·Kubernetes 데이터, Compose 파일·프로젝트와 로그인은 백업하지 않았습니다. 컨테이너가 다시 만들어져도 볼륨 데이터는 돌아오지 않습니다. 필요한 데이터가 별도 백업되었는지 macOS 삭제 전에 확인해야 합니다.

## 6. 복원 완료 판단과 결과 보고

파일 쓰기를 끝낸 후 필요한 재로그인·재시동을 하고, 실제 앱에서 주요 설정을 확인합니다. 사용자에게 다음 내용을 남깁니다.

- 앱별 복원 결과: 완료 / 파일 적용 후 동작 확인 대기 / 설치·호환성 때문에 보류 / 실패
- 실제 사용한 앱 버전, 적용한 백업 폴더, 기존 설정 안전 사본 위치
- 사용자가 마쳐야 할 로그인·권한·폰트·플러그인·장치·파일 재연결
- 오류가 있으면 해당 앱만 이전 안전 사본으로 되돌렸는지 여부

문서에 기록된 테스트는 파일 무결성과 임시 폴더에서의 일부 복원 동작 검사입니다. macOS 27에서의 전체 앱 실동작 검증은 앞으로 수행해야 합니다. 스크립트 검사 통과만으로 “완전 복원”을 보고하지 않습니다.

## 7. 새 에이전트에게 보낼 요청 예시

> 이 외장 드라이브의 `__CONFIG__/README.md`를 읽고 앱 설정 복원을 도와주세요. ChatGPT/Codex 자체 설정은 이미 복원했습니다. 먼저 `preflight_restore.py`와 실제 설치 상태를 확인해서 필요한 앱·드라이버·Python·폰트·플러그인 중 누락된 항목과 버전 호환성 문제를 알려주세요. 앱별 준비 상태를 보여준 뒤 준비된 앱부터 순차 복원하고, 준비되지 않은 앱은 이유와 함께 보류해주세요. 기존 설정은 안전 사본으로 남기고, 로그인·권한·약관·재시동이 필요하면 그 단계를 알려주세요. 이미지·문서·컨테이너 데이터는 이 설정 백업에 없는 것으로 취급하고, 마지막에 실제 확인한 결과와 남은 작업을 정리해주세요.

ChatGPT 선행 복원을 하지 않았다면 예시의 두 번째 문장을 실제 상태에 맞게 바꿉니다. 이 README가 사용자 요청이나 앱의 안전 장치를 무시할 권한을 부여하지는 않습니다.

## 8. 이번 문서 점검에서 개선한 사항

- 설치 대상 앱과 추가 준비 항목을 한 표로 정리하고, 사전 점검 보고를 복원보다 앞에 배치했습니다. Obsidian 설정 백업을 추가한 뒤 현재 13개 앱을 확인합니다.
- macOS 27 호환성은 복원 시점에 확인하도록 했으며 과거 버전 설치를 일률적으로 권하지 않습니다.
- ChatGPT 자기 복원과 Ghostty 내부 터미널 복원 문제를 분리했습니다.
- 앱별 반복 재시동 설명을 공통 단계로 묶고, Wacom은 공식 가져오기 방식임을 명확히 했습니다.
- Docker 보조 서비스 오인과 중첩 JSON 병합 설명을 정정했습니다.
- Typora 복원 전 검사에서 실패한 경우 기존 plist를 삭제할 수 있던 예외 처리 경로를 수정했습니다.
- 기존 루트 Ghostty 단일 파일 관련 설명을 현재 파일 목록에 맞췄습니다.
- 백업한 앱 설정 데이터는 변경하지 않았습니다. Docker·Typora 복원 스크립트와 해당 가이드만 수정했으며 검증값도 갱신했습니다.

`preflight_restore.py`와 `restore-plan.json`은 사전 확인용입니다. 이번 점검으로 모든 앱을 일괄 실행하는 복원 프로그램을 만든 것은 아닙니다. 수정 전 README와 수정한 스크립트는 `maintenance/`의 날짜별 사본에 보관합니다.

### MX Creative Keypad 추가 백업

기존 Options+ 백업에 포함되지 않았던 LogiPluginService 프로필·리소스를 `MXCreativeKeypad-20260917-143016`에 추가 백업했습니다. [복원 가이드](MXCreativeKeypad-20260917-143016/README.md)를 확인하세요. 공식 EXPORT 파일이 아닌 로컬 파일 사본이며, 기존 `restore_logi.py`는 이 추가 백업을 복원하지 않습니다.