下载地址
https://www.zhengdianxue.com/wp-content/uploads/skills/user_2c769e18--mindmap-designer.zip将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_2c769e18/mindmap-designer。思维导图生成器。基于东尼·博赞(Tony Buzan)思维导图方法论,对知识库内容、网页内容、搜索结果、文档、笔记等进行分析,自动提取层级结构并生成专业思维导图(JPG格式)。v5.0重大升级:彻底打破8个固定模板束缚,采用内容驱动的智能生成引擎,三位一体质量审查体系。 当用户说"生成思维导图""画思维导图""制作mindmap""梳理结构""画框架图""整理为思维导图""做成脑图""总结为mindmap""把XX内容梳理成思维导图""整理成大纲""梳理知识要点"时触发。
也适用于从书籍、文章、报告、PPT等结构化内容提取知识框架。不适用:纯文字问答、数据分析报告生成、8D报告。但PPT可从文件中提取内容制作导图。
阅读全文 (展开查看完整说明)
概述
Mindmap Generator v5.0 — 博赞内容驱动引擎
🎯 核心理念
告别固定模板,让内容决定设计。
v5.0 彻底抛弃了"从8个模板中选一个"的老路,取而代之的是三位一体内容驱动引擎:
内容分析 → 内容设计官(ContentDesigner) → 排版设计官(LayoutDesigner) →
质量审查官(QualityInspector) → v5.0渲染引擎 → 审核通过 → 交付
↓ 未通过
修改 → 重新审查博赞核心原则(已内嵌)
| 原则 | v5.0实现 |
|---|---|
| 🎯 中心图像感 | 中心节点卡片/圆形3D效果,模拟图像吸引力 |
| 🌈 色彩编码 | 同色系聚类:同一分支使用同色系渐变(深→浅) |
| 🌿 有机曲线 | 渐细贝塞尔曲线(起始粗→末端细),模拟手绘 |
| ✏️ 每线一词 | 节点文字精炼原则,检测长句并建议拆分 |
| 🔤 印刷体 | 所有文字使用印刷体(NotoSansCJK) |
| 🎨 至少3色 | 自动生成3-7个分支色的配色方案 |
| 🔗 所有线条连接 | 树状结构强制全连接,无中断 |
| 📏 线长匹配词长 | 节点框自适应文本宽度 |
| ⬜ 充足空白 | 碰撞检测确保间隙,自动缩放 |
📋 完整工作流
Phase 0:内容获取与理解
信息来源判断(同v4.0):
| 用户输入 | 操作 |
|---|---|
| 提及"知识库"、"@知识库名" | search(source="kb", kb_id=...) |
| 提及"笔记"、"我的笔记" | search(source="note") |
| 提及网页链接/URL | fetch(type="url") |
| 提及"上传的文件"、"这个文件" | fetch(type="file_path") 或 file_read |
| 提及"搜索"、"网上查" | search(source="web") |
| 直接描述主题 | search(source="web") 收集信息 |
内容过长时(>5000 tokens),分多次获取。优先获取:目录→各章摘要→各章核心观点。
Phase 1:内容分析与结构提取(内容设计官 ContentDesigner)
用LLM分析内容并构建树状结构。同步调用 ContentDesigner 进行内容质量审核。
1.1 结构提取原则
- 识别核心主题 → 中心节点(不超过15字)
- 提取层级 → 主分支→子分支→三级→叶子(不超过5层)
- 博赞原则:
- 主分支 3-7个 为最佳(最多不超过12个)
- 每个节点 控制在10字以内(教育类可放宽至20字)
- 避免长句和标点符号(表示非关键词)
- 保留关键数据、名词、概念
- 特殊节点标记:
key(★重点)、quiz(⚠误区)、method(💡方法)、formula(∑公式)
1.2 教育增强模式
内容包含"知识/学习/课程/教学/教材/考试/考点/定理/概念/定义"等 → 启用教育增强:
中心主题
├── 知识梳理 [module: knowledge]
│ ├── 知识点模块A
│ │ └── 核心概念 [tag: key]
├── 学法指导 [module: method]
│ ├── 分析方法
│ └── 解题技巧 [tag: method]
├── 总结升华 [module: summary]
│ ├── 学习误区 [tag: quiz]
│ └── 知能提升
└── 公式与难点(可选)
├── 重点公式 [tag: formula]
└── 难点突破 [tag: key]1.3 调用 ContentDesigner 审核
将提取的树状结构传给 ContentDesigner 进行内容质量审核:
from quality.content_designer import ContentDesigner
designer = ContentDesigner()
report = designer.audit_structure(tree_data)
print(designer.generate_content_report(report))审核要点:
- [ ] 中心主题是否合理(不超过30字)
- [ ] 主分支数量是否在3-12范围内
- [ ] 层级是否超过7层
- [ ] 节点文字是否精炼(无长句、无标点)
- [ ] 总节点是否超过100个(需精简或拆分)
如果内容评分 < 60分(D级),必须修改后再进入下一阶段。
1.4 输出结构确认
将结构以树状格式输出给用户确认:
中心主题
├── 主分支1
│ ├── 子分支1.1 → 要点A → 子要点
│ └── 子分支1.2 → 要点B
├── 主分支2
└── 主分支3得到用户确认后再进入下一阶段。
Phase 2:布局与视觉设计(排版设计官 LayoutDesigner)
不再从8个固定模板中选择! 改为调用 LayoutDesigner 根据内容分析报告自动生成布局和视觉配置。
from quality.layout_designer import LayoutDesigner
designer_report = content_report # 来自Phase 1.3
layout_designer = LayoutDesigner()
config = layout_designer.generate_layout_config(designer_report)
print(layout_designer.generate_layout_report(config))2.1 自动布局选择
| 内容特征 | 推荐布局 | 说明 |
|---|---|---|
| 综合内容,3-7个主分支 | radial | 全圆360°放射,标准博赞风格 |
| 教材/学术,>4层深度 | tree_right | 右向树形,适合深度展开 |
| 分支较多(6-10个) | semicircle | 150°半圆,避免全圆拥挤 |
| 教育/笔记类 | mindmap_authentic | 博赞经典:有机曲线+手绘感 |
| 正反对比/双方案 | balanced | 平衡双树,向两侧展开 |
2.2 自动配色生成
不再使用固定色板!LayoutDesigner 根据内容类型自动生成博赞同色系聚类配色方案:
- 每个主分支分配一个基色
- 该分支的所有子节点使用同色系不同明度(深→浅递减)
- 内容类型驱动配色选择:
- 教育学术 →
buzan_classic风格(纯文字无框+有机曲线) - 商业管理 →
modern_clean风格(浅色卡片+干净曲线) - 创意发散 →
vibrant_creative风格(渐变色中心+多彩线) - 综合通用 →
modern_clean风格
- 教育学术 →
2.3 自适应参数
LayoutDesigner 根据节点总数自动调整:
- 节点<10 → 放大(sf=1.15),大字体,宽松间距
- 节点10-25 → 标准(sf=1.0)
- 节点25-40 → 紧凑(sf=0.95)
- 节点40-60 → 更紧凑(sf=0.85)
- 节点>60 → 最紧凑(sf=0.75),小字体
Phase 3:思维导图生成(v5.0渲染引擎)
使用生成的配置,调用 v5.0 渲染引擎生成图片。
3.1 保存JSON数据和配置
import json
# 保存树状数据
with open('/path/to/data.json', 'w', encoding='utf-8') as f:
json.dump(tree_data, f, ensure_ascii=False, indent=2)
# 保存布局配置(由LayoutDesigner生成)
with open('/path/to/config.json', 'w', encoding='utf-8') as f:
json.dump(config, f, ensure_ascii=False, indent=2)3.2 渲染命令(新v5.0方式 — 推荐)
# v5.0 新方式:使用--config参数(由LayoutDesigner生成)
python3 /sandbox/workspace/skills/mindmap-generator/scripts/mindmap_render.py
--json /path/to/data.json
--config /path/to/config.json
--output /path/to/output.jpg
--title "思维导图标题"3.3 兼容旧版(仅用于降级)
# 兼容旧版:使用--style参数(template1-8)
python3 /sandbox/workspace/skills/mindmap-generator/scripts/mindmap_render.py
--json /path/to/data.json
--output /path/to/output.jpg
--title "思维导图标题"
--style template8
--layout radial3.4 布局模式参数
| –layout | 模式 | 适用场景 |
|---|---|---|
radial | 全圆360°放射 | 综合内容(默认) |
semicircle | 150°半圆放射 | 阅读导向,6-10分支 |
tree_right | 右向树形展开 | 深度>4层的内容 |
mindmap_authentic | 博赞经典风格 | 教育/笔记/创意 |
balanced | 平衡双树 | 对比分析 |
Phase 4:质量审查(质量审查官 QualityInspector)
这是v5.0新增的核心环节。 每次生成图片后,必须调用 QualityInspector 进行三维度审查。
from quality.quality_inspector import QualityInspector
inspector = QualityInspector()
report = inspector.inspect(tree_data, config, output_path)
print(inspector.generate_inspection_report(report))
if report["verdict"] != "PASS":
# 分析失败原因,修复后重新生成
fix_suggestions = report["fix_suggestions"]
...4.1 内容质量审查(7项检查)
| 检查项 | 条件 | 失败处理 |
|---|---|---|
| C1 中心主题存在 | center非空且≤30字 | 修改中心主题 |
| C2 主分支数量合理 | 3-12个 | 建议合并/拆分 |
| C3 层级深度合理 | ≤7层 | 压缩层级 |
| C4 总节点数合理 | ≤100个 | 精简或拆分多张 |
| C5 无空节点 | 所有节点有内容 | 补全内容 |
| C6 关键词精炼 | 长句节点≤20% | 精简文字 |
| C7(教育) 模块标记 | 教育内容有module字段 | 添加模块标记 |
4.2 排版质量审查(5项检查)
| 检查项 | 条件 | 失败处理 |
|---|---|---|
| L1 缩放因子 | 0.7-1.5 | 调整内容量 |
| L2 中心字体 | ≥16pt | 检查字体配置 |
| L3 叶子字体 | ≥8pt | 需可读性保障 |
| L4 节点间距 | ≥1.0 | 增大间距/精简内容 |
| L5 配色覆盖 | 配色数≥分支数 | 补充配色方案 |
4.3 视觉质量审查(5项检查)
| 检查项 | 条件 | 失败处理 |
|---|---|---|
| V1 文件存在 | 图片已生成 | 检查渲染脚本 |
| V2 尺寸达标 | ≥800×600 | 调整画布尺寸 |
| V3 内容非空 | 非纯色图像 | 检查数据内容 |
| V4 文件大小 | ≤20MB | 检查分辨率 |
| V5 比例合理 | ≤3:1 | 调整布局参数 |
4.4 判定标准
- PASS:通过率≥70% 且 无错误 → 可以交付
- NEEDS_IMPROVEMENT:通过率<70% 或 有错误 → 必须修复
Phase 5:交付
审核通过后,提供下载链接:
📊 您的思维导图已生成(已通过三位一体质量审查✅)关于"生成3个版本供选择"的要求:v5.0不再强制生成3个固定模板版本。而是生成最佳版本(由LayoutDesigner根据内容自动确定),但如果用户明确要求风格对比,可以生成2个版本(主风格+黑白简约文字型作为对比)。
📁 技能文件结构
skills/mindmap-generator/
├── SKILL.md # 本说明文件
├── quality/
│ ├── __init__.py # 模块入口
│ ├── content_designer.py # 内容设计官:内容结构化审核
│ ├── layout_designer.py # 排版设计官:布局+视觉配置生成
│ └── quality_inspector.py # 质量审查官:最终三维度审查
├── scripts/
│ └── mindmap_render.py # v5.0 渲染引擎(兼容旧版模板)
├── references/
│ └── template_styles.md # [旧版参考] 模板样式(保留完整性)
└── assets/templates/ # [旧版参考] 模板图片(保留完整性)调用链路总览
用户输入 → Phase 1: 内容获取 → LLM结构提取
↓
ContentDesigner审核 ← [未通过↺修改]
↓
LayoutDesigner生成配置
↓
mindmap_render.py渲染
↓
QualityInspector审查 ← [未通过↺修复]
↓
[PASS] → 交付用户📐 v5.0 JSON数据格式
{
"center": "中心主题",
"children": [
{
"name": "主分支1",
"color": "#E74C3C",
"module": "", // 教育:knowledge/method/summary
"children": [
{
"name": "子分支1.1",
"tag": "key", // key/quiz/method/formula
"children": [
{"name": "叶子1.1.1"}
]
}
]
}
],
"connections": [
{"from": ["主分支1", "子分支1.1"], "to": ["主分支2", "子分支2.1"],
"style": "dashed", "label": "关联说明"}
],
"formulas": [
{"id": "f1", "text": "E=mc^2"}
]
}🎯 与v4.0的关键区别
| 维度 | v4.0 (旧) | v5.0 (新) |
|---|---|---|
| 模板 | 8个固定模板硬编码 | 内容驱动风格生成,无固定模板 |
| 布局 | 仅辐射树形 | 全圆/半圆/树形/博赞经典/平衡双树 |
| 配色 | 预设色板 | 同色系聚类渐变(博赞原则) |
| 曲线 | 标准贝塞尔 | 渐细贝塞尔(从粗到细) |
| 质量 | 手动检查清单 | 三位一体自动审查体系 |
| 教育 | 仅模板8支持 | 内嵌到所有布局+自动检测 |
| 渲染 | DPI 130 | DPI 150,更高分辨率 |
| 字体 | 固定缩放 | 自适应内容密度 |
| 风格数 | 每次3个版本 | 1个最优版本(可要求对比) |
🧪 测试与验证
生成后应验证:
- 图片文件存在且非空
- 所有文本节点已渲染
- 无节点重叠(可接受少量<5%)
- 颜色对比度足够
- 博赞风格要素已体现(如启用)
📋 v5.1 修复日志(2026-06-19)
基于端午思维导图实际生成后的质量审查发现问题并修复如下:
| # | 问题 | 根因 | 修复内容 | 严重度 |
|---|---|---|---|---|
| 1 | 节点填充色过淡 | lighten(color, 0.72) 过度提亮,导致填充接近白色 | 改为 lighten(color, 0.35)(主分支),后三级依次0.45/0.55/0.65 | 🔴 |
| 2 | 中心节点不醒目 | 白色背景+细边框+彩色文字,视觉权重不足 | 改为深色填充+白色文字,卡片加大(14→18),双层阴影,3px粗边框 | 🔴 |
| 3 | 渐细曲线未启用 | renderer只检查tapered_curve但LayoutDesigner输出colorful_tapered | renderer新增接收colorful_tapered和buzan_tapered两种线型名 | 🟡 |
| 4 | 节点边框过细 | 边框线宽0.8,在浅色填充上不明显 | 加粗至1.5,增加外阴影提升立体感,移除alpha参数减轻透明度 | 🟡 |
| 5 | 画布空白过多 | 初始xlim/ylim使用1.6倍外扩,padding使用1.15倍 | 收窄至1.3倍外扩和1.1倍padding | 🟢 |
| 6 | 主分支连线偏细 | 连线alpha透明度0.6,视觉权重不足 | 线宽基值保持3.0,透明度提高至0.8,末端收缩至0.25倍 | 🟢 |
修复效果量化对比
| 指标 | 修复前(v5.0) | 修复后(v5.1) | 改善 |
|---|---|---|---|
| 深色内容占比(0-100) | 2.2% | 4.5% | ↑2.3x |
| 中深色占比(100-180) | 2.5% | 8.3% | ↑3.3x |
| 浅色占比(230-255) | 86.8% | 84.7% | ↓(内容更密集) |
| 内容密度 | 14.0% | 16.7% | ↑19% |
| 文字对比度(WCAG) | ~60% | 80% | 达标✅ |
| 中心节点样式 | 浅底+粉字(近隐形) | 深底+白字(醒目) | 完全改善 |
| 填充色可见度 | RGB(247,202,223)近白 | RGB(226,109,100)亮粉 | 真正可见 |
| 渐细曲线 | 未启用 | colorful_tapered启用 | 已修复 |