전역 가져오기 및 내보내기 (Global Import & Export)
Global Import/Export는 전체 Rephlo 구성을 하나의 아카이브로 한 번에 패키징합니다. 항목별 내보내기(가져오기 및 내보내기 참고)와 달리, 이 기능은 모든 데이터 유형을 하나의 포괄적인 ZIP 파일로 묶습니다.
내보내지는 항목
Global Export에는 모든 Rephlo 데이터를 포함할 수 있습니다. 각 유형은 독립적인 체크박스로 표시됩니다.
| 데이터 유형 | 설명 | 기본값 |
|---|---|---|
| Commands | 모든 명령어, 그룹, 즐겨찾기 | 선택됨 |
| Spaces | 모든 파일과 콘텐츠를 포함한 Spaces | 선택됨 |
| History | 입력/출력을 포함한 사용 기록 | 선택됨 |
| Providers | LLM 제공업체 구성(API 키는 암호화됨) | 선택됨 |
| Conversations | 전체 메시지 기록을 포함한 채팅 세션 | 선택됨 |
| Settings | 애플리케이션 환경설정 | 선택됨 |
API 키와 비밀 정보는 내보내기를 생성한 기기에 대해 암호화된 상태로 유지됩니다. 해당 정보는 동일한 기기에서만 복호화할 수 있습니다 — 기기 간 가져오기를 참고하세요.
데이터 내보내기
1단계: Global Export 열기
- File 메뉴로 이동합니다.
- **Export All Data…**를 클릭합니다.
2단계: 내보낼 항목 선택
Global Export 대화상자에는 데이터 유형별 체크박스와 현재 개수(예: "45 commands, 5 groups", "28 conversations, 412 messages")가 표시됩니다. 내보내고 싶은 유형에 체크하세요.
Export All Data 대화상자에는 Commands, Spaces, History, Providers, Conversations, Settings가 나열되며, 각 항목에는 포함된 개수와 체크박스가 표시됩니다. 요약 줄에는 선택된 총 개수가 표시되며, 하단에는 Cancel / Export… 버튼이 있습니다.
3단계: 위치 선택 후 내보내기
- **Export…**를 클릭합니다.
- 위치와 파일 이름을 선택합니다. 기본 이름에는 날짜가 포함됩니다(예:
rephlo-backup-2026-01-20.zip). - Save를 클릭합니다.
4단계: 완료될 때까지 대기
진행 상황 대화상자에는 각 단계가 진행되는 대로 표시됩니다 — commands 준비, spaces 패키징, history, providers, conversations, settings 내보내기, 그리고 마지막으로 아카이브 생성까지입니다. 완료되면 내보낸 내용의 요약이 표시됩니다. 필요하면 내보내기 도중 취소할 수 있습니다.
데이터 가져오기
1단계: Global Import 열기
- File 메뉴로 이동합니다.
- **Import All Data…**를 클릭합니다.
- 내보낸
.zip파일을 선택합니다.
2단계: 가져오기 미리보기 검토
Rephlo는 아카이브의 유효성을 검증하고 매니페스트를 읽은 후, 가져올 내용을 표시합니다: 아카이브 생성 날짜, 생성한 앱 버전, 데이터 유형별 개수, 그리고 충돌 여부입니다. 내보내기가 다른 기기에서 이루어진 경우, 제공업체 API 키를 다시 입력해야 한다는 경고가 표시됩니다.
Import All Data 대화상자 상단에는 아카이브 이름, 생성 날짜, 버전이 표시됩니다. 아래에는 각 데이터 유형별로 항목 개수, 감지된 충돌 개수, 그리고 처리 방식을 선택하는 드롭다운(Skip / Replace / Duplicate)이 나열됩니다. History는 충돌 처리 대신 추가되는 방식으로 동작합니다. 내보내기가 다른 기기에서 생성된 경우 경고 배너가 표시됩니다.
3단계: 충돌 처리 방식 구성
충돌이 있는 각 데이터 유형에 대해 처리 방식을 선택합니다.
| 옵션 | 동작 |
|---|---|
| Skip | 기존 데이터를 유지하고, 충돌하는 항목은 가져오지 않습니다 |
| Replace | 기존 데이터 를 가져온 버전으로 덮어씁니다 |
| Duplicate | 이름이 변경된 새 항목으로 가져옵니다(예: "Command (Imported)") |
팁: 작업 중인 환경에 병합할 때는 Skip을 사용하세요. 새로 설치한 환경에 백업을 복원할 때는 Replace를 사용하세요. History 기록은 충돌 처리 없이 항상 추가됩니다.
4단계: 가져오기
- Import를 클릭합니다.
- 진행 상황 대화상자에 각 단계(commands, spaces, conversations 등)가 표시됩니다.
- 완료되면 요약을 확인합니다.
충돌 처리 방식 설명
가져온 항목이 기존 항목과 동일한 이름 또는 식별자를 가질 때 충돌이 발생합니다.
각 옵션을 사용해야 하는 경우
| 상황 | 권장 옵션 |
|---|---|
| 새로 설치한 환경에 백업 복원 | Replace |
| 동료의 데이터 병합 | Skip 또는 Duplicate |
| 이전 백업으로부터 업데이트 | Replace |
| 공유된 명령어 사용해 보기 | Duplicate |
ZIP 파일 구조
아카이브 구조를 이해하면 문제 해결이나 수동 점검에 도움이 됩니다.
매니페스트 파일
manifest.json에는 다음이 기록됩니다.
- 스키마 버전(하위 호환성을 위함)과 내보내기를 생성한 앱 버전
- UTC 기준 내보내기 타임스탬프
- 기기 간 가져오기를 감지하는 데 사용되는 해시된 기기 식별자
- 유형별 개수(commands, spaces, history 기록, providers, conversations, 메시지, 그리고 보관된 command/space 개수 포함)와 전체 아카이브 크기
Providers 및 Settings에 관한 참고 사항: provider 비밀 정보는
providers/폴더(암호화됨)에 저장되므로, provider 관련 키는 중복을 피하기 위해settings/내보내기에서 의도적으로 제외됩니다.
기기 간 가져오기
다른 컴퓨터에서 생성된 아카이브를 가져올 때:
정상적으로 동작하는 항목
- Commands(지침, 그룹, 설정)
- Spaces(파일 및 콘텐츠)
- History(사용 기록)
- Conversations(채팅 세션)
- Settings(환경설정)
주의가 필요한 항목
- Provider API 키 — 암호화는 기기별로 이루어집니다. 기기 간 가져오기 이후, 영향을 받은 provider는 키가 지워진 상태로 들어오며, 각 키를 다시 입력해야 합니다.
의도적인 설계인 이유: 키는 절대 평문으로 내보내지지 않으므로, 백업 파일이 실수로 공유되더라도 자격 증명은 안전하게 보호됩니다. Gateway(Dedicated API) provider는 아예 내보내지지 않으며, 로그인 시 자동으로 복원됩니다.
일반적인 사용 사례
재설치 전 전체 백업
- File > Export All Data…
- 모든 데이터 유형을 선택합니다.
- 외장 드라이브 또는 클라우드 스토리지에 저장합니다.
- API 키는 별도로 기록해 두세요(재설치 후에는 복호화할 수 없습니다).
- 재설치 후 **File > Import All Data…**를 사용합니다.
- Settings에서 API 키를 다시 입력합니다.
새 컴퓨터 설정
- 기존 컴퓨터에서 모든 데이터를 내보냅니다.
- ZIP 파일을 새 컴퓨터로 전송합니다.
- Rephlo를 설치하고 ZIP 파일을 가져옵니다.
- 각 provider의 API 키를 다시 입력합니다.
팀과 구성 공유
- Commands와 Spaces를 선택한 상태로 내보냅니다.
- History, Providers, Conversations, Settings(개인 데이터)의 선택을 해제합니다.
- ZIP 파일을 공유합니다.
- 동료는 자신의 명령어를 덮어쓰지 않도록 Duplicate를 사용해 가져옵니다.
개인정보 보호를 고려한 깔끔한 백업
민감한 데이터가 없는 백업을 원한다면:
- Providers(암호화된 키), History(처리된 텍스트), Conversations(채팅 메시지)의 선택을 해제합니다.
- Commands와 Spaces만 내보냅니다.
모범 사례
- 정기적인 백업 — 매주 또는 주요 변경 전에 내보내기를 수행합니다.
- 알기 쉬운 파일 이름 — 날짜를 포함합니다(예:
rephlo-backup-2026-01-20.zip). - 안전한 보관 — 암호화된 클라우드 스토리지 또는 외장 드라이브에 백업을 보관합니다.
- 복원 테스트 — 백업이 문제없이 가져와지는지 가끔 확인합니다.
- API 키 기록 — 비밀번호 관리자에 보관하세요. 기기 간 백업으로는 복구할 수 없습니다.
- 백업 버전 관리 — 최신 버전뿐 아니라 여러 버전을 보관합니다.
문제 해결
가져오기 중 "Invalid archive" 오류
- ZIP 파일이 손상되었을 수 있습니다 — 다시 다운로드하거나 다시 복사하세요.
- Rephlo의 Global Export로 생성된 파일인지 확인하세요(
manifest.json이 포함되어 있어야 합니다).
가져오기 후 데이터가 누락됨
- 해당 데이터 유형이 가져오기 대상 으로 선택되었는지 확인하세요.
- 충돌 처리 방식을 검토하세요 — 항목이 Skip되었을 수 있습니다.
가져오기 후 provider에 "API key required"가 표시됨
- 다른 기기에서 가져온 경우 정상적인 현상입니다. Settings > Providers에서 키를 다시 입력하세요.
가져오기 속도가 느린 경우
- 대용량 history 파일은 처리 시간이 더 오래 걸립니다.
- 문서가 많은 Space는 개별적으로 처리됩니다.
- 더 빠른 가져오기를 위해 History를 제외하는 것을 고려하세요.
다음 섹션: Settings에서 Rephlo를 원하는 대로 구성하세요.