技能使用指南

compile-latex（编译LaTeX幻灯片）Skill 是什么？如何下载使用？

compile-latex 技能一键完成 Beamer 幻灯片三遍编译与 bibtex 引用解析，自动设置 TEXINPUTS 与 BIBINPUTS，检查 overfull hbox、未定义引用并汇报 PDF 页数，帮讲师与科研人员告别问号引用与错误页码，提升 LaTeX 讲稿编译效率。

编译LaTeX幻灯片Skillcompile-latex
8 个章节 约 13 分钟阅读 AI 智能生成

编译LaTeX幻灯片Skill：一条指令完成 Beamer 幻灯片三遍编译与引用解析

  • 一句话定位：把 Beamer 幻灯片繁琐的「xelatex → bibtex → xelatex → xelatex」多遍编译流程封装成一次调用，自动处理参考文献与交叉引用。
  • 核心能力：使用 XeLaTeX 编译 Beamer 幻灯片，运行满 3 遍 xelatex 加 1 次 bibtex，彻底解析引用、目录与页码。
  • 环境适配：自动设置 TEXINPUTS 指向 Preambles/ 主题目录、BIBINPUTS 指向仓库根目录，解决「主题找不到」「参考文献为空」的高频报错。
  • 质量校验：编译后主动检查 Overfull hbox 警告、未定义引用（undefined citations）与标签变动提示，并汇报 PDF 页数。
  • 适用人群：用 LaTeX 写讲稿、做学术汇报、维护课件仓库的科研人员、讲师与工程师。

该技能叫什么？如何下载安装 AI 技能提升开发效率？

该技能的中文名为编译LaTeX幻灯片Skill，英文名为 compile-latex，技能 ID 为 13627。它的定位非常聚焦：在编写讲稿类幻灯片时，用 XeLaTeX 编译 Beamer LaTeX 幻灯片，并通过 3 遍编译加 bibtex 的完整序列，确保参考文献与交叉引用全部解析到位。

它解决的问题很具体：LaTeX 幻灯片的编译从来不是「按一次按钮」那么简单。第一遍 xelatex 只生成包含引用键的 .aux 文件；bibtex 读取 .aux 生成 .bbl；第二遍 xelatex 才把参考文献真正合并进文档；第三遍 xelatex 才能解析所有交叉引用并得到最终页码。任何一步漏掉，你看到的都可能是满屏的「?」和错误的页码。此外，Beamer 主题通常放在 Preambles/ 目录、.bib 文件放在仓库根目录，手动编译时如果忘记设置 TEXINPUTS 和 BIBINPUTS，就会直接报「找不到主题文件」。

「一键安装 AI 技能」的思路，就是把上述命令序列、环境变量与检查逻辑固化成一个可复用的技能，让 AI 助手在你说「编译讲稿幻灯片」时自动执行正确流程，而不是每次凭记忆敲四条命令。

安装与使用的一般步骤如下（具体命令、入口与版本要求以官方说明为准）：

  1. 确认安装前提：本地已具备可用的 LaTeX 发行版（需包含 xelatex 与 bibtex 命令）；项目仓库中存在 Slides/ 目录、Preambles/ 主题目录，且 .bib 文件位于仓库根目录。
  2. 获取并安装技能：在 AI 技能市场或技能管理入口中搜索技能 ID 13627 或英文名 compile-latex，按官方指引完成添加。
  3. 确认权限范围：该技能声明的可用工具为 Read、Bash、Glob，即读取文件、执行命令与查找文件，安装时按提示授予对应能力。
  4. 验证是否生效：在对话中提到「编译讲稿幻灯片」，或按技能约定传入参数（不带 .tex 扩展名的文件名，例如 lecture01），观察是否触发编译流程并输出结果报告。若未触发，请核对技能是否已启用，具体以官方说明为准。

