核心功能与用法
latex-compiler 将完整的 LaTeX 容器化编译能力封装为对话式工具,用户无需配置本地 TeX Live 环境即可获得出版级 PDF 输出。核心流程围绕四个工具展开:
1. 模板选择 — latex_templates 列出可用模板(article、article-zh、beamer、ieee),latex_get_template 一键获取预置源码,降低排版门槛
2. 文档编写 — 直接注入 LaTeX 源码,支持复杂数学公式、图表、交叉引用
3. 智能编译 — latex_compile 默认执行 2 轮编译自动解决引用与目录,检测到 bibliography 参数时自动插入 biber 处理参考文献
4. 即时预览 — latex_preview 返回 base64 编码 PDF,实现对话内嵌查看,无需下载
引擎选择策略:西文文档默认 pdflatex,中文文档(article-zh)必须切换至 xelatex 或 lualatex 以支持 CJK 字体。
显著优点
- 零配置即用:容器已预装完整 TeX Live 发行版,避免本地数 GB 安装包
- 多引擎灵活切换:pdflatex(速度优先)、xelatex/lualatex(现代字体与 Unicode 支持)覆盖全场景
- 智能多轮编译:自动处理交叉引用、目录、参考文献,无需手动执行多次
- 中文原生支持:article-zh 模板开箱即用,解决中文学术写作痛点
- 安全沙箱:编译在隔离容器内执行,120 秒超时防止恶意代码挂起
潜在局限
- 无持久化文件系统:PDF 仅存于容器
/home/user/output/reports/,会话结束即清除,需及时下载 - 模板覆盖有限:目前仅 4 套预设模板,复杂自定义文档仍需手动编写 preamble
- 编译超时 120 秒:超大文档或复杂 TikZ 绘图可能触发中断
- 无包管理器接口:无法动态安装缺失宏包,依赖容器预装清单
适合人群
- 学术研究者:快速生成符合 IEEE 等会议模板的投稿论文
- 理工科学生:撰写含复杂数学公式的学位论文与报告
- 多语言作者:需要 xelatex 处理中文、日文等非拉丁字符集
- 演示文稿制作者:beamer 模板快速构建学术幻灯片
常规风险
- 注入风险:
content与bibliography参数直接传入 LaTeX 编译器,恶意代码可通过\write18、shell escape 或读取敏感文件实现 RCE。尽管容器隔离降低了主机渗透风险,但仍可能消耗计算资源或泄露容器内文件 - DoS 风险:超大图片、无限循环的 TikZ 代码或递归宏定义可耗尽 120 秒配额,导致服务拒绝
- 数据丢失:未主动保存的 PDF 随会话终止消失,重要文档需即时导出