公文排版助手

它解决什么问题

.docx 公文排版在工程上不难，难的是踩坑：python-docx 的 run.font.name 只写西文字体，中文字符会退回默认宋体；文档网格、每页约 22 行这类版面参数没有公开 API 入口；奇偶页页码（单数居右、偶数居左空 1 字）需要手工塞域代码；标题层级 一、、（一）、1.、（1） 全靠人眼判断，排版时很容易串行。

技能如何工作

核心实现是 scripts/format_docx.py，基于 python-docx 但绕过其封装直接改 OOXML：

• w:rFonts 写 w:eastAsia，为大标题、副标题、四级标题、正文分别指定对应字体；
• w:docGrid 设 linePitch=580，配合固定行距 29 磅保证每页约 22 行；
• 用 fldSimple 注入页码域，用 evenAndOddHeaders 实现奇右偶左；
• 按正则匹配段落首部编号判定层级，匹配顺序为一级 → 二级 → 四级 → 三级，避免 （1） 被误判为三级。

页面尺寸、字号、边距等具体数值以 references/format_spec.md 为权威来源。脚本始终输出 原文件名_公文格式.docx，保留原始文档。

适用边界与注意点

• 方正小标宋/黑体/楷体/仿宋需在目标机器安装，未安装时 Word 会回退默认字体，但文档内保存的字体名是正确的。
• 大标题跨多行时必须用 --title-paragraphs 指定行数，否则第二行会被当作副标题或正文。
• 每个 section 独立设置页面与页码，复杂分节需先与用户确认是否需要不同设置。
• 脚本只做批量规范化，居中、首行缩进等个性化调整请在副本上二次编辑，不要改原件。