核心用法
latex-compiler 提供一站式 LaTeX 到 PDF 的容器化编译方案，通过本地 8080 端口服务封装 TeX Live 工具链。核心工作流为：选择模板（latex_templates/latex_get_template）→ 编辑源码 → 编译生成（latex_compile 或 latex_preview）→ 获取 PDF 输出。支持 pdflatex、xelatex、lualatex 三种引擎，其中 xelatex 与 lualatex 专为中文文档（article-zh 模板）优化。编译默认执行双遍以解析交叉引用，若提供 BibTeX/BibLaTeX 内容则自动调用 biber 处理参考文献。
显著优点
- 多引擎支持：覆盖 Western 与 CJK 文档场景，无需用户手动配置字体与编码；
- 模板即开即用：内置 article、article-zh、beamer、IEEE 等学术常用模板，降低入门门槛；
- 自动化流程：多遍编译与参考文献处理对用户透明，120 秒超时机制防止资源滥用；
- 容器隔离：编译环境封闭，避免本地 TeX 发行版污染或版本冲突。
潜在缺点与局限性
- 封闭文件系统：PDF 仅保存于容器内
/home/user/output/reports/，需额外步骤导出到持久化存储； - 功能边界受限：不支持 CTAN 宏包实时安装，若模板依赖缺失宏包将导致编译失败；
- 预览限制：
latex_preview返回 base64 编码，大文件可能造成传输与渲染延迟； - 中文支持引擎依赖：必须使用 xelatex 或 lualatex，pdflatex 对 CJK 支持有限。
适合人群
- 需要快速生成学术 PDF 的科研写作者；
- 不愿维护本地 TeX 环境、追求「零配置」编译的用户；
- 需要 IEEE/Beamer 等标准模板的投稿人与汇报者。
常规风险
- 宏包兼容性风险：若用户源码依赖未预装的 CTAN 宏包，编译将报错；建议在模板基础上修改，而非直接迁移复杂旧文档；
- 中文编码与字体风险：xelatex 依赖系统字体，若容器内缺失指定中文字体，中文文档将编译失败；
- 超时与资源占用：复杂图表或大量参考文献可能触及 120 秒限制；
- 输出持久化：容器重启后 PDF 丢失，需及时通过外部接口转存。