思维导图生成器

为什么会用到它

把一整篇文档或一个产品方案压缩成思维导图，手工在 XMind 里拖拽既慢又容易在层级上走偏；放到命令行里生成，又常被 shell 引号、特殊字符和 JSON 手写成本绊住。结果往往是：格式对了，结构没人查；结构对了，输出格式又不通用。

它是怎么工作的

核心思路是把结构化输入和渲染彻底分开：

• 先用 Markdown 大纲描述结构：# 一级标题作为中心节点，## 为主分支（行尾可用 [#十六进制] 指定颜色），- 列表按 2 空格缩进嵌套为子节点。也可以省略 #，用 --title 充当中心节点。大纲写进文件，避开 shell 转义问题。
• 再执行一条命令批量生成格式：--format html,png,xmind 等，--output 只需给一个基准路径，其余格式自动换扩展名。
• 主题有两套：--theme midnight（深空）和 --theme paper（纸墨，适合白底打印），HTML 里还有 🌓 按钮随时切换。
• 生成时自动跑一份结构质检报告，按认知负荷、双重编码、渐进分化、MECE、概念图关系等原则给出 ⚠ 警告和改进建议，写在 stderr 里。

生成的交互式 HTML 可直接在浏览器里双击节点改文字，Enter 加兄弟节点、Tab 加子节点，把一个节点拖到另一个节点上改变父子归属，拖中心节点平移全图，右上角切换 8 种布局。节点标签超过 20 字符会自动省略，双击节点可在编辑框中查看并修改完整内容。绑定文件后，在 Chrome/Edge 中每次改动会自动写回 HTML，其它浏览器则回退为另存新文件。

上手前要留意的约束

内容设计上有几条硬规则，违反会被质检报告点名：

• 中心节点写核心洞见，不是话题标签（AI 正从工具变为协作者 优于 AI 发展趋势）。
• 主分支 3–6 个，同级抽象层次一致，每个分支带不重复的 emoji，颜色与语义对应（蓝=机制、绿=成果、橙=问题等），定稿前做 MECE 自检。
• 子节点 2–5 个，概括度从中心到叶子逐层递减，不出现子节点比父节点更宽泛的倒挂。
• 全图 ≤ 40 节点、≤ 4 层、单节点 4–12 字。内容过于复杂时拆成多张图，而不是硬压缩。
• 因果/时序/对比等非从属关系不要硬塞进父子层级，可在措辞中保留关系词，或改用鱼骨图、时间线布局。

技术栈方面：HTML/SVG/XMind 为纯 Python 输出，零系统级 C 库依赖；PNG/JPG/PDF 需要 Pillow，检测到 Playwright 时会优先用它渲染以保留 emoji。Pillow 后备渲染会丢弃彩色 emoji，Linux 下缺 CJK 字体时中文可能变方块，需要先装 fonts-noto-cjk。这些情况脚本都会在 stderr 里给出明确提示，共享或锁定环境可用 --no-auto-install 阻止脚本自动 pip install pillow。