diff --git a/docs/examples/action_plugin_smart_mind_map_example_cn.md b/docs/examples/action_plugin_smart_mind_map_example_cn.md
index 8908684..fdfc1e7 100644
--- a/docs/examples/action_plugin_smart_mind_map_example_cn.md
+++ b/docs/examples/action_plugin_smart_mind_map_example_cn.md
@@ -27,7 +27,7 @@ Open WebUI 通过文件顶部的特定格式注释来识别和展示插件信息
"""
title: 思维导图
icon_url: data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIyNCIgaGVpZ2h0PSIyNCIgdmlld0JveD0iMCAwIDI0IDI0IiBmaWxsPSJub25lIiBzdHJva2U9ImN1cnJlbnRDb2xvciIgc3Ryb2tlLXdpZHRoPSIxLjUiIHN0cm9rZS1saW5lY2FwPSJyb3VuZCIgc3Ryb2tlLWxpbmVqb2luPSJyb3VuZCI+CiAgPGNpcmNsZSBjeD0iMTIiIGN5PSIxMiIgcj0iMyIgZmlsbD0iY3VycmVudENvbG9yIi8+CiAgPGxpbmUgeDE9IjEyIiB5MT0iOSIgeDI9IjEyIiB5Mj0iNCIvPgogIDxjaXJjbGUgY3g9IjEyIiBjeT0iMyIgcj0iMS41Ii8+CiAgPGxpbmUgeDE9IjEyIiB5MT0iMTUiIHgyPSIxMiIgeTI9IjIwIi8+CiAgPGNpcmNsZSBjeD0iMTIiIGN5PSIyMSIgcj0iMS41Ii8+CiAgPGxpbmUgeDE9IjkiIHkxPSIxMiIgeDI9IjQiIHkyPSIxMiIvPgogIDxjaXJjbGUgY3g9IjMiIGN5PSIxMiIgcj0iMS41Ii8+CiAgPGxpbmUgeDE9IjE1IiB5MT0iMTIiIHgyPSIyMCIgeTI9IjEyIi8+CiAgPGNpcmNsZSBjeD0iMjEiIGN5PSIxMiIgcj0iMS41Ii8+CiAgPGxpbmUgeDE9IjEwLjUiIHkxPSྡ1LjUiIHgyPSI2IiB5Mj0iNiIvPgogIDxjaXJjbGUgY3g9IjUiIGN5PSI1Iigcj0iMS41Ii8+CiAgPGxpbmUgeDE9IjEzLjUiIHkxPSྡ5LjUgeDI9IjE1IiB5Mj0iNiIvPgogIDxjaXJjbGUgY3g9IjE5IiBjeT0iNSIgcj0iMS41Ii8+CiAgPGxpbmUgeDE9ྡ1LjUgeTE9ྡ3MuNSB4Mj0iNiIgeTI9IjE4Ii8+CiAgPGNpcmNsZSBjeD0iNSIgY3k9IjE5IiByPSྡ1LjUiLz4KICA8bGluZSB4MT0ྡzIuNSB5MT0ྡzIuNSB4Mj0iNSIgeTI9IjE4Ii8+CiAgPGNpcmNsZSBjeD0ྡ5IiBjeT0ྡ5IiByPSྡ1LjUiLz4KPC9zdmc+Cg==
-version: 0.7.2
+version: 0.8.0
description: 智能分析文本内容,生成交互式思维导图,帮助用户结构化和可视化知识。
"""
```
@@ -50,16 +50,22 @@ description: 智能分析文本内容,生成交互式思维导图,帮助用户
```python
class Action:
class Valves(BaseModel):
- show_status: bool = Field(
+ SHOW_STATUS: bool = Field(
default=True, description="是否在聊天界面显示操作状态更新。"
)
- LLM_MODEL_ID: str = Field(
- default="gemini-2.5-flash",
- description="用于文本分析的内置LLM模型ID。",
+ MODEL_ID: str = Field(
+ default="",
+ description="用于文本分析的内置 LLM 模型 ID（留空使用当前对话模型）。",
)
MIN_TEXT_LENGTH: int = Field(
default=100, description="进行思维导图分析所需的最小文本长度(字符数)。"
)
+ CLEAR_PREVIOUS_HTML: bool = Field(
+ default=False, description="生成新导图时是否清理之前的插件输出。"
+ )
+ MESSAGE_COUNT: int = Field(
+ default=1, description="用于生成的最近消息数量（1-5）。"
+ )
def __init__(self):
self.valves = self.Valves()
diff --git a/docs/plugins/actions/index.md b/docs/plugins/actions/index.md
index 855c720..31ed4e4 100644
--- a/docs/plugins/actions/index.md
+++ b/docs/plugins/actions/index.md
@@ -23,7 +23,7 @@ Actions are interactive plugins that:
Intelligently analyzes text content and generates interactive mind maps with beautiful visualizations.
- **Version:** 0.7.2
+ **Version:** 0.8.0
[:octicons-arrow-right-24: Documentation](smart-mind-map.md)
diff --git a/docs/plugins/actions/index.zh.md b/docs/plugins/actions/index.zh.md
index a21617c..969d575 100644
--- a/docs/plugins/actions/index.zh.md
+++ b/docs/plugins/actions/index.zh.md
@@ -23,7 +23,7 @@ Actions 是交互式插件，能够：
智能分析文本并生成交互式、精美的思维导图。
- **版本：** 0.7.2
+ **版本：** 0.8.0
[:octicons-arrow-right-24: 查看文档](smart-mind-map.md)
diff --git a/docs/plugins/actions/smart-mind-map.md b/docs/plugins/actions/smart-mind-map.md
index 87b8439..4646d3e 100644
--- a/docs/plugins/actions/smart-mind-map.md
+++ b/docs/plugins/actions/smart-mind-map.md
@@ -1,7 +1,7 @@
# Smart Mind Map
Action
-v0.7.2
+v0.8.0
Intelligently analyzes text content and generates interactive mind maps for better visualization and understanding.
@@ -13,31 +13,31 @@ The Smart Mind Map plugin transforms text content into beautiful, interactive mi
## Features
-- :material-brain: **AI-Powered Analysis**: Intelligently extracts key concepts and relationships
-- :material-gesture-swipe: **Interactive Navigation**: Zoom, pan, and explore the mind map
-- :material-palette: **Beautiful Styling**: Modern design with customizable colors
-- :material-download: **Export Options**: Save as image or structured data
-- :material-translate: **Multi-language Support**: Works with multiple languages
+- :material-brain: **LLM Analysis**: Uses configurable models to extract key concepts and hierarchy
+- :material-gesture-swipe: **Rich Controls**: Zoom, reset view, expand level selector (All/2/3) and fullscreen
+- :material-palette: **Theme Aware**: Auto-detects OpenWebUI light/dark theme with manual toggle
+- :material-download: **One-Click Export**: Download high-res PNG, copy SVG, or copy Markdown source
+- :material-translate: **Multi-language**: Adapts output language to the user context
---
## Installation
-1. Download the plugin file: [`smart_mind_map.py`](https://github.com/Fu-Jie/awesome-openwebui/tree/main/plugins/actions/smart-mind-map)
-2. Upload to OpenWebUI: **Admin Panel** → **Settings** → **Functions**
-3. Enable the plugin
+1. Download the plugin file: [`思维导图.py`](https://github.com/Fu-Jie/awesome-openwebui/tree/main/plugins/actions/smart-mind-map)
+2. Upload to OpenWebUI: **Admin Panel** → **Settings** → **Functions** (Actions)
+3. Enable the plugin, and optionally allow iframe same-origin access so theme auto-detection works
---
## Usage
-1. Start a conversation and get a response from the AI
-2. Click the **Mind Map** button in the message action bar
-3. Wait for the mind map to generate
-4. Interact with the visualization:
- - **Zoom**: Scroll to zoom in/out
- - **Pan**: Click and drag to move around
- - **Expand/Collapse**: Click nodes to show/hide children
+1. Enable **Smart Mind Map** in chat settings, then provide at least ~100 characters of text
+2. Click the **Mind Map** action button on a message to trigger generation
+3. Interact with the visualization:
+ - **Zoom & Reset**: Scroll or use the + / - / ↻ controls
+ - **Expand Levels**: Switch between All / 2 / 3 levels
+ - **Theme & Fullscreen**: Toggle light/dark or enter fullscreen
+4. Export with one click: **PNG**, **Copy SVG**, or **Copy Markdown**
---
@@ -45,9 +45,11 @@ The Smart Mind Map plugin transforms text content into beautiful, interactive mi
| Option | Type | Default | Description |
|--------|------|---------|-------------|
-| `show_status` | boolean | `true` | Show processing status updates |
-| `max_depth` | integer | `5` | Maximum depth of the mind map |
-| `theme` | string | `"default"` | Color theme for the visualization |
+| `SHOW_STATUS` | boolean | `true` | Show status updates in chat during processing |
+| `MODEL_ID` | string | `""` | Built-in LLM ID for analysis (empty uses current chat model) |
+| `MIN_TEXT_LENGTH` | integer | `100` | Minimum characters required before analysis runs |
+| `CLEAR_PREVIOUS_HTML` | boolean | `false` | Clear previous plugin HTML instead of merging |
+| `MESSAGE_COUNT` | integer | `1` | Number of recent messages to include (1–5) |
---
@@ -73,16 +75,20 @@ The plugin generates an interactive HTML mind map embedded in the chat:
!!! note "Prerequisites"
- OpenWebUI v0.3.0 or later
- No additional Python packages required
+ - For theme auto-detection/PNG export accuracy, allow iframe same-origin access in **User Settings → Interface → Artifacts**
---
## Troubleshooting
??? question "Mind map is not displaying?"
- Ensure your browser supports HTML5 Canvas and JavaScript is enabled.
+ - Ensure the input text is at least `MIN_TEXT_LENGTH` characters
+ - Confirm a valid `MODEL_ID` is available (or leave empty to use current model)
+ - Refresh and re-run after enabling the plugin
-??? question "Generation takes too long?"
- For very long texts, the AI analysis may take more time. Consider breaking down the content into smaller sections.
+??? question "Theme looks wrong or PNG export is blank?"
+ - Enable iframe same-origin access so the plugin can read the parent theme
+ - Wait for the mind map to fully render before exporting
---
diff --git a/docs/plugins/actions/smart-mind-map.zh.md b/docs/plugins/actions/smart-mind-map.zh.md
index a6709bc..43a1f06 100644
--- a/docs/plugins/actions/smart-mind-map.zh.md
+++ b/docs/plugins/actions/smart-mind-map.zh.md
@@ -1,7 +1,7 @@
# Smart Mind Map（智能思维导图）
Action
-v0.7.2
+v0.8.0
智能分析文本内容，生成交互式思维导图，帮助你更直观地理解信息结构。
@@ -13,31 +13,31 @@ Smart Mind Map 会将文本转换成漂亮的交互式思维导图。插件会
## 功能特性
-- :material-brain: **AI 分析**：智能提取关键概念与关联关系
-- :material-gesture-swipe: **交互导航**：支持缩放、平移、展开/折叠
-- :material-palette: **精美样式**：现代化配色，支持自定义主题
-- :material-download: **导出**：可保存为图片或结构化数据
-- :material-translate: **多语言**：支持多语言文本分析
+- :material-brain: **LLM 分析**：可配置模型，提取核心概念与层级
+- :material-gesture-swipe: **丰富控制**：缩放/重置、展开层级（全部/2/3 级）与全屏
+- :material-palette: **主题感知**：自动检测 OpenWebUI 亮/暗色主题并支持手动切换
+- :material-download: **一键导出**：下载高分辨率 PNG、复制 SVG 或 Markdown
+- :material-translate: **多语言**：根据用户语言自动输出
---
## 安装
-1. 下载插件文件：[`smart_mind_map.py`](https://github.com/Fu-Jie/awesome-openwebui/tree/main/plugins/actions/smart-mind-map)
-2. 上传到 OpenWebUI：**Admin Panel** → **Settings** → **Functions**
-3. 启用插件
+1. 下载插件文件：[`思维导图.py`](https://github.com/Fu-Jie/awesome-openwebui/tree/main/plugins/actions/smart-mind-map)
+2. 上传到 OpenWebUI：**Admin Panel** → **Settings** → **Functions**（Actions）
+3. 启用插件，并可在设置中允许 iframe same-origin 以启用主题自动检测
---
## 使用方法
-1. 先与 AI 对话并生成回复
-2. 点击消息操作栏中的 **Mind Map** 按钮
-3. 等待思维导图生成
-4. 交互使用：
- - **缩放**：滚轮缩放
- - **平移**：按住拖动
- - **展开/折叠**：点击节点显示或隐藏子节点
+1. 在聊天设置中启用 **Smart Mind Map**，提供不少于约 100 字符的文本
+2. 点击消息操作栏中的 **Mind Map** 动作按钮触发生成
+3. 交互使用：
+ - **缩放与重置**：滚轮或使用 + / - / ↻ 控制
+ - **展开层级**：切换“全部 / 2 级 / 3 级”
+ - **主题与全屏**：手动切换亮/暗色或进入全屏
+4. 一键导出：**PNG**、**复制 SVG**、**复制 Markdown**
---
@@ -45,9 +45,11 @@ Smart Mind Map 会将文本转换成漂亮的交互式思维导图。插件会
| 选项 | 类型 | 默认值 | 说明 |
|--------|------|---------|-------------|
-| `show_status` | boolean | `true` | 是否显示处理状态更新 |
-| `max_depth` | integer | `5` | 思维导图的最大层级 |
-| `theme` | string | `"default"` | 可视化的主题配色 |
+| `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） |
---
@@ -73,16 +75,20 @@ Smart Mind Map 会将文本转换成漂亮的交互式思维导图。插件会
!!! note "前置条件"
- OpenWebUI v0.3.0 及以上
- 无需额外 Python 依赖
+ - 如需自动匹配主题/提高 PNG 导出准确性，请在 **User Settings → Interface → Artifacts** 中允许 iframe same-origin 访问
---
## 常见问题
??? question "思维导图不显示？"
- 请确认浏览器支持 HTML5 Canvas，并且已开启 JavaScript。
+ - 确认输入文本达到 `MIN_TEXT_LENGTH`
+ - 确保已配置可用的 `MODEL_ID`（或留空使用当前模型）
+ - 启用插件后刷新页面再试
-??? question "生成时间过长？"
- 对超长文本，AI 分析会更耗时。建议拆分内容后再生成。
+??? question "主题不匹配或 PNG 为空白？"
+ - 在设置中开启 iframe same-origin 以读取父页面主题
+ - 等待导图完全渲染后再导出
---
diff --git a/docs/plugins/index.md b/docs/plugins/index.md
index 3ae410a..386fbc4 100644
--- a/docs/plugins/index.md
+++ b/docs/plugins/index.md
@@ -48,7 +48,7 @@ OpenWebUI supports four types of plugins, each serving a different purpose:
| Plugin | Type | Description | Version |
|--------|------|-------------|---------|
-| [Smart Mind Map](actions/smart-mind-map.md) | Action | Generate interactive mind maps from text | 0.7.2 |
+| [Smart Mind Map](actions/smart-mind-map.md) | Action | Generate interactive mind maps from text | 0.8.0 |
| [Smart Infographic](actions/smart-infographic.md) | Action | Transform text into professional infographics | 1.0.0 |
| [Knowledge Card](actions/knowledge-card.md) | Action | Create beautiful learning flashcards | 0.2.0 |
| [Export to Excel](actions/export-to-excel.md) | Action | Export chat history to Excel files | 1.0.0 |
diff --git a/docs/plugins/index.zh.md b/docs/plugins/index.zh.md
index 116a639..a39d2f7 100644
--- a/docs/plugins/index.zh.md
+++ b/docs/plugins/index.zh.md
@@ -48,7 +48,7 @@ OpenWebUI 支持四种类型的插件，每种都有不同的用途：
| 插件 | 类型 | 描述 | 版本 |
|--------|------|-------------|---------|
-| [Smart Mind Map（智能思维导图）](actions/smart-mind-map.md) | Action | 从文本生成交互式思维导图 | 0.7.2 |
+| [Smart Mind Map（智能思维导图）](actions/smart-mind-map.md) | Action | 从文本生成交互式思维导图 | 0.8.0 |
| [Smart Infographic（智能信息图）](actions/smart-infographic.md) | Action | 将文本转成专业信息图 | 1.0.0 |
| [Knowledge Card（知识卡片）](actions/knowledge-card.md) | Action | 生成精美学习卡片 | 0.2.0 |
| [Export to Excel（导出到 Excel）](actions/export-to-excel.md) | Action | 导出聊天记录为 Excel | 1.0.0 |