新功能
查找 Oleafly 最新的笔记、Markdown、引用、编辑器、Typst、图表、研究和代理功能的使用指南。
最新的更新加入了笔记(一项实验功能,用来把研究笔记保存为 Markdown 文件),并且让 Markdown 文档可以构建成图书、幻灯片、海报或信函。Quarto 网页现在会显示在预览中,在没有 TeX 的电脑上,引擎窗口会优先提供 TinyTeX。在此之前是每次编译后都保持最新的项目文件夹 PDF、在你已在使用的 CLI 代理上运行的工具、禅模式,以及输入时从 Zotero 引用文献。本页指向完整的说明,而不是重复一份发布说明清单。
研究笔记,作为一项实验
标题为“研究笔记,作为一项实验”的部分笔记把研究笔记以 Markdown 文件的形式保存在你的电脑上。你在富文本编辑器中书写,可以使用标注、表格、统计图、图表、公式、链接,以及带截止日期的任务。它默认关闭,需要在设置 → 实验功能中开启笔记。笔记在可以拆分和停靠的标签页中打开,你可以通过搜索、标签、任务或日期再次找到它们。笔记可以放在项目里,也可以在协作服务器上与其他人一起写,助手或 CLI 代理可以提出修改建议,由你在笔记中接受或拒绝。快速记录会打开一个小窗口,让你在任何应用中都能记下想保留的念头。
开启笔记 · 在笔记中书写 · 查找并整理笔记 · 项目中的笔记与共享笔记 · 结合 AI 使用笔记
带类型的 Markdown 文档
标题为“带类型的 Markdown 文档”的部分在 Markdown 文档的 front matter 中加上 type:,就可以把它构建成报告、图书、幻灯片、海报、信函或简历。幻灯片会构建成 16:9 的 Beamer 幻灯片,放映可以放映它,信函的地址取自 to 和 from。你自己写的 front matter 仍然优先。文档设置中的文档类型会替你写下这一行,LaTeX 导出和 oleafly build 也会遵循这个类型。
文档类型 · Markdown 的文档设置 · 放映幻灯片
预览中的 Quarto 网页
标题为“预览中的 Quarto 网页”的部分构建网页的 Quarto 文档,例如 format: html 或 reveal.js 幻灯片,现在会把网页显示在预览窗格中。该网页无法访问 Oleafly 的其余部分。要在你自己的浏览器中打开它,请选择预览工具栏上的在浏览器中打开。
没有 TeX 时优先提供 TinyTeX
标题为“没有 TeX 时优先提供 TinyTeX”的部分当项目需要 latexmk,而这台电脑上没有可用的 TeX 时,引擎窗口现在会把下载 TinyTeX列在最前面,并标为推荐。下载并使用 TinyTeX会安装它并编译项目。若要继续使用内置引擎,请使用底部的继续使用 Tectonic卡片。
项目文件夹里始终最新的 PDF
标题为“项目文件夹里始终最新的 PDF”的部分PDF 预览中的保存按钮现在会打开一个菜单。在其中打开编译时同步 PDF,之后每次编译成功,Oleafly 都会在项目文件夹里刷新一个以项目标题命名的 PDF,例如 Thesis_Final_Draft.pdf。它是一个普通文件,所以云同步和检查点都会把它带上,而且 Oleafly 绝不会覆盖不是它创建的文件。要找回较早的 PDF,请打开某个检查点的文件,选择保存 PDF。
在你的 CLI 代理上运行工具
标题为“在你的 CLI 代理上运行工具”的部分图片转 LaTeX、图片转 Typst、公式工具和扫描的 PDF 可以使用已连接的 CLI 代理,例如 Claude Code 或 Codex,凭你自己的登录即可,不需要 API 密钥。没有密钥时,论文审阅、行内编辑和用 AI 修复也会用这个代理。Antigravity CLI 现在是内置代理。
任意文件夹里的 TeX,以及从镜像下载
标题为“任意文件夹里的 TeX,以及从镜像下载”的部分设置 → 引擎 → LaTeX 中的选择 TeX 文件夹可以用安装在 Oleafly 不会查找的位置的 TeX 来编译。TinyTeX、Typst 和其他下载现在优先来自 Oleafly 的镜像。设置 → 下载 → 下载源可以改用原始站点或你自己的镜像,并设置 TeX 宏包的下载仓库。TinyTeX 的下载可以取消,也可以继续。
latexmk 与系统 TeX · 下载源标签页 · 安装和更新 TinyTeX
PDF 中丢失的文字
标题为“PDF 中丢失的文字”的部分TeX 会跳过所用字体无法显示的字符,却仍然报告成功,所以一段中文、日文或韩文可能会变成空白。现在你会收到提示,日志会列出缺失的字符,并给出每种文字的设置方法,所用字体随内置引擎一起提供。
跳过思考的本地模型
标题为“跳过思考的本地模型”的部分会先思考再作答的 Ollama 和 Lemonade 模型,现在在强度菜单中提供无。简单的请求选它,回复会快得多。
中日韩编辑器字体,以及按名称使用下载的字体
标题为“中日韩编辑器字体,以及按名称使用下载的字体”的部分中日韩字体设置让中文、日文和韩文字符在编辑器中使用自己的字体,与你的编程字体并存。下载的 Lato、PT Sans 和 PT Serif 可以按名称使用:Typst 能找到它们,添加到项目会把其中一个复制到 LaTeX 项目中。
写作时引用 Zotero 文献
标题为“写作时引用 Zotero 文献”的部分在 LaTeX、Typst 或 Markdown 文件中输入 @,你的整个 Zotero 文库就会与项目自己的参考文献一起显示。选择一篇论文会插入引用,并且只把这一条目添加到项目的 .bib 中。之后,从 Zotero 添加和从 Zotero 更新会让该文件与你的文库保持同步。它可以配合在同一台电脑上打开的 Zotero 7 使用,也可以配合 zotero.org 账户使用。
编辑器主题和颜色
标题为“编辑器主题和颜色”的部分为浅色模式选一个编辑器主题,为深色模式再选一个,编辑器就会随应用切换。Paper(一种偏暖的米白色)和 One Light 是新增的主题。编辑器颜色可以更改主题的任何颜色,并在 LaTeX、Typst 和 Markdown 中实时预览。颜色按角色分组,所以标题、引用或公式在这三种语言中的颜色相同。
禅模式
标题为“禅模式”的部分按 Ctrl+⌘⇧F(Windows 和 Linux 上为 Shift+F11)可隐藏工具栏、侧边栏、助手和终端。只剩下编辑器,角落里有一个编译按钮。连按两次 Esc 可恢复所有内容。
路径随重命名和移动的文件而更新
标题为“路径随重命名和移动的文件而更新”的部分重命名文件或把它拖到另一个文件夹后,指向它的 \input、\includegraphics、#include、image() 和 Markdown 链接也会随之更改。除非你设为始终更新或从不更新,否则 Oleafly 会先询问。
默认编译引擎适用于每个新的 LaTeX 项目
标题为“默认编译引擎适用于每个新的 LaTeX 项目”的部分你在设置 → 引擎 → LaTeX 下选择的引擎,现在适用于新项目、导入、转换后的文档,以及你就地打开的受信任文件夹。在那里选择 latexmk,新项目从一开始就会使用你自己的 TeX 安装来编译。
缩放、字体和新快捷键
标题为“缩放、字体和新快捷键”的部分⌘= 和 ⌘- 缩放整个应用,⌘, 打开设置,⌘⌥P 显示或隐藏 PDF。应用和编辑器的字体可以是你电脑上安装的任何字体。编辑器还新增了行高、字间距以及光标宽度和颜色的设置。
系统 LaTeX 与外部命令
标题为“系统 LaTeX 与外部命令”的部分当 Tectonic 无法构建文档时,引擎对话框会自动打开,并可以将项目迁移到你的系统 LaTeX。编辑器上方的横幅会为 minted、PythonTeX 和 \write18 提供允许外部命令。在 Linux 上,Oleafly 现在绘制自己的标题栏,并接受从文件管理器拖入的文件。
当 Tectonic 不够用时 · 允许外部命令 · 在 Linux 上安装
Typst,与 LaTeX 同样完整
标题为“Typst,与 LaTeX 同样完整”的部分Typst 项目现在拥有 LaTeX 项目曾有的一切,还有一些自己独有的功能。可以为每个项目选择 Typst 版本,从 0.11 到 0.15,Oleafly 会下载该版本,并对照已发布的校验和进行检查。包来自 Typst Universe,也可以放在项目内部,使其离线编译。项目自己的字体、构建变体和可复现构建,对 Typst 和语言服务器都有效。
在编辑器中,Typst 获得了可视化模式、折叠、粘性标题,对函数、路径、标签和包的补全,重命名和格式化文档。它还获得了 LaTeX 所拥有的图形、表格、引用和公式工具。跳转到 PDF 和在 PDF 中点击,可以在源码和页面之间跳转。导出包括 PNG、SVG、HTML、PDF/A 和 PDF/UA,预检也会检查 Typst 源文件。
设置 Typst 项目 · 用 Typst 写作 · 将 LaTeX 项目转换为 Typst
每种引擎都有宏包、文档设置和文档分析
标题为“每种引擎都有宏包、文档设置和文档分析”的部分编辑器工具栏上的三个按钮,现在在 LaTeX、Typst 和 Markdown 中(适用之处)的工作方式相同:
- 宏包在 LaTeX 中搜索 CTAN,在 Typst 中搜索 Typst Universe,并添加加载包的那一行。
- 文档设置更改纸张大小、页边距、字体、语言、行距和编号。它会替你编辑导言区、
#set规则或前置元数据。 - 文档分析列出文档中的图形、表格、公式、标签、引用和 TODO,并复制其投稿元数据。
一个图表编排器,支持 TikZ、Typst 和 Mermaid
标题为“一个图表编排器,支持 TikZ、Typst 和 Mermaid”的部分图表编排器现在会询问图表使用哪种语言:LaTeX 用 TikZ,Typst 用 fletcher 图表,Markdown 用 Mermaid 流程图。三者共用同一块画布,代码和图形在两个方向上保持同步。文档工具栏上的绘制图表会跳过这个问题,直接使用该文档的语言。插入 Markdown 的 Mermaid 图表也会出现在编译后的 PDF 中。
用 PDF 放映幻灯片
标题为“用 PDF 放映幻灯片”的部分可以全屏放映任何已编译的 PDF,并提供可选的演讲者视图,显示下一页幻灯片、计时器和你的备注。
像搜索 GitHub issue 一样搜索你的文库
标题为“像搜索 GitHub issue 一样搜索你的文库”的部分主屏幕上的项目搜索支持 engine:typst、is:bookmarked 和 created:>@today-1w 这样的限定词,还支持 AND、OR、括号和排序。输入时会出现建议,高级筛选编辑的是同一段文本。
Zotero 与 alphaXiv
标题为“Zotero 与 alphaXiv”的部分可以将你的整个 Zotero 文库导入项目的参考文献,并连接 alphaXiv,让助手能从中搜索和阅读论文。
可检查、可撤销的 CLI 代理
标题为“可检查、可撤销的 CLI 代理”的部分设置中的每个 CLI 代理都会显示 Oleafly 找到的程序,测试会在保存任何内容之前运行它。代理更改文件后,你可以审阅每一处更改,并撤销或重做。代理主页还提供研究起点,例如文献梳理或引用审计。
可搜索的设置
标题为“可搜索的设置”的部分在设置中输入“主题”“Zotero”或“拼写”之类的词即可跳转。重置按钮上的圆点表示该部分中有内容与默认值不同,文件路径在你指向它们之前会保持模糊。
每个 Oleafly 工具都有一份指南
标题为“每个 Oleafly 工具都有一份指南”的部分可选的 LaTeX 工具图库现在包含 47 个专注的工具,其中有十个 Typst 转换器。你可以在 LaTeX、Typst、Markdown、Word、HTML、PDF、图片、电子表格和 Mermaid 图表之间转换文档;构建并验证参考文献;搜索论文、实验室和截止日期;进行统计计算;以及使用小型写作辅助工具。
每个工具现在都有自己的页面,介绍它的输入、步骤、示例、隐私行为、限制,以及该工具不适用时更合适的途径。
双窗格工具有一条可拖动、支持键盘操作的分隔条。每个工具都会记住自己在桌面端的分栏位置,而窄窗口会把输入和结果上下堆叠。
懂得源文件的校对
标题为“懂得源文件的校对”的部分校对现在在 LaTeX、Typst 和 Markdown 中把拼写检查与 Harper 的语法和风格检查结合起来。它会跳过不应被当作正文的源码语法,然后让你替换某个发现的问题,或暂时忽略、仅在一个项目中忽略、在所有地方都忽略。学术配置文件增加了适合研究写作的检查,你还可以在某个发现的问题上禁用单条 Harper 规则。
更快的 LaTeX 编辑
标题为“更快的 LaTeX 编辑”的部分编辑器可以让数学定界符、括号和环境成对出现;延续列表;关闭当前环境;并补全感知宏包的命令、交叉引用、引用和项目路径。单独的设置让你开启或关闭自动补全、括号、数学或环境闭合。
更可靠的参考文献
标题为“更可靠的参考文献”的部分引用的插入遵循文档所声明的参考文献库,包括常见的 BibTeX 和 Biber 配置。文库导入接受 BibTeX、RIS、EndNote XML 和 Zotero RDF。参考文献清理器会在更改文件之前预览规范化后的键和重复项,在键变化时更新引用,并保存备份。新的独立工具涵盖 DOI、arXiv、ISBN、PubMed、URL、格式化引用和八种引用样式。
跨写作格式的导入与导出
标题为“跨写作格式的导入与导出”的部分Word 和 HTML 文档可以变成 LaTeX、Markdown 或 Typst 项目。Markdown 可以变成 LaTeX 或 Typst,Typst 可以变成 LaTeX 或 Markdown。已打开的项目可以将其受支持的路径导出为 Word、带 MathML 的 HTML、Markdown、Typst、LaTeX、纯文本、PDF、源码 ZIP 或页面图像。LaTeX 演示文稿和书籍还可以导出为 PowerPoint 或 EPUB。Markdown 项目两者都支持,Typst 项目支持 EPUB。
21 种语言的界面
标题为“21 种语言的界面”的部分在设置 → 通用 → 语言下选择系统或 21 种语言之一,从简体中文和日本語到 Deutsch 和 Español。界面会立即改变,无需重启。此设置控制应用的标签和消息。文档语言、校对词典和助手输出仍是独立的选择。
PDF 无障碍与投稿检查
标题为“PDF 无障碍与投稿检查”的部分预检把编译、版面、参考文献、资源、盲审、ATS 和无障碍方面的发现汇集在一处。它的 PDF/UA 部分检查一组明确定义的、可由机器测试的子集,它的带标签 PDF 工作流则让兼容的 LaTeX 项目为 LuaLaTeX 做好准备。指南解释了哪些结果是确定的、哪些是启发式的,以及为什么一次无问题的运行并不等于正式的 PDF/UA 认证。
TeX 宏包恢复
标题为“TeX 宏包恢复”的部分当 latexmk 构建报告缺少某个 TeX 文件时,Oleafly 可以找到包含它的 TeX Live 宏包,安装该宏包,然后重新编译。宏包管理器还可以搜索完整的 TeX Live 目录,并显示某个宏包位于系统目录树还是个人目录树。
更方便地引用软件
标题为“更方便地引用软件”的部分设置 → 帮助与关于现在带有一条可直接复制的 Oleafly BibTeX 条目。在已打开的项目中,在本文中引用 Oleafly 可以把该条目添加到文档所使用的参考文献库。
发布说明与更新
标题为“发布说明与更新”的部分请在 GitHub Releases (在新标签页中打开) 上阅读逐版本的更改。在应用中,打开设置 → 帮助与关于检查更新。应用更新介绍了更新流程。