结合 AI 使用笔记
就一篇笔记询问助手或 CLI 代理,接受或拒绝它提出的修改建议,并带入研究任务产生的文件。
笔记是一项实验功能,在你开启之前一直关闭。参见开启笔记。
每篇笔记都有它自己的助手。它会阅读这篇笔记,并回答关于它的问题。当你要求修改时,它会提出建议,这项修改会显示在笔记中,直到你接受或拒绝。
你需要什么
标题为“你需要什么”的部分| 要使用 | 设置 |
|---|---|
| Oleafly 代理,内置的助手 | 设置 → AI 助手中的一个提供商或本地模型。参见设置 AI。没有的话,助手会显示连接提供商。 |
| CLI 代理 | 在设置 → AI 助手 → CLI 代理中连接的一个代理。它使用该代理自己的登录。参见 CLI 代理。 |
| 研究任务及其生成的文件 | 在设置 → 实验功能中开启研究任务,并且有一篇关联到项目的笔记。参见研究任务。 |
| Oleafly 之外的 MCP 客户端 | 设置 → 集成 → Oleafly MCP中的启用 MCP 服务器。参见通过 MCP 连接。 |
打开助手
标题为“打开助手”的部分助手位于笔记底部。折叠时,它是一个小小的助手按钮,上面还写着当前的模式,Oleafly 代理或 CLI 代理。
- 选择助手,或在笔记中按 ⌘J(Ctrl+J)。
- 要折叠它,请选择隐藏指令框,或在指令框为空时按相同的按键。
- 要就某一段文字提问,请选中它,然后选择选区旁边的小栏中的询问代理,或按 ⌘J(Ctrl+J)。这段文字会放进你的消息中。
助手工作期间,折叠的助手按钮旁边会出现一个停止按钮。
要使用其他按键,请在设置 → 键盘快捷键的笔记标签页中更改笔记:询问代理。
使用 Oleafly 代理时,每篇笔记都有它自己的对话。新对话会开始一个全新的对话,对话历史会打开较早的对话。
当至少有一个 CLI 代理就绪时,助手顶部会有一个开关,用来选择 Oleafly 代理或 CLI 代理。模型选择器也会在 CLI 代理下列出你的代理,选中其中一个会把这篇笔记切换到 CLI 代理。

