在 Oleafly 中与助手协作
连接模型或 CLI 代理,设置批准规则,并交给它一个可以验证的任务。
在 Oleafly 中与助手协作
好的请求会让助手得到一个可以检查的结果。比如这样说:“修复这个项目中未定义的引用,编译项目,并报告还缺少哪些键。”Oleafly 让助手可以访问项目文件、参考文献工具、编译器日志和 PDF 检查,所以工作不会停留在一段建议的代码片段上。
连接你使用的助手
打开 设置 → AI 助手。在 提供商与密钥 中,配置托管提供商、自定义的 OpenAI 兼容端点,或 Ollama。使用本地模型时,先启动 Ollama,下载你想用的模型,再连接它的本地服务器。模型和项目依赖都下载完成后,这套配置可以离线使用。
你也可以选择 CLI 代理,来配置已安装的代理,例如 Claude Code 或 Codex。它们使用各自的账号和身份验证。回到助手,选择 Oleafly 代理 或 CLI 代理,然后为这次对话选择运行时和模型。具体步骤见提供商设置、CLI 代理和 Ollama。
设置批准模式
批准选择器位于聊天消息输入框的下方,并按项目保存。
| 模式 | 适用场景 |
|---|---|
| 请求批准 | 让归类为只读的工具直接运行,其他操作先经你审阅。 |
| 替我批准 | 允许读取类和网络类工具;文件修改和 shell 命令仍会先询问。 |
| 完全访问权限 | 让工具操作无需批准提示直接运行。 |
| 自定义 | 应用你保存的允许/拒绝规则,对未匹配的工具采用标准风险策略。 |
第一次编辑会话请选择 请求批准。接受每张批准卡片之前,先阅读卡片上的工具操作。如果要编辑选中的一段文字,行内编辑会给你一个便于检查的、有针对性的替换结果。批准控制会因所选运行时而异;CLI 代理也有它自己的配置。
指令与批准讲解项目规则、approvals.toml 以及其他配置文件。指令引导工作;批准模式则控制助手可以运行什么。
提供足够的上下文
把相关的章节、参考文献、图和数据都放在项目里。用 添加上下文 把助手指向与这次请求有关的材料。对于符号或风格方面的偏好,把自定义指令保存在 设置 → AI 助手 → 指令 下:
保留导言区中的符号宏。引用键保持不变。编辑 LaTeX 之后,编译并检查受影响的 PDF 页面。报告任何你无法验证的内容。
技能提供可复用的工作流程,用于文献检索、图、审阅和其他反复出现的工作。从助手的技能卡片或斜杠菜单中选择一个,然后补上你的问题和所需的输出。
让结果可检查
修复构建时,指明出错的文件,并要求编译成功。生成图时,说明数据、尺寸、标签和存放位置。做文献检索时,要求给出标题、来源链接,并简短说明每篇论文为什么属于这次综述。
针对某一节的请求可以这样写:
为使表达更清晰,修改引言的前两段。保留其中的主张、符号和引用键。编译项目,并检查修改后的文字是否出现在 PDF 中。列出你的改动。
对照请求来阅读结果。构建成功只能说明文档能够编译,并不能证明某个科学论断或引用是正确的。
把较长的工作交给研究任务
打开 研究工作区 → 任务 → 新建任务。为它起一个标题,写下指令,并选择一个可用的 代理与模型。创建任务,然后启动它。代理会在一份隔离的副本中工作,你可以继续写作。
例如,让它生成 reading-list.md,列出五篇相关论文、经过核实的标识符,以及说明每篇论文相关性的一段话。在 活动 中跟进进度,在 审阅 中打开文件预览,准备好后再应用选中的结果。这适用于文献检索、独立审阅,或者你想先检查、再并入稿件的图表实验。
研究任务指南涵盖启动、停止、审阅、应用和移除任务。
保留有用的版本
已保存的检查点和 Git 各有分工。编译成功之后,如果源文件有变化且这次构建符合条件,Oleafly 可以保存一个检查点。打开 版本管理 → 已保存的检查点 来查看或恢复检查点。用 源代码管理 来主动进行 Git 提交,并与协作者分享。
并不是每次 AI 编辑之前都会自动创建检查点。在大幅修改之前,先编译当前草稿并确认已有检查点,或者做一次 Git 提交。参见检查点和 Git 历史。