Folio Writer
Folio Helper
一款免費的小型輔助 App，讓 Mac App Store 版的 Folio Writer 能使用你 Mac 上已安裝的工具進行編譯——也就是 Apple 的沙盒不允許 App 自行啟動的那些工具。
版本 1.6.4 · 免費 · 已通過 Apple 公證 · macOS 13 或更新版本。只有 Mac App Store 版才需要它，而且只在你要使用自己安裝的工具時才需要。
1.6.4 新功能——更快、更穩定的輔助程式：它會一次查找你所有的工具並記住找到的位置，因此工具面板一兩秒內就會填滿，不再偶爾在冷啟動時回報「沒有工具」；編譯 ▸ 停止現在會停止渲染器啟動的所有程序（latexmk 的 xelatex、Quarto 的 pandoc 與 Jupyter），而不只是最上層的程序；而提早結束的工具也不會再在編譯途中把輔助程式一起拖垮。如果你開啟了自動更新，你已經擁有這個版本。
已經有 Folio Helper 了？從 Folio Writer 1.8.6 與 Folio Helper 1.6.3 起，更新是自動的：App 大約每天檢查一次新版本，驗證下載檔的程式碼簽章，然後執行中的輔助程式會在背景悄悄替換自己——沒有對話框、不用點擊、也不需要任何核准。想先被詢問？可在設定 ▸ 編譯中關閉；手動更新按鈕則位於編譯 ▸ 設定外部工具…。
還在使用 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 命令列。安裝它之後，透過你自己的 LaTeX 編譯成 PDF、用 Quarto 渲染 .qmd 專案，以及寫作助手的 Claude CLI 模式，在 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 的一次公證提示，這就是輔助程式所需要的最後一次互動：此後它會自動保持最新。
手動安裝：
- 下載上方的 zip 檔並解壓縮（Safari 可能已經替你完成）。
- 把 Folio Helper.app 拖進你的應用程式資料夾。
- 開啟它一次。它沒有視窗——它會把自己註冊為背景輔助程式，並以「Folio Helper」出現在 系統設定 ▸ 一般 ▸ 登入項目 中。
- 在 Folio Writer 中開啟編譯 ▸ 設定外部工具…並按下重新檢查。輔助程式卡片會列出它找到的每個工具，以及其路徑與版本。
它會做什麼——以及不會做什麼
- 只執行上方那份固定的工具清單——無法要求它執行任何其他東西。
- 只在 Folio Writer 要求時才執行它們；連線會透過程式碼簽章驗證確實來自 Folio Writer。
- 沒有視窗、沒有選單列項目、自己不存取網路、不蒐集任何資料。它會在常見位置（Homebrew、MacTeX、TinyTeX、
/usr/local）以及透過你登入 shell 的PATH尋找工具。
解除安裝
結束它（系統設定 ▸ 登入項目 ▸ 關閉「Folio Helper」），然後從「應用程式」中刪除 Folio Helper.app。Folio Writer 會繼續運作；編譯只是退回到沙盒所允許的範圍。