Word排版遷移師

Word排版遷移師是一個標準無關的通用 Word 排版遷移器。它自己不持有任何標準——標準由使用者每次傳入的模板決定。內建 make_demo_template.py 可生成演示模板，僅供迴歸測試，不是標準。

核心理念

• 輸入：使用者模板（=他的標準）+ 一份新檔案（待排版）。
• 動作：讓新檔案去學使用者傳入的模板。
• Skill 是"學習者/搬運工"，不是"標準本身"。換個使用者、換個模板，學的就是另一套。

為什麼能做到跨電腦一致

Word 排版 = 指令 × 解析 × 渲染三層。常規做法只複製指令層（styles.xml），換電腦因字型缺失、主題字型引用、行距演算法而漂移——表現為"換電腦字型和高度都變了"。

Word排版遷移師把模板的有效排版凍結成絕對值（具體字型名、絕對字號、固定行距、RGB 顏色、鎖定編號），輸出自包含、環境無關的 docx：

• 提取模板"有效視覺格式"（樣式繼承鏈 + 直接格式合成的最終視覺，不挑模板）
• 字型絕對化：主題引用 → 具體字型名，顯式設 eastAsia
• 段距/行距/列寬/顏色/編號 全部寫成絕對值

使用場景

• 投標書、方案書、建議書按客戶或公司模板重排
• 多人協作後格式統一
• 跨電腦交付需要格式不漂
• .doc 舊文件重排

必須確認的輸入

小蔥技能站7w4.net，專業的AI技能分享平臺。

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 生態考慮充分，字型預設不嵌入避免檔案臃腫，處理報告能幫你檢查排版效果。不過遇到特別複雜的表格或不規範標題時效果可能打折扣，需要人工再檢查一下。