利用 TeXbrain 浏览器本地同步绕开 Overleaf 付费墙

在撰写学术论文时，Overleaf 将 Git 同步功能设为付费选项，导致云端编辑与本地版本控制无法同步。通过部署 TeXbrain 可以解决这一问题。该方案将编译引擎通过 WebAssembly 迁移至浏览器端，通过实现离线编译与本地文件读写，让用户无需支付订阅费。

这种本地化运行的逻辑在于，它并非依靠远程服务器，而是基于 SwiftLaTeX 把 pdfTeX 编译成了 WASM 模块。由于编译进程直接在浏览器沙箱内执行，因此不依赖后端服务器。其核心在于调用了 File System Access API，赋予浏览器直接读写本地磁盘文件夹的权限。这种机制消除了云端与本地版本不一致的痛点，用户可以利用 VS Code 编辑并使用 Git 提交代码，同时在浏览器端实时生成 PDF。

这一方案采用 MIT 协议，用户既能直接访问网页，也可以通过执行 git clone https://github.com/swimmingbrain/texbrain 克隆源码进行私有化部署。具体运行步骤为：进入网页后，授权访问本地项目文件夹，编写 .tex 文件，最后触发 WASM 编译引擎生成 PDF。

针对浏览器运行 LaTeX 时常出现的 LaTeX Error: File 'xxxx.sty' not found 报错，TeXbrain 采取了镜像补全机制。它会优先检索浏览器缓存，若未找到所需宏包，则通过 jsDelivr 镜像拉取 TeX Live 的包。由于传输的是文件名而非文档内容，数据安全性较高。不过用户需要留意，其宏包版本基本锁定在 TeX Live 2020，若使用了 2023 或 2024 版本的最新特性，可能会触发兼容性报错。

在实际迁移过程中，该方案存在三个局限性。第一是引擎单一，目前只支持 pdfTeX。如果项目依赖 fontspec 宏包或需要调用本地非标准字体，由于 XeTeX 和 LuaTeX 无法运行，会导致字体渲染失败。第二是参考文献处理存在断层，当前版本没集成 bibtex 或 biber，无法在浏览器内直接编译 .bib 文件，此时必须通过本地命令行预处理或手动维护 .bbl 文件。第三是环境依赖，虽然支持离线工作，但在首次加载必要宏包和 WASM 模块时必须联网。

从行业背景看，Overleaf 与 ShareLaTeX 在 2017 年合并，旨在通过整合两家公司的资源，避免在追求相同目标时重复投入，从而服务于全球数千家机构和企业的两百万多名作者。

对于在实验室管控电脑或 Chromebook 等无法安装 4GB+ 完整 TeX Live 环境的场景，或者对隐私要求极高、不愿将文档上传至第三方服务器的用户，这是一个高效的替代方案。通过“本地文件系统直连 + WASM 编译”，用户可以构建一套无需订阅且支持 Git 版本管理的本地化 LaTeX 工作流。