Compile LaTex & Typst into PDF with TypeTex

核心用法

Typst & LaTeX Compiler 是一个基于 TypeTex API 的云端文档编译服务，允许用户通过 HTTP 请求将 Typst (.typ) 或 LaTeX (.tex) 源代码转换为 PDF。用户只需发送包含源码的 JSON 请求，即可获取 base64 编码的 PDF 文件，支持单文件、多文件项目以及图像嵌入等复杂场景。

显著优点

1. 零环境依赖：无需本地安装 TeX Live 或 Typst，大幅降低使用门槛
2. 双引擎支持：同时覆盖现代排版语言 Typst 与经典 LaTeX 生态
3. 多文件项目：通过 auxiliary_files 字段支持模块化文档结构
4. 完整功能：支持数学公式、图表、TikZ、参考文献等高级特性
5. 快速集成：RESTful API 设计，易于嵌入任何编程语言或自动化流程

潜在缺点与局限性

• 网络依赖：必须保持在线连接，离线无法使用
• 超时限制：复杂文档可能在 60 秒后超时
• 资源不可控：服务器负载可能影响编译速度与稳定性
• 安全风险：源代码上传至第三方服务器，敏感文档需谨慎
• 定制化受限：无法安装个人宏包或修改编译器配置

适合人群

• 需要快速生成 PDF 报告但不愿配置本地环境的开发者
• 构建文档自动化流水线的 AI Agent 与工具集成者
• 教育场景中学生临时编译作业
• 原型验证阶段的技术写作者

常规风险

• 数据隐私：文档内容传输至第三方服务器
• 服务可用性：免费公共服务无 SLA 保障，可能中断
• 输出质量：复杂排版需求可能因环境差异与本地结果不符

核心用法

TypeTex Compiler 是一款面向 Typst 和 LaTeX 的云端文档编译服务。用户通过 HTTP API 发送源代码，服务端即时返回 PDF 文件（Base64 编码）。支持单文件快速编译与多文件复杂项目，可嵌入图片、自定义模板及参考文献。

Typst 编译：POST /public/compile/typst，发送 .typ 源码与辅助文件，获取 PDF。
LaTeX 编译：POST /public/compile/latex，基于 TeX Live/Tectonic 完整发行版，支持 \input、\include、BibTeX 等标准流程。
多文件支持：通过 auxiliary_files 字段传递依赖（模板、章节、图片），图片需 Base64 编码。

显著优点

1. 零配置即开即用：无需安装 TeX Live、Typst CLI 或配置字体环境，API 调用即可生成 PDF。
2. 双引擎覆盖：同时支持现代排版语言 Typst（编译快、语法简洁）与经典 LaTeX（生态成熟、学术期刊兼容）。
3. 完整功能支持：TikZ/PGFPlots、Hayagriva 文献、自定义 .sty/.cls 文件均可使用。
4. 清晰的错误反馈：Typst 返回结构化错误信息；LaTeX 附带完整编译日志，便于调试。
5. Modal 可信基础设施：托管于 Modal 云平台，HTTPS 加密，服务稳定性有保障。

潜在缺点与局限性

• 外部依赖：必须联网调用 API，无法离线使用；文档内容需传输至第三方服务器。
• T3 来源可信度：未提供 GitHub 仓库或开发者背景信息，社区验证与长期维护存疑。
• 无认证与速率限制：当前版本无需 API Key，高并发场景下资源公平性未明确。
• 60 秒超时限制：复杂文档（大规模 TikZ 绘图、大量参考文献）可能编译失败。
• 数据隐私风险：敏感文档（商业合同、未发表论文）通过外部 API 处理存在泄露隐患。

适合人群

• 学术研究者：快速生成 arXiv 预印本、会议论文，无需维护本地 TeX 环境。
• 开发者与自动化流程：CI/CD 文档构建、报告自动生成、模板渲染服务。
• Typst 尝鲜用户：想体验 Typst 现代语法，但暂不愿安装本地工具链。
• 教育场景：编程教学中的文档生成作业，降低学生环境配置门槛。

常规风险

1. 数据传输风险：文档内容经由 HTTPS 发送至 Modal 平台，虽加密但仍脱离用户控制域。
2. 服务可用性：单点 API 依赖，若服务下线或域名变更，Skill 将失效。
3. 编译输出安全：返回的 PDF 为服务器生成，理论上存在被注入恶意内容的可能（虽无证据）。
4. 依赖版本锁定：Typst 与 Tectonic 版本由服务端决定，可能与本地版本行为差异导致排版不一致。

建议：避免处理含敏感个人身份信息（PII）或商业机密的文档；关注 API 健康状态；关键场景建议本地备份编译方案。