feat(smart-mind-map-tool): initial release v1.0.0 with adaptive Rich UI

- Convert Plugin Name from text input to dropdown with all plugins
- Add Tool type option to match bug report template
- Merge Alternatives Considered into Additional Information section
- Combine Motivation fields into single Motivation & Use Case field
- Reduce from 7 to 5 key fields for better UX
- Keep all critical information for feature evaluation
- Consistent structure with bug report template

.agent/rules/antigravity.md

@@ -0,0 +1,147 @@
+---
+description: >
+  Antigravity development mode rules. Apply when the user requests high-speed iteration,
+  a quick prototype, or says "反重力开发" / "antigravity mode".
+globs: "plugins/**/*.py"
+always_on: false
+---
+# Antigravity Development Mode
+
+> High-speed delivery + strict reversibility. Every decision must keep both roll-forward and rollback feasible.
+
+---
+
+## Core Principles
+
+1. **Small, isolated edits** — one logical change per operation; no mixing refactor + feature.
+2. **Deterministic interfaces** — function signatures and return shapes must not change without an explicit contract update.
+3. **Multi-level fallback** — every I/O path has a degraded alternative (e.g., S3 → local → DB).
+4. **Reversible by default** — every file write, API call, or schema change must have an undo path recorded or be idempotent.
+
+---
+
+## Mandatory Safety Patterns
+
+### 1. Timeout Guards on All Frontend Calls
+
+Any `__event_call__` or `__event_emitter__` JS execution MUST be wrapped:
+
+```python
+import asyncio
+
+try:
+    result = await asyncio.wait_for(
+        __event_call__({"type": "execute", "data": {"code": js_code}}),
+        timeout=2.0
+    )
+except asyncio.TimeoutError:
+    logger.warning("Frontend JS execution timed out; falling back.")
+    result = fallback_value
+except Exception as e:
+    logger.error(f"Frontend call failed: {e}", exc_info=True)
+    result = fallback_value
+```
+
+JS side must also guard internally:
+
+```javascript
+try {
+    return (localStorage.getItem('locale') || navigator.language || 'en-US');
+} catch (e) {
+    return 'en-US';
+}
+```
+
+### 2. Path Sandbox Validation
+
+Resolve every workspace path and verify it stays inside the repo root:
+
+```python
+import os
+
+def _validate_workspace_path(path: str, workspace_root: str) -> str:
+    resolved = os.path.realpath(os.path.abspath(path))
+    root = os.path.realpath(workspace_root)
+    if not resolved.startswith(root + os.sep) and resolved != root:
+        raise PermissionError(f"Path escape detected: {resolved} is outside {root}")
+    return resolved
+```
+
+### 3. Dual-Channel Upload Fallback
+
+Always try API first; fall back to DB/local on failure:
+
+```python
+async def _upload_file(self, filename: str, content: bytes) -> str:
+    # Channel 1: API upload (S3-compatible)
+    try:
+        url = await self._api_upload(filename, content)
+        if url:
+            return url
+    except Exception as e:
+        logger.warning(f"API upload failed: {e}; falling back to local.")
+
+    # Channel 2: Local file + DB registration
+    return await self._local_db_upload(filename, content)
+```
+
+### 4. Progressive Status Reporting
+
+For tasks > 3 seconds, emit staged updates:
+
+```python
+await self._emit_status(emitter, "正在分析内容...", done=False)
+# ... phase 1 ...
+await self._emit_status(emitter, "正在生成输出...", done=False)
+# ... phase 2 ...
+await self._emit_status(emitter, "完成", done=True)
+```
+
+Always emit `done=True` on completion and `notification(error)` on failure.
+
+### 5. Emitter Guard
+
+Check before every emit to prevent crashes on missing emitter:
+
+```python
+if emitter and self.valves.SHOW_STATUS:
+    await emitter({"type": "status", "data": {"description": msg, "done": done}})
+```
+
+### 6. Exception Surface Rule
+
+Never swallow exceptions silently. Every `except` block must:
+
+- Log to backend: `logger.error(f"...: {e}", exc_info=True)`
+- Notify user: `await self._emit_notification(emitter, f"处理失败: {str(e)}", "error")`
+
+---
+
+## Edit Discipline
+
+| ✅ DO | ❌ DO NOT |
+|-------|-----------|
+| One function / one Valve / one method per edit | Mix multiple unrelated changes in one operation |
+| Validate input at the function boundary | Assume upstream data is well-formed |
+| Return early on invalid state | Nest complex logic beyond 3 levels |
+| Check fallback availability before primary path | Assume primary path always succeeds |
+| Log before and after expensive I/O | Skip logging for "obvious" operations |
+
+---
+
+## Rollback Checklist
+
+Before completing an antigravity operation, confirm:
+
+- [ ] No global state mutated on `self` (filter singleton rule)
+- [ ] File writes are atomic or can be recreated
+- [ ] Database changes are idempotent (safe to re-run)
+- [ ] Timeout guards are in place for all async calls to external systems
+- [ ] The user can observe progress through status/notification events
+
+---
+
+## References
+
+- Full engineering spec: `.github/copilot-instructions.md` → Section: **Antigravity Development Mode**
+- Design document: `docs/development/copilot-engineering-plan.md` → Section 5

.agent/rules/plugin_standards.md

@@ -0,0 +1,33 @@
+---
+description: Standards for OpenWebUI Plugin Development, specifically README formatting.
+globs: plugins/**
+always_on: true
+---
+# Plugin Development Standards
+
+## README Documentation
+
+All plugins MUST follow the standard README template.
+
+**Reference Template**: @docs/PLUGIN_README_TEMPLATE.md
+
+### Language Requirements
+
+- **English Version (`README.md`)**: The primary documentation source. Must follow the template strictly.
+- **Chinese Version (`README_CN.md`)**: MUST be translated based on the English version (`README.md`) to ensure consistency in structure and content.
+
+### Metadata Requirements
+
+The metadata line must follow this format:
+`**Author:** [Name](Link) | **Version:** [X.Y.Z] | **Project:** [OpenWebUI Extensions](https://github.com/Fu-Jie/openwebui-extensions) | **License:** MIT`
+
+### Structure Checklist
+
+1. **Title & Description**
+2. **Metadata Line** (Author, Version, Project, License)
+3. **Preview** (Screenshots/GIFs)
+4. **What's New** (Keep last 3 versions)
+5. **Key Features**
+6. **How to Use**
+7. **Configuration (Valves)**
+8. **Troubleshooting** (Must include link to GitHub Issues)

.agent/skills/README.md

@@ -0,0 +1,71 @@
+# Agent Skills Index
+
+This folder contains reusable Agent Skills for GitHub Copilot / VS Code custom agent workflows.
+
+## Available Skills
+
+- **community-announcer**
+  - Purpose: Generate community announcement content and related assets.
+  - Entry: `community-announcer/SKILL.md`
+
+- **doc-mirror-sync**
+  - Purpose: Sync mirrored documentation content and helper scripts.
+  - Entry: `doc-mirror-sync/SKILL.md`
+
+- **gh-issue-replier**
+  - Purpose: Draft standardized issue replies with templates.
+  - Entry: `gh-issue-replier/SKILL.md`
+
+- **gh-issue-scheduler**
+  - Purpose: Schedule and discover unanswered issues for follow-up.
+  - Entry: `gh-issue-scheduler/SKILL.md`
+
+- **i18n-validator**
+  - Purpose: Validate translation key consistency across i18n dictionaries.
+  - Entry: `i18n-validator/SKILL.md`
+
+- **plugin-scaffolder**
+  - Purpose: Scaffold OpenWebUI plugin boilerplate with repository standards.
+  - Entry: `plugin-scaffolder/SKILL.md`
+
+- **version-bumper**
+  - Purpose: Assist with semantic version bumping workflows.
+  - Entry: `version-bumper/SKILL.md`
+
+- **xlsx-single-file**
+  - Purpose: Single-file spreadsheet operations workflow without LibreOffice.
+  - Entry: `xlsx-single-file/SKILL.md`
+
+---
+
+## Release Pipeline Skills
+
+These four skills form a complete release pipeline and are designed to be used in sequence:
+
+```
+release-prep  →  pr-submitter  →  pr-reviewer  →  release-finalizer
+ (prepare)       (push & PR)      (respond to review)  (merge & close issue)
+```
+
+- **release-prep**
+  - Purpose: Full release preparation — version sync across 7+ files, bilingual release notes creation, consistency check, and commit.
+  - Entry: `release-prep/SKILL.md`
+
+- **pr-submitter**
+  - Purpose: Shell-escape-safe PR submission — writes body to temp file, validates sections, pushes branch, creates PR via `gh pr create --body-file`.
+  - Entry: `pr-submitter/SKILL.md`
+
+- **pr-reviewer**
+  - Purpose: Fetch PR review comments, categorize feedback, implement fixes, commit and push, reply to reviewers.
+  - Entry: `pr-reviewer/SKILL.md`
+
+- **release-finalizer**
+  - Purpose: Merge release PR to main with proper commit message, auto-link and close related issues, post closing messages.
+  - Entry: `release-finalizer/SKILL.md`
+
+## Notes
+
+- Skill definitions follow the expected location pattern:
+  - `.github/skills/<skill-name>/SKILL.md`
+- Each skill may include optional `assets/`, `references/`, and `scripts/` folders.
+- This directory mirrors `.gemini/skills` for compatibility.

.agent/skills/community-announcer/SKILL.md

@@ -0,0 +1,23 @@
+---
+name: community-announcer
+description: Drafts engaging English and Chinese update announcements for the OpenWebUI Community and other social platforms. Use when a new version is released.
+---
+
+# Community Announcer
+
+## Overview
+Automates the drafting of high-impact update announcements.
+
+## Workflow
+1. **Source Intel**: Read the latest version's `What's New` section from `README.md`.
+2. **Drafting**: Create two versions:
+   - **Community Post**: Professional, structured, technical.
+   - **Catchy Short**: For Discord/Twitter, use emojis and bullet points.
+3. **Multi-language**: Generate BOTH English and Chinese versions automatically.
+
+## Announcement Structure (Recommended)
+- **Headline**: "Update vX.X.X - [Main Feature]"
+- **Introduction**: Brief context.
+- **Key Highlights**: Bulleted list of fixes/features.
+- **Action**: "Download from [Market Link]"
+- **Closing**: Thanks and Star request.

.agent/skills/doc-mirror-sync/SKILL.md

@@ -0,0 +1,50 @@
+---
+name: doc-mirror-sync
+description: Automatically synchronizes plugin READMEs to the official documentation directory (docs/). Use after editing a plugin's local documentation to keep the MkDocs site up to date.
+---
+
+# Doc Mirror Sync
+
+## Overview
+Automates the mirroring of `plugins/{type}/{name}/README.md` to `docs/plugins/{type}/{name}.md`.
+
+## Docs-Only Mode (No Release Changes)
+Use this mode when the request is "only sync docs".
+
+- Only update documentation mirror files under `docs/plugins/**`.
+- Do **not** bump plugin version.
+- Do **not** modify plugin code (`plugins/**.py`) unless explicitly requested.
+- Do **not** update root badges/dates for release.
+- Do **not** run release preparation steps.
+
+## Workflow
+1. Identify changed READMEs.
+2. Copy content to corresponding mirror paths.
+3. Update version badges in `docs/plugins/{type}/index.md`.
+
+## Commands
+
+### Sync all mirrors (EN + ZH)
+
+```bash
+python .github/skills/doc-mirror-sync/scripts/sync.py
+```
+
+### Sync only one plugin (EN only)
+
+```bash
+cp plugins/<type>/<name>/README.md docs/plugins/<type>/<name>.md
+```
+
+### Sync only one plugin (EN + ZH)
+
+```bash
+cp plugins/<type>/<name>/README.md docs/plugins/<type>/<name>.md
+cp plugins/<type>/<name>/README_CN.md docs/plugins/<type>/<name>.zh.md
+```
+
+## Notes
+
+- If asked for English-only update, sync only `README.md` -> `.md` mirror.
+- If both languages are requested, sync both `README.md` and `README_CN.md`.
+- After syncing, verify git diff only contains docs file changes.

.agent/skills/doc-mirror-sync/scripts/sync.py

@@ -0,0 +1,38 @@
+#!/usr/bin/env python3
+import os
+import shutil
+import re
+
+def sync_mirrors():
+    plugins_root = "plugins"
+    docs_root = "docs/plugins"
+    
+    types = ["actions", "filters", "pipes", "pipelines", "tools"]
+    
+    for t in types:
+        src_type_dir = os.path.join(plugins_root, t)
+        dest_type_dir = os.path.join(docs_root, t)
+        
+        if not os.path.exists(src_type_dir): continue
+        os.makedirs(dest_type_dir, exist_ok=True)
+        
+        for name in os.listdir(src_type_dir):
+            plugin_dir = os.path.join(src_type_dir, name)
+            if not os.path.isdir(plugin_dir): continue
+            
+            # Sync README.md -> docs/plugins/{type}/{name}.md
+            src_readme = os.path.join(plugin_dir, "README.md")
+            if os.path.exists(src_readme):
+                dest_readme = os.path.join(dest_type_dir, f"{name}.md")
+                shutil.copy(src_readme, dest_readme)
+                print(f"✅ Mirrored: {t}/{name} (EN)")
+            
+            # Sync README_CN.md -> docs/plugins/{type}/{name}.zh.md
+            src_readme_cn = os.path.join(plugin_dir, "README_CN.md")
+            if os.path.exists(src_readme_cn):
+                dest_readme_zh = os.path.join(dest_type_dir, f"{name}.zh.md")
+                shutil.copy(src_readme_cn, dest_readme_zh)
+                print(f"✅ Mirrored: {t}/{name} (ZH)")
+
+if __name__ == "__main__":
+    sync_mirrors()

.agent/skills/gh-issue-replier/SKILL.md

@@ -0,0 +1,51 @@
+---
+name: gh-issue-replier
+description: Professional English replier for GitHub issues. Use when a task is completed, a bug is fixed, or more info is needed from the user. Automates replying using the 'gh' CLI tool.
+---
+
+# Gh Issue Replier
+
+## Overview
+
+The `gh-issue-replier` skill enables Gemini CLI to interact with GitHub issues professionally. It enforces English for all communications and leverages the `gh` CLI to post comments.
+
+## Workflow
+
+1.  **Identify the Issue**: Find the issue number (e.g., #49).
+2.  **Check Star Status**: Run the bundled script to check if the author has starred the repo.
+    *   Command: `bash scripts/check_star.sh <issue-number>`
+    *   Interpretation: 
+        *   Exit code **0**: User has starred. Use "Already Starred" templates.
+        *   Exit code **1**: User has NOT starred. Include "Star Request" in the reply.
+3.  **Select a Template**: Load [templates.md](references/templates.md) to choose a suitable English response pattern.
+4.  **Draft the Reply**: Compose a concise message based on the star status.
+5.  **Post the Comment**: Use the `gh` tool to submit the reply.
+
+## Tool Integration
+
+### Check Star Status
+```bash
+bash scripts/check_star.sh <issue-number>
+```
+
+### Post Comment
+```bash
+gh issue comment <issue-number> --body "<message-body>"
+```
+
+Example (if user has NOT starred):
+```bash
+gh issue comment 49 --body "This has been fixed in v1.2.7. If you find this helpful, a star on the repo would be much appreciated! ⭐"
+```
+
+Example (if user HAS starred):
+```bash
+gh issue comment 49 --body "This has been fixed in v1.2.7. Thanks for your support!"
+```
+
+## Guidelines
+
+-   **Language**: ALWAYS use English for the comment body, even if the system prompt or user conversation is in another language.
+-   **Tone**: Professional, helpful, and appreciative.
+-   **Precision**: When announcing a fix, mention the specific version or the logic change (e.g., "Updated regex pattern").
+-   **Closing**: If the issue is resolved and you have permission, you can also use `gh issue close <number>`.

.agent/skills/gh-issue-replier/references/example_reference.md

@@ -0,0 +1,17 @@
+# Reference Documentation for Gh Issue Replier
+
+This is a placeholder for detailed reference documentation.
+Replace with actual reference content or delete if not needed.
+
+## Structure Suggestions
+
+### API Reference Example
+- Overview
+- Authentication
+- Endpoints with examples
+- Error codes
+
+### Workflow Guide Example
+- Prerequisites
+- Step-by-step instructions
+- Best practices

.agent/skills/gh-issue-replier/references/templates.md

@@ -0,0 +1,45 @@
+# Issue Reply Templates
+
+Use these templates to craft professional English replies. Adjust placeholders like `@username`, `v1.2.x`, and `[commit hash]` as needed.
+
+## 1. Acknowledging a New Issue
+Use when you first see an issue and want to let the user know you are working on it.
+
+- "Thank you for reporting this! I'm looking into it right now."
+- "Thanks for bringing this to my attention. I'll try to reproduce this behavior and get back to you shortly."
+
+## 2. Requesting More Information
+Use when you need logs or specific details to fix the bug.
+
+- "Could you please provide the **'Original'** vs **'Normalized'** content from your browser console logs (F12)? It would help a lot in debugging."
+- "It would be very helpful if you could share the specific Markdown text that triggered this issue."
+
+## 3. Announcing a Fix
+Use when you have pushed the fix to the repository.
+
+- "This has been fixed in version **v1.2.x**. You can update the plugin to resolve it."
+- "I've just pushed a fix for this in [commit hash]. Please let me know if it works for you after updating."
+- "The issue was caused by a greedy regex pattern. I've updated it to use a tempered greedy token to prevent incorrect merging."
+
+## 4. Guiding to Official Market
+Always provide the official market link to ensure the user gets the latest verified version.
+
+- "The fix is now live! You can download the latest version from the official OpenWebUI Community page here: [Plugin Market Link]. Simply update the function in your OpenWebUI instance to apply the changes."
+- "I recommend getting the updated version from the official store: [Link]. It includes the fix for the spacing issue we discussed."
+
+## 5. Closing the Issue
+Use when the issue is confirmed resolved.
+
+- "Glad to hear it's working now! Closing this for now. Feel free to reopen it if the problem persists."
+- "Since this is resolved, I'm closing this issue. Thanks again for your feedback!"
+
+## 5. Pro-tip: Star Request
+Gently handle star requests based on the user's current status.
+
+### If User has NOT starred:
+- "If you find this plugin helpful, a star on the repo would be much appreciated! ⭐"
+- "We'd love your support! If this fixed your issue, please consider starring the repository. ⭐"
+
+### If User HAS already starred:
+- "Thanks again for starring the project and for your continuous support!"
+- "I appreciate your support and for being a stargazer of this project!"

.agent/skills/gh-issue-replier/scripts/check_star.sh

@@ -0,0 +1,31 @@
+#!/usr/bin/env bash
+
+# Robust Star Checker v2
+# Usage: ./check_star.sh <issue_number>
+
+ISSUE_NUM=$1
+if [ -z "$ISSUE_NUM" ]; then exit 2; fi
+
+# 1. Get Repo and Author info
+REPO_FULL=$(gh repo view --json owner,name -q ".owner.login + \"/\" + .name")
+USER_LOGIN=$(gh issue view "$ISSUE_NUM" --json author -q ".author.login")
+
+# 2. Use GraphQL for high precision (Detects stars even when REST 404s)
+IS_STARRED=$(gh api graphql -f query='
+query($owner:String!, $repo:String!, $user:String!) {
+  repository(owner:$owner, name:$repo) {
+    stargazers(query:$user, first:1) {
+      nodes {
+        login
+      }
+    }
+  }
+}' -f owner="${REPO_FULL%/*}" -f repo="${REPO_FULL#*/}" -f user="$USER_LOGIN" -q ".data.repository.stargazers.nodes[0].login")
+
+if [ "$IS_STARRED" == "$USER_LOGIN" ]; then
+    echo "Confirmed: @$USER_LOGIN HAS starred $REPO_FULL. ⭐"
+    exit 0
+else
+    echo "Confirmed: @$USER_LOGIN has NOT starred $REPO_FULL."
+    exit 1
+fi

.agent/skills/gh-issue-scheduler/SKILL.md

@@ -0,0 +1,42 @@
+---
+name: gh-issue-scheduler
+description: Finds all open GitHub issues that haven't been replied to by the owner, summarizes them, and generates a solution plan. Use when the user wants to audit pending tasks or plan maintenance work.
+---
+
+# Gh Issue Scheduler
+
+## Overview
+
+The `gh-issue-scheduler` skill helps maintainers track community feedback by identifying unaddressed issues and drafting actionable technical plans to resolve them.
+
+## Workflow
+
+1.  **Identify Unanswered Issues**: Run the bundled script to fetch issues without owner replies.
+    *   Command: `bash scripts/find_unanswered.sh`
+2.  **Analyze and Summarize**: For each identified issue, summarize the core problem and the user's intent.
+3.  **Generate Solution Plans**: Draft a technical "Action Plan" for each issue, including:
+    *   **Root Cause Analysis** (if possible)
+    *   **Proposed Fix/Implementation**
+    *   **Verification Strategy**
+4.  **Present to User**: Display a structured report of all pending issues and their respective plans.
+
+## Tool Integration
+
+### Find Unanswered Issues
+```bash
+bash scripts/find_unanswered.sh
+```
+
+## Report Format
+
+When presenting the summary, use the following Markdown structure:
+
+### 📋 Unanswered Issues Audit
+
+#### Issue #[Number]: [Title]
+- **Author**: @username
+- **Summary**: Concise description of the problem.
+- **Action Plan**:
+    1. Step 1 (e.g., Investigate file X)
+    2. Step 2 (e.g., Apply fix Y)
+    3. Verification (e.g., Run test Z)

.agent/skills/gh-issue-scheduler/scripts/find_unanswered.sh

