# Oleafly 工具

在同一個工具箱中轉換文件、建立參考文獻、檢查參考文獻清單、計算統計數字，並開始專注的寫作任務。

論文很少剛好是你需要的格式。方程式可能被困在螢幕截圖裡，合作者可能寄來 Word 檔案，參考文獻也可能只有一個 DOI。Oleafly 工具把這些零散的問題，變成你能編輯、檢查並保存的內容。

你可以在開啟專案之前就執行工具。複製結果、存成檔案，或在輸出是支援的寫作格式時建立專案。

:::note[開啟工具箱]
Oleafly 工具目前是測試版功能。開啟**設定 → 實驗功能**，打開 **LaTeX 工具**，然後回到專案庫。這項設定會顯示工具庫及其斜線指令。
:::

## 開啟工具

選擇最快的路徑：

1. 在專案庫中，開啟 **Oleafly 工具**，並依名稱、格式或任務搜尋。
2. 在 macOS 上按 ⌘⇧F，在 Windows 和 Linux 上按 Ctrl+Shift+F。輸入 `/tools` 開啟工具庫，或輸入工具的指令，例如 `/latex-to-word`。
3. 在專案內，如果有對應的編輯器動作就使用它。例如，選取方程式後可以開啟 **LaTeX 轉圖片**。

本指南中的每個工具頁面都會列出它確切的斜線指令。

### 調整雙窗格工具的大小

在桌面尺寸的視窗中，有輸入和結果窗格的工具，兩者之間會有分隔線。拖曳它，就能讓你正在使用的那一側有更多空間。你也可以用鍵盤讓分隔線取得焦點，再使用方向鍵。Oleafly 會為每個工具記住該分割位置。在窄視窗中，窗格會上下堆疊，任何一側都不會被擠成難以閱讀的窄欄。

## 選擇最短的路徑

### 轉換與建立

| 你有 | 你想要 | 開啟 |
| --- | --- | --- |
| 螢幕截圖或照片 | 可編輯的數學式、筆記或表格 | [圖片轉 LaTeX](/docs/tools/image-to-latex/)或[圖片轉 Typst](/docs/tools/image-to-typst/) |
| PDF | 可編輯的原始碼 | [PDF 轉 LaTeX](/docs/tools/pdf-to-latex/)、[PDF 轉 Markdown](/docs/tools/pdf-to-markdown/)或 [PDF 轉 Typst](/docs/tools/pdf-to-typst/) |
| Word 文件 | 連同圖片的可編輯原始碼 | [Word 轉 LaTeX](/docs/tools/word-to-latex/)或 [Word 轉 Typst](/docs/tools/word-to-typst/) |
| LaTeX 原始碼 | Word、HTML、Markdown、Typst 或方程式圖片 | [LaTeX 轉 Word](/docs/tools/latex-to-word/)、[HTML](/docs/tools/latex-to-html/)、[Markdown](/docs/tools/latex-to-markdown/)、[Typst](/docs/tools/latex-to-typst/)或[圖片](/docs/tools/latex-to-image/) |
| Typst 原始碼 | Word、HTML、Markdown 或 LaTeX | [Typst 轉 Word](/docs/tools/typst-to-word/)、[HTML](/docs/tools/typst-to-html/)、[Markdown](/docs/tools/typst-to-markdown/)或 [LaTeX](/docs/tools/typst-to-latex/) |
| Markdown | LaTeX 或 Typst | [Markdown 轉 LaTeX](/docs/tools/markdown-to-latex/)或 [Markdown 轉 Typst](/docs/tools/markdown-to-typst/) |
| HTML 標記 | LaTeX 或 Typst | [HTML 轉 LaTeX](/docs/tools/html-to-latex/)或 [HTML 轉 Typst](/docs/tools/html-to-typst/) |
| 試算表檔案 | 已跳脫的 LaTeX 或 Typst 表格 | [Excel 轉 LaTeX](/docs/tools/excel-to-latex/)或 [Excel 轉 Typst](/docs/tools/excel-to-typst/) |
| 複製的 CSV 或 TSV 列 | 已跳脫的 Typst 表格 | [CSV 轉 Typst](/docs/tools/csv-to-typst/) |
| Mermaid 流程圖 | 可編輯的 TikZ 或 fletcher 程式碼 | [Mermaid 轉 LaTeX](/docs/tools/mermaid-to-latex/)或 [Mermaid 轉 Typst](/docs/tools/mermaid-to-typst/) |
| 文字或圖片中的方程式 | LaTeX 或 Typst 數學式 | [方程式轉 LaTeX](/docs/tools/equation-to-latex/)或[方程式轉 Typst](/docs/tools/equation-to-typst/) |
| arXiv 論文 | 它的原始碼，LaTeX 格式或轉換成 Typst | [arXiv 轉 LaTeX](/docs/tools/arxiv-to-latex/)或 [arXiv 轉 Typst](/docs/tools/arxiv-to-typst/) |