该技能的主要功能和特点

  • 固定三遍编译序列：严格执行 xelatex → bibtex → xelatex → xelatex，保证参考文献、交叉引用、页码与目录一次性全部正确，避免「引用显示为问号」的返工。
  • 强制使用 XeLaTeX：明确要求始终使用 XeLaTeX，而非 pdflatex，这对中文排版与字体支持尤其关键。
  • 自动注入环境变量：编译时设置 TEXINPUTS=../Preambles:$TEXINPUTS 与 BIBINPUTS=..:$BIBINPUTS，让 Beamer 主题与参考文献文件「自动被找到」，无需手动配置。
  • 参数化调用：只需提供不带 .tex 扩展名的文件名，技能会自行补全并进入 Slides/ 目录执行，减少手误。
  • 提供 latexmk 替代方案：除手动三遍序列外，也支持用 latexmk -xelatex 一条命令完成同样的依赖解析，适合习惯自动化工具的团队。
  • 编译后质量检查：用 grep 检索输出中的 Overfull \hbox 警告、undefined citations、Label(s) may have changed，主动发现排版溢出与引用异常。
  • 可视化验证闭环：编译完成后打开生成的 PDF 供人工目视检查，最后汇报编译成功与否、overfull hbox 警告数量、未定义引用情况以及 PDF 页数。

相比「自己记命令、自己拼参数」的普通做法，它的优势不在算法，而在流程确定性：把易错的隐式知识（顺序、次数、环境变量、检查项）变成显式执行。

如何使用该技能？

以下是基于技能说明的分步骤使用指南：

步骤 1：准备目录结构。 确保仓库根目录下有 Slides/（存放 .tex 源文件）、Preambles/（存放 Beamer 主题）、以及根目录的 .bib 参考文献文件。这是技能能正确设置 TEXINPUTS 与 BIBINPUTS 的前提。

步骤 2：按约定传入参数。 技能的参数提示为 [不带 .tex 扩展名的文件名]。例如你的文件是 Slides/lecture01.tex，那么 $ARGUMENTS 取值为 lecture01。

步骤 3：触发编译。 你可以直接说「编译讲稿幻灯片 lecture01」，技能会进入 Slides/ 目录并执行三遍序列：

cd Slides
TEXINPUTS=../Preambles:$TEXINPUTS xelatex -interaction=nonstopmode lecture01.tex
BIBINPUTS=..:$BIBINPUTS bibtex lecture01
TEXINPUTS=../Preambles:$TEXINPUTS xelatex -interaction=nonstopmode lecture01.tex
TEXINPUTS=../Preambles:$TEXINPUTS xelatex -interaction=nonstopmode lecture01.tex

若偏好一体化工具，也可以改用：

cd Slides
TEXINPUTS=../Preambles:$TEXINPUTS BIBINPUTS=..:$BIBINPUTS latexmk -xelatex -interaction=nonstopmode lecture01.tex

步骤 4：查看警告检查结果。 技能会检索编译日志中的 Overfull \hbox（内容超出页边距）、undefined citations（未定义引用）、Label(s) may have changed（标签变动，提示可能需要再编译一次），并报告发现的任何问题。

步骤 5：打开 PDF 目视确认。 技能会执行 open Slides/lecture01.pdf 打开成品，你可以检查版式、公式与文献列表。

步骤 6：阅读结果报告。 最终报告包含四项信息：编译成功或失败、overfull hbox 警告数量、未定义的引用、PDF 页数。若出现未定义引用，通常应回头检查 .bib 文件与 \cite 键是否拼写一致，然后重新编译。

同类型竞品对比分析

方案名称 定位 核心功能 安装/使用门槛 适用场景 优势与不足
编译LaTeX幻灯片Skill（compile-latex） 面向 AI 助手的 Beamer 编译技能 三遍 xelatex + bibtex、自动设置 TEXINPUTS/BIBINPUTS、警告检查、结果汇报 需已装 LaTeX 发行版；通过技能市场添加，以官方说明为准 讲稿类 Beamer 幻灯片、含参考文献的学术汇报 优势：流程固定、零记忆成本、自带检查清单；不足：依赖既定目录结构，超出约定的项目需调整
手动命令行编译 传统 LaTeX 使用方式 自己敲 xelatex/bibtex 多遍命令 需熟练记住顺序与环境变量 个人熟手、临时小改动 优势：完全自由；不足：易漏遍数、易忘环境变量，报错排查耗时
latexmk 自动化工具 LaTeX 生态中的通用构建工具 自动判断需编译遍数并调用引擎 需额外安装与配置，命令相对简单 常规论文与幻灯片构建 优势：通用性强、自动收敛；不足：不理解项目约定的目录与检查项，警告需自行判读
IDE 编辑器内置编译按钮 编辑器集成的构建功能 一键调用配置好的编译链 需在编辑器中配置编译方案 平时在固定 IDE 中写作的用户 优势：图形化、门槛低；不足：配置跨项目复用性差，AI 对话式工作流中无法直接调用

