Word文档排版克隆Skill
📖 技能介绍
name: format-migrator-pro description: Word排版迁移师——标准无关的通用 Word 排版迁移器。用户传入自己的模板（标准）+ 一份新文件，Skill 让新文件学模板的排版，输出自包含、跨电脑 95%+ 一致的 .docx，附处理报告和结构 QA 报告。
Word排版迁移师
Word排版迁移师是一个标准无关的通用 Word 排版迁移器。它自己不持有任何标准——标准由用户每次传入的模板决定。内置 make_demo_template.py 可生成演示模板，仅供回归测试，不是标准。
核心理念
想要更强大的技能插件，就来小葱技能站7w4.net看看吧。
- 输入：用户模板（=他的标准）+ 一份新文件（待排版）。
- 动作：让新文件去学用户传入的模板。
- Skill 是"学习者/搬运工"，不是"标准本身"。换个用户、换个模板，学的就是另一套。
为什么能做到跨电脑一致
Word 排版 = 指令 × 解析 × 渲染三层。常规做法只复制指令层（styles.xml），换电脑因字体缺失、主题字体引用、行距算法而漂移——表现为"换电脑字体和高度都变了"。
Word排版迁移师把模板的有效排版冻结成绝对值（具体字体名、绝对字号、固定行距、RGB 颜色、锁定编号），输出自包含、环境无关的 docx： - 提取模板"有效视觉格式"（样式继承链 + 直接格式合成的最终视觉，不挑模板） - 字体绝对化：主题引用 → 具体字体名，显式设 eastAsia - 段距/行距/列宽/颜色/编号 全部写成绝对值
使用场景
- 投标书、方案书、建议书按客户或公司模板重排
- 多人协作后格式统一
- 跨电脑交付需要格式不漂
.doc旧文档重排
必须确认的输入
- 参考模板 Word（标准来源）：
.docx优先，.doc也行 - 待排版 Word（内容来源）：
.docx优先 - 输出路径：生成新
.docx，不覆盖原始文件 - 可选：
--header-text指定页眉文字；--embed-fonts嵌入字体（默认关）
工作流
.doc输入自动走多后端降级转.docx（Word COM > WPS COM > soffice > 人工指引）- 解析源文档：段落、表格、章节文本
- 识别标题层级（
1/1.1/1.1.1/1.1.1.1编号 → Heading 1-4） - 提取模板有效视觉格式（样式继承链 + 直接格式合成，不挑模板）
- 字体绝对化：主题引用 → 具体名，显式 eastAsia，颜色 RGB，字号 sz
- 冻结成绝对值：正文段距读模板、标题视觉回填、表格学模板、编号/图片固定
- 输出自包含 docx + 处理报告 + QA 报告
- 渲染检查（打包在 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%+）
🤖 AI 评测
这个排版工具质量不错，文档写得清楚明白，能把任意模板的排版风格"学会"并套用到新文档上，跨电脑打开格式基本不会乱。它对中文 Windows 生态考虑充分，字体默认不嵌入避免文件臃肿，处理报告能帮你检查排版效果。不过遇到特别复杂的表格或不规范标题时效果可能打折扣，需要人工再检查一下。
