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