Word文档助手

要解决的问题

生成或修改 Word 文档时，常见痛点不只是“写几个字”：页边距、表格列宽、目录、修订、批注、跨 run 的文本替换都会让 XML 或脚本结果难以直接交付。直接操作 .docx 时，还需区分新建、编辑和读取三种路径，否则容易得到无法打开或渲染异常的文档。

技能如何工作

该技能按任务选择工具链：

• 新建文档：优先使用预装的 docx（npm）脚本生成 .docx，并注意 A4、横版、DXA 表格宽度、ShadingType.CLEAR、项目符号、分页符等易错点。
• 编辑现有文档：先解包，修改 word/document.xml 后重新打包；用 merge_runs.py 合并相邻同格式 run，便于定位跨片段文本。
• 读取内容：使用 pandoc -t markdown file.docx 将文档转成可分析文本。
• 修订与批注：通过脚本写入 comments.xml 等交叉引用文件，并提示在 document.xml 中添加锚点；可用 accept_changes.py 生成接受修订后的副本。
• 结果校验：用 pdftoppm 渲染页面图像，检查目录、表格、页码与删除段落。

适用边界与注意

它面向已有 pandoc、LibreOffice、Poppler 的环境；旧版 .doc 需先转换。技能不是图形化 Word 插件，不能替代复杂排版设计，也不应依赖肉眼未校验的 XML 修改。