# 設定

選擇你的寫作方式、連接研究工具，並管理本機儲存空間。

從側邊列的齒輪或指令面板開啟**設定**，也可以在 macOS 上按 ⌘,，在 Windows 與 Linux 上按 Ctrl+,。這個快捷鍵在分離的 PDF 視窗中也能使用，在 macOS 上，**Oleafly** 選單裡也有**設定…**。設定只適用於這台電腦，除非你開啟了[雲端同步](/docs/cloud-sync/#settings)。專案的引擎、主文件和其他專案選項，則會隨專案檔案一起移動。

![從專案工具列開啟設定。左欄列出所有設定區段。](https://cdn.oleafly.com/images/screenshots/desktop/docs/settings-general-dark-window-v2.png#view=519,89,883,902)

## 尋找設定

在左欄頂端的**搜尋設定**中輸入一個詞，例如「theme」、「Zotero」或「spelling」。區段清單會縮減為符合的區段和設定。選擇一項設定即可跳過去。Oleafly 會開啟正確的分頁，捲動到該列，並加上底色讓你找得到。

## 重設區段

一般、外觀、字典、AI 助理、引擎、鍵盤快捷鍵和實驗功能的最後，都有**重設為預設值**。按鈕上的小圓點表示該區段中有內容與預設值不同。重設某個區段，不會影響其他區段。

## 路徑保持隱藏

家目錄內的路徑會顯示為 `~/…`。設定中的檔案與資料夾路徑，例如專案資料夾、引擎位置和 CLI 代理程式，在你把游標移到上面或用 Tab 鍵移到它之前，都會保持模糊。這樣設定畫面的螢幕截圖就不會洩漏你的檔案放在哪裡。

## 一般

選擇介面語言、設定校對、開啟或關閉離線編譯，並控制導覽。介面提供 21 種語言，**系統預設**會跟隨你的作業系統。新的語言會立即生效。

[一般的每個控制項](/docs/settings/general/)都有各自的說明。**離線模式**會讓 Tectonic 和 Typst 只使用它們已有的套件，並關閉網路引用查詢。讓新專案離線之前，請先閱讀[編譯](/docs/compiling/)。

## 外觀

選擇淺色或深色主題、強調色、背景，以及應用程式和編輯器的字型。電腦上安裝的任何字型都可以使用。設定整個應用程式的縮放等級、調整文字大小，並選擇專案要以分割檢視、僅編輯器或僅 PDF 開啟。編輯器有一個淺色模式主題和一個深色模式主題，**編輯器顏色**可以變更任一主題的任何顏色。這裡的編輯器控制項還包括行高、字元間距、游標、自動完成、括號、數學與環境的配對、固定捲動的上下文、按鍵組合（預設、Vim 或 Emacs）、行內建議，以及檔案移動時路徑要如何處理。你也可以控制檔案樹、專案庫的 PDF 預覽和禪模式。**終端機**分頁會設定內建終端機的樣式。它的**資料夾開啟方式**設定會選擇**在終端機中開啟**，以及 Oleafly 替你執行的命令（例如登入 CLI 代理程式）所使用的終端機應用程式。可以是內建終端機，也可以是其他應用程式，例如 macOS 上的 iTerm、Windows 上的 Windows 終端機，或 Linux 上的 GNOME Terminal。請參閱[外觀與主題](/docs/settings/appearance/)。

## 字典

檢視你已忽略的字詞。**全域**分頁列出在每個專案中都略過的字詞，**專案**分頁則列出只在開啟中的專案略過的字詞。移除某個字詞後，校對就會再次納入它。分頁下方是你關閉的文法規則、已駁回的發現，以及**學術設定檔預設關閉的規則**：每條規則都附有說明、範例，以及開啟它的開關。請參閱[拼字與文法](/docs/spellcheck-grammar/)。

## 資料儲存

查看專案庫放在哪裡，以及專案、檔案、Git 歷史記錄和建置快取用了多少空間。在**本機儲存**下控制自動[檢查點](/docs/checkpoints/)及其儲存空間通知。**雲端同步**分頁會把你專案庫中的專案和設定備份到 Dropbox。請在這裡管理本機儲存空間，備份時請依照[你的資料放在哪裡](/docs/where-your-data-lives/)。

## AI 助理

| 分頁 | 你可以設定的內容 |
|---|---|
| **供應商與金鑰** | 雲端供應商、相容端點、本機模型、模型選擇器、專案核准與預算。 |
| **CLI 代理程式** | 安裝、連接並設定在你電腦上執行的代理程式。 |
| **指示** | 寫作指示、模型預設值、PDF 擷取與工具目錄。 |
| **角色** | 針對不同類型工作的具名指示預設組。 |
| **技能** | 研究工作流程、領域指引與你自己可重複使用的技能，附有搜尋框，每項技能各有一個開關。 |
| **MCP** | 助理可使用的外部工具，包括伺服器探索與設定匯入。 |
| **工具** | 工具所用的模型，例如本機模型或已連接的 CLI 代理程式，以及你的 Mathpix 金鑰。 |

請從[設定 AI](/docs/ai-setup/) 開始。個別控制項請閱讀 [CLI 代理程式](/docs/cli-agents/)、[技能](/docs/skills/)以及[用量與預算](/docs/ai-usage/)。

## 引擎

管理用來編譯文件的工具。對於 LaTeX，Oleafly 可以偵測系統上的 TeX 安裝，也可以安裝它自己的 TinyTeX。套件管理和標記式 PDF 設定都在這裡。請參閱 [LaTeX 引擎與套件](/docs/latex-engines/)。

**LaTeX** 分頁上的**管理 TeX 發行版**會列出 Oleafly 找到的每個 TeX 安裝，例如 MacTeX、TeX Live、MiKTeX 或 TinyTeX。安裝有 `latexmk` 或 `tlmgr` 工具時，每一列會顯示對應的徽章，而**使用中**標示 latexmk 編譯所使用的那一個。要改用另一個編譯，請在它那一列選擇**用於編譯**。那一列上的**自動**會把選擇交還給 Oleafly，它會先選完整的系統 TeX，再選 TinyTeX。沒有 Perl 的 MiKTeX 會顯示 **latexmk 需要 Perl**，在你安裝 Perl（例如 Strawberry Perl）之前無法選用。如果 TeX 安裝在 Oleafly 不會尋找的資料夾中，**選擇 TeX 資料夾**可以讓你選取它。請參閱 [latexmk 與系統 TeX](/docs/latex-engines/#latexmk-and-system-tex)。

沒有 Oleafly 自己的 TinyTeX 時，TinyTeX 卡片會提供**下載 TinyTeX（約 250 MB）**。TinyTeX 下載、解壓縮和加入套件時，按鈕會顯示進度，而**取消**可以在下載和解壓縮期間停止安裝。如果下載中途停止，按鈕會顯示**繼續下載**，並附上已經儲存的 MB 數，然後從那裡接續。如果已有完整的 TeX 安裝處於**使用中**，安裝之後它仍會維持使用中，你以**用於編譯**選定的那一個也一樣。要切換，請在 TinyTeX 上選擇**用於編譯**。完整的安裝有 `latexmk`、pdfLaTeX、XeLaTeX、LuaLaTeX 和 Biber。在**自動**模式中，Oleafly 會把缺少其中某些工具的安裝，或沒有 Perl 的 MiKTeX，排在 TinyTeX 後面，所以 TinyTeX 一安裝好就會自行接手。安裝之後，TinyTeX 有自己的一列，附有**移除**。當你的 TinyTeX 不是這個版本的 Oleafly 預期的發行版時，該列也會顯示**更新**。

在 Debian、Ubuntu 和 Fedora 上，用系統套件安裝的 TeX Live 屬於 `apt` 或 `dnf`。套件清單會這樣說明，而 Oleafly 不會動那個 TeX Live。請用系統工具加入套件，或在你想讓 Oleafly 管理它們時下載 TinyTeX。

**LaTeX** 分頁中也有**預設編譯引擎**。新建、匯入和轉換的 LaTeX 專案，都會從你在那裡選的引擎開始。請參閱[為新專案設定預設值](/docs/engines/#set-a-default-for-new-projects)。

對於 Typst，**版本**列出 Typst 0.11 到 0.15。你可以安裝某個版本、選擇新專案的預設版本，並用**試用較新版本**，以較新的 Typst 建置開啟中的專案，在切換之前看看哪些錯誤和警告會改變。每個專案都在編譯選單中固定自己的版本。請參閱 [Typst 版本](/docs/typst/#typst-versions)。

**Markdown 編譯器**列會安裝或修復受管理的 Pandoc。

## 下載

下載範本和字型套件、將已下載的字型加入專案、檢視已下載的拼字字典，並管理儲存到你範本庫的 AI 範本。**下載來源**分頁會設定下載的來源，以及 `tlmgr` 安裝 TeX 套件所用的套件庫。請參閱[下載](/docs/settings/downloads/)。

## 整合

每個分頁都會顯示該服務自己的標誌。

| 分頁 | 它連接的對象 |
|---|---|
| **GitHub** | 你用於發布、拉取和推送專案的帳號，以及新專案是否取得 Git 儲存庫。 |
| **alphaXiv** | alphaXiv 的 MCP 伺服器，讓助理可以搜尋並閱讀論文。 |
| **Zotero** | 你的 Zotero 文獻庫，可在寫作時從中引用，或匯入專案的參考文獻。 |
| **引用搜尋** | 學術搜尋服務的金鑰與聯絡電子郵件。 |
| **Oleafly MCP** | Oleafly 的本機伺服器，供外部助理處理你的專案。 |
| **桌面應用程式** | Cua Driver，讓代理程式可以使用你允許的桌面程式和網站。 |

[連接研究來源](/docs/integrations/research-sources/)說明了 alphaXiv、Zotero 和引用搜尋。外部 MCP 工具在 **AI 助理 → MCP** 下連接。外部助理透過**整合 → Oleafly MCP** 連接到 Oleafly。[MCP 指南](/docs/mcp/)涵蓋這兩個方向。

## 鍵盤快捷鍵

搜尋快捷鍵清單，並為支援自訂的應用程式動作記錄替代按鍵。編輯器的按鍵組合會和應用程式指令一併列出。請參閱[鍵盤快捷鍵](/docs/keyboard-shortcuts/)。

## 實驗功能

實驗功能收納仍在測試階段的功能。區段頂端的警告說明，這些功能尚未經過完整測試，可能在未來版本中變更、損壞或移除。每個開關預設都是關閉的：

- **LaTeX 工具**會顯示 Oleafly 工具庫及其斜線指令。[Oleafly 工具指南](/docs/tools/)涵蓋了每一個轉換器、參考文獻產生器、研究工具、檢查器和寫作輔助工具。
- **筆記**會在首頁側邊列新增筆記。筆記是一個 Markdown 檔案，可以包含圖表、圖形和數學公式，你和你的代理程式都能編輯。筆記不會出現在你的專案庫中，而且你可以把每則筆記連結到專案。這個開關也會在**設定 → 外觀**和**設定 → 鍵盤快捷鍵**中新增**筆記**分頁。請參閱[筆記](/docs/notes/)。
- **研究任務**讓代理程式在專案的副本中自行工作，並把它的變更留給你檢視。應用程式把它標示為高度不穩定：執行可能停滯、失敗，或留下需要手動整理的變更，而且全程都會消耗你供應商的額度。開啟它會在設定中新增**研究**區段，關閉它則會停止所有執行中的任務。請參閱[研究任務](/docs/research-tasks/)。

![設定 → 實驗功能，LaTeX 工具、筆記 和 研究任務 已開啟，位於說明這些功能仍在測試階段的警告下方。](https://cdn.oleafly.com/images/screenshots/desktop/docs/settings-experimentation-dark-window-v2.png#view=424,136,1072,928)

跟著使用某個功能的指南操作之前，請先在這裡開啟對應的開關。

## 說明與關於

查看應用程式版本、檢查更新、閱讀更新內容、重新開始導覽、開啟說明文件，或回報問題。**複製資訊**會收集版本和系統詳細資料，供錯誤回報使用。**在論文中引用 Oleafly** 是頁面上的最後一張卡片。

無論開啟哪個區段，設定側邊欄底部都有五個小按鈕：Discord、X、GitHub、說明文件和版本資訊。最後一個會開啟更新內容。

個別指南請閱讀[一般](/docs/settings/general/)、[外觀](/docs/settings/appearance/)、[下載](/docs/settings/downloads/)、[儲存](/docs/settings/storage/)和[說明](/docs/settings/help/)。
