核心用法
mindmap 是一款本地运行的思维导图生成技能，通过 Python 脚本将结构化 JSON 数据转换为可视化图表。用户仅需提供中心主题与分支层级结构（支持 2-4 层嵌套），即可一键生成专业级思维导图。
执行流程：
1. 环境检测：自动检查 Python 3.8+ 及 cairosvg 依赖状态
2. 依赖安装：按平台（macOS brew / Linux apt/dnf）输出精确安装命令，首次使用引导清晰
3. 数据构造：采用标准 JSON 格式描述层级关系，支持自定义分支颜色
4. 多格式导出：HTML（默认，交互式）、PNG/JPG/PDF（需 Cairo 库）、SVG/XMind（零依赖）
显著优点
- 交互体验优秀：HTML 版本支持节点拖拽、画布缩放平移、折叠展开、实时导出，媲美专业软件
- 格式覆盖全面：6 种导出格式满足分享（PNG/PDF）、编辑（XMind）、嵌入（SVG）全场景
- 平台适配智能：自动识别 macOS/Linux 桌面/服务器环境，智能选择输出路径
- 零依赖轻量化：HTML/SVG/XMind 三格式无需任何系统库，开箱即用
潜在局限
- 图形格式依赖外部库：PNG/JPG/PDF 需 Cairo/Pango 等系统级图形库，首次配置门槛较高
- 层级深度限制：建议 2-3 层，4 层以上节点密集时自动布局效果下降
- 无实时协作：纯本地运行，不支持云端同步或多人编辑
- 样式定制有限：主题颜色、字体、连线样式等暂不支持自定义参数
适合人群
- 需要快速将文章/笔记结构化的知识工作者
- 偏好本地工具、注重数据隐私的技术用户
- 教育工作者制作课程大纲、产品经理梳理需求场景
常规风险
- 依赖安装风险：Linux 平台
--break-system-packages可能污染系统 Python 环境，建议配合虚拟环境使用 - 路径解析差异：Windows 路径（
%USERPROFILE%）虽文档提及但未在示例中验证，跨平台一致性存疑 - 长文本截断：节点文字建议 4-10 字，超长内容无自动换行策略，可能导致布局溢出
- 浏览器兼容性：HTML 交互功能依赖现代浏览器 API，旧版浏览器可能功能降级