最新Dify工作流实践：文档快速生成思维导图完整指南
在日常项目中，面对密集的文档、方案与纪要，快速提取核心信息始终是痛点。反复通读多遍才能厘清逻辑脉络？不妨借助Dify，将文档自动转化为结构化的思维导图，大幅提升重点提取与理解效率。以下基于Dify 1.2.0版本的完整实践记录。
环境搭建
1. 安装Markdown转换器插件
该插件专门用于将Markdown内容渲染为思维导图所需的HTML文件。
2. 安装Agent策略插件
此插件确保Dify能够顺畅调用MCP工具，实现远程指令下发。
3. 启动MCP Server工具
MCP Server的核心功能是将输入的Markdown文本转换为HTML格式的思维导图。原始项目代码地址如下：
https://github.com/YuChenSSR/mindmap-mcp-server
默认仅支持stdio模式（本地进程通信），但Dify服务通常部署在容器中，需通过sse模式实现远程调用。因此对源码做了适配调整。
服务启动命令如下：
# Python环境搭建步骤略 pip install mcp # 安装必要依赖 python mindmap_mcp_server.py --host 0.0.0.0 --port 1100
工作流配置
整体工作流拓扑见下图，后续逐一拆解各节点。
开始节点
定义file变量，支持文件上传输入。
文档提取器节点
负责从上传文档中抽取原始文本内容。
文档内容转Markdown节点
将提取的原始内容转换为规范的Markdown格式。使用的Prompt如下：
上下文内容：{{#context#}}
## 核心任务
将上下文内容转化为符合以下标准的Markdown格式思维导图框架：
1. **要素提取**：识别并提取关键实体、关系、流程三类核心要素
2. **逻辑重构**：按「总-分」结构重组信息，确保父子节点存在推导关系
## 格式规范
### 层级控制
- 主标题 `#`（1级）：文档主题
- 章节 `##`（2级）：核心模块（≥3个）
- 子项 `###`（3级）：具体要素（每个父节点下≥2个）
### 内容标记
- 关键术语：**加粗显示** + (简短释义)
- 数据示例：```包裹的代码块```
## 质量保障
1. 预检机制（输出前必须验证）：
- [ ] 无孤立节点（所有子项都有父节点）
- [ ] 无重复内容（合并相似条目）Agent节点
添加Agent策略时，需选择环境阶段安装的Agent策略插件，并指定FunctionCalling策略。同时配置MCP工具：注意工具列表至少添加一个工具才能正常保存，因此额外加入了获取当前时间的工具。
MCP服务配置如下：
{
"mindmap": {
"description": "将输入的markdown的内容转为思维导图",
"url": "http://192.168.1.110:1100/sse",
"headers": {},
"timeout": 60,
"sse_read_timeout": 300
}
}
指令配置：
请根据上下文内容调用mindmap MCP工具将输出结果转为合适完整可渲染的html，
注意生成的内容务必不要添加其他冗余的信息。
上下文:{{#1748051257295.text#}}
生成内容校验节点
用于检查上一步输出的HTML是否存在语法缺陷，并按规则修复后输出最终结果。使用的Prompt如下：
你的任务是对上下文中的html内容做校验，
对html内容存在语法问题做修复并输出，
确保输出内容完整不含且不包含冗余内容，
最终输出为'#思维导图'拼接上html内容
上下文：{{#context#}}
Markdown转HTML节点
调用环境阶段安装的Markdown转换器插件，完成格式转换。
结束节点
最终导出为HTML文件。
工作流执行
测试时选用篇幅适中的文章（避免token超限），直接以一篇历史文章验证输出效果。
工作流执行完毕后生成文件，点击右下角即可查看渲染结果。
实践踩坑记录
- 输入文件中若含有特殊字符（尤其是代码片段），生成的思维导图偶尔会出现渲染异常。
- Dify Agent偶发无法调用MCP工具。此时需优化MCP工具的description字段，并同步调整工作流节点的Prompt与指令。
总结
本文分享了利用Dify将文档自动转化为结构化思维导图的完整方案。坦率讲，当前流程仍较粗糙，优化空间充裕：例如输入源可直接从网页抓取、长文档可拆分迭代处理、文档内图片的兼容性等，这些都是后续迭代方向。