# 你的檔案與資料

了解哪些內容會跟著專案走，以及如何備份原始碼、歷史記錄與應用程式資料。

你的稿件是一個由一般原始碼檔案組成的資料夾。你可以用其他編輯器開啟這些檔案、備份它們，或把它們帶離 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 會改放在 ProgramData（通常是 `C:\ProgramData`）裡，資料夾名稱是 `Oleafly-` 加上一段短代碼。不需要管理員權限。如果 Oleafly 也無法設定那個資料夾，它會這樣告訴你。你可以繼續用 Tectonic 編譯，或自己把 TeX Live 安裝在 `C:\texlive`。

**管理 TeX 發行版**下 TinyTeX 的那一列會顯示該資料夾；把滑鼠停在模糊的路徑上就能讀到。請從那一列移除 TinyTeX，而不要手動刪除資料夾。

## 備份你的工作

| 你想保留的內容 | 保留方式 |
| --- | --- |
| 稿件原始碼與專案資源 | 複製專案資料夾，或匯出原始碼 ZIP |
| Git 提交 | 備份儲存庫，或推送到你設定的遠端 |
| 已儲存的檢查點 | 從版本管理匯出加密的歷史記錄壓縮檔 |
| 應用程式偏好設定與本機記錄 | 把 Oleafly 的資料目錄納入你平常的電腦備份 |
| 已連結的資料與參考文獻 | 備份它們的原始資料夾 |
| 專案庫中的專案與設定（存放在這台電腦之外） | 開啟[雲端同步](/docs/cloud-sync/)，在你的 Dropbox 保留一份副本 |

原始碼 ZIP 不含建置快取與 Git。遠端儲存庫請使用 [GitHub 同步](/docs/github-sync/)，檢查點歷史記錄請使用[檢查點壓縮檔](/docs/checkpoints/)。

## 移到另一台電腦

安裝 Oleafly，然後複製或 clone 稿件專案。在那台機器上重新連接已連結資料夾與模型供應商。專案會帶著它的編譯器選擇與中繼資料；額外的工具或套件可能需要另外安裝。如果 Typst 專案鎖定的版本這台電腦沒有，會在編譯前提議下載該版本。

## 畫面上的路徑

位於你家目錄內的路徑，在設定、版本歷史記錄、引擎與代理程式詳細資料，以及聊天中，會顯示為 `~/…`。在設定中，檔案與資料夾路徑也會保持模糊，直到你把滑鼠移到上面或用 Tab 鍵移到它們，所以螢幕截圖不會洩漏你的檔案放在哪裡。

## 網路存取

寫作與本機校對都在你的電腦上進行。託管的 AI 會收到提供給所選供應商的脈絡。讀取圖片和掃描 PDF 的工具會使用本機的 Ollama 模型，除非你為它們選擇託管的模型或 Mathpix，那時檔案會送到那個服務。Zotero 引用會與你電腦上的 Zotero 應用程式溝通；連接帳號時，則與 zotero.org 溝通。引用搜尋、Zotero 匯入、alphaXiv 工具、GitHub 同步、Typst 套件與版本下載、其他下載，以及更新檢查，會連到各自的服務。[即時協作](/docs/collaboration/)會把每個共用的專案，送到它所共用的協作伺服器。[雲端同步](/docs/cloud-sync/)會把你專案庫中的專案與設定，送到你自己的 Dropbox。開啟 設定 → 說明與關於 會取得公開的數字：專案的 GitHub 星號與 fork 數量，以及 Discord 社群中有多少成員在線上。這些請求不帶任何帳號、專案或用量資訊，而且離線模式會略過 Discord 的那一個。Tectonic 與 Typst 都支援透過離線模式使用快取編譯。

[閱讀產品原則 →](/docs/philosophy/)
