latex-pdf-compiler

LaTeX PDF 编译器

此技能可让 Claude 创建兼容 Overleaf 的 LaTeX 文档，并使用用户本地安装的 pdflatex 编译为 PDF。

何时使用此技能

当用户：

• 要求“创建 LaTeX [文档] 并编译”
• 请求“用 LaTeX 制作 PDF”
• 表示“编译此 LaTeX”或“编译为 PDF”
• 要求“生成并编译”任何 LaTeX 文档
• 请求更新现有 LaTeX 并重新编译

请启用此技能。

工作流

一步生成并编译

当用户请求创建 LaTeX 文档并进行编译时：

1. 生成兼容 Overleaf 的 LaTeX

   • 使用标准文档类创建简洁、结构良好的 LaTeX
   • 使用常见且广泛可用的宏包
   • 将 LaTeX 源代码放入 language="latex" 的代码制品中

2. 立即编译

   • 使用 compile_latex.py 脚本编译 LaTeX
   • 运行 pdflatex 两次（以处理引用和目录）
   • 将编译后的 PDF 提供给用户

3. 提供两个制品

   • 展示 LaTeX 源代码制品（可编辑）
   • 提供编译后的 PDF

更新并重新编译

当用户请求修改现有 LaTeX 时：

1. 更新 LaTeX 制品，应用所需修改
2. 使用编译脚本自动重新编译
3. 更新 PDF 制品或提供新的下载文件

仅编译

当用户对现有 LaTeX 制品说“编译此内容”时：

1. 从制品中提取 LaTeX
2. 使用脚本编译
3. 提供 PDF

LaTeX 生成指南

标准做法

• 使用标准文档类：article、report、book、letter
• 仅包含在 Overleaf 中可用的常见宏包：
  • amsmath、amssymb - 数学符号
  • graphicx - 图像
  • hyperref - 超链接
  • geometry - 页面布局
  • fancyhdr - 页眉/页脚
  • enumitem - 列表格式
  • xcolor - 颜色
• 使用 UTF-8 编码
• 确保文档结构正确

LaTeX 结构示例

\documentclass[11pt,a4paper]{article}

\usepackage[utf8]{inputenc}
\usepackage{amsmath}
\usepackage{graphicx}
\usepackage{hyperref}
\usepackage[margin=1in]{geometry}

\title{Document Title}
\author{Author Name}
\date{\today}

\begin{document}

\maketitle

\section{Introduction}
Content here...

\end{document}

编译过程

此技能使用 compile_latex.py 脚本，该脚本会：

1. 将 LaTeX 写入临时 .tex 文件
2. 使用以下标志运行 pdflatex 两次：
   • -interaction=nonstopmode（遇到错误时不中止）
   • -output-directory（指定临时目录）
3. 捕获输出和错误
4. 返回：
   • 成功：PDF 文件路径和经过 Base64 编码的 PDF 数据
   • 失败：错误消息和日志摘录

错误处理

如果编译失败：

• 显示 LaTeX 日志中的相关错误消息
• 建议常见修复方法（缺少宏包、语法错误等）
• 提供修改 LaTeX 并重试的选项

输出格式

编译成功后：

• 提供下载链接或经过 Base64 编码的 PDF
• 保留 LaTeX 源代码制品，以便后续编辑
• 如果文件保存在本地，请说明文件位置

要求

• 必须安装 pdflatex（TeX Live、MiKTeX 或 MacTeX）
• pdflatex 应位于系统 PATH 中
• 编译脚本需要 Python 3.x

常见用例

1. 学术论文：使用 \documentclass{article}，搭配 amsmath、章节和参考文献
2. 简历/CV：使用 geometry、enumitem 实现整洁的排版
3. 报告：使用 \documentclass{report}，包含章节、目录和图表
4. 信函：使用 \documentclass{letter} 并采用恰当的格式
5. 数学作业：大量使用 amsmath、align 和 equation 环境
6. 演示文稿：使用 \documentclass{beamer} 制作幻灯片

脚本位置

编译脚本应位于： scripts/compile_latex.py

需要编译时会自动调用此脚本。