Merge pull request #20 from Fu-Jie/copilot/fix-session-alias-errors

Harden async context compression against new DB session alias and runtime edge cases
chore: release async-context-compression v1.1.2
2026-01-11 17:26:03 +08:00 · 2026-01-11 17:25:07 +08:00 · 2026-01-11 08:36:13 +00:00 · 2026-01-11 08:31:10 +00:00 · 2026-01-11 08:30:02 +00:00 · 2026-01-11 08:28:52 +00:00
47 changed files with 3542 additions and 4011 deletions
--- a/.github/copilot-instructions.md
+++ b/.github/copilot-instructions.md
@@ -40,7 +40,7 @@ plugins/actions/export_to_docx/
    - 格式: `**Author:** [Fu-Jie](https://github.com/Fu-Jie) | **Version:** x.x.x | **Project:** [Awesome OpenWebUI](https://github.com/Fu-Jie/awesome-openwebui)`
    - **注意**: Author 和 Project 为固定值，仅需更新 Version 版本号
 3.  **描述 (Description)**: 一句话功能介绍
-4.  **最新更新 (What's New)**: **必须**放在描述之后，显著展示最新版本的变更点
+4.  **最新更新 (What's New)**: **必须**放在描述之后，显著展示最新版本的变更点 (仅展示最近 3 次更新)
 5.  **核心特性 (Key Features)**: 使用 Emoji + 粗体标题 + 描述格式
 6.  **使用方法 (How to Use)**: 按步骤说明
 7.  **配置参数 (Configuration/Valves)**: 使用表格格式，包含参数名、默认值、描述
@@ -96,7 +96,7 @@ example code or syntax here

 ### 文档内容要求 (Content Requirements)

- **新增功能**: 必须在 "What's New" 章节中明确列出，使用 Emoji + 粗体标题格式。
+- **新增功能**: 必须在 "What's New" 章节中明确列出，使用 Emoji + 粗体标题格式 (仅保留最近 3 个版本的更新记录)。
 - **双语**: 必须提供 `README.md` (英文) 和 `README_CN.md` (中文)。
 - **表格对齐**: 配置参数表格使用左对齐 `:---`。
 - **Emoji 规范**: 标题使用合适的 Emoji 增强可读性。
@@ -260,7 +260,46 @@ async def _emit_notification(

 ## 📋 日志规范 (Logging Standard)

- **禁止使用** `print()` 语句
+### 1. 前端控制台调试 (Frontend Console Debugging) - **优先推荐 (Preferred)**
+
+对于需要实时查看数据流、排查 UI 交互或内容变更的场景，**优先使用**前端控制台日志。这种方式可以直接在浏览器 DevTools (F12) 中查看，无需访问服务端日志。
+
+**实现方式**: 通过 `__event_emitter__` 发送 `type: "execute"` 事件执行 JS 代码。
+
+```python
+import json
+
+async def _emit_debug_log(self, __event_emitter__, title: str, data: dict):
+    """在浏览器控制台打印结构化调试日志"""
+    if not self.valves.show_debug_log or not __event_emitter__:
+        return
+
+    try:
+        js_code = f"""
+            (async function() {{
+                console.group("🛠️ {title}");
+                console.log({json.dumps(data, ensure_ascii=False)});
+                console.groupEnd();
+            }})();
+        """
+        
+        await __event_emitter__({
+            "type": "execute",
+            "data": {"code": js_code}
+        })
+    except Exception as e:
+        print(f"Error emitting debug log: {e}")
+```
+
+**配置要求**:
+- 在 `Valves` 中添加 `show_debug_log: bool` 开关，默认关闭。
+- 仅在开关开启时发送日志。
+
+### 2. 服务端日志 (Server-side Logging)
+
+用于记录系统级错误、异常堆栈或无需前端感知的后台任务。
+
+- **禁止使用** `print()` 语句 (除非用于简单的脚本调试)
 - 必须使用 Python 标准库 `logging`

 ```python
--- a/.github/workflows/community-stats.yml
+++ b/.github/workflows/community-stats.yml
@@ -1,5 +1,5 @@
 # OpenWebUI 社区统计报告自动生成
-# 每小时自动获取并更新社区统计数据
+# 只在统计数据变化时 commit，避免频繁提交

 name: Community Stats

@@ -32,6 +32,17 @@ jobs:
        run: |
          pip install requests python-dotenv
      
+      - name: Get previous stats
+        id: prev_stats
+        run: |
+          # 获取当前的 points 用于比较
+          if [ -f docs/community-stats.json ]; then
+            OLD_POINTS=$(jq -r '.user.total_points' docs/community-stats.json 2>/dev/null || echo "0")
+            echo "old_points=$OLD_POINTS" >> $GITHUB_OUTPUT
+          else
+            echo "old_points=0" >> $GITHUB_OUTPUT
+          fi
+      
      - name: Generate stats report
        env:
          OPENWEBUI_API_KEY: ${{ secrets.OPENWEBUI_API_KEY }}
@@ -39,10 +50,23 @@ jobs:
        run: |
          python scripts/openwebui_stats.py
      
-      - name: Check for changes
+      - name: Check for significant changes
        id: check_changes
        run: |
-          git diff --quiet docs/community-stats.zh.md docs/community-stats.md README.md README_CN.md || echo "changed=true" >> $GITHUB_OUTPUT
+          # 获取新的 points
+          NEW_POINTS=$(jq -r '.user.total_points' docs/community-stats.json 2>/dev/null || echo "0")
+          
+          echo "📊 Previous points: ${{ steps.prev_stats.outputs.old_points }}"
+          echo "📊 Current points: $NEW_POINTS"
+          
+          # 只在 points 变化时才 commit
+          if [ "$NEW_POINTS" != "${{ steps.prev_stats.outputs.old_points }}" ]; then
+            echo "changed=true" >> $GITHUB_OUTPUT
+            echo "✅ Points changed (${{ steps.prev_stats.outputs.old_points }} → $NEW_POINTS), will commit"
+          else
+            echo "changed=false" >> $GITHUB_OUTPUT
+            echo "⏭️ Points unchanged, skipping commit"
+          fi
      
      - name: Commit and push changes
        if: steps.check_changes.outputs.changed == 'true'
@@ -50,5 +74,5 @@ jobs:
          git config --local user.email "github-actions[bot]@users.noreply.github.com"
          git config --local user.name "github-actions[bot]"
          git add docs/community-stats.zh.md docs/community-stats.md docs/community-stats.json README.md README_CN.md
-          git commit -m "chore: update community stats $(date +'%Y-%m-%d')"
+          git diff --staged --quiet || git commit -m "chore: update community stats $(date +'%Y-%m-%d')"
          git push
--- a/README.md
+++ b/README.md
@@ -7,26 +7,26 @@ A collection of enhancements, plugins, and prompts for [OpenWebUI](https://githu
 <!-- STATS_START -->
 ## 📊 Community Stats

-> 🕐 Auto-updated: 2026-01-08 08:35
+> 🕐 Auto-updated: 2026-01-11 02:11

 | 👤 Author | 👥 Followers | ⭐ Points | 🏆 Contributions |
 |:---:|:---:|:---:|:---:|
-| [Fu-Jie](https://openwebui.com/u/Fu-Jie) | **50** | **64** | **18** |
+| [Fu-Jie](https://openwebui.com/u/Fu-Jie) | **75** | **77** | **22** |

 | 📝 Posts | ⬇️ Downloads | 👁️ Views | 👍 Upvotes | 💾 Saves |
 |:---:|:---:|:---:|:---:|:---:|
-| **11** | **916** | **9670** | **55** | **50** |
+| **14** | **1087** | **11853** | **68** | **67** |

 ### 🔥 Top 6 Popular Plugins

 | Rank | Plugin | Downloads | Views |
 |:---:|------|:---:|:---:|
-| 🥇 | [Smart Mind Map](https://openwebui.com/posts/turn_any_text_into_beautiful_mind_maps_3094c59a) | 294 | 2550 |
-| 🥈 | [Export to Excel](https://openwebui.com/posts/export_mulit_table_to_excel_244b8f9d) | 178 | 507 |
-| 🥉 | [Async Context Compression](https://openwebui.com/posts/async_context_compression_b1655bc8) | 119 | 1308 |
-| 4️⃣ | [📊 Smart Infographic (AntV)](https://openwebui.com/posts/smart_infographic_ad6f0c7f) | 87 | 1123 |
-| 5️⃣ | [Flash Card](https://openwebui.com/posts/flash_card_65a2ea8f) | 84 | 1561 |
-| 6️⃣ | [Export to Word (Enhanced)](https://openwebui.com/posts/export_to_word_enhanced_formatting_fca6a315) | 69 | 644 |
+| 🥇 | [Smart Mind Map](https://openwebui.com/posts/turn_any_text_into_beautiful_mind_maps_3094c59a) | 348 | 3165 |
+| 🥈 | [Export to Excel](https://openwebui.com/posts/export_mulit_table_to_excel_244b8f9d) | 181 | 559 |
+| 🥉 | [Async Context Compression](https://openwebui.com/posts/async_context_compression_b1655bc8) | 128 | 1437 |
+| 4️⃣ | [📊 Smart Infographic (AntV)](https://openwebui.com/posts/smart_infographic_ad6f0c7f) | 120 | 1393 |
+| 5️⃣ | [Flash Card](https://openwebui.com/posts/flash_card_65a2ea8f) | 94 | 1766 |
+| 6️⃣ | [Export to Word (Enhanced)](https://openwebui.com/posts/export_to_word_enhanced_formatting_fca6a315) | 87 | 814 |

 *See full stats in [Community Stats Report](./docs/community-stats.md)*
 <!-- STATS_END -->
--- a/README_CN.md
+++ b/README_CN.md
@@ -7,26 +7,26 @@ OpenWebUI 增强功能集合。包含个人开发与收集的插件、提示词
 <!-- STATS_START -->
 ## 📊 社区统计

-> 🕐 自动更新于 2026-01-08 08:35
+> 🕐 自动更新于 2026-01-11 02:11

 | 👤 作者 | 👥 粉丝 | ⭐ 积分 | 🏆 贡献 |
 |:---:|:---:|:---:|:---:|
-| [Fu-Jie](https://openwebui.com/u/Fu-Jie) | **50** | **64** | **18** |
+| [Fu-Jie](https://openwebui.com/u/Fu-Jie) | **75** | **77** | **22** |

 | 📝 发布 | ⬇️ 下载 | 👁️ 浏览 | 👍 点赞 | 💾 收藏 |
 |:---:|:---:|:---:|:---:|:---:|
-| **11** | **916** | **9670** | **55** | **50** |
+| **14** | **1087** | **11853** | **68** | **67** |

 ### 🔥 热门插件 Top 6

 | 排名 | 插件 | 下载 | 浏览 |
 |:---:|------|:---:|:---:|
-| 🥇 | [Smart Mind Map](https://openwebui.com/posts/turn_any_text_into_beautiful_mind_maps_3094c59a) | 294 | 2550 |
-| 🥈 | [Export to Excel](https://openwebui.com/posts/export_mulit_table_to_excel_244b8f9d) | 178 | 507 |
-| 🥉 | [Async Context Compression](https://openwebui.com/posts/async_context_compression_b1655bc8) | 119 | 1308 |
-| 4️⃣ | [📊 Smart Infographic (AntV)](https://openwebui.com/posts/smart_infographic_ad6f0c7f) | 87 | 1123 |
-| 5️⃣ | [Flash Card](https://openwebui.com/posts/flash_card_65a2ea8f) | 84 | 1561 |
-| 6️⃣ | [Export to Word (Enhanced)](https://openwebui.com/posts/export_to_word_enhanced_formatting_fca6a315) | 69 | 644 |
+| 🥇 | [Smart Mind Map](https://openwebui.com/posts/turn_any_text_into_beautiful_mind_maps_3094c59a) | 348 | 3165 |
+| 🥈 | [Export to Excel](https://openwebui.com/posts/export_mulit_table_to_excel_244b8f9d) | 181 | 559 |
+| 🥉 | [Async Context Compression](https://openwebui.com/posts/async_context_compression_b1655bc8) | 128 | 1437 |
+| 4️⃣ | [📊 Smart Infographic (AntV)](https://openwebui.com/posts/smart_infographic_ad6f0c7f) | 120 | 1393 |
+| 5️⃣ | [Flash Card](https://openwebui.com/posts/flash_card_65a2ea8f) | 94 | 1766 |
+| 6️⃣ | [Export to Word (Enhanced)](https://openwebui.com/posts/export_to_word_enhanced_formatting_fca6a315) | 87 | 814 |

 *完整统计请查看 [社区统计报告](./docs/community-stats.zh.md)*
 <!-- STATS_END -->
--- a/docs/community-stats.json
+++ b/docs/community-stats.json
@@ -1,14 +1,15 @@
 {
-  "total_posts": 11,
-  "total_downloads": 916,
-  "total_views": 9670,
-  "total_upvotes": 55,
-  "total_downvotes": 1,
-  "total_saves": 50,
-  "total_comments": 15,
+  "total_posts": 14,
+  "total_downloads": 1087,
+  "total_views": 11853,
+  "total_upvotes": 68,
+  "total_downvotes": 2,
+  "total_saves": 67,
+  "total_comments": 17,
  "by_type": {
-    "action": 9,
-    "filter": 2
+    "filter": 2,
+    "unknown": 1,
+    "action": 11
  },
  "posts": [
    {
@@ -18,10 +19,10 @@
      "version": "0.9.1",
      "author": "Fu-Jie",
      "description": "Intelligently analyzes text content and generates interactive mind maps to help users structure and visualize knowledge.",
-      "downloads": 294,
-      "views": 2550,
+      "downloads": 348,
+      "views": 3165,
      "upvotes": 10,
-      "saves": 16,
+      "saves": 21,
      "comments": 10,
      "created_at": "2025-12-30",
      "updated_at": "2026-01-07",
@@ -34,10 +35,10 @@
      "version": "0.3.7",
      "author": "Fu-Jie",
      "description": "Extracts tables from chat messages and exports them to Excel (.xlsx) files with smart formatting.",
-      "downloads": 178,
-      "views": 507,
+      "downloads": 181,
+      "views": 559,
      "upvotes": 3,
-      "saves": 3,
+      "saves": 4,
      "comments": 0,
      "created_at": "2025-05-30",
      "updated_at": "2026-01-07",
@@ -47,16 +48,16 @@
      "title": "Async Context Compression",
      "slug": "async_context_compression_b1655bc8",
      "type": "filter",
-      "version": "1.1.0",
+      "version": "1.1.1",
      "author": "Fu-Jie",
      "description": "Reduces token consumption in long conversations while maintaining coherence through intelligent summarization and message compression.",
-      "downloads": 119,
-      "views": 1308,
+      "downloads": 128,
+      "views": 1437,
      "upvotes": 5,
      "saves": 9,
      "comments": 0,
      "created_at": "2025-11-08",
-      "updated_at": "2026-01-07",
+      "updated_at": "2026-01-10",
      "url": "https://openwebui.com/posts/async_context_compression_b1655bc8"
    },
    {
@@ -66,10 +67,10 @@
      "version": "1.4.1",
      "author": "jeff",
      "description": "AI-powered infographic generator based on AntV Infographic. Supports professional templates, auto-icon matching, and SVG/PNG downloads.",
-      "downloads": 87,
-      "views": 1123,
+      "downloads": 120,
+      "views": 1393,
      "upvotes": 7,
-      "saves": 8,
+      "saves": 9,
      "comments": 2,
      "created_at": "2025-12-28",
      "updated_at": "2026-01-07",
@@ -82,10 +83,10 @@
      "version": "0.2.4",
      "author": "Fu-Jie",
      "description": "Quickly generates beautiful flashcards from text, extracting key points and categories.",
-      "downloads": 84,
-      "views": 1561,
+      "downloads": 94,
+      "views": 1766,
      "upvotes": 8,
-      "saves": 5,
+      "saves": 6,
      "comments": 2,
      "created_at": "2025-12-30",
      "updated_at": "2026-01-07",
@@ -98,10 +99,10 @@
      "version": "0.4.3",
      "author": "Fu-Jie",
      "description": "Export current conversation from Markdown to Word (.docx) with Mermaid diagrams rendered client-side (Mermaid.js, SVG+PNG), LaTeX math, real hyperlinks, improved tables, syntax highlighting, and blockquote support.",
-      "downloads": 69,
-      "views": 644,
+      "downloads": 87,
+      "views": 814,
      "upvotes": 5,
-      "saves": 5,
+      "saves": 8,
      "comments": 0,
      "created_at": "2026-01-03",
      "updated_at": "2026-01-07",
@@ -114,8 +115,8 @@
      "version": "1.4.1",
      "author": "jeff",
      "description": "基于 AntV Infographic 的智能信息图生成插件。支持多种专业模板，自动图标匹配，并提供 SVG/PNG 下载功能。",
-      "downloads": 33,
-      "views": 434,
+      "downloads": 35,
+      "views": 486,
      "upvotes": 3,
      "saves": 0,
      "comments": 0,
@@ -130,15 +131,31 @@
      "version": "0.4.3",
      "author": "Fu-Jie",
      "description": "将对话导出为 Word (.docx)，支持 Mermaid 图表 (客户端渲染 SVG+PNG)、LaTeX 数学公式、真实超链接、增强表格格式、代码高亮和引用块。",
-      "downloads": 20,
-      "views": 815,
-      "upvotes": 7,
-      "saves": 1,
+      "downloads": 33,
+      "views": 955,
+      "upvotes": 8,
+      "saves": 2,
      "comments": 1,
      "created_at": "2026-01-04",
      "updated_at": "2026-01-07",
      "url": "https://openwebui.com/posts/导出为_word_支持公式流程图表格和代码块_8a6306c0"
    },
+    {
+      "title": "Deep Dive",
+      "slug": "deep_dive_c0b846e4",
+      "type": "action",
+      "version": "1.0.0",
+      "author": "Fu-Jie",
+      "description": "A comprehensive thinking lens that dives deep into any content - from context to logic, insights, and action paths.",
+      "downloads": 24,
+      "views": 272,
+      "upvotes": 3,
+      "saves": 3,
+      "comments": 0,
+      "created_at": "2026-01-08",
+      "updated_at": "2026-01-08",
+      "url": "https://openwebui.com/posts/deep_dive_c0b846e4"
+    },
    {
      "title": "思维导图",
      "slug": "智能生成交互式思维导图帮助用户可视化知识_8d4b097b",
@@ -146,8 +163,8 @@
      "version": "0.9.1",
      "author": "Fu-Jie",
      "description": "智能分析文本内容,生成交互式思维导图,帮助用户结构化和可视化知识。",
-      "downloads": 15,
-      "views": 273,
+      "downloads": 17,
+      "views": 306,
      "upvotes": 2,
      "saves": 1,
      "comments": 0,
@@ -163,8 +180,8 @@
      "author": "Fu-Jie",
      "description": "快速将文本提炼为精美的学习记忆卡片，支持核心要点提取与分类。",
      "downloads": 12,
-      "views": 329,
-      "upvotes": 3,
+      "views": 349,
+      "upvotes": 4,
      "saves": 1,
      "comments": 0,
      "created_at": "2025-12-30",
@@ -175,17 +192,49 @@
      "title": "异步上下文压缩",
      "slug": "异步上下文压缩_5c0617cb",
      "type": "filter",
-      "version": "1.1.0",
+      "version": "1.1.1",
      "author": "Fu-Jie",
      "description": "通过智能摘要和消息压缩，降低长对话的 token 消耗，同时保持对话连贯性。",
-      "downloads": 5,
-      "views": 126,
-      "upvotes": 2,
+      "downloads": 7,
+      "views": 177,
+      "upvotes": 3,
      "saves": 1,
      "comments": 0,
      "created_at": "2025-11-08",
-      "updated_at": "2026-01-07",
+      "updated_at": "2026-01-10",
      "url": "https://openwebui.com/posts/异步上下文压缩_5c0617cb"
+    },
+    {
+      "title": "精读",
+      "slug": "精读_99830b0f",
+      "type": "action",
+      "version": "1.0.0",
+      "author": "Fu-Jie",
+      "description": "全方位的思维透镜 —— 从背景全景到逻辑脉络，从深度洞察到行动路径。",
+      "downloads": 1,
+      "views": 94,
+      "upvotes": 2,
+      "saves": 1,
+      "comments": 0,
+      "created_at": "2026-01-08",
+      "updated_at": "2026-01-08",
+      "url": "https://openwebui.com/posts/精读_99830b0f"
+    },
+    {
+      "title": " 🛠️ Debug Open WebUI Plugins in Your Browser",
+      "slug": "debug_open_webui_plugins_in_your_browser_81bf7960",
+      "type": "unknown",
+      "version": "",
+      "author": "",
+      "description": "",
+      "downloads": 0,
+      "views": 80,
+      "upvotes": 5,
+      "saves": 1,
+      "comments": 2,
+      "created_at": "2026-01-10",
+      "updated_at": "2026-01-10",
+      "url": "https://openwebui.com/posts/debug_open_webui_plugins_in_your_browser_81bf7960"
    }
  ],
  "user": {
@@ -193,11 +242,11 @@
    "name": "Fu-Jie",
    "profile_url": "https://openwebui.com/u/Fu-Jie",
    "profile_image": "https://community.s3.openwebui.com/uploads/users/b15d1348-4347-42b4-b815-e053342d6cb0/profile_d9510745-4bd4-4f8f-a997-4a21847d9300.webp",
-    "followers": 50,
+    "followers": 75,
    "following": 2,
-    "total_points": 64,
-    "post_points": 54,
-    "comment_points": 10,
-    "contributions": 18
+    "total_points": 77,
+    "post_points": 66,
+    "comment_points": 11,
+    "contributions": 22
  }
 }
--- a/docs/community-stats.md
+++ b/docs/community-stats.md
@@ -1,35 +1,39 @@
 # 📊 OpenWebUI Community Stats Report

-> 📅 Updated: 2026-01-08 08:35
+> 📅 Updated: 2026-01-11 02:11

 ## 📈 Overview

 | Metric | Value |
 |------|------|
-| 📝 Total Posts | 11 |
-| ⬇️ Total Downloads | 916 |
-| 👁️ Total Views | 9670 |
-| 👍 Total Upvotes | 55 |
-| 💾 Total Saves | 50 |
-| 💬 Total Comments | 15 |
+| 📝 Total Posts | 14 |
+| ⬇️ Total Downloads | 1087 |
+| 👁️ Total Views | 11853 |
+| 👍 Total Upvotes | 68 |
+| 💾 Total Saves | 67 |
+| 💬 Total Comments | 17 |

 ## 📂 By Type

- **action**: 9
 - **filter**: 2
+- **unknown**: 1
+- **action**: 11

 ## 📋 Posts List

 | Rank | Title | Type | Version | Downloads | Views | Upvotes | Saves | Updated |
 |:---:|------|:---:|:---:|:---:|:---:|:---:|:---:|:---:|
-| 1 | [Smart Mind Map](https://openwebui.com/posts/turn_any_text_into_beautiful_mind_maps_3094c59a) | action | 0.9.1 | 294 | 2550 | 10 | 16 | 2026-01-07 |
-| 2 | [Export to Excel](https://openwebui.com/posts/export_mulit_table_to_excel_244b8f9d) | action | 0.3.7 | 178 | 507 | 3 | 3 | 2026-01-07 |
-| 3 | [Async Context Compression](https://openwebui.com/posts/async_context_compression_b1655bc8) | filter | 1.1.0 | 119 | 1308 | 5 | 9 | 2026-01-07 |
-| 4 | [📊 Smart Infographic (AntV)](https://openwebui.com/posts/smart_infographic_ad6f0c7f) | action | 1.4.1 | 87 | 1123 | 7 | 8 | 2026-01-07 |
-| 5 | [Flash Card](https://openwebui.com/posts/flash_card_65a2ea8f) | action | 0.2.4 | 84 | 1561 | 8 | 5 | 2026-01-07 |
-| 6 | [Export to Word (Enhanced)](https://openwebui.com/posts/export_to_word_enhanced_formatting_fca6a315) | action | 0.4.3 | 69 | 644 | 5 | 5 | 2026-01-07 |
-| 7 | [📊 智能信息图 (AntV Infographic)](https://openwebui.com/posts/智能信息图_e04a48ff) | action | 1.4.1 | 33 | 434 | 3 | 0 | 2026-01-07 |
-| 8 | [导出为 Word (增强版)](https://openwebui.com/posts/导出为_word_支持公式流程图表格和代码块_8a6306c0) | action | 0.4.3 | 20 | 815 | 7 | 1 | 2026-01-07 |
-| 9 | [思维导图](https://openwebui.com/posts/智能生成交互式思维导图帮助用户可视化知识_8d4b097b) | action | 0.9.1 | 15 | 273 | 2 | 1 | 2026-01-07 |
-| 10 | [闪记卡 (Flash Card)](https://openwebui.com/posts/闪记卡生成插件_4a31eac3) | action | 0.2.4 | 12 | 329 | 3 | 1 | 2026-01-07 |
-| 11 | [异步上下文压缩](https://openwebui.com/posts/异步上下文压缩_5c0617cb) | filter | 1.1.0 | 5 | 126 | 2 | 1 | 2026-01-07 |
+| 1 | [Smart Mind Map](https://openwebui.com/posts/turn_any_text_into_beautiful_mind_maps_3094c59a) | action | 0.9.1 | 348 | 3165 | 10 | 21 | 2026-01-07 |
+| 2 | [Export to Excel](https://openwebui.com/posts/export_mulit_table_to_excel_244b8f9d) | action | 0.3.7 | 181 | 559 | 3 | 4 | 2026-01-07 |
+| 3 | [Async Context Compression](https://openwebui.com/posts/async_context_compression_b1655bc8) | filter | 1.1.1 | 128 | 1437 | 5 | 9 | 2026-01-10 |
+| 4 | [📊 Smart Infographic (AntV)](https://openwebui.com/posts/smart_infographic_ad6f0c7f) | action | 1.4.1 | 120 | 1393 | 7 | 9 | 2026-01-07 |
+| 5 | [Flash Card](https://openwebui.com/posts/flash_card_65a2ea8f) | action | 0.2.4 | 94 | 1766 | 8 | 6 | 2026-01-07 |
+| 6 | [Export to Word (Enhanced)](https://openwebui.com/posts/export_to_word_enhanced_formatting_fca6a315) | action | 0.4.3 | 87 | 814 | 5 | 8 | 2026-01-07 |
+| 7 | [📊 智能信息图 (AntV Infographic)](https://openwebui.com/posts/智能信息图_e04a48ff) | action | 1.4.1 | 35 | 486 | 3 | 0 | 2026-01-07 |
+| 8 | [导出为 Word (增强版)](https://openwebui.com/posts/导出为_word_支持公式流程图表格和代码块_8a6306c0) | action | 0.4.3 | 33 | 955 | 8 | 2 | 2026-01-07 |
+| 9 | [Deep Dive](https://openwebui.com/posts/deep_dive_c0b846e4) | action | 1.0.0 | 24 | 272 | 3 | 3 | 2026-01-08 |
+| 10 | [思维导图](https://openwebui.com/posts/智能生成交互式思维导图帮助用户可视化知识_8d4b097b) | action | 0.9.1 | 17 | 306 | 2 | 1 | 2026-01-07 |
+| 11 | [闪记卡 (Flash Card)](https://openwebui.com/posts/闪记卡生成插件_4a31eac3) | action | 0.2.4 | 12 | 349 | 4 | 1 | 2026-01-07 |
+| 12 | [异步上下文压缩](https://openwebui.com/posts/异步上下文压缩_5c0617cb) | filter | 1.1.1 | 7 | 177 | 3 | 1 | 2026-01-10 |
+| 13 | [精读](https://openwebui.com/posts/精读_99830b0f) | action | 1.0.0 | 1 | 94 | 2 | 1 | 2026-01-08 |
+| 14 | [ 🛠️ Debug Open WebUI Plugins in Your Browser](https://openwebui.com/posts/debug_open_webui_plugins_in_your_browser_81bf7960) | unknown |  | 0 | 80 | 5 | 1 | 2026-01-10 |
--- a/docs/community-stats.zh.md
+++ b/docs/community-stats.zh.md
@@ -1,35 +1,39 @@
 # 📊 OpenWebUI 社区统计报告

-> 📅 更新时间: 2026-01-08 08:35
+> 📅 更新时间: 2026-01-11 02:11

 ## 📈 总览

 | 指标 | 数值 |
 |------|------|
-| 📝 发布数量 | 11 |
-| ⬇️ 总下载量 | 916 |
-| 👁️ 总浏览量 | 9670 |
-| 👍 总点赞数 | 55 |
-| 💾 总收藏数 | 50 |
-| 💬 总评论数 | 15 |
+| 📝 发布数量 | 14 |
+| ⬇️ 总下载量 | 1087 |
+| 👁️ 总浏览量 | 11853 |
+| 👍 总点赞数 | 68 |
+| 💾 总收藏数 | 67 |
+| 💬 总评论数 | 17 |

 ## 📂 按类型分类

- **action**: 9
 - **filter**: 2
+- **unknown**: 1
+- **action**: 11

 ## 📋 发布列表

 | 排名 | 标题 | 类型 | 版本 | 下载 | 浏览 | 点赞 | 收藏 | 更新日期 |
 |:---:|------|:---:|:---:|:---:|:---:|:---:|:---:|:---:|
-| 1 | [Smart Mind Map](https://openwebui.com/posts/turn_any_text_into_beautiful_mind_maps_3094c59a) | action | 0.9.1 | 294 | 2550 | 10 | 16 | 2026-01-07 |
-| 2 | [Export to Excel](https://openwebui.com/posts/export_mulit_table_to_excel_244b8f9d) | action | 0.3.7 | 178 | 507 | 3 | 3 | 2026-01-07 |
-| 3 | [Async Context Compression](https://openwebui.com/posts/async_context_compression_b1655bc8) | filter | 1.1.0 | 119 | 1308 | 5 | 9 | 2026-01-07 |
-| 4 | [📊 Smart Infographic (AntV)](https://openwebui.com/posts/smart_infographic_ad6f0c7f) | action | 1.4.1 | 87 | 1123 | 7 | 8 | 2026-01-07 |
-| 5 | [Flash Card](https://openwebui.com/posts/flash_card_65a2ea8f) | action | 0.2.4 | 84 | 1561 | 8 | 5 | 2026-01-07 |
-| 6 | [Export to Word (Enhanced)](https://openwebui.com/posts/export_to_word_enhanced_formatting_fca6a315) | action | 0.4.3 | 69 | 644 | 5 | 5 | 2026-01-07 |
-| 7 | [📊 智能信息图 (AntV Infographic)](https://openwebui.com/posts/智能信息图_e04a48ff) | action | 1.4.1 | 33 | 434 | 3 | 0 | 2026-01-07 |
-| 8 | [导出为 Word (增强版)](https://openwebui.com/posts/导出为_word_支持公式流程图表格和代码块_8a6306c0) | action | 0.4.3 | 20 | 815 | 7 | 1 | 2026-01-07 |
-| 9 | [思维导图](https://openwebui.com/posts/智能生成交互式思维导图帮助用户可视化知识_8d4b097b) | action | 0.9.1 | 15 | 273 | 2 | 1 | 2026-01-07 |
-| 10 | [闪记卡 (Flash Card)](https://openwebui.com/posts/闪记卡生成插件_4a31eac3) | action | 0.2.4 | 12 | 329 | 3 | 1 | 2026-01-07 |
-| 11 | [异步上下文压缩](https://openwebui.com/posts/异步上下文压缩_5c0617cb) | filter | 1.1.0 | 5 | 126 | 2 | 1 | 2026-01-07 |
+| 1 | [Smart Mind Map](https://openwebui.com/posts/turn_any_text_into_beautiful_mind_maps_3094c59a) | action | 0.9.1 | 348 | 3165 | 10 | 21 | 2026-01-07 |
+| 2 | [Export to Excel](https://openwebui.com/posts/export_mulit_table_to_excel_244b8f9d) | action | 0.3.7 | 181 | 559 | 3 | 4 | 2026-01-07 |
+| 3 | [Async Context Compression](https://openwebui.com/posts/async_context_compression_b1655bc8) | filter | 1.1.1 | 128 | 1437 | 5 | 9 | 2026-01-10 |
+| 4 | [📊 Smart Infographic (AntV)](https://openwebui.com/posts/smart_infographic_ad6f0c7f) | action | 1.4.1 | 120 | 1393 | 7 | 9 | 2026-01-07 |
+| 5 | [Flash Card](https://openwebui.com/posts/flash_card_65a2ea8f) | action | 0.2.4 | 94 | 1766 | 8 | 6 | 2026-01-07 |
+| 6 | [Export to Word (Enhanced)](https://openwebui.com/posts/export_to_word_enhanced_formatting_fca6a315) | action | 0.4.3 | 87 | 814 | 5 | 8 | 2026-01-07 |
+| 7 | [📊 智能信息图 (AntV Infographic)](https://openwebui.com/posts/智能信息图_e04a48ff) | action | 1.4.1 | 35 | 486 | 3 | 0 | 2026-01-07 |
+| 8 | [导出为 Word (增强版)](https://openwebui.com/posts/导出为_word_支持公式流程图表格和代码块_8a6306c0) | action | 0.4.3 | 33 | 955 | 8 | 2 | 2026-01-07 |
+| 9 | [Deep Dive](https://openwebui.com/posts/deep_dive_c0b846e4) | action | 1.0.0 | 24 | 272 | 3 | 3 | 2026-01-08 |
+| 10 | [思维导图](https://openwebui.com/posts/智能生成交互式思维导图帮助用户可视化知识_8d4b097b) | action | 0.9.1 | 17 | 306 | 2 | 1 | 2026-01-07 |
+| 11 | [闪记卡 (Flash Card)](https://openwebui.com/posts/闪记卡生成插件_4a31eac3) | action | 0.2.4 | 12 | 349 | 4 | 1 | 2026-01-07 |
+| 12 | [异步上下文压缩](https://openwebui.com/posts/异步上下文压缩_5c0617cb) | filter | 1.1.1 | 7 | 177 | 3 | 1 | 2026-01-10 |
+| 13 | [精读](https://openwebui.com/posts/精读_99830b0f) | action | 1.0.0 | 1 | 94 | 2 | 1 | 2026-01-08 |
+| 14 | [ 🛠️ Debug Open WebUI Plugins in Your Browser](https://openwebui.com/posts/debug_open_webui_plugins_in_your_browser_81bf7960) | unknown |  | 0 | 80 | 5 | 1 | 2026-01-10 |
--- a/docs/development/frontend-console-debugging.md
+++ b/docs/development/frontend-console-debugging.md
@@ -0,0 +1,150 @@
+# 🛠️ Debugging Python Plugins with Frontend Console
+
+When developing plugins for Open WebUI, debugging can be challenging. Standard `print()` statements or server-side logging might not always be accessible, especially in hosted environments or when you want to see the data flow in real-time alongside the UI interactions.
+
+This guide introduces a powerful technique: **Frontend Console Debugging**. By injecting JavaScript from your Python plugin, you can print structured logs directly to the browser's Developer Tools console (F12).
+
+## Why Frontend Debugging?
+
+*   **Real-time Feedback**: See logs immediately as actions happen in the browser.
+*   **Rich Objects**: Inspect complex JSON objects (like `body` or `messages`) interactively, rather than reading massive text dumps.
+*   **No Server Access Needed**: Debug issues even if you don't have SSH/Console access to the backend server.
+*   **Clean Output**: Group logs using `console.group()` to keep your console organized.
+
+## The Core Mechanism
+
+Open WebUI plugins (both Actions and Filters) support an event system. We can leverage the `__event_call__` (or sometimes `__event_emitter__`) to send a special event of type `execute`. This tells the frontend to run the provided JavaScript code.
+
+### The Helper Method
+
+To make this easy to use, we recommend adding a helper method `_emit_debug_log` to your plugin class.
+
+```python
+import json
+from typing import List
+
+async def _emit_debug_log(
+    self, 
+    __event_call__, 
+    title: str, 
+    data: dict
+):
+    """
+    Emit debug log to browser console via JS execution.
+    
+    Args:
+        __event_call__: The event callable passed to action/outlet.
+        title: A title for the log group.
+        data: A dictionary of data to log.
+    """
+    # 1. Check if debugging is enabled (recommended)
+    if not getattr(self.valves, "show_debug_log", True) or not __event_call__:
+        return
+
+    try:
+        # 2. Construct the JavaScript code
+        # We use an async IIFE (Immediately Invoked Function Expression) 
+        # to ensure a clean scope and support await if needed.
+        js_code = f"""
+            (async function() {{
+                console.group("🛠️ Plugin Debug: {title}");
+                console.log({json.dumps(data, ensure_ascii=False)});
+                console.groupEnd();
+            }})();
+        """
+
+        # 3. Send the execute event
+        await __event_call__(
+            {
+                "type": "execute",
+                "data": {"code": js_code},
+            }
+        )
+    except Exception as e:
+        print(f"Error emitting debug log: {e}")
+```
+
+## Implementation Steps
+
+### 1. Add a Valve for Control
+
+It's best practice to make debugging optional so it doesn't clutter the console for normal users.
+
+```python
+from pydantic import BaseModel, Field
+
+class Filter:
+    class Valves(BaseModel):
+        show_debug_log: bool = Field(
+            default=False, 
+            description="Print debug logs to browser console (F12)"
+        )
+    
+    def __init__(self):
+        self.valves = self.Valves()
+```
+
+### 2. Inject `__event_call__`
+
+Ensure your `action` (for Actions) or `outlet` (for Filters) method accepts `__event_call__`.
+
+**For Filters (`outlet`):**
+
+```python
+async def outlet(
+    self,
+    body: dict,
+    __user__: Optional[dict] = None,
+    __event_call__=None,  # <--- Add this
+    __metadata__: Optional[dict] = None,
+) -> dict:
+```
+
+**For Actions (`action`):**
+
+```python
+async def action(
+    self,
+    body: dict,
+    __user__=None,
+    __event_call__=None, # <--- Add this
+    __request__=None,
+):
+```
+
+### 3. Call the Helper
+
+Now you can log anything, anywhere in your logic!
+
+```python
+# Inside your logic...
+new_content = self.process_content(content)
+
+# Log the before and after
+await self._emit_debug_log(
+    __event_call__,
+    "Content Normalization",
+    {
+        "original": content,
+        "processed": new_content,
+        "changes": diff_list
+    }
+)
+```
+
+## Best Practices
+
+1.  **Use `json.dumps`**: Always serialize your Python dictionaries to JSON strings before embedding them in the f-string. This handles escaping quotes and special characters correctly.
+2.  **Async IIFE**: Wrapping your JS in `(async function() { ... })();` is safer than raw code. It prevents variable collisions with other scripts and allows using `await` inside your debug script if you ever need to check DOM elements.
+3.  **Check for None**: Always check if `__event_call__` is not None before using it, as it might not be available in all contexts (e.g., when running tests or in older Open WebUI versions).
+
+## Example Output
+
+When enabled, your browser console will show:
+
+```text
+> 🛠️ Plugin Debug: Content Normalization
+  > {original: "...", processed: "...", changes: [...]}
+```
+
+You can expand the object to inspect every detail of your data. Happy debugging!
--- a/docs/development/mermaid-syntax-standards.md
+++ b/docs/development/mermaid-syntax-standards.md
@@ -0,0 +1,64 @@
+# Mermaid Syntax Standards & Best Practices
+
+This document summarizes the official syntax standards for Mermaid flowcharts, focusing on node labels, quoting rules, and special character handling. It serves as a reference for the `markdown_normalizer` plugin logic.
+
+## 1. Node Shapes & Syntax
+
+Mermaid supports various node shapes defined by specific wrapping characters.
+
+| Shape | Syntax | Example |
+| :--- | :--- | :--- |
+| **Rectangle** (Default) | `id[Label]` | `A[Start]` |
+| **Rounded** | `id(Label)` | `B(Process)` |
+| **Stadium** (Pill) | `id([Label])` | `C([End])` |
+| **Subroutine** | `id[[Label]]` | `D[[Subroutine]]` |
+| **Cylinder** (Database) | `id[(Label)]` | `E[(Database)]` |
+| **Circle** | `id((Label))` | `F((Point))` |
+| **Double Circle** | `id(((Label)))` | `G(((Endpoint)))` |
+| **Asymmetric** | `id>Label]` | `H>Flag]` |
+| **Rhombus** (Decision) | `id{Label}` | `I{Decision}` |
+| **Hexagon** | `id{{Label}}` | `J{{Prepare}}` |
+| **Parallelogram** | `id[/Label/]` | `K[/Input/]` |
+| **Parallelogram Alt** | `id[\Label\]` | `L[\Output\]` |
+| **Trapezoid** | `id[/Label\]` | `M[/Trap/]` |
+| **Trapezoid Alt** | `id[\Label/]` | `N[\TrapAlt/]` |
+
+## 2. Quoting Rules (Critical)
+
+### Why Quote?
+Quoting node labels is **highly recommended** and sometimes **mandatory** to prevent syntax errors.
+
+### Mandatory Quoting Scenarios
+You **MUST** enclose labels in double quotes `"` if they contain:
+1.  **Special Characters**: `()`, `[]`, `{}`, `;`, `"`, etc.
+2.  **Keywords**: Words like `end`, `subgraph`, etc., if used in specific contexts.
+3.  **Unicode/Emoji**: While often supported without quotes, quoting ensures consistent rendering across different environments.
+4.  **Markdown**: If you want to use Markdown formatting (bold, italic) inside a label.
+
+### Best Practice: Always Quote
+To ensure robustness, especially when processing LLM-generated content which may contain unpredictable characters, **always enclosing labels in double quotes is the safest strategy**.
+
+**Examples:**
+*   ❌ Risky: `id(Start: 15:00)` (Colon might be interpreted as style separator)
+*   ✅ Safe: `id("Start: 15:00")`
+*   ❌ Broken: `id(Func(x))` (Nested parentheses break parsing)
+*   ✅ Safe: `id("Func(x)")`
+
+## 3. Escape Characters
+
+Inside a quoted string:
+*   Double quotes `"` must be escaped as `\"`.
+*   HTML entities (e.g., `#35;` for `#`) can be used.
+
+## 4. Plugin Logic Verification
+
+The `markdown_normalizer` plugin implements the following logic:
+
+1.  **Detection**: Identifies Mermaid node definitions using a comprehensive regex covering all shapes above.
+2.  **Normalization**:
+    *   Checks if the label is already quoted.
+    *   If **NOT quoted**, it wraps the label in double quotes `""`.
+    *   Escapes any existing double quotes inside the label (`"` -> `\"`).
+3.  **Shape Preservation**: The regex captures the specific opening and closing delimiters (e.g., `((` and `))`) to ensure the node shape is strictly preserved during normalization.
+
+**Conclusion**: The plugin's behavior of automatically adding quotes to unquoted labels is **fully aligned with Mermaid's official best practices** for robustness and error prevention.
--- a/docs/plugins/actions/summary.md
+++ b/docs/plugins/actions/summary.md
@@ -1,82 +0,0 @@
-# Summary
-
-<span class="category-badge action">Action</span>
-<span class="version-badge">v0.1.0</span>
-
-Generate concise summaries of long text content with key points extraction.
-
---
-
-## Overview
-
-The Summary plugin helps you quickly understand long pieces of text by generating concise summaries with extracted key points. It's perfect for:
-
- Summarizing long articles or documents
- Extracting key points from conversations
- Creating quick overviews of complex topics
-
-## Features
-
- :material-text-box-search: **Smart Summarization**: AI-powered content analysis
- :material-format-list-bulleted: **Key Points**: Extracted important highlights
- :material-content-copy: **Easy Copy**: One-click copying of summaries
- :material-tune: **Adjustable Length**: Control summary detail level
-
---
-
-## Installation
-
-1. Download the plugin file: [`summary.py`](https://github.com/Fu-Jie/awesome-openwebui/tree/main/plugins/actions/summary)
-2. Upload to OpenWebUI: **Admin Panel** → **Settings** → **Functions**
-3. Enable the plugin
-
---
-
-## Usage
-
-1. Get a long response from the AI or paste long text
-2. Click the **Summary** button in the message action bar
-3. View the generated summary with key points
-
---
-
-## Configuration
-
-| Option | Type | Default | Description |
-|--------|------|---------|-------------|
-| `summary_length` | string | `"medium"` | Length of summary (short/medium/long) |
-| `include_key_points` | boolean | `true` | Extract and list key points |
-| `language` | string | `"auto"` | Output language |
-
---
-
-## Example Output
-
-```markdown
-## Summary
-
-This document discusses the implementation of a new feature 
-for the application, focusing on user experience improvements 
-and performance optimizations.
-
-### Key Points
-
- ✅ New user interface design improves accessibility
- ✅ Backend optimizations reduce load times by 40%
- ✅ Mobile responsiveness enhanced
- ✅ Integration with third-party services simplified
-```
-
---
-
-## Requirements
-
-!!! note "Prerequisites"
-    - OpenWebUI v0.3.0 or later
-    - Uses the active LLM model for summarization
-
---
-
-## Source Code
-
-[:fontawesome-brands-github: View on GitHub](https://github.com/Fu-Jie/awesome-openwebui/tree/main/plugins/actions/summary){ .md-button }
--- a/docs/plugins/actions/summary.zh.md
+++ b/docs/plugins/actions/summary.zh.md
@@ -1,82 +0,0 @@
-# Summary（摘要）
-
-<span class="category-badge action">Action</span>
-<span class="version-badge">v0.1.0</span>
-
-为长文本生成简洁摘要，并提取关键要点。
-
---
-
-## 概览
-
-Summary 插件可以快速理解长文本，生成精炼摘要并列出关键点，适合：
-
- 总结长文章或文档
- 从对话中提炼要点
- 为复杂主题制作快速概览
-
-## 功能特性
-
- :material-text-box-search: **智能摘要**：AI 驱动的内容分析
- :material-format-list-bulleted: **关键点**：提取重要信息
- :material-content-copy: **便捷复制**：一键复制摘要
- :material-tune: **长度可调**：可选择摘要详略程度
-
---
-
-## 安装
-
-1. 下载插件文件：[`summary.py`](https://github.com/Fu-Jie/awesome-openwebui/tree/main/plugins/actions/summary)
-2. 上传到 OpenWebUI：**Admin Panel** → **Settings** → **Functions**
-3. 启用插件
-
---
-
-## 使用方法
-
-1. 获取一段较长的 AI 回复或粘贴长文本
-2. 点击消息操作栏的 **Summary** 按钮
-3. 查看生成的摘要与关键点
-
---
-
-## 配置项
-
-| 选项 | 类型 | 默认值 | 说明 |
-|--------|------|---------|-------------|
-| `summary_length` | string | `"medium"` | 摘要长度（short/medium/long） |
-| `include_key_points` | boolean | `true` | 是否提取并列出关键点 |
-| `language` | string | `"auto"` | 输出语言 |
-
---
-
-## 输出示例
-
-```markdown
-## Summary
-
-This document discusses the implementation of a new feature 
-for the application, focusing on user experience improvements 
-and performance optimizations.
-
-### Key Points
-
- ✅ New user interface design improves accessibility
- ✅ Backend optimizations reduce load times by 40%
- ✅ Mobile responsiveness enhanced
- ✅ Integration with third-party services simplified
-```
-
---
-
-## 运行要求
-
-!!! note "前置条件"
-    - OpenWebUI v0.3.0 及以上
-    - 使用当前会话的 LLM 模型进行摘要
-
---
-
-## 源码
-
-[:fontawesome-brands-github: 在 GitHub 查看](https://github.com/Fu-Jie/awesome-openwebui/tree/main/plugins/actions/summary){ .md-button }
--- a/docs/plugins/filters/async-context-compression.md
+++ b/docs/plugins/filters/async-context-compression.md
@@ -1,7 +1,7 @@
 # Async Context Compression

 <span class="category-badge filter">Filter</span>
-<span class="version-badge">v1.1.0</span>
+<span class="version-badge">v1.1.2</span>

 Reduces token consumption in long conversations through intelligent summarization while maintaining conversational coherence.

@@ -29,6 +29,9 @@ This is especially useful for:
 - :material-clock-fast: **Async Processing**: Non-blocking background compression
 - :material-memory: **Context Preservation**: Keeps important information
 - :material-currency-usd-off: **Cost Reduction**: Minimize token usage
+- :material-console: **Frontend Debugging**: Debug logs in browser console
+- :material-alert-circle-check: **Enhanced Error Reporting**: Clear error status notifications
+- :material-check-all: **Open WebUI v0.7.x Compatibility**: Dynamic DB session handling

 ---

--- a/docs/plugins/filters/async-context-compression.zh.md
+++ b/docs/plugins/filters/async-context-compression.zh.md
@@ -1,7 +1,7 @@
 # Async Context Compression（异步上下文压缩）

 <span class="category-badge filter">Filter</span>
-<span class="version-badge">v1.1.0</span>
+<span class="version-badge">v1.1.2</span>

 通过智能摘要减少长对话的 token 消耗，同时保持对话连贯。

@@ -29,6 +29,9 @@ Async Context Compression 过滤器通过以下方式帮助管理长对话的 to
 - :material-clock-fast: **异步处理**：后台非阻塞压缩
 - :material-memory: **保留上下文**：尽量保留重要信息
 - :material-currency-usd-off: **降低成本**：减少 token 使用
+- :material-console: **前端调试**：支持浏览器控制台日志
+- :material-alert-circle-check: **增强错误报告**：清晰的错误状态通知
+- :material-check-all: **Open WebUI v0.7.x 兼容性**：动态数据库会话处理

 ---

--- a/docs/plugins/filters/index.md
+++ b/docs/plugins/filters/index.md
@@ -22,7 +22,7 @@ Filters act as middleware in the message pipeline:

    Reduces token consumption in long conversations through intelligent summarization while maintaining coherence.

-    **Version:** 1.1.0
+    **Version:** 1.1.2

    [:octicons-arrow-right-24: Documentation](async-context-compression.md)

--- a/docs/plugins/index.md
+++ b/docs/plugins/index.md
@@ -53,7 +53,6 @@ OpenWebUI supports four types of plugins, each serving a different purpose:
 | [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 |
 | [Export to Word](actions/export-to-word.md) | Action | Export chat content to Word (.docx) with formatting | 0.1.0 |
-| [Summary](actions/summary.md) | Action | Text summarization tool | 1.0.0 |
 | [Async Context Compression](filters/async-context-compression.md) | Filter | Intelligent context compression | 1.0.0 |
 | [Context Enhancement](filters/context-enhancement.md) | Filter | Enhance chat context | 1.0.0 |
 | [Gemini Manifold Companion](filters/gemini-manifold-companion.md) | Filter | Companion for Gemini Manifold | 1.0.0 |
--- a/docs/plugins/index.zh.md
+++ b/docs/plugins/index.zh.md
@@ -53,7 +53,6 @@ OpenWebUI 支持四种类型的插件，每种都有不同的用途：
 | [Knowledge Card（知识卡片）](actions/knowledge-card.md) | Action | 生成精美学习卡片 | 0.2.0 |
 | [Export to Excel（导出到 Excel）](actions/export-to-excel.md) | Action | 导出聊天记录为 Excel | 1.0.0 |
 | [Export to Word（导出为 Word）](actions/export-to-word.md) | Action | 将聊天内容导出为 Word (.docx) 并保留格式 | 0.1.0 |
-| [Summary（摘要）](actions/summary.md) | Action | 文本摘要工具 | 1.0.0 |
 | [Async Context Compression（异步上下文压缩）](filters/async-context-compression.md) | Filter | 智能上下文压缩 | 1.0.0 |
 | [Context Enhancement（上下文增强）](filters/context-enhancement.md) | Filter | 提升对话上下文 | 1.0.0 |
 | [Gemini Manifold Companion](filters/gemini-manifold-companion.md) | Filter | Gemini Manifold 伴侣 | 1.0.0 |
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -187,7 +187,6 @@ nav:
      - Knowledge Card: plugins/actions/knowledge-card.md
      - Export to Excel: plugins/actions/export-to-excel.md
      - Export to Word: plugins/actions/export-to-word.md
-      - Summary: plugins/actions/summary.md
    - Filters:
      - plugins/filters/index.md
      - Async Context Compression: plugins/filters/async-context-compression.md
--- a/plugins/actions/export_to_docx/export_to_word.png
+++ b/plugins/actions/export_to_docx/export_to_word.png
--- a/plugins/actions/export_to_docx/export_to_word_cn.png
+++ b/plugins/actions/export_to_docx/export_to_word_cn.png
--- a/plugins/actions/infographic/infographic.png
+++ b/plugins/actions/infographic/infographic.png
--- a/plugins/actions/infographic/infographic_cn.png
+++ b/plugins/actions/infographic/infographic_cn.png
--- a/plugins/actions/js-render-poc/README.md
+++ b/plugins/actions/js-render-poc/README.md
@@ -1,170 +0,0 @@
-# Infographic to Markdown
-
-> **Version:** 1.0.0
-
-AI-powered infographic generator that renders SVG on the frontend and embeds it directly into Markdown as a Data URL image.
-
-## Overview
-
-This plugin combines the power of AI text analysis with AntV Infographic visualization to create beautiful infographics that are embedded directly into chat messages as Markdown images.
-
-### How It Works
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│                    Open WebUI Plugin                         │
-├─────────────────────────────────────────────────────────────┤
-│  1. Python Action                                            │
-│     ├── Receive message content                              │
-│     ├── Call LLM to generate Infographic syntax              │
-│     └── Send __event_call__ to execute frontend JS           │
-├─────────────────────────────────────────────────────────────┤
-│  2. Browser JS (via __event_call__)                          │
-│     ├── Dynamically load AntV Infographic library            │
-│     ├── Render SVG offscreen                                 │
-│     ├── Export to Data URL via toDataURL()                   │
-│     └── Update message content via REST API                  │
-├─────────────────────────────────────────────────────────────┤
-│  3. Markdown Rendering                                       │
-│     └── Display ![description](data:image/svg+xml;base64,...) │
-└─────────────────────────────────────────────────────────────┘
-```
-
-## Features
-
- 🤖 **AI-Powered**: Automatically analyzes text and selects the best infographic template
- 📊 **Multiple Templates**: Supports 18+ infographic templates (lists, charts, comparisons, etc.)
- 🖼️ **Self-Contained**: SVG/PNG embedded as Data URL, no external dependencies
- 📝 **Markdown Native**: Results are pure Markdown images, compatible everywhere
- 🔄 **API Writeback**: Updates message content via REST API for persistence
-
-## Plugins in This Directory
-
-### 1. `infographic_markdown.py` - Main Plugin ⭐
- **Purpose**: Production use
- **Features**: Full AI + AntV Infographic + Data URL embedding
-
-### 2. `js_render_poc.py` - Proof of Concept
- **Purpose**: Learning and testing
- **Features**: Simple SVG creation demo, `__event_call__` pattern
-
-## Configuration (Valves)
-
-| Parameter | Type | Default | Description |
-|-----------|------|---------|-------------|
-| `SHOW_STATUS` | bool | `true` | Show operation status updates |
-| `MODEL_ID` | string | `""` | LLM model ID (empty = use current model) |
-| `MIN_TEXT_LENGTH` | int | `50` | Minimum text length required |
-| `MESSAGE_COUNT` | int | `1` | Number of recent messages to use |
-| `SVG_WIDTH` | int | `800` | Width of generated SVG (pixels) |
-| `EXPORT_FORMAT` | string | `"svg"` | Export format: `svg` or `png` |
-
-## Supported Templates
-
-| Category | Template | Description |
-|----------|----------|-------------|
-| List | `list-grid` | Grid cards |
-| List | `list-vertical` | Vertical list |
-| Tree | `tree-vertical` | Vertical tree |
-| Tree | `tree-horizontal` | Horizontal tree |
-| Mind Map | `mindmap` | Mind map |
-| Process | `sequence-roadmap` | Roadmap |
-| Process | `sequence-zigzag` | Zigzag process |
-| Relation | `relation-sankey` | Sankey diagram |
-| Relation | `relation-circle` | Circular relation |
-| Compare | `compare-binary` | Binary comparison |
-| Analysis | `compare-swot` | SWOT analysis |
-| Quadrant | `quadrant-quarter` | Quadrant chart |
-| Chart | `chart-bar` | Bar chart |
-| Chart | `chart-column` | Column chart |
-| Chart | `chart-line` | Line chart |
-| Chart | `chart-pie` | Pie chart |
-| Chart | `chart-doughnut` | Doughnut chart |
-| Chart | `chart-area` | Area chart |
-
-## Syntax Examples
-
-### Grid List
-```infographic
-infographic list-grid
-data
-  title Project Overview
-  items
-    - label Module A
-      desc Description of module A
-    - label Module B
-      desc Description of module B
-```
-
-### Binary Comparison
-```infographic
-infographic compare-binary
-data
-  title Pros vs Cons
-  items
-    - label Pros
-      children
-        - label Strong R&D
-          desc Technology leadership
-    - label Cons
-      children
-        - label Weak brand
-          desc Insufficient marketing
-```
-
-### Bar Chart
-```infographic
-infographic chart-bar
-data
-  title Quarterly Revenue
-  items
-    - label Q1
-      value 120
-    - label Q2
-      value 150
-```
-
-## Technical Details
-
-### Data URL Embedding
-```javascript
-// SVG to Base64 Data URL
-const svgData = new XMLSerializer().serializeToString(svg);
-const base64 = btoa(unescape(encodeURIComponent(svgData)));
-const dataUri = "data:image/svg+xml;base64," + base64;
-
-// Markdown image syntax
-const markdownImage = `![description](${dataUri})`;
-```
-
-### AntV toDataURL API
-```javascript
-// Export as SVG (recommended, supports embedded resources)
-const svgUrl = await instance.toDataURL({
-    type: 'svg',
-    embedResources: true
-});
-
-// Export as PNG (more compatible but larger)
-const pngUrl = await instance.toDataURL({
-    type: 'png',
-    dpr: 2
-});
-```
-
-## Notes
-
-1. **Browser Compatibility**: Requires modern browsers with ES6+ and Fetch API support
-2. **Network Dependency**: First use requires loading AntV library from CDN
-3. **Data URL Size**: Base64 encoding increases size by ~33%
-4. **Chinese Fonts**: SVG export embeds fonts for correct display
-
-## Related Resources
-
- [AntV Infographic Documentation](https://infographic.antv.vision/)
- [Infographic API Reference](https://infographic.antv.vision/reference/infographic-api)
- [Infographic Syntax Guide](https://infographic.antv.vision/learn/infographic-syntax)
-
-## License
-
-MIT License
--- a/plugins/actions/js-render-poc/README_CN.md
+++ b/plugins/actions/js-render-poc/README_CN.md
@@ -1,174 +0,0 @@
-# 信息图转 Markdown
-
-> **版本:** 1.0.0
-
-AI 驱动的信息图生成器，在前端渲染 SVG 并以 Data URL 图片格式直接嵌入到 Markdown 中。
-
-## 概述
-
-这个插件结合了 AI 文本分析能力和 AntV Infographic 可视化引擎，生成精美的信息图并以 Markdown 图片格式直接嵌入到聊天消息中。
-
-### 工作原理
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│                    Open WebUI 插件                           │
-├─────────────────────────────────────────────────────────────┤
-│  1. Python Action                                            │
-│     ├── 接收消息内容                                          │
-│     ├── 调用 LLM 生成 Infographic 语法                        │
-│     └── 发送 __event_call__ 执行前端 JS                      │
-├─────────────────────────────────────────────────────────────┤
-│  2. 浏览器 JS (通过 __event_call__)                          │
-│     ├── 动态加载 AntV Infographic 库                          │
-│     ├── 离屏渲染 SVG                                          │
-│     ├── 使用 toDataURL() 导出 Data URL                        │
-│     └── 通过 REST API 更新消息内容                            │
-├─────────────────────────────────────────────────────────────┤
-│  3. Markdown 渲染                                            │
-│     └── 显示 ![描述](data:image/svg+xml;base64,...)          │
-└─────────────────────────────────────────────────────────────┘
-```
-
-## 功能特点
-
- 🤖 **AI 驱动**: 自动分析文本并选择最佳的信息图模板
- 📊 **多种模板**: 支持 18+ 种信息图模板（列表、图表、对比等）
- 🖼️ **自包含**: SVG/PNG 以 Data URL 嵌入，无外部依赖
- 📝 **Markdown 原生**: 结果是纯 Markdown 图片，兼容任何平台
- 🔄 **API 回写**: 通过 REST API 更新消息内容实现持久化
-
-## 目录中的插件
-
-### 1. `infographic_markdown.py` - 主插件 ⭐
- **用途**: 生产使用
- **功能**: 完整的 AI + AntV Infographic + Data URL 嵌入
-
-### 2. `infographic_markdown_cn.py` - 主插件（中文版）
- **用途**: 生产使用
- **功能**: 与英文版相同，界面文字为中文
-
-### 3. `js_render_poc.py` - 概念验证
- **用途**: 学习和测试
- **功能**: 简单的 SVG 创建演示，`__event_call__` 模式
-
-## 配置选项 (Valves)
-
-| 参数 | 类型 | 默认值 | 描述 |
-|------|------|--------|------|
-| `SHOW_STATUS` | bool | `true` | 是否显示操作状态 |
-| `MODEL_ID` | string | `""` | LLM 模型 ID（空则使用当前模型） |
-| `MIN_TEXT_LENGTH` | int | `50` | 最小文本长度要求 |
-| `MESSAGE_COUNT` | int | `1` | 用于生成的最近消息数量 |
-| `SVG_WIDTH` | int | `800` | 生成的 SVG 宽度（像素） |
-| `EXPORT_FORMAT` | string | `"svg"` | 导出格式：`svg` 或 `png` |
-
-## 支持的模板
-
-| 类别 | 模板名称 | 描述 |
-|------|----------|------|
-| 列表 | `list-grid` | 网格卡片 |
-| 列表 | `list-vertical` | 垂直列表 |
-| 树形 | `tree-vertical` | 垂直树 |
-| 树形 | `tree-horizontal` | 水平树 |
-| 思维导图 | `mindmap` | 思维导图 |
-| 流程 | `sequence-roadmap` | 路线图 |
-| 流程 | `sequence-zigzag` | 折线流程 |
-| 关系 | `relation-sankey` | 桑基图 |
-| 关系 | `relation-circle` | 圆形关系 |
-| 对比 | `compare-binary` | 二元对比 |
-| 分析 | `compare-swot` | SWOT 分析 |
-| 象限 | `quadrant-quarter` | 四象限图 |
-| 图表 | `chart-bar` | 条形图 |
-| 图表 | `chart-column` | 柱状图 |
-| 图表 | `chart-line` | 折线图 |
-| 图表 | `chart-pie` | 饼图 |
-| 图表 | `chart-doughnut` | 环形图 |
-| 图表 | `chart-area` | 面积图 |
-
-## 语法示例
-
-### 网格列表
-```infographic
-infographic list-grid
-data
-  title 项目概览
-  items
-    - label 模块一
-      desc 这是第一个模块的描述
-    - label 模块二
-      desc 这是第二个模块的描述
-```
-
-### 二元对比
-```infographic
-infographic compare-binary
-data
-  title 优劣对比
-  items
-    - label 优势
-      children
-        - label 研发能力强
-          desc 技术领先
-    - label 劣势
-      children
-        - label 品牌曝光不足
-          desc 营销力度不够
-```
-
-### 条形图
-```infographic
-infographic chart-bar
-data
-  title 季度收入
-  items
-    - label Q1
-      value 120
-    - label Q2
-      value 150
-```
-
-## 技术细节
-
-### Data URL 嵌入
-```javascript
-// SVG 转 Base64 Data URL
-const svgData = new XMLSerializer().serializeToString(svg);
-const base64 = btoa(unescape(encodeURIComponent(svgData)));
-const dataUri = "data:image/svg+xml;base64," + base64;
-
-// Markdown 图片语法
-const markdownImage = `![描述](${dataUri})`;
-```
-
-### AntV toDataURL API
-```javascript
-// 导出 SVG（推荐，支持嵌入资源）
-const svgUrl = await instance.toDataURL({
-    type: 'svg',
-    embedResources: true
-});
-
-// 导出 PNG（更兼容但体积更大）
-const pngUrl = await instance.toDataURL({
-    type: 'png',
-    dpr: 2
-});
-```
-
-## 注意事项
-
-1. **浏览器兼容性**: 需要现代浏览器支持 ES6+ 和 Fetch API
-2. **网络依赖**: 首次使用需要从 CDN 加载 AntV Infographic 库
-3. **Data URL 大小**: Base64 编码会增加约 33% 的体积
-4. **中文字体**: SVG 导出时会嵌入字体以确保正确显示
-
-## 相关资源
-
- [AntV Infographic 官方文档](https://infographic.antv.vision/)
- [Infographic API 参考](https://infographic.antv.vision/reference/infographic-api)
- [Infographic 语法规范](https://infographic.antv.vision/learn/infographic-syntax)
-
-## 许可证
-
-MIT License
--- a/plugins/actions/js-render-poc/infographic_markdown.py
+++ b/plugins/actions/js-render-poc/infographic_markdown.py
@@ -1,592 +0,0 @@
-"""
-title: 📊 Infographic to Markdown
-author: Fu-Jie
-version: 1.0.0
-description: AI生成信息图语法，前端渲染SVG并转换为Markdown图片格式嵌入消息。支持AntV Infographic模板。
-"""
-
-import time
-import json
-import logging
-import re
-from typing import Optional, Callable, Awaitable, Any, Dict
-from pydantic import BaseModel, Field
-from fastapi import Request
-from datetime import datetime
-
-from open_webui.utils.chat import generate_chat_completion
-from open_webui.models.users import Users
-
-logging.basicConfig(level=logging.INFO)
-logger = logging.getLogger(__name__)
-
-# =================================================================
-# LLM Prompts
-# =================================================================
-
-SYSTEM_PROMPT_INFOGRAPHIC = """
-You are a professional infographic design expert who can analyze user-provided text content and convert it into AntV Infographic syntax format.
-
-## Infographic Syntax Specification
-
-Infographic syntax is a Mermaid-like declarative syntax for describing infographic templates, data, and themes.
-
-### Syntax Rules
- Entry uses `infographic <template-name>`
- Key-value pairs are separated by spaces, **absolutely NO colons allowed**
- Use two spaces for indentation
- Object arrays use `-` with line breaks
-
-⚠️ **IMPORTANT WARNING: This is NOT YAML format!**
- ❌ Wrong: `children:` `items:` `data:` (with colons)
- ✅ Correct: `children` `items` `data` (without colons)
-
-### Template Library & Selection Guide
-
-Choose the most appropriate template based on the content structure:
-
-#### 1. List & Hierarchy
- **List**: `list-grid` (Grid Cards), `list-vertical` (Vertical List)
- **Tree**: `tree-vertical` (Vertical Tree), `tree-horizontal` (Horizontal Tree)
- **Mindmap**: `mindmap` (Mind Map)
-
-#### 2. Sequence & Relationship
- **Process**: `sequence-roadmap` (Roadmap), `sequence-zigzag` (Zigzag Process)
- **Relationship**: `relation-sankey` (Sankey Diagram), `relation-circle` (Circular)
-
-#### 3. Comparison & Analysis
- **Comparison**: `compare-binary` (Binary Comparison)
- **Analysis**: `compare-swot` (SWOT Analysis), `quadrant-quarter` (Quadrant Chart)
-
-#### 4. Charts & Data
- **Charts**: `chart-bar`, `chart-column`, `chart-line`, `chart-pie`, `chart-doughnut`, `chart-area`
-
-### Data Structure Examples
-
-#### A. Standard List/Tree
-```infographic
-infographic list-grid
-data
-  title Project Modules
-  items
-    - label Module A
-      desc Description of A
-    - label Module B
-      desc Description of B
-```
-
-#### B. Binary Comparison
-```infographic
-infographic compare-binary
-data
-  title Advantages vs Disadvantages
-  items
-    - label Advantages
-      children
-        - label Strong R&D
-          desc Leading technology
-    - label Disadvantages
-      children
-        - label Weak brand
-          desc Insufficient marketing
-```
-
-#### C. Charts
-```infographic
-infographic chart-bar
-data
-  title Quarterly Revenue
-  items
-    - label Q1
-      value 120
-    - label Q2
-      value 150
-```
-
-### Common Data Fields
- `label`: Main title/label (Required)
- `desc`: Description text (max 30 Chinese chars / 60 English chars for `list-grid`)
- `value`: Numeric value (for charts)
- `children`: Nested items
-
-## Output Requirements
-1. **Language**: Output content in the user's language.
-2. **Format**: Wrap output in ```infographic ... ```.
-3. **No Colons**: Do NOT use colons after keys.
-4. **Indentation**: Use 2 spaces.
-"""
-
-USER_PROMPT_GENERATE = """
-Please analyze the following text content and convert its core information into AntV Infographic syntax format.
-
---
-**User Context:**
-User Name: {user_name}
-Current Date/Time: {current_date_time_str}
-User Language: {user_language}
---
-
-**Text Content:**
-{long_text_content}
-
-Please select the most appropriate infographic template based on text characteristics and output standard infographic syntax.
-
-**Important Note:** 
- If using `list-grid` format, ensure each card's `desc` description is limited to **maximum 30 Chinese characters** (or **approximately 60 English characters**).
- Descriptions should be concise and highlight key points.
-"""
-
-
-class Action:
-    class Valves(BaseModel):
-        SHOW_STATUS: bool = Field(
-            default=True, description="Show operation status updates in chat interface."
-        )
-        MODEL_ID: str = Field(
-            default="",
-            description="LLM model ID for text analysis. If empty, uses current conversation model.",
-        )
-        MIN_TEXT_LENGTH: int = Field(
-            default=50,
-            description="Minimum text length (characters) required for infographic analysis.",
-        )
-        MESSAGE_COUNT: int = Field(
-            default=1,
-            description="Number of recent messages to use for generation.",
-        )
-        SVG_WIDTH: int = Field(
-            default=800,
-            description="Width of generated SVG in pixels.",
-        )
-        EXPORT_FORMAT: str = Field(
-            default="svg",
-            description="Export format: 'svg' or 'png'.",
-        )
-
-    def __init__(self):
-        self.valves = self.Valves()
-
-    def _extract_chat_id(self, body: dict, metadata: Optional[dict]) -> str:
-        """Extract chat_id from body or metadata"""
-        if isinstance(body, dict):
-            chat_id = body.get("chat_id")
-            if isinstance(chat_id, str) and chat_id.strip():
-                return chat_id.strip()
-
-            body_metadata = body.get("metadata", {})
-            if isinstance(body_metadata, dict):
-                chat_id = body_metadata.get("chat_id")
-                if isinstance(chat_id, str) and chat_id.strip():
-                    return chat_id.strip()
-
-        if isinstance(metadata, dict):
-            chat_id = metadata.get("chat_id")
-            if isinstance(chat_id, str) and chat_id.strip():
-                return chat_id.strip()
-
-        return ""
-
-    def _extract_message_id(self, body: dict, metadata: Optional[dict]) -> str:
-        """Extract message_id from body or metadata"""
-        if isinstance(body, dict):
-            message_id = body.get("id")
-            if isinstance(message_id, str) and message_id.strip():
-                return message_id.strip()
-
-            body_metadata = body.get("metadata", {})
-            if isinstance(body_metadata, dict):
-                message_id = body_metadata.get("message_id")
-                if isinstance(message_id, str) and message_id.strip():
-                    return message_id.strip()
-
-        if isinstance(metadata, dict):
-            message_id = metadata.get("message_id")
-            if isinstance(message_id, str) and message_id.strip():
-                return message_id.strip()
-
-        return ""
-
-    def _extract_infographic_syntax(self, llm_output: str) -> str:
-        """Extract infographic syntax from LLM output"""
-        match = re.search(r"```infographic\s*(.*?)\s*```", llm_output, re.DOTALL)
-        if match:
-            return match.group(1).strip()
-        else:
-            logger.warning("LLM output did not follow expected format, treating entire output as syntax.")
-            return llm_output.strip()
-
-    def _extract_text_content(self, content) -> str:
-        """Extract text from message content, supporting multimodal formats"""
-        if isinstance(content, str):
-            return content
-        elif isinstance(content, list):
-            text_parts = []
-            for item in content:
-                if isinstance(item, dict) and item.get("type") == "text":
-                    text_parts.append(item.get("text", ""))
-                elif isinstance(item, str):
-                    text_parts.append(item)
-            return "\n".join(text_parts)
-        return str(content) if content else ""
-
-    async def _emit_status(self, emitter, description: str, done: bool = False):
-        """Send status update event"""
-        if self.valves.SHOW_STATUS and emitter:
-            await emitter(
-                {"type": "status", "data": {"description": description, "done": done}}
-            )
-
-    def _generate_js_code(
-        self,
-        unique_id: str,
-        chat_id: str,
-        message_id: str,
-        infographic_syntax: str,
-        svg_width: int,
-        export_format: str,
-    ) -> str:
-        """Generate JavaScript code for frontend SVG rendering"""
-        
-        # Escape the syntax for JS embedding
-        syntax_escaped = (
-            infographic_syntax
-            .replace("\\", "\\\\")
-            .replace("`", "\\`")
-            .replace("${", "\\${")
-            .replace("</script>", "<\\/script>")
-        )
-        
-        # Template mapping (same as infographic.py)
-        template_mapping_js = """
-        const TEMPLATE_MAPPING = {
-            'list-grid': 'list-grid-compact-card',
-            'list-vertical': 'list-column-simple-vertical-arrow',
-            'tree-vertical': 'hierarchy-tree-tech-style-capsule-item',
-            'tree-horizontal': 'hierarchy-tree-lr-tech-style-capsule-item',
-            'mindmap': 'hierarchy-mindmap-branch-gradient-capsule-item',
-            'sequence-roadmap': 'sequence-roadmap-vertical-simple',
-            'sequence-zigzag': 'sequence-horizontal-zigzag-simple',
-            'sequence-horizontal': 'sequence-horizontal-zigzag-simple',
-            'relation-sankey': 'relation-sankey-simple',
-            'relation-circle': 'relation-circle-icon-badge',
-            'compare-binary': 'compare-binary-horizontal-simple-vs',
-            'compare-swot': 'compare-swot',
-            'quadrant-quarter': 'quadrant-quarter-simple-card',
-            'statistic-card': 'list-grid-compact-card',
-            'chart-bar': 'chart-bar-plain-text',
-            'chart-column': 'chart-column-simple',
-            'chart-line': 'chart-line-plain-text',
-            'chart-area': 'chart-area-simple',
-            'chart-pie': 'chart-pie-plain-text',
-            'chart-doughnut': 'chart-pie-donut-plain-text'
-        };
-        """
-        
-        return f"""
-(async function() {{
-    const uniqueId = "{unique_id}";
-    const chatId = "{chat_id}";
-    const messageId = "{message_id}";
-    const svgWidth = {svg_width};
-    const exportFormat = "{export_format}";
-    
-    console.log("[Infographic Markdown] Starting render...");
-    console.log("[Infographic Markdown] chatId:", chatId, "messageId:", messageId);
-    
-    try {{
-        // Load AntV Infographic if not loaded
-        if (typeof AntVInfographic === 'undefined') {{
-            console.log("[Infographic Markdown] Loading AntV Infographic library...");
-            await new Promise((resolve, reject) => {{
-                const script = document.createElement('script');
-                script.src = 'https://unpkg.com/@antv/infographic@latest/dist/infographic.min.js';
-                script.onload = resolve;
-                script.onerror = reject;
-                document.head.appendChild(script);
-            }});
-            console.log("[Infographic Markdown] Library loaded.");
-        }}
-        
-        const {{ Infographic }} = AntVInfographic;
-        
-        // Get infographic syntax
-        let syntaxContent = `{syntax_escaped}`;
-        console.log("[Infographic Markdown] Original syntax:", syntaxContent.substring(0, 200) + "...");
-        
-        // Clean up syntax
-        const backtick = String.fromCharCode(96);
-        const prefix = backtick + backtick + backtick + 'infographic';
-        const simplePrefix = backtick + backtick + backtick;
-        
-        if (syntaxContent.toLowerCase().startsWith(prefix)) {{
-            syntaxContent = syntaxContent.substring(prefix.length).trim();
-        }} else if (syntaxContent.startsWith(simplePrefix)) {{
-            syntaxContent = syntaxContent.substring(simplePrefix.length).trim();
-        }}
-        
-        if (syntaxContent.endsWith(simplePrefix)) {{
-            syntaxContent = syntaxContent.substring(0, syntaxContent.length - simplePrefix.length).trim();
-        }}
-        
-        // Fix colons after keywords
-        syntaxContent = syntaxContent.replace(/^(data|items|children|theme|config):/gm, '$1');
-        syntaxContent = syntaxContent.replace(/(\\s)(children|items):/g, '$1$2');
-        
-        // Ensure infographic prefix
-        if (!syntaxContent.trim().toLowerCase().startsWith('infographic')) {{
-            syntaxContent = 'infographic list-grid\\n' + syntaxContent;
-        }}
-        
-        // Apply template mapping
-        {template_mapping_js}
-        
-        for (const [key, value] of Object.entries(TEMPLATE_MAPPING)) {{
-            const regex = new RegExp(`infographic\\\\s+${{key}}(?=\\\\s|$)`, 'i');
-            if (regex.test(syntaxContent)) {{
-                console.log(`[Infographic Markdown] Auto-mapping: ${{key}} -> ${{value}}`);
-                syntaxContent = syntaxContent.replace(regex, `infographic ${{value}}`);
-                break;
-            }}
-        }}
-        
-        console.log("[Infographic Markdown] Cleaned syntax:", syntaxContent.substring(0, 200) + "...");
-        
-        // Create offscreen container
-        const container = document.createElement('div');
-        container.id = 'infographic-offscreen-' + uniqueId;
-        container.style.cssText = 'position:absolute;left:-9999px;top:-9999px;width:' + svgWidth + 'px;';
-        document.body.appendChild(container);
-        
-        // Create and render infographic
-        const instance = new Infographic({{
-            container: '#' + container.id,
-            width: svgWidth,
-            padding: 24,
-        }});
-        
-        console.log("[Infographic Markdown] Rendering infographic...");
-        instance.render(syntaxContent);
-        
-        // Wait for render and export
-        await new Promise(resolve => setTimeout(resolve, 1000));
-        
-        let dataUrl;
-        if (exportFormat === 'png') {{
-            dataUrl = await instance.toDataURL({{ type: 'png', dpr: 2 }});
-        }} else {{
-            dataUrl = await instance.toDataURL({{ type: 'svg', embedResources: true }});
-        }}
-        
-        console.log("[Infographic Markdown] Data URL generated, length:", dataUrl.length);
-        
-        // Cleanup
-        instance.destroy();
-        document.body.removeChild(container);
-        
-        // Generate markdown image
-        const markdownImage = `![📊 AI 生成的信息图](${{dataUrl}})`;
-        
-        // Update message via API
-        if (chatId && messageId) {{
-            const token = localStorage.getItem("token");
-            
-            // Get current message content
-            const getResponse = await fetch(`/api/v1/chats/${{chatId}}`, {{
-                method: "GET",
-                headers: {{ "Authorization": `Bearer ${{token}}` }}
-            }});
-            
-            if (!getResponse.ok) {{
-                throw new Error("Failed to get chat data: " + getResponse.status);
-            }}
-            
-            const chatData = await getResponse.json();
-            let originalContent = "";
-            
-            if (chatData.chat && chatData.chat.messages) {{
-                const targetMsg = chatData.chat.messages.find(m => m.id === messageId);
-                if (targetMsg && targetMsg.content) {{
-                    originalContent = targetMsg.content;
-                }}
-            }}
-            
-            // Remove existing infographic images
-            const infographicPattern = /\\n*!\\[📊[^\\]]*\\]\\(data:image\\/[^)]+\\)/g;
-            let cleanedContent = originalContent.replace(infographicPattern, "");
-            cleanedContent = cleanedContent.replace(/\\n{{3,}}/g, "\\n\\n").trim();
-            
-            // Append new image
-            const newContent = cleanedContent + "\\n\\n" + markdownImage;
-            
-            // Update message
-            const updateResponse = await fetch(`/api/v1/chats/${{chatId}}/messages/${{messageId}}/event`, {{
-                method: "POST",
-                headers: {{
-                    "Content-Type": "application/json",
-                    "Authorization": `Bearer ${{token}}`
-                }},
-                body: JSON.stringify({{
-                    type: "chat:message",
-                    data: {{ content: newContent }}
-                }})
-            }});
-            
-            if (updateResponse.ok) {{
-                console.log("[Infographic Markdown] ✅ Message updated successfully!");
-            }} else {{
-                console.error("[Infographic Markdown] API error:", updateResponse.status);
-            }}
-        }} else {{
-            console.warn("[Infographic Markdown] ⚠️ Missing chatId or messageId");
-        }}
-        
-    }} catch (error) {{
-        console.error("[Infographic Markdown] Error:", error);
-    }}
-}})();
-"""
-
-    async def action(
-        self,
-        body: dict,
-        __user__: dict = None,
-        __event_emitter__=None,
-        __event_call__: Optional[Callable[[Any], Awaitable[None]]] = None,
-        __metadata__: Optional[dict] = None,
-        __request__: Request = None,
-    ) -> dict:
-        """
-        Generate infographic using AntV and embed as Markdown image.
-        """
-        logger.info("Action: Infographic to Markdown started")
-
-        # Get user information
-        if isinstance(__user__, (list, tuple)):
-            user_language = __user__[0].get("language", "en") if __user__ else "en"
-            user_name = __user__[0].get("name", "User") if __user__[0] else "User"
-            user_id = __user__[0].get("id", "unknown_user") if __user__ else "unknown_user"
-        elif isinstance(__user__, dict):
-            user_language = __user__.get("language", "en")
-            user_name = __user__.get("name", "User")
-            user_id = __user__.get("id", "unknown_user")
-        else:
-            user_language = "en"
-            user_name = "User"
-            user_id = "unknown_user"
-
-        # Get current time
-        now = datetime.now()
-        current_date_time_str = now.strftime("%Y-%m-%d %H:%M:%S")
-
-        try:
-            messages = body.get("messages", [])
-            if not messages:
-                raise ValueError("No messages available.")
-
-            # Get recent messages
-            message_count = min(self.valves.MESSAGE_COUNT, len(messages))
-            recent_messages = messages[-message_count:]
-
-            # Aggregate content
-            aggregated_parts = []
-            for msg in recent_messages:
-                text_content = self._extract_text_content(msg.get("content"))
-                if text_content:
-                    aggregated_parts.append(text_content)
-
-            if not aggregated_parts:
-                raise ValueError("No text content found in messages.")
-
-            long_text_content = "\n\n---\n\n".join(aggregated_parts)
-
-            # Remove existing HTML blocks
-            parts = re.split(r"```html.*?```", long_text_content, flags=re.DOTALL)
-            clean_content = ""
-            for part in reversed(parts):
-                if part.strip():
-                    clean_content = part.strip()
-                    break
-
-            if not clean_content:
-                clean_content = long_text_content.strip()
-
-            # Check minimum length
-            if len(clean_content) < self.valves.MIN_TEXT_LENGTH:
-                await self._emit_status(
-                    __event_emitter__,
-                    f"⚠️ 内容太短 ({len(clean_content)} 字符)，至少需要 {self.valves.MIN_TEXT_LENGTH} 字符",
-                    True,
-                )
-                return body
-
-            await self._emit_status(__event_emitter__, "📊 正在分析内容...", False)
-
-            # Generate infographic syntax via LLM
-            formatted_user_prompt = USER_PROMPT_GENERATE.format(
-                user_name=user_name,
-                current_date_time_str=current_date_time_str,
-                user_language=user_language,
-                long_text_content=clean_content,
-            )
-
-            target_model = self.valves.MODEL_ID or body.get("model")
-
-            llm_payload = {
-                "model": target_model,
-                "messages": [
-                    {"role": "system", "content": SYSTEM_PROMPT_INFOGRAPHIC},
-                    {"role": "user", "content": formatted_user_prompt},
-                ],
-                "stream": False,
-            }
-
-            user_obj = Users.get_user_by_id(user_id)
-            if not user_obj:
-                raise ValueError(f"Unable to get user object: {user_id}")
-
-            await self._emit_status(__event_emitter__, "📊 AI 正在生成信息图语法...", False)
-
-            llm_response = await generate_chat_completion(__request__, llm_payload, user_obj)
-
-            if not llm_response or "choices" not in llm_response or not llm_response["choices"]:
-                raise ValueError("Invalid LLM response.")
-
-            assistant_content = llm_response["choices"][0]["message"]["content"]
-            infographic_syntax = self._extract_infographic_syntax(assistant_content)
-
-            logger.info(f"Generated syntax: {infographic_syntax[:200]}...")
-
-            # Extract IDs for API callback
-            chat_id = self._extract_chat_id(body, __metadata__)
-            message_id = self._extract_message_id(body, __metadata__)
-            unique_id = f"ig_{int(time.time() * 1000)}"
-
-            await self._emit_status(__event_emitter__, "📊 正在渲染 SVG...", False)
-
-            # Execute JS to render and embed
-            if __event_call__:
-                js_code = self._generate_js_code(
-                    unique_id=unique_id,
-                    chat_id=chat_id,
-                    message_id=message_id,
-                    infographic_syntax=infographic_syntax,
-                    svg_width=self.valves.SVG_WIDTH,
-                    export_format=self.valves.EXPORT_FORMAT,
-                )
-
-                await __event_call__(
-                    {
-                        "type": "execute",
-                        "data": {"code": js_code},
-                    }
-                )
-
-            await self._emit_status(__event_emitter__, "✅ 信息图生成完成！", True)
-            logger.info("Infographic to Markdown completed")
-
-        except Exception as e:
-            error_message = f"Infographic generation failed: {str(e)}"
-            logger.error(error_message, exc_info=True)
-            await self._emit_status(__event_emitter__, f"❌ {error_message}", True)
-
-        return body
--- a/plugins/actions/js-render-poc/infographic_markdown_cn.py
+++ b/plugins/actions/js-render-poc/infographic_markdown_cn.py
@@ -1,592 +0,0 @@
-"""
-title: 📊 信息图转 Markdown
-author: Fu-Jie
-version: 1.0.0
-description: AI 生成信息图语法，前端渲染 SVG 并转换为 Markdown 图片格式嵌入消息。支持 AntV Infographic 模板。
-"""
-
-import time
-import json
-import logging
-import re
-from typing import Optional, Callable, Awaitable, Any, Dict
-from pydantic import BaseModel, Field
-from fastapi import Request
-from datetime import datetime
-
-from open_webui.utils.chat import generate_chat_completion
-from open_webui.models.users import Users
-
-logging.basicConfig(level=logging.INFO)
-logger = logging.getLogger(__name__)
-
-# =================================================================
-# LLM 提示词
-# =================================================================
-
-SYSTEM_PROMPT_INFOGRAPHIC = """
-你是一位专业的信息图设计专家，能够分析用户提供的文本内容并将其转换为 AntV Infographic 语法格式。
-
-## 信息图语法规范
-
-信息图语法是一种类似 Mermaid 的声明式语法，用于描述信息图模板、数据和主题。
-
-### 语法规则
- 入口使用 `infographic <模板名>`
- 键值对用空格分隔，**绝对不允许使用冒号**
- 使用两个空格缩进
- 对象数组使用 `-` 加换行
-
-⚠️ **重要警告：这不是 YAML 格式！**
- ❌ 错误：`children:` `items:` `data:`（带冒号）
- ✅ 正确：`children` `items` `data`（不带冒号）
-
-### 模板库与选择指南
-
-根据内容结构选择最合适的模板：
-
-#### 1. 列表与层级
- **列表**：`list-grid`（网格卡片）、`list-vertical`（垂直列表）
- **树形**：`tree-vertical`（垂直树）、`tree-horizontal`（水平树）
- **思维导图**：`mindmap`（思维导图）
-
-#### 2. 序列与关系
- **流程**：`sequence-roadmap`（路线图）、`sequence-zigzag`（折线流程）
- **关系**：`relation-sankey`（桑基图）、`relation-circle`（圆形关系）
-
-#### 3. 对比与分析
- **对比**：`compare-binary`（二元对比）
- **分析**：`compare-swot`（SWOT 分析）、`quadrant-quarter`（象限图）
-
-#### 4. 图表与数据
- **图表**：`chart-bar`、`chart-column`、`chart-line`、`chart-pie`、`chart-doughnut`、`chart-area`
-
-### 数据结构示例
-
-#### A. 标准列表/树形
-```infographic
-infographic list-grid
-data
-  title 项目模块
-  items
-    - label 模块 A
-      desc 模块 A 的描述
-    - label 模块 B
-      desc 模块 B 的描述
-```
-
-#### B. 二元对比
-```infographic
-infographic compare-binary
-data
-  title 优势与劣势
-  items
-    - label 优势
-      children
-        - label 研发能力强
-          desc 技术领先
-    - label 劣势
-      children
-        - label 品牌曝光弱
-          desc 营销不足
-```
-
-#### C. 图表
-```infographic
-infographic chart-bar
-data
-  title 季度收入
-  items
-    - label Q1
-      value 120
-    - label Q2
-      value 150
-```
-
-### 常用数据字段
- `label`：主标题/标签（必填）
- `desc`：描述文字（`list-grid` 最多 30 个中文字符）
- `value`：数值（用于图表）
- `children`：嵌套项
-
-## 输出要求
-1. **语言**：使用用户的语言输出内容。
-2. **格式**：用 ```infographic ... ``` 包裹输出。
-3. **无冒号**：键后面不要使用冒号。
-4. **缩进**：使用 2 个空格。
-"""
-
-USER_PROMPT_GENERATE = """
-请分析以下文本内容，将其核心信息转换为 AntV Infographic 语法格式。
-
---
-**用户上下文：**
-用户名：{user_name}
-当前时间：{current_date_time_str}
-用户语言：{user_language}
---
-
-**文本内容：**
-{long_text_content}
-
-请根据文本特征选择最合适的信息图模板，输出标准的信息图语法。
-
-**重要提示：** 
- 如果使用 `list-grid` 格式，确保每个卡片的 `desc` 描述限制在 **最多 30 个中文字符**。
- 描述应简洁，突出重点。
-"""
-
-
-class Action:
-    class Valves(BaseModel):
-        SHOW_STATUS: bool = Field(
-            default=True, description="在聊天界面显示操作状态更新。"
-        )
-        MODEL_ID: str = Field(
-            default="",
-            description="用于文本分析的 LLM 模型 ID。留空则使用当前对话模型。",
-        )
-        MIN_TEXT_LENGTH: int = Field(
-            default=50,
-            description="信息图分析所需的最小文本长度（字符数）。",
-        )
-        MESSAGE_COUNT: int = Field(
-            default=1,
-            description="用于生成的最近消息数量。",
-        )
-        SVG_WIDTH: int = Field(
-            default=800,
-            description="生成的 SVG 宽度（像素）。",
-        )
-        EXPORT_FORMAT: str = Field(
-            default="svg",
-            description="导出格式：'svg' 或 'png'。",
-        )
-
-    def __init__(self):
-        self.valves = self.Valves()
-
-    def _extract_chat_id(self, body: dict, metadata: Optional[dict]) -> str:
-        """从 body 或 metadata 中提取 chat_id"""
-        if isinstance(body, dict):
-            chat_id = body.get("chat_id")
-            if isinstance(chat_id, str) and chat_id.strip():
-                return chat_id.strip()
-
-            body_metadata = body.get("metadata", {})
-            if isinstance(body_metadata, dict):
-                chat_id = body_metadata.get("chat_id")
-                if isinstance(chat_id, str) and chat_id.strip():
-                    return chat_id.strip()
-
-        if isinstance(metadata, dict):
-            chat_id = metadata.get("chat_id")
-            if isinstance(chat_id, str) and chat_id.strip():
-                return chat_id.strip()
-
-        return ""
-
-    def _extract_message_id(self, body: dict, metadata: Optional[dict]) -> str:
-        """从 body 或 metadata 中提取 message_id"""
-        if isinstance(body, dict):
-            message_id = body.get("id")
-            if isinstance(message_id, str) and message_id.strip():
-                return message_id.strip()
-
-            body_metadata = body.get("metadata", {})
-            if isinstance(body_metadata, dict):
-                message_id = body_metadata.get("message_id")
-                if isinstance(message_id, str) and message_id.strip():
-                    return message_id.strip()
-
-        if isinstance(metadata, dict):
-            message_id = metadata.get("message_id")
-            if isinstance(message_id, str) and message_id.strip():
-                return message_id.strip()
-
-        return ""
-
-    def _extract_infographic_syntax(self, llm_output: str) -> str:
-        """从 LLM 输出中提取信息图语法"""
-        match = re.search(r"```infographic\s*(.*?)\s*```", llm_output, re.DOTALL)
-        if match:
-            return match.group(1).strip()
-        else:
-            logger.warning("LLM 输出未遵循预期格式，将整个输出作为语法处理。")
-            return llm_output.strip()
-
-    def _extract_text_content(self, content) -> str:
-        """从消息内容中提取文本，支持多模态格式"""
-        if isinstance(content, str):
-            return content
-        elif isinstance(content, list):
-            text_parts = []
-            for item in content:
-                if isinstance(item, dict) and item.get("type") == "text":
-                    text_parts.append(item.get("text", ""))
-                elif isinstance(item, str):
-                    text_parts.append(item)
-            return "\n".join(text_parts)
-        return str(content) if content else ""
-
-    async def _emit_status(self, emitter, description: str, done: bool = False):
-        """发送状态更新事件"""
-        if self.valves.SHOW_STATUS and emitter:
-            await emitter(
-                {"type": "status", "data": {"description": description, "done": done}}
-            )
-
-    def _generate_js_code(
-        self,
-        unique_id: str,
-        chat_id: str,
-        message_id: str,
-        infographic_syntax: str,
-        svg_width: int,
-        export_format: str,
-    ) -> str:
-        """生成用于前端 SVG 渲染的 JavaScript 代码"""
-        
-        # 转义语法以便嵌入 JS
-        syntax_escaped = (
-            infographic_syntax
-            .replace("\\", "\\\\")
-            .replace("`", "\\`")
-            .replace("${", "\\${")
-            .replace("</script>", "<\\/script>")
-        )
-        
-        # 模板映射
-        template_mapping_js = """
-        const TEMPLATE_MAPPING = {
-            'list-grid': 'list-grid-compact-card',
-            'list-vertical': 'list-column-simple-vertical-arrow',
-            'tree-vertical': 'hierarchy-tree-tech-style-capsule-item',
-            'tree-horizontal': 'hierarchy-tree-lr-tech-style-capsule-item',
-            'mindmap': 'hierarchy-mindmap-branch-gradient-capsule-item',
-            'sequence-roadmap': 'sequence-roadmap-vertical-simple',
-            'sequence-zigzag': 'sequence-horizontal-zigzag-simple',
-            'sequence-horizontal': 'sequence-horizontal-zigzag-simple',
-            'relation-sankey': 'relation-sankey-simple',
-            'relation-circle': 'relation-circle-icon-badge',
-            'compare-binary': 'compare-binary-horizontal-simple-vs',
-            'compare-swot': 'compare-swot',
-            'quadrant-quarter': 'quadrant-quarter-simple-card',
-            'statistic-card': 'list-grid-compact-card',
-            'chart-bar': 'chart-bar-plain-text',
-            'chart-column': 'chart-column-simple',
-            'chart-line': 'chart-line-plain-text',
-            'chart-area': 'chart-area-simple',
-            'chart-pie': 'chart-pie-plain-text',
-            'chart-doughnut': 'chart-pie-donut-plain-text'
-        };
-        """
-        
-        return f"""
-(async function() {{
-    const uniqueId = "{unique_id}";
-    const chatId = "{chat_id}";
-    const messageId = "{message_id}";
-    const svgWidth = {svg_width};
-    const exportFormat = "{export_format}";
-    
-    console.log("[信息图 Markdown] 开始渲染...");
-    console.log("[信息图 Markdown] chatId:", chatId, "messageId:", messageId);
-    
-    try {{
-        // 加载 AntV Infographic（如果尚未加载）
-        if (typeof AntVInfographic === 'undefined') {{
-            console.log("[信息图 Markdown] 正在加载 AntV Infographic 库...");
-            await new Promise((resolve, reject) => {{
-                const script = document.createElement('script');
-                script.src = 'https://unpkg.com/@antv/infographic@latest/dist/infographic.min.js';
-                script.onload = resolve;
-                script.onerror = reject;
-                document.head.appendChild(script);
-            }});
-            console.log("[信息图 Markdown] 库加载完成。");
-        }}
-        
-        const {{ Infographic }} = AntVInfographic;
-        
-        // 获取信息图语法
-        let syntaxContent = `{syntax_escaped}`;
-        console.log("[信息图 Markdown] 原始语法:", syntaxContent.substring(0, 200) + "...");
-        
-        // 清理语法
-        const backtick = String.fromCharCode(96);
-        const prefix = backtick + backtick + backtick + 'infographic';
-        const simplePrefix = backtick + backtick + backtick;
-        
-        if (syntaxContent.toLowerCase().startsWith(prefix)) {{
-            syntaxContent = syntaxContent.substring(prefix.length).trim();
-        }} else if (syntaxContent.startsWith(simplePrefix)) {{
-            syntaxContent = syntaxContent.substring(simplePrefix.length).trim();
-        }}
-        
-        if (syntaxContent.endsWith(simplePrefix)) {{
-            syntaxContent = syntaxContent.substring(0, syntaxContent.length - simplePrefix.length).trim();
-        }}
-        
-        // 修复关键字后的冒号
-        syntaxContent = syntaxContent.replace(/^(data|items|children|theme|config):/gm, '$1');
-        syntaxContent = syntaxContent.replace(/(\\s)(children|items):/g, '$1$2');
-        
-        // 确保有 infographic 前缀
-        if (!syntaxContent.trim().toLowerCase().startsWith('infographic')) {{
-            syntaxContent = 'infographic list-grid\\n' + syntaxContent;
-        }}
-        
-        // 应用模板映射
-        {template_mapping_js}
-        
-        for (const [key, value] of Object.entries(TEMPLATE_MAPPING)) {{
-            const regex = new RegExp(`infographic\\\\s+${{key}}(?=\\\\s|$)`, 'i');
-            if (regex.test(syntaxContent)) {{
-                console.log(`[信息图 Markdown] 自动映射: ${{key}} -> ${{value}}`);
-                syntaxContent = syntaxContent.replace(regex, `infographic ${{value}}`);
-                break;
-            }}
-        }}
-        
-        console.log("[信息图 Markdown] 清理后语法:", syntaxContent.substring(0, 200) + "...");
-        
-        // 创建离屏容器
-        const container = document.createElement('div');
-        container.id = 'infographic-offscreen-' + uniqueId;
-        container.style.cssText = 'position:absolute;left:-9999px;top:-9999px;width:' + svgWidth + 'px;';
-        document.body.appendChild(container);
-        
-        // 创建并渲染信息图
-        const instance = new Infographic({{
-            container: '#' + container.id,
-            width: svgWidth,
-            padding: 24,
-        }});
-        
-        console.log("[信息图 Markdown] 正在渲染信息图...");
-        instance.render(syntaxContent);
-        
-        // 等待渲染完成并导出
-        await new Promise(resolve => setTimeout(resolve, 1000));
-        
-        let dataUrl;
-        if (exportFormat === 'png') {{
-            dataUrl = await instance.toDataURL({{ type: 'png', dpr: 2 }});
-        }} else {{
-            dataUrl = await instance.toDataURL({{ type: 'svg', embedResources: true }});
-        }}
-        
-        console.log("[信息图 Markdown] Data URL 已生成，长度:", dataUrl.length);
-        
-        // 清理
-        instance.destroy();
-        document.body.removeChild(container);
-        
-        // 生成 Markdown 图片
-        const markdownImage = `![📊 AI 生成的信息图](${{dataUrl}})`;
-        
-        // 通过 API 更新消息
-        if (chatId && messageId) {{
-            const token = localStorage.getItem("token");
-            
-            // 获取当前消息内容
-            const getResponse = await fetch(`/api/v1/chats/${{chatId}}`, {{
-                method: "GET",
-                headers: {{ "Authorization": `Bearer ${{token}}` }}
-            }});
-            
-            if (!getResponse.ok) {{
-                throw new Error("获取对话数据失败: " + getResponse.status);
-            }}
-            
-            const chatData = await getResponse.json();
-            let originalContent = "";
-            
-            if (chatData.chat && chatData.chat.messages) {{
-                const targetMsg = chatData.chat.messages.find(m => m.id === messageId);
-                if (targetMsg && targetMsg.content) {{
-                    originalContent = targetMsg.content;
-                }}
-            }}
-            
-            // 移除已有的信息图图片
-            const infographicPattern = /\\n*!\\[📊[^\\]]*\\]\\(data:image\\/[^)]+\\)/g;
-            let cleanedContent = originalContent.replace(infographicPattern, "");
-            cleanedContent = cleanedContent.replace(/\\n{{3,}}/g, "\\n\\n").trim();
-            
-            // 追加新图片
-            const newContent = cleanedContent + "\\n\\n" + markdownImage;
-            
-            // 更新消息
-            const updateResponse = await fetch(`/api/v1/chats/${{chatId}}/messages/${{messageId}}/event`, {{
-                method: "POST",
-                headers: {{
-                    "Content-Type": "application/json",
-                    "Authorization": `Bearer ${{token}}`
-                }},
-                body: JSON.stringify({{
-                    type: "chat:message",
-                    data: {{ content: newContent }}
-                }})
-            }});
-            
-            if (updateResponse.ok) {{
-                console.log("[信息图 Markdown] ✅ 消息更新成功！");
-            }} else {{
-                console.error("[信息图 Markdown] API 错误:", updateResponse.status);
-            }}
-        }} else {{
-            console.warn("[信息图 Markdown] ⚠️ 缺少 chatId 或 messageId");
-        }}
-        
-    }} catch (error) {{
-        console.error("[信息图 Markdown] 错误:", error);
-    }}
-}})();
-"""
-
-    async def action(
-        self,
-        body: dict,
-        __user__: dict = None,
-        __event_emitter__=None,
-        __event_call__: Optional[Callable[[Any], Awaitable[None]]] = None,
-        __metadata__: Optional[dict] = None,
-        __request__: Request = None,
-    ) -> dict:
-        """
-        使用 AntV 生成信息图并作为 Markdown 图片嵌入。
-        """
-        logger.info("动作：信息图转 Markdown 开始")
-
-        # 获取用户信息
-        if isinstance(__user__, (list, tuple)):
-            user_language = __user__[0].get("language", "zh") if __user__ else "zh"
-            user_name = __user__[0].get("name", "用户") if __user__[0] else "用户"
-            user_id = __user__[0].get("id", "unknown_user") if __user__ else "unknown_user"
-        elif isinstance(__user__, dict):
-            user_language = __user__.get("language", "zh")
-            user_name = __user__.get("name", "用户")
-            user_id = __user__.get("id", "unknown_user")
-        else:
-            user_language = "zh"
-            user_name = "用户"
-            user_id = "unknown_user"
-
-        # 获取当前时间
-        now = datetime.now()
-        current_date_time_str = now.strftime("%Y-%m-%d %H:%M:%S")
-
-        try:
-            messages = body.get("messages", [])
-            if not messages:
-                raise ValueError("没有可用的消息。")
-
-            # 获取最近的消息
-            message_count = min(self.valves.MESSAGE_COUNT, len(messages))
-            recent_messages = messages[-message_count:]
-
-            # 聚合内容
-            aggregated_parts = []
-            for msg in recent_messages:
-                text_content = self._extract_text_content(msg.get("content"))
-                if text_content:
-                    aggregated_parts.append(text_content)
-
-            if not aggregated_parts:
-                raise ValueError("消息中未找到文本内容。")
-
-            long_text_content = "\n\n---\n\n".join(aggregated_parts)
-
-            # 移除已有的 HTML 块
-            parts = re.split(r"```html.*?```", long_text_content, flags=re.DOTALL)
-            clean_content = ""
-            for part in reversed(parts):
-                if part.strip():
-                    clean_content = part.strip()
-                    break
-
-            if not clean_content:
-                clean_content = long_text_content.strip()
-
-            # 检查最小长度
-            if len(clean_content) < self.valves.MIN_TEXT_LENGTH:
-                await self._emit_status(
-                    __event_emitter__,
-                    f"⚠️ 内容太短（{len(clean_content)} 字符），至少需要 {self.valves.MIN_TEXT_LENGTH} 字符",
-                    True,
-                )
-                return body
-
-            await self._emit_status(__event_emitter__, "📊 正在分析内容...", False)
-
-            # 通过 LLM 生成信息图语法
-            formatted_user_prompt = USER_PROMPT_GENERATE.format(
-                user_name=user_name,
-                current_date_time_str=current_date_time_str,
-                user_language=user_language,
-                long_text_content=clean_content,
-            )
-
-            target_model = self.valves.MODEL_ID or body.get("model")
-
-            llm_payload = {
-                "model": target_model,
-                "messages": [
-                    {"role": "system", "content": SYSTEM_PROMPT_INFOGRAPHIC},
-                    {"role": "user", "content": formatted_user_prompt},
-                ],
-                "stream": False,
-            }
-
-            user_obj = Users.get_user_by_id(user_id)
-            if not user_obj:
-                raise ValueError(f"无法获取用户对象：{user_id}")
-
-            await self._emit_status(__event_emitter__, "📊 AI 正在生成信息图语法...", False)
-
-            llm_response = await generate_chat_completion(__request__, llm_payload, user_obj)
-
-            if not llm_response or "choices" not in llm_response or not llm_response["choices"]:
-                raise ValueError("无效的 LLM 响应。")
-
-            assistant_content = llm_response["choices"][0]["message"]["content"]
-            infographic_syntax = self._extract_infographic_syntax(assistant_content)
-
-            logger.info(f"生成的语法：{infographic_syntax[:200]}...")
-
-            # 提取 API 回调所需的 ID
-            chat_id = self._extract_chat_id(body, __metadata__)
-            message_id = self._extract_message_id(body, __metadata__)
-            unique_id = f"ig_{int(time.time() * 1000)}"
-
-            await self._emit_status(__event_emitter__, "📊 正在渲染 SVG...", False)
-
-            # 执行 JS 进行渲染和嵌入
-            if __event_call__:
-                js_code = self._generate_js_code(
-                    unique_id=unique_id,
-                    chat_id=chat_id,
-                    message_id=message_id,
-                    infographic_syntax=infographic_syntax,
-                    svg_width=self.valves.SVG_WIDTH,
-                    export_format=self.valves.EXPORT_FORMAT,
-                )
-
-                await __event_call__(
-                    {
-                        "type": "execute",
-                        "data": {"code": js_code},
-                    }
-                )
-
-            await self._emit_status(__event_emitter__, "✅ 信息图生成完成！", True)
-            logger.info("信息图转 Markdown 完成")
-
-        except Exception as e:
-            error_message = f"信息图生成失败：{str(e)}"
-            logger.error(error_message, exc_info=True)
-            await self._emit_status(__event_emitter__, f"❌ {error_message}", True)
-
-        return body
--- a/plugins/actions/js-render-poc/js_render_poc.py
+++ b/plugins/actions/js-render-poc/js_render_poc.py
@@ -1,257 +0,0 @@
-"""
-title: JS Render PoC
-author: Fu-Jie
-version: 0.6.0
-description: Proof of concept for JS rendering + API write-back pattern. JS renders SVG and updates message via API.
-"""
-
-import time
-import json
-import logging
-from typing import Optional, Callable, Awaitable, Any
-from pydantic import BaseModel, Field
-from fastapi import Request
-
-logging.basicConfig(level=logging.INFO)
-logger = logging.getLogger(__name__)
-
-
-class Action:
-    class Valves(BaseModel):
-        pass
-
-    def __init__(self):
-        self.valves = self.Valves()
-
-    def _extract_chat_id(self, body: dict, metadata: Optional[dict]) -> str:
-        """Extract chat_id from body or metadata"""
-        if isinstance(body, dict):
-            # body["chat_id"] 是 chat_id
-            chat_id = body.get("chat_id")
-            if isinstance(chat_id, str) and chat_id.strip():
-                return chat_id.strip()
-
-            body_metadata = body.get("metadata", {})
-            if isinstance(body_metadata, dict):
-                chat_id = body_metadata.get("chat_id")
-                if isinstance(chat_id, str) and chat_id.strip():
-                    return chat_id.strip()
-
-        if isinstance(metadata, dict):
-            chat_id = metadata.get("chat_id")
-            if isinstance(chat_id, str) and chat_id.strip():
-                return chat_id.strip()
-
-        return ""
-
-    def _extract_message_id(self, body: dict, metadata: Optional[dict]) -> str:
-        """Extract message_id from body or metadata"""
-        if isinstance(body, dict):
-            # body["id"] 是 message_id
-            message_id = body.get("id")
-            if isinstance(message_id, str) and message_id.strip():
-                return message_id.strip()
-
-            body_metadata = body.get("metadata", {})
-            if isinstance(body_metadata, dict):
-                message_id = body_metadata.get("message_id")
-                if isinstance(message_id, str) and message_id.strip():
-                    return message_id.strip()
-
-        if isinstance(metadata, dict):
-            message_id = metadata.get("message_id")
-            if isinstance(message_id, str) and message_id.strip():
-                return message_id.strip()
-
-        return ""
-
-    async def action(
-        self,
-        body: dict,
-        __user__: dict = None,
-        __event_emitter__=None,
-        __event_call__: Optional[Callable[[Any], Awaitable[None]]] = None,
-        __metadata__: Optional[dict] = None,
-        __request__: Request = None,
-    ) -> dict:
-        """
-        PoC: Use __event_call__ to execute JS that renders SVG and updates message via API.
-        """
-        # 准备调试数据
-        body_for_log = {}
-        for k, v in body.items():
-            if k == "messages":
-                body_for_log[k] = f"[{len(v)} messages]"
-            else:
-                body_for_log[k] = v
-
-        body_json = json.dumps(body_for_log, ensure_ascii=False, default=str)
-        metadata_json = (
-            json.dumps(__metadata__, ensure_ascii=False, default=str)
-            if __metadata__
-            else "null"
-        )
-
-        # 转义 JSON 中的特殊字符以便嵌入 JS
-        body_json_escaped = (
-            body_json.replace("\\", "\\\\").replace("`", "\\`").replace("${", "\\${")
-        )
-        metadata_json_escaped = (
-            metadata_json.replace("\\", "\\\\")
-            .replace("`", "\\`")
-            .replace("${", "\\${")
-        )
-
-        chat_id = self._extract_chat_id(body, __metadata__)
-        message_id = self._extract_message_id(body, __metadata__)
-
-        unique_id = f"poc_{int(time.time() * 1000)}"
-
-        if __event_emitter__:
-            await __event_emitter__(
-                {
-                    "type": "status",
-                    "data": {"description": "🔄 正在渲染...", "done": False},
-                }
-            )
-
-        if __event_call__:
-            await __event_call__(
-                {
-                    "type": "execute",
-                    "data": {
-                        "code": f"""
-(async function() {{
-    const uniqueId = "{unique_id}";
-    const chatId = "{chat_id}";
-    const messageId = "{message_id}";
-    
-    // ===== DEBUG: 输出 Python 端的数据 =====
-    console.log("[JS Render PoC] ===== DEBUG INFO (from Python) =====");
-    console.log("[JS Render PoC] body:", `{body_json_escaped}`);
-    console.log("[JS Render PoC] __metadata__:", `{metadata_json_escaped}`);
-    console.log("[JS Render PoC] Extracted: chatId=", chatId, "messageId=", messageId);
-    console.log("[JS Render PoC] =========================================");
-    
-    try {{
-        console.log("[JS Render PoC] Starting SVG render...");
-        
-        // Create SVG
-        const svg = document.createElementNS("http://www.w3.org/2000/svg", "svg");
-        svg.setAttribute("width", "200");
-        svg.setAttribute("height", "200");
-        svg.setAttribute("viewBox", "0 0 200 200");
-        svg.setAttribute("xmlns", "http://www.w3.org/2000/svg");
-        
-        const defs = document.createElementNS("http://www.w3.org/2000/svg", "defs");
-        const gradient = document.createElementNS("http://www.w3.org/2000/svg", "linearGradient");
-        gradient.setAttribute("id", "grad-" + uniqueId);
-        gradient.innerHTML = `
-            <stop offset="0%" style="stop-color:#1e88e5;stop-opacity:1" />
-            <stop offset="100%" style="stop-color:#43a047;stop-opacity:1" />
-        `;
-        defs.appendChild(gradient);
-        svg.appendChild(defs);
-        
-        const circle = document.createElementNS("http://www.w3.org/2000/svg", "circle");
-        circle.setAttribute("cx", "100");
-        circle.setAttribute("cy", "100");
-        circle.setAttribute("r", "80");
-        circle.setAttribute("fill", `url(#grad-${{uniqueId}})`);
-        svg.appendChild(circle);
-        
-        const text = document.createElementNS("http://www.w3.org/2000/svg", "text");
-        text.setAttribute("x", "100");
-        text.setAttribute("y", "105");
-        text.setAttribute("text-anchor", "middle");
-        text.setAttribute("fill", "white");
-        text.setAttribute("font-size", "16");
-        text.setAttribute("font-weight", "bold");
-        text.textContent = "PoC Success!";
-        svg.appendChild(text);
-        
-        // Convert to Base64 Data URI
-        const svgData = new XMLSerializer().serializeToString(svg);
-        const base64 = btoa(unescape(encodeURIComponent(svgData)));
-        const dataUri = "data:image/svg+xml;base64," + base64;
-        
-        console.log("[JS Render PoC] SVG rendered, data URI length:", dataUri.length);
-        
-        // Call API - 完全替换方案（更稳定）
-        if (chatId && messageId) {{
-            const token = localStorage.getItem("token");
-            
-            // 1. 获取当前消息内容
-            const getResponse = await fetch(`/api/v1/chats/${{chatId}}`, {{
-                method: "GET",
-                headers: {{ "Authorization": `Bearer ${{token}}` }}
-            }});
-            
-            if (!getResponse.ok) {{
-                throw new Error("Failed to get chat data: " + getResponse.status);
-            }}
-            
-            const chatData = await getResponse.json();
-            console.log("[JS Render PoC] Got chat data");
-            
-            let originalContent = "";
-            if (chatData.chat && chatData.chat.messages) {{
-                const targetMsg = chatData.chat.messages.find(m => m.id === messageId);
-                if (targetMsg && targetMsg.content) {{
-                    originalContent = targetMsg.content;
-                    console.log("[JS Render PoC] Found original content, length:", originalContent.length);
-                }}
-            }}
-            
-            // 2. 移除已存在的 PoC 图片（如果有的话）
-            // 匹配 ![JS Render PoC 生成的 SVG](data:...) 格式
-            const pocImagePattern = /\\n*!\\[JS Render PoC[^\\]]*\\]\\(data:image\\/svg\\+xml;base64,[^)]+\\)/g;
-            let cleanedContent = originalContent.replace(pocImagePattern, "");
-            // 移除可能残留的多余空行
-            cleanedContent = cleanedContent.replace(/\\n{{3,}}/g, "\\n\\n").trim();
-            
-            if (cleanedContent !== originalContent) {{
-                console.log("[JS Render PoC] Removed existing PoC image(s)");
-            }}
-            
-            // 3. 添加新的 Markdown 图片
-            const markdownImage = `![JS Render PoC 生成的 SVG](${{dataUri}})`;
-            const newContent = cleanedContent + "\\n\\n" + markdownImage;
-            
-            // 3. 使用 chat:message 完全替换
-            const updateResponse = await fetch(`/api/v1/chats/${{chatId}}/messages/${{messageId}}/event`, {{
-                method: "POST",
-                headers: {{
-                    "Content-Type": "application/json",
-                    "Authorization": `Bearer ${{token}}`
-                }},
-                body: JSON.stringify({{
-                    type: "chat:message",
-                    data: {{ content: newContent }}
-                }})
-            }});
-            
-            if (updateResponse.ok) {{
-                console.log("[JS Render PoC] ✅ Message updated successfully!");
-            }} else {{
-                console.error("[JS Render PoC] API error:", updateResponse.status, await updateResponse.text());
-            }}
-        }} else {{
-            console.warn("[JS Render PoC] ⚠️ Missing chatId or messageId, cannot persist.");
-        }}
-        
-    }} catch (error) {{
-        console.error("[JS Render PoC] Error:", error);
-    }}
-}})();
-                        """
-                    },
-                }
-            )
-
-        if __event_emitter__:
-            await __event_emitter__(
-                {"type": "status", "data": {"description": "✅ 渲染完成", "done": True}}
-            )
-
-        return body
--- a/plugins/actions/smart-mind-map/smart_mind_map.png
+++ b/plugins/actions/smart-mind-map/smart_mind_map.png
--- a/plugins/actions/smart-mind-map/smart_mind_map_cn.png
+++ b/plugins/actions/smart-mind-map/smart_mind_map_cn.png
--- a/plugins/actions/summary/README.md
+++ b/plugins/actions/summary/README.md
@@ -1,30 +0,0 @@
-# Deep Reading & Summary
-
-A powerful tool for analyzing long texts, generating detailed summaries, key points, and actionable insights.
-
-## Features
-
- **Deep Analysis**: Goes beyond simple summarization to understand the core message.
- **Key Point Extraction**: Identifies and lists the most important information.
- **Actionable Advice**: Provides practical suggestions based on the text content.
-
-## Usage
-
-1. Install the plugin.
-2. Send a long text or article to the chat.
-3. Click the "Deep Reading" button (or trigger via command).
-
-## Author
-
-Fu-Jie
-GitHub: [Fu-Jie/awesome-openwebui](https://github.com/Fu-Jie/awesome-openwebui)
-
-## License
-
-MIT License
-
-## Changelog
-
-### v0.1.2
-
- Removed debug messages from output
--- a/plugins/actions/summary/README_CN.md
+++ b/plugins/actions/summary/README_CN.md
@@ -1,30 +0,0 @@
-# 深度阅读与摘要 (Deep Reading & Summary)
-
-一个强大的长文本分析工具，用于生成详细摘要、关键信息点和可执行的行动建议。
-
-## 功能特点
-
- **深度分析**：超越简单的总结，深入理解核心信息。
- **关键点提取**：识别并列出最重要的信息点。
- **行动建议**：基于文本内容提供切实可行的建议。
-
-## 使用方法
-
-1. 安装插件。
-2. 发送长文本或文章到聊天框。
-3. 点击“精读”按钮（或通过命令触发）。
-
-## 作者
-
-Fu-Jie
-GitHub: [Fu-Jie/awesome-openwebui](https://github.com/Fu-Jie/awesome-openwebui)
-
-## 许可证
-
-MIT License
-
-## 更新日志
-
-### v0.1.2
-
- 移除输出中的调试信息
--- a/plugins/actions/summary/summary.py
+++ b/plugins/actions/summary/summary.py
@@ -1,674 +0,0 @@
-"""
-title: Deep Reading & Summary
-author: Fu-Jie
-author_url: https://github.com/Fu-Jie
-funding_url: https://github.com/Fu-Jie/awesome-openwebui
-version: 0.1.2
-icon_url: data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIyNCIgaGVpZ2h0PSIyNCIgdmlld0JveD0iMCAwIDI0IDI0IiBmaWxsPSJub25lIiBzdHJva2U9ImN1cnJlbnRDb2xvciIgc3Ryb2tlLXdpZHRoPSIyIiBzdHJva2UtbGluZWNhcD0icm91bmQiIHN0cm9rZS1saW5lam9pbj0icm91bmQiPjxwYXRoIGQ9Ik0xNSAxMmgtNSIvPjxwYXRoIGQ9Ik0xNSA4aC01Ii8+PHBhdGggZD0iTTE5IDE3VjVhMiAyIDAgMCAwLTItMkg0Ii8+PHBhdGggZD0iTTggMjFoMTJhMiAyIDAgMCAwIDItMnYtMWExIDEgMCAwIDAtMS0xSDExYTEgMSAwIDAgMC0xIDF2MWEyIDIgMCAxIDEtNCAwVjVhMiAyIDAgMSAwLTQgMHYyYTEgMSAwIDAgMCAxIDFoMyIvPjwvc3ZnPg==
-description: Provides deep reading analysis and summarization for long texts.
-requirements: jinja2, markdown
-"""
-
-from pydantic import BaseModel, Field
-from typing import Optional, Dict, Any
-import logging
-import re
-from fastapi import Request
-from datetime import datetime
-import pytz
-import markdown
-from jinja2 import Template
-
-from open_webui.utils.chat import generate_chat_completion
-from open_webui.models.users import Users
-
-logging.basicConfig(
-    level=logging.INFO, format="%(asctime)s - %(name)s - %(levelname)s - %(message)s"
-)
-logger = logging.getLogger(__name__)
-
-# =================================================================
-# HTML Wrapper Template (supports multiple plugins and grid layout)
-# =================================================================
-HTML_WRAPPER_TEMPLATE = """
-<!-- OPENWEBUI_PLUGIN_OUTPUT -->
-<!DOCTYPE html>
-<html lang="{user_language}">
-<head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <style>
-        body { 
-            font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif; 
-            margin: 0; 
-            padding: 10px; 
-            background-color: transparent; 
-        }
-        #main-container { 
-            display: flex; 
-            flex-wrap: wrap; 
-            gap: 20px; 
-            align-items: flex-start; 
-            width: 100%;
-        }
-        .plugin-item { 
-            flex: 1 1 400px; /* Default width, allows shrinking/growing */
-            min-width: 300px; 
-            background: white; 
-            border-radius: 12px; 
-            box-shadow: 0 4px 6px rgba(0,0,0,0.05); 
-            overflow: hidden; 
-            border: 1px solid #e5e7eb; 
-            transition: all 0.3s ease;
-        }
-        .plugin-item:hover {
-            box-shadow: 0 10px 15px rgba(0,0,0,0.1);
-        }
-        @media (max-width: 768px) { 
-            .plugin-item { flex: 1 1 100%; } 
-        }
-        /* STYLES_INSERTION_POINT */
-    </style>
-</head>
-<body>
-    <div id="main-container">
-        <!-- CONTENT_INSERTION_POINT -->
-    </div>
-    <!-- SCRIPTS_INSERTION_POINT -->
-</body>
-</html>
-"""
-
-# =================================================================
-# Internal LLM Prompts
-# =================================================================
-
-SYSTEM_PROMPT_READING_ASSISTANT = """
-You are a professional Deep Text Analysis Expert, specializing in reading long texts and extracting the essence. Your task is to conduct a comprehensive and in-depth analysis.
-
-Please provide the following:
-1.  **Detailed Summary**: Summarize the core content of the text in 2-3 paragraphs, ensuring accuracy and completeness. Do not be too brief; ensure the reader fully understands the main idea.
-2.  **Key Information Points**: List 5-8 most important facts, viewpoints, or arguments. Each point should:
-    - Be specific and insightful
-    - Include necessary details and context
-    - Use Markdown list format
-3.  **Actionable Advice**: Identify and refine specific, actionable items from the text. Each suggestion should:
-    - Be clear and actionable
-    - Include execution priority or timing suggestions
-    - If there are no clear action items, provide learning suggestions or thinking directions
-
-Please strictly follow these guidelines:
-   **Language**: All output must be in the user's specified language.
-   **Format**: Please strictly follow the Markdown format below, ensuring each section has a clear header:
-    ## Summary
-    [Detailed summary content here, 2-3 paragraphs, use Markdown **bold** or *italic* to emphasize key points]
-
-    ## Key Information Points
-    - [Key Point 1: Include specific details and context]
-    - [Key Point 2: Include specific details and context]
-    - [Key Point 3: Include specific details and context]
-    - [At least 5, at most 8 key points]
-
-    ## Actionable Advice
-    - [Action Item 1: Specific, actionable, include priority]
-    - [Action Item 2: Specific, actionable, include priority]
-    - [If no clear action items, provide learning suggestions or thinking directions]
-   **Depth First**: Analysis should be deep and comprehensive, not superficial.
-   **Action Oriented**: Focus on actionable suggestions and next steps.
-   **Analysis Results Only**: Do not include any extra pleasantries, explanations, or leading text.
-"""
-
-USER_PROMPT_GENERATE_SUMMARY = """
-Please conduct a deep analysis of the following long text, providing:
-1.  Detailed Summary (2-3 paragraphs, comprehensive overview)
-2.  Key Information Points List (5-8 items, including specific details)
-3.  Actionable Advice (Specific, clear, including priority)
-
---
-**User Context:**
-User Name: {user_name}
-Current Date/Time: {current_date_time_str}
-Weekday: {current_weekday}
-Timezone: {current_timezone_str}
-User Language: {user_language}
---
-
-**Long Text Content:**
-```
-{long_text_content}
-```
-
-Please conduct a deep and comprehensive analysis, focusing on actionable advice.
-"""
-
-# =================================================================
-# Frontend HTML Template (Jinja2 Syntax)
-# =================================================================
-
-CSS_TEMPLATE_SUMMARY = """
-        :root {
-            --primary-color: #4285f4;
-            --secondary-color: #1e88e5;
-            --action-color: #34a853;
-            --background-color: #f8f9fa;
-            --card-bg-color: #ffffff;
-            --text-color: #202124;
-            --muted-text-color: #5f6368;
-            --border-color: #dadce0;
-            --header-gradient: linear-gradient(135deg, #4285f4, #1e88e5);
-            --shadow: 0 1px 3px rgba(60,64,67,.3);
-            --border-radius: 8px;
-            --font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
-        }
-        .summary-container-wrapper {
-            font-family: var(--font-family);
-            line-height: 1.8;
-            color: var(--text-color);
-            height: 100%;
-            display: flex;
-            flex-direction: column;
-        }
-        .summary-container-wrapper .header {
-            background: var(--header-gradient);
-            color: white;
-            padding: 20px 24px;
-            text-align: center;
-        }
-        .summary-container-wrapper .header h1 {
-            margin: 0;
-            font-size: 1.5em;
-            font-weight: 500;
-            letter-spacing: -0.5px;
-        }
-        .summary-container-wrapper .user-context {
-            font-size: 0.8em;
-            color: var(--muted-text-color);
-            background-color: #f1f3f4;
-            padding: 8px 16px;
-            display: flex;
-            justify-content: space-around;
-            flex-wrap: wrap;
-            border-bottom: 1px solid var(--border-color);
-        }
-        .summary-container-wrapper .user-context span { margin: 2px 8px; }
-        .summary-container-wrapper .content { padding: 20px; flex-grow: 1; }
-        .summary-container-wrapper .section {
-            margin-bottom: 16px;
-            padding-bottom: 16px;
-            border-bottom: 1px solid #e8eaed;
-        }
-        .summary-container-wrapper .section:last-child {
-            border-bottom: none;
-            margin-bottom: 0;
-            padding-bottom: 0;
-        }
-        .summary-container-wrapper .section h2 {
-            margin-top: 0;
-            margin-bottom: 12px;
-            font-size: 1.2em;
-            font-weight: 500;
-            color: var(--text-color);
-            display: flex;
-            align-items: center;
-            padding-bottom: 8px;
-            border-bottom: 2px solid var(--primary-color);
-        }
-        .summary-container-wrapper .section h2 .icon {
-            margin-right: 8px;
-            font-size: 1.1em;
-            line-height: 1;
-        }
-        .summary-container-wrapper .summary-section h2 { border-bottom-color: var(--primary-color); }
-        .summary-container-wrapper .keypoints-section h2 { border-bottom-color: var(--secondary-color); }
-        .summary-container-wrapper .actions-section h2 { border-bottom-color: var(--action-color); }
-        .summary-container-wrapper .html-content {
-            font-size: 0.95em;
-            line-height: 1.7;
-        }
-        .summary-container-wrapper .html-content p:first-child { margin-top: 0; }
-        .summary-container-wrapper .html-content p:last-child { margin-bottom: 0; }
-        .summary-container-wrapper .html-content ul {
-            list-style: none;
-            padding-left: 0;
-            margin: 12px 0;
-        }
-        .summary-container-wrapper .html-content li {
-            padding: 8px 0 8px 24px;
-            position: relative;
-            margin-bottom: 6px;
-            line-height: 1.6;
-        }
-        .summary-container-wrapper .html-content li::before {
-            position: absolute;
-            left: 0;
-            top: 8px;
-            font-family: 'Arial';
-            font-weight: bold;
-            font-size: 1em;
-        }
-        .summary-container-wrapper .keypoints-section .html-content li::before { 
-            content: '•'; 
-            color: var(--secondary-color);
-            font-size: 1.3em;
-            top: 5px;
-        }
-        .summary-container-wrapper .actions-section .html-content li::before { 
-            content: '▸'; 
-            color: var(--action-color); 
-        }
-        .summary-container-wrapper .no-content { 
-            color: var(--muted-text-color); 
-            font-style: italic;
-            padding: 12px;
-            background: #f8f9fa;
-            border-radius: 4px;
-        }
-        .summary-container-wrapper .footer {
-            text-align: center;
-            padding: 16px;
-            font-size: 0.8em;
-            color: #5f6368;
-            background-color: #f8f9fa;
-            border-top: 1px solid var(--border-color);
-        }
-"""
-
-CONTENT_TEMPLATE_SUMMARY = """
-        <div class="summary-container-wrapper">
-            <div class="header">
-                <h1>📖 Deep Reading: Analysis Report</h1>
-            </div>
-            <div class="user-context">
-                <span><strong>User:</strong> {user_name}</span>
-                <span><strong>Time:</strong> {current_date_time_str}</span>
-            </div>
-            <div class="content">
-                <div class="section summary-section">
-                    <h2><span class="icon">📝</span>Detailed Summary</h2>
-                    <div class="html-content">{summary_html}</div>
-                </div>
-                <div class="section keypoints-section">
-                    <h2><span class="icon">💡</span>Key Information Points</h2>
-                    <div class="html-content">{keypoints_html}</div>
-                </div>
-                <div class="section actions-section">
-                    <h2><span class="icon">🎯</span>Actionable Advice</h2>
-                    <div class="html-content">{actions_html}</div>
-                </div>
-            </div>
-            <div class="footer">
-                <p>&copy; {current_year} Deep Reading - Text Analysis Service</p>
-            </div>
-        </div>
-"""
-
-
-class Action:
-    class Valves(BaseModel):
-        SHOW_STATUS: bool = Field(
-            default=True,
-            description="Whether to show operation status updates in the chat interface.",
-        )
-        MODEL_ID: str = Field(
-            default="",
-            description="Built-in LLM Model ID used for text analysis. If empty, uses the current conversation's model.",
-        )
-        MIN_TEXT_LENGTH: int = Field(
-            default=200,
-            description="Minimum text length required for deep analysis (characters). Recommended 200+.",
-        )
-        RECOMMENDED_MIN_LENGTH: int = Field(
-            default=500,
-            description="Recommended minimum text length for best analysis results.",
-        )
-        CLEAR_PREVIOUS_HTML: bool = Field(
-            default=False,
-            description="Whether to force clear previous plugin results (if True, overwrites instead of merging).",
-        )
-        MESSAGE_COUNT: int = Field(
-            default=1,
-            description="Number of recent messages to use for generation. Set to 1 for just the last message, or higher for more context.",
-        )
-
-    def __init__(self):
-        self.valves = self.Valves()
-
-    def _process_llm_output(self, llm_output: str) -> Dict[str, str]:
-        """
-        Parse LLM Markdown output and convert to HTML fragments.
-        """
-        summary_match = re.search(
-            r"##\s*Summary\s*\n(.*?)(?=\n##|$)", llm_output, re.DOTALL | re.IGNORECASE
-        )
-        keypoints_match = re.search(
-            r"##\s*Key Information Points\s*\n(.*?)(?=\n##|$)",
-            llm_output,
-            re.DOTALL | re.IGNORECASE,
-        )
-        actions_match = re.search(
-            r"##\s*Actionable Advice\s*\n(.*?)(?=\n##|$)",
-            llm_output,
-            re.DOTALL | re.IGNORECASE,
-        )
-
-        summary_md = summary_match.group(1).strip() if summary_match else ""
-        keypoints_md = keypoints_match.group(1).strip() if keypoints_match else ""
-        actions_md = actions_match.group(1).strip() if actions_match else ""
-
-        if not any([summary_md, keypoints_md, actions_md]):
-            summary_md = llm_output.strip()
-            logger.warning(
-                "LLM output did not follow expected Markdown format. Treating entire output as summary."
-            )
-
-        # Use 'nl2br' extension to convert newlines \n to <br>
-        md_extensions = ["nl2br"]
-        summary_html = (
-            markdown.markdown(summary_md, extensions=md_extensions)
-            if summary_md
-            else '<p class="no-content">Failed to extract summary.</p>'
-        )
-        keypoints_html = (
-            markdown.markdown(keypoints_md, extensions=md_extensions)
-            if keypoints_md
-            else '<p class="no-content">Failed to extract key information points.</p>'
-        )
-        actions_html = (
-            markdown.markdown(actions_md, extensions=md_extensions)
-            if actions_md
-            else '<p class="no-content">No explicit actionable advice.</p>'
-        )
-
-        return {
-            "summary_html": summary_html,
-            "keypoints_html": keypoints_html,
-            "actions_html": actions_html,
-        }
-
-    async def _emit_status(self, emitter, description: str, done: bool = False):
-        """Emits a status update event."""
-        if self.valves.SHOW_STATUS and emitter:
-            await emitter(
-                {"type": "status", "data": {"description": description, "done": done}}
-            )
-
-    async def _emit_notification(self, emitter, content: str, ntype: str = "info"):
-        """Emits a notification event (info/success/warning/error)."""
-        if emitter:
-            await emitter(
-                {"type": "notification", "data": {"type": ntype, "content": content}}
-            )
-
-    def _remove_existing_html(self, content: str) -> str:
-        """Removes existing plugin-generated HTML code blocks from the content."""
-        pattern = r"```html\s*<!-- OPENWEBUI_PLUGIN_OUTPUT -->[\s\S]*?```"
-        return re.sub(pattern, "", content).strip()
-
-    def _extract_text_content(self, content) -> str:
-        """Extract text from message content, supporting multimodal message formats"""
-        if isinstance(content, str):
-            return content
-        elif isinstance(content, list):
-            # Multimodal message: [{"type": "text", "text": "..."}, {"type": "image_url", ...}]
-            text_parts = []
-            for item in content:
-                if isinstance(item, dict) and item.get("type") == "text":
-                    text_parts.append(item.get("text", ""))
-                elif isinstance(item, str):
-                    text_parts.append(item)
-            return "\n".join(text_parts)
-        return str(content) if content else ""
-
-    def _merge_html(
-        self,
-        existing_html_code: str,
-        new_content: str,
-        new_styles: str = "",
-        new_scripts: str = "",
-        user_language: str = "en-US",
-    ) -> str:
-        """
-        Merges new content into an existing HTML container, or creates a new one.
-        """
-        if (
-            "<!-- OPENWEBUI_PLUGIN_OUTPUT -->" in existing_html_code
-            and "<!-- CONTENT_INSERTION_POINT -->" in existing_html_code
-        ):
-            base_html = existing_html_code
-            base_html = re.sub(r"^```html\s*", "", base_html)
-            base_html = re.sub(r"\s*```$", "", base_html)
-        else:
-            base_html = HTML_WRAPPER_TEMPLATE.replace("{user_language}", user_language)
-
-        wrapped_content = f'<div class="plugin-item">\n{new_content}\n</div>'
-
-        if new_styles:
-            base_html = base_html.replace(
-                "/* STYLES_INSERTION_POINT */",
-                f"{new_styles}\n/* STYLES_INSERTION_POINT */",
-            )
-
-        base_html = base_html.replace(
-            "<!-- CONTENT_INSERTION_POINT -->",
-            f"{wrapped_content}\n<!-- CONTENT_INSERTION_POINT -->",
-        )
-
-        if new_scripts:
-            base_html = base_html.replace(
-                "<!-- SCRIPTS_INSERTION_POINT -->",
-                f"{new_scripts}\n<!-- SCRIPTS_INSERTION_POINT -->",
-            )
-
-        return base_html.strip()
-
-    def _build_content_html(self, context: dict) -> str:
-        """
-        Build content HTML using context data.
-        """
-        return (
-            CONTENT_TEMPLATE_SUMMARY.replace(
-                "{user_name}", context.get("user_name", "User")
-            )
-            .replace(
-                "{current_date_time_str}", context.get("current_date_time_str", "")
-            )
-            .replace("{current_year}", context.get("current_year", ""))
-            .replace("{summary_html}", context.get("summary_html", ""))
-            .replace("{keypoints_html}", context.get("keypoints_html", ""))
-            .replace("{actions_html}", context.get("actions_html", ""))
-        )
-
-    async def action(
-        self,
-        body: dict,
-        __user__: Optional[Dict[str, Any]] = None,
-        __event_emitter__: Optional[Any] = None,
-        __request__: Optional[Request] = None,
-    ) -> Optional[dict]:
-        logger.info("Action: Deep Reading Started (v2.0.0)")
-
-        if isinstance(__user__, (list, tuple)):
-            user_language = (
-                __user__[0].get("language", "en-US") if __user__ else "en-US"
-            )
-            user_name = __user__[0].get("name", "User") if __user__[0] else "User"
-            user_id = (
-                __user__[0]["id"]
-                if __user__ and "id" in __user__[0]
-                else "unknown_user"
-            )
-        elif isinstance(__user__, dict):
-            user_language = __user__.get("language", "en-US")
-            user_name = __user__.get("name", "User")
-            user_id = __user__.get("id", "unknown_user")
-
-        now = datetime.now()
-        current_date_time_str = now.strftime("%B %d, %Y %H:%M:%S")
-        current_weekday = now.strftime("%A")
-        current_year = now.strftime("%Y")
-        current_timezone_str = "Unknown Timezone"
-
-        original_content = ""
-        try:
-            messages = body.get("messages", [])
-            if not messages:
-                raise ValueError("Unable to get valid user message content.")
-
-            # Get last N messages based on MESSAGE_COUNT
-            message_count = min(self.valves.MESSAGE_COUNT, len(messages))
-            recent_messages = messages[-message_count:]
-
-            # Aggregate content from selected messages with labels
-            aggregated_parts = []
-            for i, msg in enumerate(recent_messages, 1):
-                text_content = self._extract_text_content(msg.get("content"))
-                if text_content:
-                    role = msg.get("role", "unknown")
-                    role_label = (
-                        "User"
-                        if role == "user"
-                        else "Assistant" if role == "assistant" else role
-                    )
-                    aggregated_parts.append(f"{text_content}")
-
-            if not aggregated_parts:
-                raise ValueError("Unable to get valid user message content.")
-
-            original_content = "\n\n---\n\n".join(aggregated_parts)
-
-            if len(original_content) < self.valves.MIN_TEXT_LENGTH:
-                short_text_message = f"Text content too short ({len(original_content)} chars), recommended at least {self.valves.MIN_TEXT_LENGTH} chars for effective deep analysis.\n\n💡 Tip: For short texts, consider using '⚡ Flash Card' for quick refinement."
-                await self._emit_notification(
-                    __event_emitter__, short_text_message, "warning"
-                )
-                return {
-                    "messages": [
-                        {"role": "assistant", "content": f"⚠️ {short_text_message}"}
-                    ]
-                }
-
-            # Recommend for longer texts
-            if len(original_content) < self.valves.RECOMMENDED_MIN_LENGTH:
-                await self._emit_notification(
-                    __event_emitter__,
-                    f"Text length is {len(original_content)} chars. Recommended {self.valves.RECOMMENDED_MIN_LENGTH}+ chars for best analysis results.",
-                    "info",
-                )
-
-            await self._emit_notification(
-                __event_emitter__,
-                "📖 Deep Reading started, analyzing deeply...",
-                "info",
-            )
-            await self._emit_status(
-                __event_emitter__,
-                "📖 Deep Reading: Analyzing text, extracting essence...",
-                False,
-            )
-
-            formatted_user_prompt = USER_PROMPT_GENERATE_SUMMARY.format(
-                user_name=user_name,
-                current_date_time_str=current_date_time_str,
-                current_weekday=current_weekday,
-                current_timezone_str=current_timezone_str,
-                user_language=user_language,
-                long_text_content=original_content,
-            )
-
-            # Determine model to use
-            target_model = self.valves.MODEL_ID
-            if not target_model:
-                target_model = body.get("model")
-
-            llm_payload = {
-                "model": target_model,
-                "messages": [
-                    {"role": "system", "content": SYSTEM_PROMPT_READING_ASSISTANT},
-                    {"role": "user", "content": formatted_user_prompt},
-                ],
-                "stream": False,
-            }
-
-            user_obj = Users.get_user_by_id(user_id)
-            if not user_obj:
-                raise ValueError(f"Unable to get user object, User ID: {user_id}")
-
-            llm_response = await generate_chat_completion(
-                __request__, llm_payload, user_obj
-            )
-            assistant_response_content = llm_response["choices"][0]["message"][
-                "content"
-            ]
-
-            processed_content = self._process_llm_output(assistant_response_content)
-
-            context = {
-                "user_language": user_language,
-                "user_name": user_name,
-                "current_date_time_str": current_date_time_str,
-                "current_weekday": current_weekday,
-                "current_year": current_year,
-                **processed_content,
-            }
-
-            content_html = self._build_content_html(context)
-
-            # Extract existing HTML if any
-            existing_html_block = ""
-            match = re.search(
-                r"```html\s*(<!-- OPENWEBUI_PLUGIN_OUTPUT -->[\s\S]*?)```",
-                original_content,
-            )
-            if match:
-                existing_html_block = match.group(1)
-
-            if self.valves.CLEAR_PREVIOUS_HTML:
-                original_content = self._remove_existing_html(original_content)
-                final_html = self._merge_html(
-                    "", content_html, CSS_TEMPLATE_SUMMARY, "", user_language
-                )
-            else:
-                if existing_html_block:
-                    original_content = self._remove_existing_html(original_content)
-                    final_html = self._merge_html(
-                        existing_html_block,
-                        content_html,
-                        CSS_TEMPLATE_SUMMARY,
-                        "",
-                        user_language,
-                    )
-                else:
-                    final_html = self._merge_html(
-                        "", content_html, CSS_TEMPLATE_SUMMARY, "", user_language
-                    )
-
-            html_embed_tag = f"```html\n{final_html}\n```"
-            body["messages"][-1]["content"] = f"{original_content}\n\n{html_embed_tag}"
-
-            await self._emit_status(
-                __event_emitter__, "📖 Deep Reading: Analysis complete!", True
-            )
-            await self._emit_notification(
-                __event_emitter__,
-                f"📖 Deep Reading complete, {user_name}! Deep analysis report generated.",
-                "success",
-            )
-
-        except Exception as e:
-            error_message = f"Deep Reading processing failed: {str(e)}"
-            logger.error(f"Deep Reading Error: {error_message}", exc_info=True)
-            user_facing_error = f"Sorry, Deep Reading encountered an error while processing: {str(e)}.\nPlease check Open WebUI backend logs for more details."
-            body["messages"][-1][
-                "content"
-            ] = f"{original_content}\n\n❌ **Error:** {user_facing_error}"
-
-            await self._emit_status(
-                __event_emitter__, "Deep Reading: Processing failed.", True
-            )
-            await self._emit_notification(
-                __event_emitter__,
-                f"Deep Reading processing failed, {user_name}!",
-                "error",
-            )
-
-        return body
--- a/plugins/actions/summary/summary_cn.py
+++ b/plugins/actions/summary/summary_cn.py
@@ -1,663 +0,0 @@
-"""
-title: 精读 (Deep Reading)
-icon_url: data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIyNCIgaGVpZ2h0PSIyNCIgdmlld0JveD0iMCAwIDI0IDI0Ij48ZGVmcz48bGluZWFyR3JhZGllbnQgaWQ9ImciIHgxPSIwIiB5MT0iMCIgeDI9IjEiIHkyPSIxIj48c3RvcCBvZmZzZXQ9IjAlIiBzdG9wLWNvbG9yPSIjNDI4NWY0Ii8+PHN0b3Agb2Zmc2V0PSIxMDAlIiBzdG9wLWNvbG9yPSIjMWU4OGU1Ii8+PC9saW5lYXJHcmFkaWVudD48L2RlZnM+PHBhdGggZD0iTTYgMmg4bDYgNnYxMmEyIDIgMCAwIDEtMiAySDZhMiAyIDAgMCAxLTItMlY0YTIgMiAwIDAgMSAyLTJ6IiBmaWxsPSJ1cmwoI2cpIi8+PHBhdGggZD0iTTE0IDJsNiA2aC02eiIgZmlsbD0iIzFlODhlNSIgb3BhY2l0eT0iMC42Ii8+PGxpbmUgeDE9IjgiIHkxPSIxMyIgeDI9IjE2IiB5Mj0iMTMiIHN0cm9rZT0iI2ZmZiIgc3Ryb2tlLXdpZHRoPSIxLjUiLz48bGluZSB4MT0iOCIgeTE9IjE3IiB4Mj0iMTQiIHkyPSIxNyIgc3Ryb2tlPSIjZmZmIiBzdHJva2Utd2lkdGg9IjEuNSIvPjxjaXJjbGUgY3g9IjE2IiBjeT0iMTgiIHI9IjMiIGZpbGw9IiNmZmQ3MDAiLz48cGF0aCBkPSJNMTYgMTZsMS41IDEuNSIgc3Ryb2tlPSIjNDI4NWY0IiBzdHJva2Utd2lkdGg9IjIiIHN0cm9rZS1saW5lY2FwPSJyb3VuZCIvPjwvc3ZnPg==
-version: 0.1.2
-description: 深度分析长篇文本，提炼详细摘要、关键信息点和可执行的行动建议，适合工作和学习场景。
-requirements: jinja2, markdown
-"""
-
-from pydantic import BaseModel, Field
-from typing import Optional, Dict, Any
-import logging
-import re
-from fastapi import Request
-from datetime import datetime
-import pytz
-import markdown
-from jinja2 import Template
-
-from open_webui.utils.chat import generate_chat_completion
-from open_webui.models.users import Users
-
-logging.basicConfig(
-    level=logging.INFO, format="%(asctime)s - %(name)s - %(levelname)s - %(message)s"
-)
-logger = logging.getLogger(__name__)
-
-# =================================================================
-# HTML 容器模板 (支持多插件共存与网格布局)
-# =================================================================
-HTML_WRAPPER_TEMPLATE = """
-<!-- OPENWEBUI_PLUGIN_OUTPUT -->
-<!DOCTYPE html>
-<html lang="{user_language}">
-<head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <style>
-        body { 
-            font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif; 
-            margin: 0; 
-            padding: 10px; 
-            background-color: transparent; 
-        }
-        #main-container { 
-            display: flex; 
-            flex-wrap: wrap; 
-            gap: 20px; 
-            align-items: flex-start; 
-            width: 100%;
-        }
-        .plugin-item { 
-            flex: 1 1 400px; /* 默认宽度，允许伸缩 */
-            min-width: 300px; 
-            background: white; 
-            border-radius: 12px; 
-            box-shadow: 0 4px 6px rgba(0,0,0,0.05); 
-            overflow: hidden; 
-            border: 1px solid #e5e7eb; 
-            transition: all 0.3s ease;
-        }
-        .plugin-item:hover {
-            box-shadow: 0 10px 15px rgba(0,0,0,0.1);
-        }
-        @media (max-width: 768px) { 
-            .plugin-item { flex: 1 1 100%; } 
-        }
-        /* STYLES_INSERTION_POINT */
-    </style>
-</head>
-<body>
-    <div id="main-container">
-        <!-- CONTENT_INSERTION_POINT -->
-    </div>
-    <!-- SCRIPTS_INSERTION_POINT -->
-</body>
-</html>
-"""
-
-# =================================================================
-# 内部 LLM 提示词设计
-# =================================================================
-
-SYSTEM_PROMPT_READING_ASSISTANT = """
-你是一个专业的深度文本分析专家，擅长精读长篇文本并提炼精华。你的任务是进行全面、深入的分析。
-
-请提供以下内容：
-1.  **详细摘要**：用 2-3 段话全面总结文本的核心内容，确保准确性和完整性。不要过于简略，要让读者充分理解文本主旨。
-2.  **关键信息点**：列出 5-8 个最重要的事实、观点或论据。每个信息点应该：
-    - 具体且有深度
-    - 包含必要的细节和背景
-    - 使用 Markdown 列表格式
-3.  **行动建议**：从文本中识别并提炼出具体的、可执行的行动项。每个建议应该：
-    - 明确且可操作
-    - 包含执行的优先级或时间建议
-    - 如果没有明确的行动项，可以提供学习建议或思考方向
-
-请严格遵循以下指导原则：
-   **语言**：所有输出必须使用用户指定的语言。
-   **格式**：请严格按照以下 Markdown 格式输出，确保每个部分都有明确的标题：
-    ## 摘要
-    [这里是详细的摘要内容，2-3段话，可以使用 Markdown 进行**加粗**或*斜体*强调重点]
-
-    ## 关键信息点
-    - [关键点1：包含具体细节和背景]
-    - [关键点2：包含具体细节和背景]
-    - [关键点3：包含具体细节和背景]
-    - [至少5个，最多8个关键点]
-
-    ## 行动建议
-    - [行动项1：具体、可执行，包含优先级]
-    - [行动项2：具体、可执行，包含优先级]
-    - [如果没有明确行动项，提供学习建议或思考方向]
-   **深度优先**：分析要深入、全面，不要浮于表面。
-   **行动导向**：重点关注可执行的建议和下一步行动。
-   **只输出分析结果**：不要包含任何额外的寒暄、解释或引导性文字。
-"""
-
-USER_PROMPT_GENERATE_SUMMARY = """
-请对以下长篇文本进行深度分析，提供：
-1.  详细的摘要（2-3段话，全面概括文本内容）
-2.  关键信息点列表（5-8个，包含具体细节）
-3.  可执行的行动建议（具体、明确，包含优先级）
-
---
-**用户上下文信息:**
-用户姓名: {user_name}
-当前日期时间: {current_date_time_str}
-当前星期: {current_weekday}
-当前时区: {current_timezone_str}
-用户语言: {user_language}
---
-
-**长篇文本内容:**
-```
-{long_text_content}
-```
-
-请进行深入、全面的分析，重点关注可执行的行动建议。
-"""
-
-# =================================================================
-# 前端 HTML 模板 (Jinja2 语法)
-# =================================================================
-
-CSS_TEMPLATE_SUMMARY = """
-        :root {
-            --primary-color: #4285f4;
-            --secondary-color: #1e88e5;
-            --action-color: #34a853;
-            --background-color: #f8f9fa;
-            --card-bg-color: #ffffff;
-            --text-color: #202124;
-            --muted-text-color: #5f6368;
-            --border-color: #dadce0;
-            --header-gradient: linear-gradient(135deg, #4285f4, #1e88e5);
-            --shadow: 0 1px 3px rgba(60,64,67,.3);
-            --border-radius: 8px;
-            --font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
-        }
-        .summary-container-wrapper {
-            font-family: var(--font-family);
-            line-height: 1.8;
-            color: var(--text-color);
-            height: 100%;
-            display: flex;
-            flex-direction: column;
-        }
-        .summary-container-wrapper .header {
-            background: var(--header-gradient);
-            color: white;
-            padding: 20px 24px;
-            text-align: center;
-        }
-        .summary-container-wrapper .header h1 {
-            margin: 0;
-            font-size: 1.5em;
-            font-weight: 500;
-            letter-spacing: -0.5px;
-        }
-        .summary-container-wrapper .user-context {
-            font-size: 0.8em;
-            color: var(--muted-text-color);
-            background-color: #f1f3f4;
-            padding: 8px 16px;
-            display: flex;
-            justify-content: space-around;
-            flex-wrap: wrap;
-            border-bottom: 1px solid var(--border-color);
-        }
-        .summary-container-wrapper .user-context span { margin: 2px 8px; }
-        .summary-container-wrapper .content { padding: 20px; flex-grow: 1; }
-        .summary-container-wrapper .section {
-            margin-bottom: 16px;
-            padding-bottom: 16px;
-            border-bottom: 1px solid #e8eaed;
-        }
-        .summary-container-wrapper .section:last-child {
-            border-bottom: none;
-            margin-bottom: 0;
-            padding-bottom: 0;
-        }
-        .summary-container-wrapper .section h2 {
-            margin-top: 0;
-            margin-bottom: 12px;
-            font-size: 1.2em;
-            font-weight: 500;
-            color: var(--text-color);
-            display: flex;
-            align-items: center;
-            padding-bottom: 8px;
-            border-bottom: 2px solid var(--primary-color);
-        }
-        .summary-container-wrapper .section h2 .icon {
-            margin-right: 8px;
-            font-size: 1.1em;
-            line-height: 1;
-        }
-        .summary-container-wrapper .summary-section h2 { border-bottom-color: var(--primary-color); }
-        .summary-container-wrapper .keypoints-section h2 { border-bottom-color: var(--secondary-color); }
-        .summary-container-wrapper .actions-section h2 { border-bottom-color: var(--action-color); }
-        .summary-container-wrapper .html-content {
-            font-size: 0.95em;
-            line-height: 1.7;
-        }
-        .summary-container-wrapper .html-content p:first-child { margin-top: 0; }
-        .summary-container-wrapper .html-content p:last-child { margin-bottom: 0; }
-        .summary-container-wrapper .html-content ul {
-            list-style: none;
-            padding-left: 0;
-            margin: 12px 0;
-        }
-        .summary-container-wrapper .html-content li {
-            padding: 8px 0 8px 24px;
-            position: relative;
-            margin-bottom: 6px;
-            line-height: 1.6;
-        }
-        .summary-container-wrapper .html-content li::before {
-            position: absolute;
-            left: 0;
-            top: 8px;
-            font-family: 'Arial';
-            font-weight: bold;
-            font-size: 1em;
-        }
-        .summary-container-wrapper .keypoints-section .html-content li::before { 
-            content: '•'; 
-            color: var(--secondary-color);
-            font-size: 1.3em;
-            top: 5px;
-        }
-        .summary-container-wrapper .actions-section .html-content li::before { 
-            content: '▸'; 
-            color: var(--action-color); 
-        }
-        .summary-container-wrapper .no-content { 
-            color: var(--muted-text-color); 
-            font-style: italic;
-            padding: 12px;
-            background: #f8f9fa;
-            border-radius: 4px;
-        }
-        .summary-container-wrapper .footer {
-            text-align: center;
-            padding: 16px;
-            font-size: 0.8em;
-            color: #5f6368;
-            background-color: #f8f9fa;
-            border-top: 1px solid var(--border-color);
-        }
-"""
-
-CONTENT_TEMPLATE_SUMMARY = """
-        <div class="summary-container-wrapper">
-            <div class="header">
-                <h1>📖 精读：深度分析报告</h1>
-            </div>
-            <div class="user-context">
-                <span><strong>用户:</strong> {user_name}</span>
-                <span><strong>时间:</strong> {current_date_time_str}</span>
-            </div>
-            <div class="content">
-                <div class="section summary-section">
-                    <h2><span class="icon">📝</span>详细摘要</h2>
-                    <div class="html-content">{summary_html}</div>
-                </div>
-                <div class="section keypoints-section">
-                    <h2><span class="icon">💡</span>关键信息点</h2>
-                    <div class="html-content">{keypoints_html}</div>
-                </div>
-                <div class="section actions-section">
-                    <h2><span class="icon">🎯</span>行动建议</h2>
-                    <div class="html-content">{actions_html}</div>
-                </div>
-            </div>
-            <div class="footer">
-                <p>&copy; {current_year} 精读 - 深度文本分析服务</p>
-            </div>
-        </div>
-"""
-
-
-class Action:
-    class Valves(BaseModel):
-        SHOW_STATUS: bool = Field(
-            default=True, description="是否在聊天界面显示操作状态更新。"
-        )
-        MODEL_ID: str = Field(
-            default="",
-            description="用于文本分析的内置LLM模型ID。如果为空，则使用当前对话的模型。",
-        )
-        MIN_TEXT_LENGTH: int = Field(
-            default=200,
-            description="进行深度分析所需的最小文本长度(字符数)。建议200字符以上。",
-        )
-        RECOMMENDED_MIN_LENGTH: int = Field(
-            default=500, description="建议的最小文本长度，以获得最佳分析效果。"
-        )
-        CLEAR_PREVIOUS_HTML: bool = Field(
-            default=False,
-            description="是否强制清除旧的插件结果（如果为 True，则不合并，直接覆盖）。",
-        )
-        MESSAGE_COUNT: int = Field(
-            default=1,
-            description="用于生成的最近消息数量。设置为1仅使用最后一条消息，更大值可包含更多上下文。",
-        )
-
-    def __init__(self):
-        self.valves = self.Valves()
-        self.weekday_map = {
-            "Monday": "星期一",
-            "Tuesday": "星期二",
-            "Wednesday": "星期三",
-            "Thursday": "星期四",
-            "Friday": "星期五",
-            "Saturday": "星期六",
-            "Sunday": "星期日",
-        }
-
-    def _process_llm_output(self, llm_output: str) -> Dict[str, str]:
-        """
-        解析LLM的Markdown输出,将其转换为HTML片段。
-        """
-        summary_match = re.search(
-            r"##\s*摘要\s*\n(.*?)(?=\n##|$)", llm_output, re.DOTALL
-        )
-        keypoints_match = re.search(
-            r"##\s*关键信息点\s*\n(.*?)(?=\n##|$)", llm_output, re.DOTALL
-        )
-        actions_match = re.search(
-            r"##\s*行动建议\s*\n(.*?)(?=\n##|$)", llm_output, re.DOTALL
-        )
-
-        summary_md = summary_match.group(1).strip() if summary_match else ""
-        keypoints_md = keypoints_match.group(1).strip() if keypoints_match else ""
-        actions_md = actions_match.group(1).strip() if actions_match else ""
-
-        if not any([summary_md, keypoints_md, actions_md]):
-            summary_md = llm_output.strip()
-            logger.warning("LLM输出未遵循预期的Markdown格式。将整个输出视为摘要。")
-
-        # 使用 'nl2br' 扩展将换行符 \n 转换为 <br>
-        md_extensions = ["nl2br"]
-        summary_html = (
-            markdown.markdown(summary_md, extensions=md_extensions)
-            if summary_md
-            else '<p class="no-content">未能提取摘要信息。</p>'
-        )
-        keypoints_html = (
-            markdown.markdown(keypoints_md, extensions=md_extensions)
-            if keypoints_md
-            else '<p class="no-content">未能提取关键信息点。</p>'
-        )
-        actions_html = (
-            markdown.markdown(actions_md, extensions=md_extensions)
-            if actions_md
-            else '<p class="no-content">暂无明确的行动建议。</p>'
-        )
-
-        return {
-            "summary_html": summary_html,
-            "keypoints_html": keypoints_html,
-            "actions_html": actions_html,
-        }
-
-    async def _emit_status(self, emitter, description: str, done: bool = False):
-        """发送状态更新事件。"""
-        if self.valves.SHOW_STATUS and emitter:
-            await emitter(
-                {"type": "status", "data": {"description": description, "done": done}}
-            )
-
-    async def _emit_notification(self, emitter, content: str, ntype: str = "info"):
-        """发送通知事件 (info/success/warning/error)。"""
-        if emitter:
-            await emitter(
-                {"type": "notification", "data": {"type": ntype, "content": content}}
-            )
-
-    def _remove_existing_html(self, content: str) -> str:
-        """移除内容中已有的插件生成 HTML 代码块 (通过标记识别)。"""
-        pattern = r"```html\s*<!-- OPENWEBUI_PLUGIN_OUTPUT -->[\s\S]*?```"
-        return re.sub(pattern, "", content).strip()
-
-    def _extract_text_content(self, content) -> str:
-        """从消息内容中提取文本，支持多模态消息格式"""
-        if isinstance(content, str):
-            return content
-        elif isinstance(content, list):
-            # 多模态消息: [{"type": "text", "text": "..."}, {"type": "image_url", ...}]
-            text_parts = []
-            for item in content:
-                if isinstance(item, dict) and item.get("type") == "text":
-                    text_parts.append(item.get("text", ""))
-                elif isinstance(item, str):
-                    text_parts.append(item)
-            return "\n".join(text_parts)
-        return str(content) if content else ""
-
-    def _merge_html(
-        self,
-        existing_html_code: str,
-        new_content: str,
-        new_styles: str = "",
-        new_scripts: str = "",
-        user_language: str = "zh-CN",
-    ) -> str:
-        """
-        将新内容合并到现有的 HTML 容器中，或者创建一个新的容器。
-        """
-        if (
-            "<!-- OPENWEBUI_PLUGIN_OUTPUT -->" in existing_html_code
-            and "<!-- CONTENT_INSERTION_POINT -->" in existing_html_code
-        ):
-            base_html = existing_html_code
-            base_html = re.sub(r"^```html\s*", "", base_html)
-            base_html = re.sub(r"\s*```$", "", base_html)
-        else:
-            base_html = HTML_WRAPPER_TEMPLATE.replace("{user_language}", user_language)
-
-        wrapped_content = f'<div class="plugin-item">\n{new_content}\n</div>'
-
-        if new_styles:
-            base_html = base_html.replace(
-                "/* STYLES_INSERTION_POINT */",
-                f"{new_styles}\n/* STYLES_INSERTION_POINT */",
-            )
-
-        base_html = base_html.replace(
-            "<!-- CONTENT_INSERTION_POINT -->",
-            f"{wrapped_content}\n<!-- CONTENT_INSERTION_POINT -->",
-        )
-
-        if new_scripts:
-            base_html = base_html.replace(
-                "<!-- SCRIPTS_INSERTION_POINT -->",
-                f"{new_scripts}\n<!-- SCRIPTS_INSERTION_POINT -->",
-            )
-
-        return base_html.strip()
-
-    def _build_content_html(self, context: dict) -> str:
-        """
-        使用上下文数据构建内容 HTML。
-        """
-        return (
-            CONTENT_TEMPLATE_SUMMARY.replace(
-                "{user_name}", context.get("user_name", "用户")
-            )
-            .replace(
-                "{current_date_time_str}", context.get("current_date_time_str", "")
-            )
-            .replace("{current_year}", context.get("current_year", ""))
-            .replace("{summary_html}", context.get("summary_html", ""))
-            .replace("{keypoints_html}", context.get("keypoints_html", ""))
-            .replace("{actions_html}", context.get("actions_html", ""))
-        )
-
-    async def action(
-        self,
-        body: dict,
-        __user__: Optional[Dict[str, Any]] = None,
-        __event_emitter__: Optional[Any] = None,
-        __request__: Optional[Request] = None,
-    ) -> Optional[dict]:
-        logger.info("Action: 精读启动 (v2.0.0 - Deep Reading)")
-
-        if isinstance(__user__, (list, tuple)):
-            user_language = (
-                __user__[0].get("language", "zh-CN") if __user__ else "zh-CN"
-            )
-            user_name = __user__[0].get("name", "用户") if __user__[0] else "用户"
-            user_id = (
-                __user__[0]["id"]
-                if __user__ and "id" in __user__[0]
-                else "unknown_user"
-            )
-        elif isinstance(__user__, dict):
-            user_language = __user__.get("language", "zh-CN")
-            user_name = __user__.get("name", "用户")
-            user_id = __user__.get("id", "unknown_user")
-
-        now = datetime.now()
-        current_date_time_str = now.strftime("%Y年%m月%d日 %H:%M:%S")
-        current_weekday_en = now.strftime("%A")
-        current_weekday = self.weekday_map.get(current_weekday_en, current_weekday_en)
-        current_year = now.strftime("%Y")
-        current_timezone_str = "未知时区"
-
-        original_content = ""
-        try:
-            messages = body.get("messages", [])
-            if not messages:
-                raise ValueError("无法获取有效的用户消息内容。")
-
-            # Get last N messages based on MESSAGE_COUNT
-            message_count = min(self.valves.MESSAGE_COUNT, len(messages))
-            recent_messages = messages[-message_count:]
-
-            # Aggregate content from selected messages with labels
-            aggregated_parts = []
-            for i, msg in enumerate(recent_messages, 1):
-                text_content = self._extract_text_content(msg.get("content"))
-                if text_content:
-                    role = msg.get("role", "unknown")
-                    role_label = (
-                        "用户"
-                        if role == "user"
-                        else "助手" if role == "assistant" else role
-                    )
-                    aggregated_parts.append(f"{text_content}")
-
-            if not aggregated_parts:
-                raise ValueError("无法获取有效的用户消息内容。")
-
-            original_content = "\n\n---\n\n".join(aggregated_parts)
-
-            if len(original_content) < self.valves.MIN_TEXT_LENGTH:
-                short_text_message = f"文本内容过短({len(original_content)}字符)，建议至少{self.valves.MIN_TEXT_LENGTH}字符以获得有效的深度分析。\n\n💡 提示：对于短文本，建议使用'⚡ 闪记卡'进行快速提炼。"
-                await self._emit_notification(
-                    __event_emitter__, short_text_message, "warning"
-                )
-                return {
-                    "messages": [
-                        {"role": "assistant", "content": f"⚠️ {short_text_message}"}
-                    ]
-                }
-
-            # Recommend for longer texts
-            if len(original_content) < self.valves.RECOMMENDED_MIN_LENGTH:
-                await self._emit_notification(
-                    __event_emitter__,
-                    f"文本长度为{len(original_content)}字符。建议{self.valves.RECOMMENDED_MIN_LENGTH}字符以上可获得更好的分析效果。",
-                    "info",
-                )
-
-            await self._emit_notification(
-                __event_emitter__, "📖 精读已启动，正在进行深度分析...", "info"
-            )
-            await self._emit_status(
-                __event_emitter__, "📖 精读: 深入分析文本，提炼精华...", False
-            )
-
-            formatted_user_prompt = USER_PROMPT_GENERATE_SUMMARY.format(
-                user_name=user_name,
-                current_date_time_str=current_date_time_str,
-                current_weekday=current_weekday,
-                current_timezone_str=current_timezone_str,
-                user_language=user_language,
-                long_text_content=original_content,
-            )
-
-            # 确定使用的模型
-            target_model = self.valves.MODEL_ID
-            if not target_model:
-                target_model = body.get("model")
-
-            llm_payload = {
-                "model": target_model,
-                "messages": [
-                    {"role": "system", "content": SYSTEM_PROMPT_READING_ASSISTANT},
-                    {"role": "user", "content": formatted_user_prompt},
-                ],
-                "stream": False,
-            }
-
-            user_obj = Users.get_user_by_id(user_id)
-            if not user_obj:
-                raise ValueError(f"无法获取用户对象, 用户ID: {user_id}")
-
-            llm_response = await generate_chat_completion(
-                __request__, llm_payload, user_obj
-            )
-            assistant_response_content = llm_response["choices"][0]["message"][
-                "content"
-            ]
-
-            processed_content = self._process_llm_output(assistant_response_content)
-
-            context = {
-                "user_language": user_language,
-                "user_name": user_name,
-                "current_date_time_str": current_date_time_str,
-                "current_weekday": current_weekday,
-                "current_year": current_year,
-                **processed_content,
-            }
-
-            content_html = self._build_content_html(context)
-
-            # Extract existing HTML if any
-            existing_html_block = ""
-            match = re.search(
-                r"```html\s*(<!-- OPENWEBUI_PLUGIN_OUTPUT -->[\s\S]*?)```",
-                original_content,
-            )
-            if match:
-                existing_html_block = match.group(1)
-
-            if self.valves.CLEAR_PREVIOUS_HTML:
-                original_content = self._remove_existing_html(original_content)
-                final_html = self._merge_html(
-                    "", content_html, CSS_TEMPLATE_SUMMARY, "", user_language
-                )
-            else:
-                if existing_html_block:
-                    original_content = self._remove_existing_html(original_content)
-                    final_html = self._merge_html(
-                        existing_html_block,
-                        content_html,
-                        CSS_TEMPLATE_SUMMARY,
-                        "",
-                        user_language,
-                    )
-                else:
-                    final_html = self._merge_html(
-                        "", content_html, CSS_TEMPLATE_SUMMARY, "", user_language
-                    )
-
-            html_embed_tag = f"```html\n{final_html}\n```"
-            body["messages"][-1]["content"] = f"{original_content}\n\n{html_embed_tag}"
-
-            await self._emit_status(__event_emitter__, "📖 精读: 分析完成!", True)
-            await self._emit_notification(
-                __event_emitter__,
-                f"📖 精读完成，{user_name}！深度分析报告已生成。",
-                "success",
-            )
-
-        except Exception as e:
-            error_message = f"精读处理失败: {str(e)}"
-            logger.error(f"精读错误: {error_message}", exc_info=True)
-            user_facing_error = f"抱歉, 精读在处理时遇到错误: {str(e)}。\n请检查Open WebUI后端日志获取更多详情。"
-            body["messages"][-1][
-                "content"
-            ] = f"{original_content}\n\n❌ **错误:** {user_facing_error}"
-
-            await self._emit_status(__event_emitter__, "精读: 处理失败。", True)
-            await self._emit_notification(
-                __event_emitter__, f"精读处理失败, {user_name}!", "error"
-            )
-
-        return body
--- a/plugins/filters/async-context-compression/README.md
+++ b/plugins/filters/async-context-compression/README.md
@@ -1,9 +1,20 @@
 # Async Context Compression Filter

-**Author:** [Fu-Jie](https://github.com/Fu-Jie) | **Version:** 1.1.0 | **License:** MIT
+**Author:** [Fu-Jie](https://github.com/Fu-Jie) | **Version:** 1.1.2 | **License:** MIT

 This filter reduces token consumption in long conversations through intelligent summarization and message compression while keeping conversations coherent.

+## What's new in 1.1.2
+
+- **Open WebUI v0.7.x Compatibility**: Resolved a critical database session binding error affecting Open WebUI v0.7.x users. The plugin now dynamically discovers the database engine and session context, ensuring compatibility across versions.
+- **Enhanced Error Reporting**: Errors during background summary generation are now reported via both the status bar and browser console.
+- **Robust Model Handling**: Improved handling of missing or invalid model IDs to prevent crashes.
+
+## What's new in 1.1.1
+
+- **Frontend Debugging**: Added `show_debug_log` option to print debug info to the browser console (F12).
+- **Optimized Compression**: Improved token calculation logic to prevent aggressive truncation of history, ensuring more context is retained.
+
 ## What's new in 1.1.0 

 - Reuses Open WebUI's shared database connection by default (no custom engine or env vars required).
@@ -54,6 +65,7 @@ It is recommended to keep this filter early in the chain so it runs before filte
 | `summary_temperature`          | `0.3`    | Randomness for summary generation. Lower is more deterministic.                                                                                                       |
 | `model_thresholds`             | `{}`     | Per-model overrides for `compression_threshold_tokens` and `max_context_tokens` (useful for mixed models).                                                            |
 | `debug_mode`                   | `true`   | Log verbose debug info. Set to `false` in production.                                                                                                                 |
+| `show_debug_log`               | `false`  | Print debug logs to browser console (F12). Useful for frontend debugging.                                                                                             |

 ---

--- a/plugins/filters/async-context-compression/README_CN.md
+++ b/plugins/filters/async-context-compression/README_CN.md
@@ -1,11 +1,22 @@
 # 异步上下文压缩过滤器

-**作者:** [Fu-Jie](https://github.com/Fu-Jie) | **版本:** 1.2.0 | **许可证:** MIT
+**作者:** [Fu-Jie](https://github.com/Fu-Jie) | **版本:** 1.1.2 | **许可证:** MIT

 > **重要提示**：为了确保所有过滤器的可维护性和易用性，每个过滤器都应附带清晰、完整的文档，以确保其功能、配置和使用方法得到充分说明。

 本过滤器通过智能摘要和消息压缩技术，在保持对话连贯性的同时，显著降低长对话的 Token 消耗。

+## 1.1.2 版本更新
+
+- **Open WebUI v0.7.x 兼容性**: 修复了影响 Open WebUI v0.7.x 用户的严重数据库会话绑定错误。插件现在动态发现数据库引擎和会话上下文，确保跨版本兼容性。
+- **增强错误报告**: 后台摘要生成过程中的错误现在会通过状态栏和浏览器控制台同时报告。
+- **健壮的模型处理**: 改进了对缺失或无效模型 ID 的处理，防止程序崩溃。
+
+## 1.1.1 版本更新
+
+- **前端调试**: 新增 `show_debug_log` 选项，支持在浏览器控制台 (F12) 打印调试信息。
+- **压缩优化**: 优化 Token 计算逻辑，防止历史记录被过度截断，保留更多上下文。
+
 ## 1.1.0 版本更新

 - 默认复用 OpenWebUI 内置数据库连接，无需自建引擎、无需配置 `DATABASE_URL`。
@@ -94,6 +105,11 @@
 - **默认值**: `true`
 - **描述**: 是否在 Open WebUI 的控制台日志中打印详细的调试信息（如 Token 计数、压缩进度、数据库操作等）。生产环境建议设为 `false`。

+#### `show_debug_log`
+
+- **默认值**: `false`
+- **描述**: 是否在浏览器控制台 (F12) 打印调试日志。便于前端调试。
+
 ---

 ## 故障排除
--- a/plugins/filters/async-context-compression/async_context_compression.py
+++ b/plugins/filters/async-context-compression/async_context_compression.py
@@ -5,7 +5,7 @@ author: Fu-Jie
 author_url: https://github.com/Fu-Jie
 funding_url: https://github.com/Fu-Jie/awesome-openwebui
 description: Reduces token consumption in long conversations while maintaining coherence through intelligent summarization and message compression.
-version: 1.1.0
+version: 1.1.2
 openwebui_id: b1655bc8-6de9-4cad-8cb5-a6f7829a02ce
 license: MIT

@@ -139,6 +139,10 @@ debug_mode
  Default: true
  Description: Prints detailed debug information to the log. Recommended to set to `false` in production.

+show_debug_log
+  Default: false
+  Description: Print debug logs to browser console (F12). Useful for frontend debugging.
+
 🔧 Deployment
 ═══════════════════════════════════════════════════════

@@ -245,6 +249,7 @@ import asyncio
 import json
 import hashlib
 import time
+import contextlib

 # Open WebUI built-in imports
 from open_webui.utils.chat import generate_chat_completion
@@ -253,9 +258,10 @@ from fastapi.requests import Request
 from open_webui.main import app as webui_app

 # Open WebUI internal database (re-use shared connection)
-from open_webui.internal.db import engine as owui_engine
-from open_webui.internal.db import Session as owui_Session
-from open_webui.internal.db import Base as owui_Base
+try:
+    from open_webui.internal import db as owui_db
+except ModuleNotFoundError:  # pragma: no cover - filter runs inside Open WebUI
+    owui_db = None

 # Try to import tiktoken
 try:
@@ -265,14 +271,91 @@ except ImportError:

 # Database imports
 from sqlalchemy import Column, String, Text, DateTime, Integer, inspect
+from sqlalchemy.orm import declarative_base, sessionmaker
+from sqlalchemy.engine import Engine
 from datetime import datetime


+def _discover_owui_engine(db_module: Any) -> Optional[Engine]:
+    """Discover the Open WebUI SQLAlchemy engine via provided db module helpers."""
+    if db_module is None:
+        return None
+
+    db_context = getattr(db_module, "get_db_context", None) or getattr(
+        db_module, "get_db", None
+    )
+    if callable(db_context):
+        try:
+            with db_context() as session:
+                try:
+                    return session.get_bind()
+                except AttributeError:
+                    return getattr(session, "bind", None) or getattr(
+                        session, "engine", None
+                    )
+        except Exception as exc:
+            print(f"[DB Discover] get_db_context failed: {exc}")
+
+    for attr in ("engine", "ENGINE", "bind", "BIND"):
+        candidate = getattr(db_module, attr, None)
+        if candidate is not None:
+            return candidate
+
+    return None
+
+
+def _discover_owui_schema(db_module: Any) -> Optional[str]:
+    """Discover the Open WebUI database schema name if configured."""
+    if db_module is None:
+        return None
+
+    try:
+        base = getattr(db_module, "Base", None)
+        metadata = getattr(base, "metadata", None) if base is not None else None
+        candidate = getattr(metadata, "schema", None) if metadata is not None else None
+        if isinstance(candidate, str) and candidate.strip():
+            return candidate.strip()
+    except Exception as exc:
+        print(f"[DB Discover] Base metadata schema lookup failed: {exc}")
+
+    try:
+        metadata_obj = getattr(db_module, "metadata_obj", None)
+        candidate = (
+            getattr(metadata_obj, "schema", None) if metadata_obj is not None else None
+        )
+        if isinstance(candidate, str) and candidate.strip():
+            return candidate.strip()
+    except Exception as exc:
+        print(f"[DB Discover] metadata_obj schema lookup failed: {exc}")
+
+    try:
+        from open_webui import env as owui_env
+
+        candidate = getattr(owui_env, "DATABASE_SCHEMA", None)
+        if isinstance(candidate, str) and candidate.strip():
+            return candidate.strip()
+    except Exception as exc:
+        print(f"[DB Discover] env schema lookup failed: {exc}")
+
+    return None
+
+
+owui_engine = _discover_owui_engine(owui_db)
+owui_schema = _discover_owui_schema(owui_db)
+owui_Base = getattr(owui_db, "Base", None) if owui_db is not None else None
+if owui_Base is None:
+    owui_Base = declarative_base()
+
+
 class ChatSummary(owui_Base):
    """Chat Summary Storage Table"""

    __tablename__ = "chat_summary"
-    __table_args__ = {"extend_existing": True}
+    __table_args__ = (
+        {"extend_existing": True, "schema": owui_schema}
+        if owui_schema
+        else {"extend_existing": True}
+    )

    id = Column(Integer, primary_key=True, autoincrement=True)
    chat_id = Column(String(255), unique=True, nullable=False, index=True)
@@ -285,14 +368,66 @@ class ChatSummary(owui_Base):
 class Filter:
    def __init__(self):
        self.valves = self.Valves()
+        self._owui_db = owui_db
        self._db_engine = owui_engine
-        self._SessionLocal = owui_Session
        self.temp_state = {}  # Used to pass temporary data between inlet and outlet
+        self._fallback_session_factory = (
+            sessionmaker(bind=self._db_engine) if self._db_engine else None
+        )
        self._init_database()

+    @contextlib.contextmanager
+    def _db_session(self):
+        """Yield a database session using Open WebUI helpers with graceful fallbacks."""
+        db_module = self._owui_db
+        db_context = None
+        if db_module is not None:
+            db_context = getattr(db_module, "get_db_context", None) or getattr(
+                db_module, "get_db", None
+            )
+
+        if callable(db_context):
+            with db_context() as session:
+                yield session
+                return
+
+        factory = None
+        if db_module is not None:
+            factory = getattr(db_module, "SessionLocal", None) or getattr(
+                db_module, "ScopedSession", None
+            )
+        if callable(factory):
+            session = factory()
+            try:
+                yield session
+            finally:
+                close = getattr(session, "close", None)
+                if callable(close):
+                    close()
+            return
+
+        if self._fallback_session_factory is None:
+            raise RuntimeError(
+                "Open WebUI database session is unavailable. Ensure Open WebUI's database layer is initialized."
+            )
+
+        session = self._fallback_session_factory()
+        try:
+            yield session
+        finally:
+            try:
+                session.close()
+            except Exception as exc:  # pragma: no cover - best-effort cleanup
+                print(f"[Database] ⚠️ Failed to close fallback session: {exc}")
+
    def _init_database(self):
        """Initializes the database table using Open WebUI's shared connection."""
        try:
+            if self._db_engine is None:
+                raise RuntimeError(
+                    "Open WebUI database engine is unavailable. Ensure Open WebUI is configured with a valid DATABASE_URL."
+                )
+
            # Check if table exists using SQLAlchemy inspect
            inspector = inspect(self._db_engine)
            if not inspector.has_table("chat_summary"):
@@ -355,11 +490,14 @@ class Filter:
        debug_mode: bool = Field(
            default=True, description="Enable detailed logging for debugging."
        )
+        show_debug_log: bool = Field(
+            default=False, description="Print debug logs to browser console (F12)"
+        )

    def _save_summary(self, chat_id: str, summary: str, compressed_count: int):
        """Saves the summary to the database."""
        try:
-            with self._SessionLocal() as session:
+            with self._db_session() as session:
                # Find existing record
                existing = session.query(ChatSummary).filter_by(chat_id=chat_id).first()

@@ -399,7 +537,7 @@ class Filter:
    def _load_summary_record(self, chat_id: str) -> Optional[ChatSummary]:
        """Loads the summary record object from the database."""
        try:
-            with self._SessionLocal() as session:
+            with self._db_session() as session:
                record = session.query(ChatSummary).filter_by(chat_id=chat_id).first()
                if record:
                    # Detach the object from the session so it can be used after session close
@@ -480,6 +618,26 @@ class Filter:
            "max_context_tokens": self.valves.max_context_tokens,
        }

+    def _extract_chat_id(self, body: dict, metadata: Optional[dict]) -> str:
+        """Extract chat_id from body or metadata."""
+        if isinstance(body, dict):
+            chat_id = body.get("chat_id")
+            if isinstance(chat_id, str) and chat_id.strip():
+                return chat_id.strip()
+
+            body_metadata = body.get("metadata", {})
+            if isinstance(body_metadata, dict):
+                chat_id = body_metadata.get("chat_id")
+                if isinstance(chat_id, str) and chat_id.strip():
+                    return chat_id.strip()
+
+        if isinstance(metadata, dict):
+            chat_id = metadata.get("chat_id")
+            if isinstance(chat_id, str) and chat_id.strip():
+                return chat_id.strip()
+
+        return ""
+
    def _inject_summary_to_first_message(self, message: dict, summary: str) -> dict:
        """Injects the summary into the first message (prepended to content)."""
        content = message.get("content", "")
@@ -516,24 +674,130 @@ class Filter:

        return message

+    async def _emit_debug_log(
+        self,
+        __event_call__,
+        chat_id: str,
+        original_count: int,
+        compressed_count: int,
+        summary_length: int,
+        kept_first: int,
+        kept_last: int,
+    ):
+        """Emit debug log to browser console via JS execution"""
+        if not self.valves.show_debug_log or not __event_call__:
+            return
+
+        try:
+            # Prepare data for JS
+            log_data = {
+                "chatId": chat_id,
+                "originalCount": original_count,
+                "compressedCount": compressed_count,
+                "summaryLength": summary_length,
+                "keptFirst": kept_first,
+                "keptLast": kept_last,
+                "ratio": (
+                    f"{(1 - compressed_count/original_count)*100:.1f}%"
+                    if original_count > 0
+                    else "0%"
+                ),
+            }
+
+            # Construct JS code
+            js_code = f"""
+                (async function() {{
+                    console.group("🗜️ Async Context Compression Debug");
+                    console.log("Chat ID:", {json.dumps(chat_id)});
+                    console.log("Messages:", {original_count} + " -> " + {compressed_count});
+                    console.log("Compression Ratio:", {json.dumps(log_data['ratio'])});
+                    console.log("Summary Length:", {summary_length} + " chars");
+                    console.log("Configuration:", {{
+                        "Keep First": {kept_first},
+                        "Keep Last": {kept_last}
+                    }});
+                    console.groupEnd();
+                }})();
+            """
+
+            await __event_call__(
+                {
+                    "type": "execute",
+                    "data": {"code": js_code},
+                }
+            )
+        except Exception as e:
+            print(f"Error emitting debug log: {e}")
+
+    async def _log(self, message: str, type: str = "info", event_call=None):
+        """Unified logging to both backend (print) and frontend (console.log)"""
+        # Backend logging
+        if self.valves.debug_mode:
+            print(message)
+
+        # Frontend logging
+        if self.valves.show_debug_log and event_call:
+            try:
+                css = "color: #3b82f6;"  # Blue default
+                if type == "error":
+                    css = "color: #ef4444; font-weight: bold;"  # Red
+                elif type == "warning":
+                    css = "color: #f59e0b;"  # Orange
+                elif type == "success":
+                    css = "color: #10b981; font-weight: bold;"  # Green
+
+                # Clean message for frontend: remove separators and extra newlines
+                lines = message.split("\n")
+                # Keep lines that don't start with lots of equals or hyphens
+                filtered_lines = [
+                    line
+                    for line in lines
+                    if not line.strip().startswith("====")
+                    and not line.strip().startswith("----")
+                ]
+                clean_message = "\n".join(filtered_lines).strip()
+
+                if not clean_message:
+                    return
+
+                # Escape quotes in message for JS string
+                safe_message = clean_message.replace('"', '\\"').replace("\n", "\\n")
+
+                js_code = f"""
+                    console.log("%c[Compression] {safe_message}", "{css}");
+                """
+                await event_call({"type": "execute", "data": {"code": js_code}})
+            except Exception as e:
+                print(f"Failed to emit log to frontend: {e}")
+
    async def inlet(
        self,
        body: dict,
        __user__: Optional[dict] = None,
        __metadata__: dict = None,
        __event_emitter__: Callable[[Any], Awaitable[None]] = None,
+        __event_call__: Callable[[Any], Awaitable[None]] = None,
    ) -> dict:
        """
        Executed before sending to the LLM.
        Compression Strategy: Only responsible for injecting existing summaries, no Token calculation.
        """
        messages = body.get("messages", [])
-        chat_id = __metadata__["chat_id"]
+        chat_id = self._extract_chat_id(body, __metadata__)

-        if self.valves.debug_mode:
-            print(f"\n{'='*60}")
-            print(f"[Inlet] Chat ID: {chat_id}")
-            print(f"[Inlet] Received {len(messages)} messages")
+        if not chat_id:
+            await self._log(
+                "[Inlet] ❌ Missing chat_id in metadata, skipping compression",
+                type="error",
+                event_call=__event_call__,
+            )
+            return body
+
+        if self.valves.debug_mode or self.valves.show_debug_log:
+            await self._log(
+                f"\n{'='*60}\n[Inlet] Chat ID: {chat_id}\n[Inlet] Received {len(messages)} messages",
+                event_call=__event_call__,
+            )

        # Record the target compression progress for the original messages, for use in outlet
        # Target is to compress up to the (total - keep_last) message
@@ -541,17 +805,18 @@ class Filter:

        # [Optimization] Simple state cleanup check
        if chat_id in self.temp_state:
-            if self.valves.debug_mode:
-                print(
-                    f"[Inlet] ⚠️ Overwriting unconsumed old state (Chat ID: {chat_id})"
-                )
+            await self._log(
+                f"[Inlet] ⚠️ Overwriting unconsumed old state (Chat ID: {chat_id})",
+                type="warning",
+                event_call=__event_call__,
+            )

        self.temp_state[chat_id] = target_compressed_count

-        if self.valves.debug_mode:
-            print(
-                f"[Inlet] Recorded target compression progress: {target_compressed_count}"
-            )
+        await self._log(
+            f"[Inlet] Recorded target compression progress: {target_compressed_count}",
+            event_call=__event_call__,
+        )

        # Load summary record
        summary_record = await asyncio.to_thread(self._load_summary_record, chat_id)
@@ -600,19 +865,32 @@ class Filter:
                    }
                )

-            if self.valves.debug_mode:
-                print(
-                    f"[Inlet] Applied summary: Head({len(head_messages)}) + Summary + Tail({len(tail_messages)})"
-                )
+            await self._log(
+                f"[Inlet] Applied summary: Head({len(head_messages)}) + Summary + Tail({len(tail_messages)})",
+                type="success",
+                event_call=__event_call__,
+            )
+
+            # Emit debug log to frontend (Keep the structured log as well)
+            await self._emit_debug_log(
+                __event_call__,
+                chat_id,
+                len(messages),
+                len(final_messages),
+                len(summary_record.summary),
+                self.valves.keep_first,
+                self.valves.keep_last,
+            )
        else:
            # No summary, use original messages
            final_messages = messages

        body["messages"] = final_messages

-        if self.valves.debug_mode:
-            print(f"[Inlet] Final send: {len(body['messages'])} messages")
-            print(f"{'='*60}\n")
+        await self._log(
+            f"[Inlet] Final send: {len(body['messages'])} messages\n{'='*60}\n",
+            event_call=__event_call__,
+        )

        return body

@@ -622,29 +900,39 @@ class Filter:
        __user__: Optional[dict] = None,
        __metadata__: dict = None,
        __event_emitter__: Callable[[Any], Awaitable[None]] = None,
+        __event_call__: Callable[[Any], Awaitable[None]] = None,
    ) -> dict:
        """
        Executed after the LLM response is complete.
        Calculates Token count in the background and triggers summary generation (does not block current response, does not affect content output).
        """
-        chat_id = __metadata__["chat_id"]
+        chat_id = self._extract_chat_id(body, __metadata__)
+        if not chat_id:
+            await self._log(
+                "[Outlet] ❌ Missing chat_id in metadata, skipping compression",
+                type="error",
+                event_call=__event_call__,
+            )
+            return body
        model = body.get("model", "gpt-3.5-turbo")

-        if self.valves.debug_mode:
-            print(f"\n{'='*60}")
-            print(f"[Outlet] Chat ID: {chat_id}")
-            print(f"[Outlet] Response complete")
+        if self.valves.debug_mode or self.valves.show_debug_log:
+            await self._log(
+                f"\n{'='*60}\n[Outlet] Chat ID: {chat_id}\n[Outlet] Response complete",
+                event_call=__event_call__,
+            )

        # Process Token calculation and summary generation asynchronously in the background (do not wait for completion, do not affect output)
        asyncio.create_task(
            self._check_and_generate_summary_async(
-                chat_id, model, body, __user__, __event_emitter__
+                chat_id, model, body, __user__, __event_emitter__, __event_call__
            )
        )

-        if self.valves.debug_mode:
-            print(f"[Outlet] Background processing started")
-            print(f"{'='*60}\n")
+        await self._log(
+            f"[Outlet] Background processing started\n{'='*60}\n",
+            event_call=__event_call__,
+        )

        return body

@@ -655,6 +943,7 @@ class Filter:
        body: dict,
        user_data: Optional[dict],
        __event_emitter__: Callable[[Any], Awaitable[None]] = None,
+        __event_call__: Callable[[Any], Awaitable[None]] = None,
    ):
        """
        Background processing: Calculates Token count and generates summary (does not block response).
@@ -668,36 +957,57 @@ class Filter:
                "compression_threshold_tokens", self.valves.compression_threshold_tokens
            )

-            if self.valves.debug_mode:
-                print(f"\n[🔍 Background Calculation] Starting Token count...")
+            await self._log(
+                f"\n[🔍 Background Calculation] Starting Token count...",
+                event_call=__event_call__,
+            )

            # Calculate Token count in a background thread
            current_tokens = await asyncio.to_thread(
                self._calculate_messages_tokens, messages
            )

-            if self.valves.debug_mode:
-                print(f"[🔍 Background Calculation] Token count: {current_tokens}")
+            await self._log(
+                f"[🔍 Background Calculation] Token count: {current_tokens}",
+                event_call=__event_call__,
+            )

            # Check if compression is needed
            if current_tokens >= compression_threshold_tokens:
-                if self.valves.debug_mode:
-                    print(
-                        f"[🔍 Background Calculation] ⚡ Compression threshold triggered (Token: {current_tokens} >= {compression_threshold_tokens})"
-                    )
+                await self._log(
+                    f"[🔍 Background Calculation] ⚡ Compression threshold triggered (Token: {current_tokens} >= {compression_threshold_tokens})",
+                    type="warning",
+                    event_call=__event_call__,
+                )

                # Proceed to generate summary
                await self._generate_summary_async(
-                    messages, chat_id, body, user_data, __event_emitter__
+                    messages,
+                    chat_id,
+                    body,
+                    user_data,
+                    __event_emitter__,
+                    __event_call__,
                )
            else:
-                if self.valves.debug_mode:
-                    print(
-                        f"[🔍 Background Calculation] Compression threshold not reached (Token: {current_tokens} < {compression_threshold_tokens})"
-                    )
+                await self._log(
+                    f"[🔍 Background Calculation] Compression threshold not reached (Token: {current_tokens} < {compression_threshold_tokens})",
+                    event_call=__event_call__,
+                )

        except Exception as e:
-            print(f"[🔍 Background Calculation] ❌ Error: {str(e)}")
+            await self._log(
+                f"[🔍 Background Calculation] ❌ Error: {str(e)}",
+                type="error",
+                event_call=__event_call__,
+            )
+
+    def _clean_model_id(self, model_id: Optional[str]) -> Optional[str]:
+        """Cleans the model ID by removing whitespace and quotes."""
+        if not model_id:
+            return None
+        cleaned = model_id.strip().strip('"').strip("'")
+        return cleaned if cleaned else None

    async def _generate_summary_async(
        self,
@@ -706,6 +1016,7 @@ class Filter:
        body: dict,
        user_data: Optional[dict],
        __event_emitter__: Callable[[Any], Awaitable[None]] = None,
+        __event_call__: Callable[[Any], Awaitable[None]] = None,
    ):
        """
        Generates summary asynchronously (runs in background, does not block response).
@@ -715,18 +1026,20 @@ class Filter:
        3. Generate summary for the remaining middle messages.
        """
        try:
-            if self.valves.debug_mode:
-                print(f"\n[🤖 Async Summary Task] Starting...")
+            await self._log(
+                f"\n[🤖 Async Summary Task] Starting...", event_call=__event_call__
+            )

            # 1. Get target compression progress
            # Prioritize getting from temp_state (calculated by inlet). If unavailable (e.g., after restart), assume current is full history.
            target_compressed_count = self.temp_state.pop(chat_id, None)
            if target_compressed_count is None:
                target_compressed_count = max(0, len(messages) - self.valves.keep_last)
-                if self.valves.debug_mode:
-                    print(
-                        f"[🤖 Async Summary Task] ⚠️ Could not get inlet state, estimating progress using current message count: {target_compressed_count}"
-                    )
+                await self._log(
+                    f"[🤖 Async Summary Task] ⚠️ Could not get inlet state, estimating progress using current message count: {target_compressed_count}",
+                    type="warning",
+                    event_call=__event_call__,
+                )

            # 2. Determine the range of messages to compress (Middle)
            start_index = self.valves.keep_first
@@ -736,25 +1049,33 @@ class Filter:

            # Ensure indices are valid
            if start_index >= end_index:
-                if self.valves.debug_mode:
-                    print(
-                        f"[🤖 Async Summary Task] Middle messages empty (Start: {start_index}, End: {end_index}), skipping"
-                    )
+                await self._log(
+                    f"[🤖 Async Summary Task] Middle messages empty (Start: {start_index}, End: {end_index}), skipping",
+                    event_call=__event_call__,
+                )
                return

            middle_messages = messages[start_index:end_index]

-            if self.valves.debug_mode:
-                print(
-                    f"[🤖 Async Summary Task] Middle messages to process: {len(middle_messages)}"
-                )
+            await self._log(
+                f"[🤖 Async Summary Task] Middle messages to process: {len(middle_messages)}",
+                event_call=__event_call__,
+            )

            # 3. Check Token limit and truncate (Max Context Truncation)
            # [Optimization] Use the summary model's (if any) threshold to decide how many middle messages can be processed
            # This allows using a long-window model (like gemini-flash) to compress history exceeding the current model's window
-            summary_model_id = self.valves.summary_model or body.get(
-                "model", "gpt-3.5-turbo"
-            )
+            summary_model_id = self._clean_model_id(
+                self.valves.summary_model
+            ) or self._clean_model_id(body.get("model"))
+
+            if not summary_model_id:
+                await self._log(
+                    "[🤖 Async Summary Task] ⚠️ Summary model does not exist, skipping compression",
+                    type="warning",
+                    event_call=__event_call__,
+                )
+                return

            thresholds = self._get_model_thresholds(summary_model_id)
            # Note: Using the summary model's max context limit here
@@ -762,22 +1083,26 @@ class Filter:
                "max_context_tokens", self.valves.max_context_tokens
            )

-            if self.valves.debug_mode:
-                print(
-                    f"[🤖 Async Summary Task] Using max limit for model {summary_model_id}: {max_context_tokens} Tokens"
-                )
-
-            # Calculate current total Tokens (using summary model for counting)
-            total_tokens = await asyncio.to_thread(
-                self._calculate_messages_tokens, messages
+            await self._log(
+                f"[🤖 Async Summary Task] Using max limit for model {summary_model_id}: {max_context_tokens} Tokens",
+                event_call=__event_call__,
            )

-            if total_tokens > max_context_tokens:
-                excess_tokens = total_tokens - max_context_tokens
-                if self.valves.debug_mode:
-                    print(
-                        f"[🤖 Async Summary Task] ⚠️ Total Tokens ({total_tokens}) exceed summary model limit ({max_context_tokens}), need to remove approx {excess_tokens} Tokens"
-                    )
+            # Calculate tokens for middle messages only (plus buffer for prompt)
+            # We only send middle_messages to the summary model, so we shouldn't count the full history against its limit.
+            middle_tokens = await asyncio.to_thread(
+                self._calculate_messages_tokens, middle_messages
+            )
+            # Add buffer for prompt and output (approx 2000 tokens)
+            estimated_input_tokens = middle_tokens + 2000
+
+            if estimated_input_tokens > max_context_tokens:
+                excess_tokens = estimated_input_tokens - max_context_tokens
+                await self._log(
+                    f"[🤖 Async Summary Task] ⚠️ Middle messages ({middle_tokens} Tokens) + Buffer exceed summary model limit ({max_context_tokens}), need to remove approx {excess_tokens} Tokens",
+                    type="warning",
+                    event_call=__event_call__,
+                )

                # Remove from the head of middle_messages
                removed_tokens = 0
@@ -785,20 +1110,22 @@ class Filter:

                while removed_tokens < excess_tokens and middle_messages:
                    msg_to_remove = middle_messages.pop(0)
-                    msg_tokens = self._count_tokens(str(msg_to_remove.get("content", "")))
+                    msg_tokens = self._count_tokens(
+                        str(msg_to_remove.get("content", ""))
+                    )
                    removed_tokens += msg_tokens
                    removed_count += 1

-                if self.valves.debug_mode:
-                    print(
-                        f"[🤖 Async Summary Task] Removed {removed_count} messages, totaling {removed_tokens} Tokens"
-                    )
+                await self._log(
+                    f"[🤖 Async Summary Task] Removed {removed_count} messages, totaling {removed_tokens} Tokens",
+                    event_call=__event_call__,
+                )

            if not middle_messages:
-                if self.valves.debug_mode:
-                    print(
-                        f"[🤖 Async Summary Task] Middle messages empty after truncation, skipping summary generation"
-                    )
+                await self._log(
+                    f"[🤖 Async Summary Task] Middle messages empty after truncation, skipping summary generation",
+                    event_call=__event_call__,
+                )
                return

            # 4. Build conversation text
@@ -820,14 +1147,26 @@ class Filter:
                )

            new_summary = await self._call_summary_llm(
-                None, conversation_text, body, user_data
+                None,
+                conversation_text,
+                {**body, "model": summary_model_id},
+                user_data,
+                __event_call__,
            )

-            # 6. Save new summary
-            if self.valves.debug_mode:
-                print(
-                    "[Optimization] Saving summary in a background thread to avoid blocking the event loop."
+            if not new_summary:
+                await self._log(
+                    "[🤖 Async Summary Task] ⚠️ Summary generation returned empty result, skipping save",
+                    type="warning",
+                    event_call=__event_call__,
                )
+                return
+
+            # 6. Save new summary
+            await self._log(
+                "[Optimization] Saving summary in a background thread to avoid blocking the event loop.",
+                event_call=__event_call__,
+            )

            await asyncio.to_thread(
                self._save_summary, chat_id, new_summary, target_compressed_count
@@ -845,16 +1184,34 @@ class Filter:
                    }
                )

-            if self.valves.debug_mode:
-                print(
-                    f"[🤖 Async Summary Task] ✅ Complete! New summary length: {len(new_summary)} characters"
-                )
-                print(
-                    f"[🤖 Async Summary Task] Progress update: Compressed up to original message {target_compressed_count}"
-                )
+            await self._log(
+                f"[🤖 Async Summary Task] ✅ Complete! New summary length: {len(new_summary)} characters",
+                type="success",
+                event_call=__event_call__,
+            )
+            await self._log(
+                f"[🤖 Async Summary Task] Progress update: Compressed up to original message {target_compressed_count}",
+                event_call=__event_call__,
+            )

        except Exception as e:
-            print(f"[🤖 Async Summary Task] ❌ Error: {str(e)}")
+            await self._log(
+                f"[🤖 Async Summary Task] ❌ Error: {str(e)}",
+                type="error",
+                event_call=__event_call__,
+            )
+
+            if __event_emitter__:
+                await __event_emitter__(
+                    {
+                        "type": "status",
+                        "data": {
+                            "description": f"Summary Error: {str(e)[:100]}...",
+                            "done": True,
+                        },
+                    }
+                )
+
            import traceback

            traceback.print_exc()
@@ -891,12 +1248,15 @@ class Filter:
        new_conversation_text: str,
        body: dict,
        user_data: dict,
+        __event_call__: Callable[[Any], Awaitable[None]] = None,
    ) -> str:
        """
        Calls the LLM to generate a summary using Open WebUI's built-in method.
        """
-        if self.valves.debug_mode:
-            print(f"[🤖 LLM Call] Using Open WebUI's built-in method")
+        await self._log(
+            f"[🤖 LLM Call] Using Open WebUI's built-in method",
+            event_call=__event_call__,
+        )

        # Build summary prompt (Optimized)
        summary_prompt = f"""
@@ -933,10 +1293,19 @@ This conversation may contain previous summaries (as system messages or text) an
 Based on the content above, generate the summary:
 """
        # Determine the model to use
-        model = self.valves.summary_model or body.get("model", "")
+        model = self._clean_model_id(self.valves.summary_model) or self._clean_model_id(
+            body.get("model")
+        )

-        if self.valves.debug_mode:
-            print(f"[🤖 LLM Call] Model: {model}")
+        if not model:
+            await self._log(
+                "[🤖 LLM Call] ⚠️ Summary model does not exist, skipping summary generation",
+                type="warning",
+                event_call=__event_call__,
+            )
+            return ""
+
+        await self._log(f"[🤖 LLM Call] Model: {model}", event_call=__event_call__)

        # Build payload
        payload = {
@@ -954,18 +1323,19 @@ Based on the content above, generate the summary:
                raise ValueError("Could not get user ID")

            # [Optimization] Get user object in a background thread to avoid blocking the event loop.
-            if self.valves.debug_mode:
-                print(
-                    "[Optimization] Getting user object in a background thread to avoid blocking the event loop."
-                )
+            await self._log(
+                "[Optimization] Getting user object in a background thread to avoid blocking the event loop.",
+                event_call=__event_call__,
+            )
            user = await asyncio.to_thread(Users.get_user_by_id, user_id)

            if not user:
                raise ValueError(f"Could not find user: {user_id}")

-            if self.valves.debug_mode:
-                print(f"[🤖 LLM Call] User: {user.email}")
-                print(f"[🤖 LLM Call] Sending request...")
+            await self._log(
+                f"[🤖 LLM Call] User: {user.email}\n[🤖 LLM Call] Sending request...",
+                event_call=__event_call__,
+            )

            # Create Request object
            request = Request(scope={"type": "http", "app": webui_app})
@@ -978,20 +1348,31 @@ Based on the content above, generate the summary:

            summary = response["choices"][0]["message"]["content"].strip()

-            if self.valves.debug_mode:
-                print(f"[🤖 LLM Call] ✅ Successfully received summary")
+            await self._log(
+                f"[🤖 LLM Call] ✅ Successfully received summary",
+                type="success",
+                event_call=__event_call__,
+            )

            return summary

        except Exception as e:
-            error_message = f"Error occurred while calling LLM ({model}) to generate summary: {str(e)}"
+            error_msg = str(e)
+            # Handle specific error messages
+            if "Model not found" in error_msg:
+                error_message = f"Summary model '{model}' not found."
+            else:
+                error_message = f"Summary LLM Error ({model}): {error_msg}"
            if not self.valves.summary_model:
                error_message += (
                    "\n[Hint] You did not specify a summary_model, so the filter attempted to use the current conversation's model. "
                    "If this is a pipeline (Pipe) model or an incompatible model, please specify a compatible summary model (e.g., 'gemini-2.5-flash') in the configuration."
                )

-            if self.valves.debug_mode:
-                print(f"[🤖 LLM Call] ❌ {error_message}")
+            await self._log(
+                f"[🤖 LLM Call] ❌ {error_message}",
+                type="error",
+                event_call=__event_call__,
+            )

            raise Exception(error_message)
--- a/plugins/filters/async-context-compression/async_context_compression_cn.py
+++ b/plugins/filters/async-context-compression/async_context_compression_cn.py
@@ -5,7 +5,7 @@ author: Fu-Jie
 author_url: https://github.com/Fu-Jie
 funding_url: https://github.com/Fu-Jie/awesome-openwebui
 description: 通过智能摘要和消息压缩，降低长对话的 token 消耗，同时保持对话连贯性。
-version: 1.1.0
+version: 1.1.2
 openwebui_id: 5c0617cb-a9e4-4bd6-a440-d276534ebd18
 license: MIT

@@ -138,6 +138,10 @@ debug_mode (调试模式)
  默认: true
  说明: 在日志中打印详细的调试信息。生产环境建议设为 `false`。

+show_debug_log (前端调试日志)
+  默认: false
+  说明: 在浏览器控制台打印调试日志 (F12)。便于前端调试。
+
 🔧 部署配置
 ═══════════════════════════════════════════════════════

@@ -345,6 +349,9 @@ class Filter:
            default=0.1, ge=0.0, le=2.0, description="摘要生成的温度参数"
        )
        debug_mode: bool = Field(default=True, description="调试模式，打印详细日志")
+        show_debug_log: bool = Field(
+            default=False, description="在浏览器控制台打印调试日志 (F12)"
+        )

    def _save_summary(self, chat_id: str, summary: str, compressed_count: int):
        """保存摘要到数据库"""
@@ -426,9 +433,7 @@ class Filter:
        # 回退策略：粗略估算 (1 token ≈ 4 chars)
        return len(text) // 4

-    def _calculate_messages_tokens(
-        self, messages: List[Dict]
-    ) -> int:
+    def _calculate_messages_tokens(self, messages: List[Dict]) -> int:
        """计算消息列表的总 Token 数"""
        total_tokens = 0
        for msg in messages:
@@ -502,12 +507,109 @@ class Filter:

        return message

+    async def _emit_debug_log(
+        self,
+        __event_call__,
+        chat_id: str,
+        original_count: int,
+        compressed_count: int,
+        summary_length: int,
+        kept_first: int,
+        kept_last: int,
+    ):
+        """Emit debug log to browser console via JS execution"""
+        if not self.valves.show_debug_log or not __event_call__:
+            return
+
+        try:
+            # Prepare data for JS
+            log_data = {
+                "chatId": chat_id,
+                "originalCount": original_count,
+                "compressedCount": compressed_count,
+                "summaryLength": summary_length,
+                "keptFirst": kept_first,
+                "keptLast": kept_last,
+                "ratio": (
+                    f"{(1 - compressed_count/original_count)*100:.1f}%"
+                    if original_count > 0
+                    else "0%"
+                ),
+            }
+
+            # Construct JS code
+            js_code = f"""
+                (async function() {{
+                    console.group("🗜️ Async Context Compression Debug");
+                    console.log("Chat ID:", {json.dumps(chat_id)});
+                    console.log("Messages:", {original_count} + " -> " + {compressed_count});
+                    console.log("Compression Ratio:", {json.dumps(log_data['ratio'])});
+                    console.log("Summary Length:", {summary_length} + " chars");
+                    console.log("Configuration:", {{
+                        "Keep First": {kept_first},
+                        "Keep Last": {kept_last}
+                    }});
+                    console.groupEnd();
+                }})();
+            """
+
+            await __event_call__(
+                {
+                    "type": "execute",
+                    "data": {"code": js_code},
+                }
+            )
+        except Exception as e:
+            print(f"Error emitting debug log: {e}")
+
+    async def _log(self, message: str, type: str = "info", event_call=None):
+        """统一日志输出到后端 (print) 和前端 (console.log)"""
+        # 后端日志
+        if self.valves.debug_mode:
+            print(message)
+
+        # 前端日志
+        if self.valves.show_debug_log and event_call:
+            try:
+                css = "color: #3b82f6;"  # 默认蓝色
+                if type == "error":
+                    css = "color: #ef4444; font-weight: bold;"  # 红色
+                elif type == "warning":
+                    css = "color: #f59e0b;"  # 橙色
+                elif type == "success":
+                    css = "color: #10b981; font-weight: bold;"  # 绿色
+
+                # 清理前端消息：移除分隔符和多余换行
+                lines = message.split("\n")
+                # 保留不以大量等号或连字符开头的行
+                filtered_lines = [
+                    line
+                    for line in lines
+                    if not line.strip().startswith("====")
+                    and not line.strip().startswith("----")
+                ]
+                clean_message = "\n".join(filtered_lines).strip()
+
+                if not clean_message:
+                    return
+
+                # 转义消息中的引号和换行符
+                safe_message = clean_message.replace('"', '\\"').replace("\n", "\\n")
+
+                js_code = f"""
+                    console.log("%c[压缩] {safe_message}", "{css}");
+                """
+                await event_call({"type": "execute", "data": {"code": js_code}})
+            except Exception as e:
+                print(f"发送前端日志失败: {e}")
+
    async def inlet(
        self,
        body: dict,
        __user__: Optional[dict] = None,
        __metadata__: dict = None,
        __event_emitter__: Callable[[Any], Awaitable[None]] = None,
+        __event_call__: Callable[[Any], Awaitable[None]] = None,
    ) -> dict:
        """
        在发送到 LLM 之前执行
@@ -516,10 +618,11 @@ class Filter:
        messages = body.get("messages", [])
        chat_id = __metadata__["chat_id"]

-        if self.valves.debug_mode:
-            print(f"\n{'='*60}")
-            print(f"[Inlet] Chat ID: {chat_id}")
-            print(f"[Inlet] 收到 {len(messages)} 条消息")
+        if self.valves.debug_mode or self.valves.show_debug_log:
+            await self._log(
+                f"\n{'='*60}\n[Inlet] Chat ID: {chat_id}\n[Inlet] 收到 {len(messages)} 条消息",
+                event_call=__event_call__,
+            )

        # 记录原始消息的目标压缩进度，供 outlet 使用
        # 目标是压缩到倒数第 keep_last 条之前
@@ -527,13 +630,18 @@ class Filter:

        # [优化] 简单的状态清理检查
        if chat_id in self.temp_state:
-            if self.valves.debug_mode:
-                print(f"[Inlet] ⚠️ 覆盖未消费的旧状态 (Chat ID: {chat_id})")
+            await self._log(
+                f"[Inlet] ⚠️ 覆盖未消费的旧状态 (Chat ID: {chat_id})",
+                type="warning",
+                event_call=__event_call__,
+            )

        self.temp_state[chat_id] = target_compressed_count

-        if self.valves.debug_mode:
-            print(f"[Inlet] 记录目标压缩进度: {target_compressed_count}")
+        await self._log(
+            f"[Inlet] 记录目标压缩进度: {target_compressed_count}",
+            event_call=__event_call__,
+        )

        # 加载摘要记录
        summary_record = await asyncio.to_thread(self._load_summary_record, chat_id)
@@ -582,19 +690,32 @@ class Filter:
                    }
                )

-            if self.valves.debug_mode:
-                print(
-                    f"[Inlet] 应用摘要: Head({len(head_messages)}) + Summary + Tail({len(tail_messages)})"
-                )
+            await self._log(
+                f"[Inlet] 应用摘要: Head({len(head_messages)}) + Summary + Tail({len(tail_messages)})",
+                type="success",
+                event_call=__event_call__,
+            )
+
+            # Emit debug log to frontend (Keep the structured log as well)
+            await self._emit_debug_log(
+                __event_call__,
+                chat_id,
+                len(messages),
+                len(final_messages),
+                len(summary_record.summary),
+                self.valves.keep_first,
+                self.valves.keep_last,
+            )
        else:
            # 没有摘要，使用原始消息
            final_messages = messages

        body["messages"] = final_messages

-        if self.valves.debug_mode:
-            print(f"[Inlet] 最终发送: {len(body['messages'])} 条消息")
-            print(f"{'='*60}\n")
+        await self._log(
+            f"[Inlet] 最终发送: {len(body['messages'])} 条消息\n{'='*60}\n",
+            event_call=__event_call__,
+        )

        return body

@@ -604,6 +725,7 @@ class Filter:
        __user__: Optional[dict] = None,
        __metadata__: dict = None,
        __event_emitter__: Callable[[Any], Awaitable[None]] = None,
+        __event_call__: Callable[[Any], Awaitable[None]] = None,
    ) -> dict:
        """
        在 LLM 响应完成后执行
@@ -612,21 +734,23 @@ class Filter:
        chat_id = __metadata__["chat_id"]
        model = body.get("model", "gpt-3.5-turbo")

-        if self.valves.debug_mode:
-            print(f"\n{'='*60}")
-            print(f"[Outlet] Chat ID: {chat_id}")
-            print(f"[Outlet] 响应完成")
+        if self.valves.debug_mode or self.valves.show_debug_log:
+            await self._log(
+                f"\n{'='*60}\n[Outlet] Chat ID: {chat_id}\n[Outlet] 响应完成",
+                event_call=__event_call__,
+            )

        # 在后台异步处理 Token 计算和摘要生成（不等待完成，不影响输出）
        asyncio.create_task(
            self._check_and_generate_summary_async(
-                chat_id, model, body, __user__, __event_emitter__
+                chat_id, model, body, __user__, __event_emitter__, __event_call__
            )
        )

-        if self.valves.debug_mode:
-            print(f"[Outlet] 后台处理已启动")
-            print(f"{'='*60}\n")
+        await self._log(
+            f"[Outlet] 后台处理已启动\n{'='*60}\n",
+            event_call=__event_call__,
+        )

        return body

@@ -637,6 +761,7 @@ class Filter:
        body: dict,
        user_data: Optional[dict],
        __event_emitter__: Callable[[Any], Awaitable[None]] = None,
+        __event_call__: Callable[[Any], Awaitable[None]] = None,
    ):
        """
        后台处理：计算 Token 数并生成摘要（不阻塞响应）
@@ -650,36 +775,57 @@ class Filter:
                "compression_threshold_tokens", self.valves.compression_threshold_tokens
            )

-            if self.valves.debug_mode:
-                print(f"\n[🔍 后台计算] 开始 Token 计数...")
+            await self._log(
+                f"\n[🔍 后台计算] 开始 Token 计数...",
+                event_call=__event_call__,
+            )

            # 在后台线程中计算 Token 数
            current_tokens = await asyncio.to_thread(
                self._calculate_messages_tokens, messages
            )

-            if self.valves.debug_mode:
-                print(f"[🔍 后台计算] Token 数: {current_tokens}")
+            await self._log(
+                f"[🔍 后台计算] Token 数: {current_tokens}",
+                event_call=__event_call__,
+            )

            # 检查是否需要压缩
            if current_tokens >= compression_threshold_tokens:
-                if self.valves.debug_mode:
-                    print(
-                        f"[🔍 后台计算] ⚡ 触发压缩阈值 (Token: {current_tokens} >= {compression_threshold_tokens})"
-                    )
+                await self._log(
+                    f"[🔍 后台计算] ⚡ 触发压缩阈值 (Token: {current_tokens} >= {compression_threshold_tokens})",
+                    type="warning",
+                    event_call=__event_call__,
+                )

                # 继续生成摘要
                await self._generate_summary_async(
-                    messages, chat_id, body, user_data, __event_emitter__
+                    messages,
+                    chat_id,
+                    body,
+                    user_data,
+                    __event_emitter__,
+                    __event_call__,
                )
            else:
-                if self.valves.debug_mode:
-                    print(
-                        f"[🔍 后台计算] 未触发压缩阈值 (Token: {current_tokens} < {compression_threshold_tokens})"
-                    )
+                await self._log(
+                    f"[🔍 后台计算] 未触发压缩阈值 (Token: {current_tokens} < {compression_threshold_tokens})",
+                    event_call=__event_call__,
+                )

        except Exception as e:
-            print(f"[🔍 后台计算] ❌ 错误: {str(e)}")
+            await self._log(
+                f"[🔍 后台计算] ❌ 错误: {str(e)}",
+                type="error",
+                event_call=__event_call__,
+            )
+
+    def _clean_model_id(self, model_id: Optional[str]) -> Optional[str]:
+        """Cleans the model ID by removing whitespace and quotes."""
+        if not model_id:
+            return None
+        cleaned = model_id.strip().strip('"').strip("'")
+        return cleaned if cleaned else None

    async def _generate_summary_async(
        self,
@@ -688,6 +834,7 @@ class Filter:
        body: dict,
        user_data: Optional[dict],
        __event_emitter__: Callable[[Any], Awaitable[None]] = None,
+        __event_call__: Callable[[Any], Awaitable[None]] = None,
    ):
        """
        异步生成摘要（后台执行，不阻塞响应）
@@ -697,18 +844,18 @@ class Filter:
        3. 对剩余的中间消息生成摘要。
        """
        try:
-            if self.valves.debug_mode:
-                print(f"\n[🤖 异步摘要任务] 开始...")
+            await self._log(f"\n[🤖 异步摘要任务] 开始...", event_call=__event_call__)

            # 1. 获取目标压缩进度
            # 优先从 temp_state 获取（由 inlet 计算），如果获取不到（例如重启后），则假设当前是完整历史
            target_compressed_count = self.temp_state.pop(chat_id, None)
            if target_compressed_count is None:
                target_compressed_count = max(0, len(messages) - self.valves.keep_last)
-                if self.valves.debug_mode:
-                    print(
-                        f"[🤖 异步摘要任务] ⚠️ 无法获取 inlet 状态，使用当前消息数估算进度: {target_compressed_count}"
-                    )
+                await self._log(
+                    f"[🤖 异步摘要任务] ⚠️ 无法获取 inlet 状态，使用当前消息数估算进度: {target_compressed_count}",
+                    type="warning",
+                    event_call=__event_call__,
+                )

            # 2. 确定待压缩的消息范围 (Middle)
            start_index = self.valves.keep_first
@@ -718,21 +865,33 @@ class Filter:

            # 确保索引有效
            if start_index >= end_index:
-                if self.valves.debug_mode:
-                    print(
-                        f"[🤖 异步摘要任务] 中间消息为空 (Start: {start_index}, End: {end_index})，跳过"
-                    )
+                await self._log(
+                    f"[🤖 异步摘要任务] 中间消息为空 (Start: {start_index}, End: {end_index})，跳过",
+                    event_call=__event_call__,
+                )
                return

            middle_messages = messages[start_index:end_index]

-            if self.valves.debug_mode:
-                print(f"[🤖 异步摘要任务] 待处理中间消息: {len(middle_messages)} 条")
+            await self._log(
+                f"[🤖 异步摘要任务] 待处理中间消息: {len(middle_messages)} 条",
+                event_call=__event_call__,
+            )

            # 3. 检查 Token 上限并截断 (Max Context Truncation)
            # [优化] 使用摘要模型(如果有)的阈值来决定能处理多少中间消息
            # 这样可以用长窗口模型(如 gemini-flash)来压缩超过当前模型窗口的历史记录
-            summary_model_id = self.valves.summary_model or body.get("model")
+            summary_model_id = self._clean_model_id(
+                self.valves.summary_model
+            ) or self._clean_model_id(body.get("model"))
+
+            if not summary_model_id:
+                await self._log(
+                    "[🤖 异步摘要任务] ⚠️ 摘要模型不存在，跳过压缩",
+                    type="warning",
+                    event_call=__event_call__,
+                )
+                return

            thresholds = self._get_model_thresholds(summary_model_id)
            # 注意：这里使用的是摘要模型的最大上下文限制
@@ -740,22 +899,26 @@ class Filter:
                "max_context_tokens", self.valves.max_context_tokens
            )

-            if self.valves.debug_mode:
-                print(
-                    f"[🤖 异步摘要任务] 使用模型 {summary_model_id} 的上限: {max_context_tokens} Tokens"
-                )
-
-            # 计算当前总 Token (使用摘要模型进行计数)
-            total_tokens = await asyncio.to_thread(
-                self._calculate_messages_tokens, messages
+            await self._log(
+                f"[🤖 异步摘要任务] 使用模型 {summary_model_id} 的上限: {max_context_tokens} Tokens",
+                event_call=__event_call__,
            )

-            if total_tokens > max_context_tokens:
-                excess_tokens = total_tokens - max_context_tokens
-                if self.valves.debug_mode:
-                    print(
-                        f"[🤖 异步摘要任务] ⚠️ 总 Token ({total_tokens}) 超过摘要模型上限 ({max_context_tokens})，需要移除约 {excess_tokens} Token"
-                    )
+            # 计算中间消息的 Token (加上提示词的缓冲)
+            # 我们只把 middle_messages 发送给摘要模型，所以不应该把完整历史计入限制
+            middle_tokens = await asyncio.to_thread(
+                self._calculate_messages_tokens, middle_messages
+            )
+            # 增加提示词和输出的缓冲 (约 2000 Tokens)
+            estimated_input_tokens = middle_tokens + 2000
+
+            if estimated_input_tokens > max_context_tokens:
+                excess_tokens = estimated_input_tokens - max_context_tokens
+                await self._log(
+                    f"[🤖 异步摘要任务] ⚠️ 中间消息 ({middle_tokens} Tokens) + 缓冲超过摘要模型上限 ({max_context_tokens})，需要移除约 {excess_tokens} Token",
+                    type="warning",
+                    event_call=__event_call__,
+                )

                # 从 middle_messages 头部开始移除
                removed_tokens = 0
@@ -769,14 +932,16 @@ class Filter:
                    removed_tokens += msg_tokens
                    removed_count += 1

-                if self.valves.debug_mode:
-                    print(
-                        f"[🤖 异步摘要任务] 已移除 {removed_count} 条消息，共 {removed_tokens} Token"
-                    )
+                await self._log(
+                    f"[🤖 异步摘要任务] 已移除 {removed_count} 条消息，共 {removed_tokens} Token",
+                    event_call=__event_call__,
+                )

            if not middle_messages:
-                if self.valves.debug_mode:
-                    print(f"[🤖 异步摘要任务] 截断后中间消息为空，跳过摘要生成")
+                await self._log(
+                    f"[🤖 异步摘要任务] 截断后中间消息为空，跳过摘要生成",
+                    event_call=__event_call__,
+                )
                return

            # 4. 构建对话文本
@@ -798,12 +963,26 @@ class Filter:
                )

            new_summary = await self._call_summary_llm(
-                None, conversation_text, body, user_data
+                None,
+                conversation_text,
+                {**body, "model": summary_model_id},
+                user_data,
+                __event_call__,
            )

+            if not new_summary:
+                await self._log(
+                    "[🤖 异步摘要任务] ⚠️ 摘要生成返回空结果，跳过保存",
+                    type="warning",
+                    event_call=__event_call__,
+                )
+                return
+
            # 6. 保存新摘要
-            if self.valves.debug_mode:
-                print("[优化] 正在后台线程中保存摘要，以避免阻塞事件循环。")
+            await self._log(
+                "[优化] 在后台线程中保存摘要以避免阻塞事件循环。",
+                event_call=__event_call__,
+            )

            await asyncio.to_thread(
                self._save_summary, chat_id, new_summary, target_compressed_count
@@ -815,32 +994,52 @@ class Filter:
                    {
                        "type": "status",
                        "data": {
-                            "description": f"上下文摘要已更新 (已压缩 {len(middle_messages)} 条消息)",
+                            "description": f"上下文摘要已更新 (压缩了 {len(middle_messages)} 条消息)",
                            "done": True,
                        },
                    }
                )

-            if self.valves.debug_mode:
-                print(f"[🤖 异步摘要任务] ✅ 完成！新摘要长度: {len(new_summary)} 字符")
-                print(
-                    f"[🤖 异步摘要任务] 进度更新: 已压缩至原始第 {target_compressed_count} 条消息"
-                )
+            await self._log(
+                f"[🤖 异步摘要任务] ✅ 完成！新摘要长度: {len(new_summary)} 字符",
+                type="success",
+                event_call=__event_call__,
+            )
+            await self._log(
+                f"[🤖 异步摘要任务] 进度更新: 已压缩至原始消息 {target_compressed_count}",
+                event_call=__event_call__,
+            )

        except Exception as e:
-            print(f"[🤖 异步摘要任务] ❌ 错误: {str(e)}")
+            await self._log(
+                f"[🤖 异步摘要任务] ❌ 错误: {str(e)}",
+                type="error",
+                event_call=__event_call__,
+            )
+
+            if __event_emitter__:
+                await __event_emitter__(
+                    {
+                        "type": "status",
+                        "data": {
+                            "description": f"摘要生成错误: {str(e)[:100]}...",
+                            "done": True,
+                        },
+                    }
+                )
+
            import traceback

            traceback.print_exc()

    def _format_messages_for_summary(self, messages: list) -> str:
-        """格式化消息用于摘要"""
+        """Formats messages for summarization."""
        formatted = []
        for i, msg in enumerate(messages, 1):
            role = msg.get("role", "unknown")
            content = msg.get("content", "")

-            # 处理多模态内容
+            # Handle multimodal content
            if isinstance(content, list):
                text_parts = []
                for part in content:
@@ -848,10 +1047,10 @@ class Filter:
                        text_parts.append(part.get("text", ""))
                content = " ".join(text_parts)

-            # 处理角色名称
-            role_name = {"user": "用户", "assistant": "助手"}.get(role, role)
+            # Handle role name
+            role_name = {"user": "User", "assistant": "Assistant"}.get(role, role)

-            # 限制每条消息的长度，避免过长
+            # Limit length of each message to avoid excessive length
            if len(content) > 500:
                content = content[:500] + "..."

@@ -865,12 +1064,15 @@ class Filter:
        new_conversation_text: str,
        body: dict,
        user_data: dict,
+        __event_call__: Callable[[Any], Awaitable[None]] = None,
    ) -> str:
        """
-        使用 Open WebUI 内置方法调用 LLM 生成摘要
+        调用 LLM 生成摘要，使用 Open Web UI 的内置方法。
        """
-        if self.valves.debug_mode:
-            print(f"[🤖 LLM 调用] 使用 Open WebUI 内置方法")
+        await self._log(
+            f"[🤖 LLM 调用] 使用 Open Web UI 内置方法",
+            event_call=__event_call__,
+        )

        # 构建摘要提示词 (优化版)
        summary_prompt = f"""
@@ -907,10 +1109,19 @@ class Filter:
 请根据上述内容，生成摘要：
 """
        # 确定使用的模型
-        model = self.valves.summary_model or body.get("model", "")
+        model = self._clean_model_id(self.valves.summary_model) or self._clean_model_id(
+            body.get("model")
+        )

-        if self.valves.debug_mode:
-            print(f"[🤖 LLM 调用] 模型: {model}")
+        if not model:
+            await self._log(
+                "[🤖 LLM 调用] ⚠️ 摘要模型不存在，跳过摘要生成",
+                type="warning",
+                event_call=__event_call__,
+            )
+            return ""
+
+        await self._log(f"[🤖 LLM 调用] 模型: {model}", event_call=__event_call__)

        # 构建 payload
        payload = {
@@ -927,17 +1138,20 @@ class Filter:
            if not user_id:
                raise ValueError("无法获取用户 ID")

-            # [优化] 在后台线程中获取用户对象，以避免阻塞事件循环
-            if self.valves.debug_mode:
-                print("[优化] 正在后台线程中获取用户对象，以避免阻塞事件循环。")
+            # [优化] 在后台线程中获取用户对象以避免阻塞事件循环
+            await self._log(
+                "[优化] 在后台线程中获取用户对象以避免阻塞事件循环。",
+                event_call=__event_call__,
+            )
            user = await asyncio.to_thread(Users.get_user_by_id, user_id)

            if not user:
                raise ValueError(f"无法找到用户: {user_id}")

-            if self.valves.debug_mode:
-                print(f"[🤖 LLM 调用] 用户: {user.email}")
-                print(f"[🤖 LLM 调用] 发送请求...")
+            await self._log(
+                f"[🤖 LLM 调用] 用户: {user.email}\n[🤖 LLM 调用] 发送请求...",
+                event_call=__event_call__,
+            )

            # 创建 Request 对象
            request = Request(scope={"type": "http", "app": webui_app})
@@ -950,20 +1164,31 @@ class Filter:

            summary = response["choices"][0]["message"]["content"].strip()

-            if self.valves.debug_mode:
-                print(f"[🤖 LLM 调用] ✅ 成功获取摘要")
+            await self._log(
+                f"[🤖 LLM 调用] ✅ 成功接收摘要",
+                type="success",
+                event_call=__event_call__,
+            )

            return summary

        except Exception as e:
-            error_message = f"调用 LLM ({model}) 生成摘要时发生错误: {str(e)}"
+            error_msg = str(e)
+            # Handle specific error messages
+            if "Model not found" in error_msg:
+                error_message = f"摘要模型 '{model}' 不存在。"
+            else:
+                error_message = f"摘要 LLM 错误 ({model}): {error_msg}"
            if not self.valves.summary_model:
                error_message += (
-                    "\n[提示] 您没有指定摘要模型 (summary_model)，因此尝试使用当前对话的模型。"
-                    "如果这是一个流水线（Pipe）模型或不兼容的模型，请在配置中指定一个兼容的摘要模型（如 'gemini-2.5-flash'）。"
+                    "\n[提示] 您未指定 summary_model，因此过滤器尝试使用当前对话的模型。"
+                    "如果这是流水线 (Pipe) 模型或不兼容的模型，请在配置中指定兼容的摘要模型 (例如 'gemini-2.5-flash')。"
                )

-            if self.valves.debug_mode:
-                print(f"[🤖 LLM 调用] ❌ {error_message}")
+            await self._log(
+                f"[🤖 LLM 调用] ❌ {error_message}",
+                type="error",
+                event_call=__event_call__,
+            )

            raise Exception(error_message)
--- a/plugins/filters/context_enhancement_filter/context_enhancement_filter.py
+++ b/plugins/filters/context_enhancement_filter/context_enhancement_filter.py
@@ -1,12 +1,9 @@
 """
 title: Context & Model Enhancement Filter
-author: Fu-Jie
-author_url: https://github.com/Fu-Jie
-funding_url: https://github.com/Fu-Jie/awesome-openwebui
-version: 0.2
+version: 0.3

 description:
-    一个功能全面的 Filter 插件，用于增强请求上下文和优化模型功能。提供四大核心功能：
+    一个专注于增强请求上下文和优化模型功能的 Filter 插件。提供三大核心功能：

    1. 环境变量注入：在每条用户消息前自动注入用户环境变量（用户名、时间、时区、语言等）
       - 支持纯文本、图片、多模态消息
@@ -24,222 +21,24 @@ description:
       - 动态模型重定向
       - 智能化的模型识别和适配

-    4. 智能内容规范化：生产级的内容清洗与修复系统
-       - 智能修复损坏的代码块（前缀、后缀、缩进）
-       - 规范化 LaTeX 公式格式（行内/块级）
-       - 优化思维链标签（</thought>）格式
-       - 自动闭合未结束的代码块
-       - 智能列表格式修复
-       - 清理冗余的 XML 标签
-       - 可配置的规则系统
-
 features:
    - 自动化环境变量管理
    - 智能模型功能适配
    - 异步状态反馈
    - 幂等性保证
    - 多模型支持
-    - 智能内容清洗与规范化
 """

 from pydantic import BaseModel, Field
-from typing import Optional, List, Callable
+from typing import Optional
 import re
 import logging
-from dataclasses import dataclass, field
+import asyncio


 # 配置日志
 logger = logging.getLogger(__name__)

-@dataclass
-class NormalizerConfig:
-    """规范化配置类,用于动态启用/禁用特定规则"""
-    enable_escape_fix: bool = True          # 修复转义字符
-    enable_thought_tag_fix: bool = True     # 修复思考链标签
-    enable_code_block_fix: bool = True      # 修复代码块格式
-    enable_latex_fix: bool = True           # 修复 LaTeX 公式格式
-    enable_list_fix: bool = False            # 修复列表换行
-    enable_unclosed_block_fix: bool = True  # 修复未闭合代码块
-    enable_fullwidth_symbol_fix: bool = False # 修复代码内的全角符号
-    enable_xml_tag_cleanup: bool = True     # 清理 XML 残留标签
-    
-    # 自定义清理函数列表（高级扩展用）
-    custom_cleaners: List[Callable[[str], str]] = field(default_factory=list)
-
-class ContentNormalizer:
-    """LLM 输出内容规范化器 - 生产级实现"""
-    
-    # --- 1. 预编译正则表达式（性能优化） ---
-    _PATTERNS = {
-        # 代码块前缀：如果 ``` 前面不是行首也不是换行符
-        'code_block_prefix': re.compile(r'(?<!^)(?<!\n)(```)', re.MULTILINE),
-        
-        # 代码块后缀：匹配 ```语言名 后面紧跟非空白字符(没有换行)
-        # 匹配 ```python code 这种情况，但不匹配 ```python 或 ```python\n
-        'code_block_suffix': re.compile(r'(```[\w\+\-\.]*)[ \t]+([^\n\r])'),
-        
-        # 代码块缩进：行首的空白字符 + ```
-        'code_block_indent': re.compile(r'^[ \t]+(```)', re.MULTILINE),
-        
-        # 思考链标签：</thought> 后可能跟空格或换行
-        'thought_tag': re.compile(r'</thought>[ \t]*\n*'),
-        
-        # LaTeX 块级公式：\[ ... \]
-        'latex_bracket_block': re.compile(r'\\\[(.+?)\\\]', re.DOTALL),
-        # LaTeX 行内公式：\( ... \)
-        'latex_paren_inline': re.compile(r'\\\((.+?)\\\)'),
-        
-        # 列表项：非换行符 + 数字 + 点 + 空格 (e.g. "Text1. Item")
-        'list_item': re.compile(r'([^\n])(\d+\. )'),
-        
-        # XML 残留标签 (如 Claude 的 artifacts)
-        'xml_artifacts': re.compile(r'</?(?:antArtifact|antThinking|artifact)[^>]*>', re.IGNORECASE),
-    }
-    
-    def __init__(self, config: Optional[NormalizerConfig] = None):
-        self.config = config or NormalizerConfig()
-        self.applied_fixes = []
-    
-    def normalize(self, content: str) -> str:
-        """主入口：按顺序应用所有规范化规则"""
-        self.applied_fixes = []
-        if not content:
-            return content
-        
-        try:
-            # 1. 转义字符修复（必须最先执行，否则影响后续正则）
-            if self.config.enable_escape_fix:
-                original = content
-                content = self._fix_escape_characters(content)
-                if content != original:
-                    self.applied_fixes.append("修复转义字符")
-            
-            # 2. 思考链标签规范化
-            if self.config.enable_thought_tag_fix:
-                original = content
-                content = self._fix_thought_tags(content)
-                if content != original:
-                    self.applied_fixes.append("规范化思考链")
-            
-            # 3. 代码块格式修复
-            if self.config.enable_code_block_fix:
-                original = content
-                content = self._fix_code_blocks(content)
-                if content != original:
-                    self.applied_fixes.append("修复代码块格式")
-            
-            # 4. LaTeX 公式规范化
-            if self.config.enable_latex_fix:
-                original = content
-                content = self._fix_latex_formulas(content)
-                if content != original:
-                    self.applied_fixes.append("规范化 LaTeX 公式")
-            
-            # 5. 列表格式修复
-            if self.config.enable_list_fix:
-                original = content
-                content = self._fix_list_formatting(content)
-                if content != original:
-                    self.applied_fixes.append("修复列表格式")
-            
-            # 6. 未闭合代码块检测与修复
-            if self.config.enable_unclosed_block_fix:
-                original = content
-                content = self._fix_unclosed_code_blocks(content)
-                if content != original:
-                    self.applied_fixes.append("闭合未结束代码块")
-            
-            # 7. 全角符号转半角（仅代码块内）
-            if self.config.enable_fullwidth_symbol_fix:
-                original = content
-                content = self._fix_fullwidth_symbols_in_code(content)
-                if content != original:
-                    self.applied_fixes.append("全角符号转半角")
-            
-            # 8. XML 标签残留清理
-            if self.config.enable_xml_tag_cleanup:
-                original = content
-                content = self._cleanup_xml_tags(content)
-                if content != original:
-                    self.applied_fixes.append("清理 XML 标签")
-            
-            # 9. 执行自定义清理函数
-            for cleaner in self.config.custom_cleaners:
-                original = content
-                content = cleaner(content)
-                if content != original:
-                    self.applied_fixes.append("执行自定义清理")
-            
-            return content
-            
-        except Exception as e:
-            # 生产环境保底机制：如果清洗过程报错，返回原始内容，避免阻断服务
-            logger.error(f"内容规范化失败: {e}", exc_info=True)
-            return content
-    
-    def _fix_escape_characters(self, content: str) -> str:
-        """修复过度转义的字符"""
-        # 注意：先处理具体的转义序列，再处理通用的双反斜杠
-        content = content.replace("\\r\\n", "\n")
-        content = content.replace("\\n", "\n")
-        content = content.replace("\\t", "\t")
-        # 修复过度转义的反斜杠 (例如路径 C:\\Users)
-        content = content.replace("\\\\", "\\")
-        return content
-    
-    def _fix_thought_tags(self, content: str) -> str:
-        """规范化 </thought> 标签，统一为空两行"""
-        return self._PATTERNS['thought_tag'].sub("</thought>\n\n", content)
-    
-    def _fix_code_blocks(self, content: str) -> str:
-        """修复代码块格式（独占行、换行、去缩进）"""
-        # C: 移除代码块前的缩进（必须先执行，否则影响下面的判断）
-        content = self._PATTERNS['code_block_indent'].sub(r"\1", content)
-        # A: 确保 ``` 前有换行
-        content = self._PATTERNS['code_block_prefix'].sub(r"\n\1", content)
-        # B: 确保 ```语言标识 后有换行
-        content = self._PATTERNS['code_block_suffix'].sub(r"\1\n\2", content)
-        return content
-    
-    def _fix_latex_formulas(self, content: str) -> str:
-        """规范化 LaTeX 公式：\[ -> $$ (块级), \( -> $ (行内)"""
-        content = self._PATTERNS['latex_bracket_block'].sub(r"$$\1$$", content)
-        content = self._PATTERNS['latex_paren_inline'].sub(r"$\1$", content)
-        return content
-    
-    def _fix_list_formatting(self, content: str) -> str:
-        """修复列表项缺少换行的问题 (如 'text1. item' -> 'text\\n1. item')"""
-        return self._PATTERNS['list_item'].sub(r"\1\n\2", content)
-    
-    def _fix_unclosed_code_blocks(self, content: str) -> str:
-        """检测并修复未闭合的代码块"""
-        if content.count("```") % 2 != 0:
-            logger.warning("检测到未闭合的代码块，自动补全")
-            content += "\n```"
-        return content
-    
-    def _fix_fullwidth_symbols_in_code(self, content: str) -> str:
-        """在代码块内将全角符号转为半角（精细化操作）"""
-        # 常见误用的全角符号映射
-        FULLWIDTH_MAP = {
-            '，': ',', '。': '.', '（': '(', '）': ')',
-            '【': '[', '】': ']', '；': ';', '：': ':',
-            '？': '?', '！': '!', '"': '"', '"': '"',
-            ''': "'", ''': "'",
-        }
-        
-        parts = content.split("```")
-        # 代码块内容位于索引 1, 3, 5... (奇数位)
-        for i in range(1, len(parts), 2):
-            for full, half in FULLWIDTH_MAP.items():
-                parts[i] = parts[i].replace(full, half)
-        
-        return "```".join(parts)
-    
-    def _cleanup_xml_tags(self, content: str) -> str:
-        """移除无关的 XML 标签"""
-        return self._PATTERNS['xml_artifacts'].sub("", content)

 class Filter:
    class Valves(BaseModel):
@@ -349,13 +148,9 @@ class Filter:
                body["model"] = body["model"] + "-search"
                features["web_search"] = False
                search_enabled_for_model = True
-            if user_email == "yi204o@qq.com":
-                features["web_search"] = False

        # 如果启用了模型本身的搜索能力，发送状态提示
        if search_enabled_for_model and __event_emitter__:
-            import asyncio
-
            try:
                asyncio.create_task(
                    self._emit_search_status(__event_emitter__, model_name)
@@ -464,8 +259,6 @@ class Filter:

            # 环境变量注入成功后，发送状态提示给用户
            if env_injected and __event_emitter__:
-                import asyncio
-
                try:
                    # 如果在异步环境中，使用 await
                    asyncio.create_task(self._emit_env_status(__event_emitter__))
@@ -506,67 +299,3 @@ class Filter:
            )
        except Exception as e:
            print(f"发送搜索状态提示时出错: {e}")
-
-    async def _emit_normalization_status(self, __event_emitter__, applied_fixes: List[str] = None):
-        """
-        发送内容规范化完成的状态提示
-        """
-        description = "✓ 内容已自动规范化"
-        if applied_fixes:
-            description += f"：{', '.join(applied_fixes)}"
-
-        try:
-            await __event_emitter__(
-                {
-                    "type": "status",
-                    "data": {
-                        "description": description,
-                        "done": True,
-                    },
-                }
-            )
-        except Exception as e:
-            print(f"发送规范化状态提示时出错: {e}")
-
-    def _contains_html(self, content: str) -> bool:
-        """
-        检测内容是否包含 HTML 标签
-        """
-        # 匹配常见的 HTML 标签
-        pattern = r"<\s*/?\s*(?:html|head|body|div|span|p|br|hr|ul|ol|li|table|thead|tbody|tfoot|tr|td|th|img|a|b|i|strong|em|code|pre|blockquote|h[1-6]|script|style|form|input|button|label|select|option|iframe|link|meta|title)\b"
-        return bool(re.search(pattern, content, re.IGNORECASE))
-
-    def outlet(self, body: dict, __user__: Optional[dict] = None, __event_emitter__=None) -> dict:
-        """
-        处理传出响应体，通过修改最后一条助手消息的内容。
-        使用 ContentNormalizer 进行全面的内容规范化。
-        """
-        if "messages" in body and body["messages"]:
-            last = body["messages"][-1]
-            content = last.get("content", "") or ""
-            
-            if last.get("role") == "assistant" and isinstance(content, str):
-                # 如果包含 HTML，跳过规范化，为了防止错误格式化
-                if self._contains_html(content):
-                    return body
-
-                # 初始化规范化器
-                normalizer = ContentNormalizer()
-                
-                # 执行规范化
-                new_content = normalizer.normalize(content)
-                
-                # 更新内容
-                if new_content != content:
-                    last["content"] = new_content
-                    # 如果内容发生了改变，发送状态提示
-                    if __event_emitter__:
-                        import asyncio
-                        try:
-                            # 传入 applied_fixes
-                            asyncio.create_task(self._emit_normalization_status(__event_emitter__, normalizer.applied_fixes))
-                        except RuntimeError:
-                            # 假如不在循环中，则忽略
-                            pass
-        
-        return body
--- a/plugins/filters/markdown_normalizer/FEATURES_CN.md
+++ b/plugins/filters/markdown_normalizer/FEATURES_CN.md
@@ -0,0 +1,162 @@
+# Markdown Normalizer 功能详解
+
+本插件旨在修复 LLM 输出中常见的 Markdown 格式问题，确保在 Open WebUI 中完美渲染。以下是支持的修复功能列表及示例。
+
+## 1. 代码块修复 (Code Block Fixes)
+
+### 1.1 去除代码块缩进
+LLM 有时会在代码块前添加空格缩进，导致渲染失效。本插件会自动移除这些缩进。
+
+**Before:**
+   ```python
+   print("hello")
+   ```
+
+**After:**
+```python
+print("hello")
+```
+
+### 1.2 补全代码块前后换行
+代码块标记 ` ``` ` 必须独占一行。如果 LLM 将其与文本混在一行，插件会自动修复。
+
+**Before:**
+Here is code:```python
+print("hello")```
+
+**After:**
+Here is code:
+```python
+print("hello")
+```
+
+### 1.3 修复语言标识符后的换行
+有时 LLM 会忘记在语言标识符（如 `python`）后换行。
+
+**Before:**
+```python print("hello")
+```
+
+**After:**
+```python
+print("hello")
+```
+
+### 1.4 自动闭合代码块
+如果输出被截断或 LLM 忘记闭合代码块，插件会自动添加结尾的 ` ``` `。
+
+**Before:**
+```python
+print("unfinished code...")
+
+**After:**
+```python
+print("unfinished code...")
+```
+
+## 2. LaTeX 公式规范化 (LaTeX Normalization)
+
+Open WebUI 使用 MathJax/KaTeX 渲染公式，通常需要 `$$` 或 `$` 包裹。本插件会将常见的 LaTeX 括号语法转换为标准格式。
+
+**Before:**
+块级公式：\[ E = mc^2 \]
+行内公式：\( a^2 + b^2 = c^2 \)
+
+**After:**
+块级公式：$$ E = mc^2 $$
+行内公式：$ a^2 + b^2 = c^2 $
+
+## 3. 转义字符清理 (Escape Character Fix)
+
+修复过度转义的字符，这常见于某些 API 返回的原始字符串中。
+
+**Before:**
+Line 1\\nLine 2\\tTabbed
+
+**After:**
+Line 1
+Line 2	Tabbed
+
+## 4. 思维链标签规范化 (Thought Tag Fix)
+**功能**: 
+1.  确保 `</thought>` 标签后有足够的空行，防止思维链内容与正文粘连。
+2.  **标准化标签**: 将 `<think>` (DeepSeek 等模型常用) 或 `<thinking>` 统一转换为 Open WebUI 标准的 `<thought>` 标签，以便正确触发 UI 的折叠功能。
+
+**默认**: 开启 (`enable_thought_tag_fix = True`)
+
+**示例**:
+*   **Before**: `<think>Thinking...</think>Response starts here.`
+*   **After**: 
+    ```xml
+    <thought>Thinking...</thought>
+
+    Response starts here.
+    ```
+
+## 5. 列表格式修复 (List Formatting Fix)
+
+*默认关闭，需在设置中开启*
+
+修复列表项缺少换行的问题。
+
+**Before:**
+Header1. Item 1
+
+**After:**
+Header
+1. Item 1
+
+## 6. 全角符号转半角 (Full-width Symbol Fix)
+
+*默认关闭，需在设置中开启*
+
+仅在**代码块内部**将全角符号转换为半角符号，防止代码因符号问题无法运行。
+
+**Before:**
+```python
+if x == 1：
+    print（"hello"）
+```
+
+**After:**
+```python
+if x == 1:
+    print("hello")
+```
+
+## 7. Mermaid 语法修复 (Mermaid Syntax Fix)
+**功能**: 修复 Mermaid 图表中常见的语法错误，特别是未加引号的标签包含特殊字符的情况。
+**默认**: 开启 (`enable_mermaid_fix = True`)
+**示例**:
+*   **Before**:
+    ```mermaid
+    graph TD
+    A[Label with (parens)] --> B(Label with [brackets])
+    ```
+*   **After**:
+    ```mermaid
+    graph TD
+    A["Label with (parens)"] --> B("Label with [brackets]")
+    ```
+
+## 8. XML 标签清理 (XML Cleanup)
+
+移除 LLM 输出中残留的无用 XML 标签（如 Claude 的 artifact 标签）。
+
+**Before:**
+Here is the result <antArtifact>hidden metadata</antArtifact>.
+
+**After:**
+## 9. 标题格式修复 (Heading Format Fix)
+**功能**: 修复标题标记 `#` 后缺少空格的问题。
+**默认**: 开启 (`enable_heading_fix = True`)
+**示例**:
+*   **Before**: `#Heading 1`
+*   **After**: `# Heading 1`
+
+## 10. 表格格式修复 (Table Format Fix)
+**功能**: 修复表格行末尾缺少管道符 `|` 的问题。
+**默认**: 开启 (`enable_table_fix = True`)
+**示例**:
+*   **Before**: `| Col 1 | Col 2`
+*   **After**: `| Col 1 | Col 2 |`
--- a/plugins/filters/markdown_normalizer/README.md
+++ b/plugins/filters/markdown_normalizer/README.md
@@ -0,0 +1,44 @@
+# Markdown Normalizer Filter
+
+A production-grade content normalizer filter for Open WebUI that fixes common Markdown formatting issues in LLM outputs. It ensures that code blocks, LaTeX formulas, Mermaid diagrams, and other Markdown elements are rendered correctly.
+
+## Features
+
+*   **Mermaid Syntax Fix**: Automatically fixes common Mermaid syntax errors, such as unquoted node labels and unclosed subgraphs, ensuring diagrams render correctly.
+*   **Frontend Console Debugging**: Supports printing structured debug logs directly to the browser console (F12) for easier troubleshooting.
+*   **Code Block Formatting**: Fixes broken code block prefixes, suffixes, and indentation.
+*   **LaTeX Normalization**: Standardizes LaTeX formula delimiters (`\[` -> `$$`, `\(` -> `$`).
+*   **Thought Tag Normalization**: Unifies thought tags (`<think>`, `<thinking>` -> `<thought>`).
+*   **Escape Character Fix**: Cleans up excessive escape characters (`\\n`, `\\t`).
+*   **List Formatting**: Ensures proper newlines in list items.
+*   **Heading Fix**: Adds missing spaces in headings (`#Heading` -> `# Heading`).
+*   **Table Fix**: Adds missing closing pipes in tables.
+*   **XML Cleanup**: Removes leftover XML artifacts.
+
+## Usage
+
+1.  Install the plugin in Open WebUI.
+2.  Enable the filter globally or for specific models.
+3.  Configure the enabled fixes in the **Valves** settings.
+4.  (Optional) Enable **Show Debug Log** in Valves to view detailed logs in the browser console.
+
+## Configuration (Valves)
+
+*   `priority`: Filter priority (default: 50).
+*   `enable_escape_fix`: Fix excessive escape characters.
+*   `enable_thought_tag_fix`: Normalize thought tags.
+*   `enable_code_block_fix`: Fix code block formatting.
+*   `enable_latex_fix`: Normalize LaTeX formulas.
+*   `enable_list_fix`: Fix list item newlines (Experimental).
+*   `enable_unclosed_block_fix`: Auto-close unclosed code blocks.
+*   `enable_fullwidth_symbol_fix`: Fix full-width symbols in code blocks.
+*   `enable_mermaid_fix`: Fix Mermaid syntax errors.
+*   `enable_heading_fix`: Fix missing space in headings.
+*   `enable_table_fix`: Fix missing closing pipe in tables.
+*   `enable_xml_tag_cleanup`: Cleanup leftover XML tags.
+*   `show_status`: Show status notification when fixes are applied.
+*   `show_debug_log`: Print debug logs to browser console.
+
+## License
+
+MIT
--- a/plugins/filters/markdown_normalizer/README_CN.md
+++ b/plugins/filters/markdown_normalizer/README_CN.md
@@ -0,0 +1,44 @@
+# Markdown 格式化过滤器 (Markdown Normalizer)
+
+这是一个用于 Open WebUI 的生产级内容格式化过滤器，旨在修复 LLM 输出中常见的 Markdown 格式问题。它能确保代码块、LaTeX 公式、Mermaid 图表和其他 Markdown 元素被正确渲染。
+
+## 功能特性
+
+*   **Mermaid 语法修复**: 自动修复常见的 Mermaid 语法错误，如未加引号的节点标签和未闭合的子图 (Subgraph)，确保图表能正确渲染。
+*   **前端控制台调试**: 支持将结构化的调试日志直接打印到浏览器控制台 (F12)，方便排查问题。
+*   **代码块格式化**: 修复破损的代码块前缀、后缀和缩进问题。
+*   **LaTeX 规范化**: 标准化 LaTeX 公式定界符 (`\[` -> `$$`, `\(` -> `$`)。
+*   **思维标签规范化**: 统一思维链标签 (`<think>`, `<thinking>` -> `<thought>`)。
+*   **转义字符修复**: 清理过度的转义字符 (`\\n`, `\\t`)。
+*   **列表格式化**: 确保列表项有正确的换行。
+*   **标题修复**: 修复标题中缺失的空格 (`#标题` -> `# 标题`)。
+*   **表格修复**: 修复表格中缺失的闭合管道符。
+*   **XML 清理**: 移除残留的 XML 标签。
+
+## 使用方法
+
+1.  在 Open WebUI 中安装此插件。
+2.  全局启用或为特定模型启用此过滤器。
+3.  在 **Valves** 设置中配置需要启用的修复项。
+4.  (可选) 在 Valves 中开启 **显示调试日志 (Show Debug Log)** 以在浏览器控制台中查看详细日志。
+
+## 配置项 (Valves)
+
+*   `priority`: 过滤器优先级 (默认: 50)。
+*   `enable_escape_fix`: 修复过度的转义字符。
+*   `enable_thought_tag_fix`: 规范化思维标签。
+*   `enable_code_block_fix`: 修复代码块格式。
+*   `enable_latex_fix`: 规范化 LaTeX 公式。
+*   `enable_list_fix`: 修复列表项换行 (实验性)。
+*   `enable_unclosed_block_fix`: 自动闭合未闭合的代码块。
+*   `enable_fullwidth_symbol_fix`: 修复代码块中的全角符号。
+*   `enable_mermaid_fix`: 修复 Mermaid 语法错误。
+*   `enable_heading_fix`: 修复标题中缺失的空格。
+*   `enable_table_fix`: 修复表格中缺失的闭合管道符。
+*   `enable_xml_tag_cleanup`: 清理残留的 XML 标签。
+*   `show_status`: 应用修复时显示状态通知。
+*   `show_debug_log`: 在浏览器控制台打印调试日志。
+
+## 许可证
+
+MIT
--- a/plugins/filters/markdown_normalizer/markdown_normalizer.py
+++ b/plugins/filters/markdown_normalizer/markdown_normalizer.py
@@ -0,0 +1,524 @@
+"""
+title: Markdown Normalizer
+author: Fu-Jie
+author_url: https://github.com/Fu-Jie
+funding_url: https://github.com/Fu-Jie/awesome-openwebui
+version: 1.0.0
+description: A production-grade content normalizer filter that fixes common Markdown formatting issues in LLM outputs, such as broken code blocks, LaTeX formulas, and list formatting.
+"""
+
+from pydantic import BaseModel, Field
+from typing import Optional, List, Callable
+import re
+import logging
+import logging
+import asyncio
+import json
+from dataclasses import dataclass, field
+
+# Configure logging
+logger = logging.getLogger(__name__)
+
+
+@dataclass
+class NormalizerConfig:
+    """Configuration class for enabling/disabling specific normalization rules"""
+
+    enable_escape_fix: bool = True  # Fix excessive escape characters
+    enable_thought_tag_fix: bool = True  # Normalize thought tags
+    enable_code_block_fix: bool = True  # Fix code block formatting
+    enable_latex_fix: bool = True  # Fix LaTeX formula formatting
+    enable_list_fix: bool = (
+        False  # Fix list item newlines (default off as it can be aggressive)
+    )
+    enable_unclosed_block_fix: bool = True  # Auto-close unclosed code blocks
+    enable_fullwidth_symbol_fix: bool = False  # Fix full-width symbols in code blocks
+    enable_mermaid_fix: bool = True  # Fix common Mermaid syntax errors
+    enable_heading_fix: bool = (
+        True  # Fix missing space in headings (#Header -> # Header)
+    )
+    enable_table_fix: bool = True  # Fix missing closing pipe in tables
+    enable_xml_tag_cleanup: bool = True  # Cleanup leftover XML tags
+
+    # Custom cleaner functions (for advanced extension)
+    custom_cleaners: List[Callable[[str], str]] = field(default_factory=list)
+
+
+class ContentNormalizer:
+    """LLM Output Content Normalizer - Production Grade Implementation"""
+
+    # --- 1. Pre-compiled Regex Patterns (Performance Optimization) ---
+    _PATTERNS = {
+        # Code block prefix: if ``` is not at start of line or file
+        "code_block_prefix": re.compile(r"(?<!^)(?<!\n)(```)", re.MULTILINE),
+        # Code block suffix: ```lang followed by non-whitespace (no newline)
+        "code_block_suffix": re.compile(r"(```[\w\+\-\.]*)[ \t]+([^\n\r])"),
+        # Code block indent: whitespace at start of line + ```
+        "code_block_indent": re.compile(r"^[ \t]+(```)", re.MULTILINE),
+        # Thought tag: </thought> followed by optional whitespace/newlines
+        "thought_end": re.compile(
+            r"</(thought|think|thinking)>[ \t]*\n*", re.IGNORECASE
+        ),
+        "thought_start": re.compile(r"<(thought|think|thinking)>", re.IGNORECASE),
+        # LaTeX block: \[ ... \]
+        "latex_bracket_block": re.compile(r"\\\[(.+?)\\\]", re.DOTALL),
+        # LaTeX inline: \( ... \)
+        "latex_paren_inline": re.compile(r"\\\((.+?)\\\)"),
+        # List item: non-newline + digit + dot + space
+        "list_item": re.compile(r"([^\n])(\d+\. )"),
+        # XML artifacts (e.g. Claude's)
+        "xml_artifacts": re.compile(
+            r"</?(?:antArtifact|antThinking|artifact)[^>]*>", re.IGNORECASE
+        ),
+        # Mermaid: Match various node shapes and quote unquoted labels
+        # Fix "reverse optimization": Must precisely match shape delimiters to avoid breaking structure
+        # Priority: Longer delimiters match first
+        "mermaid_node": re.compile(
+            r'("[^"\\]*(?:\\.[^"\\]*)*")|'  # Match quoted strings first (Group 1)
+            r"(\w+)\s*(?:"
+            r"(\(\(\()(?![\"])(.*?)(?<![\"])(\)\)\))|"  # (((...))) Double Circle
+            r"(\(\()(?![\"])(.*?)(?<![\"])(\)\))|"  # ((...)) Circle
+            r"(\(\[)(?![\"])(.*?)(?<![\"])(\]\))|"  # ([...]) Stadium
+            r"(\[\()(?![\"])(.*?)(?<![\"])(\)\])|"  # [(...)] Cylinder
+            r"(\[\[)(?![\"])(.*?)(?<![\"])(\]\])|"  # [[...]] Subroutine
+            r"(\{\{)(?![\"])(.*?)(?<![\"])(\}\})|"  # {{...}} Hexagon
+            r"(\[/)(?![\"])(.*?)(?<![\"])(/\])|"  # [/.../] Parallelogram
+            r"(\[\\)(?![\"])(.*?)(?<![\"])(\\\])|"  # [\...\] Parallelogram Alt
+            r"(\[/)(?![\"])(.*?)(?<![\"])(\\\])|"  # [/...\] Trapezoid
+            r"(\[\\)(?![\"])(.*?)(?<![\"])(/\])|"  # [\.../] Trapezoid Alt
+            r"(\()(?![\"])(.*?)(?<![\"])(\))|"  # (...) Round
+            r"(\[)(?![\"])(.*?)(?<![\"])(\])|"  # [...] Square
+            r"(\{)(?![\"])(.*?)(?<![\"])(\})|"  # {...} Rhombus
+            r"(>)(?![\"])(.*?)(?<![\"])(\])"  # >...] Asymmetric
+            r")"
+        ),
+        # Heading: #Heading -> # Heading
+        "heading_space": re.compile(r"^(#+)([^ \n#])", re.MULTILINE),
+        # Table: | col1 | col2 -> | col1 | col2 |
+        "table_pipe": re.compile(r"^(\|.*[^|\n])$", re.MULTILINE),
+    }
+
+    def __init__(self, config: Optional[NormalizerConfig] = None):
+        self.config = config or NormalizerConfig()
+        self.applied_fixes = []
+
+    def normalize(self, content: str) -> str:
+        """Main entry point: apply all normalization rules in order"""
+        self.applied_fixes = []
+        if not content:
+            return content
+
+        original_content = content  # Keep a copy for logging
+
+        try:
+            # 1. Escape character fix (Must be first)
+            if self.config.enable_escape_fix:
+                original = content
+                content = self._fix_escape_characters(content)
+                if content != original:
+                    self.applied_fixes.append("Fix Escape Chars")
+
+            # 2. Thought tag normalization
+            if self.config.enable_thought_tag_fix:
+                original = content
+                content = self._fix_thought_tags(content)
+                if content != original:
+                    self.applied_fixes.append("Normalize Thought Tags")
+
+            # 3. Code block formatting fix
+            if self.config.enable_code_block_fix:
+                original = content
+                content = self._fix_code_blocks(content)
+                if content != original:
+                    self.applied_fixes.append("Fix Code Blocks")
+
+            # 4. LaTeX formula normalization
+            if self.config.enable_latex_fix:
+                original = content
+                content = self._fix_latex_formulas(content)
+                if content != original:
+                    self.applied_fixes.append("Normalize LaTeX")
+
+            # 5. List formatting fix
+            if self.config.enable_list_fix:
+                original = content
+                content = self._fix_list_formatting(content)
+                if content != original:
+                    self.applied_fixes.append("Fix List Format")
+
+            # 6. Unclosed code block fix
+            if self.config.enable_unclosed_block_fix:
+                original = content
+                content = self._fix_unclosed_code_blocks(content)
+                if content != original:
+                    self.applied_fixes.append("Close Code Blocks")
+
+            # 7. Full-width symbol fix (in code blocks only)
+            if self.config.enable_fullwidth_symbol_fix:
+                original = content
+                content = self._fix_fullwidth_symbols_in_code(content)
+                if content != original:
+                    self.applied_fixes.append("Fix Full-width Symbols")
+
+            # 8. Mermaid syntax fix
+            if self.config.enable_mermaid_fix:
+                original = content
+                content = self._fix_mermaid_syntax(content)
+                if content != original:
+                    self.applied_fixes.append("Fix Mermaid Syntax")
+
+            # 9. Heading fix
+            if self.config.enable_heading_fix:
+                original = content
+                content = self._fix_headings(content)
+                if content != original:
+                    self.applied_fixes.append("Fix Headings")
+
+            # 10. Table fix
+            if self.config.enable_table_fix:
+                original = content
+                content = self._fix_tables(content)
+                if content != original:
+                    self.applied_fixes.append("Fix Tables")
+
+            # 11. XML tag cleanup
+            if self.config.enable_xml_tag_cleanup:
+                original = content
+                content = self._cleanup_xml_tags(content)
+                if content != original:
+                    self.applied_fixes.append("Cleanup XML Tags")
+
+            # 9. Custom cleaners
+            for cleaner in self.config.custom_cleaners:
+                original = content
+                content = cleaner(content)
+                if content != original:
+                    self.applied_fixes.append("Custom Cleaner")
+
+            if self.applied_fixes:
+                logger.info(f"Markdown Normalizer Applied Fixes: {self.applied_fixes}")
+                logger.debug(
+                    f"--- Original Content ---\n{original_content}\n------------------------"
+                )
+                logger.debug(
+                    f"--- Normalized Content ---\n{content}\n--------------------------"
+                )
+
+            return content
+
+        except Exception as e:
+            # Production safeguard: return original content on error
+            logger.error(f"Content normalization failed: {e}", exc_info=True)
+            return content
+
+    def _fix_escape_characters(self, content: str) -> str:
+        """Fix excessive escape characters"""
+        content = content.replace("\\r\\n", "\n")
+        content = content.replace("\\n", "\n")
+        content = content.replace("\\t", "\t")
+        content = content.replace("\\\\", "\\")
+        return content
+
+    def _fix_thought_tags(self, content: str) -> str:
+        """Normalize thought tags: unify naming and fix spacing"""
+        # 1. Standardize start tag: <think>, <thinking> -> <thought>
+        content = self._PATTERNS["thought_start"].sub("<thought>", content)
+        # 2. Standardize end tag and ensure newlines: </think> -> </thought>\n\n
+        return self._PATTERNS["thought_end"].sub("</thought>\n\n", content)
+
+    def _fix_code_blocks(self, content: str) -> str:
+        """Fix code block formatting (prefixes, suffixes, indentation)"""
+        # Remove indentation before code blocks
+        content = self._PATTERNS["code_block_indent"].sub(r"\1", content)
+        # Ensure newline before ```
+        content = self._PATTERNS["code_block_prefix"].sub(r"\n\1", content)
+        # Ensure newline after ```lang
+        content = self._PATTERNS["code_block_suffix"].sub(r"\1\n\2", content)
+        return content
+
+    def _fix_latex_formulas(self, content: str) -> str:
+        """Normalize LaTeX formulas: \[ -> $$ (block), \( -> $ (inline)"""
+        content = self._PATTERNS["latex_bracket_block"].sub(r"$$\1$$", content)
+        content = self._PATTERNS["latex_paren_inline"].sub(r"$\1$", content)
+        return content
+
+    def _fix_list_formatting(self, content: str) -> str:
+        """Fix missing newlines in lists (e.g., 'text1. item' -> 'text\\n1. item')"""
+        return self._PATTERNS["list_item"].sub(r"\1\n\2", content)
+
+    def _fix_unclosed_code_blocks(self, content: str) -> str:
+        """Auto-close unclosed code blocks"""
+        if content.count("```") % 2 != 0:
+            content += "\n```"
+        return content
+
+    def _fix_fullwidth_symbols_in_code(self, content: str) -> str:
+        """Convert full-width symbols to half-width inside code blocks"""
+        FULLWIDTH_MAP = {
+            "，": ",",
+            "。": ".",
+            "（": "(",
+            "）": ")",
+            "【": "[",
+            "】": "]",
+            "；": ";",
+            "：": ":",
+            "？": "?",
+            "！": "!",
+            '"': '"',
+            '"': '"',
+            """: "'", """: "'",
+        }
+
+        parts = content.split("```")
+        # Code block content is at odd indices: 1, 3, 5...
+        for i in range(1, len(parts), 2):
+            for full, half in FULLWIDTH_MAP.items():
+                parts[i] = parts[i].replace(full, half)
+
+        return "```".join(parts)
+
+    def _fix_mermaid_syntax(self, content: str) -> str:
+        """Fix common Mermaid syntax errors while preserving node shapes"""
+
+        def replacer(match):
+            # Group 1 is Quoted String (if matched)
+            if match.group(1):
+                return match.group(1)
+
+            # Group 2 is ID
+            id_str = match.group(2)
+
+            # Find matching shape group
+            # Groups start at index 3 (in match.group terms) or index 2 (in match.groups() tuple)
+            # Tuple: (String, ID, Open1, Content1, Close1, ...)
+            groups = match.groups()
+            for i in range(2, len(groups), 3):
+                if groups[i] is not None:
+                    open_char = groups[i]
+                    content = groups[i + 1]
+                    close_char = groups[i + 2]
+
+                    # Escape quotes in content
+                    content = content.replace('"', '\\"')
+
+                    return f'{id_str}{open_char}"{content}"{close_char}'
+
+            return match.group(0)
+
+        parts = content.split("```")
+        for i in range(1, len(parts), 2):
+            # Check if it's a mermaid block
+            lang_line = parts[i].split("\n", 1)[0].strip().lower()
+            if "mermaid" in lang_line:
+                # Apply the comprehensive regex fix
+                parts[i] = self._PATTERNS["mermaid_node"].sub(replacer, parts[i])
+
+                # Auto-close subgraphs
+                subgraph_count = len(
+                    re.findall(r"\bsubgraph\b", parts[i], re.IGNORECASE)
+                )
+                end_count = len(re.findall(r"\bend\b", parts[i], re.IGNORECASE))
+
+                if subgraph_count > end_count:
+                    missing_ends = subgraph_count - end_count
+                    parts[i] = parts[i].rstrip() + ("\n    end" * missing_ends) + "\n"
+
+        return "```".join(parts)
+
+    def _fix_headings(self, content: str) -> str:
+        """Fix missing space in headings: #Heading -> # Heading"""
+        # We only fix if it's not inside a code block.
+        # But splitting by code block is expensive.
+        # Given headings usually don't appear inside code blocks without space in valid code (except comments),
+        # we might risk false positives in comments like `#TODO`.
+        # To be safe, let's split by code blocks.
+
+        parts = content.split("```")
+        for i in range(0, len(parts), 2):  # Even indices are markdown text
+            parts[i] = self._PATTERNS["heading_space"].sub(r"\1 \2", parts[i])
+        return "```".join(parts)
+
+    def _fix_tables(self, content: str) -> str:
+        """Fix tables missing closing pipe"""
+        parts = content.split("```")
+        for i in range(0, len(parts), 2):
+            parts[i] = self._PATTERNS["table_pipe"].sub(r"\1|", parts[i])
+        return "```".join(parts)
+
+    def _cleanup_xml_tags(self, content: str) -> str:
+        """Remove leftover XML tags"""
+        return self._PATTERNS["xml_artifacts"].sub("", content)
+
+
+class Filter:
+    class Valves(BaseModel):
+        priority: int = Field(
+            default=50,
+            description="Priority level. Higher runs later (recommended to run after other filters).",
+        )
+        enable_escape_fix: bool = Field(
+            default=True, description="Fix excessive escape characters (\\n, \\t, etc.)"
+        )
+        enable_thought_tag_fix: bool = Field(
+            default=True, description="Normalize </thought> tags"
+        )
+        enable_code_block_fix: bool = Field(
+            default=True,
+            description="Fix code block formatting (indentation, newlines)",
+        )
+        enable_latex_fix: bool = Field(
+            default=True, description="Normalize LaTeX formulas (\\[ -> $$, \\( -> $)"
+        )
+        enable_list_fix: bool = Field(
+            default=False, description="Fix list item newlines (Experimental)"
+        )
+        enable_unclosed_block_fix: bool = Field(
+            default=True, description="Auto-close unclosed code blocks"
+        )
+        enable_fullwidth_symbol_fix: bool = Field(
+            default=False, description="Fix full-width symbols in code blocks"
+        )
+        enable_mermaid_fix: bool = Field(
+            default=True,
+            description="Fix common Mermaid syntax errors (e.g. unquoted labels)",
+        )
+        enable_heading_fix: bool = Field(
+            default=True,
+            description="Fix missing space in headings (#Header -> # Header)",
+        )
+        enable_table_fix: bool = Field(
+            default=True, description="Fix missing closing pipe in tables"
+        )
+        enable_xml_tag_cleanup: bool = Field(
+            default=True, description="Cleanup leftover XML tags"
+        )
+        show_status: bool = Field(
+            default=True, description="Show status notification when fixes are applied"
+        )
+        show_debug_log: bool = Field(
+            default=False, description="Print debug logs to browser console (F12)"
+        )
+
+    def __init__(self):
+        self.valves = self.Valves()
+
+    def _contains_html(self, content: str) -> bool:
+        """Check if content contains HTML tags (to avoid breaking HTML output)"""
+        pattern = r"<\s*/?\s*(?:html|head|body|div|span|p|br|hr|ul|ol|li|table|thead|tbody|tfoot|tr|td|th|img|a|b|i|strong|em|code|pre|blockquote|h[1-6]|script|style|form|input|button|label|select|option|iframe|link|meta|title)\b"
+        return bool(re.search(pattern, content, re.IGNORECASE))
+
+    async def _emit_status(self, __event_emitter__, applied_fixes: List[str]):
+        """Emit status notification"""
+        if not self.valves.show_status or not applied_fixes:
+            return
+
+        description = "✓ Markdown Normalized"
+        if applied_fixes:
+            description += f": {', '.join(applied_fixes)}"
+
+        try:
+            await __event_emitter__(
+                {
+                    "type": "status",
+                    "data": {
+                        "description": description,
+                        "done": True,
+                    },
+                }
+            )
+        except Exception as e:
+            print(f"Error emitting status: {e}")
+
+    async def _emit_debug_log(
+        self, __event_call__, applied_fixes: List[str], original: str, normalized: str
+    ):
+        """Emit debug log to browser console via JS execution"""
+        if not self.valves.show_debug_log or not __event_call__:
+            return
+
+        try:
+            # Prepare data for JS
+            log_data = {
+                "fixes": applied_fixes,
+                "original": original,
+                "normalized": normalized,
+            }
+
+            # Construct JS code
+            js_code = f"""
+                (async function() {{
+                    console.group("🛠️ Markdown Normalizer Debug");
+                    console.log("Applied Fixes:", {json.dumps(applied_fixes, ensure_ascii=False)});
+                    console.log("Original Content:", {json.dumps(original, ensure_ascii=False)});
+                    console.log("Normalized Content:", {json.dumps(normalized, ensure_ascii=False)});
+                    console.groupEnd();
+                }})();
+            """
+
+            await __event_call__(
+                {
+                    "type": "execute",
+                    "data": {"code": js_code},
+                }
+            )
+        except Exception as e:
+            print(f"Error emitting debug log: {e}")
+
+    async def outlet(
+        self,
+        body: dict,
+        __user__: Optional[dict] = None,
+        __event_emitter__=None,
+        __event_call__=None,
+        __metadata__: Optional[dict] = None,
+    ) -> dict:
+        """
+        Process the response body to normalize Markdown content.
+        """
+        if "messages" in body and body["messages"]:
+            last = body["messages"][-1]
+            content = last.get("content", "") or ""
+
+            if last.get("role") == "assistant" and isinstance(content, str):
+                # Skip if content looks like HTML to avoid breaking it
+                if self._contains_html(content):
+                    return body
+
+                # Configure normalizer based on valves
+                config = NormalizerConfig(
+                    enable_escape_fix=self.valves.enable_escape_fix,
+                    enable_thought_tag_fix=self.valves.enable_thought_tag_fix,
+                    enable_code_block_fix=self.valves.enable_code_block_fix,
+                    enable_latex_fix=self.valves.enable_latex_fix,
+                    enable_list_fix=self.valves.enable_list_fix,
+                    enable_unclosed_block_fix=self.valves.enable_unclosed_block_fix,
+                    enable_fullwidth_symbol_fix=self.valves.enable_fullwidth_symbol_fix,
+                    enable_mermaid_fix=self.valves.enable_mermaid_fix,
+                    enable_heading_fix=self.valves.enable_heading_fix,
+                    enable_table_fix=self.valves.enable_table_fix,
+                    enable_xml_tag_cleanup=self.valves.enable_xml_tag_cleanup,
+                )
+
+                normalizer = ContentNormalizer(config)
+
+                # Execute normalization
+                new_content = normalizer.normalize(content)
+
+                # Update content if changed
+                if new_content != content:
+                    last["content"] = new_content
+
+                    # Emit status if enabled
+                    if __event_emitter__:
+                        await self._emit_status(
+                            __event_emitter__, normalizer.applied_fixes
+                        )
+                        await self._emit_debug_log(
+                            __event_call__,
+                            normalizer.applied_fixes,
+                            content,
+                            new_content,
+                        )
+
+        return body
--- a/plugins/filters/markdown_normalizer/markdown_normalizer_cn.py
+++ b/plugins/filters/markdown_normalizer/markdown_normalizer_cn.py
@@ -0,0 +1,549 @@
+"""
+title: Markdown 格式修复器 (Markdown Normalizer)
+author: Fu-Jie
+author_url: https://github.com/Fu-Jie
+funding_url: https://github.com/Fu-Jie/awesome-openwebui
+version: 1.0.0
+description: 生产级内容规范化过滤器，修复 LLM 输出中常见的 Markdown 格式问题，如损坏的代码块、LaTeX 公式、Mermaid 图表和列表格式。
+"""
+
+from pydantic import BaseModel, Field
+from typing import Optional, List, Callable
+import re
+import logging
+import asyncio
+import json
+from dataclasses import dataclass, field
+
+# Configure logging
+logger = logging.getLogger(__name__)
+
+
+@dataclass
+class NormalizerConfig:
+    """配置类，用于启用/禁用特定的规范化规则"""
+
+    enable_escape_fix: bool = True  # 修复过度的转义字符
+    enable_thought_tag_fix: bool = True  # 规范化思维链标签
+    enable_code_block_fix: bool = True  # 修复代码块格式
+    enable_latex_fix: bool = True  # 修复 LaTeX 公式格式
+    enable_list_fix: bool = False  # 修复列表项换行 (默认关闭，因为可能过于激进)
+    enable_unclosed_block_fix: bool = True  # 自动闭合未闭合的代码块
+    enable_fullwidth_symbol_fix: bool = False  # 修复代码块中的全角符号
+    enable_mermaid_fix: bool = True  # 修复常见的 Mermaid 语法错误
+    enable_heading_fix: bool = True  # 修复标题中缺失的空格 (#Header -> # Header)
+    enable_table_fix: bool = True  # 修复表格中缺失的闭合管道符
+    enable_xml_tag_cleanup: bool = True  # 清理残留的 XML 标签
+
+    # 自定义清理函数 (用于高级扩展)
+    custom_cleaners: List[Callable[[str], str]] = field(default_factory=list)
+
+
+class ContentNormalizer:
+    """LLM Output Content Normalizer - Production Grade Implementation"""
+
+    # --- 1. Pre-compiled Regex Patterns (Performance Optimization) ---
+    _PATTERNS = {
+        # Code block prefix: if ``` is not at start of line or file
+        "code_block_prefix": re.compile(r"(?<!^)(?<!\n)(```)", re.MULTILINE),
+        # Code block suffix: ```lang followed by non-whitespace (no newline)
+        "code_block_suffix": re.compile(r"(```[\w\+\-\.]*)[ \t]+([^\n\r])"),
+        # Code block indent: whitespace at start of line + ```
+        "code_block_indent": re.compile(r"^[ \t]+(```)", re.MULTILINE),
+        # Thought tag: </thought> followed by optional whitespace/newlines
+        "thought_end": re.compile(
+            r"</(thought|think|thinking)>[ \t]*\n*", re.IGNORECASE
+        ),
+        "thought_start": re.compile(r"<(thought|think|thinking)>", re.IGNORECASE),
+        # LaTeX block: \[ ... \]
+        "latex_bracket_block": re.compile(r"\\\[(.+?)\\\]", re.DOTALL),
+        # LaTeX inline: \( ... \)
+        "latex_paren_inline": re.compile(r"\\\((.+?)\\\)"),
+        # List item: non-newline + digit + dot + space
+        "list_item": re.compile(r"([^\n])(\d+\. )"),
+        # XML artifacts (e.g. Claude's)
+        "xml_artifacts": re.compile(
+            r"</?(?:antArtifact|antThinking|artifact)[^>]*>", re.IGNORECASE
+        ),
+        # Mermaid: 匹配各种形状的节点并为未加引号的标签添加引号
+        # 修复"反向优化"问题：必须精确匹配各种形状的定界符，避免破坏形状结构
+        # 优先级：长定界符优先匹配
+        "mermaid_node": re.compile(
+            r'("[^"\\]*(?:\\.[^"\\]*)*")|'  # Match quoted strings first (Group 1)
+            r"(\w+)\s*(?:"
+            r"(\(\(\()(?![\"])(.*?)(?<![\"])(\)\)\))|"  # (((...))) Double Circle
+            r"(\(\()(?![\"])(.*?)(?<![\"])(\)\))|"  # ((...)) Circle
+            r"(\(\[)(?![\"])(.*?)(?<![\"])(\]\))|"  # ([...]) Stadium
+            r"(\[\()(?![\"])(.*?)(?<![\"])(\)\])|"  # [(...)] Cylinder
+            r"(\[\[)(?![\"])(.*?)(?<![\"])(\]\])|"  # [[...]] Subroutine
+            r"(\{\{)(?![\"])(.*?)(?<![\"])(\}\})|"  # {{...}} Hexagon
+            r"(\[/)(?![\"])(.*?)(?<![\"])(/\])|"  # [/.../] Parallelogram
+            r"(\[\\)(?![\"])(.*?)(?<![\"])(\\\])|"  # [\...\] Parallelogram Alt
+            r"(\[/)(?![\"])(.*?)(?<![\"])(\\\])|"  # [/...\] Trapezoid
+            r"(\[\\)(?![\"])(.*?)(?<![\"])(/\])|"  # [\.../] Trapezoid Alt
+            r"(\()(?![\"])(.*?)(?<![\"])(\))|"  # (...) Round
+            r"(\[)(?![\"])(.*?)(?<![\"])(\])|"  # [...] Square
+            r"(\{)(?![\"])(.*?)(?<![\"])(\})|"  # {...} Rhombus
+            r"(>)(?![\"])(.*?)(?<![\"])(\])"  # >...] Asymmetric
+            r")"
+        ),
+        # Heading: #Heading -> # Heading
+        "heading_space": re.compile(r"^(#+)([^ \n#])", re.MULTILINE),
+        # Table: | col1 | col2 -> | col1 | col2 |
+        "table_pipe": re.compile(r"^(\|.*[^|\n])$", re.MULTILINE),
+    }
+
+    def __init__(self, config: Optional[NormalizerConfig] = None):
+        self.config = config or NormalizerConfig()
+        self.applied_fixes = []
+
+    def normalize(self, content: str) -> str:
+        """Main entry point: apply all normalization rules in order"""
+        self.applied_fixes = []
+        if not content:
+            return content
+
+        original_content = content  # Keep a copy for logging
+
+        try:
+            # 1. Escape character fix (Must be first)
+            if self.config.enable_escape_fix:
+                original = content
+                content = self._fix_escape_characters(content)
+                if content != original:
+                    self.applied_fixes.append("Fix Escape Chars")
+
+            # 2. Thought tag normalization
+            if self.config.enable_thought_tag_fix:
+                original = content
+                content = self._fix_thought_tags(content)
+                if content != original:
+                    self.applied_fixes.append("Normalize Thought Tags")
+
+            # 3. Code block formatting fix
+            if self.config.enable_code_block_fix:
+                original = content
+                content = self._fix_code_blocks(content)
+                if content != original:
+                    self.applied_fixes.append("Fix Code Blocks")
+
+            # 4. LaTeX formula normalization
+            if self.config.enable_latex_fix:
+                original = content
+                content = self._fix_latex_formulas(content)
+                if content != original:
+                    self.applied_fixes.append("Normalize LaTeX")
+
+            # 5. List formatting fix
+            if self.config.enable_list_fix:
+                original = content
+                content = self._fix_list_formatting(content)
+                if content != original:
+                    self.applied_fixes.append("Fix List Format")
+
+            # 6. Unclosed code block fix
+            if self.config.enable_unclosed_block_fix:
+                original = content
+                content = self._fix_unclosed_code_blocks(content)
+                if content != original:
+                    self.applied_fixes.append("Close Code Blocks")
+
+            # 7. Full-width symbol fix (in code blocks only)
+            if self.config.enable_fullwidth_symbol_fix:
+                original = content
+                content = self._fix_fullwidth_symbols_in_code(content)
+                if content != original:
+                    self.applied_fixes.append("Fix Full-width Symbols")
+
+            # 8. Mermaid syntax fix
+            if self.config.enable_mermaid_fix:
+                original = content
+                content = self._fix_mermaid_syntax(content)
+                if content != original:
+                    self.applied_fixes.append("Fix Mermaid Syntax")
+
+            # 9. Heading fix
+            if self.config.enable_heading_fix:
+                original = content
+                content = self._fix_headings(content)
+                if content != original:
+                    self.applied_fixes.append("Fix Headings")
+
+            # 10. Table fix
+            if self.config.enable_table_fix:
+                original = content
+                content = self._fix_tables(content)
+                if content != original:
+                    self.applied_fixes.append("Fix Tables")
+
+            # 11. XML tag cleanup
+            if self.config.enable_xml_tag_cleanup:
+                original = content
+                content = self._cleanup_xml_tags(content)
+                if content != original:
+                    self.applied_fixes.append("Cleanup XML Tags")
+
+            # 9. Custom cleaners
+            for cleaner in self.config.custom_cleaners:
+                original = content
+                content = cleaner(content)
+                if content != original:
+                    self.applied_fixes.append("Custom Cleaner")
+
+            if self.applied_fixes:
+                print(f"[Markdown Normalizer] Applied fixes: {self.applied_fixes}")
+                print(
+                    f"[Markdown Normalizer] --- Original Content ---\n{original_content}\n------------------------"
+                )
+                print(
+                    f"[Markdown Normalizer] --- Normalized Content ---\n{content}\n--------------------------"
+                )
+
+            return content
+
+        except Exception as e:
+            # Production safeguard: return original content on error
+            logger.error(f"Content normalization failed: {e}", exc_info=True)
+            return content
+
+    def _fix_escape_characters(self, content: str) -> str:
+        """Fix excessive escape characters"""
+        content = content.replace("\\r\\n", "\n")
+        content = content.replace("\\n", "\n")
+        content = content.replace("\\t", "\t")
+        content = content.replace("\\\\", "\\")
+        return content
+
+    def _fix_thought_tags(self, content: str) -> str:
+        """Normalize thought tags: unify naming and fix spacing"""
+        # 1. Standardize start tag: <think>, <thinking> -> <thought>
+        content = self._PATTERNS["thought_start"].sub("<thought>", content)
+        # 2. Standardize end tag and ensure newlines: </think> -> </thought>\n\n
+        return self._PATTERNS["thought_end"].sub("</thought>\n\n", content)
+
+    def _fix_code_blocks(self, content: str) -> str:
+        """Fix code block formatting (prefixes, suffixes, indentation)"""
+        # Remove indentation before code blocks
+        content = self._PATTERNS["code_block_indent"].sub(r"\1", content)
+        # Ensure newline before ```
+        content = self._PATTERNS["code_block_prefix"].sub(r"\n\1", content)
+        # Ensure newline after ```lang
+        content = self._PATTERNS["code_block_suffix"].sub(r"\1\n\2", content)
+        return content
+
+    def _fix_latex_formulas(self, content: str) -> str:
+        """Normalize LaTeX formulas: \[ -> $$ (block), \( -> $ (inline)"""
+        content = self._PATTERNS["latex_bracket_block"].sub(r"$$\1$$", content)
+        content = self._PATTERNS["latex_paren_inline"].sub(r"$\1$", content)
+        return content
+
+    def _fix_list_formatting(self, content: str) -> str:
+        """Fix missing newlines in lists (e.g., 'text1. item' -> 'text\\n1. item')"""
+        return self._PATTERNS["list_item"].sub(r"\1\n\2", content)
+
+    def _fix_unclosed_code_blocks(self, content: str) -> str:
+        """Auto-close unclosed code blocks"""
+        if content.count("```") % 2 != 0:
+            content += "\n```"
+        return content
+
+    def _fix_fullwidth_symbols_in_code(self, content: str) -> str:
+        """Convert full-width symbols to half-width inside code blocks"""
+        FULLWIDTH_MAP = {
+            "，": ",",
+            "。": ".",
+            "（": "(",
+            "）": ")",
+            "【": "[",
+            "】": "]",
+            "；": ";",
+            "：": ":",
+            "？": "?",
+            "！": "!",
+            '"': '"',
+            '"': '"',
+            """: "'", """: "'",
+        }
+
+        parts = content.split("```")
+        # Code block content is at odd indices: 1, 3, 5...
+        for i in range(1, len(parts), 2):
+            for full, half in FULLWIDTH_MAP.items():
+                parts[i] = parts[i].replace(full, half)
+
+        return "```".join(parts)
+
+    def _fix_mermaid_syntax(self, content: str) -> str:
+        """修复常见的 Mermaid 语法错误，同时保留节点形状"""
+
+        def replacer(match):
+            # Group 1 is Quoted String (if matched)
+            if match.group(1):
+                return match.group(1)
+
+            # Group 2 is ID
+            id_str = match.group(2)
+
+            # Find matching shape group
+            # Groups start at index 3 (in match.group terms) or index 2 (in match.groups() tuple)
+            # Tuple: (String, ID, Open1, Content1, Close1, ...)
+            groups = match.groups()
+            for i in range(2, len(groups), 3):
+                if groups[i] is not None:
+                    open_char = groups[i]
+                    content = groups[i + 1]
+                    close_char = groups[i + 2]
+
+                    # 如果内容包含引号，进行转义
+                    content = content.replace('"', '\\"')
+
+                    return f'{id_str}{open_char}"{content}"{close_char}'
+
+            return match.group(0)
+
+        parts = content.split("```")
+        for i in range(1, len(parts), 2):
+            # Check if it's a mermaid block
+            lang_line = parts[i].split("\n", 1)[0].strip().lower()
+            if "mermaid" in lang_line:
+                # Apply the comprehensive regex fix
+                parts[i] = self._PATTERNS["mermaid_node"].sub(replacer, parts[i])
+
+                # Auto-close subgraphs
+                # Count 'subgraph' and 'end' (case-insensitive)
+                # We use a simple regex to avoid matching words inside labels (though labels are now quoted, so it's safer)
+                # But for simplicity and speed, we just count occurrences in the whole block.
+                # A more robust way would be to strip quoted strings first, but that's expensive.
+                # Given we just quoted everything, let's try to count keywords outside quotes?
+                # Actually, since we just normalized nodes, most text is in quotes.
+                # Let's just do a simple count. It's a heuristic fix.
+                subgraph_count = len(
+                    re.findall(r"\bsubgraph\b", parts[i], re.IGNORECASE)
+                )
+                end_count = len(re.findall(r"\bend\b", parts[i], re.IGNORECASE))
+
+                if subgraph_count > end_count:
+                    missing_ends = subgraph_count - end_count
+                    parts[i] = parts[i].rstrip() + ("\n    end" * missing_ends) + "\n"
+
+        return "```".join(parts)
+
+    def _fix_headings(self, content: str) -> str:
+        """Fix missing space in headings: #Heading -> # Heading"""
+        # We only fix if it's not inside a code block.
+        # But splitting by code block is expensive.
+        # Given headings usually don't appear inside code blocks without space in valid code (except comments),
+        # we might risk false positives in comments like `#TODO`.
+        # To be safe, let's split by code blocks.
+
+        parts = content.split("```")
+        for i in range(0, len(parts), 2):  # Even indices are markdown text
+            parts[i] = self._PATTERNS["heading_space"].sub(r"\1 \2", parts[i])
+        return "```".join(parts)
+
+    def _fix_tables(self, content: str) -> str:
+        """Fix tables missing closing pipe"""
+        parts = content.split("```")
+        for i in range(0, len(parts), 2):
+            parts[i] = self._PATTERNS["table_pipe"].sub(r"\1|", parts[i])
+        return "```".join(parts)
+
+    def _cleanup_xml_tags(self, content: str) -> str:
+        """Remove leftover XML tags"""
+        return self._PATTERNS["xml_artifacts"].sub("", content)
+
+
+class Filter:
+    class Valves(BaseModel):
+        priority: int = Field(
+            default=50,
+            description="优先级。数值越高运行越晚 (建议在其他过滤器之后运行)。",
+        )
+        enable_escape_fix: bool = Field(
+            default=True, description="修复过度的转义字符 (\\n, \\t 等)"
+        )
+        enable_thought_tag_fix: bool = Field(
+            default=True, description="规范化思维链标签 (<think> -> <thought>)"
+        )
+        enable_code_block_fix: bool = Field(
+            default=True,
+            description="修复代码块格式 (缩进、换行)",
+        )
+        enable_latex_fix: bool = Field(
+            default=True, description="规范化 LaTeX 公式 (\\[ -> $$, \\( -> $)"
+        )
+        enable_list_fix: bool = Field(
+            default=False, description="修复列表项换行 (实验性)"
+        )
+        enable_unclosed_block_fix: bool = Field(
+            default=True, description="自动闭合未闭合的代码块"
+        )
+        enable_fullwidth_symbol_fix: bool = Field(
+            default=False, description="修复代码块中的全角符号"
+        )
+        enable_mermaid_fix: bool = Field(
+            default=True,
+            description="修复常见的 Mermaid 语法错误 (如未加引号的标签)",
+        )
+        enable_heading_fix: bool = Field(
+            default=True,
+            description="修复标题中缺失的空格 (#Header -> # Header)",
+        )
+        enable_table_fix: bool = Field(
+            default=True, description="修复表格中缺失的闭合管道符"
+        )
+        enable_xml_tag_cleanup: bool = Field(
+            default=True, description="清理残留的 XML 标签"
+        )
+        show_status: bool = Field(default=True, description="应用修复时显示状态通知")
+        show_debug_log: bool = Field(
+            default=False, description="在浏览器控制台打印调试日志 (F12)"
+        )
+
+    def __init__(self):
+        self.valves = self.Valves()
+
+    def _contains_html(self, content: str) -> bool:
+        """Check if content contains HTML tags (to avoid breaking HTML output)"""
+        pattern = r"<\s*/?\s*(?:html|head|body|div|span|p|br|hr|ul|ol|li|table|thead|tbody|tfoot|tr|td|th|img|a|b|i|strong|em|code|pre|blockquote|h[1-6]|script|style|form|input|button|label|select|option|iframe|link|meta|title)\b"
+        return bool(re.search(pattern, content, re.IGNORECASE))
+
+    async def _emit_status(self, __event_emitter__, applied_fixes: List[str]):
+        """Emit status notification"""
+        if not self.valves.show_status or not applied_fixes:
+            return
+
+        description = "✓ Markdown 已修复"
+        if applied_fixes:
+            # Translate fix names for status display
+            fix_map = {
+                "Fix Escape Chars": "转义字符",
+                "Normalize Thought Tags": "思维标签",
+                "Fix Code Blocks": "代码块",
+                "Normalize LaTeX": "LaTeX公式",
+                "Fix List Format": "列表格式",
+                "Close Code Blocks": "闭合代码块",
+                "Fix Full-width Symbols": "全角符号",
+                "Fix Mermaid Syntax": "Mermaid语法",
+                "Fix Headings": "标题格式",
+                "Fix Tables": "表格格式",
+                "Cleanup XML Tags": "XML清理",
+                "Custom Cleaner": "自定义清理",
+            }
+            translated_fixes = [fix_map.get(fix, fix) for fix in applied_fixes]
+            description += f": {', '.join(translated_fixes)}"
+
+        try:
+            await __event_emitter__(
+                {
+                    "type": "status",
+                    "data": {
+                        "description": description,
+                        "done": True,
+                    },
+                }
+            )
+        except Exception as e:
+            print(f"Error emitting status: {e}")
+
+    async def _emit_debug_log(
+        self,
+        __event_emitter__,
+        applied_fixes: List[str],
+        original: str,
+        normalized: str,
+    ):
+        """Emit debug log to browser console via JS execution"""
+
+    async def _emit_debug_log(
+        self, __event_call__, applied_fixes: List[str], original: str, normalized: str
+    ):
+        """Emit debug log to browser console via JS execution"""
+        if not self.valves.show_debug_log or not __event_call__:
+            return
+
+        try:
+            # Prepare data for JS
+            log_data = {
+                "fixes": applied_fixes,
+                "original": original,
+                "normalized": normalized,
+            }
+
+            # Construct JS code
+            js_code = f"""
+                (async function() {{
+                    console.group("🛠️ Markdown Normalizer Debug");
+                    console.log("Applied Fixes:", {json.dumps(applied_fixes, ensure_ascii=False)});
+                    console.log("Original Content:", {json.dumps(original, ensure_ascii=False)});
+                    console.log("Normalized Content:", {json.dumps(normalized, ensure_ascii=False)});
+                    console.groupEnd();
+                }})();
+            """
+            await __event_call__(
+                {
+                    "type": "execute",
+                    "data": {"code": js_code},
+                }
+            )
+
+        except Exception as e:
+            print(f"Error emitting debug log: {e}")
+
+    async def outlet(
+        self,
+        body: dict,
+        __user__: Optional[dict] = None,
+        __event_emitter__=None,
+        __event_call__=None,
+        __metadata__: Optional[dict] = None,
+    ) -> dict:
+        """
+        Process the response body to normalize Markdown content.
+        """
+        if "messages" in body and body["messages"]:
+            last = body["messages"][-1]
+            content = last.get("content", "") or ""
+
+            if last.get("role") == "assistant" and isinstance(content, str):
+                # Skip if content looks like HTML to avoid breaking it
+                if self._contains_html(content):
+                    return body
+
+                # Configure normalizer based on valves
+                config = NormalizerConfig(
+                    enable_escape_fix=self.valves.enable_escape_fix,
+                    enable_thought_tag_fix=self.valves.enable_thought_tag_fix,
+                    enable_code_block_fix=self.valves.enable_code_block_fix,
+                    enable_latex_fix=self.valves.enable_latex_fix,
+                    enable_list_fix=self.valves.enable_list_fix,
+                    enable_unclosed_block_fix=self.valves.enable_unclosed_block_fix,
+                    enable_fullwidth_symbol_fix=self.valves.enable_fullwidth_symbol_fix,
+                    enable_mermaid_fix=self.valves.enable_mermaid_fix,
+                    enable_heading_fix=self.valves.enable_heading_fix,
+                    enable_table_fix=self.valves.enable_table_fix,
+                    enable_xml_tag_cleanup=self.valves.enable_xml_tag_cleanup,
+                )
+
+                normalizer = ContentNormalizer(config)
+
+                # Execute normalization
+                new_content = normalizer.normalize(content)
+
+                # Update content if changed
+                if new_content != content:
+                    last["content"] = new_content
+
+                    # Emit status if enabled
+                    if __event_emitter__:
+                        await self._emit_status(
+                            __event_emitter__, normalizer.applied_fixes
+                        )
+                        await self._emit_debug_log(
+                            __event_call__,
+                            normalizer.applied_fixes,
+                            content,
+                            new_content,
+                        )
+
+        return body
--- a/plugins/filters/markdown_normalizer/test_markdown_normalizer.py
+++ b/plugins/filters/markdown_normalizer/test_markdown_normalizer.py
@@ -0,0 +1,191 @@
+import unittest
+import sys
+import os
+
+# Add the current directory to sys.path to import the module
+current_dir = os.path.dirname(os.path.abspath(__file__))
+sys.path.append(current_dir)
+
+from markdown_normalizer import ContentNormalizer, NormalizerConfig
+
+
+class TestMarkdownNormalizer(unittest.TestCase):
+    def setUp(self):
+        self.config = NormalizerConfig(
+            enable_escape_fix=True,
+            enable_thought_tag_fix=True,
+            enable_code_block_fix=True,
+            enable_latex_fix=True,
+            enable_list_fix=True,
+            enable_unclosed_block_fix=True,
+            enable_fullwidth_symbol_fix=True,
+            enable_mermaid_fix=True,
+            enable_xml_tag_cleanup=True,
+        )
+        self.normalizer = ContentNormalizer(self.config)
+
+    def test_escape_fix(self):
+        input_text = "Line 1\\nLine 2\\tTabbed"
+        expected = "Line 1\nLine 2\tTabbed"
+        self.assertEqual(self.normalizer.normalize(input_text), expected)
+
+    def test_thought_tag_fix(self):
+        # Case 1: Standard tag spacing
+        input_text = "Thinking...</thought>Result"
+        expected = "Thinking...</thought>\n\nResult"
+        self.assertEqual(self.normalizer.normalize(input_text), expected)
+
+        # Case 2: Tag standardization (<think> -> <thought>)
+        input_text_deepseek = "<think>Deep thinking...</think>Result"
+        expected_deepseek = "<thought>Deep thinking...</thought>\n\nResult"
+        self.assertEqual(
+            self.normalizer.normalize(input_text_deepseek), expected_deepseek
+        )
+
+    def test_code_block_fix(self):
+        # Case 1: Indentation
+        self.assertEqual(self.normalizer._fix_code_blocks("   ```python"), "```python")
+
+        # Case 2: Prefix (newline before block)
+        self.assertEqual(
+            self.normalizer._fix_code_blocks("Text```python"), "Text\n```python"
+        )
+
+        # Case 3: Suffix (newline after lang)
+        self.assertEqual(
+            self.normalizer._fix_code_blocks("```python print('hi')"),
+            "```python\nprint('hi')",
+        )
+
+    def test_latex_fix(self):
+        input_text = "Block: \\[ x^2 \\] Inline: \\( E=mc^2 \\)"
+        expected = "Block: $$ x^2 $$ Inline: $ E=mc^2 $"
+        self.assertEqual(self.normalizer.normalize(input_text), expected)
+
+    def test_list_fix(self):
+        input_text = "Item 1. First\nItem 2. Second"  # This is fine
+        input_text_bad = "Header1. Item 1"
+        expected = "Header\n1. Item 1"
+        self.assertEqual(self.normalizer.normalize(input_text_bad), expected)
+
+    def test_unclosed_code_block_fix(self):
+        input_text = "```python\nprint('hello')"
+        expected = "```python\nprint('hello')\n```"
+        self.assertEqual(self.normalizer.normalize(input_text), expected)
+
+    def test_fullwidth_symbol_fix(self):
+        input_text = "Outside：Fullwidth ```python\nprint（'hello'）```"
+        expected = "Outside：Fullwidth \n```python\nprint('hello')\n```"
+
+        normalized = self.normalizer.normalize(input_text)
+        self.assertIn("print('hello')", normalized)
+        self.assertIn("Outside：Fullwidth", normalized)
+        self.assertNotIn("（", normalized)
+        self.assertNotIn("）", normalized)
+
+    def test_mermaid_fix(self):
+        # Test Mermaid syntax fix for unquoted labels
+        # Note: Regex-based fix handles mixed brackets well (e.g. [] inside ())
+        # but cannot perfectly handle same-type nesting (e.g. {} inside {}) without a parser.
+        input_text = """
+```mermaid
+graph TD
+    A[Label with (parens)] --> B(Label with [brackets])
+    C{Label with [brackets]}
+```
+"""
+        expected_snippet = """
+```mermaid
+graph TD
+    A["Label with (parens)"] --> B("Label with [brackets]")
+    C{"Label with [brackets]"}
+```
+"""
+        normalized = self.normalizer.normalize(input_text)
+
+        self.assertIn('A["Label with (parens)"]', normalized)
+        self.assertIn('B("Label with [brackets]")', normalized)
+        self.assertIn('C{"Label with [brackets]"}', normalized)
+
+    def test_mermaid_shapes_regression(self):
+        # Regression test for "reverse optimization" where ((...)) was broken into ("(...)")
+        input_text = """
+```mermaid
+graph TD
+    Start((开始)) --> Input[[输入]]
+    Input --> Verify{验证}
+    Verify --> End(((结束)))
+```
+"""
+        expected_snippet = """
+```mermaid
+graph TD
+    Start(("开始")) --> Input[["输入"]]
+    Input --> Verify{"验证"}
+    Verify --> End((("结束")))
+```
+"""
+        normalized = self.normalizer.normalize(input_text)
+        self.assertIn('Start(("开始"))', normalized)
+        self.assertIn('Input[["输入"]]', normalized)
+        self.assertIn('Verify{"验证"}', normalized)
+        self.assertIn('End((("结束")))', normalized)
+
+    def test_xml_cleanup(self):
+        input_text = "Some text <antArtifact>hidden</antArtifact> visible"
+        expected = "Some text hidden visible"
+        self.assertEqual(self.normalizer.normalize(input_text), expected)
+
+    def test_heading_fix(self):
+        input_text = "#Heading 1\n##Heading 2\n### Valid Heading"
+        expected = "# Heading 1\n## Heading 2\n### Valid Heading"
+        self.assertEqual(self.normalizer.normalize(input_text), expected)
+
+    def test_table_fix(self):
+        input_text = "| Col 1 | Col 2\n| Val 1 | Val 2"
+        expected = "| Col 1 | Col 2|\n| Val 1 | Val 2|"
+        self.assertEqual(self.normalizer.normalize(input_text), expected)
+
+    def test_mermaid_subgraph_autoclose(self):
+        """Test auto-closing of Mermaid subgraphs"""
+        # Case 1: Simple unclosed subgraph
+        original = """
+```mermaid
+graph TD
+    subgraph One
+        A --> B
+```
+"""
+        expected = """
+```mermaid
+graph TD
+    subgraph One
+        A --> B
+    end
+```
+"""
+        # Note: The normalizer might add quotes to A and B if they match the node pattern,
+        # but here they are simple IDs. However, our regex is strict about shapes.
+        # Simple IDs like A and B are NOT matched by our mermaid_node regex because it requires a shape delimiter.
+        # So A and B remain A and B.
+
+        normalized = self.normalizer.normalize(original)
+        # We need to be careful about whitespace in comparison
+        self.assertIn("end", normalized)
+        self.assertEqual(normalized.strip(), expected.strip())
+
+        # Case 2: Nested unclosed subgraphs
+        original_nested = """
+```mermaid
+graph TD
+    subgraph Outer
+        subgraph Inner
+            C --> D
+```
+"""
+        normalized_nested = self.normalizer.normalize(original_nested)
+        self.assertEqual(normalized_nested.count("end"), 2)
+
+
+if __name__ == "__main__":
+    unittest.main()
--- a/scripts/download_plugin_images.py
+++ b/scripts/download_plugin_images.py
@@ -0,0 +1,133 @@
+"""
+Download plugin images from OpenWebUI Community
+下载远程插件图片到本地目录
+"""
+
+import os
+import sys
+import re
+import requests
+from urllib.parse import urlparse
+
+# Add current directory to path
+sys.path.append(os.path.dirname(os.path.abspath(__file__)))
+
+from openwebui_community_client import get_client
+
+
+def find_local_plugin_by_id(plugins_dir: str, post_id: str) -> str | None:
+    """根据 post_id 查找本地插件文件"""
+    for root, _, files in os.walk(plugins_dir):
+        for file in files:
+            if file.endswith(".py"):
+                file_path = os.path.join(root, file)
+                with open(file_path, "r", encoding="utf-8") as f:
+                    content = f.read(2000)
+
+                id_match = re.search(
+                    r"(?:openwebui_id|post_id):\s*([a-z0-9-]+)", content
+                )
+                if id_match and id_match.group(1).strip() == post_id:
+                    return file_path
+    return None
+
+
+def download_image(url: str, save_path: str) -> bool:
+    """下载图片"""
+    try:
+        response = requests.get(url, timeout=30)
+        response.raise_for_status()
+        with open(save_path, "wb") as f:
+            f.write(response.content)
+        return True
+    except Exception as e:
+        print(f"  Error downloading: {e}")
+        return False
+
+
+def get_image_extension(url: str) -> str:
+    """从 URL 获取图片扩展名"""
+    parsed = urlparse(url)
+    path = parsed.path
+    ext = os.path.splitext(path)[1].lower()
+    if ext in [".png", ".jpg", ".jpeg", ".gif", ".webp"]:
+        return ext
+    return ".png"  # 默认
+
+
+def main():
+    try:
+        client = get_client()
+    except ValueError as e:
+        print(f"Error: {e}")
+        sys.exit(1)
+
+    base_dir = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+    plugins_dir = os.path.join(base_dir, "plugins")
+
+    print("Fetching remote posts from OpenWebUI Community...")
+    posts = client.get_all_posts()
+    print(f"Found {len(posts)} remote posts.\n")
+
+    downloaded = 0
+    skipped = 0
+    not_found = 0
+
+    for post in posts:
+        post_id = post.get("id")
+        title = post.get("title", "Unknown")
+        media = post.get("media", [])
+
+        if not media:
+            continue
+
+        # 只取第一张图片
+        first_media = media[0] if isinstance(media, list) else media
+
+        # 处理字典格式 {'url': '...', 'type': 'image'}
+        if isinstance(first_media, dict):
+            image_url = first_media.get("url")
+        else:
+            image_url = first_media
+
+        if not image_url:
+            continue
+
+        print(f"Processing: {title}")
+        print(f"  Image URL: {image_url}")
+
+        # 查找对应的本地插件
+        local_plugin = find_local_plugin_by_id(plugins_dir, post_id)
+        if not local_plugin:
+            print(f"  ⚠️  No local plugin found for ID: {post_id}")
+            not_found += 1
+            continue
+
+        # 确定保存路径
+        plugin_dir = os.path.dirname(local_plugin)
+        plugin_name = os.path.splitext(os.path.basename(local_plugin))[0]
+        ext = get_image_extension(image_url)
+        save_path = os.path.join(plugin_dir, plugin_name + ext)
+
+        # 检查是否已存在
+        if os.path.exists(save_path):
+            print(f"  ⏭️  Image already exists: {os.path.basename(save_path)}")
+            skipped += 1
+            continue
+
+        # 下载
+        print(f"  Downloading to: {save_path}")
+        if download_image(image_url, save_path):
+            print(f"  ✅ Downloaded: {os.path.basename(save_path)}")
+            downloaded += 1
+        else:
+            print(f"  ❌ Failed to download")
+
+    print(f"\n{'='*50}")
+    print(
+        f"Finished: {downloaded} downloaded, {skipped} skipped, {not_found} not found locally"
+    )
+
+
+if __name__ == "__main__":
+    main()
--- a/scripts/openwebui_community_client.py
+++ b/scripts/openwebui_community_client.py
@@ -47,9 +47,15 @@ class OpenWebUICommunityClient:
            "Content-Type": "application/json",
            "Accept": "application/json",
        }
+        # 如果没有 user_id，尝试通过 API 获取
+        if not self.user_id:
+            self.user_id = self._get_user_id_from_api()

    def _parse_user_id_from_token(self, token: str) -> Optional[str]:
        """从 JWT Token 中解析用户 ID"""
+        # sk- 开头的是 API Key，无法解析用户 ID
+        if token.startswith("sk-"):
+            return None
        try:
            parts = token.split(".")
            if len(parts) >= 2:
@@ -65,6 +71,17 @@ class OpenWebUICommunityClient:
            pass
        return None

+    def _get_user_id_from_api(self) -> Optional[str]:
+        """通过 API 获取当前用户 ID"""
+        try:
+            url = f"{self.BASE_URL}/auths/"
+            response = requests.get(url, headers=self.headers)
+            response.raise_for_status()
+            data = response.json()
+            return data.get("id")
+        except Exception:
+            return None
+
    # ========== 帖子/插件获取 ==========

    def get_user_posts(self, sort: str = "new", page: int = 1) -> List[Dict]:
@@ -78,7 +95,7 @@ class OpenWebUICommunityClient:
        Returns:
            帖子列表
        """
-        url = f"{self.BASE_URL}/posts/user/{self.user_id}?sort={sort}&page={page}"
+        url = f"{self.BASE_URL}/posts/users/{self.user_id}?sort={sort}&page={page}"
        response = requests.get(url, headers=self.headers)
        response.raise_for_status()
        return response.json()
@@ -115,6 +132,113 @@ class OpenWebUICommunityClient:
                return None
            raise

+    # ========== 帖子/插件创建 ==========
+
+    def create_post(
+        self,
+        title: str,
+        content: str,
+        post_type: str = "function",
+        data: Optional[Dict] = None,
+        media: Optional[List[str]] = None,
+    ) -> Optional[Dict]:
+        """
+        创建新帖子
+
+        Args:
+            title: 帖子标题
+            content: 帖子内容（README/描述）
+            post_type: 帖子类型 (function/tool/filter/pipeline)
+            data: 插件数据结构
+            media: 图片 URL 列表
+
+        Returns:
+            创建成功返回帖子数据，失败返回 None
+        """
+        try:
+            url = f"{self.BASE_URL}/posts/create"
+
+            # 将字符串 URL 转换为字典格式 (API 要求)
+            media_list = []
+            if media:
+                for item in media:
+                    if isinstance(item, str):
+                        media_list.append({"url": item})
+                    elif isinstance(item, dict):
+                        media_list.append(item)
+
+            payload = {
+                "title": title,
+                "content": content,
+                "type": post_type,
+                "data": data or {},
+                "media": media_list,
+            }
+            print(f"  [DEBUG] Payload keys: {list(payload.keys())}")
+            print(
+                f"  [DEBUG] media format: {media_list[:1] if media_list else 'empty'}"
+            )
+            response = requests.post(url, headers=self.headers, json=payload)
+            if response.status_code != 200:
+                print(f"  [DEBUG] Response status: {response.status_code}")
+                print(f"  [DEBUG] Response body: {response.text[:500]}")
+            response.raise_for_status()
+            return response.json()
+        except Exception as e:
+            print(f"  Error creating post: {e}")
+            return None
+
+    def create_plugin(
+        self,
+        title: str,
+        source_code: str,
+        readme_content: Optional[str] = None,
+        metadata: Optional[Dict] = None,
+        media_urls: Optional[List[str]] = None,
+        plugin_type: str = "action",
+    ) -> Optional[str]:
+        """
+        创建新插件帖子
+
+        Args:
+            title: 插件标题
+            source_code: 插件源代码
+            readme_content: README 内容
+            metadata: 插件元数据
+            media_urls: 图片 URL 列表
+            plugin_type: 插件类型 (action/filter/pipe)
+
+        Returns:
+            创建成功返回帖子 ID，失败返回 None
+        """
+        # 构建 function 数据结构
+        function_data = {
+            "id": "",  # 服务器会生成
+            "name": title,
+            "type": plugin_type,
+            "content": source_code,
+            "meta": {
+                "description": metadata.get("description", "") if metadata else "",
+                "manifest": metadata or {},
+            },
+        }
+
+        data = {"function": function_data}
+
+        result = self.create_post(
+            title=title,
+            content=(
+                readme_content or metadata.get("description", "") if metadata else ""
+            ),
+            post_type="function",
+            data=data,
+            media=media_urls,
+        )
+
+        if result:
+            return result.get("id")
+        return None
+
    # ========== 帖子/插件更新 ==========

    def update_post(self, post_id: str, post_data: Dict) -> bool:
@@ -139,15 +263,17 @@ class OpenWebUICommunityClient:
        source_code: str,
        readme_content: Optional[str] = None,
        metadata: Optional[Dict] = None,
+        media_urls: Optional[List[str]] = None,
    ) -> bool:
        """
-        更新插件（代码 + README + 元数据）
+        更新插件（代码 + README + 元数据 + 图片）

        Args:
            post_id: 帖子 ID
            source_code: 插件源代码
            readme_content: README 内容（用于社区页面展示）
            metadata: 插件元数据（title, version, description 等）
+            media_urls: 图片 URL 列表

        Returns:
            是否成功
@@ -184,8 +310,63 @@ class OpenWebUICommunityClient:
                    "description"
                ]

+        # 更新图片
+        if media_urls:
+            post_data["media"] = media_urls
+
        return self.update_post(post_id, post_data)

+    # ========== 图片上传 ==========
+
+    def upload_image(self, file_path: str) -> Optional[str]:
+        """
+        上传图片到 OpenWebUI 社区
+
+        Args:
+            file_path: 图片文件路径
+
+        Returns:
+            上传成功后的图片 URL，失败返回 None
+        """
+        if not os.path.exists(file_path):
+            return None
+
+        # 获取文件信息
+        filename = os.path.basename(file_path)
+
+        # 根据文件扩展名确定 MIME 类型
+        ext = os.path.splitext(filename)[1].lower()
+        mime_types = {
+            ".png": "image/png",
+            ".jpg": "image/jpeg",
+            ".jpeg": "image/jpeg",
+            ".gif": "image/gif",
+            ".webp": "image/webp",
+        }
+        content_type = mime_types.get(ext, "application/octet-stream")
+
+        try:
+            with open(file_path, "rb") as f:
+                files = {"file": (filename, f, content_type)}
+                # 上传时不使用 JSON Content-Type
+                headers = {
+                    "Authorization": f"Bearer {self.api_key}",
+                    "Accept": "application/json",
+                }
+                response = requests.post(
+                    f"{self.BASE_URL}/files/",
+                    headers=headers,
+                    files=files,
+                )
+                response.raise_for_status()
+                result = response.json()
+
+                # 返回图片 URL
+                return result.get("url")
+        except Exception as e:
+            print(f"  Warning: Failed to upload image: {e}")
+            return None
+
    # ========== 版本比较 ==========

    def get_remote_version(self, post_id: str) -> Optional[str]:
@@ -228,14 +409,15 @@ class OpenWebUICommunityClient:
    # ========== 插件发布 ==========

    def publish_plugin_from_file(
-        self, file_path: str, force: bool = False
+        self, file_path: str, force: bool = False, auto_create: bool = True
    ) -> Tuple[bool, str]:
        """
-        从文件发布插件
+        从文件发布插件（支持首次创建和更新）

        Args:
            file_path: 插件文件路径
            force: 是否强制更新（忽略版本检查）
+            auto_create: 如果没有 openwebui_id，是否自动创建新帖子

        Returns:
            (是否成功, 消息)
@@ -247,30 +429,96 @@ class OpenWebUICommunityClient:
        if not metadata:
            return False, "No frontmatter found"

+        title = metadata.get("title")
+        if not title:
+            return False, "No title in frontmatter"
+
        post_id = metadata.get("openwebui_id") or metadata.get("post_id")
-        if not post_id:
-            return False, "No openwebui_id found"
-
        local_version = metadata.get("version")

-        # 版本检查
-        if not force and local_version:
-            if not self.version_needs_update(post_id, local_version):
-                return True, f"Skipped: version {local_version} matches remote"
-
        # 查找 README
        readme_content = self._find_readme(file_path)

+        # 查找并上传图片
+        media_urls = None
+        image_path = self._find_image(file_path)
+        if image_path:
+            print(f"  Found image: {os.path.basename(image_path)}")
+            image_url = self.upload_image(image_path)
+            if image_url:
+                print(f"  Uploaded image: {image_url}")
+                media_urls = [image_url]
+
+        # 如果没有 post_id，尝试创建新帖子
+        if not post_id:
+            if not auto_create:
+                return False, "No openwebui_id found and auto_create is disabled"
+
+            print(f"  Creating new post for: {title}")
+            new_post_id = self.create_plugin(
+                title=title,
+                source_code=content,
+                readme_content=readme_content or metadata.get("description", ""),
+                metadata=metadata,
+                media_urls=media_urls,
+            )
+
+            if new_post_id:
+                # 将新 ID 写回本地文件
+                self._inject_id_to_file(file_path, new_post_id)
+                return True, f"Created new post (ID: {new_post_id})"
+            return False, "Failed to create new post"
+
+        # 获取远程帖子信息（只需获取一次）
+        remote_post = None
+        if post_id:
+            remote_post = self.get_post(post_id)
+
+        # 版本检查（仅对更新有效）
+        if not force and local_version and remote_post:
+            remote_version = (
+                remote_post.get("data", {})
+                .get("function", {})
+                .get("meta", {})
+                .get("manifest", {})
+                .get("version")
+            )
+
+            version_changed = local_version != remote_version
+
+            # 检查 README 是否变化
+            readme_changed = False
+            remote_content = remote_post.get("content", "")
+            local_content = readme_content or metadata.get("description", "")
+
+            # 简单的内容比较 (去除首尾空白)
+            if (local_content or "").strip() != (remote_content or "").strip():
+                readme_changed = True
+
+            if not version_changed and not readme_changed:
+                return (
+                    True,
+                    f"Skipped: version {local_version} matches remote and no README changes",
+                )
+
+            if readme_changed and not version_changed:
+                print(
+                    f"  ℹ️  Version match ({local_version}) but README changed. Updating..."
+                )
+
        # 更新
        success = self.update_plugin(
            post_id=post_id,
            source_code=content,
            readme_content=readme_content or metadata.get("description", ""),
            metadata=metadata,
+            media_urls=media_urls,
        )

        if success:
-            return True, f"Updated to version {local_version}"
+            if local_version:
+                return True, f"Updated to version {local_version}"
+            return True, "Updated plugin"
        return False, "Update failed"

    def _parse_frontmatter(self, content: str) -> Dict[str, str]:
@@ -307,6 +555,77 @@ class OpenWebUICommunityClient:
                    return f.read()
        return None

+    def _find_image(self, plugin_file_path: str) -> Optional[str]:
+        """
+        查找插件对应的图片文件
+        图片名称需要和插件文件名一致（不含扩展名）
+
+        例如：
+            export_to_word.py -> export_to_word.png / export_to_word.jpg
+        """
+        plugin_dir = os.path.dirname(plugin_file_path)
+        plugin_name = os.path.splitext(os.path.basename(plugin_file_path))[0]
+
+        # 支持的图片格式
+        image_extensions = [".png", ".jpg", ".jpeg", ".gif", ".webp"]
+
+        for ext in image_extensions:
+            image_path = os.path.join(plugin_dir, plugin_name + ext)
+            if os.path.exists(image_path):
+                return image_path
+        return None
+
+    def _inject_id_to_file(self, file_path: str, post_id: str) -> bool:
+        """
+        将新创建的帖子 ID 写回本地插件文件的 frontmatter
+
+        Args:
+            file_path: 插件文件路径
+            post_id: 新创建的帖子 ID
+
+        Returns:
+            是否成功
+        """
+        try:
+            with open(file_path, "r", encoding="utf-8") as f:
+                lines = f.readlines()
+
+            new_lines = []
+            inserted = False
+            in_frontmatter = False
+
+            for line in lines:
+                # Check for start/end of frontmatter
+                if line.strip() == '"""':
+                    if not in_frontmatter:
+                        in_frontmatter = True
+                    else:
+                        in_frontmatter = False
+
+                new_lines.append(line)
+
+                # Insert after version line
+                if (
+                    in_frontmatter
+                    and not inserted
+                    and line.strip().startswith("version:")
+                ):
+                    new_lines.append(f"openwebui_id: {post_id}\n")
+                    inserted = True
+                    print(f"  Injected openwebui_id: {post_id}")
+
+            if inserted:
+                with open(file_path, "w", encoding="utf-8") as f:
+                    f.writelines(new_lines)
+                return True
+
+            print(f"  Warning: Could not inject ID (no version line found)")
+            return False
+
+        except Exception as e:
+            print(f"  Error injecting ID to file: {e}")
+            return False
+
    # ========== 统计功能 ==========

    def generate_stats(self, posts: List[Dict]) -> Dict:
--- a/scripts/openwebui_stats.py
+++ b/scripts/openwebui_stats.py
@@ -157,7 +157,10 @@ class OpenWebUIStats:
            stats["total_comments"] += post.get("commentCount", 0)

            # 解析 data 字段 - 正确路径: data.function.meta
-            function_data = post.get("data", {}).get("function", {})
+            function_data = post.get("data", {})
+            if function_data is None:
+                function_data = {}
+            function_data = function_data.get("function", {})
            meta = function_data.get("meta", {})
            manifest = meta.get("manifest", {})
            post_type = meta.get("type", function_data.get("type", "unknown"))
@@ -331,6 +334,67 @@ class OpenWebUIStats:
            json.dump(stats, f, ensure_ascii=False, indent=2)
        print(f"✅ JSON 数据已保存到: {filepath}")

+    def generate_shields_endpoints(self, stats: dict, output_dir: str = "docs/badges"):
+        """
+        生成 Shields.io endpoint JSON 文件
+
+        Args:
+            stats: 统计数据
+            output_dir: 输出目录
+        """
+        Path(output_dir).mkdir(parents=True, exist_ok=True)
+
+        def format_number(n: int) -> str:
+            """格式化数字为易读格式"""
+            if n >= 1000000:
+                return f"{n/1000000:.1f}M"
+            elif n >= 1000:
+                return f"{n/1000:.1f}k"
+            return str(n)
+
+        # 各种徽章数据
+        badges = {
+            "downloads": {
+                "schemaVersion": 1,
+                "label": "downloads",
+                "message": format_number(stats["total_downloads"]),
+                "color": "blue",
+                "namedLogo": "openwebui",
+            },
+            "plugins": {
+                "schemaVersion": 1,
+                "label": "plugins",
+                "message": str(stats["total_posts"]),
+                "color": "green",
+            },
+            "followers": {
+                "schemaVersion": 1,
+                "label": "followers",
+                "message": format_number(stats.get("user", {}).get("followers", 0)),
+                "color": "blue",
+            },
+            "points": {
+                "schemaVersion": 1,
+                "label": "points",
+                "message": format_number(stats.get("user", {}).get("total_points", 0)),
+                "color": "orange",
+            },
+            "upvotes": {
+                "schemaVersion": 1,
+                "label": "upvotes",
+                "message": format_number(stats["total_upvotes"]),
+                "color": "brightgreen",
+            },
+        }
+
+        for name, data in badges.items():
+            filepath = Path(output_dir) / f"{name}.json"
+            with open(filepath, "w", encoding="utf-8") as f:
+                json.dump(data, f, indent=2)
+            print(f"  📊 Generated badge: {name}.json")
+
+        print(f"✅ Shields.io endpoints saved to: {output_dir}/")
+
    def generate_readme_stats(self, stats: dict, lang: str = "zh") -> str:
        """
        生成 README 统计徽章区域
@@ -537,6 +601,10 @@ def main():
    json_path = script_dir / "docs" / "community-stats.json"
    stats_client.save_json(stats, str(json_path))

+    # 生成 Shields.io endpoint JSON (用于动态徽章)
+    badges_dir = script_dir / "docs" / "badges"
+    stats_client.generate_shields_endpoints(stats, str(badges_dir))
+
    # 更新 README 文件
    readme_path = script_dir / "README.md"
    readme_cn_path = script_dir / "README_CN.md"
--- a/scripts/publish_plugin.py
+++ b/scripts/publish_plugin.py
@@ -3,8 +3,10 @@ Publish plugins to OpenWebUI Community
 使用 OpenWebUICommunityClient 发布插件到官方社区

 用法：
-    python scripts/publish_plugin.py          # 只更新有版本变化的插件
-    python scripts/publish_plugin.py --force  # 强制更新所有插件
+    python scripts/publish_plugin.py                              # 更新已发布的插件（版本变化时）
+    python scripts/publish_plugin.py --force                      # 强制更新所有已发布的插件
+    python scripts/publish_plugin.py --new plugins/actions/xxx    # 首次发布指定目录的新插件
+    python scripts/publish_plugin.py --new plugins/actions/xxx --force  # 强制发布新插件
 """

 import os
@@ -15,34 +17,111 @@ import argparse
 # Add current directory to path
 sys.path.append(os.path.dirname(os.path.abspath(__file__)))

-from openwebui_community_client import OpenWebUICommunityClient, get_client
+from openwebui_community_client import get_client


-def find_plugins_with_id(plugins_dir: str) -> list:
-    """查找所有带 openwebui_id 的插件文件"""
+def find_existing_plugins(plugins_dir: str) -> list:
+    """查找所有已发布的插件文件（有 openwebui_id 的）"""
    plugins = []
    for root, _, files in os.walk(plugins_dir):
        for file in files:
-            if file.endswith(".py"):
+            if file.endswith(".py") and not file.startswith("__"):
                file_path = os.path.join(root, file)
                with open(file_path, "r", encoding="utf-8") as f:
-                    content = f.read(2000)  # 只读前 2000 字符检查 ID
+                    content = f.read(2000)

                id_match = re.search(
                    r"(?:openwebui_id|post_id):\s*([a-z0-9-]+)", content
                )
                if id_match:
                    plugins.append(
-                        {"file_path": file_path, "post_id": id_match.group(1).strip()}
+                        {
+                            "file_path": file_path,
+                            "post_id": id_match.group(1).strip(),
+                        }
                    )
    return plugins


+def find_new_plugins_in_dir(target_dir: str) -> list:
+    """查找指定目录中没有 openwebui_id 的新插件"""
+    plugins = []
+
+    if not os.path.isdir(target_dir):
+        print(f"Error: {target_dir} is not a directory")
+        return plugins
+
+    for file in os.listdir(target_dir):
+        if file.endswith(".py") and not file.startswith("__"):
+            file_path = os.path.join(target_dir, file)
+            if not os.path.isfile(file_path):
+                continue
+
+            with open(file_path, "r", encoding="utf-8") as f:
+                content = f.read(2000)
+
+            # 检查是否有 frontmatter (title)
+            title_match = re.search(r"title:\s*(.+)", content)
+            if not title_match:
+                continue
+
+            # 检查是否已有 ID
+            id_match = re.search(r"(?:openwebui_id|post_id):\s*([a-z0-9-]+)", content)
+            if id_match:
+                print(f"  ⚠️  {file} already has ID, will update instead")
+                plugins.append(
+                    {
+                        "file_path": file_path,
+                        "title": title_match.group(1).strip(),
+                        "post_id": id_match.group(1).strip(),
+                        "is_new": False,
+                    }
+                )
+            else:
+                plugins.append(
+                    {
+                        "file_path": file_path,
+                        "title": title_match.group(1).strip(),
+                        "post_id": None,
+                        "is_new": True,
+                    }
+                )
+
+    return plugins
+
+
 def main():
-    parser = argparse.ArgumentParser(description="Publish plugins to OpenWebUI Market")
+    parser = argparse.ArgumentParser(
+        description="Publish plugins to OpenWebUI Market",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""
+Examples:
+  # Update existing plugins (with version check)
+  python scripts/publish_plugin.py
+
+  # Force update all existing plugins
+  python scripts/publish_plugin.py --force
+
+  # Publish new plugins from a specific directory
+  python scripts/publish_plugin.py --new plugins/actions/summary
+
+  # Preview what would be done
+  python scripts/publish_plugin.py --new plugins/actions/summary --dry-run
+        """,
+    )
    parser.add_argument(
        "--force", action="store_true", help="Force update even if version matches"
    )
+    parser.add_argument(
+        "--new",
+        metavar="DIR",
+        help="Publish new plugins from the specified directory (required for first-time publishing)",
+    )
+    parser.add_argument(
+        "--dry-run",
+        action="store_true",
+        help="Show what would be done without actually publishing",
+    )
    args = parser.parse_args()

    try:
@@ -54,35 +133,99 @@ def main():
    base_dir = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
    plugins_dir = os.path.join(base_dir, "plugins")

-    plugins = find_plugins_with_id(plugins_dir)
-    print(f"Found {len(plugins)} plugins with OpenWebUI ID.\n")
-
    updated = 0
+    created = 0
    skipped = 0
    failed = 0

-    for plugin in plugins:
-        file_path = plugin["file_path"]
-        file_name = os.path.basename(file_path)
-        post_id = plugin["post_id"]
+    # 处理新插件发布
+    if args.new:
+        target_dir = args.new
+        if not os.path.isabs(target_dir):
+            target_dir = os.path.join(base_dir, target_dir)

-        print(f"Processing {file_name} (ID: {post_id})...")
+        print(f"🆕 Publishing new plugins from: {target_dir}\n")
+        new_plugins = find_new_plugins_in_dir(target_dir)

-        success, message = client.publish_plugin_from_file(file_path, force=args.force)
+        if not new_plugins:
+            print("No plugins found in the specified directory.")
+            return

-        if success:
-            if "Skipped" in message:
-                print(f"  ⏭️  {message}")
-                skipped += 1
+        for plugin in new_plugins:
+            file_path = plugin["file_path"]
+            file_name = os.path.basename(file_path)
+            title = plugin["title"]
+            is_new = plugin.get("is_new", True)
+
+            if is_new:
+                print(f"🆕 Creating: {file_name} ({title})")
            else:
-                print(f"  ✅ {message}")
-                updated += 1
-        else:
-            print(f"  ❌ {message}")
-            failed += 1
+                print(f"📦 Updating: {file_name} (ID: {plugin['post_id'][:8]}...)")
+
+            if args.dry_run:
+                print(f"  [DRY-RUN] Would {'create' if is_new else 'update'}")
+                continue
+
+            success, message = client.publish_plugin_from_file(
+                file_path, force=args.force, auto_create=True
+            )
+
+            if success:
+                if "Created" in message:
+                    print(f"  🎉 {message}")
+                    created += 1
+                elif "Skipped" in message:
+                    print(f"  ⏭️  {message}")
+                    skipped += 1
+                else:
+                    print(f"  ✅ {message}")
+                    updated += 1
+            else:
+                print(f"  ❌ {message}")
+                failed += 1
+
+    # 处理已有插件更新
+    else:
+        existing_plugins = find_existing_plugins(plugins_dir)
+        print(f"Found {len(existing_plugins)} existing plugins with OpenWebUI ID.\n")
+
+        if not existing_plugins:
+            print("No existing plugins to update.")
+            print(
+                "\n💡 Tip: Use --new <dir> to publish new plugins from a specific directory"
+            )
+            return
+
+        for plugin in existing_plugins:
+            file_path = plugin["file_path"]
+            file_name = os.path.basename(file_path)
+            post_id = plugin["post_id"]
+
+            print(f"📦 {file_name} (ID: {post_id[:8]}...)")
+
+            if args.dry_run:
+                print(f"  [DRY-RUN] Would update")
+                continue
+
+            success, message = client.publish_plugin_from_file(
+                file_path, force=args.force, auto_create=False  # 不自动创建，只更新
+            )
+
+            if success:
+                if "Skipped" in message:
+                    print(f"  ⏭️  {message}")
+                    skipped += 1
+                else:
+                    print(f"  ✅ {message}")
+                    updated += 1
+            else:
+                print(f"  ❌ {message}")
+                failed += 1

    print(f"\n{'='*50}")
-    print(f"Finished: {updated} updated, {skipped} skipped, {failed} failed")
+    print(
+        f"Finished: {created} created, {updated} updated, {skipped} skipped, {failed} failed"
+    )


 if __name__ == "__main__":
Author	SHA1	Message	Date
Jeff	06e8d30900	Merge pull request #20 from Fu-Jie/copilot/fix-session-alias-errors Harden async context compression against new DB session alias and runtime edge cases	2026-01-11 17:26:03 +08:00
fujie	cbf2ff7f93	chore: release async-context-compression v1.1.2 - Enhanced error reporting via status bar and console - Robust model ID handling - Open WebUI v0.7.x compatibility (dynamic DB session) - Updated documentation and version bumps	2026-01-11 17:25:07 +08:00
copilot-swe-agent[bot]	abbe3fb248	chore: centralize chat_id extraction helper Co-authored-by: Fu-Jie <33599649+Fu-Jie@users.noreply.github.com>	2026-01-11 08:36:13 +00:00
copilot-swe-agent[bot]	7e44dde979	chore: add discovery docstrings Co-authored-by: Fu-Jie <33599649+Fu-Jie@users.noreply.github.com>	2026-01-11 08:31:10 +00:00
copilot-swe-agent[bot]	3649d75539	chore: add discovery debug logs Co-authored-by: Fu-Jie <33599649+Fu-Jie@users.noreply.github.com>	2026-01-11 08:30:02 +00:00
copilot-swe-agent[bot]	d3b4219a9a	chore: refine db session discovery messaging Co-authored-by: Fu-Jie <33599649+Fu-Jie@users.noreply.github.com>	2026-01-11 08:28:52 +00:00
copilot-swe-agent[bot]	9e98d55e11	fix: make async compression db session discovery robust Co-authored-by: Fu-Jie <33599649+Fu-Jie@users.noreply.github.com>	2026-01-11 08:27:36 +00:00
copilot-swe-agent[bot]	4b8515f682	fix: ensure empty summary model skips compression Co-authored-by: Fu-Jie <33599649+Fu-Jie@users.noreply.github.com>	2026-01-11 08:25:33 +00:00
copilot-swe-agent[bot]	d2f35ce396	fix: harden async compression compatibility Co-authored-by: Fu-Jie <33599649+Fu-Jie@users.noreply.github.com>	2026-01-11 08:24:56 +00:00
copilot-swe-agent[bot]	f479f23b38	Initial plan	2026-01-11 08:19:33 +00:00
github-actions[bot]	51048f9e5d	chore: update community stats 2026-01-10	2026-01-10 18:11:03 +00:00
github-actions[bot]	1118ae34c4	chore: update community stats 2026-01-10	2026-01-10 14:07:43 +00:00
github-actions[bot]	7a5e1a4e12	chore: update community stats 2026-01-10	2026-01-10 12:12:24 +00:00
fujie	8e377e1794	Update Copilot instructions: Limit What's New section to latest 3 updates	2026-01-10 19:09:09 +08:00
fujie	d66360b02d	Update READMEs with v1.1.1 release notes	2026-01-10 19:07:49 +08:00
fujie	1ece648006	Update Async Context Compression docs to v1.1.1 and improve plugin update logic to detect README changes	2026-01-10 19:07:49 +08:00
github-actions[bot]	a262a716a3	chore: update community stats 2026-01-10	2026-01-10 11:06:57 +00:00
fujie	06fdfee182	Update context enhancement filter	2026-01-10 18:47:35 +08:00
fujie	7085e794a3	Update Async Context Compression to v1.1.1: Add frontend debug logging and optimize token calculation	2026-01-10 18:47:35 +08:00
github-actions[bot]	a9cae535eb	chore: update community stats 2026-01-10	2026-01-10 09:08:08 +00:00
github-actions[bot]	bdbd0d98be	chore: update community stats 2026-01-10	2026-01-10 08:24:17 +00:00
fujie	51612ea783	Fix AttributeError in stats script: handle NoneType data field	2026-01-10 16:19:44 +08:00
fujie	baf364a85f	Fix mkdocs build warnings: remove references to missing summary.md	2026-01-10 16:09:42 +08:00
fujie	f78e703a99	Fix Mermaid syntax normalization: preserve quoted strings and prevent false positives	2026-01-10 16:07:19 +08:00
fujie	aabb24c9cd	docs: update READMEs for markdown normalizer	2026-01-10 15:53:36 +08:00
fujie	ef34cc326c	feat: enhance markdown normalizer with mermaid fix and frontend logging	2026-01-10 15:45:20 +08:00
fujie	5fa56ba88d	docs: add frontend console debugging guide and mermaid syntax standards	2026-01-10 15:41:17 +08:00
github-actions[bot]	b71df8ef43	chore: update community stats 2026-01-09	2026-01-09 12:14:41 +00:00
fujie	8c6fe6784e	chore: only commit stats when points change	2026-01-08 23:21:04 +08:00
github-actions[bot]	29fa5bae29	chore: update community stats 2026-01-08	2026-01-08 15:10:19 +00:00
github-actions[bot]	dab465d924	chore: update community stats 2026-01-08	2026-01-08 14:43:27 +00:00
fujie	77c0defe93	feat: smart commit for stats - only commit when data actually changes - Keep detailed stats tables in README - Compare downloads/posts/upvotes before committing - Skip commit if no actual data change (only time updated)	2026-01-08 22:35:53 +08:00
fujie	80cf2b5a52	feat: switch to dynamic badges - no more stats commits - Replace README stats tables with Shields.io dynamic badges - Badges data stored in GitHub Gist (ID: 7beb87fdc36bf10408282b1db495fe55) - Workflow only uploads to Gist, never commits to main branch - Stats refresh hourly via GitHub Actions	2026-01-08 22:33:46 +08:00
fujie	96638d8092	feat: smart commit for community-stats - only commit when data changes - Add generate_shields_endpoints() for dynamic badges - Update workflow to check for significant changes before commit - Support uploading badge JSON to GitHub Gist - Reduce unnecessary commits from hourly to only when data changes	2026-01-08 22:29:02 +08:00
github-actions[bot]	21ad55ae55	chore: update community stats 2026-01-08	2026-01-08 14:10:16 +00:00
github-actions[bot]	530a6cd463	chore: update community stats 2026-01-08	2026-01-08 13:20:58 +00:00
github-actions[bot]	8615773b67	chore: update community stats 2026-01-08	2026-01-08 12:15:27 +00:00
github-actions[bot]	16eaec64b7	chore: update community stats 2026-01-08	2026-01-08 11:09:14 +00:00
github-actions[bot]	8558077dfe	chore: update community stats 2026-01-08	2026-01-08 10:10:15 +00:00
github-actions[bot]	a15353ea52	chore: update community stats 2026-01-08	2026-01-08 09:12:19 +00:00
github-actions[bot]	5b44e3e688	chore: update community stats 2026-01-08	2026-01-08 08:12:10 +00:00
github-actions[bot]	a4b3628e01	chore: update community stats 2026-01-08	2026-01-08 07:11:35 +00:00
github-actions[bot]	bbb7db3878	chore: update community stats 2026-01-08	2026-01-08 06:13:29 +00:00
github-actions[bot]	dec2bbb4bf	chore: update community stats 2026-01-08	2026-01-08 05:11:27 +00:00
github-actions[bot]	6a241b0ae0	chore: update community stats 2026-01-08	2026-01-08 04:22:44 +00:00
github-actions[bot]	51c53e0ed0	chore: update community stats 2026-01-08	2026-01-08 03:37:14 +00:00
github-actions[bot]	8cb6382e72	chore: update community stats 2026-01-08	2026-01-08 02:45:58 +00:00
github-actions[bot]	5889471e82	chore: update community stats 2026-01-08	2026-01-08 01:36:56 +00:00
fujie	ca2e0b4fba	fix: convert media URLs to dict format for create_post API	2026-01-08 08:44:41 +08:00
fujie	10d24fbfa2	debug: add detailed error logging for create_post	2026-01-08 08:41:50 +08:00
fujie	322bd6e167	chore: cleanup legacy plugins and add plugin assets - Remove deprecated summary plugin (replaced by deep-dive) - Remove js-render-poc experimental plugin - Add plugin preview images - Update publish scripts with create_plugin support	2026-01-08 08:39:21 +08:00