Folio Writer
Folio Helper
一款免费的小型配套应用，让 Mac App Store 版的 Folio Writer 能够使用你 Mac 上已安装的工具进行编译——也就是 Apple 沙盒不允许应用自行启动的那些工具。
版本 1.7 · 免费 · 已通过 Apple 公证 · macOS 14 或更高版本。只有 Mac App Store 版才需要它，而且只在使用你自己安装的工具时才需要。
1.7 新功能——Helper 现在也能运行 OpenAI 的 Codex 命令行（codex），因此 Folio Writer 1.18 将推出的助手服务本机 ChatGPT（Codex）在 App Store 版中同样可用。无论 codex 是用 npm、Homebrew 还是 Volta 安装的，它都能找到。如果开启了自动更新，你无需任何操作即可获得。
已经装了 Folio Helper？从 Folio Writer 1.8.6 和 Folio Helper 1.6.3 开始，更新是自动的：应用大约每天检查一次新版本，验证下载文件的代码签名，正在运行的 Helper 会在后台悄悄替换自身——没有对话框，无需点击，无需批准。更希望先征求你的意见？在设置 ▸ 编译中关闭它即可；手动更新按钮位于编译 ▸ 设置外部工具…中。
还在用 Folio Writer 1.8.4 或更早版本？这些版本需搭配 Folio Helper 1.5（也以不带版本号的 FolioHelper.zip 提供，即这些版本中的链接所指向的文件）。
手动更新同样可行：退出 Folio Writer——Folio Helper 会随之关闭——用新版本替换“应用程序”中的 Folio Helper.app，然后重新打开 Folio Writer。
它的用途
App Store 版运行在 Apple 的沙盒中，沙盒禁止启动外部程序——包括你用 Homebrew、MacTeX 或 TinyTeX 安装的排版工具。Folio Helper 是一个运行在沙盒之外的小小代理程序，代表 Folio Writer 运行这些工具：pandoc、pandoc-crossref、typst、xelatex / pdflatex / lualatex / latexmk、tectonic、quarto，以及 claude 和 codex 命令行。装好它之后，通过你自己的 LaTeX 编译 PDF、用 Quarto 渲染 .qmd 项目，以及写作助手的 Claude CLI 模式（自 Folio Writer 1.18 起还有通过 Codex 使用的 ChatGPT），在 App Store 版中都能正常使用。
还没有这些工具？在“终端”中用一条命令即可安装 pandoc、pandoc-crossref、Quarto、Typst 和一个 LaTeX 引擎（它会显示一个菜单，供你挑选需要的工具）：
curl -fsSL https://foliowriter.app/install-folio-tools.sh | bash
如何安装
简单方法（Folio Writer 1.8.5 或更高版本）：打开编译 ▸ 设置外部工具…，点击安装 Folio Helper。Folio Writer 会下载它、验证签名，并把它放进“应用程序”——你只需批准一次“应用程序”文件夹的访问，确认 macOS 的一次公证提示，这就是 Helper 唯一需要你操作的地方：从此它会自动保持最新。
手动安装：
- 下载上方的 zip 文件并解压（Safari 可能已经替你解压好了）。
- 把 Folio Helper.app 拖进你的应用程序文件夹。
- 打开它一次。它没有窗口——它会把自己注册为后台辅助程序，并以“Folio Helper”的名称出现在 系统设置 ▸ 通用 ▸ 登录项 中。
- 在 Folio Writer 中打开编译 ▸ 设置外部工具…，然后点击重新检查。Helper 卡片会列出它找到的每个工具及其路径和版本。
它做什么——以及不做什么
- 只运行上面那份固定的工具清单——无法让它运行任何其他程序。
- 只在 Folio Writer 请求时运行这些工具；会通过代码签名验证连接确实来自 Folio Writer。
- 没有窗口，没有菜单栏项目，自身没有任何网络访问，不收集任何信息。它会在常见位置（Homebrew、MacTeX、TinyTeX、npm、Volta、
/usr/local）以及通过你登录 shell 的PATH查找工具。
卸载
先退出它（系统设置 ▸ 登录项 ▸ 关闭“Folio Helper”），然后从“应用程序”中删除 Folio Helper.app。Folio Writer 照常可用；编译只是退回到沙盒所允许的范围。