前言¶
DeepSeek Harness (DSH) 的核心理念是「一切皆插件」。當智能體需要將運行結果導出爲標準文檔時，通常需要依賴外部服務。dsh-docx-mcp 提供了一個本地 MCP stdio 服務器，它根據 JSON 規範生成真正可打開的 .docx 文件。與需要安裝大量依賴的解決方案不同，該插件純 Node 實現，通過手寫 OOXML 和 store-zip 生成文件。
這是什麼¶
dsh-docx-mcp 是由 helibeiqi 維護的 DSH 插件，屬於「中文辦公自動化」垂直。它通過 DSH 的 MCP 橋接機制註冊爲 docx 工具，供 Agent 直接調用。該插件的核心價值在於零依賴，無需執行 npm install 即可運行。
核心能力¶
該插件支持以下功能：
- 生成真正的 .docx 文件。
- 零依賴（無需 npm install）。
- 支持標題（Heading 1-3）、段落（含加粗/斜體）、項目符號列表、表格。
- MCP stdio 服務模式。
- 與 DeepSeek Harness 完全集成。
工具：docx_generate¶
Agent 調用該工具時，需傳入以下參數：
| 參數 | 類型 | 說明 |
|---|---|---|
title |
string | 文檔大標題，自動作爲一級標題插入開頭 |
filename |
string | 輸出文件名（可含或不含 .docx） |
outDir |
string | 輸出目錄，默認 ~/dsh-docx-output |
blocks |
array | 內容塊數組 |
blocks 內容塊類型¶
| type | 字段 | 說明 |
|---|---|---|
heading |
level(1-3), text |
標題 |
paragraph |
runs(數組 {text,bold}) 或 text,bold |
段落；runs 支持同一段落內混合加粗 |
bullet |
items(string[]) 或 text |
項目符號列表 |
table |
rows(string[][]) |
表格，每行是一組單元格 |
典型用法¶
以下是一個生成「員工勞動合同續簽通知書」的 JSON 調用示例：
{
"title": "員工勞動合同續簽通知書",
"blocks": [
{ "type": "paragraph", "runs": [
{ "text": "致：", "bold": false },
{ "text": "張三", "bold": true },
{ "text": "（工號 E000123）" }
]},
{ "type": "heading", "level": 2, "text": "一、續簽事項" },
{ "type": "bullet", "items": ["合同期限：3 年", "試用期：無", "工時制度：標準工時"] },
{ "type": "heading", "level": 2, "text": "二、薪資結構" },
{ "type": "table", "rows": [
["項目", "佔比"], ["基本工資", "40%"], ["崗位工資", "40%"], ["績效工資", "20%"]
]}
]
}
工具將返回文件路徑和字節數。
安裝與集成¶
該插件以 bundle 形式分發。部署到其他機器時，需手動修改 cordis.patch.yml 中的絕對路徑，因爲該文件目前寫的是作者本機路徑（如 C:\Users\helib\dsh-docx-mcp\...）。
此外，支持通過 QUANT_MCP_NODE 環境變量指定 Node 運行時，以兼容 managed-node 版本目錄漂移問題。
本地運行¶
若需本地測試，可直接啓動 MCP 服務：
node docx-mcp-server.mjs
適用場景與注意¶
該插件適合需要快速生成標準格式文檔（如合同、報告）的場景。
注意：插件以當前 DSH 進程權限運行，需確保輸出目錄有寫入權限。在部署前，建議檢查源碼與許可證（MIT）。
