# Smart Mind Map（智能思维导图）

<span class="category-badge action">Action</span>
<span class="version-badge">v1.0.0</span>

智能分析文本内容，生成交互式思维导图，帮助你更直观地理解信息结构。

> 🏆 **OpenWebUI 官方推荐** — 获得 OpenWebUI 社区 Newsletter 官方推荐：[2026 年 2 月 3 日](https://openwebui.com/blog/open-webui-community-newsletter-february-3rd-2026)

---

## 概览

Smart Mind Map 会将文本转换成漂亮的交互式思维导图。插件会用 AI 分析内容结构，生成层级化的可视化，帮助快速梳理复杂信息。

## 功能特性

- :material-brain: **LLM 分析**：可配置模型，提取核心概念与层级
- :material-gesture-swipe: **丰富控制**：缩放/重置、展开层级（全部/2/3 级）与全屏
- :material-palette: **主题感知**：自动检测 OpenWebUI 亮/暗色主题并支持手动切换
- :material-download: **一键导出**：下载高分辨率 PNG、复制 SVG 或 Markdown
- :material-translate: **内置 i18n 语言识别**：单个文件自动检测控制台前端语言，无需繁杂的各种语言包版本。
- :material-arrow-all: **直出全屏版体验 (需配置开启)**：新版直出渲染抛开沙盒限制，纵情铺满屏幕，享受原生的图表体验。

---

## 安装

1. 下载插件文件：[`smart_mind_map.py`](https://github.com/Fu-Jie/openwebui-extensions/tree/main/plugins/actions/smart-mind-map)
2. 上传到 OpenWebUI：**Admin Panel** → **Settings** → **Functions**（Actions）
3. 启用插件，并可在设置中允许 iframe same-origin 以启用主题自动检测

---

## 使用方法

1. 在聊天设置中启用 **Smart Mind Map**，提供不少于约 100 字符的文本
2. 点击消息操作栏中的 **Mind Map** 动作按钮触发生成
3. 交互使用：
   - **缩放与重置**：滚轮或使用 + / - / ↻ 控制
   - **展开层级**：切换“全部 / 2 级 / 3 级”
   - **主题与全屏**：手动切换亮/暗色或进入全屏
4. 一键导出：**PNG**、**复制 SVG**、**复制 Markdown**

---

## 配置项

| 选项 | 类型 | 默认值 | 说明 |
|--------|------|---------|-------------|
| `SHOW_STATUS` | boolean | `true` | 是否在聊天中显示状态更新 |
| `MODEL_ID` | string | `""` | 内置 LLM 模型 ID（留空使用当前聊天模型） |
| `MIN_TEXT_LENGTH` | integer | `100` | 开始分析所需的最少字符数 |
| `CLEAR_PREVIOUS_HTML` | boolean | `false` | 生成新导图时是否清除之前的插件 HTML |
| `MESSAGE_COUNT` | integer | `1` | 用于生成的最近消息数量（1–5） |
| `ENABLE_DIRECT_EMBED_MODE` | boolean | `false` | 是否开启沉浸式直出模式 (需要 Open WebUI 0.8.0+ ) |

---

## 输出示例

插件会在聊天中嵌入交互式 HTML 思维导图：

```
📊 Mind Map Generated
├── Main Topic
│   ├── Subtopic 1
│   │   ├── Detail A
│   │   └── Detail B
│   ├── Subtopic 2
│   └── Subtopic 3
└── Related Concepts
```

---

## 运行要求

!!! note "前置条件"
    - OpenWebUI v0.3.0 及以上
    - 无需额外 Python 依赖
    - 如需自动匹配主题/提高 PNG 导出准确性，请在 **User Settings → Interface → Artifacts** 中允许 iframe same-origin 访问

---

## 常见问题

??? question "思维导图不显示？"
    - 确认输入文本达到 `MIN_TEXT_LENGTH`
    - 确保已配置可用的 `MODEL_ID`（或留空使用当前模型）
    - 启用插件后刷新页面再试

??? question "主题不匹配或 PNG 为空白？"
    - 在设置中开启 iframe same-origin 以读取父页面主题
    - 等待导图完全渲染后再导出

---

## 源码

[:fontawesome-brands-github: 在 GitHub 查看](https://github.com/Fu-Jie/openwebui-extensions/tree/main/plugins/actions/smart-mind-map){ .md-button }
