# 设置

选择你的写作方式，连接研究工具，并管理本地存储。

从侧边栏中的齿轮图标或命令面板打开**设置**，也可以在 macOS 上按 ⌘,，在 Windows 和 Linux 上按 Ctrl+,。该快捷键在分离出来的 PDF 窗口中同样有效，在 macOS 上，**Oleafly** 菜单里也有**设置…**。设置只作用于这台电脑，除非你开启[云同步](/docs/cloud-sync/#settings)。项目的引擎、主文档和其他项目选项会随项目文件一起移动。

![从项目工具栏打开设置。左侧一栏列出了所有设置分区。](https://cdn.oleafly.com/images/screenshots/desktop/docs/settings-general-dark-window-v2.png#view=519,89,883,902)

## 查找设置

在左栏顶部的**搜索设置**中输入一个词，例如“主题”“Zotero”或“拼写”。分区列表会收窄到匹配的分区和设置。选择一项设置即可跳转过去。Oleafly 会打开正确的标签页，滚动到该行，并给它加上底色，方便你找到。

## 重置分区

通用、外观、词典、AI 助手、引擎、键盘快捷键和实验功能的末尾都有**恢复默认设置**。按钮上的小圆点表示该分区中有内容与默认值不同。重置一个分区不会影响其他分区。

## 路径保持隐藏

主文件夹内的路径显示为 `~/…`。设置中的文件和文件夹路径，例如项目文件夹、引擎位置和 CLI 代理程序，会保持模糊，直到你把鼠标悬停在上面，或用 Tab 键移到它们。这样，设置的截图就不会暴露你的文件存放在哪里。

## 通用

选择界面语言、设置校对、开启或关闭离线编译，并控制导览。界面提供 21 种语言，**系统默认**会跟随你的操作系统。选择新语言后立即生效。

[通用中的每个控件](/docs/settings/general/)都有单独的说明。**离线模式**让 Tectonic 和 Typst 只使用已有的包，并关闭联网的引用查询。在让新项目脱机之前，请先阅读[编译](/docs/compiling/)。

## 外观

选择浅色或深色主题、强调色、背景，以及应用和编辑器的字体。电脑上安装的任何字体都可以使用。设置整个应用的缩放级别、调整文字大小，并选择项目以分屏视图、仅编辑器还是仅 PDF 打开。编辑器的浅色模式和深色模式各有一个主题，**编辑器颜色**可以修改任一主题的任何颜色。这里的编辑器控件还包括行高、字间距、光标、自动补全、括号、公式和环境的配对、粘性上下文、键位绑定（默认、Vim 或 Emacs）、行内建议，以及文件移动时路径的处理方式。你还可以控制文件树、项目库的 PDF 预览和禅模式。**终端**标签页设置内置终端的样式。其中的**文件夹打开方式**设置决定**在终端中打开**以及 Oleafly 替你运行的命令（例如 CLI 代理登录）使用哪个终端应用。它可以是内置终端，也可以是其他应用，例如 macOS 上的 iTerm、Windows 上的 Windows Terminal，或 Linux 上的 GNOME Terminal。参见[外观与主题](/docs/settings/appearance/)。

## 词典

查看你已忽略的词。**全局**标签页列出在所有项目中跳过的词，**项目**标签页列出只在当前打开的项目中跳过的词。移除某个词后，它会重新参与校对。标签页下方是你关闭的语法规则、已忽略的检查结果，以及**学术配置中保持关闭的规则**：每条规则都附有说明、示例和一个开启它的开关。参见[拼写与语法](/docs/spellcheck-grammar/)。

## 数据存储

查看项目库所在的位置，以及项目、文件、Git 历史和构建缓存各占用多少空间。在**本地存储**下控制自动[检查点](/docs/checkpoints/)及其存储提示。**云同步**标签页会把你的项目库项目和设置备份到 Dropbox。在这里管理本地存储，备份时请按照[你的数据存放在哪里](/docs/where-your-data-lives/)操作。

## AI 助手

| 标签页 | 可以设置的内容 |
|---|---|
| **提供商与密钥** | 云端提供商、兼容的端点、本地模型、模型选择器、项目批准和预算。 |
| **CLI 代理** | 安装、连接并配置在你电脑上运行的代理。 |
| **指令** | 写作指令、模型默认值、PDF 截取和工具目录。 |
| **人设** | 针对不同类型工作的命名指令预设。 |
| **技能** | 研究工作流、领域指导和你自己的可复用技能，带有搜索框，每项技能一个开关。 |
| **MCP** | 助手可以使用的外部工具，包括服务器发现和配置导入。 |
| **工具** | 工具所用模型，例如本地模型或已连接的 CLI 代理，以及你的 Mathpix 密钥。 |

请从[设置 AI](/docs/ai-setup/) 开始。各个控件的说明参见 [CLI 代理](/docs/cli-agents/)、[技能](/docs/skills/)和[用量与预算](/docs/ai-usage/)。

## 引擎

管理编译文档的工具。对于 LaTeX，Oleafly 可以检测系统中的 TeX 安装，或安装它自己的 TinyTeX。宏包管理和带标签 PDF 的设置也在这里。参见 [LaTeX 引擎与宏包](/docs/latex-engines/)。

**LaTeX** 标签页上的**管理 TeX 发行版**会列出 Oleafly 找到的每一个 TeX 安装，例如 MacTeX、TeX Live、MiKTeX 或 TinyTeX。安装具有 `latexmk` 或 `tlmgr` 时，对应的行会显示相应的徽章，**使用中**标出 latexmk 编译所用的那一个。要用另一个来编译，请在它那一行选择**用于编译**。那一行上的**自动**会把选择权交还给 Oleafly，它先选完整的系统 TeX，再选 TinyTeX。没有 Perl 的 MiKTeX 会显示**latexmk 需要 Perl**，在你安装 Perl（例如 Strawberry Perl）之前无法被选中。如果 TeX 安装在 Oleafly 不会查找的文件夹里，可以用**选择 TeX 文件夹**来选取它。参见 [latexmk 与系统 TeX](/docs/latex-engines/#latexmk-and-system-tex)。

没有 Oleafly 自己的 TinyTeX 时，TinyTeX 卡片会提供**下载 TinyTeX（约 250 MB）**。TinyTeX 下载、解压并添加宏包期间，按钮会显示进度，**取消**可以在下载和解压期间停止安装。如果下载中途停止，按钮会显示**继续下载**，并带有已保存的兆字节数，从中断处继续。如果已有完整的 TeX 安装处于**使用中**，安装之后它仍会保持使用，你用**用于编译**选择的那一个也是如此。要切换，请在 TinyTeX 上选择**用于编译**。完整的安装包含 `latexmk`、pdfLaTeX、XeLaTeX、LuaLaTeX 和 Biber。在**自动**下，Oleafly 会把缺少其中某些组件的安装，或没有 Perl 的 MiKTeX，排在 TinyTeX 之后，所以 TinyTeX 安装好后会自动接管。安装之后，TinyTeX 有自己的一行，带有**移除**。当你的 TinyTeX 不是这个版本的 Oleafly 期望的版本时，该行还会显示**更新**。

在 Debian、Ubuntu 和 Fedora 上，用系统软件包安装的 TeX Live 归 `apt` 或 `dnf` 管理。宏包列表会这样说明，Oleafly 不会去动那份 TeX Live。请用系统工具添加宏包，如果你想让 Oleafly 来管理，就下载 TinyTeX。

**LaTeX** 标签页还包含**默认编译引擎**。新建、导入和转换而来的 LaTeX 项目都以你在这里选择的引擎开始。参见[为新项目设置默认值](/docs/engines/#set-a-default-for-new-projects)。

对于 Typst，**版本**列出 Typst 0.11 到 0.15。可以安装某个版本、为新项目选择默认版本，并用**试用较新版本**以更新的 Typst 构建当前打开的项目，在切换之前看看哪些错误和警告会发生变化。每个项目通过编译菜单固定自己的版本。参见 [Typst 版本](/docs/typst/#typst-versions)。

**Markdown 编译器**一行用于安装或修复受管理的 Pandoc。

## 下载

下载模板包和字体包，把已下载的字体添加到项目，查看已下载的拼写词典，并管理保存到你图库中的 AI 模板。**下载源**标签页设置下载内容的来源，以及 `tlmgr` 从哪个仓库安装 TeX 宏包。参见[下载](/docs/settings/downloads/)。

## 集成

每个标签页都会显示该服务自己的徽标。

| 标签页 | 它连接什么 |
|---|---|
| **GitHub** | 用于发布、拉取和推送项目的账号，以及新项目是否创建 Git 仓库。 |
| **alphaXiv** | alphaXiv 的 MCP 服务器，让助手可以搜索和阅读论文。 |
| **Zotero** | 你的 Zotero 文献库，用于在写作时引用，或导入到项目的参考文献中。 |
| **引用搜索** | 学术搜索服务所需的密钥和联系邮箱。 |
| **Oleafly MCP** | Oleafly 的本地服务器，供外部助手处理你的项目。 |
| **桌面应用** | Cua Driver，让代理可以使用你允许的桌面程序和网站。 |

[连接研究来源](/docs/integrations/research-sources/)涵盖 alphaXiv、Zotero 和引用搜索。外部 MCP 工具在 **AI 助手 → MCP** 下连接。外部助手通过**集成 → Oleafly MCP** 连接到 Oleafly。[MCP 指南](/docs/mcp/)涵盖这两个方向。

## 键盘快捷键

搜索快捷键列表，并为支持自定义的应用操作录制替代快捷键。编辑器键位与应用命令列在一起。参见[键盘快捷键](/docs/keyboard-shortcuts/)。

## 实验功能

实验功能收纳仍处于测试阶段的功能。分区顶部的警告说明，这些功能尚未经过充分测试，可能会在以后的版本中发生变化、出现故障或被移除。每个开关默认都是关闭的：

- **LaTeX 工具**会显示 Oleafly 工具图库及其斜杠命令。[Oleafly 工具指南](/docs/tools/)涵盖了所有转换器、参考文献生成器、研究实用工具、检查器和写作助手。
- **笔记**会在主屏幕程序坞中加入笔记。笔记是一个 Markdown 文件，里面可以有图表、统计图和公式，你和你的代理都可以编辑。笔记不会出现在你的项目库里，你可以把每篇笔记关联到一个项目。这个开关还会在**设置 → 外观**和**设置 → 键盘快捷键**中各增加一个**笔记**标签页。参见[笔记](/docs/notes/)。
- **研究任务**让代理在项目的副本中独立工作，并把它的更改留给你审阅。应用把它标为高度不稳定：运行可能停滞、失败，或留下需要你手动处理的更改，而且全程都会占用你的提供商配额。开启它会在设置中增加一个**研究**分区，关闭它则会停止所有正在运行的任务。参见[研究任务](/docs/research-tasks/)。

![设置 → 实验功能，LaTeX 工具、笔记和研究任务已开启，位于说明这些功能仍处于测试阶段的警告下方。](https://cdn.oleafly.com/images/screenshots/desktop/docs/settings-experimentation-dark-window-v2.png#view=424,136,1072,928)

在按照用到某个开关的指南操作之前，请先在这里开启它。

## 帮助与关于

查看应用版本、检查更新、阅读更新内容、重新开始导览、打开文档或报告问题。**复制信息**会收集版本和系统详情，供提交错误报告使用。**在论文中引用 Oleafly** 是该页面的最后一张卡片。

无论打开哪个分区，设置侧边栏底部都有五个小按钮：Discord、X、GitHub、文档和发行说明。最后一个会打开更新内容。

各个分区的详细说明参见[通用](/docs/settings/general/)、[外观](/docs/settings/appearance/)、[下载](/docs/settings/downloads/)、[存储](/docs/settings/storage/)和[帮助](/docs/settings/help/)。
