# 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/)。