mathmod-paper-layout

name	mathmod-paper-layout
description	数模论文 DOCX/PDF 图表排版修复与终稿版面检查，处理短表跨页、图注分离、 大块留白、小字和公式导出显示异常。随 mathmod-writing 按需读取， 不修改科学结论，不训练模型，不承担科学评审或发布授权。

Paper Layout

范围与输入

从当前论文、内容主源、正式图表数据和委托的文件范围开始；确认版本与文件哈希。 只读本次必要材料，不从截图估计已有精确数字。保持数值、单位、正负号、公式含义、 样本分组、区间身份、条件及结论强度。改变科学含义时停下受影响部分，交回主控/推理。 mathmod-figure 负责图形本体设计，mathmod-writing 负责正文组织和最终放置。 默认 Markdown 初稿不要求运行本任务，也不自动安装排版依赖。

修复与检查

1. 先渲染现稿并看实际页面，定位问题页、对象和成因；不要根据源码猜版面。
2. 先查分页符、段落间距、浮动锚点与 keep-with-next 连接，再局部修复。
3. 每批改动后重新导出 PDF，逐页查看最新页面图像；不可只看首尾或提取文本。
4. 修复发现的问题再渲染；最终核对源文件、PDF、页面图及检查范围，保留未处理项。 转换失败必须停止，不能沿用目录里的旧 PDF 宣称新稿已通过。

表格、图件与留白

短表确认能放入一页后，连接表题和内部行、设置行不拆页，并在最后一行释放连接。 单行不跨页不等于整表不跨页；不能把全部正文锁成一个连接链。 长表允许合理续页并重复表头，不为了整页强行缩小字号；单行超过一页要先重组内容。 以下修复脚本只处理显式选中的顶层短表，不自动推断全部表格适合整页。 脚本自动绑定题注样式或明确全角间隔/冒号标记的表题；普通单空格标题需人工确认。 表题需结构/相邻对象等证据；“表 3 给出全部系数……”不能仅凭文字前缀当成题注。

按嵌入正文的物理尺寸检查坐标、图例、切点、单位、误差线身份与标题。量化图从正式数据 确定性绘制，不用生成图像替代。图与短标题相邻，长说明按实际长度处理；大块留白先查 错误连接，再按论文逻辑调整位置，不能用大量空行补救。读者逻辑交 Reader Clarity。

公式：源码正确不等于显示正确

保留可编辑公式。对照内容主源、Word 公式结构与最终 PDF 字形：重点看方括号、绝对值、 上下标、求和范围和编号。曾出现 OMML 的右方括号/右竖线正确而 PDF 显示为右圆括号的缺陷； 文本哈希、公式数量、编号齐全和工具 exit=0 均无法排除它。 半开区间如 (a,b] 可能本就正确，禁止用“所有括号必须同形”的全局替换。 只修复已定位表达式及转换链，不把显示缺陷直接判为模型计算错误。

可选工具

Python 依赖仅用于本任务：python -m pip install -r requirements.txt。 以下命令从本任务目录执行，输入/输出指向实际竞赛工作区，不向框架写论文。 Word/LibreOffice 转换器由当前环境提供；脚本不下载转换器或调用远端服务。

python scripts/layout_docx.py audit /path/paper.docx --short-tables 1,2,4 --report /path/qa/docx.json
python scripts/layout_docx.py repair /path/paper.docx --short-tables 1,2,4 --output /path/paper_fixed.docx --report /path/qa/repair.json
# 用当前环境转换 paper_fixed.docx，再确认生成的是新 PDF。
python scripts/layout_pdf.py inventory --pdf /path/paper_fixed.pdf --docx /path/paper_fixed.docx --pages-dir /path/qa/pages --review /path/qa/review.json
# 实际逐页看图后填写 reviewer、各页 status 和具体 notes。
python scripts/layout_pdf.py verify --pdf /path/paper_fixed.pdf --docx /path/paper_fixed.docx --pages-dir /path/qa/pages --review /path/qa/review.json
python -m unittest discover -s tests -v

选择的表号是顶层表从 1 开始的顺序，不是印在文中的表编号。输出使用新文件/空目录。 inventory 初始全部为 pending，不可自动批量填 pass。合成测试中的记录不是真实审读。 verify 要核对实际页图；只能验证记录与文件一致，不能证明填写者真的看过图。 这些记录是可选排版证据，不是新的工作流状态机或 release gate。

完成条件与回写

交付当前任务要求的文件；全文终稿应看完所有实际页面，局部任务说明范围。 在已有交付/审查记录中写清版本、哈希、页数、重要修改和未解决问题，不复制完整聊天。 仅做表达/版面调整不重跑科学模型、不覆盖正式证据，也不额外修改未委托的独立附录。 结构检查通过、视觉记录有效和科学成立是三件不同的事；未实际逐页查看不能声称版面验收。

实现参考

• python-docx 段落分页
• PyMuPDF 页面渲染

依赖文档用于核对实现，赛事实际格式要求与用户指定范围优先。