# 使用助手

修改稿件、修复构建、查找来源，并在项目内跟踪助手的工作。

直接说出你需要的结果。助手可以在同一个工作区里读取你的文件、进行编辑、编译论文，并检查输出。

> 编译这篇论文，读取错误信息并修复构建。再次编译以检查结果。

打开助手面板，选择一个已连接的模型或 [CLI 代理](/docs/cli-agents/)。[设置 AI](/docs/ai-setup/) 介绍了这两种方式。

![LaTeX 编辑器和旁边的助手、其技能以及输入框控件](https://cdn.oleafly.com/images/screenshots/desktop/docs/llama-assistant-editor-dark-window-v2.png)

## 提供合适的上下文

提问前，可以用 `@` 提及文件或文件夹，附加参考文档，或选中一段文字。提及文件会带上文件内容；提及文件夹会带上目录列表，让助手能找到所需的材料。

内置助手一开始就带有项目上下文，例如当前文件、选区、项目结构和编译状态。它还可以通过工具读取更多内容。[已链接文件夹](/docs/linked-folders/)让你引用论文文件夹之外的数据和 PDF。

## 网站和其他应用

在输入框中打开**网络**，让助手搜索网络并读取网页。Anthropic 的较新 Claude 模型和较新的 OpenAI 模型使用其提供商自己的搜索。其他模型直接读取网页，并用你在设置中添加的搜索密钥进行搜索。回答会保留所用的网址，方便你核对；助手把网页文字当作要阅读的材料，绝不当作指令。

要让代理在网站或你电脑上的程序里点击操作，例如期刊的投稿表单或统计软件，请在**设置 → 集成**中设置**桌面应用**。它运行 Cua Driver，需要你自己安装。你来选择它可以使用的应用和网站，每次点击或按键之前它都会先询问。Oleafly 中的链接会在你的默认浏览器中打开。

## 跟踪工作过程

回复会按顺序显示文字、工具活动、建议的更改和进度。展开工具卡片可以查看它的输出。编译结果可以带你打开日志或 PDF；文献结果可以带你打开对应的论文。

| 让它… | 它可以使用的内容 |
| --- | --- |
| 改进某一节 | 项目文件、选中的文字、你的指令，以及可编辑的差异 |
| 修复构建 | 编译器、诊断信息、日志和 PDF 文本 |
| 补充参考文献 | OpenAlex 搜索、元数据查询和你的参考文献库 |
| 画图表 | LaTeX 中的 TikZ 或 PGFPlots，Typst 中的 CeTZ 或 fletcher，图形单独预览，以及插入图形 |
| 审阅论文 | 草稿、参考文献、研究笔记和[审阅技能](/docs/workflows/review-and-submit/) |

可用的工具取决于文档引擎和所选的运行时。用工具控件选择要开放哪些工具组。图形工具适用于 LaTeX 和 Typst 项目，不适用于 Markdown。

文献搜索使用保存在**设置 → 集成 → 引用搜索**中的 OpenAlex API 密钥和联系邮箱。如果你[连接了 alphaXiv](/docs/integrations/research-sources/#alphaxiv)，助手还可以在那里搜索和阅读论文，并使用你的 alphaXiv 文库。每次调用 alphaXiv 之前它都会先询问你。

## 编辑前先做计划

遇到需要先做几个决定的任务，请打开**计划**。助手在准备清单时可以读取和搜索，但在编辑、编译或运行命令之前会先等待。

计划出现后，选择**批准计划**或**修改**。你也可以直接输入反馈。工作运行期间，进度提示会显示当前步骤和已更改的文件。批准计划后，仍沿用你所选的编辑审批策略。

有些模型在计划模式下只回答，不写计划。出现这种情况时，回复下方会显示一条提示：**还没有可批准的计划。请让助手先提出一个计划，或关闭“计划”。** 如果修改后得到的计划与之前相同，提示会显示 **计划没有变化。**

## 审阅建议的编辑

想在应用更改之前先检查时，请选择**请求批准**。阅读差异，然后批准或拒绝该操作。**替我批准**和**完全访问权限**会给助手更大的自主权；当前生效的策略会显示在界面中。

无论采用哪种策略，你都可以在一轮结束后查看并撤销这一轮的更改。如果想等代理完成后，再在项目副本上审阅其工作，请使用[研究任务](/docs/research-tasks/)。任务允许你只应用选中的文件。

## 审阅并撤销一轮的更改

当助手或 [CLI 代理](/docs/cli-agents/)更改了文件时，回复下方会有一行文字说明更改了多少个文件，例如**已更改 3 个文件**，以及新增和删除的行数。

- **审阅**会列出每个文件，标明已添加、已修改或已删除。点击某个文件可查看它的差异。
- 文件上的**撤销**会让它恢复到这一轮开始之前的样子。**重做**会把更改恢复回来。
- **全部撤销**一次撤销这一轮的所有源文件。`.aux` 和 `.log` 等构建输出会单独列在**已更新构建文件**下，永远不会被撤销。

如果某个文件在这一轮之后又被更改，撤销会跳过它，并标记为**本轮之后又有更改**。**全部撤销**还会跳过你在这一轮期间自己编辑过的文件，以及助手已提交到 Git 的文件，后者会显示**已在 … 中提交**，并附上对应的提交。代理完成后，撤销和重做才可用。如果另一个代理在同一项目中同时更改了文件，请逐个撤销文件。

撤销依据的是 Oleafly 在每一轮开始前制作的项目副本。副本保存在 Oleafly 自己的数据文件夹 `~/.oleafly/agent-turns` 中，绝不会放进你的项目。超过 25 MB 的文件不会被复制，因此撤销无法恢复它。如果项目的文件超过 20,000 个或大小超过 512 MB，或者复制耗时过长，这一轮就不会生成副本，该行文字会说明无法撤销。Oleafly 会保留最近 14 天内每一轮的副本，以及每个项目最新的 100 轮的副本。超出这个范围后，这一轮会显示**本轮已无法再撤销。**

## 中途改变方向

助手工作时发送一条后续消息，然后选择**立即插入**，让它在下一个安全点送达。例如：

> 保留现有的符号约定。把修改集中在公式 3 下面的说明上。

如果运行先结束了，这条消息就会成为下一轮。**停止**会取消正在进行的运行。

## 复用好用的工作流

输入 `/` 选择一个[技能](/docs/skills/)，或者在一次有用的对话之后使用**录制技能**。技能可以把你在多篇论文中重复的步骤固定下来：核对论述、准备图形，或起草回复审稿人的信。

多个内置技能除了 LaTeX 也懂 Typst。`oleafly-figure-prep` 绘制 CeTZ 和 fletcher 图形，`citation-management` 可以写 Hayagriva 参考文献，`oleafly-response-letter` 会为 Typst 论文用 Typst 写回复信，`oleafly-pre-submission` 则包含针对 Typst 项目的检查。

人设和长期指令放在 AI 设置中。用它们来记录拼写、语气和符号约定等偏好。

## 历史记录和用量

打开对话历史可以回到之前的对话。带有已保存还原点的回复会提供**将代码恢复到此回复之前**。若要查看对话之外的文档历史，请使用[版本管理](/docs/checkpoints/)。

用量计数器会打开[用量报告](/docs/ai-usage/)，你可以在其中按项目、代理、模型和日期筛选工作。

托管模型会收到提供给它们的上下文。如果希望模型请求保留在你的电脑上，请使用本地模型。**悬浮助手**是助手标题栏中的画中画按钮，它会把面板悬浮在[编辑器](/docs/editor/)上方。**重新停靠**会把它放回侧边栏。

## 新建对话

![助手工具栏包含 MCP 设置、工具管理、设置、用量、新建对话（+）、历史记录和悬浮视图。](https://cdn.oleafly.com/images/screenshots/desktop/docs/llama-assistant-editor-dark-window-v2.png#view=1439,45,479,49)

点击助手标题栏中的**新建对话**，开始一个独立的对话。针对不同的问题或章节开启新对话，上下文会更容易跟踪。新对话会使用你配置的默认模型。

## 对话历史

点击**对话历史**可以重新打开一段对话。想修改之前的结果，或询问它是怎么得出的，可以接着已有的消息继续。

## 附加文件

![消息输入框下方的 + 会打开“添加上下文”。批准模式、提示词、人设、计划模式、模型和发送都在同一行。](https://cdn.oleafly.com/images/screenshots/desktop/docs/llama-assistant-editor-dark-window-v2.png#view=1441,973,475,105)

打开附件菜单即可添加辅助材料。文件选择器接受图片、PDF、文本、LaTeX、Typst、BibTeX 和 Markdown 文件。发送之前，请检查输入框上方的附件标签。

## 移除附件

使用附件标签上的移除控件，可以让它不随下一条消息发送。这只是把附件从草稿消息中去掉，不会删除磁盘上的原文件。

## 提及文件或文件夹

输入 `@` 并选择匹配的项目条目。提及文件会提供文件内容；提及文件夹会提供目录列表，助手可以据此决定接下来读什么。文件较长时，请在提示中同时写明相关的章节。

## 提示词

打开**提示词**可以使用现成的起始请求。选中一条后，它会填入输入框，你可以在发送前根据当前论文调整。请包含一个具体的目标，例如章节名称或失败的编译。

在 Typst 项目中，提示词要求生成 Typst 而不是 LaTeX。**修复 LaTeX 错误**会变成**修复 Typst 错误**，**TikZ 图形**会变成 **CeTZ 图形**，公式、表格和演示文稿提示词则会生成 Typst 公式、Typst 表格和 Typst 幻灯片。

## 人设

从输入框中选择一个人设，即可使用已保存的指令预设。选择**无**可回到你的默认指令。启用的人设会替换默认的自定义指令文本；[指令与审批](/docs/ai-instructions/)说明了如何配置这两者。

## 模型选择器

选择一个已配置的提供商和已启用的模型。请选择具备任务所需能力的模型：视觉任务需要支持图像，而多步骤的项目工作需要可用的工具支持。如果更改端点或模型后需要重试能力检查，请使用**重新检查**。

## 推理强度

当所选模型或运行时提供推理控件时，请为任务选择其强度等级。可用的取值取决于该模型。强度越高，响应时间和用量可能越多；简短的措辞修改通常比详细的稿件审阅需要的强度低。

对于会先思考再作答的本地 Ollama 或 Lemonade 模型，选择**无**即可跳过思考步骤。参见[跳过思考步骤](/docs/ollama/#skip-the-thinking-step)。

## 发送

点击**发送**，把消息连同所选的附件、模型、人设和批准模式一起提交。如果任务涉及多个文件，发送前请把任务再读一遍。

## 停止

点击**停止**可取消正在进行的运行。在让助手继续之前，请先检查它已经做出的更改；停止运行不会撤销已完成的编辑。

## 滚动到底部

读完前面的工具输出后，使用**滚动到底部**回到最新消息。工作继续进行时，你也可以向上滚动查看对话。

## 排队的消息

在运行期间发送后续消息会把它排入队列。**立即插入**会在下一个安全点传达这条指令。使用**丢弃已排队消息**可以移除你不再想发送的后续消息。

## 持久目标

当多轮对话要朝同一个结果努力时，请设置目标。输入目标内容并选择**保存目标**。点击目标标签可以编辑，点击**清除目标**可以移除。目标要具体，例如准备好方法部分及其图形以供审阅。

## 助手设置

标题栏中的设置控件会打开 AI 配置。用它连接提供商、启用模型、编辑指令，或管理人设和技能。

## 助手 MCP 设置

MCP 设置控件会打开外部服务器的配置，这些服务器提供的工具供内置助手使用。它与让外部应用控制 Oleafly 的服务器是分开的。请参阅 [MCP 连接](/docs/mcp/)。

## 用量报告

点击用量指示器或**用量报告**，查看已记录的工作。用报告中的筛选器比较项目、模型、运行时或日期范围。[用量与预算](/docs/ai-usage/)说明了各个字段和预算控件。

## 从头到尾审阅一节

1. 选中这一节，并在输入框中提及它的源文件。
2. 选择一个已连接的模型和**请求批准**。
3. 提问：“审阅这一节的清晰度。保留论述、数字、标签和引用键。先给出修改建议。”
4. 阅读建议的编辑及其说明。
5. 批准你想要的更改，然后让助手编译。
6. 在 PDF 中检查更新后的这一节，包括参考文献和图形位置。
