当用户明确要求"LaTeX 模板优化""样式参数对齐""make_latex_model"时使用。支持任意 LaTeX 模板的样式参数对齐、标题文字对齐、标题格式对比(加粗)、HTML 可视化报告、LaTeX 自动修复建议和像素级 PDF 对比验证。
skills/make_latex_model/docs/WORKFLOW.mdskills/make_latex_model/docs/BASELINE_GUIDE.mdskills/make_latex_model/scripts/README.mdskills/make_latex_model/docs/FAQ.md@config.tex 的样式定义模式main.tex 的参考范围:
main.tex 中的 \section{}、 标题文本\subsection{}main.tex 中的 \input{} 引用的正文内容文件确保 LaTeX 渲染的 PDF 与 Word 版打印的 PDF 像素级对齐:
本技能采用“硬编码工具 + AI 决策”的混合模式:
工作空间(产物默认落在 projects/{project}/.make_latex_model/)与更多脚本细节见:
skills/make_latex_model/docs/WORKFLOW.mdskills/make_latex_model/scripts/README.md用户在以下场景触发本技能:
| 参数 | 类型 | 必需 | 说明 |
|---|---|---|---|
project | string | 是 | 项目名称(如 NSFC_Young、NSFC_General) |
word_template_year | string | 是 | Word 模板年份(如 2025) |
optimization_level | string | 否 | 优化级别:minimal(最小改动)|moderate(中等)|thorough(彻底),默认 moderate |
dry_run | boolean | 否 | 预览模式,不实际修改文件,默认 false |
python3 skills/make_latex_model/scripts/check_state.py projects/{project}
--project,支持 NSFC_Young 或 projects/NSFC_Young):cd skills/make_latex_model
./scripts/validate.sh --project projects/{project}
python3 skills/make_latex_model/scripts/enhanced_optimize.py --project projects/{project} --max-iterations 30 --report本步骤实现全自动的"优化-对比-调整"循环,推荐在需要精细调整时使用。
# 全自动迭代优化
python3 skills/make_latex_model/scripts/enhanced_optimize.py \
--project projects/NSFC_Young \
--max-iterations 30 \
--report
如需启用“Analyzer → Reasoner → Executor → Memory”的 AI 优化闭环(最小可用版),可加:
python3 skills/make_latex_model/scripts/enhanced_optimize.py \
--project projects/NSFC_Young \
--max-iterations 30 \
--ai --ai-mode heuristic
说明:当前脚本内部默认使用启发式决策;如需“宿主 AI 全程参与”,使用
--ai-mode manual_file(会生成projects/<project>/.make_latex_model/iterations/iteration_XXX/ai_request.json,等待写入ai_response.json后再继续)。
| 条件 | 阈值 | 说明 |
|---|---|---|
| 编译失败 | - | 立即停止,需人工修复 |
| 像素差异收敛 | changed_ratio < 0.01 | 达到像素级对齐 |
| 连续无改善 | 5 轮 | 指标不再优化,收敛 |
| 最大迭代 | 30 轮 | 强制停止 |
| 脚本 | 功能 |
|---|---|
enhanced_optimize.py | 一键迭代优化入口 |
prepare_main.py | 预处理/恢复 main.tex |
generate_baseline.py | 生成 Word PDF 基准 |
convergence_detector.py | 收敛检测与报告 |
run_ai_optimizer.py | AI 优化器(单轮调试入口) |
intelligent_adjust.py | 智能参数调整建议(旧版启发式,作为回退路径保留) |
CHANGELOG.md@config.tex 内只保留必要的解释性注释(不要维护版本历史)projects/{project}/extraTex/@config.tex 进行精确修改,保留:
\ifwindows)projects/{project}/main.tex 的标题文本(只改花括号内文字,不动 \input{})快速验证(推荐):
cd skills/make_latex_model
./scripts/validate.sh --project projects/{project}
⚠️ 永不触碰 main.tex 中的正文段落内容
main.tex 中的 \input{extraTex/*.tex} 引用的正文内容文件extraTex/*.tex 文件中的用户撰写内容✅ 允许修改 main.tex 中的标题文本
\section{标题文字} 中的标题文字\subsection{标题文字} 中的标题文字⚠️ 边界示例:
% ✅ 允许修改:标题文字
\section{{\bfseries(一)立项依据与研究内容}(建议8000字以内):} % 修改为
\section{{\bfseries(一)研究依据与内容}(建议8000字以内):}
% ❌ 禁止修改:正文内容
\input{extraTex/1.1.立项依据.tex} % 不改变引用关系
% extraTex/1.1.立项依据.tex 中的具体内容不修改
moderate 级别thorough 级别\ifwindows 条件判断./fonts/)xelatex -> bibtex -> xelatex -> xelatex 无错误skills/make_latex_model/config.yaml 为准)见:skills/make_latex_model/docs/FAQ.md