火一五思维导图技能 v1.0
规范 + 时尚的思维导图生成器 — 青岛火一五信息科技有限公司
一、核心能力
- 一端多出 — 同一个输入可同时导出：
.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（内部统一结构，编程复用）
- 十种风格 —
modern / classic / dark / xiaohongshu / ocean / forest / sunset / minimal / pastel / github（中文别名：现代 / 经典 / 暗色 / 小红书 / 海洋 / 森林 / 夕阳 / 极简 / 马卡龙 / 极客）。
- 多种输入 — Markdown 大纲 / 内部 JSON / OPML / 已有的 XMind 文件都能读；Markdown 支持标题 (#) 与无序/有序列表混排。
- 中文友好 — 自动选取系统内的 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 参数速查
| 参数 | 说明 |
|---|
--input / -i | 输入文件路径（md / json / opml / xmind） |
--input-text | 直接传 Markdown / JSON / OPML 字符串 |
--input-format | auto (默认) / markdown / json / opml / xmind |
--output / -o | 主输出路径；扩展名决定格式 |
--also | 逗号分隔的额外格式（基于 --output 同名） |
--style | modern / classic / dark / xiaohongshu / ocean / forest / sunset / minimal / pastel / github（默认 modern，支持中文别名） |
--dpi | PNG 分辨率（默认 200） |
--sheet-name | XMind sheet 名称（默认用根节点标题） |
--title | 手动覆盖根节点标题 |
四、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：
| 函数 | 说明 |
|---|
parse_markdown(text) → Node | Markdown outline → 树 |
parse_json(text) → Node | 内部 JSON → 树 |
parse_opml(text) → Node | OPML 2.0 → 树 |
parse_xmind(path) → Node | XMind 2021+ → 树 |
to_xmind(root, path) | 写 XMind |
to_opml(root) → str | OPML 字符串 |
to_markdown(root) → str | Markdown 字符串 |
to_freemind(root) → str | FreeMind .mm 字符串 |
to_json(root) → str | 内部 JSON |
render(root, path, style_name, dpi) | 渲染 PNG/PDF/SVG |
Node 数据结构（可自由增删）：
@dataclass
class Node:
title: str
note: str = ''
children: List[Node] = []
五、风格
| key | 名称 | 背景 | 主色 | 适用场景 |
|---|
modern（默认） | 现代商务 | 白底 #FFFFFF | 深蓝灰 #2C3E50 | 对外汇报、产品方案 |
classic | 经典稳重 | 浅灰 #FAFAFA | 靛蓝 #374785 | 正式文档、技术白皮书 |
dark | 暗色霓虹 | 深蓝 #0F172A | 亮蓝 #38BDF8 | 大屏演示、暗色幻灯 |
xiaohongshu (xhs, 小红书) | 小红书暖奶油 | 奶油 #FFF8F3 | 小红书红 #FF2442 | 营销帖、品牌故事 |
ocean (海洋, 蓝) | 海洋蓝 | 冰蓝 #F8FBFE | 深蓝 #0077B6 | SaaS 产品、技术架构 |
forest (森林, 绿, 自然) | 森林绿 | 米白 #F7FAF8 | 墨绿 #2D6A4F | 环保、农业、健康 |
sunset (夕阳, 暖橙, 橙) | 夕阳暖橙 | 奶杏 #FFFBF5 | 赤橙 #E76F51 | 运营活动、温暖叙事 |
minimal (极简, 素雅, 学术) | 极简素雅 | 纯白 #FFFFFF | 近黑 #2E2E2E | 学术论文、出版物 |
pastel (马卡龙, 粉, 儿童) | 马卡龙粉嫩 | 粉白 #FFFBFC | 天蓝 #B5D8FA | 儿童教育、女性向 |
github (极客, 程序员) | 极客 GitHub | 纯白 #FFFFFF | 深灰 #24292E | 开源文档、README |
风格只影响配色、字号、圆角；结构层级、字体选择是自适应的。
六、与主流软件互通
| 软件 | 导入方式 |
|---|
| XMind | 直接打开 .xmind（2021+ 格式）或导入 .opml / .mm |
| MindNode / MindMeister | 导入 .opml |
| 幕布 / WorkFlowy / Notion | 粘贴 .md，或导入 .opml |
| EdrawMind / 亿图图示 | 导入 .xmind / .mm |
| Apple Notes / Outlook | 粘贴 .md |
当甲方拿的是微软 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 四风格。
技术支持： 青岛火一五信息科技有限公司
