# 新功能

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

最新的更新加入了禅模式，并支持在输入时引用 Zotero 文献。编辑器还新增了一个浅色模式主题和一个深色模式主题，颜色可以自行更改。在此之前，Typst 追上了 LaTeX，每种引擎都拥有了相同的文档工具，CLI 代理也变得更容易设置和检查。本页指向完整的说明，而不是重复一份发布说明清单。

## 写作时引用 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/)介绍了更新流程。