在 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 歷史記錄。

返回 人 + 模型