跳转到内容
Oleaflyv0.4.12

常见问题与故障排查

关于入门、项目、编译、助手和备份的快速解答。

不需要。下载 Oleafly,打开,就可以写作。云端 AI 提供商、GitHub 或 Dropbox 等可选服务使用它们各自的账号。

Oleafly 支持 LaTeX、Typst 和 Markdown 吗?

标题为“Oleafly 支持 LaTeX、Typst 和 Markdown 吗?”的部分

支持。创建项目时选择引擎。每种引擎有各自的编辑和导出能力。快速入门会带你生成第一份 PDF。

可以。你可以导入项目源码、ZIP 压缩包或 Git 仓库。Oleafly 还提供了 DOCX 和基于文本的 PDF 的转换路径。请阅读导入已有项目,选择合适的方式。

没有云端连接时,你也可以写作、整理文件、使用本地校对,以及运行已下载的本地 AI 模型。Tectonic 可以用已缓存的宏包编译。新宏包、远程参考文献、云端模型、GitHub 和下载都需要联网。离线之前,请先成功编译一次,把项目准备好。

你的项目是本地库中的普通文件夹。你可以复制它们、备份它们,或在其他工具中打开它们。数据存放在哪里介绍了项目文件、应用设置和检查点。

我可以用 Oleafly 写学位论文或简历吗?

标题为“我可以用 Oleafly 写学位论文或简历吗?”的部分

可以。从学位论文工作流或简历工作流开始。它们和研究论文使用同样的编辑器、预览、参考文献和导出工具。

请确认文件来自官方发布页 (在新标签页中打开),并且与你的平台相符。按照安装指南中该平台的首次启动步骤操作。

选择与你电脑匹配的架构,然后选 AppImage、Debian 软件包或 RPM。系统要求参见 Linux 安装。

Tectonic 可能需要下载这份文档用到的宏包,一台电脑上的首次编译还会获取一批常用宏包。它们会被缓存,供之后的构建使用。宏包仍在下载时,编译可以超过通常的五分钟时限。打开日志可以看到正在发生什么。

如果离线模式已开启,请在提示中选择 关闭并编译,或者把它关闭一次编译,以获取该宏包。在系统 TeX 工具链上,请使用错误中的 查找并安装。来自 Debian、Ubuntu 或 Fedora 的 TeX Live 通过 apt 或 dnf 获取宏包。参见 LaTeX 引擎与宏包。

我选了 pdfLaTeX,Oleafly 却要求安装 TeX 发行版

标题为“我选了 pdfLaTeX,Oleafly 却要求安装 TeX 发行版”的部分

pdfLaTeX、XeLaTeX、LuaLaTeX、upLaTeX 和 pLaTeX 运行在你电脑上安装的 TeX 发行版之上。没有安装时,选择其中任何一个都会在编译之前打开一个对话框。选择 下载并使用 TinyTeX 来安装一个,或选择 切换回 Tectonic 回到内置引擎。编译失败后,预览会以 下载并使用 TinyTeX 和 使用 Tectonic 的形式提供同样的选择。参见没有安装 TeX 时。

MiKTeX 的 latexmk 运行在 Perl 之上,而 MiKTeX 不包含 Perl。请安装 Strawberry Perl,或从 设置 → 引擎 → LaTeX 安装 TinyTeX,它自带 Perl,并会从 MiKTeX 手中接管编译。参见 MiKTeX 与 Perl。

字体没有这些字符的字形。这种情况最常见于韩文、中文和日文文本,TeX 会略去这些字符,而不让编译失败。Oleafly 会发出警告,并在日志中列出它们。在 LaTeX 中,请粘贴警告里为你的文字给出的设置。在 Typst 中,请下载通知提供的字体包,或把包含这些字符的字体添加到项目的 fonts 文件夹。在 Markdown 中,请在 YAML 头部把 mainfont 或 CJKmainfont 设为包含它们的字体。参见PDF 中缺失的字符和显示为方框的字符。

一次编译最长可以运行 5 分钟。宏包仍在下载时,时限最多会延长到 30 分钟。Markdown 转 PDF 有 15 分钟,Quarto 和 Calepin 有一个小时。请再编译一次:下载会从中断的地方继续。对于 Tectonic 上的长草稿,请在编译菜单中把 编译模式 设为 快速。

新项目可以使用我自己的 TeX 安装吗?

标题为“新项目可以使用我自己的 TeX 安装吗?”的部分

可以。打开 设置 → 引擎 → LaTeX,把 默认编译引擎 设为 latexmk(系统 TeX)。之后新建、导入和转换的 LaTeX 项目都会从它开始。参见为新项目设置默认值。

这些宏包会在文档编译时运行其他程序,而 Oleafly 默认会阻止这一点。它们需要系统 LaTeX。如果你信任项目中的每个文件,请选择编辑器上方横幅中的 允许外部命令。参见允许外部命令。

打开 日志,先检查未定义的引用和交叉引用。在导出之前,预检可以帮你找到受影响的源码位置。

让助手读取日志、修复错误,然后再次编译。如果你想在过程中审阅它提出的操作,请使用 请求批准。你也可以把日志贴到 Discord 的求助论坛里。

可用的格式取决于引擎和文档类型。请查看导出表格。

可以连接模型提供商、使用本地模型,或选择 CLI 代理。设置 AI 介绍了每条路径。

不必。写作、编译、引用、预览、图表、项目历史和导出,不用助手也都能使用。

它可以处理项目文件、查找文献来源、检查 PDF、创建图片、运行工具,并帮助修复构建。请选择适合这项工作的计划和批准策略。参见聊天与工具。

模型旁边的“已验证”是什么意思?

标题为“模型旁边的“已验证”是什么意思?”的部分

该模型通过了一次工具调用探测。它帮助你选择适合项目操作的模型;它不评估模型写作或研究的质量。参见设置 AI。

有些提供商和 CLI 代理不会报告用量。“未知”表示这个值不可用。请阅读用量与预算。

可以。使用内置的 CLI 代理连接,启用 Oleafly 的本地 MCP 服务器,或把你的代理连接到 oleafly 命令,它在应用关闭时同样可用。

打开检查点,对比成功构建时的源码并恢复某个版本。你自己管理的 Git 提交则使用源代码管理。

可以。通过实时协作,你和合著者借助你们团队运行的协作服务器同时编辑同一个项目。你们每个人都在自己的电脑上以文件的形式保存项目。你也可以分享源码归档,或使用 GitHub 同步来交换提交。

我可以在两台电脑上使用我的项目吗?

标题为“我可以在两台电脑上使用我的项目吗?”的部分

可以。云同步会把你的库项目和设置保存在你自己的 Dropbox 中,你连接的每台电脑都可以下载它们。打开 设置 → 数据存储 → 云同步 即可连接。你也可以用 GitHub 同步在电脑之间转移项目。

它备份的是项目源码。自动检查点、应用偏好设置和凭据是分开存放的。请按照备份指南把你需要的内容也包含进去。

打开 设置 → 帮助与关于 → 复制信息,把这些信息连同简短的描述、重现问题的步骤和相关日志一起提供。请在 Issues (在新标签页中打开) 中报告问题;提问和工作流方面的帮助请用 Discord 社区。

图片预览

无法加载 AI 回答

请重试,或搜索文档。