feat(actions): release Smart Mind Map v1.0.0 - a milestone with Native i18n & Direct Embed

.agent/workflows/plugin-development.md

@@ -12,11 +12,11 @@ Reference: `.github/copilot-instructions.md`
 
 ### Bilingual Requirement
 
-Every plugin **MUST** have bilingual versions for both code and documentation:
+Every plugin **MUST** have a single internationalized code file and bilingual documentation:
 
-- **Code**:
+- **Code (i18n)**:
-  - English: `plugins/{type}/{name}/{name}.py`
+  - `plugins/{type}/{name}/{name}.py`
-  - Chinese: `plugins/{type}/{name}/{name_cn}.py` (or `中文名.py`)
+  - The single `.py` file must implement internal i18n (e.g., using `navigator.language` or backend headers) to support multiple languages natively, rather than splitting into separate files.
 - **README**:
   - English: `plugins/{type}/{name}/README.md`
   - Chinese: `plugins/{type}/{name}/README_CN.md`
@@ -81,14 +81,13 @@ Reference: `.github/workflows/release.yml`
 - **Release Information Compliance**: When a release is requested, the agent must generate a standard release summary (English commit title + bilingual bullet points) as defined in Section 3 & 5.
 - **Default Action (Prepare Only)**: When performing a version bump or update, the agent should update all files locally but **STOP** before committing. Present the changes and the **proposed Release/Commit Message** to the user and wait for explicit confirmation to commit/push.
 - **Consistency**: When bumping, update version in **ALL** locations:
-  1. English Code (`.py`)
+  1. Code (`.py`)
-  2. Chinese Code (`.py`)
+  2. English README (`README.md`)
-  3. English README (`README.md`)
+  3. Chinese README (`README_CN.md`)
-  4. Chinese README (`README_CN.md`)
+  4. Docs Index (`docs/.../index.md`)
-  5. Docs Index (`docs/.../index.md`)
+  5. Docs Index CN (`docs/.../index.zh.md`)
-  6. Docs Index CN (`docs/.../index.zh.md`)
+  6. Docs Detail (`docs/.../{name}.md`)
-  7. Docs Detail (`docs/.../{name}.md`)
+  7. Docs Detail CN (`docs/.../{name}.zh.md`)
-  8. Docs Detail CN (`docs/.../{name}.zh.md`)
 
 ### Automated Release Process
 
@@ -120,7 +119,7 @@ When the user confirms a release, the agent **MUST** follow these content standa
    - Before committing, present a "Release Draft" containing:
      - **Title**: e.g., `Release v0.1.1: [Plugin Name] - [Brief Summary]`
      - **Changelog**: English-only list of commits since the last release, including hashes (e.g., `896de02 docs(config): reorder antigravity model alias example`).
-     - **Verification Status**: Confirm all 8+ files have been updated and synced.
+     - **Verification Status**: Confirm all 7+ files have been updated and synced.
 3. **Internal Documentation**: Ensure "What's New" sections in READMEs and `docs/` match exactly the changes being released.
 
 ### Pull Request Check
@@ -134,7 +133,7 @@ When the user confirms a release, the agent **MUST** follow these content standa
 
 Before committing:
 
-- [ ] Code is bilingual and functional?
+- [ ] Code is internal i18n supported (`.py`) and fully functional?
 - [ ] Docstrings have updated version?
 - [ ] READMEs are updated and bilingual?
 - [ ] **Key Capabilities** in READMEs still cover all legacy core features + new features?

.github/copilot-instructions.md

@@ -8,27 +8,26 @@ This document defines the standard conventions and best practices for OpenWebUI
 
 ## 🏗️ 项目结构与命名 (Project Structure & Naming)
 
-### 1. 双语版本要求 (Bilingual Version Requirements)
+### 1. 语言与代码规范 (Language & Code Requirements)
 
 #### 插件代码 (Plugin Code)
 
