Word排版迁移师

Word排版迁移师是一个标准无关的通用 Word 排版迁移器。它自己不持有任何标准——标准由用户每次传入的模板决定。内置 make_demo_template.py 可生成演示模板，仅供回归测试，不是标准。

核心理念

• 输入：用户模板（=他的标准）+ 一份新文件（待排版）。
• 动作：让新文件去学用户传入的模板。
• Skill 是"学习者/搬运工"，不是"标准本身"。换个用户、换个模板，学的就是另一套。

为什么能做到跨电脑一致

Word 排版 = 指令 × 解析 × 渲染三层。常规做法只复制指令层（styles.xml），换电脑因字体缺失、主题字体引用、行距算法而漂移——表现为"换电脑字体和高度都变了"。

Word排版迁移师把模板的有效排版冻结成绝对值（具体字体名、绝对字号、固定行距、RGB 颜色、锁定编号），输出自包含、环境无关的 docx：

• 提取模板"有效视觉格式"（样式继承链 + 直接格式合成的最终视觉，不挑模板）
• 字体绝对化：主题引用 → 具体字体名，显式设 eastAsia
• 段距/行距/列宽/颜色/编号 全部写成绝对值

使用场景

• 投标书、方案书、建议书按客户或公司模板重排
• 多人协作后格式统一
• 跨电脑交付需要格式不漂
• .doc 旧文档重排

  7w4.net收录了海量优质技能插件。

必须确认的输入

1. 参考模板 Word（标准来源）：.docx 优先，.doc 也行
2. 待排版 Word（内容来源）：.docx 优先
3. 输出路径：生成新 .docx，不覆盖原始文件
4. 可选：--header-text 指定页眉文字；--embed-fonts 嵌入字体（默认关）

工作流

1. .doc 输入自动走多后端降级转 .docx（Word COM > WPS COM > soffice > 人工指引）
2. 解析源文档：段落、表格、章节文本
3. 识别标题层级（1/1.1/1.1.1/1.1.1.1 编号 → Heading 1-4）
4. 提取模板有效视觉格式（样式继承链 + 直接格式合成，不挑模板）
5. 字体绝对化：主题引用 → 具体名，显式 eastAsia，颜色 RGB，字号 sz
6. 冻结成绝对值：正文段距读模板、标题视觉回填、表格学模板、编号/图片固定
7. 输出自包含 docx + 处理报告 + QA 报告
8. 渲染检查（打包在 Skill 内）

能力边界

• 跨电脑一致性：95%+，不承诺 100%（打印机 metrics、Word/WPS 引擎差异残留）
• 不改写正文内容，只迁移排版
• 复杂合并单元格、超宽表格仍需人工复核
• 字体嵌入默认关（实测代价 5-7MB/小文档）；中文 Windows 用安全字体名（宋体/黑体/仿宋/楷体/微软雅黑）即可跨电脑一致

.doc 转换依赖

.doc → .docx 按顺序尝试本机已有的软件，无需额外安装：

1. Microsoft Word COM（商务客户，保格式最准）
2. WPS COM（中国 WPS 用户）
3. LibreOffice/soffice（跨平台兜底）
4. 全无时给出"另存为 .docx"的人工指引，不直接报错

命令示例

# 基本排版
python scripts/migrate_format.py --template my_template.docx --input messy.docx --out formatted.docx --report formatted.report.json

# 指定页眉
python scripts/migrate_format.py --template my_template.docx --input messy.docx --out formatted.docx --header-text "项目方案设计书"

# 嵌入字体（跨平台场景，文件会变大）
python scripts/migrate_format.py --template my_template.docx --input messy.docx --out formatted.docx --embed-fonts

# 结构 QA
python scripts/qa_docx.py --docx formatted.docx --json-out formatted.qa.json

验收清单

• 输出 .docx 可正常打开
• 正文段距、标题字号/颜色来自模板（不再白板/不再硬编码）
• 页面尺寸、页边距、页眉页脚接近模板
• dump styles.xml 无 asciiTheme，eastAsia 有具体值
• 表格文字完整、边框来自模板
• 渲染页面无文字重叠、页眉页脚断裂、表格溢出
• 换电脑打开字体/高度一致（95%+）

这个排版工具质量不错，文档写得清楚明白，能把任意模板的排版风格"学会"并套用到新文档上，跨电脑打开格式基本不会乱。它对中文 Windows 生态考虑充分，字体默认不嵌入避免文件臃肿，处理报告能帮你检查排版效果。不过遇到特别复杂的表格或不规范标题时效果可能打折扣，需要人工再检查一下。