huo15-mind-map（hu15 思维导图）

火一五思维导图技能 v1.0

规范 + 时尚的思维导图生成器 — 青岛火一五信息科技有限公司

一、核心能力

1. 一端多出 — 同一个输入可同时导出：

- .xmind（XMind 2021+ ZIP，含 content.json / metadata.json / manifest.json） - .opml（OPML 2.0，兼容 MindNode / 幕布 / WorkFlowy / Apple Notes） - .mm（FreeMind 格式，兼容 XMind、EdrawMind、亿图图示、幕布） - .md（Markdown outline，方便回写知识库 / 复用） - .png / .pdf / .svg（渲染图，发群/导入幻灯都合适） - .json（内部统一结构，编程复用）

1. 十种风格 — modern / classic / dark / xiaohongshu / ocean / forest / sunset / minimal / pastel / github（中文别名：现代 / 经典 / 暗色 / 小红书 / 海洋 / 森林 / 夕阳 / 极简 / 马卡龙 / 极客）。
2. 多种输入 — Markdown 大纲 / 内部 JSON / OPML / 已有的 XMind 文件都能读；Markdown 支持标题 (#) 与无序/有序列表混排。
3. 中文友好 — 自动选取系统内的 PingFang SC / Microsoft YaHei / Noto Sans CJK 等字体。

二、输入格式

2.1 Markdown 大纲（推荐）

# 火一五产品矩阵              # 第 1 个标题成为根节点

## 核心平台                   # ##  → 一级分支
### 龙虾 OpenClaw             # ### → 二级分支
- 插件体系                    # 缩进列表 → 下一级叶子
- 技能市场
- 场景编排
### 辉火云管家·贾维斯
- 跨应用代理
- 记忆系统

## 行业解决方案
### 机器人企业
- 数字化管家
...

规则：

• 第一个出现的 # 标题升格为根节点；
• 后续 ## ### 依次作为子级；
• - item / * item / 1. item 可接续在标题后面作为更深层级；
• 连续非标题非列表的文本行会挂到当前节点的 note 上，导出 XMind 时会写入 notes.plain.content。

2.2 内部 JSON

{
  "title": "火一五产品矩阵",
  "children": [
    {"title": "核心平台", "children": [
      {"title": "龙虾 OpenClaw"}, {"title": "辉火云管家"}
    ]},
    {"title": "行业解决方案"}
  ]
}

2.3 OPML / XMind 导入

直接喂路径给 --input，用 --input-format opml|xmind 强制解析器。

三、命令行

3.1 基础用法

# 1. 从 Markdown 生成 XMind（默认 modern 风格）
python3 scripts/create-mind-map.py \
  --input outline.md \
  --output /tmp/map.xmind

# 2. 同时导出 PNG + PDF + OPML（基于 --output 的同名文件）
python3 scripts/create-mind-map.py \
  --input outline.md \
  --output /tmp/map.xmind \
  --also png,pdf,opml \
  --style xiaohongshu

# 3. 仅渲染为 PNG，指定分辨率
python3 scripts/create-mind-map.py \
  --input outline.md \
  --output /tmp/map.png \
  --style dark --dpi 300

# 4. 把现有 XMind 转换为 Markdown
python3 scripts/create-mind-map.py \
  --input existing.xmind --input-format xmind \
  --output /tmp/existing.md

# 5. 从 stdin 读 Markdown
cat outline.md | python3 scripts/create-mind-map.py \
  --output /tmp/map.png --style modern

3.2 参数速查

四、Python API

import sys
sys.path.insert(0, 'scripts')

from mindmap_tree import parse_markdown, to_xmind, to_opml, to_json
from mindmap_render import render

with open('outline.md', encoding='utf-8') as fh:
    root = parse_markdown(fh.read())

to_xmind(root, '/tmp/map.xmind')
print(to_opml(root)[:200])
render(root, '/tmp/map.png', style_name='xiaohongshu', dpi=240)

主要 API：

Node 数据结构（可自由增删）：

@dataclass
class Node:
    title: str
    note: str = ''
    children: List[Node] = []

五、风格

风格只影响配色、字号、圆角；结构层级、字体选择是自适应的。

六、与主流软件互通

当甲方拿的是微软 Visio / Miro 这类工具时，直接发 PNG / PDF / SVG 即可。

七、触发词

• 思维导图 / 脑图 / 心智图 / mind map / mindmap
• 画思维导图 / 做思维导图 / 生成思维导图
• 导出 xmind / 生成 xmind / 转 xmind
• outline 转思维导图

八、版本历史

• v1.1.0（当前） — 扩展 6 种预设风格：ocean 海洋蓝 / forest 森林绿 / sunset 夕阳暖橙 / minimal 极简素雅 / pastel 马卡龙粉嫩 / github 极客 GitHub；完善中文别名。

• v1.0.0 — 首版。支持 Markdown/JSON/OPML/XMind 输入；输出 XMind/OPML/FreeMind/Markdown/PNG/PDF/SVG/JSON；内置 modern/classic/dark/xiaohongshu 四风格。

技术支持： 青岛火一五信息科技有限公司