@@ -0,0 +1,42 @@
+#!/usr/bin/env bash
+
+# Fetch all open issues and filter for those without responses from the owner/collaborators.
+# Uses 'gh' CLI.
+
+REPO_FULL=$(gh repo view --json owner,name -q ".owner.login + "/" + .name")
+OWNER=${REPO_FULL%/*}
+
+# 1. Get all open issues
+OPEN_ISSUES=$(gh issue list --state open --json number,title,author,createdAt --limit 100)
+
+echo "Analysis for repository: $REPO_FULL"
+echo "------------------------------------"
+
+# Process each issue
+echo "$OPEN_ISSUES" | jq -c '.[]' | while read -r issue; do
+    NUMBER=$(echo "$issue" | jq -r '.number')
+    TITLE=$(echo "$issue" | jq -r '.title')
+    AUTHOR=$(echo "$issue" | jq -r '.author.login')
+    
+    # Check comments for owner responses
+    # We look for comments where the author is the repo owner
+    COMMENTS=$(gh issue view "$NUMBER" --json comments -q ".comments[].author.login" 2>/dev/null)
+    
+    HAS_OWNER_REPLY=false
+    for COMMENT_AUTHOR in $COMMENTS; do
+        if [ "$COMMENT_AUTHOR" == "$OWNER" ]; then
+            HAS_OWNER_REPLY=true
+            break
+        fi
+    done
+    
+    if [ "$HAS_OWNER_REPLY" == "false" ]; then
+        echo "ISSUE_START"
+        echo "ID: $NUMBER"
+        echo "Title: $TITLE"
+        echo "Author: $AUTHOR"
+        echo "Description:"
+        gh issue view "$NUMBER" --json body -q ".body"
+        echo "ISSUE_END"
+    fi
+done

.agent/skills/i18n-validator/SKILL.md

@@ -0,0 +1,14 @@
+---
+name: i18n-validator
+description: Validates multi-language consistency in the TRANSLATIONS dictionary of a plugin. Use to check if any language keys are missing or if translations need updating.
+---
+
+# I18n Validator
+
+## Overview
+Ensures all 12 supported languages (en-US, zh-CN, etc.) have aligned translation keys.
+
+## Features
+- Detects missing keys in non-English dictionaries.
+- Suggests translations using the core AI engine.
+- Validates the `fallback_map` for variant redirects.

.agent/skills/i18n-validator/scripts/validate_i18n.py

@@ -0,0 +1,54 @@
+#!/usr/bin/env python3
+import sys
+import ast
+import os
+
+def check_i18n(file_path):
+    if not os.path.exists(file_path):
+        print(f"Error: File not found {file_path}")
+        return
+    
+    with open(file_path, 'r', encoding='utf-8') as f:
+        tree = ast.parse(f.read())
+    
+    translations = {}
+    for node in tree.body:
+        if isinstance(node, ast.Assign):
+            for target in node.targets:
+                if isinstance(target, ast.Name) and target.id == "TRANSLATIONS":
+                    translations = ast.literal_eval(node.value)
+                    break
+    
+    if not translations:
+        print("⚠️ No TRANSLATIONS dictionary found.")
+        return
+
+    # Base keys from English
+    base_lang = "en-US"
+    if base_lang not in translations:
+        print(f"❌ Error: {base_lang} missing in TRANSLATIONS.")
+        return
+    
+    base_keys = set(translations[base_lang].keys())
+    print(f"🔍 Analyzing {file_path}...")
+    print(f"Standard keys ({len(base_keys)}): {', '.join(sorted(base_keys))}
+")
+
+    for lang, keys in translations.items():
+        if lang == base_lang: continue
+        lang_keys = set(keys.keys())
+        missing = base_keys - lang_keys
+        extra = lang_keys - base_keys
+        
+        if missing:
+            print(f"❌ {lang}: Missing {len(missing)} keys: {', '.join(missing)}")
+        if extra:
+            print(f"⚠️ {lang}: Has {len(extra)} extra keys: {', '.join(extra)}")
+        if not missing and not extra:
+            print(f"✅ {lang}: Aligned.")
+
+if __name__ == "__main__":
+    if len(sys.argv) < 2:
+        print("Usage: validate_i18n.py <path_to_plugin.py>")
+        sys.exit(1)
+    check_i18n(sys.argv[1])

.agent/skills/plugin-scaffolder/SKILL.md

@@ -0,0 +1,19 @@
+---
+name: plugin-scaffolder
+description: Generates a standardized single-file i18n Python plugin template based on project standards. Use when starting a new plugin development to skip boilerplate writing.
+---
+
+# Plugin Scaffolder
+
+## Overview
+Generates compliant OpenWebUI plugin templates with built-in i18n, common utility methods, and required docstring fields.
+
+## Usage
+1. Provide the **Plugin Name** and **Type** (action/filter/pipe).
+2. The skill will generate the `.py` file and the bilingual `README` files.
+
+## Template Standard
+- `Valves(BaseModel)` with `UPPER_SNAKE_CASE`
+- `_get_user_context` with JS fallback and timeout
+- `_emit_status` and `_emit_debug_log` methods
+- Standardized docstring metadata

.agent/skills/plugin-scaffolder/assets/README_template.md

@@ -0,0 +1,34 @@
+# {{TITLE}}
+
+**Author:** [Fu-Jie](https://github.com/Fu-Jie/openwebui-extensions) | **Version:** 0.1.0 | **Project:** [OpenWebUI Extensions](https://github.com/Fu-Jie/openwebui-extensions) | **License:** MIT
+
+{{DESCRIPTION}}
+
+## 🔥 What's New in v0.1.0
+
+* Initial release of {{TITLE}}.
+
+## 🌐 Multilingual Support
+
+Supports automatic interface and status switching for the following languages:
+`English`, `简体中文`, `繁體中文 (香港)`, `繁體中文 (台灣)`, `한국어`, `日本語`, `Français`, `Deutsch`, `Español`, `Italiano`, `Tiếng Việt`, `Bahasa Indonesia`.
+
+## ✨ Core Features
+
+* Feature 1
+* Feature 2
+
+## How to Use 🛠️
+
+1. Install the plugin in Open WebUI.
+2. Configure settings in Valves.
+
+## Configuration (Valves) ⚙️
+
+| Parameter | Default | Description |
+| :--- | :--- | :--- |
+| `priority` | `50` | Execution priority. |
+
+## ⭐ Support
+
+If this plugin has been useful, a star on [OpenWebUI Extensions](https://github.com/Fu-Jie/openwebui-extensions) is a big motivation for me. Thank you for the support.

.agent/skills/plugin-scaffolder/assets/template.py

@@ -0,0 +1,80 @@
+"""
+title: {{TITLE}}
+author: Fu-Jie
+author_url: https://github.com/Fu-Jie/openwebui-extensions
+funding_url: https://github.com/open-webui
+version: 0.1.0
+description: {{DESCRIPTION}}
+"""
+
+import asyncio
+import logging
+import json
+from typing import Optional, Dict, Any, List, Callable, Awaitable
+from pydantic import BaseModel, Field
+from fastapi import Request
+
+# Configure logging
+logging.basicConfig(level=logging.INFO, format="%(asctime)s - %(name)s - %(levelname)s - %(message)s")
+logger = logging.getLogger(__name__)
+
+TRANSLATIONS = {
+    "en-US": {"status_starting": "Starting {{TITLE}}..."},
+    "zh-CN": {"status_starting": "正在启动 {{TITLE}}..."},
+    "zh-HK": {"status_starting": "正在啟動 {{TITLE}}..."},
+    "zh-TW": {"status_starting": "正在啟動 {{TITLE}}..."},
+    "ko-KR": {"status_starting": "{{TITLE}} 시작 중..."},
+    "ja-JP": {"status_starting": "{{TITLE}} を起動中..."},
+    "fr-FR": {"status_starting": "Démarrage de {{TITLE}}..."},
+    "de-DE": {"status_starting": "{{TITLE}} wird gestartet..."},
+    "es-ES": {"status_starting": "Iniciando {{TITLE}}..."},
+    "it-IT": {"status_starting": "Avvio di {{TITLE}}..."},
+    "vi-VN": {"status_starting": "Đang khởi động {{TITLE}}..."},
+    "id-ID": {"status_starting": "Memulai {{TITLE}}..."},
+}
+
+class {{CLASS_NAME}}:
+    class Valves(BaseModel):
+        priority: int = Field(default=50, description="Priority level (lower = earlier).")
+        show_status: bool = Field(default=True, description="Show status updates in UI.")
+
+    def __init__(self):
+        self.valves = self.Valves()
+        self.fallback_map = {
+            "zh": "zh-CN", "en": "en-US", "ko": "ko-KR", "ja": "ja-JP",
+            "fr": "fr-FR", "de": "de-DE", "es": "es-ES", "it": "it-IT",
+            "vi": "vi-VN", "id": "id-ID"
+        }
+
+    def _get_translation(self, lang: str, key: str, **kwargs) -> str:
+        target_lang = lang
+        if target_lang not in TRANSLATIONS:
+            base = target_lang.split("-")[0]
+            target_lang = self.fallback_map.get(base, "en-US")
+        
+        lang_dict = TRANSLATIONS.get(target_lang, TRANSLATIONS["en-US"])
+        text = lang_dict.get(key, TRANSLATIONS["en-US"].get(key, key))
+        return text.format(**kwargs) if kwargs else text
+
+    async def _get_user_context(self, __user__: Optional[dict], __event_call__: Optional[Callable] = None, __request__: Optional[Request] = None) -> dict:
+        user_data = __user__ if isinstance(__user__, dict) else {}
+        user_language = user_data.get("language", "en-US")
+        if __event_call__:
+            try:
+                js = "try { return (document.documentElement.lang || localStorage.getItem('locale') || navigator.language || 'en-US'); } catch (e) { return 'en-US'; }"
+                frontend_lang = await asyncio.wait_for(__event_call__({"type": "execute", "data": {"code": js}}), timeout=2.0)
+                if frontend_lang: user_language = frontend_lang
+            except: pass
+        return {"user_language": user_language}
+
+    async def {{METHOD_NAME}}(self, body: dict, __user__: Optional[dict] = None, __event_emitter__=None, __event_call__=None, __request__: Optional[Request] = None) -> dict:
+        if self.valves.show_status and __event_emitter__:
+            user_ctx = await self._get_user_context(__user__, __event_call__, __request__)
+            msg = self._get_translation(user_ctx["user_language"], "status_starting")
+            await __event_emitter__({"type": "status", "data": {"description": msg, "done": False}})
+        
+        # Implement core logic here
+        
+        if self.valves.show_status and __event_emitter__:
+            await __event_emitter__({"type": "status", "data": {"description": "Done", "done": True}})
+        return body

.agent/skills/plugin-scaffolder/assets/template.py.j2

@@ -0,0 +1,80 @@
+"""
+title: {{TITLE}}
+author: Fu-Jie
+author_url: https://github.com/Fu-Jie/openwebui-extensions
+funding_url: https://github.com/open-webui
+version: 0.1.0
+description: {{DESCRIPTION}}
+"""
+
+import asyncio
+import logging
+import json
+from typing import Optional, Dict, Any, List, Callable, Awaitable
+from pydantic import BaseModel, Field
+from fastapi import Request
+
+# Configure logging
+logging.basicConfig(level=logging.INFO, format="%(asctime)s - %(name)s - %(levelname)s - %(message)s")
+logger = logging.getLogger(__name__)
+
+TRANSLATIONS = {
+    "en-US": {"status_starting": "Starting {{TITLE}}..."},
+    "zh-CN": {"status_starting": "正在启动 {{TITLE}}..."},
+    "zh-HK": {"status_starting": "正在啟動 {{TITLE}}..."},
+    "zh-TW": {"status_starting": "正在啟動 {{TITLE}}..."},
+    "ko-KR": {"status_starting": "{{TITLE}} 시작 중..."},
+    "ja-JP": {"status_starting": "{{TITLE}} を起動中..."},
+    "fr-FR": {"status_starting": "Démarrage de {{TITLE}}..."},
+    "de-DE": {"status_starting": "{{TITLE}} wird gestartet..."},
+    "es-ES": {"status_starting": "Iniciando {{TITLE}}..."},
+    "it-IT": {"status_starting": "Avvio di {{TITLE}}..."},
+    "vi-VN": {"status_starting": "Đang khởi động {{TITLE}}..."},
+    "id-ID": {"status_starting": "Memulai {{TITLE}}..."},
+}
+
+class {{CLASS_NAME}}:
+    class Valves(BaseModel):
+        priority: int = Field(default=50, description="Priority level (lower = earlier).")
+        show_status: bool = Field(default=True, description="Show status updates in UI.")
+
+    def __init__(self):
+        self.valves = self.Valves()
+        self.fallback_map = {
+            "zh": "zh-CN", "en": "en-US", "ko": "ko-KR", "ja": "ja-JP",
+            "fr": "fr-FR", "de": "de-DE", "es": "es-ES", "it": "it-IT",
+            "vi": "vi-VN", "id": "id-ID"
+        }
+
+    def _get_translation(self, lang: str, key: str, **kwargs) -> str:
+        target_lang = lang
+        if target_lang not in TRANSLATIONS:
+            base = target_lang.split("-")[0]
+            target_lang = self.fallback_map.get(base, "en-US")
+        
+        lang_dict = TRANSLATIONS.get(target_lang, TRANSLATIONS["en-US"])
+        text = lang_dict.get(key, TRANSLATIONS["en-US"].get(key, key))
+        return text.format(**kwargs) if kwargs else text
+
+    async def _get_user_context(self, __user__: Optional[dict], __event_call__: Optional[Callable] = None, __request__: Optional[Request] = None) -> dict:
+        user_data = __user__ if isinstance(__user__, dict) else {}
+        user_language = user_data.get("language", "en-US")
+        if __event_call__:
+            try:
+                js = "try { return (document.documentElement.lang || localStorage.getItem('locale') || navigator.language || 'en-US'); } catch (e) { return 'en-US'; }"
+                frontend_lang = await asyncio.wait_for(__event_call__({"type": "execute", "data": {"code": js}}), timeout=2.0)
+                if frontend_lang: user_language = frontend_lang
+            except: pass
+        return {"user_language": user_language}
+
+    async def {{METHOD_NAME}}(self, body: dict, __user__: Optional[dict] = None, __event_emitter__=None, __event_call__=None, __request__: Optional[Request] = None) -> dict:
+        if self.valves.show_status and __event_emitter__:
+            user_ctx = await self._get_user_context(__user__, __event_call__, __request__)
+            msg = self._get_translation(user_ctx["user_language"], "status_starting")
+            await __event_emitter__({"type": "status", "data": {"description": msg, "done": False}})
+        
+        # Implement core logic here
+        
+        if self.valves.show_status and __event_emitter__:
+            await __event_emitter__({"type": "status", "data": {"description": "Done", "done": True}})
+        return body

.agent/skills/plugin-scaffolder/scripts/scaffold.py

@@ -0,0 +1,66 @@
+#!/usr/bin/env python3
+import sys
+import os
+
+
+def scaffold(p_type, p_name, title, desc):
+    target_dir = f"plugins/{p_type}/{p_name}"
+    os.makedirs(target_dir, exist_ok=True)
+
+    class_name = (
+        "Action"
+        if p_type == "actions"
+        else (
+            "Filter"
+            if p_type == "filters"
+            else "Tools" if p_type == "tools" else "Pipe"
+        )
+    )
+    method_name = (
+        "action"
+        if p_type == "actions"
+        else (
+            "outlet"
+            if p_type == "filters"
+            else "execute" if p_type == "tools" else "pipe"
+        )
+    )
+
+    replacements = {
+        "{{TITLE}}": title,
+        "{{DESCRIPTION}}": desc,
+        "{{CLASS_NAME}}": class_name,
+        "{{METHOD_NAME}}": method_name,
+    }
+
+    # Files to generate
+    templates = [
+        ("assets/template.py.j2", f"{p_name}.py"),
+        ("assets/README_template.md", "README.md"),
+        ("assets/README_template.md", "README_CN.md"),
+    ]
+
+    # Path relative to skill root
+    skill_root = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+
+    for t_path, t_name in templates:
+        template_file = os.path.join(skill_root, t_path)
+        if not os.path.exists(template_file):
+            print(f"⚠️ Warning: Template not found {template_file}")
+            continue
+
+        with open(template_file, "r") as f:
+            content = f.read()
+        for k, v in replacements.items():
+            content = content.replace(k, v)
+
+        with open(os.path.join(target_dir, t_name), "w") as f:
+            f.write(content)
+        print(f"✅ Generated: {target_dir}/{t_name}")
+
+
+if __name__ == "__main__":
+    if len(sys.argv) < 5:
+        print("Usage: scaffold.py <type> <name> <title> <desc>")
+        sys.exit(1)
+    scaffold(sys.argv[1], sys.argv[2], sys.argv[3], sys.argv[4])

.agent/skills/pr-reviewer/SKILL.md

@@ -0,0 +1,180 @@
+---
+name: pr-reviewer
+description: Fetches PR review comments, analyzes requested changes, implements fixes, commits and pushes the resolution. Use after a reviewer has left comments on an open PR to close the feedback loop efficiently.
+---
+
+# PR Reviewer
+
+## Overview
+
+This skill automates the response cycle for code review. When a reviewer leaves comments on a Pull Request, this skill fetches all pending feedback, categorizes issues by severity, implements fixes, and submits a follow-up commit with appropriate review response comments.
+
+## Prerequisites
+
+- An open PR exists with pending review comments
+- The local branch matches the PR's head branch
+- `gh` CLI is authenticated
+
+---
+
+## Workflow
+
+### Step 1 — Fetch Review State
+
+Retrieve all review comments and overall review status:
+
+```bash
+# Get overall review decisions
+PAGER=cat GH_PAGER=cat gh pr view <PR-NUMBER> --json reviews,reviewDecision,headRefName \
+  --jq '{decision: .reviewDecision, reviews: [.reviews[] | {author: .author.login, state: .state, body: .body}]}'
+
+# Get inline code comments (specific line comments)
+PAGER=cat GH_PAGER=cat gh api repos/Fu-Jie/openwebui-extensions/pulls/<PR-NUMBER>/comments \
+  --jq '[.[] | {path: .path, line: .line, body: .body, author: .user.login, id: .id}]'
+
+# Get general issue comments
+PAGER=cat GH_PAGER=cat gh issue view <PR-NUMBER> --comments --json comments \
+  --jq '[.comments[] | {author: .author.login, body: .body}]'
+```
+
+Confirm the current local branch matches the PR head:
+```bash
+git branch --show-current
+```
+If mismatched, checkout the correct branch first.
+
+### Step 2 — Categorize Review Feedback
+
+Group feedback into categories:
+
+| Category | Examples | Action |
+|----------|---------|--------|
+| **Code Bug** | Logic error, incorrect variable, broken condition | Fix code immediately |
+| **Style / Formatting** | Indentation, naming convention, missing blank line | Fix code |
+| **Documentation** | Missing i18n key, wrong version in README, typo | Fix docs |
+| **Design Question** | Suggestion to restructure, alternative approach | Discuss with user before implementing |
+| **Nitpick / Optional** | Minor style preferences reviewer marked as optional | Fix if quick; document if skipped |
+| **Blocking** | Reviewer explicitly blocks merge | Must fix before proceeding |
+
+Present the full categorized list to the user and confirm the resolution plan.
+
+### Step 3 — Implement Fixes
+
+For each accepted fix:
+
+1. Read the affected file at the commented line for context:
+   ```bash
+   sed -n '<line-5>,<line+10>p' <file-path>
+   ```
+2. Apply the fix using appropriate file edit tools
+3. After editing, verify the specific area looks correct
+
+**For code changes that might affect behavior:**
+- Check if tests exist: `ls tests/test_*.py`
+- If tests exist, run them: `python -m pytest tests/ -v`
+
+**For documentation fixes:**
+- If modifying README.md, check if `docs/` mirror needs the same fix
+- Apply the same fix to both locations
+
+### Step 4 — Run Consistency Checks
+
+After all fixes are applied:
+
+```bash
+# Version consistency (if any version files were touched)
+python3 scripts/check_version_consistency.py
+
+# Quick syntax check for Python files
+python3 -m py_compile plugins/{type}/{name}/{name}.py && echo "✅ Syntax OK"
+```
+
+### Step 5 — Stage and Commit
+
+Create a new commit (do NOT amend if the branch has already been pushed, to avoid force-push):
+
+```bash
+git add -A
+git status
+```
+
+Draft a Conventional Commits message for the fixup:
+
+Format: `fix(scope): address review feedback`
+
+Body should list what was fixed, referencing reviewer concerns:
+```
+fix(github-copilot-sdk): address review feedback from @reviewer
+
+- Fix X per review comment on line Y of file Z
+- Update README to clarify auth requirement
+- Correct edge case in _parse_mcp_servers logic
+```
+
+```bash
+git commit -m "<fixup commit message>"
+```
+
+### Step 6 — Push the Fix Commit
+
+```bash
+git push origin $(git branch --show-current)
+```
+
+**Force-push policy:**
+- Use `git push` (non-force) by default
+- Only use `git push --force-with-lease` if:
+  1. The user explicitly requests it, AND
+  2. The only change is an amended commit squash (cosmetic, no logic change)
+  3. Never use `--force` (without `--lease`)
+
+### Step 7 — Respond to Reviewers
+
+For each addressed review comment, post a reply:
+
+```bash
+# Reply to inline comment
+gh api repos/Fu-Jie/openwebui-extensions/pulls/<PR-NUMBER>/comments/<COMMENT-ID>/replies \
+  -X POST -f body="Fixed in commit <SHORT-SHA>. <Brief explanation of what was changed.>"
+
+# General comment to summarize all fixes
+gh issue comment <PR-NUMBER> --body "All review feedback addressed in commit <SHORT-SHA>:
+- Fixed: <item 1>
+- Fixed: <item 2>
+Ready for re-review. 🙏"
+```
+
+### Step 8 — Re-Request Review (Optional)
+
+If the reviewer had submitted a `CHANGES_REQUESTED` review, request a new review after fixes:
+
+```bash
+PAGER=cat GH_PAGER=cat gh api repos/Fu-Jie/openwebui-extensions/pulls/<PR-NUMBER>/requested_reviewers \
+  -X POST -f reviewers[]='<reviewer-login>'
+```
+
+---
+
+## Decision Guide
+
+### When NOT to implement a suggestion immediately
+
+- **Design questions**: "Should this be a separate class?" — Present to user for decision
+- **Optional nitpicks**: Reviewer marked as `nit:` — Ask user if they want to include it
+- **Large refactors**: If fix would require changing >50 lines, propose a separate follow-up issue instead
+
+### When to ask the user before proceeding
+
+- Any fix involving behavioral changes to plugin logic
+- Renaming Valve keys (breaking change — requires migration notes)
+- Changes that affect the bilingual release notes already committed
+
+---
+
+## Anti-Patterns to Avoid
+
+- ❌ Do NOT `git commit --amend` on a pushed commit without user approval for force-push
+- ❌ Do NOT silently skip a reviewer's comment; always acknowledge it (implement or explain why not)
+- ❌ Do NOT use `--force` (only `--force-with-lease` when absolutely necessary)
+- ❌ Do NOT make unrelated changes in the fixup commit; keep scope focused on review feedback
+- ❌ Do NOT respond to reviewer comments in Chinese if the PR language context is English

.agent/skills/pr-submitter/SKILL.md

@@ -0,0 +1,194 @@
+---
+name: pr-submitter
+description: Submits a feature branch as a Pull Request with a validated, properly formatted bilingual PR body. Handles shell-escape-safe body writing via temp files. Use after release-prep has committed all changes.
+---
+
+# PR Submitter
+
+## Overview
+
+This skill handles the final step of pushing a feature branch and creating a validated Pull Request on GitHub. Its primary purpose is to avoid the shell-escaping pitfalls (backticks, special characters in `gh pr create --body`) by always writing the PR body to a **temp file** first.
+
+## Prerequisites
+
+- All changes are committed (use `release-prep` skill first)
+- The `gh` CLI is authenticated (`gh auth status`)
+- Current branch is NOT `main` or `master`
+
+---
+
+## Workflow
+
+### Step 0 — Initialize Temp Directory (Project-Based)
+
+For all temporary files, use the project's `.temp/` directory instead of system `/tmp`:
+
+```bash
+# Create temp directory if it doesn't exist
+mkdir -p .temp
+```
+
+**Why**: All temporary files stay within the project workspace, avoiding system `/tmp` pollution and better aligning with OpenWebUI workspace isolation principles.
+
+### Step 1 — Pre-Flight Checks
+
+Run these checks before any push:
+
+```bash
+# 1. Confirm not on protected branch
+git branch --show-current
+
+# 2. Verify there are commits to push
+git log origin/$(git branch --show-current)..HEAD --oneline 2>/dev/null || echo "No remote tracking branch yet"
+
+# 3. Check gh CLI auth
+gh auth status
+```
+
+If any check fails, stop and report clearly.
+
+### Step 2 — Collect PR Metadata
+
+Gather:
+- **PR Title**: Must follow Conventional Commits format, English only (e.g., `feat(github-copilot-sdk): release v0.8.0 with conditional tool filtering`)
+- **Target base branch**: Default is `main`
+- **Plugin name + version** (to build body sections)
+- **Key changes** (reuse from release-prep or the latest What's New section)
+
+### Step 3 — Build PR Body File (Shell-Escape-Safe)
+
+**Always write the body to a temp file in `.temp/` directory.** Never embed multi-line markdown with special characters directly in a shell command.
+
+```bash
+cat > .temp/pr_body.md << 'HEREDOC'
+## Summary
+
+Brief one-sentence description of what this PR accomplishes.
+
+## Changes
+
+### New Features
+- Feature 1 description
+- Feature 2 description
+
+### Bug Fixes
+- Fix 1 description
+
+## Plugin Version
+- `PluginName` bumped to `vX.X.X`
+
+## Documentation
+- README.md / README_CN.md updated
+- docs/ mirrors synced
+
+## Testing
+- [ ] Tested locally in OpenWebUI
+- [ ] i18n validated (all language keys present)
+- [ ] Version consistency check passed (`python3 scripts/check_version_consistency.py`)
+
+---
+
+## 变更摘要（中文）
+
+简要描述本次 PR 的改动内容。
+
+### 新功能
+- 功能1描述
+- 功能2描述
+
+### 问题修复
+- 修复1描述
+HEREDOC
+```
+
+**Critical rules for the body file:**
+- Use `<< 'HEREDOC'` (quoted heredoc) to prevent variable expansion
+- Keep all backticks literal — they are safe inside a heredoc
+- Paths like `/api/v1/files/` are safe too since heredoc doesn't interpret them as commands
+
+### Step 4 — Validate PR Body
+
+Before submitting, verify the body file contains expected sections:
+
+```bash
+# Check key sections exist
+grep -q "## Summary" .temp/pr_body.md && echo "✅ Summary" || echo "❌ Summary missing"
+grep -q "## Changes" .temp/pr_body.md && echo "✅ Changes" || echo "❌ Changes missing"
+grep -q "## 变更摘要" .temp/pr_body.md && echo "✅ CN Section" || echo "❌ CN Section missing"
+
+# Preview the body
+cat .temp/pr_body.md
+```
+
+Ask the user to confirm the body content before proceeding.
+
+### Step 5 — Push Branch
+
+```bash
+git push -u origin $(git branch --show-current)
+```
+
+If push is rejected (non-fast-forward), report to user and ask whether to force-push. **Do NOT force-push without explicit confirmation.**
+
+### Step 6 — Create Pull Request
+
+```bash
+gh pr create \
+  --base main \
+  --head $(git branch --show-current) \
+  --title "<PR title from Step 2>" \
+  --body-file .temp/pr_body.md
+```
+
+Always use `--body-file`, never `--body` with inline markdown.
+
+### Step 7 — Verify PR Creation
+
+```bash
+PAGER=cat GH_PAGER=cat gh pr view --json number,url,title,body --jq '{number: .number, url: .url, title: .title, body_preview: .body[:200]}'
+```
+
+Confirm:
+- PR number and URL
+- Title matches intended Conventional Commits format
+- Body preview includes key sections (not truncated/corrupted)
+
+If the body appears corrupted (empty sections, missing backtick content), use edit:
+
+```bash
+gh pr edit <PR-NUMBER> --body-file /tmp/pr_body.md
+```
+
+### Step 8 — Cleanup
+
+```bash
+rm -f .temp/pr_body.md
+```
+
+**Note**: The `.temp/` directory itself is preserved for reuse; only the individual PR body file is deleted. To fully clean up: `rm -rf .temp/`
+
+Report final PR URL to the user.
+
+---
+
+## Shell-Escape Safety Rules
+
+| Risk | Safe Approach |
+|------|--------------|
+| Backticks in `--body` | Write to file, use `--body-file` |
+| Paths like `/api/...` | Safe in heredoc; risky in inline `--body` |
+| Newlines in `--body` | File-based only |
+| `$variable` expansion | Use `<< 'HEREDOC'` (quoted) |
+| Double quotes in body | Safe in heredoc file |
+| Temp file storage | Use `.temp/` dir, not `/tmp` |
+| Cleanup after use | Always delete temp file (keep dir) |
+
+---
+
+## Anti-Patterns to Avoid
+
+- ❌ Never use `--body "..."` with multi-line content directly in shell command
+- ❌ Never interpolate variables directly into heredoc without quoting the delimiter
+- ❌ Never force-push (`--force`) without explicit user confirmation
+- ❌ Never target `main` as the source branch (only as base)
+- ❌ Never skip the body validation step — a PR with empty body is worse than a delayed PR

.agent/skills/release-finalizer/SKILL.md

@@ -0,0 +1,208 @@
+---
+name: release-finalizer
+description: Merges a release PR, associates it with resolved issues, replies to issue reporters, and closes issues. Use after PR review is complete and ready for merge. Closes the release cycle.
+---
+
+# Release Finalizer
+
+## Overview
+
+This skill completes the final step of the release cycle: merging the release PR to `main`, replying to all related issues with solutions, and automatically closing them using GitHub's issue linking mechanism.
+
+## Prerequisites
+
+- The PR is in `OPEN` state and ready to merge
+- All status checks have passed (CI green)
+- All review feedback has been addressed
+- The PR relates to one or more GitHub issues (either in PR description or through commits)
+
+---
+
+## Workflow
+
+### Step 1 — Pre-Merge Verification
+
+Verify that the PR is ready:
+
+```bash
+PAGER=cat GH_PAGER=cat gh pr view <PR-NUMBER> --json state,statusCheckRollup,reviewDecision
+```
+
+Checklist:
+- ✅ `state` is `OPEN`
+- ✅ `statusCheckRollup` all have `conclusion: SUCCESS`
+- ✅ `reviewDecision` is `APPROVED` or empty (no blocking reviews)
+
+If any check fails, **do NOT merge**. Report the issue to the user.
+
+### Step 2 — Identify Related Issues
+
+Issues can be linked to a PR in multiple ways. Check the PR description and commit messages for keywords:
+
+```bash
+PAGER=cat GH_PAGER=cat gh pr view <PR-NUMBER> --json body,commits
+```
+
+Look for patterns like:
+- `Closes #XX`, `Fixes #XX`, `Resolves #XX` (in description or commit bodies)
+- `#XX` mentioned as "related to" or "addresses"
+
+**Manual input**: If issue links are not in the PR, ask the user which issue(s) this PR resolves.
+
+Extract all issue numbers into a list: `[#48, #52, ...]`
+
+### Step 3 — Select Merge Strategy
+
+Offer the user three options:
+
+| Strategy | Git Behavior | Use Case |
+|----------|-------------|----------|
+| **Squash** | All commits squashed into one commit on main | Clean history, recommended for release PRs |
+| **Rebase** | Linear history, no merge commit | Preserve commit granularity |
+| **Merge** | Merge commit created | Preserve full PR context |
+
+**Recommendation for release PRs**: Use `--squash` to create a single clean commit.
+
+If user doesn't specify, default to `--squash`.
+
+### Step 4 — Prepare Merge Commit Message
+
+If using `--squash`, craft a single comprehensive commit message:
+
+**Format** (Conventional Commits + Github linking):
+```
+type(scope): description
+
+- Bullet point 1
+- Bullet point 2
+
+Closes #48
+Closes #52
+```
+
+The `Closes #XX` keyword tells GitHub to automatically close those issues when the commit lands on `main`.
+
+Example:
+```
+feat(pipes,filters): release Copilot SDK Pipe v0.8.0 and Files Filter v0.1.3
+
+- Implement P1~P4 conditional tool filtering system
+- Fix file publishing reliability across all storage backends
+- Add strict file URL validation
+- Update bilingual documentation
+
+Closes #48
+```
+
+### Step 5 — Execute Merge
+
+```bash
+gh pr merge <PR-NUMBER> \
+  --squash \
+  --delete-branch \
+  -m "type(scope): description" \
+  -b "- Bullet 1\n- Bullet 2\n\nCloses #48"
+```
+
+**Key flags:**
+- `--squash`: Squash commits (recommended for releases)
+- `--delete-branch`: Delete the feature branch after merge
+- `-m`: Commit subject
+- `-b`: Commit body (supports `\n` for newlines)
+
+Confirm the merge is successful; GitHub will automatically close related issues with `Closes #XX` keyword.
+
+### Step 6 — Verify Auto-Close
+
+GitHub automatically closes issues when a commit with `Closes #XX` lands on the default branch (`main`).
+
+To verify:
+```bash
+PAGER=cat GH_PAGER=cat gh issue view <ISSUE-NUMBER> --json state
+```
+
+Should show `state: CLOSED`.
+
+### Step 7 — Post Closing Message (Optional but Recommended)
+
+For better UX, manually post a summary comment to **each issue** before it auto-closes (since auto-close happens silently):
+
+```bash
+gh issue comment <ISSUE-NUMBER> --body "
+This has been fixed in PR #<PR-NUMBER>, which is now merged to main.
+
+**Solution Summary:**
+- <Key fix 1>
+- <Key fix 2>
+
+The fix will be available in the next plugin release. Thank you for reporting! ⭐
+"
+```
+
+### Step 8 — (Optional) Regenerate Release Notes
+
+If the merge revealed any final tweaks to release notes:
+
+```bash
+# Re-export release notes from merged commit
+git log --oneline -1 <merged-commit-sha>
+```
+
+If needed, create a follow-up PR with doc polish (do NOT force-push the merged commit).
+
+---
+
+## Merge Strategy Decision Tree
+
+```
+Is this a patch/hotfix release?
+├─ YES → Use --squash
+└─ NO → Multi-feature release?
+     ├─ YES → Use --squash (cleaner history)
+     └─ NO → Preserve detail? 
+          ├─ YES → Use --rebase
+          └─ NO → Use --merge (preserve PR context)
+```
+
+---
+
+## Issue Auto-Close Keywords
+
+These keywords in commit/PR messages will auto-close issues when merged to `main`:
+
+- `Closes #XX`
+- `Fixes #XX`
+- `Resolves #XX`
+- `close #XX` (case-insensitive)
+- `fix #XX`
+- `resolve #XX`
+
+**Important**: The keyword must be on the **final commit that lands on** `main`. For squash merges, it must be in the squash commit message body.
+
+---
+
+## Anti-Patterns to Avoid
+
+- ❌ Do NOT merge if any status checks are PENDING or FAILED
+- ❌ Do NOT merge if there are blocking reviews (reviewDecision: `CHANGES_REQUESTED`)
+- ❌ Do NOT merge without verifying the Conventional Commits format in the merge message
+- ❌ Do NOT merge without including `Closes #XX` keywords for all related issues
+- ❌ Do NOT assume issues will auto-close silently — post a courtesy comment first
+- ❌ Do NOT delete the branch if it might be needed for cherry-pick or hotfixes later
+
+---
+
+## Troubleshooting
+
+### Issue did not auto-close after merge
+- Verify the `Closes #XX` keyword is in the **final commit message** (use `git log` to check)
+- Ensure the commit is on the `main` branch
+- GitHub sometimes takes a few seconds to process; refresh the issue page
+
+### Multiple issues to close
+- List all in separate `Closes #XX` lines in the commit body
+- Each one will be independently auto-closed
+
+### Want to close issue without merge?
+- Use `gh issue close <ISSUE-NUMBER>` manually
+- Only recommended if the PR was manually reverted or deemed invalid

.agent/skills/release-prep/SKILL.md

@@ -0,0 +1,157 @@
+---
+name: release-prep
+description: Orchestrates the full release preparation flow for a plugin — version sync across 7+ files, bilingual release notes creation, and commit message drafting. Use before submitting a PR. Does NOT push or create a PR; that is handled by pr-submitter.
+---
+
+# Release Prep
+
+## Overview
+
+This skill drives the complete pre-PR release pipeline. It enforces the repository rule that every release must synchronize the version number and changelog across **at least 7 locations** before a commit is created.
+
+## Scope
+
+This skill covers:
+1. Version sync (delegates detail to `version-bumper` if needed)
+2. Bilingual release notes file creation
+3. 7-location consistency verification
+4. Conventional Commits message drafting
+5. `git add -A && git commit` execution
+
+It **stops before** `git push` or `gh pr create`. Use the `pr-submitter` skill for those steps.
+
+### Temporary File Convention
+
+Any temporary files created during release prep (e.g., draft changelogs) must:
+- Be written to the project's `.temp/` directory, **NOT** system `/tmp`
+- Be cleaned up before commit using `rm -f .temp/file_name`
+- Never be committed to git (add `.temp/` to `.gitignore`)
+
+---
+
+## Workflow
+
+### Step 1 — Collect Release Info
+
+Ask the user (or infer from current state) the following:
+- **Plugin name** and **type** (actions / filters / pipes / tools)
+- **New version number** (e.g., `0.8.0`)
+- **Key changes** in English and Chinese (1-5 bullet points each)
+
+If a `What's New` section already exists in README.md, extract it as the source of truth.
+
+### Step 2 — Sync Version Across 7 Locations
+
+Verify AND update the version string in all of the following. Mark each as ✅ or ❌:
+
+| # | File | Location |
+|---|------|----------|
+| 1 | `plugins/{type}/{name}/{name}.py` | `version:` in docstring |
+| 2 | `plugins/{type}/{name}/README.md` | `**Version:** x.x.x` metadata line |
+| 3 | `plugins/{type}/{name}/README_CN.md` | `**Version:** x.x.x` metadata line |
+| 4 | `docs/plugins/{type}/{name}.md` | `**Version:** x.x.x` metadata line |
+| 5 | `docs/plugins/{type}/{name}.zh.md` | `**Version:** x.x.x` metadata line |
+| 6 | `docs/plugins/{type}/index.md` | version badge for this plugin |
+| 7 | `docs/plugins/{type}/index.zh.md` | version badge for this plugin |
+
+Additionally update the root-level **updated date badge** in:
+- `README.md` — `![updated](https://img.shields.io/badge/YYYY--MM--DD-gray?style=flat)`
+- `README_CN.md` — same badge format
+
+Use today's date (`YYYY-MM-DD`) for the badge.
+
+### Step 3 — Update What's New (All 4 Doc Files)
+
+The `What's New` / `最新更新` section must contain **only the most recent release's changes**. Previous entries should be removed from this section (they live in CHANGELOG or release notes files).
+
+Update these 4 files' `What's New` / `最新更新` block consistently:
+- `plugins/{type}/{name}/README.md`
+- `plugins/{type}/{name}/README_CN.md`
+- `docs/plugins/{type}/{name}.md`
+- `docs/plugins/{type}/{name}.zh.md`
+
+### Step 4 — Create Bilingual Release Notes Files
+
+Create two versioned release notes files:
+
+**Path**: `plugins/{type}/{name}/v{version}.md`
+**Path**: `plugins/{type}/{name}/v{version}_CN.md`
+
+#### Required Sections
+
+Each file must include:
+1. **Title**: `# v{version} Release Notes` (EN) / `# v{version} 版本发布说明` (CN)
+2. **Overview**: One paragraph summarizing this release
+3. **New Features** / **新功能**: Bulleted list of features
+4. **Bug Fixes** / **问题修复**: Bulleted list of fixes
+5. **Migration Notes** / **迁移说明**: Breaking changes or Valve key renames (omit section if none)
+6. **Companion Plugins** / **配套插件** (optional): If a companion plugin was updated
+
+If a release notes file already exists for this version, update it rather than creating a new one.
+
+#### Full Coverage Rule (Mandatory)
+
+Release notes must cover **all updates in the current release scope** and not only headline features.
+
+Minimum required coverage in both EN/CN files:
+- New features and capability enhancements
+- Bug fixes and reliability fixes
+- Documentation/README/doc-mirror updates that affect user understanding or usage
+- Terminology/i18n/wording fixes that change visible behavior or messaging
+
+Before commit, cross-check release notes against `git diff` and ensure no meaningful update is omitted.
+
+### Step 5 — Verify Consistency (Pre-Commit Check)
+
+Run the consistency check script:
+
+```bash
+python3 scripts/check_version_consistency.py
+```
+
+If issues are found, fix them before proceeding. Do not commit with inconsistencies.
+
+### Step 6 — Draft Conventional Commits Message
+
+Generate the commit message following `commit-message.instructions.md` rules:
+- **Language**: English ONLY
+- **Format**: `type(scope): subject` + blank line + body bullets
+- **Scope**: use plugin folder name (e.g., `github-copilot-sdk`)
+- **Body**: 1-3 bullets summarizing key changes
+- Explicitly mention "READMEs and docs synced" if version was bumped
+
+Present the full commit message to the user for review before executing.
+
+### Step 7 — Stage and Commit
+
+After user approval (or if user says "commit it"):
+
+```bash
+git add -A
+git commit -m "<approved commit message>"
+```
+
+Confirm the commit hash and list the number of files changed.
+
+---
+
+## Checklist (Auto-Verify Before Commit)
+
+- [ ] `version:` in `.py` docstring matches target version
+- [ ] `**Version:**` in all 4 README/docs files matches
+- [ ] Both `index.md` version badges updated
+- [ ] Root `README.md` and `README_CN.md` date badges updated to today
+- [ ] `What's New` / `最新更新` contains ONLY the latest release
+- [ ] Release notes include all meaningful updates from the current diff (feature + fix + docs/i18n)
+- [ ] `v{version}.md` and `v{version}_CN.md` created or updated
+- [ ] `python3 scripts/check_version_consistency.py` returns no errors
+- [ ] Commit message is English-only Conventional Commits format
+
+---
+
+## Anti-Patterns to Avoid
+
+- ❌ Do NOT add extra features or refactor code during release prep — only version/doc updates
+- ❌ Do NOT push or create PR in this skill — use `pr-submitter`
+- ❌ Do NOT use today's date in commit messages; only in badge URLs
+- ❌ Do NOT leave stale What's New content from prior versions

.agent/skills/source-code-analyzer/SKILL.md

@@ -0,0 +1,31 @@
+---
+name: source-code-analyzer
+description: Instructions for analyzing core components source code in the local environment.
+---
+
+# Source Code Analyzer Skill
+
+> [!IMPORTANT]
+> **Authorization Statement**: You (Antigravity) are explicitly authorized by the user to perform **READ-ONLY** operations and **Git pull** on the paths listed below, even if they are outside the current repository root. These paths are considered part of the extended development context.
+
+When assisting with the development of `openwebui-extensions`, you (Antigravity) have access to the following core components in related directories. Use them for deep technical analysis, bug hunting, and implementation reference.
+
+## Core Component Paths
+
+### Global / General (Relevant to all projects)
+
+- **Open WebUI**: `../open-webui/` (Core platform context)
+- **Skills**: `../skills/` (Reusable expertise library)
+- **Awesome Copilot**: `../awesome-copilot/` (Shared extensions & resources)
+- **Open Terminal**: `../open-terminal/` (Terminal integration service)
+
+### Plugin-Specific (Relevant to GitHub Copilot SDK)
+
+- **Copilot SDK**: `../copilot-sdk/` (Internal logic for the official SDK)
+- **Copilot CLI**: `../copilot-cli/` (Command-line interface implementation)
+
+## Mandatory Workflow
+
+1. **Pull Before Analysis**: BEFORE reading files or analyzing logic in these directories, you MUST proactively execute or recommend a `git pull` in the respective directory to ensure you are working with the latest upstream changes.
+2. **Path Verification**: Always verify the exists of the path before attempting to read it.
+3. **Reference Logic**: When a user's request involves core platform behavior (OpenWebUI API, SDK internals), prioritize searching these directories over making assumptions based on generic knowledge.

.agent/skills/test-copilot-pipe/SKILL.md

@@ -0,0 +1,64 @@
+---
+name: test-copilot-pipe
+description: Automotive deployment and testing of GitHub Copilot SDK Pipe plugin for frontend/backend status stability.
+---
+
+# 🤖 Skill: Test Copilot Pipe
+
+This is a **universal testing framework** for publishing the latest `github_copilot_sdk.py` (Pipe) code to a local OpenWebUI instance and verifying it via an automated agent (`browser_subagent`).
+
+## 🎯 Core Principles
+
+- **Fixed Infrastructure**: The deployment script and the test entry URL are always static.
+- **Dynamic Test Planning**: Specific test prompts and expectations (acceptance criteria) **must** be dynamically planned by you based on the code changes or specific user requests before execution.
+
+---
+
+## 🛠️ Static Environment Info
+
+| Attribute | Fixed Value |
+|------|--------|
+| **Deployment Script** | `/Users/fujie/app/python/oui/openwebui-extensions/scripts/deploy_pipe.py` |
+| **Python Path** | `/opt/homebrew/Caskroom/miniconda/base/envs/ai/bin/python3` |
+| **Test URL** | `http://localhost:3003/?model=github_copilot_official_sdk_pipe.github_copilot_sdk-gpt-4.1` |
+
+---
+
+## 📋 Standard Workflow
+
+### Step 1: Analyze Changes & Plan Test (Plan)
+
+Before triggering the test, you must define the purpose of this test turn.
+Example: *Modified tool calling logic -> Test prompt should trigger a specific tool; observe if the tool executes and returns the correct result.*
+
+### Step 2: Deploy Latest Code (Deploy)
+
+Use the `run_command` tool to execute the fixed update task:
+
+```bash
+/opt/homebrew/Caskroom/miniconda/base/envs/ai/bin/python3 /Users/fujie/app/python/oui/openwebui-extensions/scripts/deploy_pipe.py
+```
+
+> **Mechanism**: `deploy_pipe.py` automatically loads the API Key from `scripts/.env` in the same directory.
+> **Verification**: Look for `✅ Successfully updated... version X.X.X` or `✅ Successfully created...`. If a 401 error occurs, remind the user to generate a new API Key in OpenWebUI and update `.env`.
+
+### Step 3: Verify via Browser Subagent (Verify)
+
+Use the `browser_subagent` tool. **You must fill in the `[Dynamic Content]` slots based on Step 1**:
+
+```text
+Task:
+1. Access The Fixed URL: http://localhost:3003/?model=github_copilot_official_sdk_pipe.github_copilot_sdk-gpt-4.1
+2. RELIABILITY WAIT: Wait until the page fully loads. Wait until the chat input text area (`#chat-input`) is present in the DOM.
+3. ACTION - FAST INPUT: Use the `execute_browser_javascript` tool to instantly inject the query and submit it. Use exactly this script format to ensure stability:
+   `const input = document.getElementById('chat-input'); input.value = "[YOUR_DYNAMIC_TEST_PROMPT]"; input.dispatchEvent(new Event('input', { bubbles: true })); const e = new KeyboardEvent('keydown', { key: 'Enter', code: 'Enter', keyCode: 13, which: 13, bubbles: true }); input.dispatchEvent(e);`
+4. WAITING: Wait patiently for the streaming response to stop completely. You should wait for the Stop button to disappear, or wait for the system to settle (approximately 10-15 seconds depending on the query).
+5. CHECK THE OUTCOME: [List the phenomena you expect to see, e.g., status bar shows specific text, tool card appears, result contains specific keywords, etc.]
+6. CAPTURE: Take a screenshot of the settled state to prove the outcome.
+7. REPORT: Report the EXACT outcome matching the criteria from step 5.
+```
+
+### Step 4: Evaluate & Iterate (Evaluate)
+
+- **PASS**: Screenshot and phenomena match expectations. Report success to the user.
+- **FAIL**: Analyze the issue based on screenshots/logs (e.g., race condition reappeared, API error). Modify the code and **re-run the entire skill workflow**.

.agent/skills/version-bumper/SKILL.md

@@ -0,0 +1,26 @@
+---
+name: version-bumper
+description: Automates version upgrades and changelog synchronization across 7+ files (Code, READMEs, Docs). Use when a plugin is ready for release to ensure version consistency.
+---
+
+# Version Bumper
+
+## Overview
+This skill ensures that every version upgrade is synchronized across the entire repository, following the strict "Documentation Sync" rule in GEMINI.md.
+
+## Workflow
+1. **Prepare Info**: Gather the new version number and brief changelogs in both English and Chinese.
+2. **Auto-Patch**: The skill will help you identify and update:
+   - `plugins/.../name.py` (docstring version)
+   - `plugins/.../README.md` (metadata & What's New)
+   - `plugins/.../README_CN.md` (metadata & 最新更新)
+   - `docs/plugins/...md` (mirrors)
+   - `docs/plugins/index.md` (version badge)
+   - `README.md` (updated date badge)
+3. **Verify**: Check the diffs to ensure no formatting was broken.
+
+## Tool Integration
+Execute the bump script (draft):
+```bash
+python3 scripts/bump.py <version> "<message_en>" "<message_zh>"
+```

.agent/skills/version-bumper/scripts/bump.py

@@ -0,0 +1,70 @@
+#!/usr/bin/env python3
+import sys
+import os
+import re
+from datetime import datetime
+
+def patch_file(file_path, old_pattern, new_content, is_regex=False):
+    if not os.path.exists(file_path):
+        print(f"Warning: File not found: {file_path}")
+        return False
+    
+    with open(file_path, 'r', encoding='utf-8') as f:
+        content = f.read()
+    
+    if is_regex:
+        new_content_result = re.sub(old_pattern, new_content, content, flags=re.MULTILINE)
+    else:
+        new_content_result = content.replace(old_pattern, new_content)
+    
+    if new_content_result != content:
+        with open(file_path, 'w', encoding='utf-8') as f:
+            f.write(new_content_result)
+        print(f"✅ Patched: {file_path}")
+        return True
+    else:
+        print(f"ℹ️ No change needed: {file_path}")
+        return False
+
+def bump_version(plugin_type, plugin_name, new_version, msg_en, msg_zh):
+    print(f"🚀 Bumping {plugin_name} ({plugin_type}) to {new_version}...")
+    
+    today = datetime.now().strftime("%Y-%m-%d")
+    today_badge = today.replace("-", "--")
+    
+    # 1. Patch Plugin Python File
+    py_file = f"plugins/{plugin_type}/{plugin_name}/{plugin_name}.py"
+    patch_file(py_file, r"version: \d+\.\d+\.\d+", f"version: {new_version}", is_regex=True)
+    
+    # 2. Patch Plugin READMEs
+    readme_en = f"plugins/{plugin_type}/{plugin_name}/README.md"
+    readme_zh = f"plugins/{plugin_type}/{plugin_name}/README_CN.md"
+    
+    # Update version in metadata
+    patch_file(readme_en, r"\*\*Version:\*\* \d+\.\d+\.\d+", f"**Version:** {new_version}", is_regex=True)
+    patch_file(readme_zh, r"\*\*版本:\*\* \d+\.\d+\.\d+", f"**版本:** {new_version}", is_regex=True)
+    
+    # Update What's New (Assuming standard headers)
+    patch_file(readme_en, r"## 🔥 What's New in v.*?\n", f"## 🔥 What's New in v{new_version}\n\n* {msg_en}\n", is_regex=True)
+    patch_file(readme_zh, r"## 🔥 最新更新 v.*?\n", f"## 🔥 最新更新 v{new_version}\n\n* {msg_zh}\n", is_regex=True)
+    
+    # 3. Patch Docs Mirrors
+    doc_en = f"docs/plugins/{plugin_type}/{plugin_name}.md"
+    doc_zh = f"docs/plugins/{plugin_type}/{plugin_name}.zh.md"
+    patch_file(doc_en, r"\*\*Version:\*\* \d+\.\d+\.\d+", f"**Version:** {new_version}", is_regex=True)
+    patch_file(doc_zh, r"\*\*版本:\*\* \d+\.\d+\.\d+", f"**版本:** {new_version}", is_regex=True)
+    
+    # 4. Patch Root READMEs (Updated Date Badge)
+    patch_file("README.md", r"badge/202\d--\d\d--\d\d-gray", f"badge/{today_badge}-gray", is_regex=True)
+    patch_file("README_CN.md", r"badge/202\d--\d\d--\d\d-gray", f"badge/{today_badge}-gray", is_regex=True)
+
+    print("\n✨ All synchronization tasks completed.")
+    return True
+
+if __name__ == "__main__":
+    if len(sys.argv) < 6:
+        print("Usage: bump.py <type> <name> <version> <msg_en> <msg_zh>")
+        print("Example: bump.py filters markdown_normalizer 1.2.8 'Fix bug' '修复错误'")
+        sys.exit(1)
+    
+    bump_version(sys.argv[1], sys.argv[2], sys.argv[3], sys.argv[4], sys.argv[5])

.agent/workflows/plugin-development.md

@@ -4,30 +4,39 @@ description: OpenWebUI Plugin Development & Release Workflow
 
 # OpenWebUI Plugin Development Workflow
 
-This workflow outlines the standard process for developing, documenting, and releasing plugins for OpenWebUI, ensuring compliance with project standards and CI/CD requirements.
+This workflow outlines the standard process for developing, documenting, and releasing plugins for OpenWebUI. **Crucially, the default goal of this workflow is "Preparation" (updating all relevant files) rather than automatic "Submission" (git commit/push), unless a release is explicitly requested.**
 
 ## 1. Development Standards
 
 Reference: `.github/copilot-instructions.md`
 
 ### Bilingual Requirement
-Every plugin **MUST** have bilingual versions for both code and documentation:
 
-- **Code**:
+Every plugin **MUST** have a single internationalized code file and bilingual documentation:
-  - English: `plugins/{type}/{name}/{name}.py`
+
-  - Chinese: `plugins/{type}/{name}/{name_cn}.py` (or `中文名.py`)
+- **Code (i18n)**:
+  - `plugins/{type}/{name}/{name}.py`
+  - The single `.py` file must implement internal i18n (e.g., using `navigator.language` or backend headers) to support multiple languages natively, rather than splitting into separate files.
 - **README**:
   - English: `plugins/{type}/{name}/README.md`
   - Chinese: `plugins/{type}/{name}/README_CN.md`
 
 ### Code Structure
+
 - **Docstring**: Must include `title`, `author`, `version`, `description`, etc.
 - **Valves**: Use `pydantic` for configuration.
 - **Database**: Re-use `open_webui.internal.db` shared connection.
 - **User Context**: Use `_get_user_context` helper method.
+- **Chat Context**: Use `_get_chat_context` helper method for `chat_id` and `message_id`.
+- **Debugging**: Use `_emit_debug_log` for frontend console logging (requires `SHOW_DEBUG_LOG` valve).
+- **Chat API**: For message updates, follow the "OpenWebUI Chat API 更新规范" in `.github/copilot-instructions.md`.
+  - Use Event API for immediate UI updates
+  - Use Chat Persistence API for database storage
+  - Always update both `messages[]` and `history.messages`
 
-### Commit Messages
+### Commit Messages & Release Notes
-- **Language**: **English ONLY**. Do not use Chinese in commit messages.
+
+- **Language**: **English ONLY**. Do not use Chinese in commit messages or release notes.
 - **Format**: Conventional Commits (e.g., `feat:`, `fix:`, `docs:`).
 
 ## 2. Documentation Updates
@@ -35,10 +44,16 @@ Every plugin **MUST** have bilingual versions for both code and documentation:
 When adding or updating a plugin, you **MUST** update the following documentation files to maintain consistency:
 
 ### Plugin Directory
-- `README.md`: Update version, description, and usage. **Explicitly describe new features.**
+
-- `README_CN.md`: Update version, description, and usage. **Explicitly describe new features.**
+- `README.md`: Update version, description, and usage.
+  - **Key Capabilities**: **MUST** include ALL core functionalities and features. This is a cumulative section. Every release **MUST** verify that basic core descriptions are NOT lost or overwritten by new feature lists.
+  - **What's New**: Explicitly describe only the latest changes/updates in a prominent position at the beginning. This section is dynamic and changes with versions.
+- `README_CN.md`: Update version, description, and usage.
+  - **核心功能 (Key Capabilities)**: **必须**包含所有核心功能和特性。这是一个累积性的部分，每次版本更新**必须**确认基础核心功能的描述没有丢失或被新功能列表覆盖。
+  - **最新更新 (What's New)**: 在开头显眼位置明确描述最新的更改/更新。此部分是动态的，随版本变化。
 
 ### Global Documentation (`docs/`)
+
 - **Index Pages**:
   - `docs/plugins/{type}/index.md`: Add/Update list item with **correct version**.
   - `docs/plugins/{type}/index.zh.md`: Add/Update list item with **correct version**.
@@ -47,6 +62,7 @@ When adding or updating a plugin, you **MUST** update the following documentatio
   - `docs/plugins/{type}/{name}.zh.md`: Ensure content matches README_CN.
 
 ### Root README
+
 - `README.md`: Add to "Featured Plugins" if applicable.
 - `README_CN.md`: Add to "Featured Plugins" if applicable.
 
@@ -55,31 +71,59 @@ When adding or updating a plugin, you **MUST** update the following documentatio
 Reference: `.github/workflows/release.yml`
 
 ### Version Bumping
+
 - **Rule**: Version bump is required **ONLY when the user explicitly requests a release**. Regular code changes do NOT require version bumps.
 - **Format**: Semantic Versioning (e.g., `1.0.0` -> `1.0.1`).
 - **When to Bump**: Only update the version when:
   - User says "发布" / "release" / "bump version"
   - User explicitly asks to prepare for release
-- **Agent Initiative**: After completing significant changes (new features, bug fixes, or multiple code modifications), the agent **SHOULD proactively ask** the user if they want to release a new version. If confirmed, update all version-related files.
+- **Agent Initiative**: After completing significant changes (new features, bug fixes, or multiple code modifications), the agent **SHOULD proactively ask** the user if they want to **prepare a new version** for release.
+- **Release Information Compliance**: When a release is requested, the agent must generate a standard release summary (English commit title + bilingual bullet points) as defined in Section 3 & 5.
+- **Default Action (Prepare Only)**: When performing a version bump or update, the agent should update all files locally but **STOP** before committing. Present the changes and the **proposed Release/Commit Message** to the user and wait for explicit confirmation to commit/push.
 - **Consistency**: When bumping, update version in **ALL** locations:
-  1. English Code (`.py`)
+  1. Code (`.py`)
-  2. Chinese Code (`.py`)
+  2. English README (`README.md`)
-  3. English README (`README.md`)
+  3. Chinese README (`README_CN.md`)
-  4. Chinese README (`README_CN.md`)
+  4. Docs Index (`docs/.../index.md`)
-  5. Docs Index (`docs/.../index.md`)
+  5. Docs Index CN (`docs/.../index.zh.md`)
-  6. Docs Index CN (`docs/.../index.zh.md`)
+  6. Docs Detail (`docs/.../{name}.md`)
-  7. Docs Detail (`docs/.../{name}.md`)
+  7. Docs Detail CN (`docs/.../{name}.zh.md`)
-  8. Docs Detail CN (`docs/.../{name}.zh.md`)
 
 ### Automated Release Process
-1.  **Trigger**: Push to `main` branch with changes in `plugins/**/*.py`.
+
-2.  **Detection**: `scripts/extract_plugin_versions.py` detects changed plugins and compares versions.
+1. **Trigger**: Push to `main` branch with changes in `plugins/**/*.py`.
-3.  **Release**:
+2. **Detection**: `scripts/extract_plugin_versions.py` detects changed plugins and compares versions.
+3. **Release**:
     - Generates release notes based on changes.
     - Creates a GitHub Release tag (e.g., `v2024.01.01-1`).
     - Uploads individual `.py` files of **changed plugins only** as assets.
+4. **Market Publishing**:
+    - Workflow: `.github/workflows/publish_plugin.yml`
+    - Trigger: Release published.
+    - Action: Automatically updates the plugin code and metadata on OpenWebUI.com using `scripts/publish_plugin.py`.
+    - **Auto-Sync**: If a local plugin has no ID but matches an existing published plugin by **Title**, the script will automatically fetch the ID, update the local file, and proceed with the update.
+    - Requirement: `OPENWEBUI_API_KEY` secret must be set.
+    - **README Link**: When announcing a release, always include the GitHub README URL for the plugin:
+      - Format: `https://github.com/Fu-Jie/openwebui-extensions/blob/main/plugins/{type}/{name}/README.md`
+      - Example: `https://github.com/Fu-Jie/openwebui-extensions/blob/main/plugins/filters/folder-memory/README.md`
+
+### Release Content Standard
+
+When the user confirms a release, the agent **MUST** follow these content standards:
+
+1. **Commit Message**:
+   - **Language**: English ONLY.
+   - **Format**: `type(scope): description` (e.g., `feat(pipes): add streaming support for Copilot SDK`).
+   - **Body**: List 1-3 key changes in bullet points.
+2. **Release Summary (for user review)**:
+   - Before committing, present a "Release Draft" containing:
+     - **Title**: e.g., `Release v0.1.1: [Plugin Name] - [Brief Summary]`
+     - **Changelog**: English-only list of commits since the last release, including hashes (e.g., `896de02 docs(config): reorder antigravity model alias example`).
+     - **Verification Status**: Confirm all 7+ files have been updated and synced.
+3. **Internal Documentation**: Ensure "What's New" sections in READMEs and `docs/` match exactly the changes being released.
 
 ### Pull Request Check
+
 - Workflow: `.github/workflows/plugin-version-check.yml`
 - Checks if plugin files are modified.
 - **Fails** if version number is not updated.
@@ -89,15 +133,17 @@ Reference: `.github/workflows/release.yml`
 
 Before committing:
 
-- [ ] Code is bilingual and functional?
+- [ ] Code is internal i18n supported (`.py`) and fully functional?
 - [ ] Docstrings have updated version?
 - [ ] READMEs are updated and bilingual?
+- [ ] **Key Capabilities** in READMEs still cover all legacy core features + new features?
 - [ ] `docs/` index and detail pages are updated?
 - [ ] Root `README.md` is updated?
 - [ ] All version numbers match exactly?
 
 ## 5. Git Operations (Agent Rules)
 
-Strictly follow the rules defined in `.github/copilot-instructions.md` → **Git Operations (Agent Rules)** section.
+1. **Prepare-on-Demand**: Focus on file modifications and local verification first.
-
+2. **No Auto-Commit**: Never `git commit`, `git push`, or `create_pull_request` automatically after file updates unless the user explicitly says "commit this" or "release now".
-
+3. **Draft Mode**: If available, use PRs as drafts first.
+4. **Reference**: Strictly follow the rules defined in `.github/copilot-instructions.md` → **Git Operations (Agent Rules)** section.

.all-contributorsrc

@@ -0,0 +1,65 @@
+{
+  "files": [
+    "README.md"
+  ],
+  "imageSize": 100,
+  "commit": false,
+  "commitType": "docs",
+  "commitConvention": "angular",
+  "contributors": [
+    {
+      "login": "rbb-dev",
+      "name": "rbb-dev",
+      "avatar_url": "https://avatars.githubusercontent.com/u/37469229?v=4",
+      "profile": "https://github.com/rbb-dev",
+      "contributions": [
+        "ideas",
+        "code"
+      ]
+    },
+    {
+      "login": "dhaern",
+      "name": "Raxxoor",
+      "avatar_url": "https://avatars.githubusercontent.com/u/7317522?v=4",
+      "profile": "https://trade.xyz/?ref=BZ1RJRXWO",
+      "contributions": [
+        "bug",
+        "ideas"
+      ]
+    },
+    {
+      "login": "i-iooi-i",
+      "name": "ZOLO",
+      "avatar_url": "https://avatars.githubusercontent.com/u/1827701?v=4",
+      "profile": "https://github.com/i-iooi-i",
+      "contributions": [
+        "bug",
+        "ideas"
+      ]
+    },
+    {
+      "login": "nahoj",
+      "name": "Johan Grande",
+      "avatar_url": "https://avatars.githubusercontent.com/u/469017?v=4",
+      "profile": "https://perso.crans.org/grande/",
+      "contributions": [
+        "ideas"
+      ]
+    },
+    {
+      "login": "abaroni",
+      "name": "Alessandro Baroni",
+      "avatar_url": "https://avatars.githubusercontent.com/u/21365486?v=4",
+      "profile": "https://github.com/abaroni",
+      "contributions": [
+        "ideas"
+      ]
+    }
+  ],
+  "contributorsPerLine": 7,
+  "skipCi": true,
+  "repoType": "github",
+  "repoHost": "https://github.com",
+  "projectName": "openwebui-extensions",
+  "projectOwner": "Fu-Jie"
+}

.gemini/skills/README.md

@@ -0,0 +1,71 @@
+# Agent Skills Index
+
+This folder contains reusable Agent Skills for GitHub Copilot / VS Code custom agent workflows.
+
+## Available Skills
+
+- **community-announcer**
+  - Purpose: Generate community announcement content and related assets.
+  - Entry: `community-announcer/SKILL.md`
+
+- **doc-mirror-sync**
+  - Purpose: Sync mirrored documentation content and helper scripts.
+  - Entry: `doc-mirror-sync/SKILL.md`
+
+- **gh-issue-replier**
+  - Purpose: Draft standardized issue replies with templates.
+  - Entry: `gh-issue-replier/SKILL.md`
+
+- **gh-issue-scheduler**
+  - Purpose: Schedule and discover unanswered issues for follow-up.
+  - Entry: `gh-issue-scheduler/SKILL.md`
+
+- **i18n-validator**
+  - Purpose: Validate translation key consistency across i18n dictionaries.
+  - Entry: `i18n-validator/SKILL.md`
+
+- **plugin-scaffolder**
+  - Purpose: Scaffold OpenWebUI plugin boilerplate with repository standards.
+  - Entry: `plugin-scaffolder/SKILL.md`
+
+- **version-bumper**
+  - Purpose: Assist with semantic version bumping workflows.
+  - Entry: `version-bumper/SKILL.md`
+
+- **xlsx-single-file**
+  - Purpose: Single-file spreadsheet operations workflow without LibreOffice.
+  - Entry: `xlsx-single-file/SKILL.md`
+
+---
+
+## Release Pipeline Skills
+
+These four skills form a complete release pipeline and are designed to be used in sequence:
+
+```
+release-prep  →  pr-submitter  →  pr-reviewer  →  release-finalizer
+ (prepare)       (push & PR)      (respond to review)  (merge & close issue)
+```
+
+- **release-prep**
+  - Purpose: Full release preparation — version sync across 7+ files, bilingual release notes creation, consistency check, and commit.
+  - Entry: `release-prep/SKILL.md`
+
+- **pr-submitter**
+  - Purpose: Shell-escape-safe PR submission — writes body to temp file, validates sections, pushes branch, creates PR via `gh pr create --body-file`.
+  - Entry: `pr-submitter/SKILL.md`
+
+- **pr-reviewer**
+  - Purpose: Fetch PR review comments, categorize feedback, implement fixes, commit and push, reply to reviewers.
+  - Entry: `pr-reviewer/SKILL.md`
+
+- **release-finalizer**
+  - Purpose: Merge release PR to main with proper commit message, auto-link and close related issues, post closing messages.
+  - Entry: `release-finalizer/SKILL.md`
+
+## Notes
+
+- Skill definitions follow the expected location pattern:
+  - `.github/skills/<skill-name>/SKILL.md`
+- Each skill may include optional `assets/`, `references/`, and `scripts/` folders.
+- This directory mirrors `.gemini/skills` for compatibility.

.gemini/skills/community-announcer/SKILL.md

@@ -0,0 +1,23 @@
+---
+name: community-announcer
+description: Drafts engaging English and Chinese update announcements for the OpenWebUI Community and other social platforms. Use when a new version is released.
+---
+
+# Community Announcer
+
+## Overview
+Automates the drafting of high-impact update announcements.
+
+## Workflow
+1. **Source Intel**: Read the latest version's `What's New` section from `README.md`.
+2. **Drafting**: Create two versions:
+   - **Community Post**: Professional, structured, technical.
+   - **Catchy Short**: For Discord/Twitter, use emojis and bullet points.
+3. **Multi-language**: Generate BOTH English and Chinese versions automatically.
+
+## Announcement Structure (Recommended)
+- **Headline**: "Update vX.X.X - [Main Feature]"
+- **Introduction**: Brief context.
+- **Key Highlights**: Bulleted list of fixes/features.
+- **Action**: "Download from [Market Link]"
+- **Closing**: Thanks and Star request.

.gemini/skills/doc-mirror-sync/SKILL.md

@@ -0,0 +1,50 @@
+---
+name: doc-mirror-sync
+description: Automatically synchronizes plugin READMEs to the official documentation directory (docs/). Use after editing a plugin's local documentation to keep the MkDocs site up to date.
+---
+
+# Doc Mirror Sync
+
+## Overview
+Automates the mirroring of `plugins/{type}/{name}/README.md` to `docs/plugins/{type}/{name}.md`.
+
+## Docs-Only Mode (No Release Changes)
+Use this mode when the request is "only sync docs".
+
+- Only update documentation mirror files under `docs/plugins/**`.
+- Do **not** bump plugin version.
+- Do **not** modify plugin code (`plugins/**.py`) unless explicitly requested.
+- Do **not** update root badges/dates for release.
+- Do **not** run release preparation steps.
+
+## Workflow
+1. Identify changed READMEs.
+2. Copy content to corresponding mirror paths.
+3. Update version badges in `docs/plugins/{type}/index.md`.
+
+## Commands
+
+### Sync all mirrors (EN + ZH)
+
+```bash
+python .github/skills/doc-mirror-sync/scripts/sync.py
+```
+
+### Sync only one plugin (EN only)
+
+```bash
+cp plugins/<type>/<name>/README.md docs/plugins/<type>/<name>.md
+```
+
+### Sync only one plugin (EN + ZH)
+
+```bash
+cp plugins/<type>/<name>/README.md docs/plugins/<type>/<name>.md
+cp plugins/<type>/<name>/README_CN.md docs/plugins/<type>/<name>.zh.md
+```
+
+## Notes
+
+- If asked for English-only update, sync only `README.md` -> `.md` mirror.
+- If both languages are requested, sync both `README.md` and `README_CN.md`.
+- After syncing, verify git diff only contains docs file changes.

.gemini/skills/doc-mirror-sync/scripts/sync.py

@@ -0,0 +1,38 @@
+#!/usr/bin/env python3
+import os
+import shutil
+import re
+
+def sync_mirrors():
+    plugins_root = "plugins"
+    docs_root = "docs/plugins"
+    
+    types = ["actions", "filters", "pipes", "pipelines", "tools"]
+    
+    for t in types:
+        src_type_dir = os.path.join(plugins_root, t)
+        dest_type_dir = os.path.join(docs_root, t)
+        
+        if not os.path.exists(src_type_dir): continue
+        os.makedirs(dest_type_dir, exist_ok=True)
+        
+        for name in os.listdir(src_type_dir):
+            plugin_dir = os.path.join(src_type_dir, name)
+            if not os.path.isdir(plugin_dir): continue
+            
+            # Sync README.md -> docs/plugins/{type}/{name}.md
+            src_readme = os.path.join(plugin_dir, "README.md")
+            if os.path.exists(src_readme):
+                dest_readme = os.path.join(dest_type_dir, f"{name}.md")
+                shutil.copy(src_readme, dest_readme)
+                print(f"✅ Mirrored: {t}/{name} (EN)")
+            
+            # Sync README_CN.md -> docs/plugins/{type}/{name}.zh.md
+            src_readme_cn = os.path.join(plugin_dir, "README_CN.md")
+            if os.path.exists(src_readme_cn):
+                dest_readme_zh = os.path.join(dest_type_dir, f"{name}.zh.md")
+                shutil.copy(src_readme_cn, dest_readme_zh)
+                print(f"✅ Mirrored: {t}/{name} (ZH)")
+
+if __name__ == "__main__":
+    sync_mirrors()

.gemini/skills/gh-issue-replier/SKILL.md

@@ -0,0 +1,51 @@
+---
+name: gh-issue-replier
+description: Professional English replier for GitHub issues. Use when a task is completed, a bug is fixed, or more info is needed from the user. Automates replying using the 'gh' CLI tool.
+---
+
+# Gh Issue Replier
+
+## Overview
+
+The `gh-issue-replier` skill enables Gemini CLI to interact with GitHub issues professionally. It enforces English for all communications and leverages the `gh` CLI to post comments.
+
+## Workflow
+
+1.  **Identify the Issue**: Find the issue number (e.g., #49).
+2.  **Check Star Status**: Run the bundled script to check if the author has starred the repo.
+    *   Command: `bash scripts/check_star.sh <issue-number>`
+    *   Interpretation: 
+        *   Exit code **0**: User has starred. Use "Already Starred" templates.
+        *   Exit code **1**: User has NOT starred. Include "Star Request" in the reply.
+3.  **Select a Template**: Load [templates.md](references/templates.md) to choose a suitable English response pattern.
+4.  **Draft the Reply**: Compose a concise message based on the star status.
+5.  **Post the Comment**: Use the `gh` tool to submit the reply.
+
+## Tool Integration
+
+### Check Star Status
+```bash
+bash scripts/check_star.sh <issue-number>
+```
+
+### Post Comment
+```bash
+gh issue comment <issue-number> --body "<message-body>"
+```
+
+Example (if user has NOT starred):
+```bash
+gh issue comment 49 --body "This has been fixed in v1.2.7. If you find this helpful, a star on the repo would be much appreciated! ⭐"
+```
+
+Example (if user HAS starred):
+```bash
+gh issue comment 49 --body "This has been fixed in v1.2.7. Thanks for your support!"
+```
+
+## Guidelines
+
+-   **Language**: ALWAYS use English for the comment body, even if the system prompt or user conversation is in another language.
+-   **Tone**: Professional, helpful, and appreciative.
+-   **Precision**: When announcing a fix, mention the specific version or the logic change (e.g., "Updated regex pattern").
+-   **Closing**: If the issue is resolved and you have permission, you can also use `gh issue close <number>`.

.gemini/skills/gh-issue-replier/references/example_reference.md

@@ -0,0 +1,17 @@
+# Reference Documentation for Gh Issue Replier
+
+This is a placeholder for detailed reference documentation.
+Replace with actual reference content or delete if not needed.
+
+## Structure Suggestions
+
+### API Reference Example
+- Overview
+- Authentication
+- Endpoints with examples
+- Error codes
+
+### Workflow Guide Example
+- Prerequisites
+- Step-by-step instructions
+- Best practices

.gemini/skills/gh-issue-replier/references/templates.md

@@ -0,0 +1,45 @@
+# Issue Reply Templates
+
+Use these templates to craft professional English replies. Adjust placeholders like `@username`, `v1.2.x`, and `[commit hash]` as needed.
+
+## 1. Acknowledging a New Issue
+Use when you first see an issue and want to let the user know you are working on it.
+
+- "Thank you for reporting this! I'm looking into it right now."
+- "Thanks for bringing this to my attention. I'll try to reproduce this behavior and get back to you shortly."
+
+## 2. Requesting More Information
+Use when you need logs or specific details to fix the bug.
+
+- "Could you please provide the **'Original'** vs **'Normalized'** content from your browser console logs (F12)? It would help a lot in debugging."
+- "It would be very helpful if you could share the specific Markdown text that triggered this issue."
+
+## 3. Announcing a Fix
+Use when you have pushed the fix to the repository.
+
+- "This has been fixed in version **v1.2.x**. You can update the plugin to resolve it."
+- "I've just pushed a fix for this in [commit hash]. Please let me know if it works for you after updating."
+- "The issue was caused by a greedy regex pattern. I've updated it to use a tempered greedy token to prevent incorrect merging."
+
+## 4. Guiding to Official Market
+Always provide the official market link to ensure the user gets the latest verified version.
+
+- "The fix is now live! You can download the latest version from the official OpenWebUI Community page here: [Plugin Market Link]. Simply update the function in your OpenWebUI instance to apply the changes."
+- "I recommend getting the updated version from the official store: [Link]. It includes the fix for the spacing issue we discussed."
+
+## 5. Closing the Issue
+Use when the issue is confirmed resolved.
+
+- "Glad to hear it's working now! Closing this for now. Feel free to reopen it if the problem persists."
+- "Since this is resolved, I'm closing this issue. Thanks again for your feedback!"
+
+## 5. Pro-tip: Star Request
+Gently handle star requests based on the user's current status.
+
+### If User has NOT starred:
+- "If you find this plugin helpful, a star on the repo would be much appreciated! ⭐"
+- "We'd love your support! If this fixed your issue, please consider starring the repository. ⭐"
+
+### If User HAS already starred:
+- "Thanks again for starring the project and for your continuous support!"
+- "I appreciate your support and for being a stargazer of this project!"

.gemini/skills/gh-issue-replier/scripts/check_star.sh

@@ -0,0 +1,31 @@
+#!/usr/bin/env bash
+
+# Robust Star Checker v2
+# Usage: ./check_star.sh <issue_number>
+
+ISSUE_NUM=$1
+if [ -z "$ISSUE_NUM" ]; then exit 2; fi
+
+# 1. Get Repo and Author info
+REPO_FULL=$(gh repo view --json owner,name -q ".owner.login + \"/\" + .name")
+USER_LOGIN=$(gh issue view "$ISSUE_NUM" --json author -q ".author.login")
+
+# 2. Use GraphQL for high precision (Detects stars even when REST 404s)
+IS_STARRED=$(gh api graphql -f query='
+query($owner:String!, $repo:String!, $user:String!) {
+  repository(owner:$owner, name:$repo) {
+    stargazers(query:$user, first:1) {
+      nodes {
+        login
+      }
+    }
+  }
+}' -f owner="${REPO_FULL%/*}" -f repo="${REPO_FULL#*/}" -f user="$USER_LOGIN" -q ".data.repository.stargazers.nodes[0].login")
+
+if [ "$IS_STARRED" == "$USER_LOGIN" ]; then
+    echo "Confirmed: @$USER_LOGIN HAS starred $REPO_FULL. ⭐"
+    exit 0
+else
+    echo "Confirmed: @$USER_LOGIN has NOT starred $REPO_FULL."
+    exit 1
+fi