-每个插件必须提供两个版本：
+每个插件**必须**采用单文件国际化 (i18n) 设计。严禁为不同语言创建独立的源代码文件（如 `_cn.py`）。
 
-1. **英文版本**: `plugin_name.py` - 英文界面、提示词和注释
+1.  **单代码文件**: `plugins/{type}/{name}/{name}.py`
-2. **中文版本**: `plugin_name_cn.py` - 中文界面、提示词和注释
+2.  **内置 i18n**: 必须在代码中根据前端传来的用户语言（如 `__user__` 中的 `language` 或通过 `get_user_language` 脚本读取）动态切换界面显示、提示词和状态日志。
 
-示例：
+示例目录结构：
 ```
 plugins/actions/export_to_docx/
-├── export_to_word.py      # English version
+├── export_to_word.py      # 单个代码文件，内置多语言支持
-├── export_to_word_cn.py    # Chinese version
+├── README.md               # 英文文档 (English documentation)
-├── README.md               # English documentation
+└── README_CN.md            # 中文文档
-└── README_CN.md            # Chinese documentation
 ```
 
 #### 文档 (Documentation)
 
-每个插件目录必须包含双语 README 文件：
+尽管代码是合一的，但为了市场展示和 SEO，每个插件目录仍**必须**包含双语 README 文件：
 
 - `README.md` - English documentation
 - `README_CN.md` - 中文文档
@@ -58,12 +57,10 @@ plugins/actions/export_to_docx/
 plugins/
 ├── actions/           # Action 插件 (用户触发的功能)
 │   ├── my_action/
-│   │   ├── my_action.py          # English version
+│   │   ├── my_action.py          # 单文件，内置 i18n
-│   │   ├── 我的动作.py            # Chinese version
 │   │   ├── README.md              # English documentation
 │   │   └── README_CN.md           # Chinese documentation
-│   ├── ACTION_PLUGIN_TEMPLATE.py      # English template
+│   ├── ACTION_PLUGIN_TEMPLATE.py      # 通用 i18n 模板
-│   ├── ACTION_PLUGIN_TEMPLATE_CN.py   # Chinese template
 │   └── README.md
 ├── filters/           # Filter 插件 (输入处理)
 │   └── ...
@@ -474,7 +471,7 @@ async def get_user_language(self):
 
 #### 适用场景与引导 (Usage Guidelines)
 
-- **语言适配**: 动态获取界面语言 (`ru-RU`, `zh-CN`) 自动切换输出语言。
+- **语言适配**: 动态获取界面语言 (`ru-RU`, `zh-CN`) 自动切换输出语言和 UI 翻译。这对于单文件 i18n 插件至关重要。
 - **时区处理**: 获取 `Intl.DateTimeFormat().resolvedOptions().timeZone` 处理时间。
 - **客户端存储**: 读取 `localStorage` 中的用户偏好设置。
 - **硬件能力**: 获取 `navigator.clipboard` 或 `navigator.geolocation` (需授权)。
@@ -932,8 +929,7 @@ Filter 实例是**单例 (Singleton)**。
 
 ### 1. ✅ 开发检查清单 (Development Checklist)
 
-- [ ] 创建英文版插件代码 (`plugin_name.py`)
+- [ ] 代码实现了内置 i18n 逻辑 (`.py`)
-- [ ] 创建中文版插件代码 (`plugin_name_cn.py`)
 - [ ] 编写英文 README (`README.md`)
 - [ ] 编写中文 README (`README_CN.md`)
 - [ ] 包含标准化文档字符串
@@ -941,7 +937,7 @@ Filter 实例是**单例 (Singleton)**。
 - [ ] 使用 Lucide 图标
 - [ ] 实现 Valves 配置
 - [ ] 使用 logging 而非 print
-- [ ] 测试双语界面
+- [ ] 测试 i18n 界面适配
 - [ ] **一致性检查**: 确保文档、代码、README 同步
 - [ ] **README 结构**: 
     - **Key Capabilities** (英文) / **核心功能** (中文): 必须包含所有核心功能
