# 新功能

查找 Oleafly 最新的笔记、Markdown、引用、编辑器、Typst、图表、研究和代理功能的使用指南。

最新的更新加入了笔记（一项实验功能，用来把研究笔记保存为 Markdown 文件），并且让 Markdown 文档可以构建成图书、幻灯片、海报或信函。Quarto 网页现在会显示在预览中，在没有 TeX 的电脑上，引擎窗口会优先提供 TinyTeX。在此之前是每次编译后都保持最新的项目文件夹 PDF、在你已在使用的 CLI 代理上运行的工具、禅模式，以及输入时从 Zotero 引用文献。本页指向完整的说明，而不是重复一份发布说明清单。

## 研究笔记，作为一项实验

笔记把研究笔记以 Markdown 文件的形式保存在你的电脑上。你在富文本编辑器中书写，可以使用标注、表格、统计图、图表、公式、链接，以及带截止日期的任务。它默认关闭，需要在**设置 → 实验功能**中开启**笔记**。笔记在可以拆分和停靠的标签页中打开，你可以通过搜索、标签、任务或日期再次找到它们。笔记可以放在项目里，也可以在协作服务器上与其他人一起写，助手或 CLI 代理可以提出修改建议，由你在笔记中接受或拒绝。**快速记录**会打开一个小窗口，让你在任何应用中都能记下想保留的念头。

