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 时必须遵循：

• 使用 # 作为主标题
• 使用 ##, ###, #### 表示层级
• 不要加粗、列表等其他格式
• 结构示例：

# 主题标题
## 一级分支
### 二级分支
#### 三级分支
## 另一个一级分支

4. 转换为 XMind 格式

使用 markdown_to_xmind() 函数将 Markdown 转换为 .xmind 文件：

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 文件（可编辑）

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. 生成图片文件（易分享）

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. 完整工作流程（推荐）

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

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）：

  pip install playwright
  playwright install chromium
  

• XMind 转换依赖：/Users/lius/Code/md2xmind/lib/xmind_generator.py

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

输出格式

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

建议使用策略：

• 要分享/预览 → 使用 PNG 图片
• 要编辑调整 → 使用 XMind 格式
• 要修改内容 → 使用 Markdown 格式

注意事项

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