火一五思维导图技能 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（内部统一结构，编程复用）
2. 十种风格 — modern / classic / dark / xiaohongshu / ocean / forest / sunset / minimal / pastel / github（中文别名：现代 / 经典 / 暗色 / 小红书 / 海洋 / 森林 / 夕阳 / 极简 / 马卡龙 / 极客）。
3. 多种输入 — Markdown 大纲 / 内部 JSON / OPML / 已有的 XMind 文件都能读；Markdown 支持标题 (#) 与无序/有序列表混排。
4. 中文友好 — 自动选取系统内的 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 四风格。

---

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