# Mindmap Generator

> 思维导图生成器 - 从图片或文档快速生成高质量思维导图。 支持图片识别（PNG/JPG/GIF/WebP）和文档分析（TXT/MD/DOCX/PDF）， AI 自动提取结构生成层级清晰的思维导图，同时输出三种格式： PNG图片（易分享）、XMind（可编辑）、Markdown（可修改）。 触发场景：用户上传图片/文档要求生成思维导图、图片转思维导图、 文档转 xmind/图片、帮我做个思维导图等。 必须使用此 skill 的场景（优先级高）： - 用户上传了图片文件（png/jpg/webp等）要求"转成思维导图"、"转成xmind"、"生成脑图" - 用户上传了文档（pdf/docx/md/txt）要求"整理成思维导图"、"提取大纲"、"生成脑图" - 用户说"把这张图转成思维导图"、"这个文档帮我做个xmind" - 用户提到"思维导图" + "图片/文档/文件" - 用户询问"怎么用AI把图片转成思维导图" 不应触发的场景： - 用户只是想"总结文档内容"而不需要生成思维导图文件 - 用户想"画流程图"、"做PPT"、"生成图表" - 纯文本处理任务（如 CSV 转 JSON）

- Skill: `liusai0820/mindmap-generator` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add liusai0820/mindmap-generator`
- Raw SKILL.md: https://api.skillmd.com/api/skills/liusai0820/mindmap-generator/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Data & Analytics
- Author: liusai0820 (https://skillmd.com/u/liusai0820)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/liusai0820/mindmap-generator

---


# 思维导图生成器

从图片或文档快速生成高质量的思维导图（XMind格式）。

## 执行步骤

当用户需要转换图片或文档为思维导图时，按以下步骤执行：

### 1. 确认输入文件
获取用户要处理的文件路径。支持的格式：
- **图片**：PNG, JPG, JPEG, GIF, WebP（Claude 直接分析图片结构）
- **文档**：TXT, MD, DOCX, PDF（读取内容后分析生成层级）

如果用户没指定路径，询问文件位置。

### 2. 了解个性化需求（可选）
询问用户是否有特殊要求，例如：
- 层级深度（如"生成4级结构"）
- 重点关注（如"重点突出技术实现"）
- 组织方式（如"按时间顺序排列"）

### 3. 使用 Claude 生成思维导图内容

**对于图片输入：**
直接分析图片，提取所有层级结构，生成 Markdown 格式的思维导图大纲。

**对于文档输入：**
1. 读取文档内容（必要时使用 document reader 工具处理 DOCX/PDF）
2. 分析文档结构，提取核心主题和子主题
3. 生成层级清晰的 Markdown 大纲

生成 Markdown 时必须遵循：
- 使用 `#` 作为主标题
- 使用 `##`, `###`, `####` 表示层级
- 不要加粗、列表等其他格式
- 结构示例：
```markdown
# 主题标题
## 一级分支
### 二级分支
#### 三级分支
## 另一个一级分支
```

### 4. 转换为 XMind 格式
使用 `markdown_to_xmind()` 函数将 Markdown 转换为 .xmind 文件：

```python
import sys
sys.path.insert(0, '/Users/lius/Code/md2xmind')
from lib.xmind_generator import markdown_to_xmind

markdown_to_xmind(markdown_content, output_path, title)
```

### 5. 报告结果
- 保存 Markdown 文件（.md）
- 保存 XMind 文件（.xmind）
- 告知用户可以用 XMind 软件打开

## 工具函数

### 1. 生成 XMind 文件（可编辑）

```python
import sys
sys.path.insert(0, '/Users/lius/Code/md2xmind')
from lib.xmind_generator import markdown_to_xmind

markdown_to_xmind(
    markdown_content,      # 生成的 Markdown 内容
    "/path/to/output.xmind",  # 输出路径
    "标题"                 # 思维导图标题
)
```

### 2. 生成图片文件（易分享）

```python
import sys
sys.path.insert(0, '/Users/lius/Code/md2xmind')
from lib.markdown_to_image import markdown_to_image
import asyncio

# 生成 PNG 图片（无需 XMind 软件即可查看）
asyncio.run(markdown_to_image(
    markdown_content,      # Markdown 内容
    "/path/to/output.png",  # 输出路径（支持 PNG/JPG）
    "标题"                 # 思维导图标题
))
```

### 3. 完整工作流程（推荐）

同时生成三种格式，让用户按需使用：

```python
import sys
import asyncio
sys.path.insert(0, '/Users/lius/Code/md2xmind')
from lib.xmind_generator import markdown_to_xmind
from lib.markdown_to_image import markdown_to_image

# 假设 markdown_content 已经生成
title = "思维导图标题"
base_path = "/path/to/output"

# 1. 保存 Markdown
with open(f"{base_path}.md", 'w', encoding='utf-8') as f:
    f.write(markdown_content)

# 2. 生成 XMind（可编辑）
markdown_to_xmind(markdown_content, f"{base_path}.xmind", title)

# 3. 生成图片（易分享）
asyncio.run(markdown_to_image(markdown_content, f"{base_path}.png", title))

print(f"✅ 已生成：{base_path}.md / .xmind / .png")
```

## 环境要求

- Python 3.7+
- Claude Code 环境（AI 分析直接使用当前 Claude 会话）
- 图片生成依赖（Playwright）：
  ```bash
  pip install playwright
  playwright install chromium
  ```
- XMind 转换依赖：`/Users/lius/Code/md2xmind/lib/xmind_generator.py`

无需外部 API Key，AI 分析部分直接使用 Claude 本身的能力完成。

## 输出格式

**同时生成三种格式，满足不同场景需求：**

| 格式 | 文件扩展名 | 用途 | 是否需要额外软件 |
|------|-----------|------|-----------------|
| **图片** | `.png` | 快速查看、分享、插入文档 | 无需，任何设备都能打开 |
| **XMind** | `.xmind` | 深度编辑、调整布局 | 需要 XMind 软件 |
| **Markdown** | `.md` | 二次编辑、版本管理 | 文本编辑器即可 |

**建议使用策略：**
- 要**分享/预览** → 使用 PNG 图片
- 要**编辑调整** → 使用 XMind 格式
- 要**修改内容** → 使用 Markdown 格式

## 注意事项

- 图片质量会影响 AI 识别准确度，建议使用清晰、文字可读的图片
- 文档较长时会自动截取前 50000 字符处理
- 需要有效的 OpenRouter API Key
- 生成的文件保存在输入文件所在目录（或指定输出目录）