@@ -988,7 +984,7 @@ Filter 实例是**单例 (Singleton)**。
 2. **变更列表 (Bilingual Changes)**: 
    - 英文: Clear descriptions of technical/functional changes.
    - 中文: 清晰描述用户可见的功能改进或修复。
-3. **核查状态 (Verification)**: 确认版本号已在相关 8+ 处位置同步更新。
+3. **核查状态 (Verification)**: 确认版本号已在相关 7+ 处位置同步更新（1 个代码文件 + 2 个 README + 4 个 Docs 文件）。
 
 ### 4. 🤖 Git 提交与推送规范 (Git Operations & Push Rules)
 
@@ -1004,8 +1000,7 @@ Filter 实例是**单例 (Singleton)**。
 
 ## 📚 参考资源 (Reference Resources)
 
-- [Action 插件模板 (英文)](plugins/actions/ACTION_PLUGIN_TEMPLATE.py)
+- [Action 插件模板](plugins/actions/ACTION_PLUGIN_TEMPLATE.py)
-- [Action 插件模板 (中文)](plugins/actions/ACTION_PLUGIN_TEMPLATE_CN.py)
 - [插件开发指南](plugins/actions/PLUGIN_DEVELOPMENT_GUIDE.md)
 - [Lucide Icons](https://lucide.dev/icons/)
 - [OpenWebUI 文档](https://docs.openwebui.com/)

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.9.2
+    **Version:** 1.0.0
 
     [:octicons-arrow-right-24: Documentation](smart-mind-map.md)
 

docs/plugins/actions/index.zh.md

@@ -23,7 +23,7 @@ Actions 是交互式插件，能够：
 
     智能分析文本并生成交互式、精美的思维导图。
 
-    **版本：** 0.8.0
+    **版本：** 1.0.0
 
     [:octicons-arrow-right-24: 查看文档](smart-mind-map.md)
 

docs/plugins/actions/smart-mind-map.md

@@ -1,7 +1,7 @@
 # Smart Mind Map
 
 <span class="category-badge action">Action</span>
-<span class="version-badge">v0.9.2</span>
+<span class="version-badge">v1.0.0</span>
 
 Intelligently analyzes text content and generates interactive mind maps for better visualization and understanding.
 
@@ -17,7 +17,8 @@ The Smart Mind Map plugin transforms text content into beautiful, interactive mi
 - :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**: Matches output language to the input text
+- :material-translate: **i18n Embedded**: One code file smartly detects frontend languages and translates the output.
+- :material-arrow-all: **Auto-Sizing & Direct Embed**: Seamlessly scales to display massive canvas inline (requires setting toggle).
 
 ---
 
@@ -50,6 +51,7 @@ The Smart Mind Map plugin transforms text content into beautiful, interactive mi
 | `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) |
+| `ENABLE_DIRECT_EMBED_MODE` | boolean | `false` | Enable inline full-width UI for OpenWebUI 0.8.0+ |
 
 ---
 

docs/plugins/actions/smart-mind-map.zh.md

@@ -1,7 +1,7 @@
 # Smart Mind Map（智能思维导图）
 
 <span class="category-badge action">Action</span>
-<span class="version-badge">v0.9.2</span>
+<span class="version-badge">v1.0.0</span>
 
 智能分析文本内容，生成交互式思维导图，帮助你更直观地理解信息结构。
 
@@ -17,7 +17,8 @@ Smart Mind Map 会将文本转换成漂亮的交互式思维导图。插件会
 - :material-gesture-swipe: **丰富控制**：缩放/重置、展开层级（全部/2/3 级）与全屏
 - :material-palette: **主题感知**：自动检测 OpenWebUI 亮/暗色主题并支持手动切换
 - :material-download: **一键导出**：下载高分辨率 PNG、复制 SVG 或 Markdown
-- :material-translate: **多语言**：输出语言与输入文本一致
+- :material-translate: **内置 i18n 语言识别**：单个文件自动检测控制台前端语言，无需繁杂的各种语言包版本。
+- :material-arrow-all: **直出全屏版体验 (需配置开启)**：新版直出渲染抛开沙盒限制，纵情铺满屏幕，享受原生的图表体验。
 
 ---
 
@@ -50,6 +51,7 @@ Smart Mind Map 会将文本转换成漂亮的交互式思维导图。插件会
 | `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+ ) |
 
 ---
 

plugins/actions/smart-mind-map/README.md

@@ -2,21 +2,26 @@
 
 Smart Mind Map is a powerful OpenWebUI action plugin that intelligently analyzes long-form text content and automatically generates interactive mind maps, helping users structure and visualize knowledge.
 
-**Author:** [Fu-Jie](https://github.com/Fu-Jie) | **Version:** 0.9.2 | **Project:** [OpenWebUI Extensions](https://github.com/Fu-Jie/openwebui-extensions) | **License:** MIT
+**Author:** [Fu-Jie](https://github.com/Fu-Jie) | **Version:** 1.0.0 | **Project:** [OpenWebUI Extensions](https://github.com/Fu-Jie/openwebui-extensions) | **License:** MIT
 
-## What's New in v0.9.2
+## What's New in v1.0.0
 
-**Language Rule Alignment**
+### Direct Embed & UI Refinements
 
-- **Input Language First**: Mind map output now strictly matches the input text language.
+- **Native Multi-language UI (i18n)**: The plugin interface (buttons, settings, status) now automatically adapts to your browser's language setting for a seamless global experience.
-- **Consistent Behavior**: Matches the infographic language rule for predictable multilingual output.
+- **Direct Embed Mode**: Introduced a native-like inline display mode for Open WebUI 0.8.0+, enabling a seamless full-width canvas.
+- **Adaptive Auto-Sizing**: Mind map now dynamically scales its height and perfectly refits to the window to eliminate scrollbar artifacts.
+- **Subdued & Compact UI**: Completely redesigned the header tooling bar to a slender, single-line configuration to maximize visual rendering space.
+- **Configurable Experience**: Added `ENABLE_DIRECT_EMBED_MODE` valve to explicitly toggle the new inline rendering behavior.
 
 ## Key Features 🔑
 
 - ✅ **Intelligent Text Analysis**: Automatically identifies core themes, key concepts, and hierarchical structures.
+- ✅ **Native Multi-language UI**: Automatic interface translation (i18n) based on system language for a native feel.
 - ✅ **Interactive Visualization**: Generates beautiful interactive mind maps based on Markmap.js.
+- ✅ **Direct Embed Mode**: (Optional) For Open WebUI 0.8.0+, render natively inline to fill entire UI width.
 - ✅ **High-Resolution PNG Export**: Export mind maps as high-quality PNG images (9x scale).
-- ✅ **Complete Control Panel**: Zoom controls, expand level selection, and fullscreen mode.
+- ✅ **Complete Control Panel**: Zoom controls, expand level selection, and fullscreen mode within a compact toolbar.
 - ✅ **Theme Switching**: Manual theme toggle button with automatic theme detection.
 - ✅ **Image Output Mode**: Generate static SVG images embedded directly in Markdown for cleaner history.
 
@@ -37,6 +42,7 @@ Smart Mind Map is a powerful OpenWebUI action plugin that intelligently analyzes
 | `CLEAR_PREVIOUS_HTML` | `false` | Whether to clear previous plugin-generated HTML content. |
 | `MESSAGE_COUNT` | `1` | Number of recent messages to use for generation (1-5). |
 | `OUTPUT_MODE` | `html` | Output mode: `html` (interactive) or `image` (static). |
+| `ENABLE_DIRECT_EMBED_MODE` | `false` | Enable Direct Embed Mode (Open WebUI 0.8.0+ native layout) instead of Legacy Mode. |
 
 ## ⭐ Support
 

plugins/actions/smart-mind-map/README_CN.md

@@ -2,21 +2,26 @@
 
 思维导图是一个强大的 OpenWebUI 动作插件，能够智能分析长篇文本内容，自动生成交互式思维导图，帮助用户结构化和可视化知识。
 
-**作者:** [Fu-Jie](https://github.com/Fu-Jie) | **版本:** 0.9.2 | **项目:** [OpenWebUI Extensions](https://github.com/Fu-Jie/openwebui-extensions) | **许可证:** MIT
+**作者:** [Fu-Jie](https://github.com/Fu-Jie) | **版本:** 1.0.0 | **项目:** [OpenWebUI Extensions](https://github.com/Fu-Jie/openwebui-extensions) | **许可证:** MIT
 
-## v0.9.2 更新亮点
+## v1.0.0 最新更新
 
-**语言规则对齐**
+### 嵌入式直出与 UI 细节全线重构
 
-- **输入语言优先**：导图输出严格与输入文本语言一致。
+- **原生多语言界面 (Native i18n)**：插件界面（按钮、设置说明、状态提示）现在会根据您浏览器的语言设置自动适配系统语言。
-- **一致性提升**：与信息图语言规则保持一致，多语言输出更可预期。
+- **原生态嵌入模式 (Direct Embed)**：针对 Open WebUI 0.8.0+ 的前端架构支持了纯正的内容内联（Inline）直出模式，不再受气泡和 Markdown 隔离，真正撑满屏幕宽度。
+- **自动响应边界 (Auto-Sizing)**：突破以前高度僵死的问题。思维导图现在可以根据您的当前屏幕大小弹性伸缩（动态 `clamp()` 高度），彻底消灭丑陋的局部滚动条与白边。
+- **极简专业 UI (Compact UI)**：推倒重做了头部的菜单栏，统一使用了一套干净、单行的极简全透明微拟物 Toolbar 设计，为导图画布省下极大的垂直空间。
+- **模式配置自由**：为了照顾阅读流连贯的习惯，新增了 `ENABLE_DIRECT_EMBED_MODE` 配置开关。您必须在设置中显式开启才能体验宽广内联全屏模式。
 
 ## 核心特性 🔑
 
 - ✅ **智能文本分析**：自动识别文本的核心主题、关键概念和层次结构。
+- ✅ **原生多语言界面**：根据系统语言自动切换界面语言 (i18n)，提供原生交互体验。
 - ✅ **交互式可视化**：基于 Markmap.js 生成美观的交互式思维导图。
+- ✅ **直出全景内嵌 (Direct Embed)**：(可选开关) 对于 Open WebUI 0.8.0+，直接填补整个前端宽度，去除气泡剥离感。
 - ✅ **高分辨率 PNG 导出**：导出高质量的 PNG 图片（9 倍分辨率）。
-- ✅ **完整控制面板**：缩放控制、展开层级选择、全屏模式。
+- ✅ **完整控制面板**：极简清爽的单行大屏缩放控制、展开层级选择、全局全屏等核心操作。
 - ✅ **主题切换**：手动主题切换按钮与自动主题检测。
 - ✅ **图片输出模式**：生成静态 SVG 图片直接嵌入 Markdown，聊天记录更简洁。
 
@@ -37,6 +42,7 @@
 | `CLEAR_PREVIOUS_HTML` | `false` | 在生成新的思维导图时，是否清除之前的 HTML 内容。 |
 | `MESSAGE_COUNT` | `1` | 用于生成思维导图的最近消息数量（1-5）。 |
 | `OUTPUT_MODE` | `html` | 输出模式：`html`（交互式）或 `image`（静态图片）。 |
+| `ENABLE_DIRECT_EMBED_MODE` | `false` | 是否开启沉浸式直出嵌入模式（需要 Open WebUI v0.8.0+ 环境）。如果保持 `false` 将会维持旧版的对话流 Markdown 渲染模式。 |
 
 ## ⭐ 支持