[視覺化 Typst 編輯器](/docs/tools/visual-typst-editor/)、[Typst 編輯器](/docs/tools/typst-editor/)和[表格轉 LaTeX](/docs/tools/table-to-latex/)不需要輸入檔案就能開始新的工作。要繪製圖表而不是轉換圖表，請開啟[圖表編輯器](/docs/figures-diagrams/)。

### 建立參考文獻

手上有識別碼時就用識別碼：[DOI](/docs/tools/doi-to-bibtex/)、[ISBN](/docs/tools/isbn-to-bibtex/)、[PubMed ID](/docs/tools/pubmed-to-bibtex/)、[arXiv ID](/docs/tools/arxiv-citation-generator/)，或[網址](/docs/tools/url-to-bibtex/)。單一來源請使用[引用產生器](/docs/tools/citation-generator/)，清單請使用[參考文獻產生器](/docs/tools/bibliography-generator/)，需要比較格式規則時則使用[依格式產生引用](/docs/tools/citation-styles/)。

### 研究、檢查與寫作

- [尋找引用](/docs/tools/find-citations/)會搜尋學術索引，也能掃描草稿，找出需要佐證的論述。
- [BibTeX 驗證工具](/docs/tools/bibtex-validator/)會在不完整的條目和重複的金鑰破壞參考文獻之前，先把它們抓出來。
- [實驗室搜尋](/docs/tools/lab-search/)和[研討會截止日期](/docs/tools/conference-deadlines/)幫助你探索可以工作的地方和值得關注的研討會。
- [統計計算器](/docs/tools/statistics-calculators/)在你的裝置上計算常見的 p 值、樣本數和信賴區間。
- [寫作產生器](/docs/tools/writing-generators/)會根據你選擇的文件或選取範圍，準備有依據的提示詞。
- [符號參考](/docs/tools/symbol-reference/)會找出 LaTeX 指令，並插入到游標處。

## 什麼在哪裡執行

| 工作類型 | 會發生什麼 |
| --- | --- |
| 文件、表格和圖表轉換 | 以 Oleafly 內建的轉換器在本機執行。以 Pandoc 為基礎的路徑不會上傳原始碼。 |
| 圖片、掃描的 PDF，以及用文字描述的方程式 | 使用工具所用的模型：預設是本機的 Ollama 模型，也可以是你已設定的其他供應商的模型，或用於圖片和 PDF 的 Mathpix。選擇託管的模型會把檔案送到那個服務。圖片和掃描檔需要視覺模型。 |
| 識別碼、論文和機構查詢 | 連到相關的公開目錄，需要網路連線。這包括在 arXiv 轉 LaTeX 或 arXiv 轉 Typst 中查詢 arXiv ID。 |
| 寫作產生器 | 把審閱過的提示詞傳送給你設定的助理供應商。 |
| 手動編輯參考文獻、引用格式化、驗證和統計 | 留在你的裝置上。 |

工具標籤會告訴你何時需要連線或模型。請在**設定 → AI 助理 → 工具**中選擇工具所用的模型。[Ollama 設定](/docs/ollama/)說明本機模型，[模型供應商](/docs/ai-setup/)說明助理連線。

## 轉換只是初稿

Oleafly 會保留有用的結構，但各種格式沒有共通的詞彙。Word 樣式不是 LaTeX 巨集，PDF 儲存的是頁面位置而不是作者的意圖，Typst 函式也可能沒有對應的 LaTeX 寫法。

任何轉換之後：

1. 閱讀產生的原始碼，不要把它當成完成的稿件。
2. 編譯或預覽結果。
3. 檢查方程式、參考文獻、表格、圖片和自訂格式。
4. 在轉換後的版本通過審查之前，保留原始檔案。

:::caution[實際限制]
一般的檔案轉換接受最大 128 MB 的檔案。圖片轉錄接受小於 20 MB 的 PNG、JPEG 或 WebP 檔案。掃描 PDF 的轉錄限制為 50 頁。試算表匯入使用第一個工作表，最多接受 10,000 列、100 欄和 2 MB 的儲存格文字。各個指南說明了對每條路徑重要的限制。
:::

專案**匯入**和**匯出**選單可用的路徑，請參閱完整的[匯入指南](/docs/import-project/)和[匯出指南](/docs/export/)。