在你只能阅读的笔记中,两种模式下你都不能向助手提问。指令框会被替换成“你只能查看这篇笔记,因此助手无法修改它。”
询问 Oleafly 代理
标题为“询问 Oleafly 代理”的部分输入一个问题或请求。空的指令框写着“询问有关这篇笔记的问题,或要求修改。输入 / 查看操作”。
- 输入
@并选取另一篇笔记,就会把它的文字随你的消息一起发送。 - 输入
/可使用研究操作。每一个都会立刻发送一条关于这篇笔记的书面请求。
| 操作 | 它要求什么 |
|---|---|
| 根据最近一次运行更新 | 关联项目最近一次研究任务的结果,只使用它报告的数字。当该项目有已完成的任务时显示。 |
| 对照代码核查论断 | 对照关联项目的代码、数据和论文逐条核查论断,给出更正,并列出它无法验证的论断。当笔记关联到项目时显示。 |
| 查找引用 | 来自它能找到并核实的参考文献的 [@key] 引用。没有得到确认来源的陈述会放在名为 Citations to find 的部分,并附上检索词。 |
| 校对所选内容 | 对所选段落进行拼写、语法和标点的修正。没有选中任何内容时,它显示为校对笔记。 |
| 改写所选内容 | 把所选段落改写得更清晰,并保留每一个事实和数字。没有选中任何内容时,它显示为改写笔记。 |
| 改得更简短 | 一篇更简短的笔记,保留每一个事实、数字和引用。 |
| 写一个新段落 | 在合适的位置写一个新段落,依据是这篇笔记和你的其他笔记已经写下的内容。 |
| 添加对比表格 | 根据笔记中已有的事实生成的表格。 |
| 添加图片 | 一个 Mermaid 图表,或一个带有笔记中数据的统计图块。 |
| 总结成摘要 | 在开头加一个名为 Summary 的部分,用三到五句话写成,可以作为摘要的开头。 |
Oleafly 代理能用到什么
标题为“Oleafly 代理能用到什么”的部分每条消息,它都会得到:
- 笔记的标题和文字,最多 12,000 个字符。需要时它可以阅读其余的部分。
- 关联项目的名称。
- 有多少条建议在等待你审阅。
- 笔记旁边的文件的名称。
- 你有多少篇笔记,以及你最近编辑的 15 篇的标题。
它还可以:
- 搜索并阅读你的其他笔记。
- 读取、添加和更改笔记文件夹中的其他文件(例如它的图片和数据),并在那里运行命令。它只通过建议来更改笔记本身。
- 创建一篇新笔记。批准卡片会先显示它的标题、关联的项目、标签和正文。
- 列出、读取和搜索关联项目的文件,例如它的论文、代码和数据。它不会更改这些文件。
- 在研究任务开启时,在关联的项目中启动研究任务。
在某些笔记中,它能做的会少一些:
- 在共享笔记中,它看不到你的其他笔记,所以没有可以用
@提及或搜索的内容。 - 在项目笔记中,它不能更改项目中的文件,也不能运行命令。
询问 CLI 代理
标题为“询问 CLI 代理”的部分CLI 代理在一个文件夹中工作,这个文件夹取决于笔记。在共享笔记中,Oleafly 会告诉代理待在那个文件夹里。代理的权限提示与在任何项目中一样。参见权限请求。
没有项目的笔记
标题为“没有项目的笔记”的部分代理在笔记自己的文件夹中工作,并编辑那里的笔记文件。Oleafly 会把每项更改作为建议显示在笔记中。如果你在代理仍在工作时关闭了笔记,Oleafly 会在它完成时把它的更改从文件中取出,并把它们保留为建议,等你下次打开这篇笔记时查看。
已关联的笔记或项目笔记
标题为“已关联的笔记或项目笔记”的部分代理在项目的文件夹中工作,笔记的文字(前 60,000 个字符)会随你的消息一起发送。Oleafly 会要求代理阅读项目但不要动它的文件,并且在代理有只读模式或计划模式时,把它切换到该模式。它想对笔记做的更改会作为建议返回。
- 如果代理没有只读模式,Oleafly 会警告说它可能更改项目中的文件,并询问是否仍要发送你的消息。选择仍然发送或不发送。
- 当代理不处于只读模式时,助手会显示“此代理可以更改关联项目中的文件。”
审阅修改建议
标题为“审阅修改建议”的部分修改建议会在笔记中高亮显示,当前这一条旁边有一个审阅栏。
- 接受,或 ⌘↵(Ctrl+Enter),会保留这项更改。
- 拒绝会放弃它。撤销,或 ⌘Z(Ctrl+Z),会把你刚拒绝的内容找回来。
- 有多项更改时,上一个更改和下一个更改可以在它们之间移动,全部接受或全部拒绝则处理每一项。
在个人笔记中,Oleafly 会在全部接受应用这些更改之前保存一个版本。要回到它,请选择笔记页眉中的更多 → 版本历史。参见版本历史。
针对未打开笔记的建议会在这台电脑上等待,直到你打开它。侧边栏和笔记主页中该笔记旁边的图标会显示“这篇笔记中有待处理的修改建议”。另一个程序对已打开笔记所做的更改也会显示为建议,除非你正在与他人实时编辑这篇笔记。参见在其他程序中编辑笔记。
研究任务产生的文件
标题为“研究任务产生的文件”的部分在研究任务开启时,关联到项目的笔记会收集该项目的研究任务生成的文件。
- 在笔记中打开这篇笔记。
- 选择产物按钮,也就是笔记右上角的面板图标。它的徽标统计这篇笔记所属项目的文件数。
- 选取一个文件。面板会显示它的类型、生成它的代理、时间、带有任务名称的来自任务、它的路径、预览和任务的摘要。
- 选择插入到笔记,把文件复制到笔记中。Oleafly 会把它加在笔记末尾:图片以图像形式(PDF 图片则以链接形式)、笔记本以笔记本块的形式,其他任何文件以链接的形式。
每个文件都有一个类型:图片、交互式图表、报告、数据、笔记本或文件。交互式图表在面板中没有预览。要运行它,请把它的代码粘贴到笔记的 HTML 块中,然后选择运行。
代理添加的代码
标题为“代理添加的代码”的部分当代理添加带有脚本的 HTML 块或 React 块时,这个块会等待运行,就像是你自己添加的一样。如果你勾选了始终运行此块,代理对代码的更改会让这个块再次等待运行。参见运行代码的块。
项目助手中的已关联笔记
标题为“项目助手中的已关联笔记”的部分笔记开启时,项目中的 Oleafly 代理还会得到最多 12 篇关联到该项目的个人笔记的标题和一段简短摘要,最近编辑的排在前面。在共享项目中,它不会包含这些笔记。把笔记关联到项目介绍了如何关联一篇笔记。
MCP 客户端
标题为“MCP 客户端”的部分笔记开启时,连接到 Oleafly 的 MCP 客户端可以列出、搜索和阅读你的笔记,读取今日的每日笔记,列出任务和反向链接,把文字添加到笔记末尾,并重写笔记的某一节。它所做的更改会作为建议出现在笔记中。创建笔记(包括今日的每日笔记)要等你在 Oleafly 中批准。通过这种方式,共享笔记可以读取但不能更改。参见通过 MCP 连接。