| name | knowledge-mindmap |
| description | 自动分析知识点目录结构，生成 Excalidraw 格式的详细思维导图。适用于考研数学、专业课等知识体系的可视化整理。触发词包括"知识点思维导图"、"生成思维导图"、"知识结构图"、"目录结构图"。 |
| metadata | {"version":"2.1.0"} |
Knowledge Mindmap Generator v2.1
自动分析知识点目录结构，生成 Excalidraw 格式的详细思维导图。
v2.1 新特性（最新）
- 按序号顺时针排列：节点位置严格按照模块序号顺序顺时针排列，而非随机分布
- 序号识别算法：自动从文件夹名提取序号（如
0-数列的概念 → 0）
- 角度计算优化：从顶部（-90°）开始按序号顺时针分布各节点
v2.0 新特性
- 智能布局算法：根据模块数量自动分布，避免重叠
- 多格式导入：支持 Markdown 层级列表、JSON 笔记、Excel 表格
- 图形丰富性：圆角、阴影、图标区分模块类型
- 交互性增强：超链接到笔记原文，点击即可跳转
- 自动分层折叠：模块过多时生成折叠结构
使用方法
基本用法
/knowledge-mindmap [目录路径]
高级选项
/knowledge-mindmap [目录路径] --format=[simple|detailed|folded]
/knowledge-mindmap [目录路径] --style=[compact|expanded|tree]
/knowledge-mindmap [目录路径] --max-modules=[数字]
| 参数 | 说明 | 默认值 |
|---|
--format | 输出格式：simple（简洁）/ detailed（详细）/ folded（折叠） | detailed |
--style | 布局样式：compact（紧凑）/ expanded（展开）/ tree（树形） | expanded |
--max-modules | 折叠模式下核心模块最大数量 | 5 |
工作流程
1. 目录探索阶段
用户指定目录
↓
探索目录结构
↓
识别知识点模块
↓
提取核心内容
自动识别的关键文件：
📑 索引.md - 模块总索引📊 学习进度.md - 学习进度追踪📝 章节总结.md - 全章总结README.md - 模块说明- 各知识点笔记文件
2. 内容分析阶段
从笔记中提取：
- 模块标题和星级（⭐⭐⭐⭐⭐）
- 核心概念和定义
- 重要定理和公式
- 解题方法和技巧
- 易错点和注意事项
3. 智能布局阶段
布局算法流程：
分析模块数量和层级
↓
提取模块序号并排序
↓
选择最优布局模板
↓
按序号顺时针计算各模块坐标
↓
自动调整避免重叠
↓
生成连接线
智能布局算法
模块序号识别与排序
核心原则：节点位置按照模块序号顺序顺时针排列，而非随机分布。
def extract_module_number(folder_name):
"""从文件夹名提取序号
示例: "0-数列的概念" → 0
"1-用定义" → 1
"7-收敛速度问题" → 7
"""
import re
match = re.match(r'(\d+)-', folder_name)
return int(match.group(1)) if match else 999
sorted_modules = sorted(modules, key=lambda m: extract_module_number(m['name']))
模块数量自适应
| 模块数量 | 布局策略 | 画布尺寸 |
|---|
| 1-3 个 | 线性布局 | 800×400 |
| 4-6 个 | 放射状布局 | 1000×600 |
| 7-10 个 | 环形布局 | 1200×800 |
| 11+ 个 | 分层折叠 | 1400×900 |
坐标计算公式（按序号顺时针）
放射状布局（4-6 个模块）- 顺时针排列：
中心坐标: (canvasWidth/2, canvasHeight/2)
模块角度: 360° / 模块数量
模块距离: min(canvasWidth, canvasHeight) * 0.35
# 按序号排序后，从顶部（-90°）开始顺时针排列
模块i坐标（i为排序后的序号，从0开始）:
angle_degrees = -90° + (360° / 模块数量) * i
angle_radians = angle_degrees * π / 180
x = centerX + distance * cos(angle_radians)
y = centerY + distance * sin(angle_radians)
示例：4个模块（0,1,2,3）
模块0: -90° (顶部)
模块1: 0° (右侧)
模块2: 90° (底部)
模块3: 180° (左侧)
环形布局（7-10 个模块）- 顺时针排列：
内环（核心模块）: 距离中心 150px
外环（普通模块）: 距离中心 300px
辅助系统: 底部独立区域
# 从顶部开始按序号顺时针排列各模块
角度起始: -90°（12点钟方向）
角度间隔: 360° / 模块数量
排序后依次放置
示例：数列极限（8个模块 0-7）
模块0: -90° → 顶部
模块1: -45° → 右上
模块2: 0° → 右侧
模块3: 45° → 右下
模块4: 90° → 底部
模块5: 135° → 左下
模块6: 180° → 左侧
模块7: 225° → 左上
避免重叠检测
def check_overlap(box1, box2, margin=20):
"""检测两个矩形是否重叠，margin 为安全间距"""
return not (
box1.x + box1.width + margin < box2.x or
box2.x + box2.width + margin < box1.x or
box1.y + box1.height + margin < box2.y or
box2.y + box2.height + margin < box1.y
)
def adjust_position(box, others, step=10, max_attempts=50):
"""自动调整位置避免重叠"""
for _ in range(max_attempts):
if all(not check_overlap(box, other) for other in others):
return box
box.x += step
return box
多格式导入支持
1. Markdown 层级列表
输入格式：
- 数列极限
- 0-数列的概念
- 数列定义
- 子列概念
- 2-用性质 ⭐⭐⭐⭐⭐
- 唯一性
- 有界性
- 保号性
解析规则：
- 缩进表示层级关系
⭐⭐⭐⭐⭐ 标记核心模块- 子项自动成为模块内容
2. JSON 笔记格式
输入格式：
{
"title": "数列极限",
"modules": [
{
"id": "module-1",
"title": "用性质",
"level": 5,
"content": ["唯一性", "有界性", "保号性"],
"file": "2-用性质/README.md"
}
]
}
3. Excel 表格格式
| 列名 | 说明 | 必填 |
|---|
| 模块ID | 唯一标识 | 是 |
| 模块名称 | 显示标题 | 是 |
| 层级 | 1-5星 | 否 |
| 内容 | 分号分隔 | 否 |
| 链接 | 笔记路径 | 否 |
图形丰富性
模块类型图标
| 类型 | 图标 | 颜色 | 用途 |
|---|
| 定义 | 📖 | #3b82f6 | 概念、定义类 |
| 定理 | 📐 | #8b5cf6 | 定理、性质类 |
| 方法 | 🔧 | #f59e0b | 解题方法类 |
| 公式 | 📝 | #10b981 | 重要公式类 |
| 易错 | ⚠️ | #ef4444 | 易错点提醒 |
| 核心 | ⭐ | #f59e0b | 五星重点 |
视觉样式
{
"核心模块": {
"strokeWidth": 3,
"strokeColor": "#f59e0b",
"backgroundColor": "#fef3c7",
"roundness": {"type": 3},
"shadow": true
},
"普通模块": {
"strokeWidth": 2,
"strokeColor": "#3b82f6",
"backgroundColor": "#eff6ff",
"roundness": {"type": 3},
"shadow": false
},
圆角设置
{
"roundness": {"type": 3}
}
交互性增强
超链接功能
为每个模块添加指向原笔记的链接：
{
"id": "box-2",
"type": "rectangle",
"link": "2-用性质/README.md",
...
}
链接格式：
- 相对路径：
2-用性质/README.md
- Wiki链接：
[[2-用性质/README]]
- 外部链接：
https://...
点击跳转
用户在 Excalidraw 视图中点击模块时：
- 自动打开对应的笔记文件
- 或跳转到指定章节
实现 JSON
{
"id": "module-properties",
"type": "rectangle",
"x": 520,
"y": 50,
"width": 200,
"height": 200,
"link": "obsidian://open?vault=考研复习&file=考研数学/高数-数列极限/2-用性质/README",
"strokeColor": "#f59e0b",
...
}
自动分层折叠
折叠策略
当模块数量超过阈值（默认10个）时：
- 识别核心模块：根据星级和重要性
- 折叠次要模块：归入"更多..."折叠区
- 保留辅助系统：始终显示在底部
折叠模式布局
[核心模块1]
↑
[核心模块2] ←← [中心主题] →→ [核心模块3]
↓
[更多模块...] ← 点击展开
↓
[辅助系统]
展开后的子图
[更多模块]
├── 模块4: 四则运算
├── 模块5: 收敛速度
└── 模块6: 压缩映射
JSON 实现
{
"id": "folded-group",
"type": "rectangle",
"x": 500,
"y": 600,
"width": 200,
"height": 80,
"strokeColor": "#9ca3af",
"strokeStyle": "dashed",
"text": "更多模块（点击展开）\n+4 个模块",
"link": "#expanded-view"
}
输出格式
Obsidian Excalidraw 格式
---
excalidraw-plugin: parsed
tags: [excalidraw, mindmap]
---
==⚠ Switch to EXCALIDRAW VIEW in the MORE OPTIONS menu of this document. ⚠==
# Excalidraw Data
## Text Elements
%%
## Drawing
\`\`\`json
{
"type": "excalidraw",
"version": 2,
"source": "https://github.com/zsviczian/obsidian-excalidraw-plugin",
"elements": [...],
"appState": {
"gridSize": null,
"viewBackgroundColor": "#ffffff"
},
"files": {}
}
\`\`\`
%%
设计规范
颜色编码
| 元素类型 | 边框颜色 | 背景颜色 | 用途 |
|---|
| 中心节点 | #1e40af | #dbeafe | 椭圆形，主题核心 |
| 五星模块 | #f59e0b | #fef3c7 | 核心考点，粗边框 |
| 四星模块 | #8b5cf6 | #f3e8ff | 重要内容 |
| 普通模块 | #3b82f6 | #eff6ff | 基础知识点 |
| 辅助系统 | #9ca3af | #f3f4f6 | 虚线边框 |
| 折叠区 | #6b7280 | #f9fafb | 可展开区域 |
尺寸规范
| 模块类型 | 宽度 | 高度 | 字体大小 |
|---|
| 中心节点 | 300-400px | 120-140px | 28-32px |
| 五星模块 | 200-240px | 200-280px | 15px |
| 普通模块 | 200-260px | 150-200px | 15px |
| 辅助系统 | 500-620px | 180-200px | 14px |
| 折叠区 | 200px | 80px | 14px |
JSON 元素模板
带链接的核心模块
{
"id": "star-module-1",
"type": "rectangle",
"x": 300,
"y": 20,
"width": 240,
"height": 280,
"angle": 0,
"strokeColor": "#f59e0b",
"backgroundColor": "#fef3c7",
"fillStyle": "solid",
"strokeWidth": 3,
"strokeStyle": "solid",
"roughness": 1,
"opacity": 100,
"groupIds": [
带图标的文本
{
"id": "text-star-1",
"type": "text",
"x": 320,
"y": 30,
"width": 200,
"height": 260,
"angle": 0,
"strokeColor": "#1e40af",
"backgroundColor": "transparent",
"fillStyle": "solid",
"strokeWidth": 2,
"strokeStyle": "solid",
"roughness": 1,
"opacity": 100,
"groupIds": [
智能连接线
{
"id": "arrow-smart-1",
"type": "arrow",
"x": 600,
"y": 300,
"width": 150,
"height": 180,
"angle": 0,
"strokeColor": "#f59e0b",
"backgroundColor": "transparent",
"fillStyle": "solid",
"strokeWidth": 2,
"strokeStyle": "solid",
"roughness": 1,
"opacity": 100,
"groupIds": [
文本处理规则
字符替换
文本格式
模块标题
⭐⭐⭐⭐⭐ (如有)
• 要点1
- 子要点
• 要点2
• 要点3
字体规范
- 字体家族：
fontFamily: 5（Excalifont）
- 行高：
lineHeight: 1.25
- 对齐方式：
textAlign: "left", verticalAlign: "top"
自动保存流程
1. 生成文件名
格式：{主题名称}.思维导图.md
示例：
数列极限.思维导图.md函数极限与连续.思维导图.md
2. 保存位置
保存到用户指定的目录，或当前工作目录。
3. 用户反馈
生成完成后报告：
- 文件保存位置（可点击跳转）
- 如何在 Obsidian 中查看
- 思维导图结构概览
- 点击模块可跳转到原笔记
常见问题排查
JSON 语法错误
问题：思维导图无法显示，提示解析错误。
检查项：
- 确保所有字符串值正确引用
- 检查是否有未闭合的括号
- 确保数值类型没有多余引号（如
"x": 730" 应为 "x": 730）
- 检查
points 数组格式是否正确
布局问题
问题：元素重叠或位置不当。
解决方案：
- 使用智能布局算法自动调整
- 设置
--style=compact 紧凑布局
- 减少显示的模块数量
链接不工作
问题：点击模块无法跳转。
检查项：
- 确保
link 字段使用正确的 Obsidian URI 格式
- 检查文件路径是否正确
- 确保 vault 名称匹配
示例输出
思维导图已生成！
保存位置：[[考研数学/高数-数列极限/数列极限.思维导图.md]]
使用方法：
1. 在 Obsidian 中打开此文件
2. 按 Ctrl+E（Mac: Cmd+E）切换到阅读模式
3. 点击任意模块可跳转到原笔记
结构概览：
- 中心主题：数列极限
- 核心模块（⭐⭐⭐⭐⭐）：用性质、海涅定理、夹逼准则、单调有界
- 基础模块：数列概念、定义、四则运算、收敛速度
- 辅助系统：索引、进度、总结、错题本
交互功能：
✓ 点击模块跳转到原笔记
✓ 五星模块金色高亮
✓ 智能布局避免重叠
注意事项
- JSON 语法严格：确保 JSON 格式完全正确，任何语法错误都会导致解析失败
- 坐标系统：左上角为原点 (0,0)，x 向右增大，y 向下增大
- 元素 ID 唯一：每个元素必须有唯一的
id
- 文本长度：避免单个文本元素过长，适当分行
- 星级标注：保留原有的星级标注（⭐），便于识别重点
- 链接格式：使用 Obsidian URI 格式确保跳转功能正常
- 模块数量：超过10个模块建议使用折叠模式
