DeepSeek Harness (DSH) 的插件生态支持扩展各类能力。在办公场景中，直接将 AI 生成的内容转换为格式规范的 Word 文档是一个常见需求。dsh-word-docs 插件提供了这种能力。
这是一个给 DeepSeek Harness 的办公 Word 文档插件。由 Ei-Ayw 维护。核心功能是让 DSH 说一句话，就能输出正式文档。
核心能力¶
生成、编辑、读取与统计¶
插件支持生成、编辑、读取、统计文档以及转 PDF。底层实现仅使用 Python 标准库（zipfile + xml.etree），无第三方依赖。
中文排版优化¶
自动处理中文字体（宋体/eastAsia），支持正式公文排版，包括首行缩进和中文标题编号。
标准插件接口¶
作为标准 DSH 插件，安装后注册 word_docs 工具和 word-docs 技能。
JSON 规格定义¶
支持通过 JSON 规格定义文档，包含标题、正文（加粗/斜体/代码）、嵌套列表、表格（支持合并单元格和列宽设置）、图片、分页。
Markdown 转换¶
支持将 Markdown 转换为 Word，兼容 ATX 标题、管道表格、代码块、引用、链接等格式。
文档编辑¶
支持编辑现有文档，包括替换文本（保留格式）、追加内容、删除段落、批量填充模板（如 {占位符}）以及设置格式。
安装¶
dsh plugin --profile web add git+https://github.com/Ei-Ayw/dsh-word-docs.git
典型用法¶
通过命令行将 Markdown 转换为 Word：
python3 scripts/worddocs.py md2docx --input demo/sample.md --output demo/meeting.docx --page-number --first-line-indent --number-headings chinese
通过 JSON 规格生成文档：
{
"page": { "footer": { "pageNumber": true } },
"headingNumbering": "chinese",
"content": [
{ "type": "heading", "level": 0, "text": "2026 年第 35 周工作周报", "align": "center" },
{ "type": "paragraph", "text": "完成 **API 网关** 限流改造,压测 QPS 提升 40%" },
{ "type": "table", "colWidths": [3.5, 3, 3, 3],
"headers": ["指标", "本周", "上周", "环比"],
"rows": [ ["需求交付数", "5", "4", "+25%"],
[{ "text": "合并列", "colSpan": 2 }, "3", "-57%"] ] }
]
}
注意事项¶
- 静态编号: 标题编号为生成时写死的静态编号，非 Word 自动编号域。
- 功能范围: 图片支持 png/jpg/gif；页眉页脚在生成时设置；不支持脚注/目录域/水印。
- 本地安装: 本地安装时需注意 peer 依赖解析，执行
ln -s ~/.dsh/profiles/node_modules/@deepseek-ai node_modules/@deepseek-ai。
生态背景¶
DSH 理念是「一切皆插件」。社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系。