.gemini/skills/gh-issue-scheduler/SKILL.md

@@ -0,0 +1,42 @@
+---
+name: gh-issue-scheduler
+description: Finds all open GitHub issues that haven't been replied to by the owner, summarizes them, and generates a solution plan. Use when the user wants to audit pending tasks or plan maintenance work.
+---
+
+# Gh Issue Scheduler
+
+## Overview
+
+The `gh-issue-scheduler` skill helps maintainers track community feedback by identifying unaddressed issues and drafting actionable technical plans to resolve them.
+
+## Workflow
+
+1.  **Identify Unanswered Issues**: Run the bundled script to fetch issues without owner replies.
+    *   Command: `bash scripts/find_unanswered.sh`
+2.  **Analyze and Summarize**: For each identified issue, summarize the core problem and the user's intent.
+3.  **Generate Solution Plans**: Draft a technical "Action Plan" for each issue, including:
+    *   **Root Cause Analysis** (if possible)
+    *   **Proposed Fix/Implementation**
+    *   **Verification Strategy**
+4.  **Present to User**: Display a structured report of all pending issues and their respective plans.
+
+## Tool Integration
+
+### Find Unanswered Issues
+```bash
+bash scripts/find_unanswered.sh
+```
+
+## Report Format
+
+When presenting the summary, use the following Markdown structure:
+
+### 📋 Unanswered Issues Audit
+
+#### Issue #[Number]: [Title]
+- **Author**: @username
+- **Summary**: Concise description of the problem.
+- **Action Plan**:
+    1. Step 1 (e.g., Investigate file X)
+    2. Step 2 (e.g., Apply fix Y)
+    3. Verification (e.g., Run test Z)

.gemini/skills/gh-issue-scheduler/scripts/find_unanswered.sh

