你的文件与数据
了解哪些内容会随项目一起移动,以及如何备份源码、历史记录和应用数据。
你的稿件是一个由普通源文件组成的文件夹。你可以用其他编辑器打开这些文件、备份它们,或把它们带出 Oleafly。
项目文件
标题为“项目文件”的部分项目库中的项目通常位于 ~/.oleafly/projects/ 下。一个项目可以包含 LaTeX、Typst 或 Markdown 主文档、参考文献、图片和研究资料。
project.json 记录项目的身份和设置,包括它的主文档、引擎和固定的 Typst 版本。.git 目录保存 Git 历史。Oleafly 创建或导入的项目通常以其文件的一次提交作为开端,这次提交名为“Create project”(参见 Git 与源代码管理)。.oleafly/build/ 目录包含生成的构建输出,可以通过编译重新生成。
Typst 项目可以把它导入的包的副本保存在 typst-packages 文件夹中,这样它就能离线编译,也能在其他电脑上编译。Typst 也会使用项目 fonts 文件夹中的字体。这两个文件夹都会随项目一起移动。
你就地打开的文件夹会留在原处。Oleafly 把该文件夹的构建、设置、检查点和对话保存在自己的数据文件夹中,所以不会往你的文件夹里添加任何东西。
保存在项目之外的数据
标题为“保存在项目之外的数据”的部分应用偏好设置、加密的提供商凭据、对话和用量记录、下载的工具(例如额外的 Typst 版本)以及保存的检查点,都属于本地应用存储。Oleafly 在助手或代理每一轮之前保留的项目副本也在其中,它们让你能撤销那一轮改动的文件。@ 搜索所读取的 Zotero 库副本同样保存在那里,而不是在项目中。复制稿件文件夹并不会复制所有这些应用数据。
已链接的文件夹仍留在原来的位置。仅仅因为你链接了它们,源码压缩包并不会包含它们的内容。
笔记的位置
标题为“笔记的位置”的部分笔记是你电脑上的 Markdown 文件。每篇个人笔记都是项目文件夹中的一个文件夹,紧挨着你的项目库项目。项目笔记是项目 notes 文件夹中的一个 .md 文件,所以它会随项目一起移动。Windows、macOS 和 Linux 上的文件夹位置,以及笔记的文件夹里有什么,参见笔记的存放位置。
TinyTeX 的位置
标题为“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 数据目录纳入你日常的电脑备份 |
| 已链接的数据和参考文献 | 备份它们的原始文件夹 |
| 项目库中的项目和设置(保存在这台电脑之外) | 开启云同步,在你的 Dropbox 中保留一份副本 |
源码 ZIP 不包含构建缓存和 Git。远程仓库请使用 GitHub 同步,检查点历史请使用检查点归档。
迁移到另一台电脑
标题为“迁移到另一台电脑”的部分安装 Oleafly,然后复制或克隆稿件项目。在那台机器上重新连接已链接的文件夹和模型提供商。项目会带着它所选的编译器和元数据;额外的工具或宏包可能需要安装。固定了这台电脑上没有的版本的 Typst 项目,会在编译前提示下载该版本。
屏幕上的路径
标题为“屏幕上的路径”的部分位于你主目录内的路径,在设置、版本历史、引擎和代理详情以及对话中显示为 ~/…。在设置中,文件和文件夹路径还会保持模糊,直到你把鼠标悬停在上面或用 Tab 键聚焦到它们,因此截图不会暴露你的文件存放在哪里。
网络访问
标题为“网络访问”的部分写作和本地校对都在你的机器上进行。托管 AI 会收到提供给所选提供商的上下文。读取图片和扫描版 PDF 的工具使用本地的 Ollama 模型,除非你为它们选择托管模型或 Mathpix,此时文件会发送给那个服务。Zotero 引用会与你电脑上的 Zotero 应用通信,连接账号时则与 zotero.org 通信。引用搜索、Zotero 导入、alphaXiv 工具、GitHub 同步、Typst 包和版本下载、其他下载以及更新检查,会联系各自的服务。实时协作会把每个共享的项目发送到该项目所共享的协作服务器。云同步会把你的项目库中的项目和设置发送到你自己的 Dropbox。打开“设置 → 帮助与关于”会获取一些公开数字:项目在 GitHub 上的 Star 数和 Fork 数,以及 Discord 社区中有多少成员在线。这些请求不携带任何账号、项目或使用情况信息,离线模式会跳过 Discord 的那一个。Tectonic 和 Typst 都支持通过离线模式进行缓存编译。