# 你的文件与数据

了解哪些内容会随项目一起移动，以及如何备份源码、历史记录和应用数据。

你的稿件是一个由普通源文件组成的文件夹。你可以用其他编辑器打开这些文件、备份它们，或把它们带出 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，然后复制或克隆稿件项目。在那台机器上重新连接已链接的文件夹和模型提供商。项目会带着它所选的编译器和元数据；额外的工具或宏包可能需要安装。固定了这台电脑上没有的版本的 Typst 项目，会在编译前提示下载该版本。

## 屏幕上的路径

位于你主目录内的路径，在设置、版本历史、引擎和代理详情以及对话中显示为 `~/…`。在设置中，文件和文件夹路径还会保持模糊，直到你把鼠标悬停在上面或用 Tab 键聚焦到它们，因此截图不会暴露你的文件存放在哪里。

## 网络访问

写作和本地校对都在你的机器上进行。托管 AI 会收到提供给所选提供商的上下文。读取图片和扫描版 PDF 的工具使用本地的 Ollama 模型，除非你为它们选择托管模型或 Mathpix，此时文件会发送给那个服务。Zotero 引用会与你电脑上的 Zotero 应用通信，连接账号时则与 zotero.org 通信。引用搜索、Zotero 导入、alphaXiv 工具、GitHub 同步、Typst 包和版本下载、其他下载以及更新检查，会联系各自的服务。[实时协作](/docs/collaboration/)会把每个共享的项目发送到该项目所共享的协作服务器。[云同步](/docs/cloud-sync/)会把你的项目库中的项目和设置发送到你自己的 Dropbox。打开“设置 → 帮助与关于”会获取一些公开数字：项目在 GitHub 上的 Star 数和 Fork 数，以及 Discord 社区中有多少成员在线。这些请求不携带任何账号、项目或使用情况信息，离线模式会跳过 Discord 的那一个。Tectonic 和 Typst 都支持通过离线模式进行缓存编译。

[阅读产品原则 →](/docs/philosophy/)
