前言¶
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）。