@@ -0,0 +1,42 @@
+#!/usr/bin/env bash
+
+# Fetch all open issues and filter for those without responses from the owner/collaborators.
+# Uses 'gh' CLI.
+
+REPO_FULL=$(gh repo view --json owner,name -q ".owner.login + "/" + .name")
+OWNER=${REPO_FULL%/*}
+
+# 1. Get all open issues
+OPEN_ISSUES=$(gh issue list --state open --json number,title,author,createdAt --limit 100)
+
+echo "Analysis for repository: $REPO_FULL"
+echo "------------------------------------"
+
+# Process each issue
+echo "$OPEN_ISSUES" | jq -c '.[]' | while read -r issue; do
+    NUMBER=$(echo "$issue" | jq -r '.number')
+    TITLE=$(echo "$issue" | jq -r '.title')
+    AUTHOR=$(echo "$issue" | jq -r '.author.login')
+    
+    # Check comments for owner responses
+    # We look for comments where the author is the repo owner
+    COMMENTS=$(gh issue view "$NUMBER" --json comments -q ".comments[].author.login" 2>/dev/null)
+    
+    HAS_OWNER_REPLY=false
+    for COMMENT_AUTHOR in $COMMENTS; do
+        if [ "$COMMENT_AUTHOR" == "$OWNER" ]; then
+            HAS_OWNER_REPLY=true
+            break
+        fi
+    done
+    
+    if [ "$HAS_OWNER_REPLY" == "false" ]; then
+        echo "ISSUE_START"
+        echo "ID: $NUMBER"
+        echo "Title: $TITLE"
+        echo "Author: $AUTHOR"
+        echo "Description:"
+        gh issue view "$NUMBER" --json body -q ".body"
+        echo "ISSUE_END"
+    fi
+done

.gemini/skills/i18n-validator/SKILL.md

@@ -0,0 +1,14 @@
+---
+name: i18n-validator
+description: Validates multi-language consistency in the TRANSLATIONS dictionary of a plugin. Use to check if any language keys are missing or if translations need updating.
+---
+
+# I18n Validator
+
+## Overview
+Ensures all 12 supported languages (en-US, zh-CN, etc.) have aligned translation keys.
+
+## Features
+- Detects missing keys in non-English dictionaries.
+- Suggests translations using the core AI engine.
+- Validates the `fallback_map` for variant redirects.

.gemini/skills/i18n-validator/scripts/validate_i18n.py

@@ -0,0 +1,54 @@
+#!/usr/bin/env python3
+import sys
+import ast
+import os
+
+def check_i18n(file_path):
+    if not os.path.exists(file_path):
+        print(f"Error: File not found {file_path}")
+        return
+    
+    with open(file_path, 'r', encoding='utf-8') as f:
+        tree = ast.parse(f.read())
+    
+    translations = {}
+    for node in tree.body:
+        if isinstance(node, ast.Assign):
+            for target in node.targets:
+                if isinstance(target, ast.Name) and target.id == "TRANSLATIONS":
+                    translations = ast.literal_eval(node.value)
+                    break
+    
+    if not translations:
+        print("⚠️ No TRANSLATIONS dictionary found.")
+        return
+
+    # Base keys from English
+    base_lang = "en-US"
+    if base_lang not in translations:
+        print(f"❌ Error: {base_lang} missing in TRANSLATIONS.")
+        return
+    
+    base_keys = set(translations[base_lang].keys())
+    print(f"🔍 Analyzing {file_path}...")
+    print(f"Standard keys ({len(base_keys)}): {', '.join(sorted(base_keys))}
+")
+
+    for lang, keys in translations.items():
+        if lang == base_lang: continue
+        lang_keys = set(keys.keys())
+        missing = base_keys - lang_keys
+        extra = lang_keys - base_keys
+        
+        if missing:
+            print(f"❌ {lang}: Missing {len(missing)} keys: {', '.join(missing)}")
+        if extra:
+            print(f"⚠️ {lang}: Has {len(extra)} extra keys: {', '.join(extra)}")
+        if not missing and not extra:
+            print(f"✅ {lang}: Aligned.")
+
+if __name__ == "__main__":
+    if len(sys.argv) < 2:
+        print("Usage: validate_i18n.py <path_to_plugin.py>")
+        sys.exit(1)
+    check_i18n(sys.argv[1])

.gemini/skills/openwebui-community-publisher/SKILL.md

@@ -0,0 +1,59 @@
+---
+name: openwebui-community-publisher
+description: Automatically publishes plugin update posts to openwebui.com. 
+---
+
+# OpenWebUI Community Publisher
+
+## Overview
+
+This skill automates the process of creating **new** plugin release notes and announcements directly on the OpenWebUI Community (openwebui.com).
+
+**Note**: This skill is exclusively for **new post creation**. Do NOT use this for updating existing posts, as updates are managed separately via dedicated scripts.
+
+## Prerequisites
+
+- User must be logged into [openwebui.com](https://openwebui.com) in the browser session.
+- The content must be prepared in Markdown format (typically following the structure of the plugin's changelog or a dedicated release `.md` file).
+
+## Execution Workflow
+
+### 1. Verification
+
+- Use `browser_subagent` to navigate to `https://openwebui.com`.
+- Verify the logged-in user status (look for profile icons or "@Fu-Jie").
+
+### 2. Post Creation
+
+- Navigate to `https://openwebui.com/post`.
+- **Post Type Selection**:
+  - Choose the appropriate tab based on content:
+    - **Text**: General announcements and documentation.
+    - **Tool**: Standalone tool plugins.
+    - **Function**: Pipes, Filters, or Actions.
+    - **Prompt**: Chat prompt templates.
+    - **Model**: GGUF/Ollama model files.
+  - Unless otherwise specified, default to **Text** for general release introductions.
+- **Community Selection**:
+  - For general OpenWebUI related posts, select **o/openwebui**.
+  - For specialized topics, select the relevant community (e.g., **o/ollama** for models).
+- **Metadata Mapping**:
+  - **Title**: Use the main header from the source file.
+  - **Content/Description**: Paste the Markdown body.
+  - **Source Code (for Function/Pipe)**: If publishing a `Function`, retrieve the corresponding `.py` file content and paste it into the code area.
+- **Tags**: Leave empty by default unless relevant keywords are explicitly provided.
+- **Media**: Optional, only attach if provided.
+- **Settings**: Ensure "Adult content" is unchecked.
+
+### 3. Submission & Validation
+
+- Click the "Create" (创建) button.
+- Wait for redirection to the final post URL.
+- **CRITICAL**: Use `capture_browser_screenshot` to verify the rendering.
+- Return the final URL to the user.
+
+## Design Standards
+
+- **Rich Aesthetics**: Use emojis in titles.
+- **Structured Data**: Ensure tables and code blocks in the Markdown are preserved.
+- **Internal Linking**: Link back to the OpenWebUI market or GitHub repository where applicable.

.gemini/skills/plugin-scaffolder/SKILL.md

@@ -0,0 +1,19 @@
+---
+name: plugin-scaffolder
+description: Generates a standardized single-file i18n Python plugin template based on project standards. Use when starting a new plugin development to skip boilerplate writing.
+---
+
+# Plugin Scaffolder
+
+## Overview
+Generates compliant OpenWebUI plugin templates with built-in i18n, common utility methods, and required docstring fields.
+
+## Usage
+1. Provide the **Plugin Name** and **Type** (action/filter/pipe).
+2. The skill will generate the `.py` file and the bilingual `README` files.
+
+## Template Standard
+- `Valves(BaseModel)` with `UPPER_SNAKE_CASE`
+- `_get_user_context` with JS fallback and timeout
+- `_emit_status` and `_emit_debug_log` methods
+- Standardized docstring metadata

.gemini/skills/plugin-scaffolder/assets/README_template.md

@@ -0,0 +1,34 @@
+# {{TITLE}}
+
+**Author:** [Fu-Jie](https://github.com/Fu-Jie/openwebui-extensions) | **Version:** 0.1.0 | **Project:** [OpenWebUI Extensions](https://github.com/Fu-Jie/openwebui-extensions) | **License:** MIT
+
+{{DESCRIPTION}}
+
+## 🔥 What's New in v0.1.0
+
+* Initial release of {{TITLE}}.
+
+## 🌐 Multilingual Support
+
+Supports automatic interface and status switching for the following languages:
+`English`, `简体中文`, `繁體中文 (香港)`, `繁體中文 (台灣)`, `한국어`, `日本語`, `Français`, `Deutsch`, `Español`, `Italiano`, `Tiếng Việt`, `Bahasa Indonesia`.
+
+## ✨ Core Features
+
+* Feature 1
+* Feature 2
+
+## How to Use 🛠️
+
+1. Install the plugin in Open WebUI.
+2. Configure settings in Valves.
+
+## Configuration (Valves) ⚙️
+
+| Parameter | Default | Description |
+| :--- | :--- | :--- |
+| `priority` | `50` | Execution priority. |
+
+## ⭐ Support
+
+If this plugin has been useful, a star on [OpenWebUI Extensions](https://github.com/Fu-Jie/openwebui-extensions) is a big motivation for me. Thank you for the support.

.gemini/skills/plugin-scaffolder/assets/template.py

@@ -0,0 +1,80 @@
+"""
+title: {{TITLE}}
+author: Fu-Jie
+author_url: https://github.com/Fu-Jie/openwebui-extensions
+funding_url: https://github.com/open-webui
+version: 0.1.0
+description: {{DESCRIPTION}}
+"""
+
+import asyncio
+import logging
+import json
+from typing import Optional, Dict, Any, List, Callable, Awaitable
+from pydantic import BaseModel, Field
+from fastapi import Request
+
+# Configure logging
+logging.basicConfig(level=logging.INFO, format="%(asctime)s - %(name)s - %(levelname)s - %(message)s")
+logger = logging.getLogger(__name__)
+
+TRANSLATIONS = {
+    "en-US": {"status_starting": "Starting {{TITLE}}..."},
+    "zh-CN": {"status_starting": "正在启动 {{TITLE}}..."},
+    "zh-HK": {"status_starting": "正在啟動 {{TITLE}}..."},
+    "zh-TW": {"status_starting": "正在啟動 {{TITLE}}..."},
+    "ko-KR": {"status_starting": "{{TITLE}} 시작 중..."},
+    "ja-JP": {"status_starting": "{{TITLE}} を起動中..."},
+    "fr-FR": {"status_starting": "Démarrage de {{TITLE}}..."},
+    "de-DE": {"status_starting": "{{TITLE}} wird gestartet..."},
+    "es-ES": {"status_starting": "Iniciando {{TITLE}}..."},
+    "it-IT": {"status_starting": "Avvio di {{TITLE}}..."},
+    "vi-VN": {"status_starting": "Đang khởi động {{TITLE}}..."},
+    "id-ID": {"status_starting": "Memulai {{TITLE}}..."},
+}
+
+class {{CLASS_NAME}}:
+    class Valves(BaseModel):
+        priority: int = Field(default=50, description="Priority level (lower = earlier).")
+        show_status: bool = Field(default=True, description="Show status updates in UI.")
+
+    def __init__(self):
+        self.valves = self.Valves()
+        self.fallback_map = {
+            "zh": "zh-CN", "en": "en-US", "ko": "ko-KR", "ja": "ja-JP",
+            "fr": "fr-FR", "de": "de-DE", "es": "es-ES", "it": "it-IT",
+            "vi": "vi-VN", "id": "id-ID"
+        }
+
+    def _get_translation(self, lang: str, key: str, **kwargs) -> str:
+        target_lang = lang
+        if target_lang not in TRANSLATIONS:
+            base = target_lang.split("-")[0]
+            target_lang = self.fallback_map.get(base, "en-US")
+        
+        lang_dict = TRANSLATIONS.get(target_lang, TRANSLATIONS["en-US"])
+        text = lang_dict.get(key, TRANSLATIONS["en-US"].get(key, key))
+        return text.format(**kwargs) if kwargs else text
+
+    async def _get_user_context(self, __user__: Optional[dict], __event_call__: Optional[Callable] = None, __request__: Optional[Request] = None) -> dict:
+        user_data = __user__ if isinstance(__user__, dict) else {}
+        user_language = user_data.get("language", "en-US")
+        if __event_call__:
+            try:
+                js = "try { return (document.documentElement.lang || localStorage.getItem('locale') || navigator.language || 'en-US'); } catch (e) { return 'en-US'; }"
+                frontend_lang = await asyncio.wait_for(__event_call__({"type": "execute", "data": {"code": js}}), timeout=2.0)
+                if frontend_lang: user_language = frontend_lang
+            except: pass
+        return {"user_language": user_language}
+
+    async def {{METHOD_NAME}}(self, body: dict, __user__: Optional[dict] = None, __event_emitter__=None, __event_call__=None, __request__: Optional[Request] = None) -> dict:
+        if self.valves.show_status and __event_emitter__:
+            user_ctx = await self._get_user_context(__user__, __event_call__, __request__)
+            msg = self._get_translation(user_ctx["user_language"], "status_starting")
+            await __event_emitter__({"type": "status", "data": {"description": msg, "done": False}})
+        
+        # Implement core logic here
+        
+        if self.valves.show_status and __event_emitter__:
+            await __event_emitter__({"type": "status", "data": {"description": "Done", "done": True}})
+        return body

.gemini/skills/plugin-scaffolder/assets/template.py.j2

@@ -0,0 +1,80 @@
+"""
+title: {{TITLE}}
+author: Fu-Jie
+author_url: https://github.com/Fu-Jie/openwebui-extensions
+funding_url: https://github.com/open-webui
+version: 0.1.0
+description: {{DESCRIPTION}}
+"""
+
+import asyncio
+import logging
+import json
+from typing import Optional, Dict, Any, List, Callable, Awaitable
+from pydantic import BaseModel, Field
+from fastapi import Request
+
+# Configure logging
+logging.basicConfig(level=logging.INFO, format="%(asctime)s - %(name)s - %(levelname)s - %(message)s")
+logger = logging.getLogger(__name__)
+
+TRANSLATIONS = {
+    "en-US": {"status_starting": "Starting {{TITLE}}..."},
+    "zh-CN": {"status_starting": "正在启动 {{TITLE}}..."},
+    "zh-HK": {"status_starting": "正在啟動 {{TITLE}}..."},
+    "zh-TW": {"status_starting": "正在啟動 {{TITLE}}..."},
+    "ko-KR": {"status_starting": "{{TITLE}} 시작 중..."},
+    "ja-JP": {"status_starting": "{{TITLE}} を起動中..."},
+    "fr-FR": {"status_starting": "Démarrage de {{TITLE}}..."},
+    "de-DE": {"status_starting": "{{TITLE}} wird gestartet..."},
+    "es-ES": {"status_starting": "Iniciando {{TITLE}}..."},
+    "it-IT": {"status_starting": "Avvio di {{TITLE}}..."},
+    "vi-VN": {"status_starting": "Đang khởi động {{TITLE}}..."},
+    "id-ID": {"status_starting": "Memulai {{TITLE}}..."},
+}
+
+class {{CLASS_NAME}}:
+    class Valves(BaseModel):
+        priority: int = Field(default=50, description="Priority level (lower = earlier).")
+        show_status: bool = Field(default=True, description="Show status updates in UI.")
+
+    def __init__(self):
+        self.valves = self.Valves()
+        self.fallback_map = {
+            "zh": "zh-CN", "en": "en-US", "ko": "ko-KR", "ja": "ja-JP",
+            "fr": "fr-FR", "de": "de-DE", "es": "es-ES", "it": "it-IT",
+            "vi": "vi-VN", "id": "id-ID"
+        }
+
+    def _get_translation(self, lang: str, key: str, **kwargs) -> str:
+        target_lang = lang
+        if target_lang not in TRANSLATIONS:
+            base = target_lang.split("-")[0]
+            target_lang = self.fallback_map.get(base, "en-US")
+        
+        lang_dict = TRANSLATIONS.get(target_lang, TRANSLATIONS["en-US"])
+        text = lang_dict.get(key, TRANSLATIONS["en-US"].get(key, key))
+        return text.format(**kwargs) if kwargs else text
+
+    async def _get_user_context(self, __user__: Optional[dict], __event_call__: Optional[Callable] = None, __request__: Optional[Request] = None) -> dict:
+        user_data = __user__ if isinstance(__user__, dict) else {}
+        user_language = user_data.get("language", "en-US")
+        if __event_call__:
+            try:
+                js = "try { return (document.documentElement.lang || localStorage.getItem('locale') || navigator.language || 'en-US'); } catch (e) { return 'en-US'; }"
+                frontend_lang = await asyncio.wait_for(__event_call__({"type": "execute", "data": {"code": js}}), timeout=2.0)
+                if frontend_lang: user_language = frontend_lang
+            except: pass
+        return {"user_language": user_language}
+
+    async def {{METHOD_NAME}}(self, body: dict, __user__: Optional[dict] = None, __event_emitter__=None, __event_call__=None, __request__: Optional[Request] = None) -> dict:
+        if self.valves.show_status and __event_emitter__:
+            user_ctx = await self._get_user_context(__user__, __event_call__, __request__)
+            msg = self._get_translation(user_ctx["user_language"], "status_starting")
+            await __event_emitter__({"type": "status", "data": {"description": msg, "done": False}})
+        
+        # Implement core logic here
+        
+        if self.valves.show_status and __event_emitter__:
+            await __event_emitter__({"type": "status", "data": {"description": "Done", "done": True}})
+        return body

.gemini/skills/plugin-scaffolder/scripts/scaffold.py

@@ -0,0 +1,66 @@
+#!/usr/bin/env python3
+import sys
+import os
+
+
+def scaffold(p_type, p_name, title, desc):
+    target_dir = f"plugins/{p_type}/{p_name}"
+    os.makedirs(target_dir, exist_ok=True)
+
+    class_name = (
+        "Action"
+        if p_type == "actions"
+        else (
+            "Filter"
+            if p_type == "filters"
+            else "Tools" if p_type == "tools" else "Pipe"
+        )
+    )
+    method_name = (
+        "action"
+        if p_type == "actions"
+        else (
+            "outlet"
+            if p_type == "filters"
+            else "execute" if p_type == "tools" else "pipe"
+        )
+    )
+
+    replacements = {
+        "{{TITLE}}": title,
+        "{{DESCRIPTION}}": desc,
+        "{{CLASS_NAME}}": class_name,
+        "{{METHOD_NAME}}": method_name,
+    }
+
+    # Files to generate
+    templates = [
+        ("assets/template.py.j2", f"{p_name}.py"),
+        ("assets/README_template.md", "README.md"),
+        ("assets/README_template.md", "README_CN.md"),
+    ]
+
+    # Path relative to skill root
+    skill_root = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+
+    for t_path, t_name in templates:
+        template_file = os.path.join(skill_root, t_path)
+        if not os.path.exists(template_file):
+            print(f"⚠️ Warning: Template not found {template_file}")
+            continue
+
+        with open(template_file, "r") as f:
+            content = f.read()
+        for k, v in replacements.items():
+            content = content.replace(k, v)
+
+        with open(os.path.join(target_dir, t_name), "w") as f:
+            f.write(content)
+        print(f"✅ Generated: {target_dir}/{t_name}")
+
+
+if __name__ == "__main__":
+    if len(sys.argv) < 5:
+        print("Usage: scaffold.py <type> <name> <title> <desc>")
+        sys.exit(1)
+    scaffold(sys.argv[1], sys.argv[2], sys.argv[3], sys.argv[4])

.gemini/skills/pr-reviewer/SKILL.md

@@ -0,0 +1,180 @@
+---
+name: pr-reviewer
+description: Fetches PR review comments, analyzes requested changes, implements fixes, commits and pushes the resolution. Use after a reviewer has left comments on an open PR to close the feedback loop efficiently.
+---
+
+# PR Reviewer
+
+## Overview
+
+This skill automates the response cycle for code review. When a reviewer leaves comments on a Pull Request, this skill fetches all pending feedback, categorizes issues by severity, implements fixes, and submits a follow-up commit with appropriate review response comments.
+
+## Prerequisites
+
+- An open PR exists with pending review comments
+- The local branch matches the PR's head branch
+- `gh` CLI is authenticated
+
+---
+
+## Workflow
+
+### Step 1 — Fetch Review State
+
+Retrieve all review comments and overall review status:
+
+```bash
+# Get overall review decisions
+PAGER=cat GH_PAGER=cat gh pr view <PR-NUMBER> --json reviews,reviewDecision,headRefName \
+  --jq '{decision: .reviewDecision, reviews: [.reviews[] | {author: .author.login, state: .state, body: .body}]}'
+
+# Get inline code comments (specific line comments)
+PAGER=cat GH_PAGER=cat gh api repos/Fu-Jie/openwebui-extensions/pulls/<PR-NUMBER>/comments \
+  --jq '[.[] | {path: .path, line: .line, body: .body, author: .user.login, id: .id}]'
+
+# Get general issue comments
+PAGER=cat GH_PAGER=cat gh issue view <PR-NUMBER> --comments --json comments \
+  --jq '[.comments[] | {author: .author.login, body: .body}]'
+```
+
+Confirm the current local branch matches the PR head:
+```bash
+git branch --show-current
+```
+If mismatched, checkout the correct branch first.
+
+### Step 2 — Categorize Review Feedback
+
+Group feedback into categories:
+
+| Category | Examples | Action |
+|----------|---------|--------|
+| **Code Bug** | Logic error, incorrect variable, broken condition | Fix code immediately |
+| **Style / Formatting** | Indentation, naming convention, missing blank line | Fix code |
+| **Documentation** | Missing i18n key, wrong version in README, typo | Fix docs |
+| **Design Question** | Suggestion to restructure, alternative approach | Discuss with user before implementing |
+| **Nitpick / Optional** | Minor style preferences reviewer marked as optional | Fix if quick; document if skipped |
+| **Blocking** | Reviewer explicitly blocks merge | Must fix before proceeding |
+
+Present the full categorized list to the user and confirm the resolution plan.
+
+### Step 3 — Implement Fixes
+
+For each accepted fix:
+
+1. Read the affected file at the commented line for context:
+   ```bash
+   sed -n '<line-5>,<line+10>p' <file-path>
+   ```
+2. Apply the fix using appropriate file edit tools
+3. After editing, verify the specific area looks correct
+
+**For code changes that might affect behavior:**
+- Check if tests exist: `ls tests/test_*.py`
+- If tests exist, run them: `python -m pytest tests/ -v`
+
+**For documentation fixes:**
+- If modifying README.md, check if `docs/` mirror needs the same fix
+- Apply the same fix to both locations
+
+### Step 4 — Run Consistency Checks
+
+After all fixes are applied:
+
+```bash
+# Version consistency (if any version files were touched)
+python3 scripts/check_version_consistency.py
+
+# Quick syntax check for Python files
+python3 -m py_compile plugins/{type}/{name}/{name}.py && echo "✅ Syntax OK"
+```
+
+### Step 5 — Stage and Commit
+
+Create a new commit (do NOT amend if the branch has already been pushed, to avoid force-push):
+
+```bash
+git add -A
+git status
+```
+
+Draft a Conventional Commits message for the fixup:
+
+Format: `fix(scope): address review feedback`
+
+Body should list what was fixed, referencing reviewer concerns:
+```
+fix(github-copilot-sdk): address review feedback from @reviewer
+
+- Fix X per review comment on line Y of file Z
+- Update README to clarify auth requirement
+- Correct edge case in _parse_mcp_servers logic
+```
+
+```bash
+git commit -m "<fixup commit message>"
+```
+
+### Step 6 — Push the Fix Commit
+
+```bash
+git push origin $(git branch --show-current)
+```
+
+**Force-push policy:**
+- Use `git push` (non-force) by default
+- Only use `git push --force-with-lease` if:
+  1. The user explicitly requests it, AND
+  2. The only change is an amended commit squash (cosmetic, no logic change)
+  3. Never use `--force` (without `--lease`)
+
+### Step 7 — Respond to Reviewers
+
+For each addressed review comment, post a reply:
+
+```bash
+# Reply to inline comment
+gh api repos/Fu-Jie/openwebui-extensions/pulls/<PR-NUMBER>/comments/<COMMENT-ID>/replies \
+  -X POST -f body="Fixed in commit <SHORT-SHA>. <Brief explanation of what was changed.>"
+
+# General comment to summarize all fixes
+gh issue comment <PR-NUMBER> --body "All review feedback addressed in commit <SHORT-SHA>:
+- Fixed: <item 1>
+- Fixed: <item 2>
+Ready for re-review. 🙏"
+```
+
+### Step 8 — Re-Request Review (Optional)
+
+If the reviewer had submitted a `CHANGES_REQUESTED` review, request a new review after fixes:
+
+```bash
+PAGER=cat GH_PAGER=cat gh api repos/Fu-Jie/openwebui-extensions/pulls/<PR-NUMBER>/requested_reviewers \
+  -X POST -f reviewers[]='<reviewer-login>'
+```
+
+---
+
+## Decision Guide
+
+### When NOT to implement a suggestion immediately
+
+- **Design questions**: "Should this be a separate class?" — Present to user for decision
+- **Optional nitpicks**: Reviewer marked as `nit:` — Ask user if they want to include it
+- **Large refactors**: If fix would require changing >50 lines, propose a separate follow-up issue instead
+
+### When to ask the user before proceeding
+
+- Any fix involving behavioral changes to plugin logic
+- Renaming Valve keys (breaking change — requires migration notes)
+- Changes that affect the bilingual release notes already committed
+
+---
+
+## Anti-Patterns to Avoid
+
+- ❌ Do NOT `git commit --amend` on a pushed commit without user approval for force-push
+- ❌ Do NOT silently skip a reviewer's comment; always acknowledge it (implement or explain why not)
+- ❌ Do NOT use `--force` (only `--force-with-lease` when absolutely necessary)
+- ❌ Do NOT make unrelated changes in the fixup commit; keep scope focused on review feedback
+- ❌ Do NOT respond to reviewer comments in Chinese if the PR language context is English

.gemini/skills/pr-submitter/SKILL.md

@@ -0,0 +1,179 @@
+---
+name: pr-submitter
+description: Submits a feature branch as a Pull Request with a validated, properly formatted bilingual PR body. Handles shell-escape-safe body writing via temp files. Use after release-prep has committed all changes.
+---
+
+# PR Submitter
+
+## Overview
+
+This skill handles the final step of pushing a feature branch and creating a validated Pull Request on GitHub. Its primary purpose is to avoid the shell-escaping pitfalls (backticks, special characters in `gh pr create --body`) by always writing the PR body to a **temp file** first.
+
+## Prerequisites
+
+- All changes are committed (use `release-prep` skill first)
+- The `gh` CLI is authenticated (`gh auth status`)
+- Current branch is NOT `main` or `master`
+
+---
+
+## Workflow
+
+### Step 1 — Pre-Flight Checks
+
+Run these checks before any push:
+
+```bash
+# 1. Confirm not on protected branch
+git branch --show-current
+
+# 2. Verify there are commits to push
+git log origin/$(git branch --show-current)..HEAD --oneline 2>/dev/null || echo "No remote tracking branch yet"
+
+# 3. Check gh CLI auth
+gh auth status
+```
+
+If any check fails, stop and report clearly.
+
+### Step 2 — Collect PR Metadata
+
+Gather:
+- **PR Title**: Must follow Conventional Commits format, English only (e.g., `feat(github-copilot-sdk): release v0.8.0 with conditional tool filtering`)
+- **Target base branch**: Default is `main`
+- **Plugin name + version** (to build body sections)
+- **Key changes** (reuse from release-prep or the latest What's New section)
+
+### Step 3 — Build PR Body File (Shell-Escape-Safe)
+
+**Always write the body to a temp file.** Never embed multi-line markdown with special characters directly in a shell command.
+
+```bash
+cat > /tmp/pr_body.md << 'HEREDOC'
+## Summary
+
+Brief one-sentence description of what this PR accomplishes.
+
+## Changes
+
+### New Features
+- Feature 1 description
+- Feature 2 description
+
+### Bug Fixes
+- Fix 1 description
+
+## Plugin Version
+- `PluginName` bumped to `vX.X.X`
+
+## Documentation
+- README.md / README_CN.md updated
+- docs/ mirrors synced
+
+## Testing
+- [ ] Tested locally in OpenWebUI
+- [ ] i18n validated (all language keys present)
+- [ ] Version consistency check passed (`python3 scripts/check_version_consistency.py`)
+
+---
+
+## 变更摘要（中文）
+
+简要描述本次 PR 的改动内容。
+
+### 新功能
+- 功能1描述
+- 功能2描述
+
+### 问题修复
+- 修复1描述
+HEREDOC
+```
+
+**Critical rules for the body file:**
+- Use `<< 'HEREDOC'` (quoted heredoc) to prevent variable expansion
+- Keep all backticks literal — they are safe inside a heredoc
+- Paths like `/api/v1/files/` are safe too since heredoc doesn't interpret them as commands
+
+### Step 4 — Validate PR Body
+
+Before submitting, verify the body file contains expected sections:
+
+```bash
+# Check key sections exist
+grep -q "## Summary" /tmp/pr_body.md && echo "✅ Summary" || echo "❌ Summary missing"
+grep -q "## Changes" /tmp/pr_body.md && echo "✅ Changes" || echo "❌ Changes missing"
+grep -q "## 变更摘要" /tmp/pr_body.md && echo "✅ CN Section" || echo "❌ CN Section missing"
+
+# Preview the body
+cat /tmp/pr_body.md
+```
+
+Ask the user to confirm the body content before proceeding.
+
+### Step 5 — Push Branch
+
+```bash
+git push -u origin $(git branch --show-current)
+```
+
+If push is rejected (non-fast-forward), report to user and ask whether to force-push. **Do NOT force-push without explicit confirmation.**
+
+### Step 6 — Create Pull Request
+
+```bash
+gh pr create \
+  --base main \
+  --head $(git branch --show-current) \
+  --title "<PR title from Step 2>" \
+  --body-file /tmp/pr_body.md
+```
+
+Always use `--body-file`, never `--body` with inline markdown.
+
+### Step 7 — Verify PR Creation
+
+```bash
+PAGER=cat GH_PAGER=cat gh pr view --json number,url,title,body --jq '{number: .number, url: .url, title: .title, body_preview: .body[:200]}'
+```
+
+Confirm:
+- PR number and URL
+- Title matches intended Conventional Commits format
+- Body preview includes key sections (not truncated/corrupted)
+
+If the body appears corrupted (empty sections, missing backtick content), use edit:
+
+```bash
+gh pr edit <PR-NUMBER> --body-file /tmp/pr_body.md
+```
+
+### Step 8 — Cleanup
+
+```bash
+rm -f /tmp/pr_body.md
+```
+
+Report final PR URL to the user.
+
+---
+
+## Shell-Escape Safety Rules
+
+| Risk | Safe Approach |
+|------|--------------|
+| Backticks in `--body` | Write to file, use `--body-file` |
+| Paths like `/api/...` | Safe in heredoc; risky in inline `--body` |
+| Newlines in `--body` | File-based only |
+| `$variable` expansion | Use `<< 'HEREDOC'` (quoted) |
+| Double quotes in body | Safe in heredoc file |
+
+---
+
+## Anti-Patterns to Avoid
+
+- ❌ Never use `--body "..."` with multi-line content directly in shell command
+- ❌ Never interpolate variables directly into heredoc without quoting the delimiter
+- ❌ Never force-push (`--force`) without explicit user confirmation
+- ❌ Never target `main` as the source branch (only as base)
+- ❌ Never skip the body validation step — a PR with empty body is worse than a delayed PR

.gemini/skills/release-finalizer/SKILL.md

@@ -0,0 +1,208 @@
+---
+name: release-finalizer
+description: Merges a release PR, associates it with resolved issues, replies to issue reporters, and closes issues. Use after PR review is complete and ready for merge. Closes the release cycle.
+---
+
+# Release Finalizer
+
+## Overview
+
+This skill completes the final step of the release cycle: merging the release PR to `main`, replying to all related issues with solutions, and automatically closing them using GitHub's issue linking mechanism.
+
+## Prerequisites
+
+- The PR is in `OPEN` state and ready to merge
+- All status checks have passed (CI green)
+- All review feedback has been addressed
+- The PR relates to one or more GitHub issues (either in PR description or through commits)
+
+---
+
+## Workflow
+
+### Step 1 — Pre-Merge Verification
+
+Verify that the PR is ready:
+
+```bash
+PAGER=cat GH_PAGER=cat gh pr view <PR-NUMBER> --json state,statusCheckRollup,reviewDecision
+```
+
+Checklist:
+- ✅ `state` is `OPEN`
+- ✅ `statusCheckRollup` all have `conclusion: SUCCESS`
+- ✅ `reviewDecision` is `APPROVED` or empty (no blocking reviews)
+
+If any check fails, **do NOT merge**. Report the issue to the user.
+
+### Step 2 — Identify Related Issues
+
+Issues can be linked to a PR in multiple ways. Check the PR description and commit messages for keywords:
+
+```bash
+PAGER=cat GH_PAGER=cat gh pr view <PR-NUMBER> --json body,commits
+```
+
+Look for patterns like:
+- `Closes #XX`, `Fixes #XX`, `Resolves #XX` (in description or commit bodies)
+- `#XX` mentioned as "related to" or "addresses"
+
+**Manual input**: If issue links are not in the PR, ask the user which issue(s) this PR resolves.
+
+Extract all issue numbers into a list: `[#48, #52, ...]`
+
+### Step 3 — Select Merge Strategy
+
+Offer the user three options:
+
+| Strategy | Git Behavior | Use Case |
+|----------|-------------|----------|
+| **Squash** | All commits squashed into one commit on main | Clean history, recommended for release PRs |
+| **Rebase** | Linear history, no merge commit | Preserve commit granularity |
+| **Merge** | Merge commit created | Preserve full PR context |
+
+**Recommendation for release PRs**: Use `--squash` to create a single clean commit.
+
+If user doesn't specify, default to `--squash`.
+
+### Step 4 — Prepare Merge Commit Message
+
+If using `--squash`, craft a single comprehensive commit message:
+
+**Format** (Conventional Commits + Github linking):
+```
+type(scope): description
+
+- Bullet point 1
+- Bullet point 2
+
+Closes #48
+Closes #52
+```
+
+The `Closes #XX` keyword tells GitHub to automatically close those issues when the commit lands on `main`.
+
+Example:
+```
+feat(pipes,filters): release Copilot SDK Pipe v0.8.0 and Files Filter v0.1.3
+
+- Implement P1~P4 conditional tool filtering system
+- Fix file publishing reliability across all storage backends
+- Add strict file URL validation
+- Update bilingual documentation
+
+Closes #48
+```
+
+### Step 5 — Execute Merge
+
+```bash
+gh pr merge <PR-NUMBER> \
+  --squash \
+  --delete-branch \
+  -m "type(scope): description" \
+  -b "- Bullet 1\n- Bullet 2\n\nCloses #48"
+```
+
+**Key flags:**
+- `--squash`: Squash commits (recommended for releases)
+- `--delete-branch`: Delete the feature branch after merge
+- `-m`: Commit subject
+- `-b`: Commit body (supports `\n` for newlines)
+
+Confirm the merge is successful; GitHub will automatically close related issues with `Closes #XX` keyword.
+
+### Step 6 — Verify Auto-Close
+
+GitHub automatically closes issues when a commit with `Closes #XX` lands on the default branch (`main`).
+
+To verify:
+```bash
+PAGER=cat GH_PAGER=cat gh issue view <ISSUE-NUMBER> --json state
+```
+
+Should show `state: CLOSED`.
+
+### Step 7 — Post Closing Message (Optional but Recommended)
+
+For better UX, manually post a summary comment to **each issue** before it auto-closes (since auto-close happens silently):
+
+```bash
+gh issue comment <ISSUE-NUMBER> --body "
+This has been fixed in PR #<PR-NUMBER>, which is now merged to main.
+
+**Solution Summary:**
+- <Key fix 1>
+- <Key fix 2>
+
+The fix will be available in the next plugin release. Thank you for reporting! ⭐
+"
+```
+
+### Step 8 — (Optional) Regenerate Release Notes
+
+If the merge revealed any final tweaks to release notes:
+
+```bash
+# Re-export release notes from merged commit
+git log --oneline -1 <merged-commit-sha>
+```
+
+If needed, create a follow-up PR with doc polish (do NOT force-push the merged commit).
+
+---
+
+## Merge Strategy Decision Tree
+
+```
+Is this a patch/hotfix release?
+├─ YES → Use --squash
+└─ NO → Multi-feature release?
+     ├─ YES → Use --squash (cleaner history)
+     └─ NO → Preserve detail? 
+          ├─ YES → Use --rebase
+          └─ NO → Use --merge (preserve PR context)
+```
+
+---
+
+## Issue Auto-Close Keywords
+
+These keywords in commit/PR messages will auto-close issues when merged to `main`:
+
+- `Closes #XX`
+- `Fixes #XX`
+- `Resolves #XX`
+- `close #XX` (case-insensitive)
+- `fix #XX`
+- `resolve #XX`
+
+**Important**: The keyword must be on the **final commit that lands on** `main`. For squash merges, it must be in the squash commit message body.
+
+---
+
+## Anti-Patterns to Avoid
+
+- ❌ Do NOT merge if any status checks are PENDING or FAILED
+- ❌ Do NOT merge if there are blocking reviews (reviewDecision: `CHANGES_REQUESTED`)
+- ❌ Do NOT merge without verifying the Conventional Commits format in the merge message
+- ❌ Do NOT merge without including `Closes #XX` keywords for all related issues
+- ❌ Do NOT assume issues will auto-close silently — post a courtesy comment first
+- ❌ Do NOT delete the branch if it might be needed for cherry-pick or hotfixes later
+
+---
+
+## Troubleshooting
+
+### Issue did not auto-close after merge
+- Verify the `Closes #XX` keyword is in the **final commit message** (use `git log` to check)
+- Ensure the commit is on the `main` branch
+- GitHub sometimes takes a few seconds to process; refresh the issue page
+
+### Multiple issues to close
+- List all in separate `Closes #XX` lines in the commit body
+- Each one will be independently auto-closed
+
+### Want to close issue without merge?
+- Use `gh issue close <ISSUE-NUMBER>` manually
+- Only recommended if the PR was manually reverted or deemed invalid

.gemini/skills/release-prep/SKILL.md

@@ -0,0 +1,137 @@
+---
+name: release-prep
+description: Orchestrates the full release preparation flow for a plugin — version sync across 7+ files, bilingual release notes creation, and commit message drafting. Use before submitting a PR. Does NOT push or create a PR; that is handled by pr-submitter.
+---
+
+# Release Prep
+
+## Overview
+
+This skill drives the complete pre-PR release pipeline. It enforces the repository rule that every release must synchronize the version number and changelog across **at least 7 locations** before a commit is created.
+
+## Scope
+
+This skill covers:
+1. Version sync (delegates detail to `version-bumper` if needed)
+2. Bilingual release notes file creation
+3. 7-location consistency verification
+4. Conventional Commits message drafting
+5. `git add -A && git commit` execution
+
+It **stops before** `git push` or `gh pr create`. Use the `pr-submitter` skill for those steps.
+
+---
+
+## Workflow
+
+### Step 1 — Collect Release Info
+
+Ask the user (or infer from current state) the following:
+- **Plugin name** and **type** (actions / filters / pipes / tools)
+- **New version number** (e.g., `0.8.0`)
+- **Key changes** in English and Chinese (1-5 bullet points each)
+
+If a `What's New` section already exists in README.md, extract it as the source of truth.
+
+### Step 2 — Sync Version Across 7 Locations
+
+Verify AND update the version string in all of the following. Mark each as ✅ or ❌:
+
+| # | File | Location |
+|---|------|----------|
+| 1 | `plugins/{type}/{name}/{name}.py` | `version:` in docstring |
+| 2 | `plugins/{type}/{name}/README.md` | `**Version:** x.x.x` metadata line |
+| 3 | `plugins/{type}/{name}/README_CN.md` | `**Version:** x.x.x` metadata line |
+| 4 | `docs/plugins/{type}/{name}.md` | `**Version:** x.x.x` metadata line |
+| 5 | `docs/plugins/{type}/{name}.zh.md` | `**Version:** x.x.x` metadata line |
+| 6 | `docs/plugins/{type}/index.md` | version badge for this plugin |
+| 7 | `docs/plugins/{type}/index.zh.md` | version badge for this plugin |
+
+Additionally update the root-level **updated date badge** in:
+- `README.md` — `![updated](https://img.shields.io/badge/YYYY--MM--DD-gray?style=flat)`
+- `README_CN.md` — same badge format
+
+Use today's date (`YYYY-MM-DD`) for the badge.
+
+### Step 3 — Update What's New (All 4 Doc Files)
+
+The `What's New` / `最新更新` section must contain **only the most recent release's changes**. Previous entries should be removed from this section (they live in CHANGELOG or release notes files).
+
+Update these 4 files' `What's New` / `最新更新` block consistently:
+- `plugins/{type}/{name}/README.md`
+- `plugins/{type}/{name}/README_CN.md`
+- `docs/plugins/{type}/{name}.md`
+- `docs/plugins/{type}/{name}.zh.md`
+
+### Step 4 — Create Bilingual Release Notes Files
+
+Create two versioned release notes files:
+
+**Path**: `plugins/{type}/{name}/v{version}.md`
+**Path**: `plugins/{type}/{name}/v{version}_CN.md`
+
+#### Required Sections
+
+Each file must include:
+1. **Title**: `# v{version} Release Notes` (EN) / `# v{version} 版本发布说明` (CN)
+2. **Overview**: One paragraph summarizing this release
+3. **New Features** / **新功能**: Bulleted list of features
+4. **Bug Fixes** / **问题修复**: Bulleted list of fixes
+5. **Migration Notes** / **迁移说明**: Breaking changes or Valve key renames (omit section if none)
+6. **Companion Plugins** / **配套插件** (optional): If a companion plugin was updated
+
+If a release notes file already exists for this version, update it rather than creating a new one.
+
+### Step 5 — Verify Consistency (Pre-Commit Check)
+
+Run the consistency check script:
+
+```bash
+python3 scripts/check_version_consistency.py
+```
+
+If issues are found, fix them before proceeding. Do not commit with inconsistencies.
+
+### Step 6 — Draft Conventional Commits Message
+
+Generate the commit message following `commit-message.instructions.md` rules:
+- **Language**: English ONLY
+- **Format**: `type(scope): subject` + blank line + body bullets
+- **Scope**: use plugin folder name (e.g., `github-copilot-sdk`)
+- **Body**: 1-3 bullets summarizing key changes
+- Explicitly mention "READMEs and docs synced" if version was bumped
+
+Present the full commit message to the user for review before executing.
+
+### Step 7 — Stage and Commit
+
+After user approval (or if user says "commit it"):
+
+```bash
+git add -A
+git commit -m "<approved commit message>"
+```
+
+Confirm the commit hash and list the number of files changed.
+
+---
+
+## Checklist (Auto-Verify Before Commit)
+
+- [ ] `version:` in `.py` docstring matches target version
+- [ ] `**Version:**` in all 4 README/docs files matches
+- [ ] Both `index.md` version badges updated
+- [ ] Root `README.md` and `README_CN.md` date badges updated to today
+- [ ] `What's New` / `最新更新` contains ONLY the latest release
+- [ ] `v{version}.md` and `v{version}_CN.md` created or updated
+- [ ] `python3 scripts/check_version_consistency.py` returns no errors
+- [ ] Commit message is English-only Conventional Commits format
+
+---
+
+## Anti-Patterns to Avoid
+
+- ❌ Do NOT add extra features or refactor code during release prep — only version/doc updates
+- ❌ Do NOT push or create PR in this skill — use `pr-submitter`
+- ❌ Do NOT use today's date in commit messages; only in badge URLs
+- ❌ Do NOT leave stale What's New content from prior versions

.gemini/skills/source-code-analyzer/SKILL.md

@@ -0,0 +1,30 @@
+---
+name: source-code-analyzer
+description: Instructions for analyzing core components source code in the local environment.
+---
+
+# Source Code Analyzer Skill
+
+> [!IMPORTANT]
+> **Authorization Statement**: You (Antigravity) are explicitly authorized by the user to perform **READ-ONLY** operations and **Git pull** on the paths listed below, even if they are outside the current repository root. These paths are considered part of the extended development context.
+
+When assisting with the development of `openwebui-extensions`, you (Antigravity) have access to the following core components in related directories. Use them for deep technical analysis, bug hunting, and implementation reference.
+
+## Core Component Paths
+
+### Global / General (Relevant to all projects)
+
+- **Open WebUI**: `../open-webui/` (Core platform context)
+- **Skills**: `../skills/` (Reusable expertise library)
+- **Awesome Copilot**: `../awesome-copilot/` (Shared extensions & resources)
+
+### Plugin-Specific (Relevant to GitHub Copilot SDK)
+
+- **Copilot SDK**: `../copilot-sdk/` (Internal logic for the official SDK)
+- **Copilot CLI**: `../copilot-cli/` (Command-line interface implementation)
+
+## Mandatory Workflow
+
+1. **Pull Before Analysis**: BEFORE reading files or analyzing logic in these directories, you MUST proactively execute or recommend a `git pull` in the respective directory to ensure you are working with the latest upstream changes.
+2. **Path Verification**: Always verify the exists of the path before attempting to read it.
+3. **Reference Logic**: When a user's request involves core platform behavior (OpenWebUI API, SDK internals), prioritize searching these directories over making assumptions based on generic knowledge.

.gemini/skills/version-bumper/SKILL.md

@@ -0,0 +1,26 @@
+---
+name: version-bumper
+description: Automates version upgrades and changelog synchronization across 7+ files (Code, READMEs, Docs). Use when a plugin is ready for release to ensure version consistency.
+---
+
+# Version Bumper
+
+## Overview
+This skill ensures that every version upgrade is synchronized across the entire repository, following the strict "Documentation Sync" rule in GEMINI.md.
+
+## Workflow
+1. **Prepare Info**: Gather the new version number and brief changelogs in both English and Chinese.
+2. **Auto-Patch**: The skill will help you identify and update:
+   - `plugins/.../name.py` (docstring version)
+   - `plugins/.../README.md` (metadata & What's New)
+   - `plugins/.../README_CN.md` (metadata & 最新更新)
+   - `docs/plugins/...md` (mirrors)
+   - `docs/plugins/index.md` (version badge)
+   - `README.md` (updated date badge)
+3. **Verify**: Check the diffs to ensure no formatting was broken.
+
+## Tool Integration
+Execute the bump script (draft):
+```bash
+python3 scripts/bump.py <version> "<message_en>" "<message_zh>"
+```

.gemini/skills/version-bumper/scripts/bump.py

@@ -0,0 +1,70 @@
+#!/usr/bin/env python3
+import sys
+import os
+import re
+from datetime import datetime
+
+def patch_file(file_path, old_pattern, new_content, is_regex=False):
+    if not os.path.exists(file_path):
+        print(f"Warning: File not found: {file_path}")
+        return False
+    
+    with open(file_path, 'r', encoding='utf-8') as f:
+        content = f.read()
+    
+    if is_regex:
+        new_content_result = re.sub(old_pattern, new_content, content, flags=re.MULTILINE)
+    else:
+        new_content_result = content.replace(old_pattern, new_content)
+    
+    if new_content_result != content:
+        with open(file_path, 'w', encoding='utf-8') as f:
+            f.write(new_content_result)
+        print(f"✅ Patched: {file_path}")
+        return True
+    else:
+        print(f"ℹ️ No change needed: {file_path}")
+        return False
+
+def bump_version(plugin_type, plugin_name, new_version, msg_en, msg_zh):
+    print(f"🚀 Bumping {plugin_name} ({plugin_type}) to {new_version}...")
+    
+    today = datetime.now().strftime("%Y-%m-%d")
+    today_badge = today.replace("-", "--")
+    
+    # 1. Patch Plugin Python File
+    py_file = f"plugins/{plugin_type}/{plugin_name}/{plugin_name}.py"
+    patch_file(py_file, r"version: \d+\.\d+\.\d+", f"version: {new_version}", is_regex=True)
+    
+    # 2. Patch Plugin READMEs
+    readme_en = f"plugins/{plugin_type}/{plugin_name}/README.md"
+    readme_zh = f"plugins/{plugin_type}/{plugin_name}/README_CN.md"
+    
+    # Update version in metadata
+    patch_file(readme_en, r"\*\*Version:\*\* \d+\.\d+\.\d+", f"**Version:** {new_version}", is_regex=True)
+    patch_file(readme_zh, r"\*\*版本:\*\* \d+\.\d+\.\d+", f"**版本:** {new_version}", is_regex=True)
+    
+    # Update What's New (Assuming standard headers)
+    patch_file(readme_en, r"## 🔥 What's New in v.*?\n", f"## 🔥 What's New in v{new_version}\n\n* {msg_en}\n", is_regex=True)
+    patch_file(readme_zh, r"## 🔥 最新更新 v.*?\n", f"## 🔥 最新更新 v{new_version}\n\n* {msg_zh}\n", is_regex=True)
+    
+    # 3. Patch Docs Mirrors
+    doc_en = f"docs/plugins/{plugin_type}/{plugin_name}.md"
+    doc_zh = f"docs/plugins/{plugin_type}/{plugin_name}.zh.md"
+    patch_file(doc_en, r"\*\*Version:\*\* \d+\.\d+\.\d+", f"**Version:** {new_version}", is_regex=True)
+    patch_file(doc_zh, r"\*\*版本:\*\* \d+\.\d+\.\d+", f"**版本:** {new_version}", is_regex=True)
+    
+    # 4. Patch Root READMEs (Updated Date Badge)
+    patch_file("README.md", r"badge/202\d--\d\d--\d\d-gray", f"badge/{today_badge}-gray", is_regex=True)
+    patch_file("README_CN.md", r"badge/202\d--\d\d--\d\d-gray", f"badge/{today_badge}-gray", is_regex=True)
+
+    print("\n✨ All synchronization tasks completed.")
+    return True
+
+if __name__ == "__main__":
+    if len(sys.argv) < 6:
+        print("Usage: bump.py <type> <name> <version> <msg_en> <msg_zh>")
+        print("Example: bump.py filters markdown_normalizer 1.2.8 'Fix bug' '修复错误'")
+        sys.exit(1)
+    
+    bump_version(sys.argv[1], sys.argv[2], sys.argv[3], sys.argv[4], sys.argv[5])

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,165 @@
+name: 🐛 Bug Report
+description: Report a bug or issue with OpenWebUI plugins
+title: "[BUG] "
+labels: ["bug"]
+assignees: []
+
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for reporting a bug! Please provide clear information to help us reproduce and fix the issue.
+
+  - type: dropdown
+    id: plugin-type
+    attributes:
+      label: Plugin Type
+      description: Which type of plugin is affected?
+      options:
+        - Action
+        - Filter
+        - Pipe
+        - Pipeline
+        - Tool
+        - Other
+    validations:
+      required: true
+
+  - type: dropdown
+    id: plugin-name
+    attributes:
+      label: Plugin Name
+      description: Which plugin has the issue?
+      options:
+        - "Select a plugin..."
+        - "Action - Deep Dive"
+        - "Action - Export to Word Enhanced"
+        - "Action - Export to Excel"
+        - "Action - Flash Card"
+        - "Action - Smart Infographic"
+        - "Action - Smart Mind Map"
+        - "Filter - Async Context Compression"
+        - "Filter - Context & Model Enhancement Filter"
+        - "Filter - Folder Memory"
+        - "Filter - GitHub Copilot SDK Files Filter"
+        - "Filter - Markdown Normalizer"
+        - "Filter - Gemini Multimodel Filter"
+        - "Pipeline - MOE Prompt Refiner"
+        - "Pipe - GitHub Copilot SDK"
+        - "Pipe - iFlow SDK"
+        - "Tool - OpenWebUI Skills Manager"
+        - "Tool - Smart Infographic Tool"
+        - "Tool - Smart Mind Map Tool"
+        - "Other / Not Listed"
+    validations:
+      required: true
+
+  - type: input
+    id: plugin-name-other
+    attributes:
+      label: Plugin Name (if not in list)
+      description: If you selected 'Other / Not Listed', please specify the plugin name
+      placeholder: "Plugin name"
+    validations:
+      required: false
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: Clearly describe the bug. What went wrong? What did you expect?
+      placeholder: |
+        I tried to use [feature], but instead of [expected behavior], it [actual behavior].
+        
+        Error message (if any):
+    validations:
+      required: true
+
+  - type: textarea
+    id: steps
+    attributes:
+      label: Steps to Reproduce
+      description: How can we reproduce this issue?
+      placeholder: |
+        1. Click on...
+        2. Enter...
+        3. See error...
+    validations:
+      required: true
+
+  - type: input
+    id: openwebui-version
+    attributes:
+      label: OpenWebUI Version
+      description: What version of OpenWebUI are you using?
+      placeholder: "e.g., 0.3.0 or main"
+    validations:
+      required: true
+
+  - type: textarea
+    id: environment
+    attributes:
+      label: Operating System & Container
+      description: "Your operating system and deployment method"
+      placeholder: |
+        Example 1:
+        OS: macOS 14.3
+        Container: Docker (version 24.0.x)
+        
+        Example 2:
+        OS: Ubuntu 22.04 LTS
+        Deployment: Docker Compose
+    validations:
+      required: true
+
+  - type: markdown
+    attributes:
+      value: |
+        ## 📋 Debug Information (Optional)
+        
+        To help diagnose the issue faster, please provide relevant logs:
+        
+        **Frontend Console Logs** (Recommended):
+        1. Enable: Click avatar → Settings → General → Enable Plugin Debug Output
+        2. Open DevTools: Press `F12` (or `Cmd+Option+I` on Mac)
+        3. Go to Console tab and copy any error messages or `🛠️ Debug` output
+        
+        **Server-Side Logs**:
+        - Docker: `docker logs <container-id>`
+        - Local: Check terminal output or log files
+
+  - type: textarea
+    id: logs
+    attributes:
+      label: Error Logs (Optional)
+      description: "Paste frontend console or server logs that show the error"
+      placeholder: |
+        Error message from console:
+        [Your logs here]
+      render: bash
+    validations:
+      required: false
+
+  - type: textarea
+    id: additional
+    attributes:
+      label: Additional Information (Optional)
+      description: "Screenshots, related issues, or other helpful details"
+      placeholder: |
+        - Screenshots (if applicable)
+        - Related issues or discussions
+        - Steps you've already tried to fix it
+    validations:
+      required: false
+
+  - type: checkboxes
+    id: checklist
+    attributes:
+      label: Checklist
+      options:
+        - label: I have searched for duplicate issues
+          required: true
+        - label: I have provided clear reproduction steps
+          required: true
+        - label: I have mentioned OpenWebUI version and OS/container info
+          required: true

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,11 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Documentation
+    url: https://docs.openwebui.com/
+    about: Official OpenWebUI documentation
+  - name: Discussions
+    url: https://github.com/Fu-Jie/openwebui-extensions/discussions
+    about: Ask questions and discuss with the community
+  - name: OpenWebUI Repository
+    url: https://github.com/open-webui/open-webui
+    about: Main OpenWebUI project

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,104 @@
+name: ✨ Feature Request
+description: Suggest a new feature or improvement
+title: "[FEATURE] "
+labels: ["enhancement"]
+assignees: []
+
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for your suggestion! Please describe the feature you'd like to see.
+
+  - type: dropdown
+    id: plugin-type
+    attributes:
+      label: Plugin Type (Optional)
+      description: Is this for a specific plugin type?
+      options:
+        - Action
+        - Filter
+        - Pipe
+        - Pipeline
+        - Tool
+        - Core/General
+        - Documentation
+        - Other
+    validations:
+      required: false
+
+  - type: dropdown
+    id: plugin-name
+    attributes:
+      label: Plugin Name (Optional)
+      description: Which plugin would benefit from this feature?
+      options:
+        - "Select a plugin..."
+        - "Action - Deep Dive"
+        - "Action - Export to Word Enhanced"
+        - "Action - Export to Excel"
+        - "Action - Flash Card"
+        - "Action - Smart Infographic"
+        - "Action - Smart Mind Map"
+        - "Filter - Async Context Compression"
+        - "Filter - Context & Model Enhancement Filter"
+        - "Filter - Folder Memory"
+        - "Filter - GitHub Copilot SDK Files Filter"
+        - "Filter - Markdown Normalizer"
+        - "Filter - Gemini Multimodel Filter"
+        - "Pipeline - MOE Prompt Refiner"
+        - "Pipe - GitHub Copilot SDK"
+        - "Pipe - iFlow SDK"
+        - "Tool - OpenWebUI Skills Manager"
+        - "Tool - Smart Infographic Tool"
+        - "Tool - Smart Mind Map Tool"
+        - "Core/General Improvement"
+        - "Other / Not Listed"
+    validations:
+      required: false
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Feature Description
+      description: Clearly describe the feature you're requesting
+      placeholder: |
+        What feature would you like to see?
+        How would it work?
+    validations:
+      required: true
+
+  - type: textarea
+    id: motivation
+    attributes:
+      label: Motivation & Use Case
+      description: Why is this feature important? What problem does it solve?
+      placeholder: |
+        What's the pain point this solves?
+        How would it improve your workflow?
+        Who else would benefit from this?
+    validations:
+      required: true
+
+  - type: textarea
+    id: additional
+    attributes:
+      label: Additional Information (Optional)
+      description: "Mockups, alternatives considered, references, or examples"
+      placeholder: |
+        - Links to related plugins or tools
+        - Screenshots or mockups
+        - Alternative approaches you've considered
+        - Code examples or references
+    validations:
+      required: false
+
+  - type: checkboxes
+    id: checklist
+    attributes:
+      label: Checklist
+      options:
+        - label: I have searched existing issues/discussions for similar requests
+          required: true
+        - label: This feature would be useful for multiple users
+          required: false

.github/TEMP_FILES_POLICY.md

@@ -0,0 +1,121 @@
+# Temporary Files Handling Policy
+
+**Last Updated**: 2026-02-26  
+**Status**: Active Guideline
+
+## Overview
+
+All temporary files created during skill execution or development workflows must follow this centralized policy to maintain project cleanliness and workspace isolation alignment.
+
+## Core Rule
+
+**Temporary files MUST be stored in the project's `.temp/` directory, NOT in system directories like `/tmp`.**
+
+## Rationale
+
+1. **Workspace Isolation**: Aligns with OpenWebUI's workspace-per-user model
+2. **Project Cohesion**: All project artifacts (temporary or permanent) stay within project boundaries
+3. **Multi-User Safety**: Avoids conflicts between multiple developers using the same system
+4. **Cleanup Traceability**: Easy to verify all temp files are cleaned up via single `.temp/` directory
+5. **Debugging**: Inspectable before deletion if issues occur
+
+## Usage Pattern
+
+### Creating Temp File
+
+```bash
+# Step 1: Ensure temp directory exists
+mkdir -p .temp
+
+# Step 2: Write temp file
+cat > .temp/my_temp_file.md << 'EOF'
+...content...
+EOF
+
+# Step 3: Use the file in your workflow
+# (e.g., pass to gh CLI, process with script, etc.)
+```
+
+### Cleanup After Use
+
+```bash
+# Remove individual temp files
+rm -f .temp/my_temp_file.md
+
+# Or full cleanup of entire temp directory
+rm -rf .temp/
+```
+
+## Skills Affected
+
+| Skill | Implementation | Status |
+|-------|----------------|--------|
+| `pr-submitter` | PR body file (`.temp/pr_body.md`) | ✅ Updated |
+| `release-prep` | Draft notes (if any) | ✅ Policy Added |
+| `version-bumper` | Backup files (if any) | ℹ️ Check needed |
+| Future skills | TBD | 📋 Must follow policy |
+
+## .gitignore Configuration
+
+The following entry in `.gitignore` ensures temp files are never committed:
+
+```
+# Temporary files
+.temp/
+.build/
+```
+
+## Examples
+
+### Example 1: PR Submitter Skill
+```bash
+# Create PR body in temp directory
+mkdir -p .temp
+cat > .temp/pr_body.md << 'EOF'
+## Summary
+New feature implementation
+EOF
+
+# Use with gh CLI
+gh pr create --body-file .temp/pr_body.md --title "feat: new feature"
+
+# Cleanup
+rm -f .temp/pr_body.md
+```
+
+### Example 2: Release Prepare Workflow
+```bash
+# Create draft changelog
+mkdir -p .temp
+cat > .temp/changelog_draft.md << 'EOF'
+# v1.0.0 Release Notes
+EOF
+
+# Edit, validate, then integrate into real files
+# ...
+
+# Cleanup
+rm -f .temp/changelog_draft.md
+```
+
+## Anti-Patterns (❌ Don't Do This)
+
+- ❌ Writing temp files to `/tmp` — will be lost/orphaned
+- ❌ Writing to root directory or `plugins/` — pollutes repo
+- ❌ Not cleaning up temp files — accumulates clutter
+- ❌ Committing `.temp/` files to git — defeats the purpose
+- ❌ Using absolute paths — breaks workflow portability
+
+## Enforcement
+
+1. **Code Review**: PRs should verify no `/tmp` references in scripts
+2. **CI/CD**: Setup can validate `.temp/` cleanup via git status before commit
+3. **Documentation**: All skill docs must reference this policy (link to this file)
+4. **Automated**: Consider adding pre-commit hook to ensure `.temp/` is not staged
+
+## Questions / Clarifications
+
+For questions about this policy, refer to:
+- `.github/skills/pr-submitter/SKILL.md` — Practical example
+- `.github/skills/release-prep/SKILL.md` — Policy integration
+- `/memories/repo/temp-file-handling-convention.md` — Internal notes

.github/agents/plugin-implementer.agent.md

@@ -0,0 +1,62 @@
+---
+name: Plugin Implementer
+description: Implement OpenWebUI plugin and docs updates with strict project standards
+argument-hint: Provide approved plan or feature request to implement
+tools: ['execute/getTerminalOutput', 'execute/runInTerminal', 'read/readFile', 'read/terminalSelection', 'read/terminalLastCommand', 'edit/createFile', 'edit/editFiles', 'search', 'web', 'web/fetch', 'web/githubRepo', 'agent']
+infer: true
+handoffs:
+  - label: Run Review
+    agent: Plugin Reviewer
+    prompt: Review the implementation for i18n, safety, and consistency issues.
+    send: false
+---
+You are the **implementation specialist** for the `openwebui-extensions` repository.
+
+## Execution Rules
+1. **Minimal diffs**: Change only what the approved plan specifies.
+2. **Single-file i18n**: Every plugin is one `.py` file with built-in `TRANSLATIONS` dict. Never create `_cn.py` split files.
+3. **Context helpers**: Always use `_get_user_context(__user__)` and `_get_chat_context(body, __metadata__)` — never access dict keys directly.
+4. **Emitter guards**: Every `await emitter(...)` must be guarded by `if emitter:`.
+5. **Logging**: Use `logging.getLogger(__name__)` — no bare `print()` in production code.
+6. **Async safety**: Wrap all `__event_call__` with `asyncio.wait_for(..., timeout=2.0)` + inner JS `try { ... } catch(e) { return fallback; }`.
+
+## Required Plugin Pattern
+```python
+# Docstring: title, author, author_url, funding_url, version, description
+# icon_url is REQUIRED for Action plugins (Lucide SVG, base64)
+
+class Action:  # or Filter / Pipe
+    class Valves(BaseModel):
+        SHOW_STATUS: bool = Field(default=True, description="...")
+        # All fields UPPER_SNAKE_CASE
+
+    def __init__(self):
+        self.valves = self.Valves()
+
+    def _get_user_context(self, __user__): ...   # always implement
+    def _get_chat_context(self, body, __metadata__=None): ...  # always implement
+    async def _emit_status(self, emitter, description, done=False): ...
+    async def _emit_notification(self, emitter, content, ntype="info"): ...
+```
+
+## Known Split-File Plugins (Legacy — Do NOT Add More)
+These still have `_cn.py` files. When touching any of them, migrate CN content into `TRANSLATIONS` dict:
+- `plugins/actions/deep-dive/deep_dive_cn.py`
+- `plugins/actions/export_to_docx/export_to_word_cn.py`
+- `plugins/actions/export_to_excel/export_to_excel_cn.py`
+- `plugins/actions/flash-card/flash_card_cn.py`
+- `plugins/actions/infographic/infographic_cn.py`
+- `plugins/filters/folder-memory/folder_memory_cn.py`
+
+## Version Bump Rule
+Only bump version when user explicitly says "发布" / "release" / "bump version".
+When bumping, update ALL 7+ files (code docstring + 2× README + 2× doc detail + 2× doc index + 2× root README date badge).
+
+## Git Policy
+- Never run `git commit`, `git push`, or create PRs automatically.
+- After all edits, list what changed and why, then stop.
+
+## Completion Output
+- Modified files (full relative paths, one-line descriptions)
+- Remaining manual checks
+- Suggested handoff to **Plugin Reviewer**

.github/agents/plugin-planner.agent.md

@@ -0,0 +1,78 @@
+---
+name: Plugin Planner
+description: Analyze requirements and produce a safe implementation plan for OpenWebUI plugins
+argument-hint: Describe the plugin goal, constraints, and target files
+tools: ['read/readFile', 'search', 'web', 'web/githubRepo', 'read/terminalLastCommand', 'read/terminalSelection', 'agent']
+infer: true
+handoffs:
+  - label: Start Implementation
+    agent: Plugin Implementer
+    prompt: Implement the approved plan step by step with minimal diffs.
+    send: false
+---
+You are the **planning specialist** for the `openwebui-extensions` repository.
+
+## Your Responsibilities
+1. Read existing plugin code and docs **before** proposing any change.
+2. Produce a **small, reversible** plan (one logical change per file per step).
+3. Clearly list all impacted files including the docs sync chain.
+4. Flag risks: breaking changes, release implications, version bumps needed.
+
+## Hard Rules
+- Never propose `git commit`, `git push`, or PR creation.
+- Every plan must end with an acceptance checklist for the user to approve before handing off.
+- Reference `.github/copilot-instructions.md` as the authoritative spec.
+
+## Repository Plugin Inventory
+
+### Actions (`plugins/actions/`)
+| Dir | Main file | Version | i18n status |
+|-----|-----------|---------|-------------|
+| `deep-dive` | `deep_dive.py` | 1.0.0 | ⚠️ has `deep_dive_cn.py` split |
+| `export_to_docx` | `export_to_word.py` | 0.4.4 | ⚠️ has `export_to_word_cn.py` split |
+| `export_to_excel` | `export_to_excel.py` | 0.3.7 | ⚠️ has `export_to_excel_cn.py` split |
+| `flash-card` | `flash_card.py` | 0.2.4 | ⚠️ has `flash_card_cn.py` split |
+| `infographic` | `infographic.py` | 1.5.0 | ⚠️ has `infographic_cn.py` split |
+| `smart-mind-map` | `smart_mind_map.py` | 1.0.0 | ✅ single file |
+| `smart-mermaid` | _(empty stub)_ | — | — |
+
+### Filters (`plugins/filters/`)
+| Dir | Main file | Version | i18n status |
+|-----|-----------|---------|-------------|
+| `async-context-compression` | `async_context_compression.py` | 1.3.0 | ✅ |
+| `context_enhancement_filter` | `context_enhancement_filter.py` | 0.3 | ⚠️ non-SemVer version |
+| `copilot_files_preprocessor` | _(empty stub)_ | — | — |
+| `folder-memory` | `folder_memory.py` | 0.1.0 | ⚠️ has `folder_memory_cn.py` split |
+| `github_copilot_sdk_files_filter` | `github_copilot_sdk_files_filter.py` | 0.1.2 | ✅ |
+| `markdown_normalizer` | `markdown_normalizer.py` | 1.2.4 | ✅ |
+| `web_gemini_multimodel_filter` | `web_gemini_multimodel.py` | 0.3.2 | ✅ |
+
+### Pipes / Pipelines / Tools
+| Path | Main file | Version |
+|------|-----------|---------|
+| `pipes/github-copilot-sdk` | `github_copilot_sdk.py` | 0.7.0 |
+| `pipelines/moe_prompt_refiner` | `moe_prompt_refiner.py` | — |
+| `tools/workspace-file-manager` | `workspace_file_manager.py` | 0.2.0 |
+
+## Naming Conventions (Actual Mix)
+- Action dirs: some use **dashes** (`deep-dive`, `flash-card`, `smart-mind-map`), some **underscores** (`export_to_docx`, `export_to_excel`, `infographic`)
+- Filter dirs: similarly mixed — prefer underscores for new plugins
+- Main `.py` filenames always use **underscores**
+
+## Docs Sync Chain (for every plugin change)
+For `plugins/{type}/{name}/`, these 7+ files must stay in sync:
+1. `plugins/{type}/{name}/{name}.py` — version in docstring
+2. `plugins/{type}/{name}/README.md` — version + What's New
+3. `plugins/{type}/{name}/README_CN.md` — version + 最新更新
+4. `docs/plugins/{type}/{name}.md`
+5. `docs/plugins/{type}/{name}.zh.md`
+6. `docs/plugins/{type}/index.md` — version badge
+7. `docs/plugins/{type}/index.zh.md` — version badge
+8. Root `README.md` / `README_CN.md` — date badge
+
+## Output Format
+- **Scope summary**
+- **Affected files** (full relative paths)
+- **Step-by-step plan** (numbered, ≤10 steps)
+- **Risk flags** (version bump? breaking change? split-file migration needed?)
+- **Acceptance checklist** → user must approve before handoff to Implementer

.github/agents/plugin-reviewer.agent.md

@@ -0,0 +1,71 @@
+---
+name: Plugin Reviewer
+description: Perform strict repository-aligned code review for OpenWebUI plugin changes
+argument-hint: Share changed files or branch diff to review
+tools: ['search', 'read/readFile', 'web', 'web/fetch', 'web/githubRepo', 'execute/getTerminalOutput', 'read/terminalLastCommand', 'read/terminalSelection']
+infer: true
+handoffs:
+  - label: Prepare Release Draft
+    agent: Release Prep
+    prompt: Create a bilingual release draft and commit message based on reviewed changes.
+    send: false
+---
+You are the **review specialist** for the `openwebui-extensions` repository.
+
+Full review rules are in .github/instructions/code-review.instructions.md.
+
+## Review Checklist
+
+### 🔴 Blocking (must fix before release)
+
+**1. Single-file i18n Architecture**
+- [ ] No new `_cn.py` split files created.
+- [ ] All user-visible strings go through `TRANSLATIONS[lang].get(key, fallback)`.
+- [ ] `FALLBACK_MAP` covers at least `zh → zh-CN` and `en → en-US`.
+- [ ] `format(**kwargs)` on translations wrapped in `try/except KeyError`.
+
+**2. Context Helpers**
+- [ ] Uses `_get_user_context(__user__)` (not `__user__["name"]` directly).
+- [ ] Uses `_get_chat_context(body, __metadata__)` (not ad-hoc `body.get("chat_id")`).
+
+**3. Antigravity Safety**
+- [ ] Every `__event_call__` wrapped: `asyncio.wait_for(..., timeout=2.0)`.
+- [ ] JS code passed to `__event_call__` has `try { ... } catch(e) { return fallback; }`.
+- [ ] File path operations validated against workspace root (no traversal).
+- [ ] Upload paths have dual-channel fallback (API → DB/local).
+
+**4. Emitter Guards**
+- [ ] Every `await emitter(...)` guarded by `if emitter:`.
+- [ ] `_emit_status(done=False)` on start, `done=True` on success, `_emit_notification("error")` on failure.
+- [ ] No bare `print()` — use `logging.getLogger(__name__)`.
+
+**5. Filter Singleton Safety**
+- [ ] No mutable per-request state stored on `self` in Filter plugins.
+
+**6. Streaming Compatibility (OpenWebUI 0.8.x)**
+- [ ] `</think>` tag closed before any normal text or tool cards.
+- [ ] `<details type="tool_calls" ...>` attributes escape `"` as `&quot;`.
+- [ ] `<details ...>` block has newline immediately after `>`.
+
+**7. Version & Docs Sync**
+- [ ] Version bumped in docstring (if release).
+- [ ] `README.md` + `README_CN.md` updated (What's New + version).
+- [ ] `docs/plugins/{type}/{name}.md` and `.zh.md` match README.
+- [ ] `docs/plugins/{type}/index.md` and `.zh.md` version badges updated.
+- [ ] Root `README.md` / `README_CN.md` date badge updated.
+
+### 🟡 Non-blocking (suggestions)
+- Copilot SDK tools: `params_type=MyParams` in `define_tool()`.
+- Long tasks (>3s): periodic `_emit_notification("info")` every 5s.
+- `icon_url` present for Action plugins (Lucide SVG, base64).
+
+## Known Pre-existing Issues (Don't block on unless the PR introduces new ones)
+- `_cn.py` splits in: `deep-dive`, `export_to_docx`, `export_to_excel`, `flash-card`, `infographic`, `folder-memory` — legacy, not new.
+- `context_enhancement_filter` version is `0.3` (non-SemVer) — pre-existing.
+- `copilot_files_preprocessor` and `smart-mermaid` are empty stubs — pre-existing.
+
+## Review Output
+- **Blocking issues** (file:line references)
+- **Non-blocking suggestions**
+- **Pass / Fail verdict**
+- **Next step**: Pass → handoff to Release Prep; Fail → return to Implementer with fix list

.github/agents/release-prep.agent.md

@@ -0,0 +1,82 @@
+---
+name: Release Prep
+description: Prepare release-ready summaries and Conventional Commit drafts without pushing
+argument-hint: Provide final change list and target version (optional)
+tools: ['search', 'read/readFile', 'web', 'web/fetch', 'web/githubRepo', 'execute/getTerminalOutput', 'read/terminalLastCommand', 'read/terminalSelection']
+infer: true
+---
+You are the **release preparation specialist** for the `openwebui-extensions` repository.
+
+Full commit message rules: .github/instructions/commit-message.instructions.md
+Full release workflow: .agent/workflows/plugin-development.md
+
+## Responsibilities
+1. Generate a Conventional Commit message (English only).
+2. Draft bilingual release notes (EN + 中文).
+3. Verify ALL file sync locations are updated.
+4. **Stop before any commit or push** — wait for explicit user confirmation.
+
+## Commit Message Format
+```text
+type(scope): brief imperative description
+
+- Key change 1
+- Key change 2 (include migration note if needed)
+```
+- `type`: `feat` / `fix` / `docs` / `refactor` / `chore`
+- `scope`: plugin folder name (e.g., `smart-mind-map`, `github-copilot-sdk`, `folder-memory`)
+- Title ≤ 72 chars, imperative mood, no trailing period, no capital first letter
+
+## 9-File Sync Checklist (fill in for each changed plugin)
+```text
+Plugin: {type}/{name} → v{new_version}
+[ ] 1. plugins/{type}/{name}/{name}.py          → version in docstring
+[ ] 2. plugins/{type}/{name}/README.md          → version + What's New
+[ ] 3. plugins/{type}/{name}/README_CN.md       → version + 最新更新
+[ ] 4. docs/plugins/{type}/{name}.md            → mirrors README
+[ ] 5. docs/plugins/{type}/{name}.zh.md         → mirrors README_CN
+[ ] 6. docs/plugins/{type}/index.md             → version badge updated
+[ ] 7. docs/plugins/{type}/index.zh.md          → version badge updated
+[ ] 8. README.md (root)                         → date badge updated
+[ ] 9. README_CN.md (root)                      → date badge updated
+```
+
+## Current Plugin Versions (as of last audit — 2026-02-23)
+| Plugin | Type | Version | Note |
+|--------|------|---------|------|
+| deep-dive | action | 1.0.0 | has `_cn.py` split |
+| export_to_docx | action | 0.4.4 | has `_cn.py` split |
+| export_to_excel | action | 0.3.7 | has `_cn.py` split |
+| flash-card | action | 0.2.4 | has `_cn.py` split |
+| infographic | action | 1.5.0 | has `_cn.py` split |
+| smart-mind-map | action | 1.0.0 | ✅ |
+| async-context-compression | filter | 1.3.0 | ✅ |
+| context_enhancement_filter | filter | 0.3 | ⚠️ non-SemVer |
+| folder-memory | filter | 0.1.0 | has `_cn.py` split |
+| github_copilot_sdk_files_filter | filter | 0.1.2 | ✅ |
+| markdown_normalizer | filter | 1.2.4 | ✅ |
+| web_gemini_multimodel_filter | filter | 0.3.2 | ✅ |
+| github-copilot-sdk | pipe | 0.7.0 | ✅ |
+| workspace-file-manager | tool | 0.2.0 | ✅ |
+
+## Output Template
+
+### Commit Message
+```text
+{type}({scope}): {description}
+
+- {change 1}
+- {change 2}
+```
+
+### Change Summary (EN)
+- {bullet list of user-visible changes}
+
+### 变更摘要（中文）
+- {中文要点列表}
+
+### Verification Status
+{filled-in 9-file checklist for each changed plugin}
+
+---
+⚠️ **Waiting for user confirmation — no git operations will run until explicitly approved.**

.github/instructions/code-review.instructions.md

@@ -0,0 +1,54 @@
+---
+name: Plugin Code Review
+description: Comprehensive OpenWebUI plugin review checklist covering i18n, context helpers, antigravity safety, and streaming compatibility
+applyTo: "plugins/**/*.py"
+---
+# Code Review Instructions — OpenWebUI Plugins
+
+You are an expert Senior Software Engineer reviewing OpenWebUI plugins for the `openwebui-extensions` repository.
+When reviewing plugin code, you MUST verify each point below to ensure the code meets the strict repository standards.
+
+## 1. Single-file i18n Pattern (CRITICAL)
+- **One File Rule**: One `.py` file per plugin. No `_cn.py` or language-split files.
+- **Translations**: All user-visible strings (status, notification, UI text) MUST go through a `TRANSLATIONS` dictionary and a `FALLBACK_MAP`.
+- **Safety**: `format(**kwargs)` calls on translated strings MUST be wrapped in `try/except KeyError` to prevent crashes if a translation is missing a placeholder.
+
+## 2. Context Helpers (CRITICAL)
+- **User Context**: MUST use `_get_user_context(__user__)` instead of direct `__user__["name"]` access. `__user__` can be a list, dict, or None.
+- **Chat Context**: MUST use `_get_chat_context(body, __metadata__)` instead of ad-hoc `body.get("chat_id")` calls.
+
+## 3. Event & Logging
+- **No Print**: No bare `print()` in production code. Use `logging.getLogger(__name__)`.
+- **Emitter Safety**: Every `await emitter(...)` call MUST be guarded by `if emitter:` (or equivalent).
+- **Status Lifecycle**: 
+  - `_emit_status(done=False)` at task start.
+  - `_emit_status(done=True)` on completion.
+  - `_emit_notification("error")` on failure.
+
+## 4. Antigravity Safety (CRITICAL)
+- **Timeout Guards**: All `__event_call__` JS executions MUST be wrapped with `asyncio.wait_for(..., timeout=2.0)`. Failure to do this can hang the entire backend.
+- **JS Fallbacks**: JS code executed via `__event_call__` MUST have an internal `try { ... } catch (e) { return fallback; }` block.
+- **Path Sandboxing**: File path operations MUST be validated against the workspace root (no directory traversal vulnerabilities).
+- **Upload Fallbacks**: Upload paths MUST have a dual-channel fallback (API → local/DB).
+
+## 5. Filter Singleton Safety
+- **No Mutable State**: Filter plugins are singletons. There MUST be NO request-scoped mutable state stored on `self` (e.g., `self.current_user = ...`).
+- **Statelessness**: Per-request values MUST be computed from `body` and context helpers on each call.
+
+## 6. Copilot SDK Tools
+- **Pydantic Models**: Tool parameters MUST be defined as a `pydantic.BaseModel` subclass.
+- **Explicit Params**: `define_tool(...)` MUST include `params_type=MyParams`.
+- **Naming**: Tool names MUST match `^[a-zA-Z0-9_-]+$` (ASCII only).
+
+## 7. Streaming Compatibility (OpenWebUI 0.8.x)
+- **Thinking Tags**: The `</think>` tag MUST be closed before any normal content or tool cards are emitted.
+- **Attribute Escaping**: Tool card `arguments` and `result` attributes MUST escape `"` as `&quot;`.
+- **Newline Requirement**: The `<details type="tool_calls" ...>` block MUST be followed by a newline immediately after `>`.
+
+## 8. Performance & Memory
+- **Streaming**: Large files or responses MUST be streamed, not loaded entirely into memory.
+- **Database Connections**: Plugins MUST reuse the OpenWebUI internal database connection (`owui_engine`, `owui_Session`) rather than creating new ones.
+
+## 9. HTML Injection (Action Plugins)
+- **Wrapper Template**: HTML output MUST use the standard `<!-- OPENWEBUI_PLUGIN_OUTPUT -->` wrapper.
+- **Idempotency**: The plugin MUST implement `_remove_existing_html` to ensure multiple runs do not duplicate the HTML output.

.github/instructions/commit-message.instructions.md

@@ -0,0 +1,90 @@
+---
+name: Commit Message
+description: Comprehensive Conventional Commits guidelines for openwebui-extensions
+---
+# Commit Message Instructions
+
+You are an expert developer generating commit messages for the `openwebui-extensions` repository. 
+Always adhere to the following strict guidelines based on the Conventional Commits specification.
+
+## 1. General Rules
+- **Language**: **English ONLY**. Never use Chinese or other languages in the commit title or body.
+- **Structure**:
+  ```text
+  <type>(<scope>): <subject>
+  <BLANK LINE>
+  <body>
+  <BLANK LINE>
+  <footer>
+  ```
+
+## 2. Type (`<type>`)
+Must be one of the following:
+- `feat`: A new feature or a new plugin.
+- `fix`: A bug fix.
+- `docs`: Documentation only changes (e.g., README, MkDocs).
+- `refactor`: A code change that neither fixes a bug nor adds a feature.
+- `perf`: A code change that improves performance.
+- `test`: Adding missing tests or correcting existing tests.
+- `chore`: Changes to the build process, CI/CD, or auxiliary tools/scripts.
+- `style`: Changes that do not affect the meaning of the code (white-space, formatting, etc.).
+
+## 3. Scope (`<scope>`)
+The scope should indicate the affected component or plugin.
+- **For Plugins**: Use the plugin's folder name or category (e.g., `actions`, `filters`, `pipes`, `export-to-docx`, `github-copilot-sdk`).
+- **For Docs**: Use `docs` or the specific doc section (e.g., `guide`, `readme`).
+- **For Infra**: Use `ci`, `scripts`, `deps`.
+- *Note*: Omit the scope if the change is global or spans too many components.
+
+## 4. Subject Line (`<subject>`)
+- **Length**: Keep it under 50-72 characters.
+- **Mood**: Use the imperative, present tense: "change" not "changed" nor "changes" (e.g., "add feature" instead of "added feature").
+- **Formatting**: Do not capitalize the first letter. Do not place a period `.` at the end.
+- **Clarity**: State exactly *what* changed. Avoid vague terms like "update code" or "fix bug".
+
+## 5. Body (`<body>`)
+- **When to use**: Highly recommended for `feat`, `fix`, and `refactor`.
+- **Content**: Explain *what* and *why* (motivation), not just *how* (the code diff shows the how).
+- **Format**: Use a bulleted list (1-3 points) for readability.
+- **Repo Specifics**: If the commit involves a plugin version bump, explicitly mention that the READMEs and docs were synced.
+
+## 6. Footer / Breaking Changes (`<footer>`)
+- If the commit introduces a breaking change (e.g., changing a Valve configuration key, altering a plugin's output format), append `!` after the scope/type: `feat(pipes)!: ...`
+- Add a `BREAKING CHANGE:` block in the footer explaining the migration path.
+
+## 7. Examples
+
+**Example 1: Feature with Body**
+```text
+feat(github-copilot-sdk): add antigravity timeout guards
+
+- Wrap all __event_call__ JS executions with asyncio.wait_for(timeout=2.0)
+- Add dual-channel upload fallback (API → local/DB)
+- Emit staged status events for tasks > 3 seconds
+```
+
+**Example 2: Bug Fix**
+```text
+fix(export-to-docx): resolve missing title fallback
+
+- Fallback to user_name + date when chat_title is empty
+- Prevent crash when metadata variables are missing
+```
+
+**Example 3: Documentation Sync**
+```text
+docs(plugins): sync bilingual READMEs for v1.2.0 release
+
+- Update What's New section for folder-memory plugin
+- Sync docs/plugins/filters/folder-memory.md
+```
+
+**Example 4: Breaking Change**
+```text
+refactor(core)!: rename global configuration valves
+
+- Standardize all valve keys to UPPER_SNAKE_CASE
+- Remove deprecated legacy_api_key field
+
+BREAKING CHANGE: Users must reconfigure their API keys in the UI as the old `api_key` field is no longer read.
+```

.github/instructions/test-generation.instructions.md

@@ -0,0 +1,54 @@
+---
+name: Test Generation
+description: Comprehensive Pytest conventions, mocking strategies, and model usage rules for OpenWebUI plugins
+applyTo: "plugins/debug/**,tests/**"
+---
+# Test Generation Instructions
+
+You are an expert SDET (Software Development Engineer in Test) writing tests for the `openwebui-extensions` repository.
+Follow these comprehensive guidelines to ensure robust, reliable, and cost-effective testing.
+
+## 1. Test Structure & Placement
+- **Unit Tests**: Place in the `tests/` directory at the root of the repository. Name files `test_<module>.py`.
+- **Integration/Debug Scripts**: Place in `plugins/debug/<plugin_name>/`. Name files `debug_<feature>.py` or `inspect_<feature>.py`.
+- **Fixtures**: Use `conftest.py` for shared fixtures (e.g., mock users, mock emitters, mock database sessions).
+
+## 2. Model Usage & Cost Control (CRITICAL)
+When writing tests or debug scripts that actually invoke an LLM:
+- **Allowed Models**: You MUST use low-cost models: `gpt-5-mini` (Preferred) or `gpt-4.1`.
+- **Forbidden**: NEVER use expensive models (like `gpt-4-turbo`, `claude-3-opus`) in automated tests unless explicitly requested by the user.
+- **API Keys**: Never hardcode API keys. Always read from environment variables (`os.getenv("OPENAI_API_KEY")`) or a `.env` file.
+
+## 3. Mocking OpenWebUI Internals
+OpenWebUI plugins rely heavily on injected runtime variables. Your tests must mock these accurately:
+- **`__user__`**: Mock as a dictionary. Always test both with a full user object and an empty/None object to ensure fallback logic works.
+  ```python
+  mock_user_en = {"id": "u1", "name": "Alice", "language": "en-US"}
+  mock_user_zh = {"id": "u2", "name": "Bob", "language": "zh-CN"}
+  mock_user_none = None
+  ```
+- **`__event_emitter__`**: Mock as an async callable that records emitted events for assertion.
+  ```python
+  async def mock_emitter(event: dict):
+      emitted_events.append(event)
+  ```
+- **`__event_call__`**: Mock as an async callable. To test Antigravity timeout guards, you must occasionally mock this to sleep longer than the timeout (e.g., `await asyncio.sleep(3.0)`) to ensure `asyncio.wait_for` catches it.
+
+## 4. Testing Async Code
+- All OpenWebUI plugin entry points (`action`, `inlet`, `outlet`) are asynchronous.
+- Use `@pytest.mark.asyncio` for all test functions.
+- Ensure you `await` all plugin method calls.
+
+## 5. i18n (Internationalization) Testing
+Since all plugins must be single-file i18n:
+- **Mandatory**: Write parameterized tests to verify output in both English (`en-US`) and Chinese (`zh-CN`).
+- Verify that if an unsupported language is passed (e.g., `fr-FR`), the system correctly falls back to the default (usually `en-US`).
+
+## 6. Antigravity & Safety Testing
+- **Timeout Guards**: Explicitly test that frontend JS executions (`__event_call__`) do not hang the backend. Assert that a `TimeoutError` is caught and handled gracefully.
+- **State Leakage**: For `Filter` plugins (which are singletons), write tests that simulate concurrent requests from different users to ensure no state leaks across `self`.
+
+## 7. Assertions & Best Practices
+- Assert on **behavior and output**, not internal implementation details.
+- For HTML/Markdown generation plugins, use Regex or BeautifulSoup to assert the presence of required tags (e.g., `<!-- OPENWEBUI_PLUGIN_OUTPUT -->`) rather than exact string matching.
+- Keep tests isolated. Do not rely on the execution order of tests.

.github/skills/README.md

@@ -0,0 +1,71 @@
+# Agent Skills Index
+
+This folder contains reusable Agent Skills for GitHub Copilot / VS Code custom agent workflows.
+
+## Available Skills
+
+- **community-announcer**
+  - Purpose: Generate community announcement content and related assets.
+  - Entry: `community-announcer/SKILL.md`
+
+- **doc-mirror-sync**
+  - Purpose: Sync mirrored documentation content and helper scripts.
+  - Entry: `doc-mirror-sync/SKILL.md`
+
+- **gh-issue-replier**
+  - Purpose: Draft standardized issue replies with templates.
+  - Entry: `gh-issue-replier/SKILL.md`
+
+- **gh-issue-scheduler**
+  - Purpose: Schedule and discover unanswered issues for follow-up.
+  - Entry: `gh-issue-scheduler/SKILL.md`
+
+- **i18n-validator**
+  - Purpose: Validate translation key consistency across i18n dictionaries.
+  - Entry: `i18n-validator/SKILL.md`
+
+- **plugin-scaffolder**
+  - Purpose: Scaffold OpenWebUI plugin boilerplate with repository standards.
+  - Entry: `plugin-scaffolder/SKILL.md`
+
+- **version-bumper**
+  - Purpose: Assist with semantic version bumping workflows.
+  - Entry: `version-bumper/SKILL.md`
+
+- **xlsx-single-file**
+  - Purpose: Single-file spreadsheet operations workflow without LibreOffice.
+  - Entry: `xlsx-single-file/SKILL.md`
+
+---
+
+## Release Pipeline Skills
+
+These four skills form a complete release pipeline and are designed to be used in sequence:
+
+```
+release-prep  →  pr-submitter  →  pr-reviewer  →  release-finalizer
+ (prepare)       (push & PR)      (respond to review)  (merge & close issue)
+```
+
+- **release-prep**
+  - Purpose: Full release preparation — version sync across 7+ files, bilingual release notes creation, consistency check, and commit.
+  - Entry: `release-prep/SKILL.md`
+
+- **pr-submitter**
+  - Purpose: Shell-escape-safe PR submission — writes body to temp file, validates sections, pushes branch, creates PR via `gh pr create --body-file`.
+  - Entry: `pr-submitter/SKILL.md`
+
+- **pr-reviewer**
+  - Purpose: Fetch PR review comments, categorize feedback, implement fixes, commit and push, reply to reviewers.
+  - Entry: `pr-reviewer/SKILL.md`
+
+- **release-finalizer**
+  - Purpose: Merge release PR to main with proper commit message, auto-link and close related issues, post closing messages.
+  - Entry: `release-finalizer/SKILL.md`
+
+## Notes
+
+- Skill definitions follow the expected location pattern:
+  - `.github/skills/<skill-name>/SKILL.md`
+- Each skill may include optional `assets/`, `references/`, and `scripts/` folders.
+- This directory mirrors `.gemini/skills` for compatibility.

.github/skills/community-announcer/SKILL.md

@@ -0,0 +1,23 @@
+---
+name: community-announcer
+description: Drafts engaging English and Chinese update announcements for the OpenWebUI Community and other social platforms. Use when a new version is released.
+---
+
+# Community Announcer
+
+## Overview
+Automates the drafting of high-impact update announcements.
+
+## Workflow
+1. **Source Intel**: Read the latest version's `What's New` section from `README.md`.
+2. **Drafting**: Create two versions:
+   - **Community Post**: Professional, structured, technical.
+   - **Catchy Short**: For Discord/Twitter, use emojis and bullet points.
+3. **Multi-language**: Generate BOTH English and Chinese versions automatically.
+
+## Announcement Structure (Recommended)
+- **Headline**: "Update vX.X.X - [Main Feature]"
+- **Introduction**: Brief context.
+- **Key Highlights**: Bulleted list of fixes/features.
+- **Action**: "Download from [Market Link]"
+- **Closing**: Thanks and Star request.

.github/skills/doc-mirror-sync/SKILL.md

@@ -0,0 +1,50 @@
+---
+name: doc-mirror-sync
+description: Automatically synchronizes plugin READMEs to the official documentation directory (docs/). Use after editing a plugin's local documentation to keep the MkDocs site up to date.
+---
+
+# Doc Mirror Sync
+
+## Overview
+Automates the mirroring of `plugins/{type}/{name}/README.md` to `docs/plugins/{type}/{name}.md`.
+
+## Docs-Only Mode (No Release Changes)
+Use this mode when the request is "only sync docs".
+
+- Only update documentation mirror files under `docs/plugins/**`.
+- Do **not** bump plugin version.
+- Do **not** modify plugin code (`plugins/**.py`) unless explicitly requested.
+- Do **not** update root badges/dates for release.
+- Do **not** run release preparation steps.
+
+## Workflow
+1. Identify changed READMEs.
+2. Copy content to corresponding mirror paths.
+3. Update version badges in `docs/plugins/{type}/index.md`.
+
+## Commands
+
+### Sync all mirrors (EN + ZH)
+
+```bash
+python .github/skills/doc-mirror-sync/scripts/sync.py
+```
+
+### Sync only one plugin (EN only)
+
+```bash
+cp plugins/<type>/<name>/README.md docs/plugins/<type>/<name>.md
+```
+
+### Sync only one plugin (EN + ZH)
+
+```bash
+cp plugins/<type>/<name>/README.md docs/plugins/<type>/<name>.md
+cp plugins/<type>/<name>/README_CN.md docs/plugins/<type>/<name>.zh.md
+```
+
+## Notes
+
+- If asked for English-only update, sync only `README.md` -> `.md` mirror.
+- If both languages are requested, sync both `README.md` and `README_CN.md`.
+- After syncing, verify git diff only contains docs file changes.

.github/skills/doc-mirror-sync/scripts/sync.py

@@ -0,0 +1,38 @@
+#!/usr/bin/env python3
+import os
+import shutil
+import re
+
+def sync_mirrors():
+    plugins_root = "plugins"
+    docs_root = "docs/plugins"
+    
+    types = ["actions", "filters", "pipes", "pipelines", "tools"]
+    
+    for t in types:
+        src_type_dir = os.path.join(plugins_root, t)
+        dest_type_dir = os.path.join(docs_root, t)
+        
+        if not os.path.exists(src_type_dir): continue
+        os.makedirs(dest_type_dir, exist_ok=True)
+        
+        for name in os.listdir(src_type_dir):
+            plugin_dir = os.path.join(src_type_dir, name)
+            if not os.path.isdir(plugin_dir): continue
+            
+            # Sync README.md -> docs/plugins/{type}/{name}.md
+            src_readme = os.path.join(plugin_dir, "README.md")
+            if os.path.exists(src_readme):
+                dest_readme = os.path.join(dest_type_dir, f"{name}.md")
+                shutil.copy(src_readme, dest_readme)
+                print(f"✅ Mirrored: {t}/{name} (EN)")
+            
+            # Sync README_CN.md -> docs/plugins/{type}/{name}.zh.md
+            src_readme_cn = os.path.join(plugin_dir, "README_CN.md")
+            if os.path.exists(src_readme_cn):
+                dest_readme_zh = os.path.join(dest_type_dir, f"{name}.zh.md")
+                shutil.copy(src_readme_cn, dest_readme_zh)
+                print(f"✅ Mirrored: {t}/{name} (ZH)")
+
+if __name__ == "__main__":
+    sync_mirrors()

.github/skills/gh-issue-replier/SKILL.md

@@ -0,0 +1,51 @@
+---
+name: gh-issue-replier
+description: Professional English replier for GitHub issues. Use when a task is completed, a bug is fixed, or more info is needed from the user. Automates replying using the 'gh' CLI tool.
+---
+
+# Gh Issue Replier
+
+## Overview
+
+The `gh-issue-replier` skill enables Gemini CLI to interact with GitHub issues professionally. It enforces English for all communications and leverages the `gh` CLI to post comments.
+
+## Workflow
+
+1.  **Identify the Issue**: Find the issue number (e.g., #49).
+2.  **Check Star Status**: Run the bundled script to check if the author has starred the repo.
+    *   Command: `bash scripts/check_star.sh <issue-number>`
+    *   Interpretation: 
+        *   Exit code **0**: User has starred. Use "Already Starred" templates.
+        *   Exit code **1**: User has NOT starred. Include "Star Request" in the reply.
+3.  **Select a Template**: Load [templates.md](references/templates.md) to choose a suitable English response pattern.
+4.  **Draft the Reply**: Compose a concise message based on the star status.
+5.  **Post the Comment**: Use the `gh` tool to submit the reply.
+
+## Tool Integration
+
+### Check Star Status
+```bash
+bash scripts/check_star.sh <issue-number>
+```
+
+### Post Comment
+```bash
+gh issue comment <issue-number> --body "<message-body>"
+```
+
+Example (if user has NOT starred):
+```bash
+gh issue comment 49 --body "This has been fixed in v1.2.7. If you find this helpful, a star on the repo would be much appreciated! ⭐"
+```
+
+Example (if user HAS starred):
+```bash
+gh issue comment 49 --body "This has been fixed in v1.2.7. Thanks for your support!"
+```
+
+## Guidelines
+
+-   **Language**: ALWAYS use English for the comment body, even if the system prompt or user conversation is in another language.
+-   **Tone**: Professional, helpful, and appreciative.
+-   **Precision**: When announcing a fix, mention the specific version or the logic change (e.g., "Updated regex pattern").
+-   **Closing**: If the issue is resolved and you have permission, you can also use `gh issue close <number>`.

.github/skills/gh-issue-replier/references/example_reference.md

@@ -0,0 +1,17 @@
+# Reference Documentation for Gh Issue Replier
+
+This is a placeholder for detailed reference documentation.
+Replace with actual reference content or delete if not needed.
+
+## Structure Suggestions
+
+### API Reference Example
+- Overview
+- Authentication
+- Endpoints with examples
+- Error codes
+
+### Workflow Guide Example
+- Prerequisites
+- Step-by-step instructions
+- Best practices

.github/skills/gh-issue-replier/references/templates.md

@@ -0,0 +1,45 @@
+# Issue Reply Templates
+
+Use these templates to craft professional English replies. Adjust placeholders like `@username`, `v1.2.x`, and `[commit hash]` as needed.
+
+## 1. Acknowledging a New Issue
+Use when you first see an issue and want to let the user know you are working on it.
+
+- "Thank you for reporting this! I'm looking into it right now."
+- "Thanks for bringing this to my attention. I'll try to reproduce this behavior and get back to you shortly."
+
+## 2. Requesting More Information
+Use when you need logs or specific details to fix the bug.
+
+- "Could you please provide the **'Original'** vs **'Normalized'** content from your browser console logs (F12)? It would help a lot in debugging."
+- "It would be very helpful if you could share the specific Markdown text that triggered this issue."
+
+## 3. Announcing a Fix
+Use when you have pushed the fix to the repository.
+
+- "This has been fixed in version **v1.2.x**. You can update the plugin to resolve it."
+- "I've just pushed a fix for this in [commit hash]. Please let me know if it works for you after updating."
+- "The issue was caused by a greedy regex pattern. I've updated it to use a tempered greedy token to prevent incorrect merging."
+
+## 4. Guiding to Official Market
+Always provide the official market link to ensure the user gets the latest verified version.
+
+- "The fix is now live! You can download the latest version from the official OpenWebUI Community page here: [Plugin Market Link]. Simply update the function in your OpenWebUI instance to apply the changes."
+- "I recommend getting the updated version from the official store: [Link]. It includes the fix for the spacing issue we discussed."
+
+## 5. Closing the Issue
+Use when the issue is confirmed resolved.
+
+- "Glad to hear it's working now! Closing this for now. Feel free to reopen it if the problem persists."
+- "Since this is resolved, I'm closing this issue. Thanks again for your feedback!"
+
+## 5. Pro-tip: Star Request
+Gently handle star requests based on the user's current status.
+
+### If User has NOT starred:
+- "If you find this plugin helpful, a star on the repo would be much appreciated! ⭐"
+- "We'd love your support! If this fixed your issue, please consider starring the repository. ⭐"
+
+### If User HAS already starred:
+- "Thanks again for starring the project and for your continuous support!"
+- "I appreciate your support and for being a stargazer of this project!"

.github/skills/gh-issue-replier/scripts/check_star.sh

@@ -0,0 +1,31 @@
+#!/usr/bin/env bash
+
+# Robust Star Checker v2
+# Usage: ./check_star.sh <issue_number>
+
+ISSUE_NUM=$1
+if [ -z "$ISSUE_NUM" ]; then exit 2; fi
+
+# 1. Get Repo and Author info
+REPO_FULL=$(gh repo view --json owner,name -q ".owner.login + \"/\" + .name")
+USER_LOGIN=$(gh issue view "$ISSUE_NUM" --json author -q ".author.login")
+
+# 2. Use GraphQL for high precision (Detects stars even when REST 404s)
+IS_STARRED=$(gh api graphql -f query='
+query($owner:String!, $repo:String!, $user:String!) {
+  repository(owner:$owner, name:$repo) {
+    stargazers(query:$user, first:1) {
+      nodes {
+        login
+      }
+    }
+  }
+}' -f owner="${REPO_FULL%/*}" -f repo="${REPO_FULL#*/}" -f user="$USER_LOGIN" -q ".data.repository.stargazers.nodes[0].login")
+
+if [ "$IS_STARRED" == "$USER_LOGIN" ]; then
+    echo "Confirmed: @$USER_LOGIN HAS starred $REPO_FULL. ⭐"
+    exit 0
+else
+    echo "Confirmed: @$USER_LOGIN has NOT starred $REPO_FULL."
+    exit 1
+fi

.github/skills/gh-issue-scheduler/SKILL.md

@@ -0,0 +1,42 @@
+---
+name: gh-issue-scheduler
+description: Finds all open GitHub issues that haven't been replied to by the owner, summarizes them, and generates a solution plan. Use when the user wants to audit pending tasks or plan maintenance work.
+---
+
+# Gh Issue Scheduler
+
+## Overview
+
+The `gh-issue-scheduler` skill helps maintainers track community feedback by identifying unaddressed issues and drafting actionable technical plans to resolve them.
+
+## Workflow
+
+1.  **Identify Unanswered Issues**: Run the bundled script to fetch issues without owner replies.
+    *   Command: `bash scripts/find_unanswered.sh`
+2.  **Analyze and Summarize**: For each identified issue, summarize the core problem and the user's intent.
+3.  **Generate Solution Plans**: Draft a technical "Action Plan" for each issue, including:
+    *   **Root Cause Analysis** (if possible)
+    *   **Proposed Fix/Implementation**
+    *   **Verification Strategy**
+4.  **Present to User**: Display a structured report of all pending issues and their respective plans.
+
+## Tool Integration
+
+### Find Unanswered Issues
+```bash
+bash scripts/find_unanswered.sh
+```
+
+## Report Format
+
+When presenting the summary, use the following Markdown structure:
+
+### 📋 Unanswered Issues Audit
+
+#### Issue #[Number]: [Title]
+- **Author**: @username
+- **Summary**: Concise description of the problem.
+- **Action Plan**:
+    1. Step 1 (e.g., Investigate file X)
+    2. Step 2 (e.g., Apply fix Y)
+    3. Verification (e.g., Run test Z)

.github/skills/gh-issue-scheduler/scripts/find_unanswered.sh

@@ -0,0 +1,42 @@
+#!/usr/bin/env bash
+
+# Fetch all open issues and filter for those without responses from the owner/collaborators.
+# Uses 'gh' CLI.
+
+REPO_FULL=$(gh repo view --json owner,name -q ".owner.login + "/" + .name")
+OWNER=${REPO_FULL%/*}
+
+# 1. Get all open issues
+OPEN_ISSUES=$(gh issue list --state open --json number,title,author,createdAt --limit 100)
+
+echo "Analysis for repository: $REPO_FULL"
+echo "------------------------------------"
+
+# Process each issue
+echo "$OPEN_ISSUES" | jq -c '.[]' | while read -r issue; do
+    NUMBER=$(echo "$issue" | jq -r '.number')
+    TITLE=$(echo "$issue" | jq -r '.title')
+    AUTHOR=$(echo "$issue" | jq -r '.author.login')
+    
+    # Check comments for owner responses
+    # We look for comments where the author is the repo owner
+    COMMENTS=$(gh issue view "$NUMBER" --json comments -q ".comments[].author.login" 2>/dev/null)
+    
+    HAS_OWNER_REPLY=false
+    for COMMENT_AUTHOR in $COMMENTS; do
+        if [ "$COMMENT_AUTHOR" == "$OWNER" ]; then
+            HAS_OWNER_REPLY=true
+            break
+        fi
+    done
+    
+    if [ "$HAS_OWNER_REPLY" == "false" ]; then
+        echo "ISSUE_START"
+        echo "ID: $NUMBER"
+        echo "Title: $TITLE"
+        echo "Author: $AUTHOR"
+        echo "Description:"
+        gh issue view "$NUMBER" --json body -q ".body"
+        echo "ISSUE_END"
+    fi
+done

.github/skills/i18n-validator/SKILL.md

@@ -0,0 +1,14 @@
+---
+name: i18n-validator
+description: Validates multi-language consistency in the TRANSLATIONS dictionary of a plugin. Use to check if any language keys are missing or if translations need updating.
+---
+
+# I18n Validator
+
+## Overview
+Ensures all 12 supported languages (en-US, zh-CN, etc.) have aligned translation keys.
+
+## Features
+- Detects missing keys in non-English dictionaries.
+- Suggests translations using the core AI engine.
+- Validates the `fallback_map` for variant redirects.

.github/skills/i18n-validator/scripts/validate_i18n.py

@@ -0,0 +1,54 @@
+#!/usr/bin/env python3
+import sys
+import ast
+import os
+
+def check_i18n(file_path):
+    if not os.path.exists(file_path):
+        print(f"Error: File not found {file_path}")
+        return
+    
+    with open(file_path, 'r', encoding='utf-8') as f:
+        tree = ast.parse(f.read())
+    
+    translations = {}
+    for node in tree.body:
+        if isinstance(node, ast.Assign):
+            for target in node.targets:
+                if isinstance(target, ast.Name) and target.id == "TRANSLATIONS":
+                    translations = ast.literal_eval(node.value)
+                    break
+    
+    if not translations:
+        print("⚠️ No TRANSLATIONS dictionary found.")
+        return
+
+    # Base keys from English
+    base_lang = "en-US"
+    if base_lang not in translations:
+        print(f"❌ Error: {base_lang} missing in TRANSLATIONS.")
+        return
+    
+    base_keys = set(translations[base_lang].keys())
+    print(f"🔍 Analyzing {file_path}...")
+    print(f"Standard keys ({len(base_keys)}): {', '.join(sorted(base_keys))}
+")
+
+    for lang, keys in translations.items():
+        if lang == base_lang: continue
+        lang_keys = set(keys.keys())
+        missing = base_keys - lang_keys
+        extra = lang_keys - base_keys
+        
+        if missing:
+            print(f"❌ {lang}: Missing {len(missing)} keys: {', '.join(missing)}")
+        if extra:
+            print(f"⚠️ {lang}: Has {len(extra)} extra keys: {', '.join(extra)}")
+        if not missing and not extra:
+            print(f"✅ {lang}: Aligned.")
+
+if __name__ == "__main__":
+    if len(sys.argv) < 2:
+        print("Usage: validate_i18n.py <path_to_plugin.py>")
+        sys.exit(1)
+    check_i18n(sys.argv[1])

.github/skills/plugin-scaffolder/SKILL.md

@@ -0,0 +1,19 @@
+---
+name: plugin-scaffolder
+description: Generates a standardized single-file i18n Python plugin template based on project standards. Use when starting a new plugin development to skip boilerplate writing.
+---
+
+# Plugin Scaffolder
+
+## Overview
+Generates compliant OpenWebUI plugin templates with built-in i18n, common utility methods, and required docstring fields.
+
+## Usage
+1. Provide the **Plugin Name** and **Type** (action/filter/pipe).
+2. The skill will generate the `.py` file and the bilingual `README` files.
+
+## Template Standard
+- `Valves(BaseModel)` with `UPPER_SNAKE_CASE`
+- `_get_user_context` with JS fallback and timeout
+- `_emit_status` and `_emit_debug_log` methods
+- Standardized docstring metadata

.github/skills/plugin-scaffolder/assets/README_template.md

@@ -0,0 +1,34 @@
+# {{TITLE}}
+
+**Author:** [Fu-Jie](https://github.com/Fu-Jie/openwebui-extensions) | **Version:** 0.1.0 | **Project:** [OpenWebUI Extensions](https://github.com/Fu-Jie/openwebui-extensions) | **License:** MIT
+
+{{DESCRIPTION}}
+
+## 🔥 What's New in v0.1.0
+
+* Initial release of {{TITLE}}.
+
+## 🌐 Multilingual Support
+
+Supports automatic interface and status switching for the following languages:
+`English`, `简体中文`, `繁體中文 (香港)`, `繁體中文 (台灣)`, `한국어`, `日本語`, `Français`, `Deutsch`, `Español`, `Italiano`, `Tiếng Việt`, `Bahasa Indonesia`.
+
+## ✨ Core Features
+
+* Feature 1
+* Feature 2
+
+## How to Use 🛠️
+
+1. Install the plugin in Open WebUI.
+2. Configure settings in Valves.
+
+## Configuration (Valves) ⚙️
+
+| Parameter | Default | Description |
+| :--- | :--- | :--- |
+| `priority` | `50` | Execution priority. |
+
+## ⭐ Support
+
+If this plugin has been useful, a star on [OpenWebUI Extensions](https://github.com/Fu-Jie/openwebui-extensions) is a big motivation for me. Thank you for the support.

.github/skills/plugin-scaffolder/assets/template.py

@@ -0,0 +1,80 @@
+"""
+title: {{TITLE}}
+author: Fu-Jie
+author_url: https://github.com/Fu-Jie/openwebui-extensions
+funding_url: https://github.com/open-webui
+version: 0.1.0
+description: {{DESCRIPTION}}
+"""
+
+import asyncio
+import logging
+import json
+from typing import Optional, Dict, Any, List, Callable, Awaitable
+from pydantic import BaseModel, Field
+from fastapi import Request
+
+# Configure logging
+logging.basicConfig(level=logging.INFO, format="%(asctime)s - %(name)s - %(levelname)s - %(message)s")
+logger = logging.getLogger(__name__)
+
+TRANSLATIONS = {
+    "en-US": {"status_starting": "Starting {{TITLE}}..."},
+    "zh-CN": {"status_starting": "正在启动 {{TITLE}}..."},
+    "zh-HK": {"status_starting": "正在啟動 {{TITLE}}..."},
+    "zh-TW": {"status_starting": "正在啟動 {{TITLE}}..."},
+    "ko-KR": {"status_starting": "{{TITLE}} 시작 중..."},
+    "ja-JP": {"status_starting": "{{TITLE}} を起動中..."},
+    "fr-FR": {"status_starting": "Démarrage de {{TITLE}}..."},
+    "de-DE": {"status_starting": "{{TITLE}} wird gestartet..."},
+    "es-ES": {"status_starting": "Iniciando {{TITLE}}..."},
+    "it-IT": {"status_starting": "Avvio di {{TITLE}}..."},
+    "vi-VN": {"status_starting": "Đang khởi động {{TITLE}}..."},
+    "id-ID": {"status_starting": "Memulai {{TITLE}}..."},
+}
+
+class {{CLASS_NAME}}:
+    class Valves(BaseModel):
+        priority: int = Field(default=50, description="Priority level (lower = earlier).")
+        show_status: bool = Field(default=True, description="Show status updates in UI.")
+
+    def __init__(self):
+        self.valves = self.Valves()
+        self.fallback_map = {
+            "zh": "zh-CN", "en": "en-US", "ko": "ko-KR", "ja": "ja-JP",
+            "fr": "fr-FR", "de": "de-DE", "es": "es-ES", "it": "it-IT",
+            "vi": "vi-VN", "id": "id-ID"
+        }
+
+    def _get_translation(self, lang: str, key: str, **kwargs) -> str:
+        target_lang = lang
+        if target_lang not in TRANSLATIONS:
+            base = target_lang.split("-")[0]
+            target_lang = self.fallback_map.get(base, "en-US")
+        
+        lang_dict = TRANSLATIONS.get(target_lang, TRANSLATIONS["en-US"])
+        text = lang_dict.get(key, TRANSLATIONS["en-US"].get(key, key))
+        return text.format(**kwargs) if kwargs else text
+
+    async def _get_user_context(self, __user__: Optional[dict], __event_call__: Optional[Callable] = None, __request__: Optional[Request] = None) -> dict:
+        user_data = __user__ if isinstance(__user__, dict) else {}
+        user_language = user_data.get("language", "en-US")
+        if __event_call__:
+            try:
+                js = "try { return (document.documentElement.lang || localStorage.getItem('locale') || navigator.language || 'en-US'); } catch (e) { return 'en-US'; }"
+                frontend_lang = await asyncio.wait_for(__event_call__({"type": "execute", "data": {"code": js}}), timeout=2.0)
+                if frontend_lang: user_language = frontend_lang
+            except: pass
+        return {"user_language": user_language}
+
+    async def {{METHOD_NAME}}(self, body: dict, __user__: Optional[dict] = None, __event_emitter__=None, __event_call__=None, __request__: Optional[Request] = None) -> dict:
+        if self.valves.show_status and __event_emitter__:
+            user_ctx = await self._get_user_context(__user__, __event_call__, __request__)
+            msg = self._get_translation(user_ctx["user_language"], "status_starting")
+            await __event_emitter__({"type": "status", "data": {"description": msg, "done": False}})
+        
+        # Implement core logic here
+        
+        if self.valves.show_status and __event_emitter__:
+            await __event_emitter__({"type": "status", "data": {"description": "Done", "done": True}})
+        return body

.github/skills/plugin-scaffolder/assets/template.py.j2

@@ -0,0 +1,80 @@
+"""
+title: {{TITLE}}
+author: Fu-Jie
+author_url: https://github.com/Fu-Jie/openwebui-extensions
+funding_url: https://github.com/open-webui
+version: 0.1.0
+description: {{DESCRIPTION}}
+"""
+
+import asyncio
+import logging
+import json
+from typing import Optional, Dict, Any, List, Callable, Awaitable
+from pydantic import BaseModel, Field
+from fastapi import Request
+
+# Configure logging
+logging.basicConfig(level=logging.INFO, format="%(asctime)s - %(name)s - %(levelname)s - %(message)s")
+logger = logging.getLogger(__name__)
+
+TRANSLATIONS = {
+    "en-US": {"status_starting": "Starting {{TITLE}}..."},
+    "zh-CN": {"status_starting": "正在启动 {{TITLE}}..."},
+    "zh-HK": {"status_starting": "正在啟動 {{TITLE}}..."},
+    "zh-TW": {"status_starting": "正在啟動 {{TITLE}}..."},
+    "ko-KR": {"status_starting": "{{TITLE}} 시작 중..."},
+    "ja-JP": {"status_starting": "{{TITLE}} を起動中..."},
+    "fr-FR": {"status_starting": "Démarrage de {{TITLE}}..."},
+    "de-DE": {"status_starting": "{{TITLE}} wird gestartet..."},
+    "es-ES": {"status_starting": "Iniciando {{TITLE}}..."},
+    "it-IT": {"status_starting": "Avvio di {{TITLE}}..."},
+    "vi-VN": {"status_starting": "Đang khởi động {{TITLE}}..."},
+    "id-ID": {"status_starting": "Memulai {{TITLE}}..."},
+}
+
+class {{CLASS_NAME}}:
+    class Valves(BaseModel):
+        priority: int = Field(default=50, description="Priority level (lower = earlier).")
+        show_status: bool = Field(default=True, description="Show status updates in UI.")
+
+    def __init__(self):
+        self.valves = self.Valves()
+        self.fallback_map = {
+            "zh": "zh-CN", "en": "en-US", "ko": "ko-KR", "ja": "ja-JP",
+            "fr": "fr-FR", "de": "de-DE", "es": "es-ES", "it": "it-IT",
+            "vi": "vi-VN", "id": "id-ID"
+        }
+
+    def _get_translation(self, lang: str, key: str, **kwargs) -> str:
+        target_lang = lang
+        if target_lang not in TRANSLATIONS:
+            base = target_lang.split("-")[0]
+            target_lang = self.fallback_map.get(base, "en-US")
+        
+        lang_dict = TRANSLATIONS.get(target_lang, TRANSLATIONS["en-US"])
+        text = lang_dict.get(key, TRANSLATIONS["en-US"].get(key, key))
+        return text.format(**kwargs) if kwargs else text
+
+    async def _get_user_context(self, __user__: Optional[dict], __event_call__: Optional[Callable] = None, __request__: Optional[Request] = None) -> dict:
+        user_data = __user__ if isinstance(__user__, dict) else {}
+        user_language = user_data.get("language", "en-US")
+        if __event_call__:
+            try:
+                js = "try { return (document.documentElement.lang || localStorage.getItem('locale') || navigator.language || 'en-US'); } catch (e) { return 'en-US'; }"
+                frontend_lang = await asyncio.wait_for(__event_call__({"type": "execute", "data": {"code": js}}), timeout=2.0)
+                if frontend_lang: user_language = frontend_lang
+            except: pass
+        return {"user_language": user_language}
+
+    async def {{METHOD_NAME}}(self, body: dict, __user__: Optional[dict] = None, __event_emitter__=None, __event_call__=None, __request__: Optional[Request] = None) -> dict:
+        if self.valves.show_status and __event_emitter__:
+            user_ctx = await self._get_user_context(__user__, __event_call__, __request__)
+            msg = self._get_translation(user_ctx["user_language"], "status_starting")
+            await __event_emitter__({"type": "status", "data": {"description": msg, "done": False}})
+        
+        # Implement core logic here
+        
+        if self.valves.show_status and __event_emitter__:
+            await __event_emitter__({"type": "status", "data": {"description": "Done", "done": True}})
+        return body

.github/skills/plugin-scaffolder/scripts/scaffold.py

@@ -0,0 +1,66 @@
+#!/usr/bin/env python3
+import sys
+import os
+
+
+def scaffold(p_type, p_name, title, desc):
+    target_dir = f"plugins/{p_type}/{p_name}"
+    os.makedirs(target_dir, exist_ok=True)
+
+    class_name = (
+        "Action"
+        if p_type == "actions"
+        else (
+            "Filter"
+            if p_type == "filters"
+            else "Tools" if p_type == "tools" else "Pipe"
+        )
+    )
+    method_name = (
+        "action"
+        if p_type == "actions"
+        else (
+            "outlet"
+            if p_type == "filters"
+            else "execute" if p_type == "tools" else "pipe"
+        )
+    )
+
+    replacements = {
+        "{{TITLE}}": title,
+        "{{DESCRIPTION}}": desc,
+        "{{CLASS_NAME}}": class_name,
+        "{{METHOD_NAME}}": method_name,
+    }
+
+    # Files to generate
+    templates = [
+        ("assets/template.py.j2", f"{p_name}.py"),
+        ("assets/README_template.md", "README.md"),
+        ("assets/README_template.md", "README_CN.md"),
+    ]
+
+    # Path relative to skill root
+    skill_root = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+
+    for t_path, t_name in templates:
+        template_file = os.path.join(skill_root, t_path)
+        if not os.path.exists(template_file):
+            print(f"⚠️ Warning: Template not found {template_file}")
+            continue
+
+        with open(template_file, "r") as f:
+            content = f.read()
+        for k, v in replacements.items():
+            content = content.replace(k, v)
+
+        with open(os.path.join(target_dir, t_name), "w") as f:
+            f.write(content)
+        print(f"✅ Generated: {target_dir}/{t_name}")
+
+
+if __name__ == "__main__":
+    if len(sys.argv) < 5:
+        print("Usage: scaffold.py <type> <name> <title> <desc>")
+        sys.exit(1)
+    scaffold(sys.argv[1], sys.argv[2], sys.argv[3], sys.argv[4])

.github/skills/pr-reviewer/SKILL.md

@@ -0,0 +1,180 @@
+---
+name: pr-reviewer
+description: Fetches PR review comments, analyzes requested changes, implements fixes, commits and pushes the resolution. Use after a reviewer has left comments on an open PR to close the feedback loop efficiently.
+---
+
+# PR Reviewer
+
+## Overview
+
+This skill automates the response cycle for code review. When a reviewer leaves comments on a Pull Request, this skill fetches all pending feedback, categorizes issues by severity, implements fixes, and submits a follow-up commit with appropriate review response comments.
+
+## Prerequisites
+
+- An open PR exists with pending review comments
+- The local branch matches the PR's head branch
+- `gh` CLI is authenticated
+
+---
+
+## Workflow
+
+### Step 1 — Fetch Review State
+
+Retrieve all review comments and overall review status:
+
+```bash
+# Get overall review decisions
+PAGER=cat GH_PAGER=cat gh pr view <PR-NUMBER> --json reviews,reviewDecision,headRefName \
+  --jq '{decision: .reviewDecision, reviews: [.reviews[] | {author: .author.login, state: .state, body: .body}]}'
+
+# Get inline code comments (specific line comments)
+PAGER=cat GH_PAGER=cat gh api repos/Fu-Jie/openwebui-extensions/pulls/<PR-NUMBER>/comments \
+  --jq '[.[] | {path: .path, line: .line, body: .body, author: .user.login, id: .id}]'
+
+# Get general issue comments
+PAGER=cat GH_PAGER=cat gh issue view <PR-NUMBER> --comments --json comments \
+  --jq '[.comments[] | {author: .author.login, body: .body}]'
+```
+
+Confirm the current local branch matches the PR head:
+```bash
+git branch --show-current
+```
+If mismatched, checkout the correct branch first.
+
+### Step 2 — Categorize Review Feedback
+
+Group feedback into categories:
+
+| Category | Examples | Action |
+|----------|---------|--------|
+| **Code Bug** | Logic error, incorrect variable, broken condition | Fix code immediately |
+| **Style / Formatting** | Indentation, naming convention, missing blank line | Fix code |
+| **Documentation** | Missing i18n key, wrong version in README, typo | Fix docs |
+| **Design Question** | Suggestion to restructure, alternative approach | Discuss with user before implementing |
+| **Nitpick / Optional** | Minor style preferences reviewer marked as optional | Fix if quick; document if skipped |
+| **Blocking** | Reviewer explicitly blocks merge | Must fix before proceeding |
+
+Present the full categorized list to the user and confirm the resolution plan.
+
+### Step 3 — Implement Fixes
+
+For each accepted fix:
+
+1. Read the affected file at the commented line for context:
+   ```bash
+   sed -n '<line-5>,<line+10>p' <file-path>
+   ```
+2. Apply the fix using appropriate file edit tools
+3. After editing, verify the specific area looks correct
+
+**For code changes that might affect behavior:**
+- Check if tests exist: `ls tests/test_*.py`
+- If tests exist, run them: `python -m pytest tests/ -v`
+
+**For documentation fixes:**
+- If modifying README.md, check if `docs/` mirror needs the same fix
+- Apply the same fix to both locations
+
+### Step 4 — Run Consistency Checks
+
+After all fixes are applied:
+
+```bash
+# Version consistency (if any version files were touched)
+python3 scripts/check_version_consistency.py
+
+# Quick syntax check for Python files
+python3 -m py_compile plugins/{type}/{name}/{name}.py && echo "✅ Syntax OK"
+```
+
+### Step 5 — Stage and Commit
+
+Create a new commit (do NOT amend if the branch has already been pushed, to avoid force-push):
+
+```bash
+git add -A
+git status
+```
+
+Draft a Conventional Commits message for the fixup:
+
+Format: `fix(scope): address review feedback`
+
+Body should list what was fixed, referencing reviewer concerns:
+```
+fix(github-copilot-sdk): address review feedback from @reviewer
+
+- Fix X per review comment on line Y of file Z
+- Update README to clarify auth requirement
+- Correct edge case in _parse_mcp_servers logic
+```
+
+```bash
+git commit -m "<fixup commit message>"
+```
+
+### Step 6 — Push the Fix Commit
+
+```bash
+git push origin $(git branch --show-current)
+```
+
+**Force-push policy:**
+- Use `git push` (non-force) by default
+- Only use `git push --force-with-lease` if:
+  1. The user explicitly requests it, AND
+  2. The only change is an amended commit squash (cosmetic, no logic change)
+  3. Never use `--force` (without `--lease`)
+
+### Step 7 — Respond to Reviewers
+
+For each addressed review comment, post a reply:
+
+```bash
+# Reply to inline comment
+gh api repos/Fu-Jie/openwebui-extensions/pulls/<PR-NUMBER>/comments/<COMMENT-ID>/replies \
+  -X POST -f body="Fixed in commit <SHORT-SHA>. <Brief explanation of what was changed.>"
+
+# General comment to summarize all fixes
+gh issue comment <PR-NUMBER> --body "All review feedback addressed in commit <SHORT-SHA>:
+- Fixed: <item 1>
+- Fixed: <item 2>
+Ready for re-review. 🙏"
+```
+
+### Step 8 — Re-Request Review (Optional)
+
+If the reviewer had submitted a `CHANGES_REQUESTED` review, request a new review after fixes:
+
+```bash
+PAGER=cat GH_PAGER=cat gh api repos/Fu-Jie/openwebui-extensions/pulls/<PR-NUMBER>/requested_reviewers \
+  -X POST -f reviewers[]='<reviewer-login>'
+```
+
+---
+
+## Decision Guide
+
+### When NOT to implement a suggestion immediately
+
+- **Design questions**: "Should this be a separate class?" — Present to user for decision
+- **Optional nitpicks**: Reviewer marked as `nit:` — Ask user if they want to include it
+- **Large refactors**: If fix would require changing >50 lines, propose a separate follow-up issue instead
+
+### When to ask the user before proceeding
+
+- Any fix involving behavioral changes to plugin logic
+- Renaming Valve keys (breaking change — requires migration notes)
+- Changes that affect the bilingual release notes already committed
+
+---
+
+## Anti-Patterns to Avoid
+
+- ❌ Do NOT `git commit --amend` on a pushed commit without user approval for force-push
+- ❌ Do NOT silently skip a reviewer's comment; always acknowledge it (implement or explain why not)
+- ❌ Do NOT use `--force` (only `--force-with-lease` when absolutely necessary)
+- ❌ Do NOT make unrelated changes in the fixup commit; keep scope focused on review feedback
+- ❌ Do NOT respond to reviewer comments in Chinese if the PR language context is English

.github/skills/pr-submitter/SKILL.md

@@ -0,0 +1,194 @@
+---
+name: pr-submitter
+description: Submits a feature branch as a Pull Request with a validated, properly formatted bilingual PR body. Handles shell-escape-safe body writing via temp files. Use after release-prep has committed all changes.
+---
+
+# PR Submitter
+
+## Overview
+
+This skill handles the final step of pushing a feature branch and creating a validated Pull Request on GitHub. Its primary purpose is to avoid the shell-escaping pitfalls (backticks, special characters in `gh pr create --body`) by always writing the PR body to a **temp file** first.
+
+## Prerequisites
+
+- All changes are committed (use `release-prep` skill first)
+- The `gh` CLI is authenticated (`gh auth status`)
+- Current branch is NOT `main` or `master`
+
+---
+
+## Workflow
+
+### Step 0 — Initialize Temp Directory (Project-Based)
+
+For all temporary files, use the project's `.temp/` directory instead of system `/tmp`:
+
+```bash
+# Create temp directory if it doesn't exist
+mkdir -p .temp
+```
+
+**Why**: All temporary files stay within the project workspace, avoiding system `/tmp` pollution and better aligning with OpenWebUI workspace isolation principles.
+
+### Step 1 — Pre-Flight Checks
+
+Run these checks before any push:
+
+```bash
+# 1. Confirm not on protected branch
+git branch --show-current
+
+# 2. Verify there are commits to push
+git log origin/$(git branch --show-current)..HEAD --oneline 2>/dev/null || echo "No remote tracking branch yet"
+
+# 3. Check gh CLI auth
+gh auth status
+```
+
+If any check fails, stop and report clearly.
+
+### Step 2 — Collect PR Metadata
+
+Gather:
+- **PR Title**: Must follow Conventional Commits format, English only (e.g., `feat(github-copilot-sdk): release v0.8.0 with conditional tool filtering`)
+- **Target base branch**: Default is `main`
+- **Plugin name + version** (to build body sections)
+- **Key changes** (reuse from release-prep or the latest What's New section)
+
+### Step 3 — Build PR Body File (Shell-Escape-Safe)
+
+**Always write the body to a temp file in `.temp/` directory.** Never embed multi-line markdown with special characters directly in a shell command.
+
+```bash
+cat > .temp/pr_body.md << 'HEREDOC'
+## Summary
+
+Brief one-sentence description of what this PR accomplishes.
+
+## Changes
+
+### New Features
+- Feature 1 description
+- Feature 2 description
+
+### Bug Fixes
+- Fix 1 description
+
+## Plugin Version
+- `PluginName` bumped to `vX.X.X`
+
+## Documentation
+- README.md / README_CN.md updated
+- docs/ mirrors synced
+
+## Testing
+- [ ] Tested locally in OpenWebUI
+- [ ] i18n validated (all language keys present)
+- [ ] Version consistency check passed (`python3 scripts/check_version_consistency.py`)
+
+---
+
+## 变更摘要（中文）
+
+简要描述本次 PR 的改动内容。
+
+### 新功能
+- 功能1描述
+- 功能2描述
+
+### 问题修复
+- 修复1描述
+HEREDOC
+```
+
+**Critical rules for the body file:**
+- Use `<< 'HEREDOC'` (quoted heredoc) to prevent variable expansion
+- Keep all backticks literal — they are safe inside a heredoc
+- Paths like `/api/v1/files/` are safe too since heredoc doesn't interpret them as commands
+
+### Step 4 — Validate PR Body
+
+Before submitting, verify the body file contains expected sections:
+
+```bash
+# Check key sections exist
+grep -q "## Summary" .temp/pr_body.md && echo "✅ Summary" || echo "❌ Summary missing"
+grep -q "## Changes" .temp/pr_body.md && echo "✅ Changes" || echo "❌ Changes missing"
+grep -q "## 变更摘要" .temp/pr_body.md && echo "✅ CN Section" || echo "❌ CN Section missing"
+
+# Preview the body
+cat .temp/pr_body.md
+```
+
+Ask the user to confirm the body content before proceeding.
+
+### Step 5 — Push Branch
+
+```bash
+git push -u origin $(git branch --show-current)
+```
+
+If push is rejected (non-fast-forward), report to user and ask whether to force-push. **Do NOT force-push without explicit confirmation.**
+
+### Step 6 — Create Pull Request
+
+```bash
+gh pr create \
+  --base main \
+  --head $(git branch --show-current) \
+  --title "<PR title from Step 2>" \
+  --body-file .temp/pr_body.md
+```
+
+Always use `--body-file`, never `--body` with inline markdown.
+
+### Step 7 — Verify PR Creation
+
+```bash
+PAGER=cat GH_PAGER=cat gh pr view --json number,url,title,body --jq '{number: .number, url: .url, title: .title, body_preview: .body[:200]}'
+```
+
+Confirm:
+- PR number and URL
+- Title matches intended Conventional Commits format
+- Body preview includes key sections (not truncated/corrupted)
+
+If the body appears corrupted (empty sections, missing backtick content), use edit:
+
+```bash
+gh pr edit <PR-NUMBER> --body-file /tmp/pr_body.md
+```
+
+### Step 8 — Cleanup
+
+```bash
+rm -f .temp/pr_body.md
+```
+
+**Note**: The `.temp/` directory itself is preserved for reuse; only the individual PR body file is deleted. To fully clean up: `rm -rf .temp/`
+
+Report final PR URL to the user.
+
+---
+
+## Shell-Escape Safety Rules
+
+| Risk | Safe Approach |
+|------|--------------|
+| Backticks in `--body` | Write to file, use `--body-file` |
+| Paths like `/api/...` | Safe in heredoc; risky in inline `--body` |
+| Newlines in `--body` | File-based only |
+| `$variable` expansion | Use `<< 'HEREDOC'` (quoted) |
+| Double quotes in body | Safe in heredoc file |
+| Temp file storage | Use `.temp/` dir, not `/tmp` |
+| Cleanup after use | Always delete temp file (keep dir) |
+
+---
+
+## Anti-Patterns to Avoid
+
+- ❌ Never use `--body "..."` with multi-line content directly in shell command
+- ❌ Never interpolate variables directly into heredoc without quoting the delimiter
+- ❌ Never force-push (`--force`) without explicit user confirmation
+- ❌ Never target `main` as the source branch (only as base)
+- ❌ Never skip the body validation step — a PR with empty body is worse than a delayed PR

.github/skills/release-finalizer/SKILL.md

@@ -0,0 +1,208 @@
+---
+name: release-finalizer
+description: Merges a release PR, associates it with resolved issues, replies to issue reporters, and closes issues. Use after PR review is complete and ready for merge. Closes the release cycle.
+---
+
+# Release Finalizer
+
+## Overview
+
+This skill completes the final step of the release cycle: merging the release PR to `main`, replying to all related issues with solutions, and automatically closing them using GitHub's issue linking mechanism.
+
+## Prerequisites
+
+- The PR is in `OPEN` state and ready to merge
+- All status checks have passed (CI green)
+- All review feedback has been addressed
+- The PR relates to one or more GitHub issues (either in PR description or through commits)
+
+---
+
+## Workflow
+
+### Step 1 — Pre-Merge Verification
+
+Verify that the PR is ready:
+
+```bash
+PAGER=cat GH_PAGER=cat gh pr view <PR-NUMBER> --json state,statusCheckRollup,reviewDecision
+```
+
+Checklist:
+- ✅ `state` is `OPEN`
+- ✅ `statusCheckRollup` all have `conclusion: SUCCESS`
+- ✅ `reviewDecision` is `APPROVED` or empty (no blocking reviews)
+
+If any check fails, **do NOT merge**. Report the issue to the user.
+
+### Step 2 — Identify Related Issues
+
+Issues can be linked to a PR in multiple ways. Check the PR description and commit messages for keywords:
+
+```bash
+PAGER=cat GH_PAGER=cat gh pr view <PR-NUMBER> --json body,commits
+```
+
+Look for patterns like:
+- `Closes #XX`, `Fixes #XX`, `Resolves #XX` (in description or commit bodies)
+- `#XX` mentioned as "related to" or "addresses"
+
+**Manual input**: If issue links are not in the PR, ask the user which issue(s) this PR resolves.
+
+Extract all issue numbers into a list: `[#48, #52, ...]`
+
+### Step 3 — Select Merge Strategy
+
+Offer the user three options:
+
+| Strategy | Git Behavior | Use Case |
+|----------|-------------|----------|
+| **Squash** | All commits squashed into one commit on main | Clean history, recommended for release PRs |
+| **Rebase** | Linear history, no merge commit | Preserve commit granularity |
+| **Merge** | Merge commit created | Preserve full PR context |
+
+**Recommendation for release PRs**: Use `--squash` to create a single clean commit.
+
+If user doesn't specify, default to `--squash`.
+
+### Step 4 — Prepare Merge Commit Message
+
+If using `--squash`, craft a single comprehensive commit message:
+
+**Format** (Conventional Commits + Github linking):
+```
+type(scope): description
+
+- Bullet point 1
+- Bullet point 2
+
+Closes #48
+Closes #52
+```
+
+The `Closes #XX` keyword tells GitHub to automatically close those issues when the commit lands on `main`.
+
+Example:
+```
+feat(pipes,filters): release Copilot SDK Pipe v0.8.0 and Files Filter v0.1.3
+
+- Implement P1~P4 conditional tool filtering system
+- Fix file publishing reliability across all storage backends
+- Add strict file URL validation
+- Update bilingual documentation
+
+Closes #48
+```
+
+### Step 5 — Execute Merge
+
+```bash
+gh pr merge <PR-NUMBER> \
+  --squash \
+  --delete-branch \
+  -m "type(scope): description" \
+  -b "- Bullet 1\n- Bullet 2\n\nCloses #48"
+```
+
+**Key flags:**
+- `--squash`: Squash commits (recommended for releases)
+- `--delete-branch`: Delete the feature branch after merge
+- `-m`: Commit subject
+- `-b`: Commit body (supports `\n` for newlines)
+
+Confirm the merge is successful; GitHub will automatically close related issues with `Closes #XX` keyword.
+
+### Step 6 — Verify Auto-Close
+
+GitHub automatically closes issues when a commit with `Closes #XX` lands on the default branch (`main`).
+
+To verify:
+```bash
+PAGER=cat GH_PAGER=cat gh issue view <ISSUE-NUMBER> --json state
+```
+
+Should show `state: CLOSED`.
+
+### Step 7 — Post Closing Message (Optional but Recommended)
+
+For better UX, manually post a summary comment to **each issue** before it auto-closes (since auto-close happens silently):
+
+```bash
+gh issue comment <ISSUE-NUMBER> --body "
+This has been fixed in PR #<PR-NUMBER>, which is now merged to main.
+
+**Solution Summary:**
+- <Key fix 1>
+- <Key fix 2>
+
+The fix will be available in the next plugin release. Thank you for reporting! ⭐
+"
+```
+
+### Step 8 — (Optional) Regenerate Release Notes
+
+If the merge revealed any final tweaks to release notes:
+
+```bash
+# Re-export release notes from merged commit
+git log --oneline -1 <merged-commit-sha>
+```
+
+If needed, create a follow-up PR with doc polish (do NOT force-push the merged commit).
+
+---
+
+## Merge Strategy Decision Tree
+
+```
+Is this a patch/hotfix release?
+├─ YES → Use --squash
+└─ NO → Multi-feature release?
+     ├─ YES → Use --squash (cleaner history)
+     └─ NO → Preserve detail? 
+          ├─ YES → Use --rebase
+          └─ NO → Use --merge (preserve PR context)
+```
+
+---
+
+## Issue Auto-Close Keywords
+
+These keywords in commit/PR messages will auto-close issues when merged to `main`:
+
+- `Closes #XX`
+- `Fixes #XX`
+- `Resolves #XX`
+- `close #XX` (case-insensitive)
+- `fix #XX`
+- `resolve #XX`
+
+**Important**: The keyword must be on the **final commit that lands on** `main`. For squash merges, it must be in the squash commit message body.
+
+---
+
+## Anti-Patterns to Avoid
+
+- ❌ Do NOT merge if any status checks are PENDING or FAILED
+- ❌ Do NOT merge if there are blocking reviews (reviewDecision: `CHANGES_REQUESTED`)
+- ❌ Do NOT merge without verifying the Conventional Commits format in the merge message
+- ❌ Do NOT merge without including `Closes #XX` keywords for all related issues
+- ❌ Do NOT assume issues will auto-close silently — post a courtesy comment first
+- ❌ Do NOT delete the branch if it might be needed for cherry-pick or hotfixes later
+
+---
+
+## Troubleshooting
+
+### Issue did not auto-close after merge
+- Verify the `Closes #XX` keyword is in the **final commit message** (use `git log` to check)
+- Ensure the commit is on the `main` branch
+- GitHub sometimes takes a few seconds to process; refresh the issue page
+
+### Multiple issues to close
+- List all in separate `Closes #XX` lines in the commit body
+- Each one will be independently auto-closed
+
+### Want to close issue without merge?
+- Use `gh issue close <ISSUE-NUMBER>` manually
+- Only recommended if the PR was manually reverted or deemed invalid

.github/skills/release-prep/SKILL.md

@@ -0,0 +1,157 @@
+---
+name: release-prep
+description: Orchestrates the full release preparation flow for a plugin — version sync across 7+ files, bilingual release notes creation, and commit message drafting. Use before submitting a PR. Does NOT push or create a PR; that is handled by pr-submitter.
+---
+
+# Release Prep
+
+## Overview
+
+This skill drives the complete pre-PR release pipeline. It enforces the repository rule that every release must synchronize the version number and changelog across **at least 7 locations** before a commit is created.
+
+## Scope
+
+This skill covers:
+1. Version sync (delegates detail to `version-bumper` if needed)
+2. Bilingual release notes file creation
+3. 7-location consistency verification
+4. Conventional Commits message drafting
+5. `git add -A && git commit` execution
+
+It **stops before** `git push` or `gh pr create`. Use the `pr-submitter` skill for those steps.
+
+### Temporary File Convention
+
+Any temporary files created during release prep (e.g., draft changelogs) must:
+- Be written to the project's `.temp/` directory, **NOT** system `/tmp`
+- Be cleaned up before commit using `rm -f .temp/file_name`
+- Never be committed to git (add `.temp/` to `.gitignore`)
+
+---
+
+## Workflow
+
+### Step 1 — Collect Release Info
+
+Ask the user (or infer from current state) the following:
+- **Plugin name** and **type** (actions / filters / pipes / tools)
+- **New version number** (e.g., `0.8.0`)
+- **Key changes** in English and Chinese (1-5 bullet points each)
+
+If a `What's New` section already exists in README.md, extract it as the source of truth.
+
+### Step 2 — Sync Version Across 7 Locations
+
+Verify AND update the version string in all of the following. Mark each as ✅ or ❌:
+
+| # | File | Location |
+|---|------|----------|
+| 1 | `plugins/{type}/{name}/{name}.py` | `version:` in docstring |
+| 2 | `plugins/{type}/{name}/README.md` | `**Version:** x.x.x` metadata line |
+| 3 | `plugins/{type}/{name}/README_CN.md` | `**Version:** x.x.x` metadata line |
+| 4 | `docs/plugins/{type}/{name}.md` | `**Version:** x.x.x` metadata line |
+| 5 | `docs/plugins/{type}/{name}.zh.md` | `**Version:** x.x.x` metadata line |
+| 6 | `docs/plugins/{type}/index.md` | version badge for this plugin |
+| 7 | `docs/plugins/{type}/index.zh.md` | version badge for this plugin |
+
+Additionally update the root-level **updated date badge** in:
+- `README.md` — `![updated](https://img.shields.io/badge/YYYY--MM--DD-gray?style=flat)`
+- `README_CN.md` — same badge format
+
+Use today's date (`YYYY-MM-DD`) for the badge.
+
+### Step 3 — Update What's New (All 4 Doc Files)
+
+The `What's New` / `最新更新` section must contain **only the most recent release's changes**. Previous entries should be removed from this section (they live in CHANGELOG or release notes files).
+
+Update these 4 files' `What's New` / `最新更新` block consistently:
+- `plugins/{type}/{name}/README.md`
+- `plugins/{type}/{name}/README_CN.md`
+- `docs/plugins/{type}/{name}.md`
+- `docs/plugins/{type}/{name}.zh.md`
+
+### Step 4 — Create Bilingual Release Notes Files
+
+Create two versioned release notes files:
+
+**Path**: `plugins/{type}/{name}/v{version}.md`
+**Path**: `plugins/{type}/{name}/v{version}_CN.md`
+
+#### Required Sections
+
+Each file must include:
+1. **Title**: `# v{version} Release Notes` (EN) / `# v{version} 版本发布说明` (CN)
+2. **Overview**: One paragraph summarizing this release
+3. **New Features** / **新功能**: Bulleted list of features
+4. **Bug Fixes** / **问题修复**: Bulleted list of fixes
+5. **Migration Notes** / **迁移说明**: Breaking changes or Valve key renames (omit section if none)
+6. **Companion Plugins** / **配套插件** (optional): If a companion plugin was updated
+
+If a release notes file already exists for this version, update it rather than creating a new one.
+
+#### Full Coverage Rule (Mandatory)
+
+Release notes must cover **all updates in the current release scope** and not only headline features.
+
+Minimum required coverage in both EN/CN files:
+- New features and capability enhancements
+- Bug fixes and reliability fixes
+- Documentation/README/doc-mirror updates that affect user understanding or usage
+- Terminology/i18n/wording fixes that change visible behavior or messaging
+
+Before commit, cross-check release notes against `git diff` and ensure no meaningful update is omitted.
+
+### Step 5 — Verify Consistency (Pre-Commit Check)
+
+Run the consistency check script:
+
+```bash
+python3 scripts/check_version_consistency.py
+```
+
+If issues are found, fix them before proceeding. Do not commit with inconsistencies.
+
+### Step 6 — Draft Conventional Commits Message
+
+Generate the commit message following `commit-message.instructions.md` rules:
+- **Language**: English ONLY
+- **Format**: `type(scope): subject` + blank line + body bullets
+- **Scope**: use plugin folder name (e.g., `github-copilot-sdk`)
+- **Body**: 1-3 bullets summarizing key changes
+- Explicitly mention "READMEs and docs synced" if version was bumped
+
+Present the full commit message to the user for review before executing.
+
+### Step 7 — Stage and Commit
+
+After user approval (or if user says "commit it"):
+
+```bash
+git add -A
+git commit -m "<approved commit message>"
+```
+
+Confirm the commit hash and list the number of files changed.
+
+---
+
+## Checklist (Auto-Verify Before Commit)
+
+- [ ] `version:` in `.py` docstring matches target version
+- [ ] `**Version:**` in all 4 README/docs files matches
+- [ ] Both `index.md` version badges updated
+- [ ] Root `README.md` and `README_CN.md` date badges updated to today
+- [ ] `What's New` / `最新更新` contains ONLY the latest release
+- [ ] Release notes include all meaningful updates from the current diff (feature + fix + docs/i18n)
+- [ ] `v{version}.md` and `v{version}_CN.md` created or updated
+- [ ] `python3 scripts/check_version_consistency.py` returns no errors
+- [ ] Commit message is English-only Conventional Commits format
+
+---
+
+## Anti-Patterns to Avoid
+
+- ❌ Do NOT add extra features or refactor code during release prep — only version/doc updates
+- ❌ Do NOT push or create PR in this skill — use `pr-submitter`
+- ❌ Do NOT use today's date in commit messages; only in badge URLs
+- ❌ Do NOT leave stale What's New content from prior versions

.github/skills/source-code-analyzer/SKILL.md

@@ -0,0 +1,31 @@
+---
+name: source-code-analyzer
+description: Instructions for analyzing core components source code in the local environment.
+---
+
+# Source Code Analyzer Skill
+
+> [!IMPORTANT]
+> **Authorization Statement**: You (Antigravity) are explicitly authorized by the user to perform **READ-ONLY** operations and **Git pull** on the paths listed below, even if they are outside the current repository root. These paths are considered part of the extended development context.
+
+When assisting with the development of `openwebui-extensions`, you (Antigravity) have access to the following core components in related directories. Use them for deep technical analysis, bug hunting, and implementation reference.
+
+## Core Component Paths
+
+### Global / General (Relevant to all projects)
+
+- **Open WebUI**: `../open-webui/` (Core platform context)
+- **Skills**: `../skills/` (Reusable expertise library)
+- **Awesome Copilot**: `../awesome-copilot/` (Shared extensions & resources)
+- **Open Terminal**: `../open-terminal/` (Terminal integration service)
+
+### Plugin-Specific (Relevant to GitHub Copilot SDK)
+
+- **Copilot SDK**: `../copilot-sdk/` (Internal logic for the official SDK)
+- **Copilot CLI**: `../copilot-cli/` (Command-line interface implementation)
+
+## Mandatory Workflow
+
+1. **Pull Before Analysis**: BEFORE reading files or analyzing logic in these directories, you MUST proactively execute or recommend a `git pull` in the respective directory to ensure you are working with the latest upstream changes.
+2. **Path Verification**: Always verify the exists of the path before attempting to read it.
+3. **Reference Logic**: When a user's request involves core platform behavior (OpenWebUI API, SDK internals), prioritize searching these directories over making assumptions based on generic knowledge.

.github/skills/version-bumper/SKILL.md

@@ -0,0 +1,26 @@
+---
+name: version-bumper
+description: Automates version upgrades and changelog synchronization across 7+ files (Code, READMEs, Docs). Use when a plugin is ready for release to ensure version consistency.
+---
+
+# Version Bumper
+
+## Overview
+This skill ensures that every version upgrade is synchronized across the entire repository, following the strict "Documentation Sync" rule in GEMINI.md.
+
+## Workflow
+1. **Prepare Info**: Gather the new version number and brief changelogs in both English and Chinese.
+2. **Auto-Patch**: The skill will help you identify and update:
+   - `plugins/.../name.py` (docstring version)
+   - `plugins/.../README.md` (metadata & What's New)
+   - `plugins/.../README_CN.md` (metadata & 最新更新)
+   - `docs/plugins/...md` (mirrors)
+   - `docs/plugins/index.md` (version badge)
+   - `README.md` (updated date badge)
+3. **Verify**: Check the diffs to ensure no formatting was broken.
+
+## Tool Integration
+Execute the bump script (draft):
+```bash
+python3 scripts/bump.py <version> "<message_en>" "<message_zh>"
+```

.github/skills/version-bumper/scripts/bump.py

@@ -0,0 +1,70 @@
+#!/usr/bin/env python3
+import sys
+import os
+import re
+from datetime import datetime
+
+def patch_file(file_path, old_pattern, new_content, is_regex=False):
+    if not os.path.exists(file_path):
+        print(f"Warning: File not found: {file_path}")
+        return False
+    
+    with open(file_path, 'r', encoding='utf-8') as f:
+        content = f.read()
+    
+    if is_regex:
+        new_content_result = re.sub(old_pattern, new_content, content, flags=re.MULTILINE)
+    else:
+        new_content_result = content.replace(old_pattern, new_content)
+    
+    if new_content_result != content:
+        with open(file_path, 'w', encoding='utf-8') as f:
+            f.write(new_content_result)
+        print(f"✅ Patched: {file_path}")
+        return True
+    else:
+        print(f"ℹ️ No change needed: {file_path}")
+        return False
+
+def bump_version(plugin_type, plugin_name, new_version, msg_en, msg_zh):
+    print(f"🚀 Bumping {plugin_name} ({plugin_type}) to {new_version}...")
+    
+    today = datetime.now().strftime("%Y-%m-%d")
+    today_badge = today.replace("-", "--")
+    
+    # 1. Patch Plugin Python File
+    py_file = f"plugins/{plugin_type}/{plugin_name}/{plugin_name}.py"
+    patch_file(py_file, r"version: \d+\.\d+\.\d+", f"version: {new_version}", is_regex=True)
+    
+    # 2. Patch Plugin READMEs
+    readme_en = f"plugins/{plugin_type}/{plugin_name}/README.md"
+    readme_zh = f"plugins/{plugin_type}/{plugin_name}/README_CN.md"
+    
+    # Update version in metadata
+    patch_file(readme_en, r"\*\*Version:\*\* \d+\.\d+\.\d+", f"**Version:** {new_version}", is_regex=True)
+    patch_file(readme_zh, r"\*\*版本:\*\* \d+\.\d+\.\d+", f"**版本:** {new_version}", is_regex=True)
+    
+    # Update What's New (Assuming standard headers)
+    patch_file(readme_en, r"## 🔥 What's New in v.*?\n", f"## 🔥 What's New in v{new_version}\n\n* {msg_en}\n", is_regex=True)
+    patch_file(readme_zh, r"## 🔥 最新更新 v.*?\n", f"## 🔥 最新更新 v{new_version}\n\n* {msg_zh}\n", is_regex=True)
+    
+    # 3. Patch Docs Mirrors
+    doc_en = f"docs/plugins/{plugin_type}/{plugin_name}.md"
+    doc_zh = f"docs/plugins/{plugin_type}/{plugin_name}.zh.md"
+    patch_file(doc_en, r"\*\*Version:\*\* \d+\.\d+\.\d+", f"**Version:** {new_version}", is_regex=True)
+    patch_file(doc_zh, r"\*\*版本:\*\* \d+\.\d+\.\d+", f"**版本:** {new_version}", is_regex=True)
+    
+    # 4. Patch Root READMEs (Updated Date Badge)
+    patch_file("README.md", r"badge/202\d--\d\d--\d\d-gray", f"badge/{today_badge}-gray", is_regex=True)
+    patch_file("README_CN.md", r"badge/202\d--\d\d--\d\d-gray", f"badge/{today_badge}-gray", is_regex=True)
+
+    print("\n✨ All synchronization tasks completed.")
+    return True
+
+if __name__ == "__main__":
+    if len(sys.argv) < 6:
+        print("Usage: bump.py <type> <name> <version> <msg_en> <msg_zh>")
+        print("Example: bump.py filters markdown_normalizer 1.2.8 'Fix bug' '修复错误'")
+        sys.exit(1)
+    
+    bump_version(sys.argv[1], sys.argv[2], sys.argv[3], sys.argv[4], sys.argv[5])

.github/workflows/community-stats.yml

@@ -0,0 +1,91 @@
+# OpenWebUI 社区统计报告自动生成
+# 智能检测：只在有意义的变更时才 commit
+# - 新增插件 (total_posts)
+# - 插件版本变更 (version)
+# - 积分增加 (total_points)
+# - 粉丝增加 (followers)
+
+name: Community Stats
+
+on:
+  schedule:
+    - cron: '0 * * * *'
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+jobs:
+  update-stats:
+    runs-on: ubuntu-latest
+    
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+      
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+      
+      - name: Install dependencies
+        run: |
+          pip install requests python-dotenv
+
+      - name: Capture existing stats (before update)
+        id: old_stats
+        run: |
+          if [ -f docs/community-stats.json ]; then
+            echo "total_posts=$(jq -r '.total_posts // 0' docs/community-stats.json)" >> $GITHUB_OUTPUT
+          else
+            echo "total_posts=0" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Generate stats report
+        env:
+          OPENWEBUI_API_KEY: ${{ secrets.OPENWEBUI_API_KEY }}
+          OPENWEBUI_USER_ID: ${{ secrets.OPENWEBUI_USER_ID }}
+          GIST_TOKEN: ${{ secrets.GIST_TOKEN }}
+          GIST_ID: ${{ secrets.GIST_ID }}
+        run: |
+          python scripts/openwebui_stats.py
+
+      - name: Capture new stats (after update)
+        id: new_stats
+        run: |
+          echo "total_posts=$(jq -r '.total_posts // 0' docs/community-stats.json)" >> $GITHUB_OUTPUT
+
+      - name: Check for significant changes
+        id: check_changes
+        run: |
+          OLD_POSTS="${{ steps.old_stats.outputs.total_posts }}"
+          NEW_POSTS="${{ steps.new_stats.outputs.total_posts }}"
+          
+          SHOULD_COMMIT="false"
+          CHANGE_REASON=""
+          
+          if [ "$NEW_POSTS" -gt "$OLD_POSTS" ]; then
+            SHOULD_COMMIT="true"
+            CHANGE_REASON="new plugin added ($OLD_POSTS -> $NEW_POSTS)"
+            echo "📦 New plugin detected: $OLD_POSTS -> $NEW_POSTS"
+          fi
+          
+          echo "should_commit=$SHOULD_COMMIT" >> $GITHUB_OUTPUT
+          echo "change_reason=$CHANGE_REASON" >> $GITHUB_OUTPUT
+          
+          if [ "$SHOULD_COMMIT" = "false" ]; then
+            echo "ℹ️ No significant changes detected, skipping commit"
+          else
+            echo "✅ Significant changes detected: $CHANGE_REASON"
+          fi
+
+      - name: Commit and push changes
+        if: steps.check_changes.outputs.should_commit == 'true'
+        run: |
+          git config --local user.email "github-actions[bot]@users.noreply.github.com"
+          git config --local user.name "github-actions[bot]"
+          git add docs/ README.md README_CN.md
+          git diff --staged --quiet || git commit -m "chore: update community stats - ${{ steps.check_changes.outputs.change_reason }}"
+          git push

.github/workflows/publish_new_plugin.yml

@@ -0,0 +1,68 @@
+name: Publish New Plugin
+
+on:
+  workflow_dispatch:
+    inputs:
+      plugin_dir:
+        description: 'Plugin directory (e.g., plugins/actions/deep-dive)'
+        required: true
+        type: string
+      dry_run:
+        description: 'Dry run mode (preview only)'
+        required: false
+        type: boolean
+        default: false
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.x'
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install requests
+
+      - name: Validate plugin directory
+        run: |
+          if [ ! -d "${{ github.event.inputs.plugin_dir }}" ]; then
+            echo "❌ Error: Directory '${{ github.event.inputs.plugin_dir }}' does not exist"
+            exit 1
+          fi
+          echo "✅ Found plugin directory: ${{ github.event.inputs.plugin_dir }}"
+          ls -la "${{ github.event.inputs.plugin_dir }}"
+
+      - name: Publish Plugin
+        env:
+          OPENWEBUI_API_KEY: ${{ secrets.OPENWEBUI_API_KEY }}
+        run: |
+          if [ "${{ github.event.inputs.dry_run }}" = "true" ]; then
+            echo "🔍 Dry run mode - previewing..."
+            python scripts/publish_plugin.py --new "${{ github.event.inputs.plugin_dir }}" --dry-run
+          else
+            echo "🚀 Publishing plugin..."
+            python scripts/publish_plugin.py --new "${{ github.event.inputs.plugin_dir }}"
+          fi
+
+      - name: Commit changes (if ID was added)
+        if: ${{ github.event.inputs.dry_run != 'true' }}
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          
+          # Check if there are changes to commit
+          if git diff --quiet; then
+            echo "No changes to commit"
+          else
+            git add "${{ github.event.inputs.plugin_dir }}"
+            git commit -m "feat: add openwebui_id to ${{ github.event.inputs.plugin_dir }}"
+            git push
+            echo "✅ Committed and pushed openwebui_id changes"
+          fi

.github/workflows/publish_plugin.yml

@@ -0,0 +1,34 @@
+name: Publish Plugins to OpenWebUI Market
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'plugins/**/*.py'
+      - '!plugins/debug/**'
+  release:
+    types: [published]
+  workflow_dispatch:
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.x'
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install requests
+
+      - name: Publish Plugins
+        env:
+          OPENWEBUI_API_KEY: ${{ secrets.OPENWEBUI_API_KEY }}
+        run: python scripts/publish_plugin.py

.github/workflows/release.yml

@@ -1,8 +1,6 @@
-# GitHub Actions Workflow for Plugin Release
+# Plugin Release Workflow
-# 插件发布工作流
 #
 # This workflow automates the release process for OpenWebUI plugins.
-# 此工作流自动化 OpenWebUI 插件的发布流程。
 #
 # Triggers:
 # - Push to main branch when plugins are modified (auto-release)
@@ -15,7 +13,7 @@
 # 3. Creates a GitHub Release with plugin files as downloadable assets
 # 4. Supports multiple plugin updates in a single release
 
-name: Plugin Release / 插件发布
+name: Plugin Release
 
 on:
   # Auto-trigger on push to main when plugins are modified
@@ -24,6 +22,11 @@ on:
       - main
     paths:
       - 'plugins/**/*.py'
+      - 'plugins/**/README.md'
+      - 'plugins/**/README_CN.md'
+      - 'plugins/**/v*.md'
+      - 'plugins/**/v*_CN.md'
+      - 'docs/plugins/**/*.md'
     tags:
       - 'v*'
 
@@ -54,6 +57,8 @@ permissions:
 jobs:
   check-changes:
     runs-on: ubuntu-latest
+    # Skip release if commit message contains [skip release]
+    if: ${{ !contains(github.event.head_commit.message, '[skip release]') }}
     env:
       LANG: en_US.UTF-8
       LC_ALL: en_US.UTF-8
@@ -61,6 +66,8 @@ jobs:
       has_changes: ${{ steps.detect.outputs.has_changes }}
       changed_plugins: ${{ steps.detect.outputs.changed_plugins }}
       release_notes: ${{ steps.detect.outputs.release_notes }}
+      has_doc_changes: ${{ steps.detect.outputs.has_doc_changes }}
+      changed_doc_files: ${{ steps.detect.outputs.changed_doc_files }}
     
     steps:
       - name: Checkout repository
@@ -97,17 +104,19 @@ jobs:
           python scripts/extract_plugin_versions.py --json --output current_versions.json
           
           # Get previous plugin versions by checking out old plugins
-          if git worktree add /tmp/old_repo ${COMPARE_REF} 2>/dev/null; then
+          OLD_WORKTREE=$(mktemp -d)
-            if [ -d /tmp/old_repo/plugins ]; then
+          if git worktree add "$OLD_WORKTREE" ${COMPARE_REF} 2>/dev/null; then
-              python scripts/extract_plugin_versions.py --plugins-dir /tmp/old_repo/plugins --json --output old_versions.json
+            if [ -d "$OLD_WORKTREE/plugins" ]; then
+              python scripts/extract_plugin_versions.py --plugins-dir "$OLD_WORKTREE/plugins" --json --output old_versions.json
             else
               echo "[]" > old_versions.json
             fi
-            git worktree remove /tmp/old_repo 2>/dev/null || true
+            git worktree remove "$OLD_WORKTREE" 2>/dev/null || true
           else
             echo "Failed to create worktree, using empty version list"
             echo "[]" > old_versions.json
           fi
+          rm -rf "$OLD_WORKTREE" 2>/dev/null || true
           
           # Compare versions and generate release notes
           python scripts/extract_plugin_versions.py --compare old_versions.json --ignore-removed --output changes.md
@@ -115,9 +124,29 @@ jobs:
           
           echo "=== Version Changes ==="
           cat changes.md
+
+          # Detect documentation/release-note changes that should be reflected in release notes
+          git diff --name-only "$COMPARE_REF"..HEAD -- \
+            'plugins/**/README.md' \
+            'plugins/**/README_CN.md' \
+            'plugins/**/v*.md' \
+            'plugins/**/v*_CN.md' \
+            'docs/plugins/**/*.md' > changed_docs.txt || true
+
+          if [ -s changed_docs.txt ]; then
+            echo "has_doc_changes=true" >> $GITHUB_OUTPUT
+            echo "changed_doc_files<<EOF" >> $GITHUB_OUTPUT
+            cat changed_docs.txt >> $GITHUB_OUTPUT
+            echo "" >> $GITHUB_OUTPUT
+            echo "EOF" >> $GITHUB_OUTPUT
+          else
+            echo "has_doc_changes=false" >> $GITHUB_OUTPUT
+            echo "changed_doc_files=" >> $GITHUB_OUTPUT
+          fi
           
           # Check if there are any changes
           if grep -q "No changes detected" changes.md; then
+            # Only trigger release if there are actual version changes, not just doc changes
             echo "has_changes=false" >> $GITHUB_OUTPUT
             echo "changed_plugins=" >> $GITHUB_OUTPUT
           else
@@ -180,14 +209,34 @@ jobs:
 
       - name: Determine version
         id: version
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         run: |
           if [ "${{ github.event_name }}" = "workflow_dispatch" ] && [ -n "${{ github.event.inputs.version }}" ]; then
             VERSION="${{ github.event.inputs.version }}"
           elif [[ "${{ github.ref }}" == refs/tags/v* ]]; then
             VERSION="${GITHUB_REF#refs/tags/}"
           else
-            # Auto-generate version based on date and run number
+            # Auto-generate version based on date and daily release count
-            VERSION="v$(date +'%Y.%m.%d')-${{ github.run_number }}"
+            TODAY=$(date +'%Y.%m.%d')
+            TODAY_PREFIX="v${TODAY}-"
+            
+            # Count existing releases with today's date prefix
+            # grep -c returns 1 if count is 0, so we use || true to avoid script failure
+            EXISTING_COUNT=$(gh release list --limit 100 2>/dev/null | grep -c "^${TODAY_PREFIX}" || true)
+            
+            # Clean up output (handle potential newlines or fallback issues)
+            EXISTING_COUNT=$(echo "$EXISTING_COUNT" | tr -cd '0-9')
+            if [ -z "$EXISTING_COUNT" ]; then EXISTING_COUNT=0; fi
+            
+            NEXT_NUM=$((EXISTING_COUNT + 1))
+            
+            VERSION="${TODAY_PREFIX}${NEXT_NUM}"
+            
+            # Final fallback to ensure VERSION is never empty
+            if [ -z "$VERSION" ]; then
+              VERSION="v$(date +'%Y.%m.%d-%H%M%S')"
+            fi
           fi
           echo "version=$VERSION" >> $GITHUB_OUTPUT
           echo "Release version: $VERSION"
@@ -196,7 +245,6 @@ jobs:
         id: plugins
         run: |
           python scripts/extract_plugin_versions.py --json --output plugin_versions.json
-          python scripts/extract_plugin_versions.py --json --output plugin_versions.json
 
       - name: Collect plugin files for release
         id: collect_files
@@ -226,6 +274,52 @@ jobs:
           echo "=== Collected Files ==="
           find release_plugins -name "*.py" -type f | head -20
 
+      - name: Update plugin icon URLs
+        run: |
+          echo "Updating icon_url in plugins to use absolute GitHub URLs..."
+          # Base URL for raw content using the release tag
+          REPO_URL="https://raw.githubusercontent.com/${{ github.repository }}/${{ steps.version.outputs.version }}"
+          
+          find release_plugins -name "*.py" | while read -r file; do
+            # $file is like release_plugins/plugins/actions/infographic/infographic.py
+            # Remove release_plugins/ prefix to get the path in the repo
+            src_file="${file#release_plugins/}"
+            src_dir=$(dirname "$src_file")
+            base_name=$(basename "$src_file" .py)
+            
+            # Check if a corresponding png exists in the source repository
+            png_file="${src_dir}/${base_name}.png"
+            
+            if [ -f "$png_file" ]; then
+              echo "Found icon for $src_file: $png_file"
+              TARGET_ICON_URL="${REPO_URL}/${png_file}"
+              
+              # Use python for safe replacement
+              python3 -c "
+          import sys
+          import re
+          
+          file_path = '$file'
+          icon_url = '$TARGET_ICON_URL'
+          
+          try:
+              with open(file_path, 'r', encoding='utf-8') as f:
+                  content = f.read()
+              
+              # Replace icon_url: ... with new url
+              # Matches 'icon_url: ...' and replaces it
+              new_content = re.sub(r'^icon_url:.*$', f'icon_url: {icon_url}', content, flags=re.MULTILINE)
+              
+              with open(file_path, 'w', encoding='utf-8') as f:
+                  f.write(new_content)
+              print(f'Successfully updated icon_url in {file_path}')
+          except Exception as e:
+              print(f'Error updating {file_path}: {e}', file=sys.stderr)
+              sys.exit(1)
+          "
+            fi
+          done
+
       - name: Debug Filenames
         run: |
           python3 -c "import sys; print(f'Filesystem encoding: {sys.getfilesystemencoding()}')"
@@ -244,9 +338,9 @@ jobs:
           LAST_TAG=$(git describe --tags --abbrev=0 2>/dev/null || echo "")
           
           if [ -n "$LAST_TAG" ]; then
-            COMMITS=$(git log ${LAST_TAG}..HEAD --pretty=format:"- %s" --no-merges -- plugins/ | head -20)
+            COMMITS=$(git log ${LAST_TAG}..HEAD --pretty=format:"- **%s**%n%b" --no-merges -- plugins/ | sed '/^$/d' | head -40)
           else
-            COMMITS=$(git log --pretty=format:"- %s" --no-merges -10 -- plugins/)
+            COMMITS=$(git log --pretty=format:"- **%s**%n%b" --no-merges -10 -- plugins/ | sed '/^$/d')
           fi
           
           {
@@ -258,51 +352,70 @@ jobs:
 
       - name: Generate release notes
         id: notes
+        env:
+          VERSION: ${{ steps.version.outputs.version }}
+          TITLE: ${{ github.event.inputs.release_title }}
+          NOTES: ${{ github.event.inputs.release_notes }}
+          DETECTED_CHANGES: ${{ needs.check-changes.outputs.release_notes }}
+          COMMITS: ${{ steps.commits.outputs.commits }}
+          DOC_FILES: ${{ needs.check-changes.outputs.changed_doc_files }}
         run: |
-          VERSION="${{ steps.version.outputs.version }}"
+          > release_notes.md
-          TITLE="${{ github.event.inputs.release_title }}"
+
-          NOTES="${{ github.event.inputs.release_notes }}"
+          # 1. Release notes from v*.md files (highest priority, shown first)
-          DETECTED_CHANGES="${{ needs.check-changes.outputs.release_notes }}"
+          if [ -n "$DOC_FILES" ]; then
-          COMMITS="${{ steps.commits.outputs.commits }}"
+            RELEASE_NOTE_FILES=$(echo "$DOC_FILES" | grep -E '^plugins/.*/v[^/]*\.md$' | grep -v '_CN\.md$' || true)
-          
+            if [ -n "$RELEASE_NOTE_FILES" ]; then
-          echo "# ${VERSION} Release / 发布" > release_notes.md
+              while IFS= read -r file; do
-          echo "" >> release_notes.md
+                [ -z "$file" ] && continue
-          
+                if [ -f "$file" ]; then
+                  # Inject plugin README link before each release note file content
+                  plugin_dir=$(dirname "$file")
+                  readme_url="https://github.com/Fu-Jie/openwebui-extensions/blob/main/${plugin_dir}/README.md"
+                  echo "> 📖 [Plugin README](${readme_url})" >> release_notes.md
+                  echo "" >> release_notes.md
+                  cat "$file" >> release_notes.md
+                  echo "" >> release_notes.md
+                fi
+              done <<< "$RELEASE_NOTE_FILES"
+            fi
+          fi
+
+          # 2. Plugin version changes detected by script
           if [ -n "$TITLE" ]; then
             echo "## $TITLE" >> release_notes.md
             echo "" >> release_notes.md
           fi
           
           if [ -n "$DETECTED_CHANGES" ] && ! echo "$DETECTED_CHANGES" | grep -q "No changes detected"; then
-            echo "## What's Changed / 更新内容" >> release_notes.md
+            echo "## What's Changed" >> release_notes.md
             echo "" >> release_notes.md
             echo "$DETECTED_CHANGES" >> release_notes.md
             echo "" >> release_notes.md
           fi
           
+          # 3. Commits (Conventional Commits format with body)
           if [ -n "$COMMITS" ]; then
-            echo "## Commits / 提交记录" >> release_notes.md
+            echo "## Commits" >> release_notes.md
             echo "" >> release_notes.md
             echo "$COMMITS" >> release_notes.md
             echo "" >> release_notes.md
           fi
           
           if [ -n "$NOTES" ]; then
-            echo "## Additional Notes / 附加说明" >> release_notes.md
+            echo "## Additional Notes" >> release_notes.md
             echo "" >> release_notes.md
             echo "$NOTES" >> release_notes.md
             echo "" >> release_notes.md
           fi
           
-
-          
           cat >> release_notes.md << 'EOF'
           
-          ## Download / 下载
+          ## Download
           
-          📦 **Download the updated plugin files below** / 请在下方下载更新的插件文件
+          📦 **Download the updated plugin files below**
           
-          ### Installation / 安装
+          ### Installation
           
           #### From OpenWebUI Community
           1. Open OpenWebUI Admin Panel
@@ -310,7 +423,7 @@ jobs:
           3. Search for the plugin name
           4. Click Install
           
-          #### Manual Installation / 手动安装
+          #### Manual Installation
           1. Download the plugin file (`.py`) from the assets below
           2. Open OpenWebUI Admin Panel → Functions
           3. Click "Create Function" → Import
@@ -318,20 +431,42 @@ jobs:
           
           ---
           
-          📚 [Documentation / 文档](https://fu-jie.github.io/awesome-openwebui/)
+          📚 [Documentation](https://fu-jie.github.io/openwebui-extensions/)
-          🐛 [Report Issues / 报告问题](https://github.com/Fu-Jie/awesome-openwebui/issues)
+          🐛 [Report Issues](https://github.com/Fu-Jie/openwebui-extensions/issues)
           EOF
           
           echo "=== Release Notes ==="
           cat release_notes.md
 
+      - name: Create Git Tag
+        if: ${{ !startsWith(github.ref, 'refs/tags/v') }}
+        run: |
+          VERSION="${{ steps.version.outputs.version }}"
+          
+          if [ -z "$VERSION" ]; then
+            echo "Error: Version is empty!"
+            exit 1
+          fi
+          
+          if ! git rev-parse "$VERSION" >/dev/null 2>&1; then
+            echo "Creating tag $VERSION"
+            git tag "$VERSION"
+            git push origin "$VERSION"
+          else
+            echo "Tag $VERSION already exists"
+          fi
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
       - name: Create GitHub Release
         uses: softprops/action-gh-release@v2
         with:
           tag_name: ${{ steps.version.outputs.version }}
+          target_commitish: ${{ github.sha }}
           name: ${{ github.event.inputs.release_title || steps.version.outputs.version }}
           body_path: release_notes.md
           prerelease: ${{ github.event.inputs.prerelease || false }}
+          make_latest: true
           files: |
             plugin_versions.json
         env:

.gitignore

@@ -136,6 +136,9 @@ logs/
 # Temporary files
 *.tmp
 *.temp
+.temp/
+.build/
 
 # OpenWebUI specific
 # Add any specific ignores for OpenWebUI plugins if needed
+.git-worktrees/

.markdownlint.json

@@ -0,0 +1,7 @@
+{
+    "default": true,
+    "MD013": false,
+    "MD033": false,
+    "MD030": false,
+    "MD051": false
+}

CONTRIBUTING.md

@@ -1,87 +1,16 @@
-# 贡献指南 (Contributing Guide)
+# Contributing Guide
 
-感谢你对 **OpenWebUI Extras** 感兴趣！我们非常欢迎社区贡献更多的插件、提示词和创意。
+Thank you for your interest in **OpenWebUI Extensions**!
 
-## 🤝 如何贡献
+## 🚀 How to Contribute
 
-### 1. 分享提示词 (Prompts)
+1. **Fork** this repository.
+2. **Add/Modify** the plugin file in the `plugins/` directory.
+3. **Submit PR**: We will review and merge it.
 
-如果你有一个好用的提示词：
+## 💡 Important
-1. 在 `prompts/` 目录下找到合适的分类（如 `coding/`, `writing/`）。如果没有合适的，可以新建一个文件夹。
-2. 创建一个新的 `.md` 或 `.json` 文件。
-3. 提交 Pull Request (PR)。
 
-### 2. 开发插件 (Plugins)
+- Ensure your plugin includes complete metadata (title, author, version, description).
+- If updating an existing plugin, please **increment the version number** (e.g., `0.1.0` -> `0.1.1`) to trigger the auto-update.
 
-如果你开发了一个新的 OpenWebUI 插件 (Function/Tool)：
+Thank you! 🚀
-1. 确保你的插件代码包含完整的元数据（Frontmatter）：
-   ```python
-   """
-   title: 插件名称
-   author: 你的名字
-   version: 0.1.0
-   description: 简短描述插件的功能
-   """
-   ```
-2. 将插件文件放入 `plugins/` 目录下的合适位置：
-   - `plugins/actions/`: 用于添加按钮或修改消息的 Action 插件。
-   - `plugins/filters/`: 用于拦截请求或响应的 Filter 插件。
-   - `plugins/pipes/`: 用于自定义模型或 API 的 Pipe 插件。
-   - `plugins/tools/`: 用于 LLM 调用的 Tool 插件。
-3. 建议在 `docs/` 下添加一个简单的使用说明。
-
-### 3. 改进文档
-
-如果你发现文档有错误或可以改进的地方，直接提交 PR 即可。
-
-## 🛠️ 开发规范
-
-- **代码风格**：Python 代码请遵循 PEP 8 规范。
-- **注释**：关键逻辑请添加注释，方便他人理解。
-- **测试**：提交前请在本地 OpenWebUI 环境中测试通过。
-
-## 📝 提交 PR
-
-1. Fork 本仓库。
-2. 创建一个新的分支 (`git checkout -b feature/AmazingFeature`)。
-3. 提交你的修改 (`git commit -m 'Add some AmazingFeature'`)。
-4. 推送到分支 (`git push origin feature/AmazingFeature`)。
-5. 开启一个 Pull Request。
-
-## 📦 版本更新与发布
-
-当你更新插件时，请遵循以下流程：
-
-### 1. 更新版本号
-
-在插件文件的 docstring 中更新版本号（遵循[语义化版本](https://semver.org/lang/zh-CN/)）：
-
-```python
-"""
-title: 我的插件
-version: 0.2.0  # 更新此处
-...
-"""
-```
-
-### 2. 更新更新日志
-
-在 `CHANGELOG.md` 的 `[Unreleased]` 部分添加你的更改：
-
-```markdown
-### Added / 新增
-- 新功能描述
-
-### Fixed / 修复
-- Bug 修复描述
-```
-
-### 3. 发布流程
-
-维护者会通过以下方式发布新版本：
-- 手动触发 GitHub Actions 中的 "Plugin Release" 工作流
-- 或创建版本标签 (`v*`)
-
-详细说明请参阅 [发布工作流文档](docs/release-workflow.zh.md)。
-
-再次感谢你的贡献！🚀

CONTRIBUTING_CN.md

@@ -0,0 +1,16 @@
+# 贡献指南
+
+感谢你对 **OpenWebUI Extensions** 感兴趣！
+
+## 🚀 贡献流程
+
+1. **Fork** 本仓库。
+2. **修改/添加** `plugins/` 目录下的插件文件。
+3. **提交 PR**: 我们会尽快审核并合并。
+
+## 💡 注意事项
+
+- 请确保插件包含完整的元数据（title, author, version, description）。
+- 如果是更新已有插件，请记得**增加版本号**（如 `0.1.0` -> `0.1.1`），这样系统会自动同步更新。
+
+再次感谢你的贡献！🚀

GEMINI.md

@@ -0,0 +1,157 @@
+# OpenWebUI Extensions — Gemini CLI Project Context
+
+> This file is loaded automatically by Gemini CLI as project-level instructions.
+> Full engineering spec: `.github/copilot-instructions.md`
+
+---
+
+## Project Overview
+
+**openwebui-extensions** is a collection of OpenWebUI plugins authored by Fu-Jie.
+
+Repository: `https://github.com/Fu-Jie/openwebui-extensions`
+
+Plugin types: `actions` / `filters` / `pipes` / `pipelines` / `tools`
+
+---
+
+## Non-Negotiable Rules
+
+1. **No auto-commit.** Never run `git commit`, `git push`, or `gh pr create` unless the user says "发布" / "release" / "commit it". Default output = local file changes only.
+2. **No silent failures.** All errors must surface via `__event_emitter__` notification or backend `logging`.
+3. **No hardcoded model IDs.** Default to the current conversation model; let `Valves` override.
+4. **Chinese responses.** Reply in Simplified Chinese for all planning, explanations, and status summaries. English only for code, commit messages, and docstrings.
+
+---
+
+## Plugin File Contract
+
+Every plugin MUST be a **single-file i18n** Python module:
+
+```text
+plugins/{type}/{name}/{name}.py   ← single source file, built-in i18n
+plugins/{type}/{name}/README.md   ← English docs
+plugins/{type}/{name}/README_CN.md ← Chinese docs
+```
+
+### Docstring (required fields)
+
+```python
+"""
+title: Plugin Display Name
+author: Fu-Jie
+author_url: https://github.com/Fu-Jie/openwebui-extensions
+funding_url: https://github.com/open-webui
+version: 0.1.0
+description: One-line description.
+"""
+```
+
+### Required patterns
+
+- `Valves(BaseModel)` with `UPPER_SNAKE_CASE` fields
+- `_get_user_context(__user__)` — never access `__user__` directly
+- `_get_chat_context(body, __metadata__)` — never infer IDs ad-hoc
+- `_emit_status(emitter, msg, done)` / `_emit_notification(emitter, content, type)`
+- Async I/O only — wrap sync calls with `asyncio.to_thread`
+- `logging` for backend logs — no bare `print()` in production
+
+---
+
+## Antigravity Development Rules
+
+When the user invokes antigravity mode (high-speed iteration), enforce these safeguards automatically:
+
+| Rule | Detail |
+|------|--------|
+| Small reversible edits | One logical change per file per operation |
+| Timeout guards | `asyncio.wait_for(..., timeout=2.0)` on all `__event_call__` JS executions |
+| Path sandbox | Verify every workspace path stays inside the repo root before read/write |
+| Source Sensing | Use `source-code-analyzer` skill for `../open-webui`, `../copilot-sdk` etc. `git pull` before analysis. |
+| External Auth  | **AUTHORIZED** to read (RO) from specified external paths (open-webui, copilot-sdk, etc.) for analysis. |
+| Fallback chains | API upload → DB + local copy; never a single point of failure |
+| Progressive status | `status(done=False)` at start, `status(done=True)` on end, `notification(error)` on failure |
+| Validate before emit | Check `emitter is not None` before every `await emitter(...)` |
+
+---
+
+## File Creation & Delivery Protocol (3-Step)
+
+1. `local write` — create artifact inside workspace scope
+2. `publish_file_from_workspace(filename='...')` — migrate to OpenWebUI storage (S3-compatible)
+3. Return `/api/v1/files/{id}/content` download link in Markdown
+
+Set `skip_rag=true` metadata on generated downloadable artifacts.
+
+---
+
+## Copilot SDK Tool Definition (critical)
+
+```python
+from pydantic import BaseModel, Field
+from copilot import define_tool
+
+class MyToolParams(BaseModel):
+    query: str = Field(..., description="Search query")
+
+my_tool = define_tool(
+    name="my_tool",
+    description="...",
+    params_type=MyToolParams,   # REQUIRED — prevents empty schema hallucination
+)(async_impl_fn)
+```
+
+---
+
+## Streaming Output Format (OpenWebUI 0.8.x)
+
+- Reasoning: `<think>\n...\n</think>\n` — close BEFORE normal content or tool cards
+- Tool cards: `<details type="tool_calls" id="..." name="..." arguments="&quot;...&quot;" result="&quot;...&quot;" done="true">\n<summary>Tool Executed</summary>\n</details>\n\n`
+- Escape ALL `"` inside `arguments`/`result` attributes as `&quot;`
+- Status events via `__event_emitter__` — do NOT pollute the content stream with debug text
+
+---
+
+## Documentation Sync (when changing a plugin)
+
+Must update ALL of these or the PR check fails:
+
+1. `plugins/{type}/{name}/{name}.py` — version in docstring
+2. `plugins/{type}/{name}/README.md` — version, What's New
+3. `plugins/{type}/{name}/README_CN.md` — same
+4. `docs/plugins/{type}/{name}.md` — mirror README
+5. `docs/plugins/{type}/{name}.zh.md` — mirror README_CN
+6. `docs/plugins/{type}/index.md` — version badge
+7. `docs/plugins/{type}/index.zh.md` — version badge
+
+---
+
+## i18n & Language Standards
+
+1. **Alignment**: Keep the number of supported languages in `TRANSLATIONS` consistent with major plugins (e.g., `smart-mind-map`).
+2. **Supported Languages**: en-US, zh-CN, zh-HK, zh-TW, ko-KR, ja-JP, fr-FR, de-DE, es-ES, it-IT, vi-VN, id-ID.
+3. **Fallback Map**: Must include variant redirects (e.g., `es-MX` -> `es-ES`, `fr-CA` -> `fr-FR`).
+4. **Tooltips**: All `description` fields in `Valves` must be **English only** to maintain clean UI.
+
+---
+
+## Commit Message Format
+
+```text
+type(scope): brief English description
+
+- Key change 1
+- Key change 2
+```
+
+Types: `feat` / `fix` / `docs` / `refactor` / `chore`
+Scope: plugin folder name (e.g., `github-copilot-sdk`)
+
+---
+
+## Full Reference
+
+`.github/copilot-instructions.md` — complete engineering specification (1000+ lines)
+`.agent/workflows/plugin-development.md` — step-by-step development workflow
+`.agent/rules/antigravity.md` — antigravity mode detailed rules
+`docs/development/copilot-engineering-plan.md` — design baseline

README.md

@@ -1,43 +1,152 @@
-# OpenWebUI Extras
+# OpenWebUI Extensions
+<!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
+[![All Contributors](https://img.shields.io/badge/all_contributors-5-orange.svg?style=flat-square)](#contributors-)
+<!-- ALL-CONTRIBUTORS-BADGE:END -->
 
 English | [中文](./README_CN.md)
 
-A collection of enhancements, plugins, and prompts for [OpenWebUI](https://github.com/open-webui/open-webui), developed and curated for personal use to extend functionality and improve experience.
+A collection of enhancements, plugins, and prompts for [open-webui](https://github.com/open-webui/open-webui), developed and curated for personal use to extend functionality and improve experience.
 
-[Contributing](./CONTRIBUTING.md)
+<!-- STATS_START -->
+## 📊 Community Stats
+>
+> ![updated](https://img.shields.io/endpoint?url=https%3A%2F%2Fgist.githubusercontent.com%2FFu-Jie%2Fdb3d95687075a880af6f1fba76d679c6%2Fraw%2Fbadge_updated.json&style=flat)
+
+| 👤 Author | 👥 Followers | ⭐ Points | 🏆 Contributions |
+| :---: | :---: | :---: | :---: |
+| [Fu-Jie](https://openwebui.com/u/Fu-Jie) | ![followers](https://img.shields.io/endpoint?url=https%3A%2F%2Fgist.githubusercontent.com%2FFu-Jie%2Fdb3d95687075a880af6f1fba76d679c6%2Fraw%2Fbadge_followers.json&style=flat) | ![points](https://img.shields.io/endpoint?url=https%3A%2F%2Fgist.githubusercontent.com%2FFu-Jie%2Fdb3d95687075a880af6f1fba76d679c6%2Fraw%2Fbadge_points.json&style=flat) | ![contributions](https://img.shields.io/endpoint?url=https%3A%2F%2Fgist.githubusercontent.com%2FFu-Jie%2Fdb3d95687075a880af6f1fba76d679c6%2Fraw%2Fbadge_contributions.json&style=flat) |
+
+| 📝 Posts | ⬇️ Downloads | 👁️ Views | 👍 Upvotes | 💾 Saves |
+| :---: | :---: | :---: | :---: | :---: |
+| ![posts](https://img.shields.io/endpoint?url=https%3A%2F%2Fgist.githubusercontent.com%2FFu-Jie%2Fdb3d95687075a880af6f1fba76d679c6%2Fraw%2Fbadge_posts.json&style=flat) | ![downloads](https://img.shields.io/endpoint?url=https%3A%2F%2Fgist.githubusercontent.com%2FFu-Jie%2Fdb3d95687075a880af6f1fba76d679c6%2Fraw%2Fbadge_downloads.json&style=flat) | ![views](https://img.shields.io/endpoint?url=https%3A%2F%2Fgist.githubusercontent.com%2FFu-Jie%2Fdb3d95687075a880af6f1fba76d679c6%2Fraw%2Fbadge_views.json&style=flat) | ![upvotes](https://img.shields.io/endpoint?url=https%3A%2F%2Fgist.githubusercontent.com%2FFu-Jie%2Fdb3d95687075a880af6f1fba76d679c6%2Fraw%2Fbadge_upvotes.json&style=flat) | ![saves](https://img.shields.io/endpoint?url=https%3A%2F%2Fgist.githubusercontent.com%2FFu-Jie%2Fdb3d95687075a880af6f1fba76d679c6%2Fraw%2Fbadge_saves.json&style=flat) |
+
+### 🔥 Top 6 Popular Plugins
+
+| Rank | Plugin | Version | Downloads | Views | 📅 Updated |
+| :---: | :--- | :---: | :---: | :---: | :---: |
+| 🥇 | [Smart Mind Map](https://openwebui.com/posts/turn_any_text_into_beautiful_mind_maps_3094c59a) | ![p1_version](https://img.shields.io/endpoint?url=https%3A%2F%2Fgist.githubusercontent.com%2FFu-Jie%2Fdb3d95687075a880af6f1fba76d679c6%2Fraw%2Fbadge_p1_version.json&style=flat) | ![p1_dl](https://img.shields.io/endpoint?url=https%3A%2F%2Fgist.githubusercontent.com%2FFu-Jie%2Fdb3d95687075a880af6f1fba76d679c6%2Fraw%2Fbadge_p1_dl.json&style=flat) | ![p1_vw](https://img.shields.io/endpoint?url=https%3A%2F%2Fgist.githubusercontent.com%2FFu-Jie%2Fdb3d95687075a880af6f1fba76d679c6%2Fraw%2Fbadge_p1_vw.json&style=flat) | ![updated](https://img.shields.io/badge/2026--03--04-gray?style=flat) |
+| 🥈 | [Smart Infographic](https://openwebui.com/posts/smart_infographic_ad6f0c7f) | ![p2_version](https://img.shields.io/endpoint?url=https%3A%2F%2Fgist.githubusercontent.com%2FFu-Jie%2Fdb3d95687075a880af6f1fba76d679c6%2Fraw%2Fbadge_p2_version.json&style=flat) | ![p2_dl](https://img.shields.io/endpoint?url=https%3A%2F%2Fgist.githubusercontent.com%2FFu-Jie%2Fdb3d95687075a880af6f1fba76d679c6%2Fraw%2Fbadge_p2_dl.json&style=flat) | ![p2_vw](https://img.shields.io/endpoint?url=https%3A%2F%2Fgist.githubusercontent.com%2FFu-Jie%2Fdb3d95687075a880af6f1fba76d679c6%2Fraw%2Fbadge_p2_vw.json&style=flat) | ![updated](https://img.shields.io/badge/2026--02--13-gray?style=flat) |
+| 🥉 | [Markdown Normalizer](https://openwebui.com/posts/markdown_normalizer_baaa8732) | ![p3_version](https://img.shields.io/endpoint?url=https%3A%2F%2Fgist.githubusercontent.com%2FFu-Jie%2Fdb3d95687075a880af6f1fba76d679c6%2Fraw%2Fbadge_p3_version.json&style=flat) | ![p3_dl](https://img.shields.io/endpoint?url=https%3A%2F%2Fgist.githubusercontent.com%2FFu-Jie%2Fdb3d95687075a880af6f1fba76d679c6%2Fraw%2Fbadge_p3_dl.json&style=flat) | ![p3_vw](https://img.shields.io/endpoint?url=https%3A%2F%2Fgist.githubusercontent.com%2FFu-Jie%2Fdb3d95687075a880af6f1fba76d679c6%2Fraw%2Fbadge_p3_vw.json&style=flat) | ![updated](https://img.shields.io/badge/2026--02--28-gray?style=flat) |
+| 4️⃣ | [Export to Word Enhanced](https://openwebui.com/posts/export_to_word_enhanced_formatting_fca6a315) | ![p4_version](https://img.shields.io/endpoint?url=https%3A%2F%2Fgist.githubusercontent.com%2FFu-Jie%2Fdb3d95687075a880af6f1fba76d679c6%2Fraw%2Fbadge_p4_version.json&style=flat) | ![p4_dl](https://img.shields.io/endpoint?url=https%3A%2F%2Fgist.githubusercontent.com%2FFu-Jie%2Fdb3d95687075a880af6f1fba76d679c6%2Fraw%2Fbadge_p4_dl.json&style=flat) | ![p4_vw](https://img.shields.io/endpoint?url=https%3A%2F%2Fgist.githubusercontent.com%2FFu-Jie%2Fdb3d95687075a880af6f1fba76d679c6%2Fraw%2Fbadge_p4_vw.json&style=flat) | ![updated](https://img.shields.io/badge/2026--02--13-gray?style=flat) |
+| 5️⃣ | [Async Context Compression](https://openwebui.com/posts/async_context_compression_b1655bc8) | ![p5_version](https://img.shields.io/endpoint?url=https%3A%2F%2Fgist.githubusercontent.com%2FFu-Jie%2Fdb3d95687075a880af6f1fba76d679c6%2Fraw%2Fbadge_p5_version.json&style=flat) | ![p5_dl](https://img.shields.io/endpoint?url=https%3A%2F%2Fgist.githubusercontent.com%2FFu-Jie%2Fdb3d95687075a880af6f1fba76d679c6%2Fraw%2Fbadge_p5_dl.json&style=flat) | ![p5_vw](https://img.shields.io/endpoint?url=https%3A%2F%2Fgist.githubusercontent.com%2FFu-Jie%2Fdb3d95687075a880af6f1fba76d679c6%2Fraw%2Fbadge_p5_vw.json&style=flat) | ![updated](https://img.shields.io/badge/2026--02--28-gray?style=flat) |
+| 6️⃣ | [Export to Excel](https://openwebui.com/posts/export_mulit_table_to_excel_244b8f9d) | ![v](https://img.shields.io/badge/v-0.3.7-blue?style=flat) | ![p6_dl](https://img.shields.io/endpoint?url=https%3A%2F%2Fgist.githubusercontent.com%2FFu-Jie%2Fdb3d95687075a880af6f1fba76d679c6%2Fraw%2Fbadge_p6_dl.json&style=flat) | ![p6_vw](https://img.shields.io/endpoint?url=https%3A%2F%2Fgist.githubusercontent.com%2FFu-Jie%2Fdb3d95687075a880af6f1fba76d679c6%2Fraw%2Fbadge_p6_vw.json&style=flat) | ![updated](https://img.shields.io/badge/2026--02--13-gray?style=flat) |
+
+### 📈 Total Downloads Trend
+
+![Activity](https://gist.githubusercontent.com/Fu-Jie/db3d95687075a880af6f1fba76d679c6/raw/chart.svg)
+
+*See full stats and charts in [Community Stats Report](./docs/community-stats.md)*
+<!-- STATS_END -->
+
+## 🌟 Star Features
+
+### 1. [GitHub Copilot Official SDK Pipe](https://openwebui.com/posts/github_copilot_official_sdk_pipe_ce96f7b4) ![v0.9.1](https://img.shields.io/badge/v0.9.1-blue?style=flat-square) ![active-dev](https://img.shields.io/badge/active--dev-orange?style=flat-square) ![downloads](https://img.shields.io/endpoint?url=https%3A%2F%2Fgist.githubusercontent.com%2FFu-Jie%2Fdb3d95687075a880af6f1fba76d679c6%2Fraw%2Fbadge_post_aef940e01073e811a311c3a443d9c149_dl.json&style=flat-square) ![views](https://img.shields.io/endpoint?url=https%3A%2F%2Fgist.githubusercontent.com%2FFu-Jie%2Fdb3d95687075a880af6f1fba76d679c6%2Fraw%2Fbadge_post_aef940e01073e811a311c3a443d9c149_vw.json&style=flat-square)
+
+**The ultimate autonomous Agent integration for OpenWebUI.** Deeply bridging GitHub Copilot SDK with your OpenWebUI ecosystem. It enables the Agent to autonomously perform **intent recognition**, **web search**, and **context compaction** while reusing your existing tools, skills, and configurations for a professional, full-featured experience.
+
+> [!TIP]
+> **No GitHub Copilot subscription required!** Supports **BYOK (Bring Your Own Key)** mode using your own OpenAI/Anthropic API keys.
+
+#### 🚀 Key Leap (v0.9.1+)
+
+- **🔌 Seamless Ecosystem Integration**: Automatically injects and reuses your OpenWebUI **Tools**, **MCP**, **OpenAPI Servers**, and **Skills**, significantly enhancing the Agent's capabilities through your existing setup.
+- **🌐 Language Consistency**: System prompts mandate that Agent output language remains strictly consistent with user input.
+- **🧩 Skills Revolution**: Native support for **SKILL directories** and a **Bidirectional Bridge** to OpenWebUI Workspace Skills.
+- **🛡️ Secure Isolation**: Strict user/session-level **Workspace Sandboxing** with persistent configuration.
+- **📊 Interactive Delivery**: Full support for **HTML Artifacts** and **RichUI** rendering, providing instant interactive previews and persistent downloadable results.
+- **🛠️ Deterministic Toolchain**: Built-in specialized tools for skill lifecycles (`manage_skills`) and system optimization.
+
+> [!TIP]
+> **💡 Pro Tip: Enhanced Visualization**
+> We highly recommend asking the Agent to install the [Visual Explainer](https://github.com/nicobailon/visual-explainer) skill during your conversation. It dramatically improves the aesthetics and interactivity of generated **HTML Artifacts**. Simply tell the AI:
+> "Please install this skill: <https://github.com/nicobailon/visual-explainer>" to get started.
+
+#### 📺 Demo: Visual Skills & Data Analysis
+
+![GitHub Copilot SDK Skill Demo](https://github.com/Fu-Jie/openwebui-extensions/raw/main/docs/assets/videos/skill.gif)
+> *In this demo, the Agent installs a visual enhancement skill and automatically generates an interactive dashboard from World Cup data.*
+
+#### 🌟 Featured Real-World Cases
+
+- **[GitHub Star Forecasting](./docs/plugins/pipes/star-prediction-example.md)**: Automatically parsing CSV data, writing analysis scripts, and generating interactive growth dashboards.
+- **[Video Optimization](./docs/plugins/pipes/video-processing-example.md)**: Direct control of system-level tools (FFmpeg) to accelerate and compress media with professional color optimization.
+
+### 2. [Smart Mind Map](https://openwebui.com/posts/turn_any_text_into_beautiful_mind_maps_3094c59a)
+
+**Experience interactive thinking.** Seamlessly transforms complex chat sessions into structured, clickable mind maps for better visual modeling and rapid idea extraction.
+
+### 3. [Smart Infographic](https://openwebui.com/posts/smart_infographic_ad6f0c7f)
+
+**Professional data storytelling.** Converts raw information into sleek, boardroom-ready infographics powered by AntV, perfect for summarizing long-form content instantly.
+
+### 4. [Export to Word Enhanced](https://openwebui.com/posts/export_to_word_enhanced_formatting_fca6a315)
+
+**High-fidelity reporting.** Export conversation history into professionally formatted Word documents with preserved headers, code blocks, and math formulas.
+
+### 5. [Async Context Compression](https://openwebui.com/posts/async_context_compression_b1655bc8)
+
+**Maximize your context window.** Intelligently compresses chat history using LLM logic to save tokens and costs while maintaining a high-quality reasoning chain.
 
 ## 📦 Project Contents
 
-### 🧩 Plugins
+<!-- markdownlint-disable MD033 -->
+<details>
+<summary><b>🧩 Plugins (Actions, Filters, Pipes, Pipelines)</b></summary>
 
 Located in the `plugins/` directory, containing Python-based enhancements:
 
-#### Actions
+### Actions
+
 - **Smart Mind Map** (`smart-mind-map`): Generates interactive mind maps from text.
 - **Smart Infographic** (`infographic`): Transforms text into professional infographics using AntV.
-- **Knowledge Card** (`knowledge-card`): Creates beautiful flashcards for learning.
+- **Flash Card** (`flash-card`): Quickly generates beautiful flashcards for learning.
+- **Deep Dive** (`deep-dive`): A comprehensive thinking lens that dives deep into any content.
 - **Export to Excel** (`export_to_excel`): Exports chat history to Excel files.
 - **Export to Word** (`export_to_docx`): Exports chat history to Word documents.
-- **Summary** (`summary`): Text summarization tool.
 
-#### Filters
+### Tools
+
+- **Smart Mind Map Tool** (`smart-mind-map-tool`): The tool version of Smart Mind Map, enabling AI proactive/autonomous invocation.
+- **OpenWebUI Skills Manager Tool** (`openwebui-skills-manager-tool`): Native tool for managing OpenWebUI skills.
+
+### Filters
+
+- **GitHub Copilot SDK Files Filter** (`github_copilot_sdk_files_filter`): Essential companion for Copilot SDK. Bypasses RAG to ensure full file accessibility for Agents.
+- **Web Gemini Multimodal Filter** (`web_gemini_multimodel_filter`): Adds multimodal capabilities (PDF, Video, Office) to any model with intelligent routing.
 - **Async Context Compression** (`async-context-compression`): Optimizes token usage via context compression.
 - **Context Enhancement** (`context_enhancement_filter`): Enhances chat context.
-- **Gemini Manifold Companion** (`gemini_manifold_companion`): Companion filter for Gemini Manifold.
+- **Folder Memory** (`folder-memory`): Automatically extracts project rules from conversations and injects them into the folder's system prompt.
+- **Markdown Normalizer** (`markdown_normalizer`): Fixes common Markdown formatting issues in LLM outputs.
 
+### Pipes
 
-#### Pipes
+- **GitHub Copilot SDK** (`github-copilot-sdk`): Official GitHub Copilot SDK integration. Supports dynamic models (GPT-4o, Claude 3.5, o1), multi-turn conversation, streaming, and infinite sessions.
-- **Gemini Manifold** (`gemini_mainfold`): Pipeline for Gemini model integration.
+
+### Pipelines
 
-#### Pipelines
 - **MoE Prompt Refiner** (`moe_prompt_refiner`): Refines prompts for Mixture of Experts (MoE) summary requests to generate high-quality comprehensive reports.
 
-### 🎯 Prompts
+</details>
+<!-- markdownlint-enable MD033 -->
 
-Located in the `prompts/` directory, containing fine-tuned System Prompts:
+<!-- markdownlint-disable MD033 -->
+<details>
+<summary><b>🎯 Prompts (System Prompts for various roles)</b></summary>
 
-- **Coding**: Programming assistance prompts.
+System Prompts are managed in the `docs/prompts/` directory:
-- **Marketing**: Marketing and copywriting prompts.
+
+- **[Prompt Library](./docs/prompts/library.md)**: A curated collection of fine-tuned prompts for Coding, Marketing, and Analysis.
+
+</details>
+<!-- markdownlint-enable MD033 -->
+
+## 🛠️ Extensions
+
+Standalone frontend extensions to supercharge your Open WebUI:
+
+- **[Open WebUI Prompt Plus](https://github.com/Fu-Jie/open-webui-prompt-plus)**
+
+[![Newsletter](https://img.shields.io/badge/OpenWebUI_Newsletter-Featured-blue?style=flat-square)](https://openwebui.com/blog/newsletter-january-28-2026): An all-in-one prompt management suite featuring AI-powered prompt generation, spotlight-style quick search, and advanced category organization.
 
 ## 📖 Documentation
 
@@ -74,6 +183,35 @@ This project is a collection of resources and does not require a Python environm
 ### Contributing
 
 If you have great prompts or plugins to share:
+
 1. Fork this repository.
 2. Add your files to the appropriate `prompts/` or `plugins/` directory.
 3. Submit a Pull Request.
+
+[Contributing](./CONTRIBUTING.md)
+
+## Contributors ✨
+
+Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):
+
+<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
+<!-- prettier-ignore-start -->
+<!-- markdownlint-disable -->
+<table>
+  <tbody>
+    <tr>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/rbb-dev"><img src="https://avatars.githubusercontent.com/u/37469229?v=4?s=100" width="100px;" alt="rbb-dev"/><br /><sub><b>rbb-dev</b></sub></a><br /><a href="#ideas-rbb-dev" title="Ideas, Planning, & Feedback">🤔</a> <a href="https://github.com/Fu-Jie/openwebui-extensions/commits?author=rbb-dev" title="Code">💻</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://trade.xyz/?ref=BZ1RJRXWO"><img src="https://avatars.githubusercontent.com/u/7317522?v=4?s=100" width="100px;" alt="Raxxoor"/><br /><sub><b>Raxxoor</b></sub></a><br /><a href="https://github.com/Fu-Jie/openwebui-extensions/issues?q=author%3Adhaern" title="Bug reports">🐛</a> <a href="#ideas-dhaern" title="Ideas, Planning, & Feedback">🤔</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/i-iooi-i"><img src="https://avatars.githubusercontent.com/u/1827701?v=4?s=100" width="100px;" alt="ZOLO"/><br /><sub><b>ZOLO</b></sub></a><br /><a href="https://github.com/Fu-Jie/openwebui-extensions/issues?q=author%3Ai-iooi-i" title="Bug reports">🐛</a> <a href="#ideas-i-iooi-i" title="Ideas, Planning, & Feedback">🤔</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://perso.crans.org/grande/"><img src="https://avatars.githubusercontent.com/u/469017?v=4?s=100" width="100px;" alt="Johan Grande"/><br /><sub><b>Johan Grande</b></sub></a><br /><a href="#ideas-nahoj" title="Ideas, Planning, & Feedback">🤔</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/abaroni"><img src="https://avatars.githubusercontent.com/u/21365486?v=4?s=100" width="100px;" alt="Alessandro Baroni"/><br /><sub><b>Alessandro Baroni</b></sub></a><br /><a href="#ideas-abaroni" title="Ideas, Planning, & Feedback">🤔</a></td>
+    </tr>
+  </tbody>
+</table>
+
+<!-- markdownlint-restore -->
+<!-- prettier-ignore-end -->
+
+<!-- ALL-CONTRIBUTORS-LIST:END -->
+
+This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!