# 파일과 데이터

프로젝트와 함께 이동하는 것이 무엇인지 알아 두고, 소스와 이력과 앱 데이터를 백업하는 방법을 확인하세요.

원고는 평범한 소스 파일이 든 폴더입니다. 그 파일을 다른 편집기로 열 수도 있고, 백업할 수도 있고, Oleafly 밖으로 가져갈 수도 있습니다.

## 프로젝트 파일

라이브러리 프로젝트는 보통 `~/.oleafly/projects/` 아래에 있습니다. 프로젝트에는 LaTeX, Typst, Markdown 주 문서, 참고문헌, 그림, 연구 자료가 들어갈 수 있습니다.

`project.json`은 프로젝트의 식별 정보와 설정을 기록합니다. 주 문서, 엔진, 고정된 Typst 버전도 여기에 들어갑니다. `.git` 디렉터리에는 Git 이력이 들어 있습니다. Oleafly가 만들거나 가져온 프로젝트는 보통 파일 전체를 하나의 커밋으로 묶은 상태에서 시작하며, 그 커밋의 이름은 “Create project”입니다([Git과 소스 관리](/docs/git-history/#the-first-commit) 참고). `.oleafly/build/` 디렉터리에는 생성된 빌드 출력이 있으며, 컴파일하면 다시 만들 수 있습니다.

Typst 프로젝트는 가져오는 패키지의 사본을 `typst-packages` 폴더에 보관할 수 있어서, 오프라인에서도 다른 컴퓨터에서도 컴파일됩니다. Typst는 프로젝트의 `fonts` 폴더에 있는 글꼴도 사용합니다. 두 폴더는 프로젝트와 함께 이동합니다.

[제자리에서 연](/docs/library/#folders-opened-in-place) 폴더는 있던 자리에 그대로 있습니다. Oleafly는 그 폴더의 빌드, 설정, 체크포인트, 채팅을 자체 데이터 폴더에 보관하므로 내 폴더에는 아무것도 추가되지 않습니다.

## 프로젝트 밖에 저장되는 데이터

앱 환경설정, 암호화된 제공자 자격 증명, 채팅과 사용량 기록, 추가 Typst 버전 같은 내려받은 도구, 저장된 체크포인트는 로컬 앱 저장소에 속합니다. 어시스턴트나 에이전트의 매 차례가 시작되기 전에 Oleafly가 보관하는 프로젝트 사본도 마찬가지입니다. 이 사본으로 그 차례가 바꾼 파일을 되돌릴 수 있습니다. `@` 검색이 읽는 Zotero 라이브러리 사본도 프로젝트가 아니라 거기에 있습니다. 원고 폴더를 복사해도 이 앱 데이터가 모두 복사되지는 않습니다.

[연결된 폴더](/docs/linked-folders/)는 원래 위치에 그대로 있습니다. 연결했다는 이유만으로 소스 압축 파일에 그 내용이 들어가지는 않습니다.

## 노트가 있는 곳

[노트](/docs/notes/)는 내 컴퓨터의 Markdown 파일입니다. 개인 노트는 각각 프로젝트 폴더 안에, 라이브러리 프로젝트 옆에 폴더로 저장됩니다. 프로젝트 노트는 프로젝트의 `notes` 폴더에 있는 `.md` 파일이므로 프로젝트와 함께 이동합니다. Windows, macOS, Linux의 폴더와 노트 폴더에 들어 있는 것은 [노트가 저장되는 위치](/docs/notes/#where-notes-are-stored)를 참고하세요.

## TinyTeX가 저장되는 곳

**설정 → 엔진 → LaTeX**에서 TinyTeX를 설치하면 Oleafly는 이를 `~/.oleafly/tinytex`에 둡니다. Windows에서 사용자 폴더 이름에 한국어나 중국어 이름처럼 악센트 문자나 비라틴 문자가 있으면 예외입니다. TeX Live가 그런 폴더에서는 실행되지 못하기 때문입니다. 이때 TinyTeX는 보통 `C:\ProgramData`인 ProgramData 안에서 `Oleafly-` 뒤에 짧은 코드가 붙은 이름의 폴더에 들어갑니다. 관리자 권한은 필요하지 않습니다. Oleafly가 그 폴더도 만들 수 없으면 그렇다고 알려 줍니다. 그래도 Tectonic으로 계속 컴파일하거나, `C:\texlive`에 TeX Live를 직접 설치할 수 있습니다.

**TeX 배포판 관리** 아래의 TinyTeX 행에는 그 폴더가 표시되며, 흐리게 가려진 경로 위에 마우스를 올리면 읽을 수 있습니다. TinyTeX를 지울 때는 폴더를 직접 삭제하지 말고 그 행에서 제거하세요.

## 작업 백업하기

| 보관하려는 것 | 보관 방법 |
| --- | --- |
| 원고 소스와 프로젝트 자산 | 프로젝트 폴더를 복사하거나 소스 ZIP을 내보냅니다 |
| Git 커밋 | 저장소를 백업하거나 설정해 둔 원격 저장소로 푸시합니다 |
| 저장된 체크포인트 | 버전 관리에서 암호화된 이력 아카이브를 내보냅니다 |
| 앱 환경설정과 로컬 기록 | 평소 쓰는 컴퓨터 백업에 Oleafly 데이터 디렉터리를 포함합니다 |
| 연결된 데이터와 참고문헌 | 원래 폴더를 백업합니다 |
| 이 컴퓨터 밖에 두는 라이브러리 프로젝트와 설정 | [클라우드 동기화](/docs/cloud-sync/)를 켜서 Dropbox에 사본을 보관합니다 |

소스 ZIP에는 빌드 캐시와 Git이 들어가지 않습니다. 원격 저장소에는 [GitHub 동기화](/docs/github-sync/)를, 체크포인트 이력에는 [체크포인트 아카이브](/docs/checkpoints/)를 쓰세요.

## 다른 컴퓨터로 옮기기

Oleafly를 설치하고 원고 프로젝트를 복사하거나 클론하세요. 그 컴퓨터에서 연결된 폴더와 모델 제공자를 다시 연결하세요. 프로젝트에는 컴파일러 선택과 메타데이터가 함께 들어 있으며, 추가 도구나 패키지는 설치해야 할 수 있습니다. 이 컴퓨터에 없는 버전을 고정한 Typst 프로젝트는 컴파일하기 전에 그 버전을 내려받을지 묻습니다.

## 화면에 표시되는 경로

홈 폴더 안의 경로는 설정, 버전 이력, 엔진과 에이전트 상세 정보, 채팅에서 `~/…`로 표시됩니다. 설정에서는 파일과 폴더 경로가 마우스를 올리거나 Tab 키로 이동하기 전까지 흐리게 처리되어, 스크린샷에 파일 위치가 드러나지 않습니다.

## 네트워크 접근

글쓰기와 로컬 교정은 이 컴퓨터에서 이루어집니다. 호스팅 AI는 선택한 제공자에게 전달된 맥락을 받습니다. 이미지와 스캔한 PDF를 읽는 도구는 호스팅 모델이나 Mathpix를 고르지 않는 한 로컬 Ollama 모델을 사용하며, 고르면 파일이 그 서비스로 전송됩니다. Zotero 인용은 이 컴퓨터의 Zotero 앱과 통신하며, 계정을 연결했다면 zotero.org와 통신합니다. 인용 검색, Zotero 가져오기, alphaXiv 도구, GitHub 동기화, Typst 패키지와 버전 다운로드, 그 밖의 다운로드, 업데이트 확인은 각각의 서비스에 접속합니다. [실시간 협업](/docs/collaboration/)은 공유된 프로젝트마다 그 프로젝트가 공유된 협업 서버로 보냅니다. [클라우드 동기화](/docs/cloud-sync/)는 라이브러리 프로젝트와 설정을 내 Dropbox로 보냅니다. 설정 → 도움말 및 정보를 열면 공개된 수치를 가져옵니다. 프로젝트의 GitHub 별 수와 포크 수, Discord 커뮤니티에 접속 중인 멤버 수입니다. 이 요청에는 계정, 프로젝트, 사용량 정보가 담기지 않으며, 오프라인 모드에서는 Discord 요청을 건너뜁니다. Tectonic과 Typst는 둘 다 오프라인 모드를 통한 캐시된 컴파일을 지원합니다.

[제품 원칙 읽기 →](/docs/philosophy/)
