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 / 幻方無官方從屬關係。
