docx-template-strict

目的：把 .docx 当作“模板”来用，完整保留模板的封面、分节（sectPr）、页眉页脚、样式、下划线 run 结构、字体与布局；只在模板中指定的占位符位置填充文本/图片/参考文献。

> 关键原则：不要用 python-docx 重新生成段落结构（这会破坏模板 run/sectPr）。

> 本 skill 采用：docx(zip) → XML 精确替换 → 写回 docx。

适用场景

• “按某个 Word 模板格式提交作业/论文/报告，封面与排版必须和模板一致”。
• 需要插图、图题、参考文献，同时保持模板视觉 1:1。

输入要求（模板必须包含占位符）

占位符格式

• 统一：{{TOKEN_NAME}}
• 必须是连续字符串，避免被 Word 拆成多个 run。

常用占位符（建议）

• {{TITLE_CN}} / {{TITLE_EN}}
• {{NAME_CN}} / {{NAME_EN}}
• {{MAJOR}} {{CLASS}} {{STUDENT_ID}}
• {{COURSE}} {{TEACHER}} {{DATE_CN}}
• {{ABSTRACT_CN}} {{KEYWORDS_CN}}
• {{ABSTRACT_EN}} {{KEYWORDS_EN}}

图占位符（段落级）

每张图推荐 3 段占位符（各占一整段，且仅包含该 token）：

• {{FIG1}}
• {{FIG1_CAPTION_CN}}
• {{FIG1_CAPTION_EN}}

第二张图：FIG2 同理。

参考文献占位符

• 推荐整块替换：{{REFERENCES}}（多行文本，包含 [1]...）

用法

1) 填充模板生成 docx

运行脚本：

python3 ~/.openclaw/skills/docx-template-strict/scripts/fill_template.py \
  --template "/path/to/template.docx" \
  --out "/path/to/output.docx" \
  --data "/path/to/data.json"

data.json 示例：

{
  "TITLE_CN": "...",
  "TITLE_EN": "...",
  "NAME_CN": "林佩权",
  "NAME_EN": "Lin Peiquan",
  "ABSTRACT_CN": "...",
  "ABSTRACT_EN": "...",
  "KEYWORDS_CN": "...",
  "KEYWORDS_EN": "...",
  "REFERENCES": "[1] ...\n[2] ...\n"
}

2) 插图（可选）

在 data.json 中提供：

{
  "FIG1": {"path": "/path/to/fig1.png"},
  "FIG2": {"path": "/path/to/fig2.jpg"}
}

脚本会：

• 把 {{FIG1}} 所在段落替换为图片 drawing
• 保留模板段落样式（对齐/缩进）

输出 QA（脚本自动做）

• 扫描是否仍存在 {{...}} 未替换 token
• 检查模板分节数量（sectPr）是否被破坏（必须一致）
• 检查 media 资源是否写入且 rels 指向有效

注意事项 / 已知限制

• 强依赖占位符：如果模板里没有 token，无法保证 1:1。
• 若 Word/WPS 将 token 拆成多个 run：脚本可能无法识别（建议复制 token 时使用“仅保留文本”）。
• PDF 导出不在本 skill 保真范围内：建议用本机 Word/WPS 导出 PDF，避免 LibreOffice 渲染漂移。