\r \r

EdrawMind（万兴脑图）思维导图生成技能\r

\r 通过 edrawmind_cli.py 脚本调用 EdrawMind HTTP API，将自然语言主题或已有 Markdown 文档转化为专业思维导图。支持自定义布局、主题风格、画布背景和手绘效果。生成后返回在线编辑链接和缩略图预览。\r \r

快速参考\r

\r | 任务场景 | 处理方式 |\r |---------|---------|\r | 从已有 Markdown 文件生成 | 读取文件 → 提取并清理标题 → 确定布局/主题/背景 → 执行脚本 |\r | 根据用户描述的主题生成 | 起草 Markdown 大纲 → 根据内容类型确定参数 → 执行脚本 |\r | 从代码/项目结构生成 | 探索代码库 → 整理为 Markdown 层级 → 执行脚本 |\r \r ---\r \r

Step 1 — 准备 Markdown 内容\r

\r 输入必须是结构良好的 Markdown，使用标题层级表示树状结构。\r \r 核心规则：\r

• # → 根节点（中心主题），建议仅一个\r
• ## → 一级分支、### → 二级分支，以此类推\r
• -/*/+/1. 列表项 → 子节点，缩进列表项 → 更深层子节点\r
• 必须包含至少一个标题和至少一个列表项\r
• 节点文字简洁（中文 3-10 字，英文 3-5 词），去除编号前缀\r
• 建议最大深度 5 层，最大节点数约 150 个\r \r

详细格式规范、层级映射及示例参见 Markdown 格式规范。\r \r ---\r \r

Step 2 — 选择布局类型（layout_type）\r

\r 根据内容特点选择最合适的布局（1–12），默认 1（MindMap 双向导图）。\r \r 智能推断：\r

• 含"原因/影响/根因/6M" → 8（鱼骨图）\r
• 含"时间/进度/计划/里程碑/路线图" → 7（时间轴）\r
• 含"组织/部门/团队/人员架构" → 5（向下组织结构图）\r
• 含"分类/体系/全景/层级" → 4（向下对称树状图）\r
• 含"对比/矩阵/SWOT/多维" → 12（矩阵图）\r
• 含"对比表/需求/功能清单" → 11（树型表格）\r
• 含"清单/目录/大纲/列举" → 10（括号图）\r
• 含"演示/发散/放射/展示" → 9（扇形放射图）\r
• 其他/未指定 → 1（MindMap）\r \r

各布局的结构特点及视觉效果参见 风格参数指南。\r \r ---\r \r

Step 3 — 选择主题风格（theme_style）\r

\r 传入 1–10，默认不传则保持导入时原始主题。\r \r 智能推断：\r

• "学习/笔记/知识/教育" → 2\r
• "创意/活力/时尚/产品/年轻" → 3\r
• "商务/汇报/正式/简洁/职场" → 4\r
• "头脑风暴/彩虹/活泼/儿童/趣味" → 5\r
• "文档/报告/打印/大纲/素雅" → 6\r
• "生活/旅游/健康/自然/计划" → 7\r
• "暗色/夜间/深色/护眼" → 8\r
• "科技/霓虹/赛博/发布会/炫酷" → 9\r
• "科幻/IT/架构/安全/暗黑" → 10\r
• 未指定 → 1\r \r

各主题的配色、连线形状等详细说明参见 风格参数指南。\r \r ---\r \r

Step 4 — 选择画布背景（background）\r

\r 传入预设编号 1–15 或自定义 "#RRGGBB"。默认不传（无背景）。自定义颜色优先级高于纹理预设。\r \r 快速推断：\r

• "极简/打印/正式" → 2 · "温馨/商务" → 3\r
• "科技/分析" → 4 或 11 · "自然/清新" → 5\r
• "文艺/创意" → 6 · "暗色主题" → 7/8/14/15\r
• "复古/手绘感" → 9 · 品牌色 → 直接传 "#RRGGBB"\r \r

各背景的色值及纹理效果参见 风格参数指南。\r \r ---\r \r

Step 5 — 选择手绘风格（可选）\r

\r 两个独立参数，可单独或组合使用：\r \r line_hand_drawn — 连线手绘（true/false，默认 false）：所有连线变为手绘弯曲风格。\r \r fill_hand_drawn — 节点填充手绘：none（默认）/ pencil / watercolor / charcoal / paint / graffiti。\r \r 注意：手绘风格影响渲染性能，建议节点数 ≤ 50；超过时优先使用非手绘风格。\r \r 组合推荐：\r

• "手绘/素描" → line_hand_drawn=true + fill=pencil + background=9（棉纸纹）\r
• "水彩插画" → line_hand_drawn=true + fill=watercolor + 浅色背景\r
• "炭笔艺术" → line_hand_drawn=true + fill=charcoal + background=10（浅灰纹）\r
• "涂鸦个性" → line_hand_drawn=true + fill=graffiti + 深色背景\r \r

手绘风格的完整组合效果参见 风格参数指南。\r \r ---\r \r

Step 6 — 执行脚本生成思维导图\r

\r 将准备好的 Markdown 内容通过 --text 参数直接传给脚本，根据前几步确定的参数拼接命令行，在终端执行：\r \r

python ./scripts/edrawmind_cli.py --text "\x3CMARKDOWN内容>" [OPTIONS]\r
```\r
\r
**`--text` 中的换行用 `\
` 表示。** 无需创建临时文件。常用选项：`--layout N`（布局 1–12）、`--theme N`（主题 1–10）、`--background BG`（背景 1–15 或 `#RRGGBB`）、`--line-hand-drawn`、`--fill STYLE`。\r
\r
**调用示例：**\r
```bash\r
python ./scripts/edrawmind_cli.py --text "# AI技术\
## 机器学习\
- 监督学习\
- 无监督学习\
## 深度学习\
- CNN\
- Transformer" --layout 1 --theme 2\r
```\r
\r
**判断结果：** 成功时输出包含 `✓` 和 `Edit URL`；失败时输出 `✗` 或 `Connection failed`。已在终端输出中找到成功标志时，**不得重复执行脚本**。\r
\r
> 完整 CLI 参数说明参见 [CLI 工具参考](./references/tool-reference.md)。\r
\r
---\r
\r
## Step 7 — 展示结果\r
\r
1. **必须展示 `file_url`**：提供在线编辑链接，确保用户能访问和编辑思维导图\r
2. **展示缩略图**：如果当前环境支持图片渲染，使用 `thumbnail_url` 展示预览缩略图\r
\r
---\r
\r
## 应用场景\r
\r
### 从已有 Markdown 文档生成\r
\r
1. 读取源 Markdown 文件\r
2. 提取标题结构，清理编号前缀、精简冗长标题\r
3. 分析内容类型，选择合适的布局和主题\r
4. 执行 `edrawmind_cli.py`\r
5. 展示 `file_url` 和缩略图\r
\r
### 根据用户描述的主题生成\r
\r
1. 获取用户主题（或从对话中推断）\r
2. 起草 2-4 层深度的 Markdown 大纲\r
3. 根据主题类型智能推断布局、主题、背景\r
4. 执行 `edrawmind_cli.py`\r
5. 展示 `file_url` 和缩略图\r
\r
### 从代码库/项目结构生成\r
\r
1. 探索代码库，理解架构\r
2. 整理为 Markdown 层级结构\r
3. 推荐使用 RightTree（`--layout 3`）或 RightMap（`--layout 2`）\r
4. 执行 `edrawmind_cli.py`\r
5. 展示 `file_url` 和缩略图\r
\r
---\r
\r
## 注意事项\r
\r
- 纯文本段落无法生成思维导图，必须使用标题和列表\r
- 建议每次只使用一个 `#` 一级标题作为根节点\r
- 对于大型文档（100+ 个标题），按章节拆分为多个思维导图\r
- **必须向用户展示返回的 `file_url`**\r
- 用户明确指定布局/主题/背景时严格遵从；未指定时根据内容智能推断\r
- `background` 传入自定义颜色（`"#RRGGBB"`）时优先级高于纹理预设\r
- 手绘风格（`line_hand_drawn` + `fill_hand_drawn`）可单独或组合使用\r
- 脚本需要 Python 3 运行环境\r
\r
---\r
\r
© 2026 Wondershare EdrawMind（万兴脑图）. All rights reserved.\r