| name | word-formatter |
| description | Word 文档智能排版工具（VR版）。支持两种格式输入方式： 方式A（VR-A）从参考文档提取格式并1:1复刻应用到目标文档； 方式B（VR-B）自然语言描述格式，AI解析生成预设，不确定时必须追问用户。 内置公文排版（GB/T 9704-2012）、学术论文等预设。 核心特性：确定性规则分类（非AI猜测）、强制字体应用（剥离theme防覆盖）、 OOXML级缩进处理（防叠加）、排版后自动校验。务必在以下场景使用：用户说 "排版""格式化""整理文档""公文格式""论文排版""统一格式""Word排版" "文档格式""格式规范""页边距""字体设置""行距""标题格式""排版一下" "帮我排版""格式不对""调整格式""按这个格式排""参考这个文档的格式" "提取格式""复刻格式"。
|
| argument-hint | [文件路径] [--preset 公文|论文|自定义] |
| allowed-tools | Bash(*), Read, Write, Edit, Glob |
Word 文档智能排版
基于 python-docx 的确定性排版引擎，1:1 复刻格式规范，杜绝 AI 自行发挥。
核心设计原则
- 确定性规则分类 —— 用正则 + OOXML 属性判定元素类型（标题/正文/表格等），不用 AI 猜
- 强制字体应用 —— 逐 run 设置字体，剥离
w:eastAsiaTheme 等 theme 属性，防止 Word 主题自动替换
- OOXML 级缩进 —— 先清除所有残留缩进属性（
w:hanging/w:leftChars 等），再设 firstLineChars=200，杜绝缩进叠加
- 安全副本 —— 不修改原文件，操作临时副本
- 校验闭环 —— 排版后自动校验每一项，列出所有不符合项，必须人工确认
依赖
pip install python-docx>=1.1.0
执行流程
Step 1 确认需求 —— 两种格式输入方式
方式 A：从参考文档提取格式（VR-A）
用户给一份"排版好的参考文档"，引擎自动提取其中的格式规范，然后应用到目标文档。
用户：我有一份排版好的 XX.docx，帮我按这个格式排版 YY.docx
↓
Step 1: 提取参考文档的格式
python scripts/formatter_extract.py <参考.docx> -o /tmp/extracted.json
↓
Step 2: 把提取结果展示给用户确认
"提取到的格式：标题=黑体二号居中，正文=宋体小四首行缩进..."
↓
Step 3: 用户确认或修改后应用
python scripts/formatter_cli.py <目标.docx> --preset /tmp/extracted.json --verify
python scripts/formatter_extract.py <参考.docx> --apply <目标.docx>
python scripts/formatter_extract.py <参考.docx> -o preset.json
方式 B：自然语言描述格式（VR-B）
用户直接说想要什么格式，AI 解析为预设 JSON。如果描述不够明确，AI 必须追问。
用户：帮我排版，标题用黑体二号，正文用宋体小四，行距1.5倍
↓
Step 1: AI 解析用户描述，生成预设 JSON
如果不确定（如"行距1.5倍"是固定值还是倍数？），必须问用户
↓
Step 2: 生成预设并展示给用户确认
"确认格式：标题=黑体22pt居中，正文=宋体12pt首行缩进，行距=固定值20pt..."
↓
Step 3: 用户确认后应用
python scripts/formatter_cli.py <目标.docx> --preset /tmp/custom.json --verify
预设快捷方式（内置规范）
不想从头描述时，可直接用内置预设：
gongwen —— 党政机关公文格式（GB/T 9704-2012）thesis —— 学术论文通用格式
Step 2 运行排版
python scripts/formatter_cli.py <input.docx> --preset gongwen --verify
python scripts/formatter_cli.py <input.docx> --preset thesis --verify
python scripts/formatter_cli.py <input.docx> --preset <path.json> --verify
python scripts/formatter_cli.py <input.docx> --verify-only
python scripts/formatter_cli.py <input.docx> --set title_size=18 body_font=宋体
python scripts/formatter_cli.py --list-presets
输出文件默认为 <原文件名>_formatted.docx，可用 -o 指定。
Step 3 审查校验报告
排版后自动运行校验，输出格式为：
校验结果：X 个错误 / Y 个警告 / Z 个信息
❌ 错误（必须修复）：
[段落3/run1] 字号不符
期望: 16pt | 实际: 12pt
⚠️ 警告（建议修复）：
[段落5] 行距不符
期望: 28pt | 实际: 24pt
AI 必须做的：把校验报告原样呈现给用户，不要自行解释或忽略任何 ERROR。
Step 4 给用户摘要
在对话中给出：
- 排版完成的文件路径
- 校验结果摘要（通过/未通过）
- 如有 ERROR，列出具体哪些段落有问题，让用户确认
排版规范速查
公文排版（gongwen）
| 元素 | 字体 | 字号 | 行距 | 对齐 | 缩进 |
|---|
| 标题 | 方正小标宋简体 | 二号(22pt) | 33pt | 居中 | 无 |
| 副标题 | 楷体_GB2312 | 三号(16pt) | 28pt | 居中 | 无 |
| 一级标题 | 黑体 | 三号(16pt) | 28pt | 两端对齐 | 首行2字符 |
| 二级标题 | 楷体_GB2312 | 三号(16pt) | 28pt | 两端对齐 | 首行2字符 |
| 三级标题 | 仿宋_GB2312 | 三号(16pt) | 28pt | 两端对齐 | 首行2字符 |
| 正文 | 仿宋_GB2312 | 三号(16pt) | 28pt | 两端对齐 | 首行2字符 |
页边距：上 3.7cm / 下 3.5cm / 左 2.8cm / 右 2.6cm
论文排版（thesis）
| 元素 | 字体 | 字号 | 行距 | 对齐 |
|---|
| 标题 | 黑体 | 二号(22pt) | 33pt | 居中 |
| 一级标题 | 黑体 | 三号(16pt) | 28pt | 居中 |
| 二级标题 | 黑体 | 四号(14pt) | 24pt | 左对齐 |
| 三级标题 | 黑体 | 小四(12pt) | 20pt | 左对齐 |
| 正文 | 宋体 | 小四(12pt) | 20pt | 两端对齐 |
页边距：上下 2.54cm / 左右 3.17cm
标题层级识别规则
| 层级 | 正则 | 示例 |
|---|
| H1 | ^一/二/三...、 | 一、总体要求 |
| H2 | ^（一/二/三...） | （一）基本原则 |
| H3 | ^\d+\. | 1. 工作目标 |
| H4 | ^（\d+） | （1）第一项 |
校验项清单
参考文档
