跳转到内容
Oleaflyv0.4.12

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

你的稿件是一个由普通源文件组成的文件夹。你可以用其他编辑器打开这些文件、备份它们,或把它们带出 Oleafly。

你的工作和数据存放在哪里在你的电脑上,Oleafly 读写项目文件夹(其中有源码、图片、参考文献、project.json 和 Git 历史),以及它自己的数据文件夹(其中有设置、加密的密钥、对话和检查点)。它就地读取已链接文件夹,并读取 Zotero 应用而不做任何改动。只有在你使用需要联网服务的功能时,才会联系这些在线服务:托管的 AI 提供商、GitHub、研究服务、下载和更新,以及协作服务器。你的电脑在线,仅在你使用时项目文件夹源码、图片、.bib,project.json, .gitOleafly 数据设置和密钥,对话、检查点Oleafly已链接文件夹留在原处Zotero 应用只读托管的 AI 提供商GitHub研究服务下载和更新协作服务器你的工作和数据存放在哪里在你的电脑上,Oleafly 读写项目文件夹(其中有源码、图片、参考文献、project.json 和 Git 历史),以及它自己的数据文件夹(其中有设置、加密的密钥、对话和检查点)。它就地读取已链接文件夹,并读取 Zotero 应用而不做任何改动。只有在你使用需要联网服务的功能时,才会联系这些在线服务:托管的 AI 提供商、GitHub、研究服务、下载和更新,以及协作服务器。你的电脑在线,仅在你使用时项目文件夹源码、.bib、project.json, .gitOleafly 数据设置、密钥、对话、检查点Oleafly已链接文件夹留在原处Zotero 应用只读托管的 AI 提供商GitHub研究服务下载和更新协作服务器
你的项目、Oleafly 自己的数据和已链接文件夹都留在你的电脑上。只有在你使用需要某项在线服务的功能时,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 上的文件夹位置,以及笔记的文件夹里有什么,参见笔记的存放位置。

当你从设置 → 引擎 → 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 都支持通过离线模式进行缓存编译。

阅读产品原则 →

图片预览

无法加载 AI 回答

请重试,或搜索文档。