思维导图工具 - 知识可视化与结构化利器¶

思维导图工具（Smart Mind Map Tool）是广受好评的“思维导图”插件的工具（Tool）版本。它赋予了模型主动生成交互式思维导图的能力，通过智能分析上下文，将碎片化知识转化为层级分明的视觉架构。

💡 说明：如果您更倾向于手动点击按钮触发生成，可以获取 思维导图 Action（动作）版本。

使用 Batch Install Plugins 安装¶

如果你已经安装了 Batch Install Plugins from GitHub，可以用下面这句来安装或更新当前插件：

从 Fu-Jie/openwebui-extensions 安装插件

当选择弹窗打开后，搜索当前插件，勾选后继续安装即可。

[!IMPORTANT] 如果你已经安装了 OpenWebUI 官方社区里的同名版本，请先删除旧版本，否则重新安装时可能报错。删除后，Batch Install Plugins 后续就可以继续负责更新这个插件。

🚀 为什么会有工具（Tool）版本？¶

1. 得益于 OpenWebUI 0.8.0 的 Rich UI 特性：在以前的版本中，是不支持直接将自定义的 HTML/iframe 嵌入到对话流中的。而从 0.8.0 开始，平台不仅支持了这种顺滑的前端组件直出（Rich UI），而且同时对 Action 和 Tool 开放了该能力。
2. AI 自主调用（区别于 Action）：Action 是被动的，需要用户在输入框或消息旁手动点击触发；而 Tool 赋予了模型**自主权**。AI 可以根据对话上下文，自行判断在什么时候为您生成导图最有帮助，实现真正的“智能助理”体验。

它非常适合以下场景：

• 总结复杂的对话内容。
• 规划项目、整理文章大纲。
• 解释具有层级结构的抽象概念。

✨ 核心特性¶

• ✅ 主动触发生成：AI 在感知到需要视觉化展示时会自动调用工具生成导图。
• ✅ 全量上下文感知：支持聚合整个会话历史（MESSAGE_COUNT 为 0），生成最完整的知识地图。
• ✅ 原生多语言 UI (i18n)：自动检测并适配浏览器/系统语言（简体中文、繁体中文、英文、日文、韩文等）。
• ✅ 统一的高级视觉：完全复刻 Action 版本的极简工具栏、玻璃拟态审美以及专业边框阴影。
• ✅ 深度交互控制：支持缩放（放大/缩小/重置）、层级调节（默认为 3 级展开）以及全屏模式。
• ✅ 高品质导出：支持将导图导出为超高清 PNG 图片。

🛠️ 安装与设置¶

1. 安装：在 OpenWebUI 管理员设置 -> 插件 -> 工具中上传 smart_mind_map_tool.py。
2. 启用原生理机制：在“管理员设置 -> 模型”或配置里，确保目标模型**启用了原生工具调用（Native Tool Calling）**。只有开启这个能力，AI 才能自主并稳定地触发 Tool 功能。
3. 分配工具：在工作区或聊天界面处为目标模型选中并挂载本工具。
4. 配置：
5. MESSAGE_COUNT：设置为 12（默认）以使用最近的 12 条对话记录，或设置为 0 聚合全部历史。
6. MODEL_ID：指定分析导图时偏好的模型（留空则默认使用当前模型）。

⚙️ 配置参数 (Valves)¶

❓ 常见问题¶

• 语言显示不正确？：工具采用 4 级探测机制（前端脚本 > 浏览器头 > 用户资料 > 默认）。请检查浏览器语言设置。
• 生成的导图太小或太大？：我们针对对话流内联显示优化了 500px 的固定高度，并配有自适应缩放逻辑。
• 导出图片：建议先点击“⛶”进入全屏，获得最佳构图后再点击导出。

⭐ 支持¶

如果这个工具帮您理清了思路，欢迎在 GitHub 给我们一个 Star。

⚖️ 许可证¶

MIT License. Designed with ❤️ by Fu-Jie.