核心用法
latex-compiler 是一个基于容器内 LaTeX 服务（端口 8080）的文档编译工具，封装了完整的 LaTeX 工作流。用户可通过 latex_templates 与 latex_get_template 快速获取 article、article-zh、beamer、ieee 等预设模板，随后使用 latex_compile 调用 pdflatex、xelatex 或 lualatex 引擎生成 PDF。对于中文文档，系统强制要求使用 xelatex 或 lualatex 以确保字体兼容性。编译过程默认执行 2 轮以解析交叉引用，若提供 BibTeX/BibLaTeX 内容则自动调用 biber 处理参考文献。
latex_preview 提供即时反馈，将 PDF 以 base64 编码返回，便于在对话界面中直接查看渲染效果，无需下载文件。输出目录固定为 /home/user/output/reports/，确保文件管理的一致性。
显著优点
- 多引擎支持：覆盖主流 LaTeX 引擎，兼顾性能（
pdflatex）与多语言兼容性（xelatex/lualatex） - 模板开箱即用：内置 IEEE 论文、中文文章、幻灯片等模板，降低入门门槛
- 自动化文献处理：
bibliography参数触发自动biber流程，无需手动干预 - 即时预览：base64 内联渲染省去文件传输步骤，提升迭代效率
- 智能多轮编译：默认 2 轮编译自动解决引用与目录依赖
潜在缺点与局限性
- 超时限制：单次编译 120 秒超时，复杂文档或大量宏包可能触发中断
- 容器隔离：PDF 仅保存在容器内
/home/user/output/reports/，需额外机制导出到外部存储 - 引擎限制：
article-zh等模板对引擎有硬性要求，误选会导致编译失败 - 无实时协作：单用户独占容器环境，不支持多人并发编辑
- 模板数量有限：仅 4 种预设模板，高度定制需求需手动编写 preamble
适合人群
- 学术研究者：快速生成符合 IEEE 等期刊格式的论文 PDF
- 多语言作者：需要中文排版支持的技术文档撰写者
- 教学场景：需要即时验证 LaTeX 代码正确性的师生
- 自动化报告生成：需要将结构化数据转为 PDF 的技术团队
常规风险
- 宏包安全隐患：ead、 ile 等 TeX 原语理论上可访问容器文件系统（虽受容器隔离限制）
- 编译失败泄露信息：LaTeX 错误日志可能暴露文件路径或本地用户名
- base64 传输开销：大体积 PDF 的 base64 编码会显著增加响应体积与延迟
- 资源耗尽：递归宏定义或无限循环可能耗尽 120 秒 CPU 配额