DocX 无损编辑工具包

它解决什么问题

Word 的 .docx 并不只是一个文本容器，它更像是一个 ZIP 包：正文、样式、主题、页眉页脚、修订和媒体文件都拆在多个 XML 部件里。如果脚本只是读取后整篇重新生成，很容易把原有样式、编号、分节、字段和中文排版打散；而直接字符串替换又可能忽略 w:r、w:t 的运行结构，造成格式断裂。

它如何工作

这个技能把 .docx 当作可解包的 XML 包处理，核心路径是 解包 → 原地修改 → 重新打包：

• 读取：先用 docx_reader.py 查看结构、大纲和预览，再决定改动范围。
• 编辑：根据任务选择创建、填空编辑或套用格式，使用 docx_replace_text.py、docx_fill_placeholders.py、docx_add_paragraph.py 等脚本做局部修改。
• 校验：输出前跑 docx_validate.py，并用 docx_reader.py --diff-against 确认只改了预期内容。
• 渲染：通过 docx_render.py 生成 PDF 与 PNG，人工检查字体、溢出和版式。

它对中文/CJK 场景做了显式约束，包括 UTF-8、w:rFonts w:eastAsia、字号表和 GB/T 9704 公文排版建议，并强调标题必须有 w:outlineLvl，否则可能从目录或导航窗格中消失。

适用边界

它更适合已有 .docx 的局部修改、模板填充和格式套用，不鼓励用重新生成替代原文件编辑。渲染依赖 LibreOffice 和 poppler；若本地缺少中文字体，预览可能用 Noto 替代，但文档中保存的字体名仍应保持正确。