Compile LaTex & Typst into PDF with TypeTex

核心用法

Typst & LaTeX Compiler 是一项云端文档编译服务，通过 REST API 将 Typst (.typ) 或 LaTeX (.tex) 源代码实时转换为 PDF。用户仅需发送 JSON 格式的源码请求，即可接收 base64 编码的 PDF 文件，实现零配置的文档生成工作流。

主要功能点：

• 双引擎支持：原生支持 Typst（现代标记语言）与 LaTeX（传统学术排版）
• 多文件项目：通过 auxiliary_files 字段传递模板、章节、图片等依赖
• 二进制资源嵌入：图片等二进制文件需 base64 编码后传入
• 健康检查端点：提供 /health 接口用于服务状态监控

显著优点

1. 零环境负担：无需安装 TeX Live、Typst CLI 或管理字体依赖，彻底消除本地编译环境的配置痛苦
2. 即时可用：无认证门槛，开箱即用，适合快速原型与自动化流程
3. 现代基础设施：基于 Modal 云部署，具备弹性扩展潜力
4. 多格式兼容：完整支持 TeX Live 发行版（Tectonic 引擎）与 Typst 最新特性，包括 TikZ、BibLaTeX、Hayagriva 文献管理等
5. 结构化错误反馈：LaTeX 编译失败时返回完整日志，便于调试

潜在缺点与局限性

• 无 SLA 保障：明确标注 "无认证" 与 "共享资源"，生产环境高可用性存疑
• 60 秒超时限制：复杂 TikZ 图形或大型 bibliography 可能触发超时
• 网络依赖：完全依赖云端，离线场景无法使用
• 安全风险：API 暴露于公网且无认证，存在被滥用的潜在可能（尽管文档呼吁 "respectful usage"）
• 字体与包限制：自定义字体和罕见 LaTeX 包可能未预装，需联系支持添加
• base64 开销：大体积图片需编码传输，增加请求体大小与延迟

适合人群

• AI Agent / 自动化系统：需要程序化生成 PDF 报告的开发者
• 学术写作者：临时需要编译 LaTeX 而无需配置完整环境的用户
• 技术文档团队：构建文档生成流水线的 DevOps/技术写作人员
• Typst 早期采用者：希望体验现代排版语言但不愿安装 CLI 的用户

常规风险

• 数据隐私：源码与 PDF 流经第三方云服务（Modal + TypeTex），敏感内容需谨慎评估
• 服务持续性：依赖单一服务商（studio-intrinsic--typetex-compile-app.modal.run），无开源替代或自托管选项
• 滥用封禁：共享资源池模式下，高频调用可能导致 IP 限流或服务不可用
• 编译一致性：云端与本地环境可能存在微妙差异（版本、包更新时序）

核心用法

Typst & LaTeX Compiler 是一个轻量级 API 封装工具，允许用户通过 HTTP POST 请求将 Typst（.typ）或 LaTeX（.tex）源代码发送至 Modal 平台的 TypeTex 编译服务，并返回 Base64 编码的 PDF 文件。

主要端点：

• /public/compile/typst — 编译 Typst 文档
• /public/compile/latex — 编译 LaTeX 文档
• /public/compile/health — 健康检查

关键特性：

• 支持多文件项目：通过 auxiliary_files 参数传入模板、章节、图片等依赖
• 二进制文件支持：图片等附件需 Base64 编码后随请求发送
• 错误反馈：Typst 返回简洁错误信息，LaTeX 额外提供完整编译日志
• 无认证门槛：开放 API，适合快速原型与自动化工作流

---

显著优点

1. 零本地配置：无需安装 TeX Live、Typst CLI 或处理复杂依赖，省去数 GB 环境配置
2. 双语言支持：同时覆盖现代排版语言 Typst（语法简洁、编译快）与经典 LaTeX（生态成熟、期刊兼容）
3. 多文件架构：通过 auxiliary_files 实现模块化写作，支持模板复用与大型项目
4. 安全简洁：代码仅使用 Python 标准库 requests 和 base64，无第三方依赖风险

---

潜在缺点与局限性

| 方面 | 说明 |

|------|------|

| **数据外泄** | 文档源代码必须上传至 Modal 第三方服务器，不适合含机密信息的场景 |

| **服务依赖** | 功能完全依赖外部 API，服务中断或 API 变更将导致 Skill 失效 |

| **隐私合规** | 用户数据知情同意与第三方共享披露存在警告项（GDPR 层面需留意） |

| **超时限制** | 复杂文档 60 秒超时，极端复杂项目可能编译失败 |

| **定制受限** | 无法自定义编译器版本或添加私有宏包，依赖服务预装环境 |

---

适合人群

• 学术研究者：快速生成论文草稿、公式排版、参考文献整理
• 开发者/自动化工程师：CI/CD 文档生成、报告自动化、模板化 PDF 产出
• Typst 尝鲜者：想体验新语法但不愿配置本地环境
• 教育场景：学生作业、课程讲义的标准化编译

---

常规风险

1. 内容泄露风险：所有文档内容经 HTTPS 传输至 Modal 平台，虽加密但仍属第三方处理。建议避免上传含密码、API 密钥、个人隐私或商业机密的文档。

2. 服务可用性风险：该 Skill 无本地降级方案，API 故障即完全不可用。关键业务应预设备用编译方案或本地 TeX 环境。

3. 输出验证缺失：返回的 PDF 未经本地校验，若服务被篡改存在返回恶意文件的理论风险（尽管 Modal 平台可信度较高）。

4. 长期维护不确定性：T3 级别个人开发者维护，未来更新频率与项目持续性无保障。