TeX64 是 macOS 的桌面 LaTeX 编辑器。您在自己的计算机上打开一个文件夹，编辑 .tex 文件，一键构建，然后在集成的 PDF 查看器中读取结果 - 一个完全本地的编辑循环，通过视觉数学输入、图像到 LaTeX OCR 和 LaTeX-specialized AI (Axiom) 进行增强。此页面是一个简单的工具指南条目：每个功能的实际用途以及用途。
TeX64 是什么
TeX64 是本地优先：除了 AI 功能之外，它完全离线运行，并且您的源和 PDF 都保留在您自己的计算机上。目前，它仅适用于 macOS（macOS 12 Monterey 或更高版本），对 Apple Silicon (M1/M2/M3/M4) 和 Intel Mac 提供本机支持。 Windows 和 Linux 构建已计划但尚未可用 - 在签名和安装程序策略最终确定时分发已暂停。
使用它的形状很简单。打开工作区（文件夹），您将获得一个具有文件树、选项卡编辑和拆分视图的编辑器。您的主 .tex 文件是自动检测的，按 Cmd+B 会构建它，并在集成查看器中显示 PDF。编辑要素全部存在：从章节、部分、图形、标签、引文和 TODO 自动生成的大纲，以及跨整个工作区的全文搜索（由 ripgrep 提供支持）。
请注意，TeX64 本身并不是排版引擎。编译运行您通过 latexmk 单独安装的 TeX 发行版（见下文）。换句话说，TeX64 是将编辑、构建和预览联系在一起的前端，而排版本身是由标准 TeX 工具链完成的。
安装
安装应用程序本身是通常的 macOS 例程。从下载页面 (/download) 中，获取与您的计算机（Apple Silicon 或 Intel）匹配的 DMG，打开它，然后将 TeX64.app 拖到您的应用程序文件夹中。它大约需要 150 MB 的磁盘空间。
首次启动时，macOS Gatekeeper 可能会显示警告；如果是这样，按住 Control 键并单击该应用程序，然后选择“打开” 启动它。如果您不确定您的 Mac 是 Apple Silicon 还是 Intel，请在终端中运行 uname -p（arm 表示 Apple Silicon，i386 表示 Intel）。 DMG 经过签名和公证，并且每个工件都会发布校验和。
TeX环境设置
如前所述，在 TeX64 中构建需要单独安装 TeX 发行版。建议是 MacTeX （完整的 TeX Live 加上 GUI 工具，~4 GB）。为了保持精简，您可以安装 BasicTeX (~100 MB) 并随着时间的推移使用 sudo tlmgr install 添加缺少的软件包。
TeX64 特别需要的工具是 lualatex（默认引擎）、latexmk（驱动构建）、latexindent（用于格式化）和 synctex（用于 SyncTeX）。您可以在应用程序中的 Settings > 环境 下检查是否找到它们：绿色勾号 (✓) 表示找到，红色表示丢失。如果缺少某些内容，请安装 MacTeX 或使用 tlmgr 添加单独的软件包。
对于根本不存在TeX环境的情况，TeX64还可以为您安装一个托管的TeX Live（0.1.12版本中添加）：当缺少所需工具时，应用程序可以在自己的管理下设置一个TeX Live环境。
- 推荐：MacTeX（完整 TeX Live + GUI，~4 GB）
- 精益：BasicTeX (~100 MB) 加上
tlmgr其余部分 - 验证：绿色检查 Settings > 环境下的
lualatex/latexmk/latexindent/synctex
实用的首次写入循环
如果安装TeX64后直接跳到大型论文模板，则很难判断故障是来自编辑器还是来自TeX环境。从一个小手稿开始并证明循环：打开、构建、检查 PDF、返回源代码、修改。然后逐渐发展到章节、图表和参考文献。
- 打开工作区：选择一个稿件文件夹并确定哪个文件（例如
main.tex）作为入口点。 - 检查根文件：如果自动检测选择了错误的文件，请从菜单中明确设置。
- 构建一个简短的文档一次：在添加章节或图形之前，验证是否找到了 TeX 工具并且出现了 PDF。
- 小步成长：一次添加一个部分、方程、图表或引文，并随时阅读构建日志。
- 在已知工作的手稿上使用 Axiom 和 OCR：生成的代码应该通过 diff 和编译的 PDF 进行检查。
稿件文件夹的形状如何制作
TeX64 将文件夹视为工作空间，因此第一个文件夹布局成为写入稳定性的一部分。简短的报告可以存在于单个 main.tex 中；对于论文或技术手册，从一开始就将正文文件、图形和参考书目分开，使得搜索、大纲导航、AI 请求和 SyncTeX 跳转更容易推理。
thesis/
main.tex
chapters/
intro.tex
methods.tex
figures/
setup.pdf
refs.bib- 将
\documentclass、包和\begin{document}保留在main.tex中；包括带有\input{chapters/intro}等行的章节。 - 首选带有连字符或下划线的 ASCII 图形文件名；避免路径中出现空格和日语名称。
- 首先确认
Cmd+B生成 PDF，然后一次添加章节、图形和参考书目。 - 在要求 Axiom 进行大规模编辑之前，请将项目保持在编译状态。查看 AI 与最后一个好的 PDF 的差异。
数学输入（块）
块（可视化数学编辑器）是无需记住 LaTeX 符号即可构建方程的功能。它在底层使用MathLive，一个交互式方程生成器：您**从希腊字母、运算符、关系、箭头、集合符号、分数和根等结构以及重音符号的调色板中进行选择来组装公式。当您键入时，您会实时看到渲染结果，完成后，相应的 LaTeX 代码会自动插入回源中。
有三种方法：将光标置于数学环境中并右键单击>“在块中编辑”，使用菜单数学>块Editor，或按Cmd+Shift+E。 TeX64 自动检测数学环境并为其启动模块。涵盖的环境包括显示的环境 - equation、align、gather、multline、split、cases - matrix 系列，以及编写为 $...$ 或 \(...\) 的内联数学。
数学 OCR（图像→公式）
OCR 将图像中的数学转换为 LaTeX 代码。它适用于屏幕截图、手写笔记、PDF 中的公式以及教科书或论文中的方程照片 — 手写和打印都一样。 要使用它，请从菜单中选择 数学 > OCR，裁剪屏幕的任何区域，AI 分析图像，生成 LaTeX，并将结果直接插入编辑器中。
由于转换在云 AI 上运行，因此它需要 互联网连接 和 支持 AI 的计划（文档将其描述为 TeX64 Basic 或更高版本上的 AI 功能）。由于它会捕获屏幕的某个区域，因此您可能需要在 macOS 屏幕录制 权限下启用 TeX64（系统 Settings > 隐私和安全 > 屏幕录制）。为了获得更高的准确性：使用高对比度图像（浅色背景上的深色文本），裁剪为仅方程式，尽可能整齐地书写手写体，并拆分复杂的公式。在依赖输出之前，请务必检查并更正输出。
根据经验：从头开始创建新公式或不熟悉 LaTeX 表示法时，请使用 Blocks， 并在数字化现有手写或 PDF 方程时使用 OCR。
AI 写作（公理）
Axiom 是内置于 TeX64 中的 LaTeX-specialized AI 代理。它了解整个项目的上下文，并且不仅仅是聊天 - 它在工作时直接读取和写入文件。有两个入口点：AI 聊天，您可以用自然语言交谈（“为什么会发生此错误？”、“使本节更简洁”），以及内联完成，它建议编辑器中的下一行、方程或段落。补全还可以将诸如“x 的平方从 0 到 1 的积分”之类的自然语言变成像 \int_0^1 x^2 dx 这样的方程。
作为代理，Axiom 读取您的项目文件（.tex、.bib、.sty、.cls 等）和文件树，并建议将编辑作为差异。重要的是，这些差异始终仅在您审核并批准后应用。它还可以编译项目并读取构建日志，并搜索 arXiv 以获取 BibTeX条目。另一方面，它无法访问工作空间之外的文件，也无法运行任意系统命令（其工具受到限制）； API 密钥和令牌会自动编辑。
有两种型号：标准 Axiom 型号适用于每个计划，功能最强大的 Axiom Pro 仅限 Pro。关于隐私：您的纸质数据永远不会用于 AI 训练，仅当您明确使用 AI 功能时才会发送数据，它通过 OpenAI API 在服务器端进行处理，并且在处理后被删除，而不是长期存储。这些计划有免费、基本和 Pro；即使是免费也包含每月大约 200,000 个代币的 AI 津贴，更高的级别会添加更多功能的模型和更大的配额（有关确切数字，请参阅定价页面）。始终验证输出 - Axiom 很强大，但对于复杂的代码或语义可能是错误的。
SyncTeX（正向/反向搜索）
SyncTeX 在两个方向上链接源和 PDF 中的匹配位置，并且它内置于 TeX64 PDF 查看器中。通过向前搜索（源→ PDF），与光标相对应的 PDF 区域会突出显示，查看器会自动滚动到那里。通过反向搜索（PDF → 源代码）， Cmd - 单击 PDF 会直接跳转到相应的源代码行并突出显示它（对于多行块，例如段落或 figure，它会跳转到块的开头）。
为此，synctex 必须可用，并且构建必须生成 .synctex.gz 文件。 TeX64 的构建默认启用 .synctex.gz 生成，因此通常无需额外设置即可运行。它也适用于 多文件项目： 单击使用 \input 或 \include 拆分的文件中的元素，正确的外部文件会自动打开并跳转到正确的行。假设根文件（包含 \begin{document} 的主文件）设置正确 - TeX64 尝试自动检测它，并且您可以在需要时通过菜单的“设置根文件”显式设置它。
跳转精度取决于 TeX64 可以从 SyncTeX 文件中读取的信息的粒度。通常，您会以段落级精度到达正确的行，但某些软件包（例如 tikz 或 pgfplots）以及大量宏的使用可能会使映射复杂化并产生更粗糙（例如页面级）的精度。