# 搭配 AI 的筆記

針對筆記詢問助理或 CLI 代理程式、接受或拒絕它建議的變更，並匯入研究任務產生的檔案。

筆記是實驗功能，在你開啟之前會一直保持關閉。請參閱[開啟筆記](/docs/notes/#turn-on-notes)。

每則筆記都有自己的助理。它會閱讀筆記，並回答與筆記有關的問題。當你要求變更時，它會提出建議，這項變更會顯示在筆記中，直到你接受或拒絕。

## 你需要準備什麼

| 要使用 | 設定 |
| --- | --- |
| **Oleafly 代理程式**，內建的助理 | 在 **設定 → AI 助理** 中設定供應商或本機模型。請參閱[設定 AI](/docs/ai-setup/)。沒有設定時，助理會顯示 **連接供應商**。 |
| **CLI 代理程式** | 在 **設定 → AI 助理 → CLI 代理程式** 中連接的代理程式。它使用代理程式自己的登入。請參閱 [CLI 代理程式](/docs/cli-agents/)。 |
| 研究任務及其產生的檔案 | 在 **設定 → 實驗功能** 中開啟 **研究任務**，並有一則連結到專案的筆記。請參閱[研究任務](/docs/research-tasks/)。 |
| Oleafly 之外的 MCP 用戶端 | 在 **設定 → 整合 → Oleafly MCP** 中選擇 **啟用 MCP 伺服器**。請參閱[透過 MCP 連接](/docs/mcp/)。 |

## 開啟助理

助理位在筆記的底部。收合時，它是一個小小的 **助理** 按鈕，同時也會標明模式：**Oleafly 代理程式** 或 **CLI 代理程式**。

- 選擇 **助理**，或在筆記中按 ⌘J（Ctrl+J）。
- 要收合它，請選擇 **隱藏指示框**，或在指示框是空的時候按同一組按鍵。
- 要詢問某個段落，請選取它，然後選擇選取範圍旁小列中的 **詢問代理程式**，或按 ⌘J（Ctrl+J）。該段落會放進你的訊息中。

助理工作時，收合的 **助理** 按鈕旁會出現 **停止** 按鈕。

若要使用其他按鍵，請在 **設定 → 鍵盤快捷鍵** 的 **筆記** 分頁中變更 **筆記：詢問代理程式**。

使用 **Oleafly 代理程式** 時，每則筆記都會保留自己的對話。**新聊天** 會開始新的對話，**聊天歷史記錄** 則會開啟先前的對話。

當至少有一個 CLI 代理程式就緒時，助理頂端會有一個開關，用來選擇 **Oleafly 代理程式** 或 **CLI 代理程式**。模型選擇器也會在 **CLI 代理程式** 下列出你的代理程式，選擇其中一個就會把筆記切換到 **CLI 代理程式**。

![在 Literature review matrix 筆記中，助理頂端的開關設為 CLI 代理程式，提示框上方的代理程式列中選了 Gemini CLI。](https://cdn.oleafly.com/images/screenshots/desktop/docs/notes-assistant-dark-window-v2.png#view=1138,0,782,1200)

在你只能閱讀的筆記中，兩種模式都無法詢問助理任何事。指示框會被「你只能檢視這篇筆記，因此助理無法變更它。」取代。

## 詢問 Oleafly 代理程式

輸入問題或要求。空白的指示框寫著「詢問這篇筆記的相關問題，或要求修改。輸入 / 查看動作」。

- 輸入 `@` 並選擇另一則筆記，就會把它的文字隨你的訊息一起傳送。
- 輸入 `/` 可使用研究動作。每個動作都會立即傳送一則與筆記有關的書面要求。

| 動作 | 它要求什麼 |
| --- | --- |
| **根據最近一次執行更新** | 連結專案最近一次研究任務的結果，只使用它所回報的數字。當該專案有已完成的任務時才會顯示。 |
| **對照程式碼查核論點** | 對照連結專案的程式碼、資料和論文，逐項查核每個論點，附上更正以及它無法驗證的論點清單。當筆記連結到專案時才會顯示。 |
| **尋找引用** | 來自它能找到並驗證的參考文獻的 `[@key]` 引用。沒有確認來源的陳述，會連同搜尋詞一起放進名為「待尋找的引用」的章節。 |
| **校對選取範圍** | 修正選取段落中的拼字、文法和標點。沒有選取任何內容時，它會顯示為 **校對筆記**。 |
| **改寫選取範圍** | 把選取的段落改寫得更清楚，並保留每個事實和數字。沒有選取任何內容時，它會顯示為 **改寫筆記**。 |
| **改得更精簡** | 更精簡的筆記，保留每個事實、數字和引用。 |
| **撰寫新段落** | 根據這則筆記和你其他筆記已經說過的內容，在適當的位置寫一個新段落。 |
| **新增比較表格** | 用筆記中已有的事實建立的表格。 |
| **新增圖片** | 一個 Mermaid 圖表，或一個帶有筆記資料的圖表區塊。 |
| **濃縮成摘要** | 在開頭加上名為「摘要」的章節，用三到五句話，可以作為摘要的開頭。 |

### Oleafly 代理程式能使用什麼

每則訊息都會帶上：

- 筆記的標題和文字，最多 12,000 個字元。需要時它可以讀取其餘部分。
- 所連結專案的名稱。
- 有多少修改建議正等著你檢視。
- 筆記旁邊檔案的名稱。
- 你有多少則筆記，以及你最近編輯的 15 則筆記的標題。

它也可以：

- 搜尋並閱讀你的其他筆記。
- 讀取、新增和變更筆記資料夾中的其他檔案，例如它的圖片和資料，並在那裡執行命令。它只會透過修改建議來變更筆記本身。
- 建立新筆記。核准卡片會先顯示它的 **標題**、**連結的專案**、**標籤** 和 **內文**。
- 列出、讀取和搜尋所連結專案的檔案，例如它的論文、程式碼和資料。它不會變更這些檔案。
- 當 **研究任務** 開啟時，在所連結的專案中啟動研究任務。

在某些筆記中，它能做的比較少：

- 在共用筆記中，它看不到你的其他筆記，所以沒有可以用 `@` 提及或搜尋的內容。
- 在專案筆記中，它無法變更專案中的檔案，也無法執行命令。

## 詢問 CLI 代理程式

CLI 代理程式在某個資料夾中工作，而是哪個資料夾取決於筆記。在共用筆記中，Oleafly 會告訴代理程式留在那個資料夾內。代理程式的權限提示和在任何專案中一樣運作。請參閱[權限請求](/docs/cli-agents/#permission-requests)。

### 沒有專案的筆記

代理程式在筆記自己的資料夾中工作，並編輯那裡的筆記檔案。Oleafly 會把每項變更以修改建議的形式顯示在筆記中。如果你在代理程式仍在工作時關閉筆記，Oleafly 會在它完成時把它的變更從檔案中取出，並保留為修改建議，等你下次開啟筆記時使用。

### 已連結的筆記或專案筆記

代理程式在專案的資料夾中工作，筆記的文字（前 60,000 個字元）會隨你的訊息一起傳送。Oleafly 會請代理程式閱讀專案並且不要動它的檔案，並在代理程式有唯讀或規劃模式時，讓它進入該模式。它想在筆記中做的變更，會以修改建議的形式傳回。

- 如果代理程式沒有唯讀模式，Oleafly 會警告它可能變更專案中的檔案，並詢問是否仍要傳送你的訊息。請選擇 **仍然傳送** 或 **不要傳送**。
- 當代理程式不在唯讀模式時，助理會顯示「這個代理程式可以變更所連結專案中的檔案。」

## 檢視建議的變更

建議的變更會在筆記中以醒目提示標示，目前這一項旁邊有一個檢視列。

- **接受**，或 ⌘↵（Ctrl+Enter），會保留這項變更。
- **拒絕** 會捨棄它。**復原**，或 ⌘Z（Ctrl+Z），會帶回你剛拒絕的內容。
- 變更不只一項時，**上一個變更** 和 **下一個變更** 可以在它們之間移動，**全部接受** 或 **全部拒絕** 則會一次處理完每一項。

在個人筆記中，Oleafly 會在 **全部接受** 套用變更之前儲存一個版本。要回到它，請選擇筆記標頭中的 **更多 → 版本記錄**。請參閱[版本記錄](/docs/notes/writing/#version-history)。

尚未開啟的筆記的修改建議，會在這台電腦上等到你開啟它為止。側邊欄和筆記首頁中筆記旁的圖示會顯示「這篇筆記中有待處理的修改建議」。其他程式對開啟中筆記所做的變更，也會以修改建議的形式出現，除非你正在和其他人即時編輯這則筆記。請參閱[用其他程式編輯筆記](/docs/notes/#edit-a-note-in-another-program)。

## 研究任務產生的檔案

開啟 **研究任務** 後，連結到專案的筆記會收集該專案的研究任務所產生的檔案。

1. 在筆記中開啟這則筆記。
2. 選擇 **產物** 按鈕，也就是筆記右上角的面板圖示。它的徽章會計算筆記所屬專案的檔案數量。
3. 選擇一個檔案。面板會顯示它的類型、產生它的代理程式、時間、帶有任務名稱的 **來自任務**、它的路徑、預覽，以及任務的摘要。
4. 選擇 **插入筆記**，把檔案複製到筆記中。Oleafly 會把它加在筆記的結尾：圖片會以影像形式加入（PDF 圖片則是連結），筆記本會以筆記本區塊加入，其他任何檔案則以連結加入。

每個檔案都有類型：**圖片**、**互動式圖表**、**報告**、**資料**、**筆記本** 或 **檔案**。互動式圖表在面板中沒有預覽。要執行它，請把它的程式碼貼到筆記的 HTML 區塊中，然後選擇 **執行**。

## 代理程式加入的程式碼

當代理程式加入帶有指令碼的 HTML 區塊或 React 區塊時，區塊會等待 **執行**，就像是你自己加入的一樣。如果你勾選了 **一律執行這個區塊**，代理程式對程式碼所做的變更，會讓區塊再次等待 **執行**。請參閱[會執行程式碼的區塊](/docs/notes/writing/#blocks-that-run-code)。

## 專案助理中的連結筆記

開啟筆記後，專案中的 Oleafly 代理程式也會取得連結到該專案的最多 12 則個人筆記的標題和簡短摘要，最近編輯的排在最前面。在共用專案中，它不會取得這些內容。[把筆記連結到專案](/docs/notes/projects-and-sharing/#link-a-note-to-a-project)說明了如何連結一則筆記。

## MCP 用戶端

開啟筆記後，連接到 Oleafly 的 MCP 用戶端可以列出、搜尋和閱讀你的筆記、讀取今日的每日筆記、列出任務和反向連結、在筆記結尾加入文字，並改寫其中一個章節。它的變更會以修改建議的形式出現在筆記中。建立筆記，包括今日的每日筆記，會等待你在 Oleafly 中核准。共用筆記可以讀取，但無法用這種方式變更。請參閱[透過 MCP 連接](/docs/mcp/)。
