核心功能
thu-thesis 是一款专为清华大学毕业生设计的 AI 辅助论文转换工具，解决 Word 格式论文向官方 LaTeX 模板（thuthesis）迁移的痛点。工具采用"三层 AI-native"架构：Python 脚本负责机械提取与组装（无 LLM 调用），AI 在关键节点介入阅读骨架生成与质量评测。
显著优点
1. 官方规范保证：严格遵循清华 thuthesis 官方模板，所有格式决策以 assets/databk/ 中的官方示例为黄金标准，不擅自改动封面、页眉、目录、参考文献样式等
2. 完整内容提取：自动识别章节结构、中英文摘要、参考文献（含 BibTeX 生成）、图片（含 caption）、表格（三线表格式）、致谢、个人简历等全部论文要素
3. 智能引用处理：支持 [1,2,3] 和 [1-3] 数字引用自动转 `
cite，以及 曹玉（2025） 等 author-year 行文引用自动补
cite，未引用文献用
cocite` 兜底
4. 缩略语自动管理：生成符号说明表，检测"孤儿缩略语"并在正文首次出现处自动补写完整形式
5. 严格质量评测：38 项 Rubric 逐项打分，AI 自动修复可修复问题（最多 3 轮迭代），输出详细评测报告
6. MBA 专业适配：内置 MBA 专业硕士配置模板（degree-type=professional）
潜在局限
- 输入格式敏感：仅支持
.docx，旧版.doc必须用 Word 另存为（textutil等工具会破坏表格结构） - SVG 图片不支持：需手动转换为 PNG/PDF 后补入
- 图表位置依赖 AI 判断：Step 2 生成
struct.json时若content_range设定不准，可能导致图表丢失，需人工核对 - 部分字段需手工补充：答辩后的 committee/comments/resolution 为占位文件
- Author-year 匹配非 100%：姓名简称无法映射时保留原文，需人工检查
适合人群
- 清华 MBA/学硕/专硕毕业生：需将 Word 论文转为符合官方规范的 PDF
- 对 LaTeX 不熟悉的用户：无需学习 thuthesis 复杂配置，一键完成转换
- 时间紧张的毕业生：自动化处理格式规范，专注内容完善
常规风险
- 编译环境依赖：需预装 TeX Live（xelatex/bibtex）及 Python 依赖（
python-docx、jinja2） - 中间文件占用：转换过程产生多份 JSON 中间文件，需及时清理
- 图表丢失风险：如前所述，AI 生成的章节范围若覆盖不全会导致图表遗漏，强烈建议执行「图表完整性检查」步骤
- 参考文献解析质量：自动解析的 BibTeX 可能存在 author 截断、机构名识别错误等问题，需人工复核
refs.bib和thesis.bbl
使用要点
首次运行执行 setup.sh 从 GitHub 拉取最新 thuthesis 并备份格式参考；转换流程为 extract → AI 生成 struct.json → build 编译；务必检查 raw_xxx.json 中的图片 para_idx 和表格 before_para 是否被 struct.json 的章节范围完整覆盖。