技能介绍

解决什么问题

把 Word 论文交给 LaTeX 时，真正麻烦的往往不是文字本身，而是样式和结构：上标引用、上下标、表格字号、图表编号、脚注、公式、元数据。手工复制到 ZUFE-Thesis 模板里，很容易出现上标被压平、标题层级错乱、图片题注误填、手写编号和 LaTeX 编号同时出现等问题。该技能把这类转换拆成可检查、可回退的门禁流程，目标是让 Word 中的语义证据先被保留，再被映射到模板，而不是让脚本替作者做文章结构判断。

核心流程

流程 A：门禁与预准备
先确认模板签名、身份版本和渲染器依赖接口；检查工作区、DOCX、metadata、旧输出，以及 python-docx、xelatex、biber、关键 TeX 包和 QA 工具。没有可用模板时，不会在空目录或缺失签名的目录中继续转换。

流程 B：抽取、账本与渲染
import_docx.py 按原文顺序记录普通 run、可转换超链接、脚注和原生 OMML 公式，生成 thesis.json 与 extracted.md。Agent 负责判断段落属于章节标题、正文、摘要、参考文献、致谢、附录、图表标题还是噪声，并把低置信度问题抛给用户确认。render_chapters.py、render_basicinfo.py、render_bib.py 只在映射已确认且门禁通过时写入模板。

流程 C：编译、诊断与质检
build.py 强制重跑流程 B 门禁，通过后归档旧 main.pdf，运行 xelatex -> biber -> xelatex -> xelatex。失败由 diagnose_build.py 分类，qa.py 再核对输入指纹、编译链、PDF 新鲜度、文本、引用和模板残留；通过后仍建议人工视觉检查。

注意点

该技能不是通用 Word 转 LaTeX 工具。它依赖原始 ZUFE-Thesis 模板，且不处理尾注、内部书签、表格单元格脚注、MathType/OLE 对象、墨迹公式、批注修订、文本框、Word 域/自动编号、SmartArt、页眉页脚等边界。对于原生 OMML 公式，转换成功也不等于视觉完全一致。手写编号、图表题注、引用类型和英文摘要缺失都需要明确确认，不能静默改写或补写。