# Dropbox 클라우드 동기화

라이브러리 프로젝트와 설정을 내 Dropbox에 백업하고 다른 컴퓨터에서 엽니다. 무엇이 동기화되는지, 충돌과 삭제를 어떻게 처리하는지, 각 메시지가 무슨 뜻인지 설명합니다.

클라우드 동기화는 라이브러리 프로젝트와 설정의 사본을 내 Dropbox에 보관합니다. 다른 컴퓨터에서 같은 Dropbox를 연결하고 프로젝트를 다운로드하면 두 컴퓨터가 프로젝트를 서로 맞춰 둡니다.

**설정 → 데이터 저장 → 클라우드 동기화**를 열어 설정하세요.

## 시작하기 전에

- Dropbox 계정이 필요합니다. 무료 Dropbox Basic 계정은 2 GB를 제공합니다.
- 클라우드 동기화는 macOS, Windows, Linux에서 작동합니다.
- Oleafly는 열려 있는 동안에만 동기화하며, 최소화되었거나 창이 숨겨져 있을 때도 포함됩니다. Oleafly를 닫으면 아무것도 동기화되지 않습니다.
- Oleafly는 Dropbox와 직접 통신합니다. 중간에 Oleafly 서버는 없습니다.

## Dropbox 연결하기

1. **설정 → 데이터 저장 → 클라우드 동기화**를 열고 **Dropbox 연결**을 선택합니다.
2. 브라우저에서 Dropbox의 로그인 및 승인 페이지가 열립니다. 거기서 로그인하고 Oleafly를 승인합니다.
3. Oleafly가 연결을 마치고 나면 브라우저에 "연결되었습니다"라고 표시됩니다. 승인한 뒤 문제가 생기면 브라우저에 로그인이 끝나지 않았다고 표시되고, Oleafly가 무슨 일이 있었는지 알려 줍니다.

로그인은 Dropbox 자체 페이지에서 하므로 Oleafly는 Dropbox 비밀번호를 볼 수 없습니다.

### 브라우저가 Oleafly로 돌아오지 못할 때

승인하면 Dropbox가 브라우저를 내 컴퓨터의 로컬 주소(127.0.0.1)로 보내고, Oleafly가 거기서 로그인 정보를 받아 옵니다. 이 방법이 작동하지 않으면 **로그인에 문제가 있나요? 코드를 붙여넣으세요**를 선택하세요. Dropbox에 코드가 표시됩니다. 복사해서 Oleafly에 붙여넣으세요.

### Oleafly가 접근할 수 있는 범위

- Oleafly는 Dropbox 안의 자체 앱 폴더인 `Apps/Oleafly`만 열 수 있습니다. Dropbox의 다른 파일은 전혀 볼 수 없습니다.
- Dropbox에 요청하는 권한은 네 가지뿐이며, 그 밖의 권한은 요청하지 않습니다. `account_info.read`는 내 이메일 주소와 사용한 공간을 보여 줍니다. `files.metadata.read`, `files.content.read`, `files.content.write`는 Oleafly가 자체 폴더 안의 파일을 나열하고 읽고 쓰게 해 줍니다.
- 로그인은 PKCE를 사용하는 OAuth를 씁니다.
- macOS와 Windows에서는 로그인 토큰이 운영 체제의 키체인에 보관됩니다. Linux에서, 또는 키체인을 사용할 수 없을 때는 Oleafly 데이터 폴더의 암호화된 파일에 보관됩니다.
- 토큰은 동기화되지 않습니다. 각 컴퓨터가 따로 연결합니다.

### 클라우드 동기화 카드

연결하고 나면 카드에 다음이 표시됩니다.