[开启笔记](/docs/notes/#turn-on-notes) · [在笔记中书写](/docs/notes/writing/) · [查找并整理笔记](/docs/notes/organize/) · [项目中的笔记与共享笔记](/docs/notes/projects-and-sharing/) · [结合 AI 使用笔记](/docs/notes/ai/)

## 带类型的 Markdown 文档

在 Markdown 文档的 front matter 中加上 `type:`，就可以把它构建成报告、图书、幻灯片、海报、信函或简历。幻灯片会构建成 16:9 的 Beamer 幻灯片，**放映**可以放映它，信函的地址取自 `to` 和 `from`。你自己写的 front matter 仍然优先。**文档设置**中的**文档类型**会替你写下这一行，LaTeX 导出和 `oleafly build` 也会遵循这个类型。

[文档类型](/docs/writing/markdown/#document-types) · [Markdown 的文档设置](/docs/document-settings/#markdown) · [放映幻灯片](/docs/present-slides/)

## 预览中的 Quarto 网页

构建网页的 Quarto 文档，例如 `format: html` 或 reveal.js 幻灯片，现在会把网页显示在预览窗格中。该网页无法访问 Oleafly 的其余部分。要在你自己的浏览器中打开它，请选择预览工具栏上的**在浏览器中打开**。

[Quarto](/docs/engines/#quarto) · [在浏览器中打开](/docs/pdf-preview/#open-in-browser)

## 没有 TeX 时优先提供 TinyTeX

当项目需要 `latexmk`，而这台电脑上没有可用的 TeX 时，引擎窗口现在会把**下载 TinyTeX**列在最前面，并标为**推荐**。**下载并使用 TinyTeX**会安装它并编译项目。若要继续使用内置引擎，请使用底部的**继续使用 Tectonic**卡片。

[未安装 TeX 时](/docs/latex-engines/#when-no-tex-is-installed) · [当 Tectonic 不够用时](/docs/latex-engines/#when-tectonic-isnt-enough)

## 项目文件夹里始终最新的 PDF

PDF 预览中的保存按钮现在会打开一个菜单。在其中打开**编译时同步 PDF**，之后每次编译成功，Oleafly 都会在项目文件夹里刷新一个以项目标题命名的 PDF，例如 `Thesis_Final_Draft.pdf`。它是一个普通文件，所以云同步和检查点都会把它带上，而且 Oleafly 绝不会覆盖不是它创建的文件。要找回较早的 PDF，请打开某个检查点的文件，选择**保存 PDF**。

[编译时同步 PDF](/docs/pdf-preview/#sync-pdf-on-compiles) · [从检查点保存 PDF](/docs/checkpoints/#save-a-pdf-from-a-checkpoint)

## 在你的 CLI 代理上运行工具

图片转 LaTeX、图片转 Typst、公式工具和扫描的 PDF 可以使用已连接的 CLI 代理，例如 Claude Code 或 Codex，凭你自己的登录即可，不需要 API 密钥。没有密钥时，论文审阅、行内编辑和**用 AI 修复**也会用这个代理。Antigravity CLI 现在是内置代理。

[用代理代替 API 密钥](/docs/cli-agents/#use-an-agent-instead-of-an-api-key) · [代理目录](/docs/cli-agents/#agent-catalog)

## 任意文件夹里的 TeX，以及从镜像下载

**设置 → 引擎 → LaTeX** 中的**选择 TeX 文件夹**可以用安装在 Oleafly 不会查找的位置的 TeX 来编译。TinyTeX、Typst 和其他下载现在优先来自 Oleafly 的镜像。**设置 → 下载 → 下载源**可以改用原始站点或你自己的镜像，并设置 TeX 宏包的下载仓库。TinyTeX 的下载可以取消，也可以继续。

[latexmk 与系统 TeX](/docs/latex-engines/#latexmk-and-system-tex) · [下载源标签页](/docs/settings/downloads/#sources-tab) · [安装和更新 TinyTeX](/docs/latex-engines/#install-and-update-tinytex)

## PDF 中丢失的文字

TeX 会跳过所用字体无法显示的字符，却仍然报告成功，所以一段中文、日文或韩文可能会变成空白。现在你会收到提示，日志会列出缺失的字符，并给出每种文字的设置方法，所用字体随内置引擎一起提供。

[PDF 中缺失的字符](/docs/latex-engines/#characters-missing-from-the-pdf)

## 跳过思考的本地模型

会先思考再作答的 Ollama 和 Lemonade 模型，现在在强度菜单中提供**无**。简单的请求选它，回复会快得多。

[跳过思考步骤](/docs/ollama/#skip-the-thinking-step)

## 中日韩编辑器字体，以及按名称使用下载的字体

**中日韩字体**设置让中文、日文和韩文字符在编辑器中使用自己的字体，与你的编程字体并存。下载的 Lato、PT Sans 和 PT Serif 可以按名称使用：Typst 能找到它们，**添加到项目**会把其中一个复制到 LaTeX 项目中。

[中日韩字体](/docs/settings/appearance/#cjk-font) · [向项目添加字体](/docs/settings/downloads/#add-a-font-to-a-project)

## 写作时引用 Zotero 文献

在 LaTeX、Typst 或 Markdown 文件中输入 `@`，你的整个 Zotero 文库就会与项目自己的参考文献一起显示。选择一篇论文会插入引用，并且只把这一条目添加到项目的 `.bib` 中。之后，**从 Zotero 添加**和**从 Zotero 更新**会让该文件与你的文库保持同步。它可以配合在同一台电脑上打开的 Zotero 7 使用，也可以配合 zotero.org 账户使用。

[从你的 Zotero 文库中引用](/docs/citations/#cite-from-your-zotero-library) · [连接 Zotero](/docs/integrations/research-sources/#zotero)

## 编辑器主题和颜色

为浅色模式选一个编辑器主题，为深色模式再选一个，编辑器就会随应用切换。Paper（一种偏暖的米白色）和 One Light 是新增的主题。**编辑器颜色**可以更改主题的任何颜色，并在 LaTeX、Typst 和 Markdown 中实时预览。颜色按角色分组，所以标题、引用或公式在这三种语言中的颜色相同。

[编辑器主题](/docs/settings/appearance/#editor-themes) · [编辑器颜色](/docs/settings/appearance/#editor-colors)

## 禅模式

按 Ctrl+⌘⇧F（Windows 和 Linux 上为 Shift+F11）可隐藏工具栏、侧边栏、助手和终端。只剩下编辑器，角落里有一个编译按钮。连按两次 Esc 可恢复所有内容。

[禅模式](/docs/editor/#zen-mode)

## 路径随重命名和移动的文件而更新

重命名文件或把它拖到另一个文件夹后，指向它的 `\input`、`\includegraphics`、`#include`、`image()` 和 Markdown 链接也会随之更改。除非你设为始终更新或从不更新，否则 Oleafly 会先询问。

[路径随移动的文件而更新](/docs/files/#paths-follow-a-moved-file)

## 默认编译引擎适用于每个新的 LaTeX 项目

你在**设置 → 引擎 → LaTeX** 下选择的引擎，现在适用于新项目、导入、转换后的文档，以及你就地打开的受信任文件夹。在那里选择 `latexmk`，新项目从一开始就会使用你自己的 TeX 安装来编译。

[为新项目设置默认值](/docs/engines/#set-a-default-for-new-projects)

## 缩放、字体和新快捷键

⌘= 和 ⌘- 缩放整个应用，⌘, 打开设置，⌘⌥P 显示或隐藏 PDF。应用和编辑器的字体可以是你电脑上安装的任何字体。编辑器还新增了行高、字间距以及光标宽度和颜色的设置。

[外观与主题](/docs/settings/appearance/) · [键盘快捷键](/docs/keyboard-shortcuts/)

## 系统 LaTeX 与外部命令

当 Tectonic 无法构建文档时，引擎对话框会自动打开，并可以将项目迁移到你的系统 LaTeX。编辑器上方的横幅会为 `minted`、PythonTeX 和 `\write18` 提供**允许外部命令**。在 Linux 上，Oleafly 现在绘制自己的标题栏，并接受从文件管理器拖入的文件。

[当 Tectonic 不够用时](/docs/latex-engines/#when-tectonic-isnt-enough) · [允许外部命令](/docs/latex-engines/#allow-external-commands) · [在 Linux 上安装](/docs/install/#linux)

## 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 项目](/docs/typst/) · [用 Typst 写作](/docs/writing/typst/) · [将 LaTeX 项目转换为 Typst](/docs/typst/#convert-a-latex-project-to-typst)

## 每种引擎都有宏包、文档设置和文档分析

编辑器工具栏上的三个按钮，现在在 LaTeX、Typst 和 Markdown 中（适用之处）的工作方式相同：

- **宏包**在 LaTeX 中搜索 CTAN，在 Typst 中搜索 Typst Universe，并添加加载包的那一行。
- **文档设置**更改纸张大小、页边距、字体、语言、行距和编号。它会替你编辑导言区、`#set` 规则或前置元数据。
- **文档分析**列出文档中的图形、表格、公式、标签、引用和 TODO，并复制其投稿元数据。

[宏包](/docs/packages/) · [文档设置](/docs/document-settings/) · [文档分析](/docs/document-insights/)

## 一个图表编排器，支持 TikZ、Typst 和 Mermaid

图表编排器现在会询问图表使用哪种语言：LaTeX 用 TikZ，Typst 用 fletcher 图表，Markdown 用 Mermaid 流程图。三者共用同一块画布，代码和图形在两个方向上保持同步。文档工具栏上的**绘制图表**会跳过这个问题，直接使用该文档的语言。插入 Markdown 的 Mermaid 图表也会出现在编译后的 PDF 中。

[绘制图表](/docs/figures-diagrams/)

## 用 PDF 放映幻灯片

可以全屏放映任何已编译的 PDF，并提供可选的演讲者视图，显示下一页幻灯片、计时器和你的备注。

[放映幻灯片](/docs/present-slides/)

## 像搜索 GitHub issue 一样搜索你的文库

主屏幕上的项目搜索支持 `engine:typst`、`is:bookmarked` 和 `created:>@today-1w` 这样的限定词，还支持 AND、OR、括号和排序。输入时会出现建议，高级筛选编辑的是同一段文本。

[搜索你的项目](/docs/library/#search-your-projects)

## Zotero 与 alphaXiv

可以将你的整个 Zotero 文库导入项目的参考文献，并连接 alphaXiv，让助手能从中搜索和阅读论文。

[Zotero](/docs/integrations/research-sources/#zotero)、[alphaXiv](/docs/integrations/research-sources/#alphaxiv)

## 可检查、可撤销的 CLI 代理

设置中的每个 CLI 代理都会显示 Oleafly 找到的程序，**测试**会在保存任何内容之前运行它。代理更改文件后，你可以审阅每一处更改，并撤销或重做。代理主页还提供研究起点，例如文献梳理或引用审计。

[设置 CLI 代理](/docs/cli-agents/) · [审阅并撤销更改](/docs/cli-agents/#review-and-undo-changes) · [研究起点](/docs/cli-agents/#research-starting-points)

## 可搜索的设置

在设置中输入“主题”“Zotero”或“拼写”之类的词即可跳转。重置按钮上的圆点表示该部分中有内容与默认值不同，文件路径在你指向它们之前会保持模糊。

[设置](/docs/settings/#find-a-setting)

## 每个 Oleafly 工具都有一份指南

可选的 **LaTeX 工具**图库现在包含 47 个专注的工具，其中有十个 Typst 转换器。你可以在 LaTeX、Typst、Markdown、Word、HTML、PDF、图片、电子表格和 Mermaid 图表之间转换文档；构建并验证参考文献；搜索论文、实验室和截止日期；进行统计计算；以及使用小型写作辅助工具。

每个工具现在都有自己的页面，介绍它的输入、步骤、示例、隐私行为、限制，以及该工具不适用时更合适的途径。

双窗格工具有一条可拖动、支持键盘操作的分隔条。每个工具都会记住自己在桌面端的分栏位置，而窄窗口会把输入和结果上下堆叠。

[浏览全部 47 个工具](/docs/tools/)

## 懂得源文件的校对

校对现在在 LaTeX、Typst 和 Markdown 中把拼写检查与 Harper 的语法和风格检查结合起来。它会跳过不应被当作正文的源码语法，然后让你替换某个发现的问题，或暂时忽略、仅在一个项目中忽略、在所有地方都忽略。学术配置文件增加了适合研究写作的检查，你还可以在某个发现的问题上禁用单条 Harper 规则。

[设置校对和学术风格](/docs/spellcheck-grammar/)

## 更快的 LaTeX 编辑

编辑器可以让数学定界符、括号和环境成对出现；延续列表；关闭当前环境；并补全感知宏包的命令、交叉引用、引用和项目路径。单独的设置让你开启或关闭自动补全、括号、数学或环境闭合。

[使用自动补全和结构化输入](/docs/autocomplete/) · [了解编辑器](/docs/editor/)

## 更可靠的参考文献

引用的插入遵循文档所声明的参考文献库，包括常见的 BibTeX 和 Biber 配置。文库导入接受 BibTeX、RIS、EndNote XML 和 Zotero RDF。参考文献清理器会在更改文件之前预览规范化后的键和重复项，在键变化时更新引用，并保存备份。新的独立工具涵盖 DOI、arXiv、ISBN、PubMed、URL、格式化引用和八种引用样式。

[管理引用和参考文献](/docs/citations/) · [打开参考文献工具](/docs/tools/#build-references)

## 跨写作格式的导入与导出

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。

[导入已有的工作](/docs/import-project/) · [导出和转换项目](/docs/export/)

## 21 种语言的界面

在**设置 → 通用 → 语言**下选择**系统**或 21 种语言之一，从简体中文和日本語到 Deutsch 和 Español。界面会立即改变，无需重启。此设置控制应用的标签和消息。文档语言、校对词典和助手输出仍是独立的选择。

[更改应用语言](/docs/localization/)

## PDF 无障碍与投稿检查

预检把编译、版面、参考文献、资源、盲审、ATS 和无障碍方面的发现汇集在一处。它的 PDF/UA 部分检查一组明确定义的、可由机器测试的子集，它的带标签 PDF 工作流则让兼容的 LaTeX 项目为 LuaLaTeX 做好准备。指南解释了哪些结果是确定的、哪些是启发式的，以及为什么一次无问题的运行并不等于正式的 PDF/UA 认证。

[运行预检并准备带标签的 PDF](/docs/preflight/)

## TeX 宏包恢复

当 `latexmk` 构建报告缺少某个 TeX 文件时，Oleafly 可以找到包含它的 TeX Live 宏包，安装该宏包，然后重新编译。宏包管理器还可以搜索完整的 TeX Live 目录，并显示某个宏包位于系统目录树还是个人目录树。

[选择 LaTeX 引擎并管理宏包](/docs/latex-engines/)

## 更方便地引用软件

**设置 → 帮助与关于**现在带有一条可直接复制的 Oleafly BibTeX 条目。在已打开的项目中，**在本文中引用 Oleafly** 可以把该条目添加到文档所使用的参考文献库。

[复制或插入 Oleafly 的引用](/docs/settings/help/#cite-oleafly-in-a-paper)

## 发布说明与更新

请在 [GitHub Releases](https://github.com/Oleafly/Oleafly/releases) 上阅读逐版本的更改。在应用中，打开**设置 → 帮助与关于**检查更新。[应用更新](/docs/updates/)介绍了更新流程。
