word-docx-writer：中文 Word 报告生成与排版插件

在智能体工作流中，生成结构化的中文长文档（如实验报告、毕业论文）通常需要处理复杂的排版规则。手动格式化既耗时，又容易出错。word-docx-writer 旨在解决这一问题，它是一个提供 Agent Skill 与工具包的插件，能够生成规范的 .docx 文档，并支持对已有文档进行规范化处理。

核心能力¶

该插件主要包含以下特性：

• 轻量级依赖：生成文档的核心逻辑仅依赖 Python 标准库，插入图片时需要 Pillow。
• 双实现模式：支持 OOXML（跨平台，无需 Word）与 Word COM（Windows + Microsoft Word）两种实现。OOXML 负责基础生成，Word COM 用于 .doc 转换、目录刷新等高级功能。
• 模板与规范化：支持从模板中套用封面、目录、页眉页脚，并只替换正文；同时也支持对任意已有 .docx 文档一键套用字体、字号、段落格式与颜色。
• 多 Agent 兼容：可作为 DSH 插件分发，同时也兼容 Claude、Gemini 等 Agent 工具。

安装与启用¶

通过 DeepSeek Harness (DSH) 的官方目录安装该插件：

dsh plugin --profile web add dsh-plugin-word-docx-writer@latest

安装完成后，插件提供内置技能与脚本工具包。

典型用法¶

使用前需确保环境满足依赖：Python 3.8+ 和 Pillow。

1. 生成文档
   通过标记稿生成 Word 文档。假设存在 content.txt，执行以下命令：

    python scripts/build_docx.py --content content.txt --out report.docx

2. 规范化已有文档
   对已生成的或已有的 .docx 文档套用排版规范。默认优先使用 Word COM，失败时自动退回 OOXML 模式：

    python scripts/word_style.py report.docx

若需在非 Windows 平台强制使用 OOXML 模式，可添加 `--method ooxml` 参数。

3. 校验文档结构
   读取并转换 .docx 文档结构进行校验：

    python scripts/read_docx.py report.docx

适用场景与注意¶

• 适用场景：适用于各类中文长文档的生成与排版，包括实验报告、课程设计报告、毕业论文、项目总结等。
• 平台限制：
  • 非 Windows 平台：build_docx.py 与 word_style.py --method ooxml 完全可用。
  • .doc 转换与目录刷新：需要 Windows + Microsoft Word（COM）环境，或手动使用 LibreOffice/Word 完成。
• 许可证：该插件采用 MIT 许可证，使用时请保留版权声明。

总结¶

word-docx-writer 为 DSH 及其他 Agent 工具提供了一套标准化的中文文档处理方案。它通过轻量级的 Python 脚本和双实现模式，平衡了跨平台能力与 Windows 下 Office 的深度集成能力，适合需要批量生成或规范化 Word 文档的工作流场景。

更多详情可参考插件目录：https://www.skillhub.cn/plugins/RempleXI/word-docx-writer