- Dropbox 계정의 이메일 주소.
- Dropbox 사용량을 보여 주는 링. Dropbox가 차오름에 따라 녹색에서 노란색, 주황색, 빨간색으로 바뀌며 80%부터는 빨간색입니다.
- **이 컴퓨터에서 동기화**, 여기서 동기화를 켜고 끄는 스위치.
- **자동 동기화**, Oleafly가 알아서 동기화하게 하는 스위치.
- 이 컴퓨터의 이름. 클릭하면 컴퓨터 이름을 바꿀 수 있습니다.
- **프로젝트** 목록.
- **고급**, 그 안에 **연결 해제**가 있습니다.

## 동기화되는 항목

### 프로젝트

라이브러리의 모든 프로젝트가 주 문서를 컴파일하는 폴더를 포함한 파일과 함께 동기화됩니다. Oleafly는 모든 프로젝트에서 다음 항목을 조용히 제외합니다.

- `.aux`, `.log` 파일과 컴파일된 주 PDF 같은 빌드 출력. 결과 로그처럼 Git으로 추적하는 빌드 파일은 계속 Dropbox에 백업됩니다.
- Python의 `__pycache__` 폴더
- `.git` 폴더
- Oleafly 자체 작업 폴더
- 편집기가 만드는 임시 파일
- `.DS_Store` 같은 시스템 파일

