核心用法
该 Skill 是一个基于 Python 的纯本地思维导图生成工具，用户通过构造 JSON 格式的层级数据结构，调用脚本即可生成精美的可视化思维导图。支持 2-4 层节点嵌套，中心主题与分支结构清晰定义，输出格式涵盖 HTML（交互式）、PNG、JPG、SVG、PDF 及 XMind 六种主流格式。
使用流程分为两步：首先将内容整理为规范的 JSON 结构，包含 central 中心主题和 branches 分支数组；然后通过命令行执行 generate_mindmap.py 脚本，指定标题、输出路径、数据内容及目标格式。HTML 格式为默认输出，具备完整的交互功能——支持节点拖拽移位、折叠展开、画布缩放平移，以及浏览器内直接导出其他格式，无需额外依赖即可开箱即用。
对于 PNG/JPG/PDF 等位图或矢量格式，需可选安装 cairosvg 和 Pillow 库，脚本会在依赖缺失时自动提示平台对应的安装命令，引导用户完成配置。
显著优点
零网络依赖与数据安全：该 Skill 完全基于 Python 标准库实现，无 HTTP 请求、无 DNS 查询、无 socket 通信，所有计算与文件生成均在本地完成，彻底杜绝数据外泄风险，特别适合处理敏感商业信息或个人隐私内容。
格式覆盖全面：从可交互的 HTML 到专业软件兼容的 XMind，从网页嵌入的 SVG 到印刷质量的 PDF，再到社交分享的 PNG/JPG，六种格式满足不同场景需求。HTML 格式尤为出色，内置的 JavaScript 交互引擎让用户直接在浏览器中调整布局、导出文件，体验流畅。
跨平台兼容性强：脚本针对 macOS、Linux（Debian/Ubuntu/Fedora/RHEL）及无桌面服务器环境均提供详细的依赖安装指南，自动检测运行环境并适配输出路径，从个人笔记本到云端服务器均可稳定运行。
代码质量与透明度：1,145 行 Python 代码结构清晰、注释完整，无代码混淆、无动态代码加载，安全审计可完全复现，符合生产级工具标准。
潜在缺点与局限性
可选依赖的安装门槛：虽然 HTML/SVG/XMind 格式零依赖，但 PNG/JPG/PDF 导出需要系统级图形库（Cairo、Pango）及 Python 包，macOS 需 Homebrew、Linux 需 apt/dnf，无桌面服务器环境配置相对复杂，对非技术用户存在一定门槛。
节点层级与样式限制：当前设计建议 2-3 层结构，最多支持 4 层嵌套，超深层级可能导致布局拥挤；节点样式（颜色、形状、连线）依赖自动分配或有限的自定义选项，缺乏主题模板系统，视觉统一性需手动调整。
交互功能浏览器依赖：HTML 的拖拽、缩放等交互功能依赖现代浏览器环境，老旧浏览器或禁用 JavaScript 的环境无法正常体验，且生成的 HTML 文件包含内嵌脚本，无法直接嵌入严格的内容安全策略（CSP）网站。
无实时协作与云同步：作为纯本地工具，不支持多人在线编辑、云端自动保存或版本历史管理，团队协作场景下需配合 Git 等版本控制工具使用。
适合的目标群体
知识工作者与学习者：需要快速将阅读笔记、课程大纲、会议纪要与书籍目录转化为可视化结构的人群，思维导图的学习效率提升显著。
内容创作者与讲师：制作课件、撰写博客、准备演讲时，用于生成配图或交互式演示素材，HTML 格式可直接嵌入教学平台。
项目经理与产品团队：梳理需求拆解、功能模块划分、项目里程碑规划，XMind 格式兼容主流项目管理工具链。
技术写作者与开发者：整理 API 文档、系统架构、技术栈选型等结构化内容，SVG/PDF 格式适合插入技术白皮书。
隐私敏感型用户：企业内网环境、涉密数据处理场景，零网络通信特性确保信息不出本地。
使用风险与注意事项
依赖来源验证：安装 cairosvg 和 Pillow 时，建议仅从 PyPI 官方源获取，可通过 --trusted-host 参数限定域名，防范供应链攻击。系统级依赖（Cairo、Pango）务必使用官方包管理器（Homebrew、apt、dnf），避免从第三方渠道下载。
sudo 权限使用：文档中涉及的 sudo 命令仅用于安装系统级图形库，属合法用途，但用户应确认命令来源可信，避免在不明脚本中盲目提权。
输入数据验证：虽然脚本包含 JSON 基础解析与错误处理，但用户构造的恶意数据结构（如极深层级嵌套、超大文本节点）可能导致内存占用过高或渲染异常，建议控制节点数量与文本长度在合理范围。
输出路径权限：脚本默认输出到用户主目录或桌面，在服务器环境需确保目标路径可写，避免因权限不足导致生成失败。
浏览器安全策略：生成的 HTML 文件包含内联 JavaScript 与样式，在企业内网或启用严格 CSP 的环境中可能无法正常渲染，建议根据目标平台调整输出格式选择。