该技能的典型应用场景与实际体验情况

场景一：高校教师的课程讲稿。 一位讲师每周要更新 lectureXX.tex，讲稿里引用了十几篇文献与大量交叉引用。过去他经常忘记跑 bibtex，导致参考文献页显示为问号。使用该技能后，只要说「编译讲稿幻灯片 lecture05」，三遍序列自动完成，报告直接告诉他 overfull hbox 有几处、有无未定义引用。实际体验：上手几乎零难度，唯一需要注意的是文件名不要带 .tex；效果稳定，尤其适合每次都走同一套流程的重复性任务。

场景二：科研人员的组会汇报。 汇报幻灯片里的图注与文献引用较多，页码错乱会直接影响现场翻页。三遍编译确保最终页码正确。实际体验：编译耗时随文档规模增长，长文档需耐心等待；建议编译间隙不要频繁修改源文件。

场景三：多人协作的课件仓库。 团队把主题统一放在 Preambles/、文献放在根目录，新成员常常因环境变量未设置而报「主题找不到」。技能把 TEXINPUTS 与 BIBINPUTS 固化为标准动作。实际体验：这是它最有价值的地方——把「老成员的经验」变成「新成员也能复现的流程」；但前提是团队确实遵守这套目录约定。

场景四：中文 Beamer 幻灯片。 由于强制使用 XeLaTeX，中文排版与字体调用的兼容性更好。实际体验：需要注意编译日志中的字体警告并不总是致命，应结合 PDF 实际效果判断，而非一味追求日志零警告。

该技能能为用户带来的价值

  • 效率提升：把四条命令、两个环境变量、三类警告检查与一次 PDF 打开压缩为一次调用，单次编译的准备与排错时间显著缩短。
  • 降低门槛：新手不必理解「为什么需要三遍编译」，也能得到正确的参考文献与页码；隐式知识被固化为显式步骤。
  • 减少返工：主动检查未定义引用与标签变动，把问题暴露在提交前而不是演示现场。
  • 质量可见：overfull hbox 数量与 PDF 页数形成可追踪的质量指标，便于逐版对比。
  • 长期价值：统一团队编译口径，让课件仓库对新人友好，减少「在我电脑上是好的」这类环境差异问题。

常见问题 FAQ

Q1：怎么安装这个技能？ 在技能市场或技能管理入口搜索技能 ID 13627 或英文名 compile-latex 添加即可，并确保本地已安装含 xelatex 与 bibtex 的 LaTeX 发行版。具体安装命令与入口以官方说明为准。

Q2：为什么一定要编译三遍，能不能只跑一遍？ 不能省略。第一遍 xelatex 生成含引用键的 .aux；bibtex 据此生成 .bbl；第二遍把参考文献合并进文档；第三遍解析交叉引用并得到最终页码。少跑一遍就可能出现问号引用或错误页码。

Q3：报「找不到主题文件」或「参考文献为空」怎么办？ 先检查目录约定：Beamer 主题是否在 Preambles/、.bib 是否在仓库根目录。技能依赖 TEXINPUTS 与 BIBINPUTS 定位这两处资源，目录不符时需要调整结构或改用手动方式。

Q4：这个技能收费吗？ 技能本身是否收费取决于发布方的说明，请以官方说明为准；LaTeX 发行版与其工具链本身为开源软件。

Q5：它和 latexmk 该怎么选？ 若你的项目遵循「Slides/ + Preambles/ + 根目录 .bib」的结构，并希望自动获得警告检查与结果汇报，直接用本技能更省心；若项目结构特殊或需要高度自定义构建流程，用技能提供的 latexmk -xelatex 替代方案更灵活。