그 밖에도 동기화되지 않는 항목이 몇 가지 있으며, 프로젝트 행에 건너뛴 항목으로 이유와 함께 나열됩니다. 심볼릭 링크, `node_modules`와 `.venv` 폴더, 16 GB보다 큰 파일, [일부 컴퓨터에서 사용할 수 없는 이름](#renames-and-file-names)을 가진 파일입니다.

컴퓨터의 다른 위치에 있는 폴더에서 연 프로젝트([그 자리에서 연 폴더](/docs/library/#folders-opened-in-place))는 동기화되지 않습니다. 프로젝트 목록에 그런 프로젝트가 몇 개인지 표시됩니다.

Git 이력과 [체크포인트](/docs/checkpoints/)는 동기화되지 않습니다.

### 프로젝트 세부 정보

각 프로젝트의 `project.json`도 동기화되므로 이름, 주 문서, 엔진, 표지 색상 같은 세부 정보가 프로젝트를 따라갑니다. 몇 가지 세부 정보는 한 컴퓨터에만 속하며 그 컴퓨터에 남습니다.

- 내보내기 경로
- 프로젝트를 숨겼는지 여부
- TeX 패키지 사양
- 체크포인트 캡처 정책
- 어느 프로젝트에서 포크했는지

### 노트

개인 [노트](/docs/notes/)는 각각 라이브러리 프로젝트처럼 동기화되고, 프로젝트 안의 노트는 그 프로젝트의 파일과 함께 동기화됩니다. 개인 노트가 두 컴퓨터에서 바뀌었다면 다른 컴퓨터의 버전이 `note (Laptop 2026-10-14).md` 같은 충돌 사본으로 노트의 폴더에 저장되며, 노트 메뉴의 **충돌 사본 비교**로 한 버전을 유지할 수 있습니다. 프로젝트 안의 노트는 다른 프로젝트 파일처럼 프로젝트의 `notes` 폴더에서 그 옆에 충돌 사본이 생깁니다.

### 설정

앱 설정은 AI 지침, AI 페르소나, 사용자 사전을 포함해 동기화됩니다. 일부 설정은 컴퓨터마다 따로 유지됩니다. **자동 동기화**가 켜져 있는지 여부, LaTeX의 **기본 컴파일 엔진**, 터미널의 **Shell**과 **Shell 경로**, 연동의 **Computer Use**, 실험 기능의 **연구 작업** 스위치, 연구의 **작업 명령에 기본적으로 네트워크 허용**이 그렇습니다. 이렇게 하면 다른 곳에서 켰다는 이유만으로 어떤 컴퓨터에서 에이전트가 내 데스크톱 앱을 쓰게 되는 일이 없습니다. 또 TeX 설치가 없는 컴퓨터는 다른 컴퓨터가 latexmk를 쓰더라도 Tectonic을 그대로 사용합니다.

AI 채팅, 비밀번호, API 키 등 비밀 정보는 절대 동기화되지 않습니다.

## Dropbox에 들어 있는 것

모든 항목은 `Apps/Oleafly` 폴더에 들어갑니다.

```text
Apps/Oleafly/
├── projects/
│   └── <project id>/
│       ├── files/          the project's files, under their own names
│       └── version.json    which version of each file belongs to the project
└── settings/
    └── settings.json       your synced settings
```

프로젝트 파일은 원래 이름을 유지하므로 Dropbox에서 열 수 있습니다. `Apps/Oleafly`의 파일을 직접 편집하거나 옮기는 것은 지원되지 않습니다. Oleafly는 그 폴더의 모든 것을 신뢰하지 않는 데이터로 취급하고 검사합니다.

## 동기화 한 회가 진행되는 방식

각 회는 같은 단계를 거칩니다.

1. Oleafly가 Dropbox에 지난 회 이후 어떤 프로젝트가 바뀌었는지 묻습니다. 바뀐 것이 없으면 요청 한 번으로 끝납니다.
2. 이 컴퓨터에서 각 프로젝트의 파일을 스캔합니다. 바뀌지 않은 파일은 다시 읽지 않고 빠르게 알아봅니다.
3. 각 파일마다 세 버전을 비교합니다. 이 컴퓨터의 버전, Dropbox의 버전, 양쪽이 마지막으로 일치했던 버전입니다. 이로써 어느 쪽이 바뀌었는지 알 수 있습니다.
4. 다른 컴퓨터에서 온 변경 사항을 임시 위치에 다운로드하고, 각 파일을 기록된 지문(해시)과 대조합니다. 그런 다음에야 파일이 프로젝트에 들어갑니다. 스캔 이후 이 컴퓨터에서 그 파일을 바꿨다면 Oleafly는 다음 회까지 그 파일을 건드리지 않습니다.
5. 이 컴퓨터의 변경 사항을 업로드한 다음 Dropbox 자체의 체크섬을 보낸 내용과 비교합니다.
6. 프로젝트의 버전 기록을 저장하며, 그 사이에 다른 컴퓨터가 기록을 저장하지 않았는지 확인합니다. 저장한 컴퓨터가 있었다면 더 새로운 기록으로 그 회를 다시 실행하므로 어느 컴퓨터의 작업도 사라지지 않습니다.
7. 마지막으로, 이 컴퓨터에서 삭제한 파일을 Dropbox에서 제거합니다.

## Oleafly가 동기화하는 시점

**자동 동기화**는 끄지 않는 한 켜져 있습니다. 켜져 있는 동안 Oleafly는 파일을 저장하고 몇 초 뒤에, 그리고 다른 컴퓨터가 내 Dropbox를 바꾼 직후에 동기화합니다. 그 사이에는 5분마다, Oleafly 창이 숨겨져 있으면 15분마다 확인합니다. 첫 번째 회는 Oleafly가 시작되고 약 20초 뒤에 실행되며, 설정 변경 사항은 변경하고 약 3초 뒤에 동기화됩니다. **자동 동기화**가 꺼져 있으면 Oleafly는 **지금 동기화**를 선택할 때 동기화하고, 연결할 때, **이 컴퓨터에서 동기화**를 다시 켤 때, 프로젝트의 스위치를 다시 켤 때 한 번 동기화합니다.

회가 실패하면, 예를 들어 오프라인일 때는 Oleafly가 30초 뒤에 다시 시도하고 실패할 때마다 더 오래 기다리며 최대 5분까지, 창이 숨겨져 있으면 15분까지 늘어납니다. 한 번이라도 성공하면 일반 일정으로 돌아갑니다. 컴퓨터가 다시 온라인이 되었을 때도 동기화합니다.

**지금 동기화**는 회를 바로 실행하고 결과를 메시지 하나로 보여 줍니다. 자동으로 실행되는 회는 팝업을 띄우지 않습니다. 상태는 프로젝트 섹션에 표시됩니다. 시간과 함께 표시되는 "마지막 동기화", "프로젝트를 동기화하는 중", 또는 문제를 설명하는 한 줄입니다.

Dropbox가 가득 찼거나, 프로젝트가 일시 중지되었거나, 충돌 사본이 생겼거나, 설정을 선택해야 하는 것처럼 사용자의 확인이 필요한 일이 있으면 설정 버튼에 작은 주황색 점이 나타납니다. 그러면 설정이 클라우드 동기화 화면으로 열려 무엇이 문제인지 먼저 볼 수 있습니다.

## 충돌

동기화 사이에 같은 파일이 두 컴퓨터에서 바뀌면 Oleafly는 두 버전을 모두 보관합니다. 이 컴퓨터의 버전은 원래 이름으로 남습니다. 다른 컴퓨터의 버전은 그 옆에 저장되며, 파일을 쓴 컴퓨터의 이름과 날짜가 붙습니다. 예를 들면 `ch1 (Laptop 2026-10-14).tex`입니다. 같은 날 두 번째 충돌이 생기면 이름에 번호가 붙습니다. 프로젝트 행에는 **닫기**를 선택할 때까지 충돌 사본이 나열됩니다.

두 파일을 모두 열어 원하는 내용을 남기고 필요 없는 사본은 삭제하세요.

`project.json`에는 충돌 사본이 생기지 않습니다. 대신 필드가 병합됩니다. 각 컴퓨터의 변경 사항이 유지되며, 두 컴퓨터가 같은 필드를 바꿨다면 이 컴퓨터의 값이 우선합니다.

### 저장하지 않은 편집은 안전합니다

동기화는 저장하지 않은 변경 사항이 있는 채로 편집기에 열려 있는 파일을 절대 덮어쓰지 않습니다. 다른 컴퓨터의 변경 사항은 기다립니다. 저장하고 나면 다음 회가 내 편집을 다른 편집과 똑같이 취급하므로, 양쪽이 파일을 바꿨다면 충돌 사본이 생깁니다.

열려 있지만 바꾸지 않은 파일은 다른 컴퓨터의 변경 사항이 도착하는 즉시 편집기에서 업데이트됩니다. 편집하는 도중에 변경이 도착하면 편집기가 디스크에서 파일이 바뀌었다고 알려 주며, **다시 불러오기** 또는 **내 버전 유지**를 선택합니다. 새 파일과 충돌 사본은 파일 트리에 나타나고, 다른 컴퓨터에서 삭제한 파일은 여기서도 닫힙니다.

### 이름 바꾸기와 파일 이름

파일 이름의 대소문자만 바꾸는 것은 삭제가 아니라 이름 바꾸기로 처리됩니다.

Oleafly는 다음 파일을 건너뛰고 프로젝트 행 아래에 나열합니다.

- `:`이 들어 있는 이름이나 `CON.tex` 같은 이름처럼 모든 컴퓨터에서 사용할 수 없는 이름의 파일
- 같은 폴더의 다른 이름과 대소문자만 다른 이름의 파일. 이미 동기화되고 있는 파일은 계속 동기화됩니다.

이 목록에는 Oleafly가 여기서 읽지 못했거나 다운로드하거나 업로드하지 못한 파일도 표시됩니다. 다운로드에 실패한 파일은 1시간 뒤에 다시 시도하며, 파일이 바뀌면 그보다 일찍 시도합니다.

## 파일 삭제

한 컴퓨터에서 파일을 삭제하면 다른 컴퓨터에서도 삭제됩니다. 그곳에서는 파일이 시스템 휴지통으로 이동하며, 시스템에 휴지통이 없으면 Oleafly 자체 휴지통 폴더로 이동합니다. 거기서 되살릴 수 있습니다.

Dropbox에서 기록이 없어졌다고 해서 컴퓨터의 파일이 삭제되는 일은 없습니다. 누군가 Dropbox에서 프로젝트 폴더를 직접 삭제하면 Oleafly가 프로젝트를 다시 업로드합니다. Dropbox에 있는 프로젝트 기록에 `project.json`이 없으면 Oleafly는 그 파일을 삭제하지 않고 다시 업로드합니다.

### 많은 파일 삭제를 막는 보호 기능

한 컴퓨터에서 프로젝트 파일의 절반 넘게 한꺼번에 삭제되고 그 수가 20개를 넘으면, Oleafly는 삭제를 전달하지 않습니다. 프로젝트의 모든 파일이 삭제된 경우에도 마찬가지입니다. 폴더를 옮기거나 이름을 바꾸는 것은 파일이 그대로 있으므로 해당되지 않습니다. 프로젝트에 "파일을 보호하려고 일시 중지됨"이 표시되고 두 가지 선택지가 나옵니다.

- **되돌려 놓기**는 Dropbox에서 파일을 복원합니다.
- **Dropbox에서도 삭제**는 확인한 뒤 Dropbox에서도 파일을 삭제합니다. 그러면 다른 컴퓨터에서도 파일이 사라집니다.

같은 점검은 반대 방향으로도 작동합니다. 예를 들어 기록이 이전 버전에서 복원되어 프로젝트의 Dropbox 기록에서 많은 파일이 갑자기 사라지면, Oleafly는 이 컴퓨터에서 그 파일들을 삭제하지 않습니다. 프로젝트에 "파일을 보호하려고 일시 중지됨"이 표시되고 두 가지 선택지가 나옵니다.

- **Dropbox에 되돌려 놓기**는 이 컴퓨터의 파일을 다시 업로드합니다.
- **여기에서도 삭제**는 확인한 뒤 그 파일들을 이 컴퓨터의 휴지통으로 옮깁니다.

## 프로젝트 목록

라이브러리의 각 프로젝트에는 크기와 마지막 동기화 시점을 보여 주는 행이 있습니다.

- 행의 스위치로 이 컴퓨터에서 프로젝트를 동기화하거나 여기서 일시 중지합니다.
- Dropbox에만 있는 프로젝트에는 다운로드 버튼이 있습니다. **모두 다운로드**는 이 컴퓨터의 휴지통에 있는 프로젝트를 제외한 모든 프로젝트를 다운로드합니다. 다운로드한 프로젝트는 라이브러리에 나타납니다.
- 프로젝트가 이 컴퓨터의 휴지통에 있으면 다운로드할 때 두 번째 사본을 만드는 대신 휴지통에서 복원합니다. 다음 동기화에서 다른 곳에서 바뀐 내용을 가져옵니다.
- Dropbox에서 다운로드한 프로젝트는 그 컴퓨터에서 신뢰하기 전까지 제한 모드로 열립니다. [그 자리에서 여는 폴더](/docs/library/#folders-opened-in-place)와 같은 신뢰 확인 창이 나타납니다.

### Dropbox에서 프로젝트 제거하기

공간을 확보하려면 프로젝트 행의 **…** 메뉴에서 **Dropbox에서 제거**를 선택하세요. 그러면 Dropbox에 있는 프로젝트 사본이 삭제됩니다. 프로젝트는 이 컴퓨터에 남고 여기서는 동기화가 멈춥니다. 다른 컴퓨터는 각자의 사본을 유지하며 "Dropbox에서 제거됨(이 컴퓨터 이름)"이라고 표시합니다.

프로젝트의 스위치를 다시 켜면 다시 업로드됩니다.

Dropbox에만 있는 프로젝트의 메뉴에도 **Dropbox에서 제거**가 있습니다. 이 메뉴는 Dropbox에서 프로젝트를 삭제하므로 이후에는 이 컴퓨터에서 다운로드할 수 없습니다. 이미 프로젝트가 있는 컴퓨터는 각자의 사본을 유지합니다.

Dropbox가 폴더를 바로 삭제하지 못해도 프로젝트는 제거된 것으로 표시되며, Oleafly가 이후 동기화에서 삭제를 마칩니다.

## 저장 공간과 가득 찬 Dropbox

클라우드 동기화 카드의 링은 Dropbox 사용량을 보여 주며 80%부터 빨간색이 됩니다. 무료 Dropbox Basic 계정은 2 GB를 제공합니다.

Dropbox가 가득 차면 업로드는 멈추지만 다운로드는 계속 작동합니다. 배너가 이를 알려 주고, 업로드하지 못한 각 프로젝트에도 표시됩니다. 가득 찬 동안 Oleafly는 업로드하기 전에 남은 공간을 확인하므로 들어갈 수 없는 파일은 보내지 않습니다. 공간을 확보하려면 다음 중 하나를 하세요.

- 큰 프로젝트의 동기화를 끕니다.
- Dropbox에서 프로젝트를 제거합니다.
- Dropbox에서 공간을 확보합니다.

공간이 생기면 동기화는 저절로 이어집니다.

## 오프라인과 중단된 동기화

오프라인일 때는 편집 내용이 컴퓨터에 남아 있으며 잃어버리는 것이 없습니다. 연결이 돌아오면 동기화가 다시 이어집니다.

회가 중간에 멈추면, 예를 들어 네트워크가 끊겼거나 Oleafly를 닫았다면 다음 회가 작업을 마칩니다. 오래 걸리는 첫 백업은 파일 200개 또는 256 MB마다 진행 상황을 저장하므로 처음부터 다시 시작하지 않습니다. **이 컴퓨터에서 동기화**를 끄면 실행 중인 회가 멈춥니다.

Git 명령이 프로젝트 파일을 바꾸는 동안에는, 예를 들어 터미널에서 체크아웃이나 풀을 실행하는 중에는 회가 기다렸다가 다음 회에 다시 시도합니다. Windows에서는 다른 프로그램이 열어 둔 파일을 몇 분 뒤에 다시 시도합니다.

Dropbox가 Oleafly에 속도를 늦춰 달라고 요청하거나 일시적인 오류가 생기면 Oleafly가 저절로 다시 시도합니다.

이 컴퓨터의 디스크 공간이 부족해지면 공간을 확보할 때까지 다운로드가 대기합니다. 업로드는 계속됩니다.

## 설정 동기화

컴퓨터를 처음 연결하면 Oleafly가 그 컴퓨터의 설정을 Dropbox에 있는 설정과 비교합니다. 서로 다르면 한 번 묻습니다. "Oleafly에서 어떤 설정을 사용할까요?" **Dropbox 설정 사용** 또는 **이 컴퓨터의 설정 유지**를 선택하세요. 대화 상자를 닫으면 저절로 다시 나타나지 않습니다. 같은 두 선택지가 클라우드 동기화 카드에 남아 있으며, 하나를 고르기 전에는 아무것도 덮어쓰지 않습니다.

그 후에는 설정이 저절로 병합됩니다.

- 서로 다른 컴퓨터에서 서로 다른 설정을 바꾸면 변경 사항이 모두 유지됩니다.
- 같은 설정을 양쪽에서 바꿨다면 이 컴퓨터의 값이 우선합니다.
- 사전에 있는 단어 같은 목록은 합쳐집니다. AI 페르소나는 하나씩 병합되므로 두 컴퓨터에서 수정한 페르소나도 하나의 페르소나로 남습니다.

Dropbox의 설정을 직접 불러오려면 **설정 → 일반 → 가져오기**를 열고 **클라우드에서 가져오기**를 선택하세요. 설정 파일을 가져올 때와 같은 검토 단계가 나타납니다.

## 컴퓨터와 계정

### 이 컴퓨터에 이름 붙이기

각 컴퓨터에는 이름이 있습니다. 처음에는 컴퓨터의 호스트 이름입니다. 클라우드 동기화 카드에서 이름을 클릭해 바꿀 수 있습니다. 다른 컴퓨터는 이 이름을 충돌 사본과 "Dropbox에서 제거됨" 메모에 표시합니다.

### 연결 해제

**고급**을 열고 **연결 해제**를 선택한 다음 확인하세요. 이 컴퓨터에서 동기화가 멈추고 Oleafly의 Dropbox 접근 권한이 사라집니다. 프로젝트는 이 컴퓨터와 Dropbox에 그대로 남습니다. 그 시점에 Oleafly가 Dropbox에 연결하지 못해도 이 컴퓨터에서는 연결이 해제되고 그 사실을 알려 주며, Dropbox의 연결된 앱에서 Oleafly를 직접 제거할 수 있습니다.

### 다른 Dropbox 계정으로 전환하기

다른 Dropbox 계정을 연결하면 처음부터 새로 시작합니다. 이전 계정과는 아무것도 비교하지 않으며, 그 때문에 삭제되는 것도 없습니다.

### 접근 권한이 종료될 때

Oleafly의 접근 권한이 종료되면, 예를 들어 Dropbox의 연결된 앱에서 Oleafly를 제거했다면 카드에 "Dropbox 액세스가 종료되었습니다. 계속 동기화하려면 다시 연결하세요."라고 표시됩니다. **다시 연결**을 선택하세요.

### 다른 컴퓨터의 더 새로운 Oleafly

다른 컴퓨터에서 더 새로운 버전의 Oleafly를 실행해 프로젝트를 더 새로운 형식으로 저장했다면, 이전 버전은 그 프로젝트의 동기화를 멈추고 [Oleafly를 업데이트](/docs/updates/)하라고 안내합니다.

## 안전 점검

- Dropbox에서 온 모든 파일은 무언가를 교체하기 전에 기록된 지문과 대조해 검사합니다.
- Dropbox에서 온 어떤 것도 `.git` 안, 프로젝트 폴더 밖, 또는 심볼릭 링크를 통해서는 쓰이지 않습니다.
- 이 버전의 Oleafly가 열 수 없는 Dropbox의 `project.json`은 이 컴퓨터에 있는 것을 절대 대체하지 않습니다.
- 컴파일 중에 셸 명령 실행을 신뢰한 프로젝트는 Dropbox에서 파일이 도착하면 다음 컴파일 전에 다시 확인을 요청합니다. Git 풀 뒤와 같습니다.
- Oleafly는 `Apps/Oleafly`의 모든 것을 신뢰하지 않는 데이터로 취급하고 검사합니다.
- Oleafly는 Dropbox에 있는 파일에 종단 간 암호화를 추가하지 않습니다. 파일은 다른 파일과 똑같이 Dropbox에 저장됩니다.

## 문제 해결

| 메시지 또는 증상 | 해결 방법 |
| --- | --- |
| 브라우저가 Oleafly로 돌아오지 않음 | **로그인에 문제가 있나요? 코드를 붙여넣으세요**를 선택하고 Dropbox에 표시된 코드를 붙여 넣으세요. |
| "Dropbox 액세스가 종료되었습니다. 계속 동기화하려면 다시 연결하세요." | **다시 연결**을 선택하고 브라우저에서 Oleafly를 승인하세요. |
| "Oleafly에서 어떤 설정을 사용할까요?" | **Dropbox 설정 사용** 또는 **이 컴퓨터의 설정 유지**를 선택하세요. 대화 상자를 닫으면 나중에 클라우드 동기화 카드에서 정할 수 있습니다. 아무것도 덮어쓰지 않습니다. |
| "파일을 보호하려고 일시 중지됨" | 많은 파일이 여기 또는 Dropbox에서 한꺼번에 삭제되었습니다. 파일을 남기려면 **되돌려 놓기** 또는 **Dropbox에 되돌려 놓기**를, 삭제하려는 것이라면 **Dropbox에서도 삭제** 또는 **여기에서도 삭제**를 선택하세요. |
| `ch1 (Laptop 2026-10-14).tex` 같은 파일이 나타남 | 이름에 적힌 컴퓨터에서 만든 충돌 사본입니다. 두 파일을 비교해 원하는 내용을 남기고 나머지는 삭제하세요. |
| 프로젝트 행에 파일을 건너뛰었다고 표시됨 | 목록을 열어 각 파일과 이유를 확인하세요. 모든 컴퓨터에서 사용할 수 없거나 다른 이름과 겹치는 이름의 파일은 이름을 바꾸세요. |
| 설정 버튼에 주황색 점이 있음 | 클라우드 동기화를 확인해야 합니다. 설정을 열어 클라우드 동기화 카드를 읽어 보세요. |
| "Oleafly가 Dropbox에 있는 사본을 읽을 수 없어 이 프로젝트가 동기화되지 않고 있습니다." | **이 컴퓨터의 사본으로 바꾸기**를 선택하세요. Dropbox 사본에만 있는 내용은 사라지므로 먼저 다른 컴퓨터를 확인하세요. |
| "Oleafly가 Dropbox에 있는 설정을 읽을 수 없습니다." | **이 컴퓨터의 설정 사용**을 선택해 Dropbox 설정을 교체하세요. |
| "이 컴퓨터의 디스크 공간이 부족해지고 있습니다." | 디스크 공간을 확보하세요. 동기화는 저절로 이어집니다. |
| "이 프로젝트에는 파일이 100,000개 넘게 있습니다. 너무 많아서 동기화할 수 없습니다." | 프로젝트에 필요 없는 파일을 폴더 밖으로 옮기세요. |
| "Dropbox에서 제거됨" 뒤에 컴퓨터 이름이 표시됨 | 그 컴퓨터가 Dropbox에서 프로젝트를 제거했습니다. 여기에 있는 내 사본은 안전합니다. 프로젝트의 스위치를 켜면 다시 업로드됩니다. |
| "Dropbox가 가득 찼습니다." | 큰 프로젝트의 동기화를 끄거나, Dropbox에서 프로젝트를 제거하거나, Dropbox에서 공간을 확보하세요. 다운로드는 계속 작동하며, 공간이 생기면 동기화가 이어집니다. |
| "Dropbox가 이번 달 업로드 한도에 도달했습니다." | Dropbox는 일부 계정의 월별 업로드량을 제한합니다. 편집 내용은 이 컴퓨터에 남아 있으며, Dropbox가 다시 허용하면 업로드됩니다. |
| "Dropbox에 연결하지 못했습니다. Oleafly가 다시 시도합니다." | 연결을 확인하세요. 편집 내용은 이 컴퓨터에 남아 있으며, 다시 온라인이 되면 Oleafly가 동기화합니다. |
| "이 프로젝트는 더 새로운 버전의 Oleafly로 동기화되었습니다. 계속 동기화하려면 Oleafly를 업데이트하세요." | 이 컴퓨터에서 [Oleafly를 업데이트](/docs/updates/)하세요. |
| 다운로드한 프로젝트가 제한 모드로 열림 | 프로젝트에 무엇이 들어 있는지 확인한 뒤 이 컴퓨터에서 신뢰하세요. |
| 아무것도 동기화되지 않음 | **이 컴퓨터에서 동기화**가 켜져 있는지, 프로젝트의 스위치가 켜져 있는지 확인하세요. Oleafly는 열려 있는 동안에만 동기화합니다. **자동 동기화**가 꺼져 있다면 **지금 동기화**를 선택하세요. |

Git으로 프로젝트를 옮기려면 [GitHub 동기화](/docs/github-sync/)를 참고하세요. Oleafly가 컴퓨터에 보관하는 모든 것은 [내 파일과 데이터](/docs/where-your-data-lives/)를 참고하세요.
