chore(release): finalize github-copilot-sdk v0.9.1 prep
- sync bilingual plugin READMEs, docs mirrors, and root highlight sections for v0.9.1 - add comprehensive EN/CN release notes covering features, fixes, docs, and i18n updates - enforce full-coverage release-note rule in release-prep skill for future releases
This commit is contained in:
fujie
13
.github/skills/release-prep/SKILL.md
vendored
13
.github/skills/release-prep/SKILL.md
vendored
@@ -89,6 +89,18 @@ Each file must include:
|
|||||||
|
|
||||||
If a release notes file already exists for this version, update it rather than creating a new one.
|
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)
|
### Step 5 — Verify Consistency (Pre-Commit Check)
|
||||||
|
|
||||||
Run the consistency check script:
|
Run the consistency check script:
|
||||||
@@ -130,6 +142,7 @@ Confirm the commit hash and list the number of files changed.
|
|||||||
- [ ] Both `index.md` version badges updated
|
- [ ] Both `index.md` version badges updated
|
||||||
- [ ] Root `README.md` and `README_CN.md` date badges updated to today
|
- [ ] Root `README.md` and `README_CN.md` date badges updated to today
|
||||||
- [ ] `What's New` / `最新更新` contains ONLY the latest release
|
- [ ] `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
|
- [ ] `v{version}.md` and `v{version}_CN.md` created or updated
|
||||||
- [ ] `python3 scripts/check_version_consistency.py` returns no errors
|
- [ ] `python3 scripts/check_version_consistency.py` returns no errors
|
||||||
- [ ] Commit message is English-only Conventional Commits format
|
- [ ] Commit message is English-only Conventional Commits format
|
||||||
|
|||||||
18
README.md
18
README.md
@@ -25,6 +25,7 @@ A collection of enhancements, plugins, and prompts for [OpenWebUI](https://githu
|
|||||||
| :---: | :--- | :---: | :---: | :---: | :---: |
|
| :---: | :--- | :---: | :---: | :---: | :---: |
|
||||||
| 🥇 | [Smart Mind Map](https://openwebui.com/posts/turn_any_text_into_beautiful_mind_maps_3094c59a) |  |  |  |  |
|
| 🥇 | [Smart Mind Map](https://openwebui.com/posts/turn_any_text_into_beautiful_mind_maps_3094c59a) |  |  |  |  |
|
||||||
| 🥈 | [Smart Infographic](https://openwebui.com/posts/smart_infographic_ad6f0c7f) |  |  |  |  |
|
| 🥈 | [Smart Infographic](https://openwebui.com/posts/smart_infographic_ad6f0c7f) |  |  |  |  |
|
||||||
|
| 🆕 | [GitHub Copilot Official SDK Pipe](https://openwebui.com/posts/github_copilot_official_sdk_pipe_ce96f7b4) |  |  |  |  |
|
||||||
| 🥉 | [Markdown Normalizer](https://openwebui.com/posts/markdown_normalizer_baaa8732) |  |  |  |  |
|
| 🥉 | [Markdown Normalizer](https://openwebui.com/posts/markdown_normalizer_baaa8732) |  |  |  |  |
|
||||||
| 4️⃣ | [Export to Word Enhanced](https://openwebui.com/posts/export_to_word_enhanced_formatting_fca6a315) |  |  |  |  |
|
| 4️⃣ | [Export to Word Enhanced](https://openwebui.com/posts/export_to_word_enhanced_formatting_fca6a315) |  |  |  |  |
|
||||||
| 5️⃣ | [Async Context Compression](https://openwebui.com/posts/async_context_compression_b1655bc8) |  |  |  |  |
|
| 5️⃣ | [Async Context Compression](https://openwebui.com/posts/async_context_compression_b1655bc8) |  |  |  |  |
|
||||||
@@ -38,20 +39,27 @@ A collection of enhancements, plugins, and prompts for [OpenWebUI](https://githu
|
|||||||
|
|
||||||
## 🌟 Star Features
|
## 🌟 Star Features
|
||||||
|
|
||||||
### 1. [GitHub Copilot SDK Pipe](https://openwebui.com/posts/github_copilot_official_sdk_pipe_ce96f7b4) [](https://openwebui.com/posts/github_copilot_official_sdk_pipe_ce96f7b4)
|
### 1. [GitHub Copilot Official SDK Pipe](https://openwebui.com/posts/github_copilot_official_sdk_pipe_ce96f7b4) [](https://openwebui.com/posts/github_copilot_official_sdk_pipe_ce96f7b4) 
|
||||||
|
|
||||||
**The ultimate autonomous Agent for OpenWebUI.** Transforming your LLM into a powerful OS-level engineer with native code execution, deep tool autonomy, and professional skill management.
|
**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]
|
> [!TIP]
|
||||||
> **No GitHub Copilot subscription required!** Supports **BYOK (Bring Your Own Key)** mode using your own OpenAI/Anthropic API keys.
|
> **No GitHub Copilot subscription required!** Supports **BYOK (Bring Your Own Key)** mode using your own OpenAI/Anthropic API keys.
|
||||||
|
|
||||||
#### 🚀 Key Leap (v0.9.0+)
|
#### 🚀 Key Leap (v0.9.1+)
|
||||||
|
|
||||||
- **🧩 Skills Revolution**: Native support for **SKILL directories** (scripts, templates, resources) coupled with a **Bidirectional Bridge** to OpenWebUI Workspace Skills.
|
- **🔌 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.
|
- **🛡️ Secure Isolation**: Strict user/session-level **Workspace Sandboxing** with persistent configuration.
|
||||||
- **📊 Interactive Delivery**: Professional **File Delivery Protocol** for instant HTML artifacts and persistent downloadable results.
|
- **📊 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.
|
- **🛠️ 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
|
#### 📺 Demo: Visual Skills & Data Analysis
|
||||||
|
|
||||||
|
|
||||||
|
|||||||
20
README_CN.md
20
README_CN.md
@@ -22,6 +22,7 @@ OpenWebUI 增强功能集合。包含个人开发与收集的插件、提示词
|
|||||||
| :---: | :--- | :---: | :---: | :---: | :---: |
|
| :---: | :--- | :---: | :---: | :---: | :---: |
|
||||||
| 🥇 | [Smart Mind Map](https://openwebui.com/posts/turn_any_text_into_beautiful_mind_maps_3094c59a) |  |  |  |  |
|
| 🥇 | [Smart Mind Map](https://openwebui.com/posts/turn_any_text_into_beautiful_mind_maps_3094c59a) |  |  |  |  |
|
||||||
| 🥈 | [Smart Infographic](https://openwebui.com/posts/smart_infographic_ad6f0c7f) |  |  |  |  |
|
| 🥈 | [Smart Infographic](https://openwebui.com/posts/smart_infographic_ad6f0c7f) |  |  |  |  |
|
||||||
|
| 🆕 | [GitHub Copilot Official SDK Pipe](https://openwebui.com/posts/github_copilot_official_sdk_pipe_ce96f7b4) |  |  |  |  |
|
||||||
| 🥉 | [Markdown Normalizer](https://openwebui.com/posts/markdown_normalizer_baaa8732) |  |  |  |  |
|
| 🥉 | [Markdown Normalizer](https://openwebui.com/posts/markdown_normalizer_baaa8732) |  |  |  |  |
|
||||||
| 4️⃣ | [Export to Word Enhanced](https://openwebui.com/posts/export_to_word_enhanced_formatting_fca6a315) |  |  |  |  |
|
| 4️⃣ | [Export to Word Enhanced](https://openwebui.com/posts/export_to_word_enhanced_formatting_fca6a315) |  |  |  |  |
|
||||||
| 5️⃣ | [Async Context Compression](https://openwebui.com/posts/async_context_compression_b1655bc8) |  |  |  |  |
|
| 5️⃣ | [Async Context Compression](https://openwebui.com/posts/async_context_compression_b1655bc8) |  |  |  |  |
|
||||||
@@ -35,19 +36,26 @@ OpenWebUI 增强功能集合。包含个人开发与收集的插件、提示词
|
|||||||
|
|
||||||
## 🌟 精选功能
|
## 🌟 精选功能
|
||||||
|
|
||||||
### 1. [GitHub Copilot SDK Pipe](https://openwebui.com/posts/github_copilot_official_sdk_pipe_ce96f7b4) [](https://openwebui.com/posts/github_copilot_official_sdk_pipe_ce96f7b4)
|
### 1. [GitHub Copilot Official SDK Pipe](https://openwebui.com/posts/github_copilot_official_sdk_pipe_ce96f7b4) [](https://openwebui.com/posts/github_copilot_official_sdk_pipe_ce96f7b4) 
|
||||||
|
|
||||||
**OpenWebUI 终极自主 Agent 增强。** 将 LLM 转化为具备 OS 级操作能力的专业工程师，支持原生代码执行、深度工具自治以及专业技能管理。
|
**OpenWebUI 终极自主 Agent 深度集成。** 将 GitHub Copilot SDK 与 OpenWebUI 生态完美桥接。它允许 Agent 具备**智能意图识别**、**自主网页搜索**与**自动上下文压缩**能力，同时直接复用您现有的工具、技能与配置，通过全功能 Skill 体系带来极致的专业交互体验。
|
||||||
|
|
||||||
> [!TIP]
|
> [!TIP]
|
||||||
> **无需 GitHub Copilot 订阅！** 支持 **BYOK (Bring Your Own Key)** 模式，使用你自己的 OpenAI/Anthropic API Key。
|
> **无需 GitHub Copilot 订阅！** 支持 **BYOK (Bring Your Own Key)** 模式，使用你自己的 OpenAI/Anthropic API Key。
|
||||||
|
|
||||||
#### 🚀 核心进化 (v0.9.0+)
|
#### 🚀 核心进化 (v0.9.1+)
|
||||||
|
|
||||||
- **🧩 技能革命**: 原生支持 **SKILL 目录**（含脚本、模板与资源），并实现与 OpenWebUI **工作区 > Skills** 的深度双向桥接。
|
- **🔌 生态深度注入**: 自动读取并复用 OpenWebUI **工具 (Tools)**、**MCP**、**OpenAPI Server** 与 **技能 (Skills)**，显著增强 Agent 的实战能力。
|
||||||
|
- **🧩 技能革命**: 原生支持 **SKILL 目录**，并实现与 OpenWebUI **工作区 > Skills** 的深度双向桥接。
|
||||||
- **🛡️ 安全沙箱**: 严格的用户/会话级 **工作区隔离** 与持久化配置环境。
|
- **🛡️ 安全沙箱**: 严格的用户/会话级 **工作区隔离** 与持久化配置环境。
|
||||||
- **📊 交互交付**: 专业 **文件交付协议**，支持即时预览交互式 HTML Artifacts 与持久化结果下载。
|
- **📊 交互交付**: 完整支持 **HTML Artifacts** 与 **RichUI** 渲染，提供即时预览交互式应用程序与持久化结果下载。
|
||||||
- **🛠️ 确定性工具链**: 内置 `manage_skills` 等专业工具，赋予 Agent 完整的技能生命周期管理能力。
|
- **🛠️ 确定性工具链**: 内置 `manage_skills` 等专业工具，赋予 Agent 完整的技能生命周期管理能力。
|
||||||
|
- **🌐 语言一致性**: 提示词强制要求 Agent 输出语言与用户输入保持一致，确保国际化体验。
|
||||||
|
|
||||||
|
> [!TIP]
|
||||||
|
> **💡 进阶实战建议**
|
||||||
|
> 强烈推荐在对话中让 Agent 为其安装 [Visual Explainer](https://github.com/nicobailon/visual-explainer) 技能。该技能能显著提升 **HTML Artifacts** 的美观度与交互深度，只需对 AI 说：
|
||||||
|
> “请帮我安装这个技能：https://github.com/nicobailon/visual-explainer” 即可瞬间启用。
|
||||||
|
|
||||||
#### 📺 演示：可视化技能与数据分析
|
#### 📺 演示：可视化技能与数据分析
|
||||||
|
|
||||||
@@ -103,7 +111,7 @@ OpenWebUI 增强功能集合。包含个人开发与收集的插件、提示词
|
|||||||
|
|
||||||
### Pipes (模型管道)
|
### Pipes (模型管道)
|
||||||
|
|
||||||
- **GitHub Copilot SDK** (`github-copilot-sdk`): GitHub Copilot SDK 官方集成。支持动态模型、多轮对话、流式输出、图片输入及无限会话。
|
- **GitHub Copilot SDK** (`github-copilot-sdk`): 深度集成 GitHub Copilot SDK 的强大 Agent。支持智能意图识别、自主网页搜索与上下文压缩，并能够无缝复用 OpenWebUI 的工具 (Tools)、MCP 与 OpenAPI Server。
|
||||||
|
|
||||||
### Pipelines (工作流管道)
|
### Pipelines (工作流管道)
|
||||||
|
|
||||||
|
|||||||
@@ -2,7 +2,13 @@
|
|||||||
|
|
||||||
**Author:** [Fu-Jie](https://github.com/Fu-Jie) | **Version:** 0.9.1 | **Project:** [OpenWebUI Extensions](https://github.com/Fu-Jie/openwebui-extensions) | **License:** MIT
|
**Author:** [Fu-Jie](https://github.com/Fu-Jie) | **Version:** 0.9.1 | **Project:** [OpenWebUI Extensions](https://github.com/Fu-Jie/openwebui-extensions) | **License:** MIT
|
||||||
|
|
||||||
This is an advanced Pipe function for [OpenWebUI](https://github.com/open-webui/open-webui) that integrates the official [GitHub Copilot SDK](https://github.com/github/copilot-sdk). It enables you to use **GitHub Copilot models** (e.g., `gpt-5.2-codex`, `claude-sonnet-4.5`,`gemini-3-pro`, `gpt-5-mini`) **AND** your own models via **BYOK** (OpenAI, Anthropic) directly within OpenWebUI, providing a unified agentic experience with **strict User & Chat-level Workspace Isolation**.
|
This is a powerful **GitHub Copilot SDK** Pipe for **OpenWebUI** that provides a unified **Agentic experience**. It goes beyond simple model access by enabling autonomous **Intent Recognition**, **Web Search**, and **Context Compaction**. It seamlessly reuses your existing **Tools, MCP servers, OpenAPI servers, and Skills** from OpenWebUI to create a truly integrated ecosystem.
|
||||||
|
|
||||||
|
- **🧠 Autonomous Intent Recognition**: The Agent independently analyzes user goals to determine the most effective path forward.
|
||||||
|
- **🌐 Smart Web Search**: Built-in capability to trigger web searches autonomously based on task requirements.
|
||||||
|
- **♾️ Infinite Session (Context Compaction)**: Automatically manages long-running conversations by compacting context (summarization + TODO persistence) to maintain project focus.
|
||||||
|
- **🧩 Ecosystem Injection**: Directly reads and leverages your configured **OpenWebUI Tools, MCPs, OpenAPI Servers, and Skills**.
|
||||||
|
- **🎨 Interactive Delivery**: Native support for **HTML Artifacts** and **RichUI** components for real-time visualization and reporting.
|
||||||
|
|
||||||
> [!IMPORTANT]
|
> [!IMPORTANT]
|
||||||
> **Essential Companion**
|
> **Essential Companion**
|
||||||
@@ -14,11 +20,13 @@ This is an advanced Pipe function for [OpenWebUI](https://github.com/open-webui/
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## ✨ v0.9.1: MCP Tool Filtering & Web Search Reliability Fix
|
## ✨ v0.9.1: Autonomous Web Search & Reliability Fix
|
||||||
|
|
||||||
- **🐛 Fixed MCP tool filtering logic**: Resolved a critical issue where configuring `function_name_filter_list` (or selecting specific tools in UI) would cause all tools from that MCP server to be incorrectly hidden due to ID prefix mismatches (`server:mcp:`).
|
- **🌐 Autonomous Web Search**: `web_search` is now always enabled for the Agent (bypassing the UI toggle), leveraging the Copilot SDK's native ability to decide when to search.
|
||||||
- **🌐 Autonomous Web Search**: `web_search` is now always enabled for the agent (bypassing the UI toggle), leveraging the Copilot SDK's native ability to decide when to search.
|
- **🛠️ Terminology Alignment**: Standardized all references to **"Agent"** and **"Context Compaction"** (for Infinite Session) across all languages to better reflect the technical capabilities.
|
||||||
- **🔍 Improved filter stability**: Ensured tool-level whitelists apply reliably without breaking the entire server connection.
|
- **🌐 Language Consistency**: System prompts mandate that Agent output language remains strictly consistent with user input.
|
||||||
|
- **🐛 Fixed MCP Tool Filtering**: Resolved a critical issue where configuring `function_name_filter_list` (or selecting specific tools in UI) would cause all tools from that MCP server to be incorrectly hidden due to ID prefix mismatches (`server:mcp:`).
|
||||||
|
- **🔍 Improved Filter Stability**: Ensured tool-level whitelists apply reliably without breaking the entire server connection.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -36,7 +44,13 @@ This is an advanced Pipe function for [OpenWebUI](https://github.com/open-webui/
|
|||||||
- **Live HTML/JS**: Instantly render and interact with apps, dashboards, or reports generated by the Agent.
|
- **Live HTML/JS**: Instantly render and interact with apps, dashboards, or reports generated by the Agent.
|
||||||
- **Persistent Publishing**: Agents can "publish" generated files (Excel, CSV, docs) to OpenWebUI's file storage, providing permanent download links.
|
- **Persistent Publishing**: Agents can "publish" generated files (Excel, CSV, docs) to OpenWebUI's file storage, providing permanent download links.
|
||||||
- **🌊 UX-First Streaming**: Full support for "Thinking" processes (Chain of Thought), status indicators, and real-time progress bars for long-running tasks.
|
- **🌊 UX-First Streaming**: Full support for "Thinking" processes (Chain of Thought), status indicators, and real-time progress bars for long-running tasks.
|
||||||
- **🧠 Deep Database Integration**: Real-time persistence of TOD·O lists and session metadata ensures your workflow state is always visible in the UI.
|
- **🧠 Deep Database Integration**: Real-time persistence of TODO lists and session metadata ensures your workflow state is always visible in the UI.
|
||||||
|
|
||||||
|
> [!TIP]
|
||||||
|
> **💡 Visualization Pro-Tip**
|
||||||
|
> To get the most out of **HTML Artifacts** and **RichUI**, we highly recommend asking the Agent to install the skill via its GitHub URL:
|
||||||
|
> "Install this skill: https://github.com/nicobailon/visual-explainer".
|
||||||
|
> This skill is specifically optimized for generating high-quality visual components and integrates perfectly with this Pipe.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|||||||
@@ -1,25 +1,36 @@
|
|||||||
# GitHub Copilot SDK 官方管道
|
# GitHub Copilot Official SDK Pipe
|
||||||
|
|
||||||
**作者:** [Fu-Jie](https://github.com/Fu-Jie/openwebui-extensions) | **版本:** 0.9.1 | **项目:** [OpenWebUI Extensions](https://github.com/Fu-Jie/openwebui-extensions) | **许可证:** MIT
|
**作者:** [Fu-Jie](https://github.com/Fu-Jie/openwebui-extensions) | **版本:** 0.9.1 | **项目:** [OpenWebUI Extensions](https://github.com/Fu-Jie/openwebui-extensions) | **许可证:** MIT
|
||||||
|
|
||||||
这是一个用于 [OpenWebUI](https://github.com/open-webui/open-webui) 的高级 Pipe 函数，深度集成了 **GitHub Copilot SDK**。它不仅支持 **GitHub Copilot 官方模型**（如 `gpt-5.2-codex`, `claude-sonnet-4.5`, `gemini-3-pro`, `gpt-5-mini`），还支持 **BYOK (自带 Key)** 模式对接自定义服务商（OpenAI, Anthropic），并具备**严格的用户与会话级工作区隔离**能力，提供统一且安全的 Agent 交互体验。
|
这是一个将 **GitHub Copilot SDK** 深度集成到 **OpenWebUI** 中的强大 Agent SDK 管道。它不仅实现了 SDK 的核心功能，还支持 **智能意图识别**、**自主网页搜索** 与 **自动上下文压缩**，并能够无缝读取 OpenWebUI 已有的配置进行智能注入，让 Agent 能够具备以下能力：
|
||||||
|
|
||||||
|
- **🧠 智能意图识别**：Agent 能自主分析用户任务的深层意图，决定最有效的处理路径。
|
||||||
|
- **🌐 自主网页搜索**：具备独立的网页搜索触发判断力，无需用户手动干预。
|
||||||
|
- **♾️ 自动压缩上下文**：支持 Infinite Session，自动对长对话进行上下文压缩与摘要，确保长期任务跟进。
|
||||||
|
- **🛠️ 全功能 Skill 体系**：完美支持本地自定义 Skill 目录，通过脚本与资源的结合实现真正的功能增强。
|
||||||
|
- **🧩 深度生态复用**：直接复用您在 OpenWebUI 中配置的各种 **工具 (Tools)**、**MCP**、**OpenAPI Server** 和 **技能 (Skills)**。
|
||||||
|
|
||||||
|
为您带来更强、更完整的交互体验。
|
||||||
|
|
||||||
> [!IMPORTANT]
|
> [!IMPORTANT]
|
||||||
> **核心伴侣组件**
|
> **核心伴侣组件**
|
||||||
> 如需启用文件处理与数据分析能力，请务必安装 [GitHub Copilot SDK Files Filter](https://openwebui.com/posts/403a62ee-a596-45e7-be65-fab9cc24dd6)。
|
> 如需启用文件处理与数据分析能力，请务必安装 [GitHub Copilot SDK Files Filter](https://openwebui.com/posts/403a62ee-a596-45e7-be65-fab9cc249dd6)。
|
||||||
>
|
|
||||||
>## ✨ 0.9.1 最新更新：MCP 工具过滤与网页搜索可靠性修复
|
|
||||||
|
|
||||||
- **🐛 修复 MCP 工具过滤逻辑**：解决了在管理员后端配置 `function_name_filter_list`（或在聊天界面勾选特定工具）时，因 ID 前缀（`server:mcp:`）识别逻辑错误导致所选服务器下的全部工具意外失效的问题。
|
|
||||||
- **🌐 自主网页搜索**：`web_search` 工具现已强制对 Agent 开启（绕过 UI 网页搜索开关），充分利用 Copilot 自身具备的搜索判断能力。
|
|
||||||
- **🔍 提升过滤稳定性**：由于修复了 ID 归一化逻辑，现在手动点选或后端配置的工具白名单均能稳定生效，不再会导致整个服务被排除。
|
|
||||||
|
|
||||||
> [!TIP]
|
> [!TIP]
|
||||||
> **BYOK 模式无需订阅**
|
> **BYOK 模式无需订阅**
|
||||||
> 如果您使用自带的 API Key (BYOK 模式对接 OpenAI/Anthropic)，**您不需要 GitHub Copilot 官方订阅**。只有在访问 GitHub 官方模型时才需要订阅。
|
> 如果您使用自带的 API Key (BYOK 模式对接 OpenAI/Anthropic)，**您不需要 GitHub Copilot 官方订阅**。只有在访问 GitHub 官方模型时才需要订阅。
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
## ✨ 0.9.1 最新更新：自主网页搜索与可靠性修复
|
||||||
|
|
||||||
|
- **🌐 强化自主网页搜索**：`web_search` 工具现已强制对 Agent 开启（绕过 UI 网页搜索开关），充分利用 Copilot 自身具备的搜索判断能力。
|
||||||
|
- **🛠️ 术语一致性优化**：全语种同步将“助手”更改为 **"Agent"**，并将“优化会话”统一为 **"压缩上下文"**，更准确地描述 Infinite Session 的技术本质。
|
||||||
|
- **🌐 语言一致性**：内置指令确保 Agent 输出语言与用户输入严格对齐，提供无缝的国际化交互体验。
|
||||||
|
- **🐛 修复 MCP 工具过滤逻辑**：解决了在管理员后端配置 `function_name_filter_list`（或在聊天界面勾选特定工具）时，因 ID 前缀（`server:mcp:`）识别逻辑错误导致工具意外失效的问题。
|
||||||
|
- **🔍 提升过滤稳定性**：修复了工具 ID 归一化逻辑，确保点选的工具白名单在 SDK 会话中精确生效。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
## ✨ 核心能力 (Key Capabilities)
|
## ✨ 核心能力 (Key Capabilities)
|
||||||
|
|
||||||
- **🔑 统一智能体验 (官方 + BYOK)**: 自由切换官方模型与自定义服务商（OpenAI, Anthropic, DeepSeek, xAI），支持 **BYOK (自带 Key)** 模式。
|
- **🔑 统一智能体验 (官方 + BYOK)**: 自由切换官方模型与自定义服务商（OpenAI, Anthropic, DeepSeek, xAI），支持 **BYOK (自带 Key)** 模式。
|
||||||
@@ -28,13 +39,19 @@
|
|||||||
- **原生 MCP**: 高性能直连 Model Context Protocol 服务器。
|
- **原生 MCP**: 高性能直连 Model Context Protocol 服务器。
|
||||||
- **OpenAPI 桥接**: 将任何外部 REST API 一键转换为 Agent 可调用的工具。
|
- **OpenAPI 桥接**: 将任何外部 REST API 一键转换为 Agent 可调用的工具。
|
||||||
- **OpenWebUI 原生桥接**: 零配置接入现有的 OpenWebUI 工具及内置功能（网页搜索、记忆等）。
|
- **OpenWebUI 原生桥接**: 零配置接入现有的 OpenWebUI 工具及内置功能（网页搜索、记忆等）。
|
||||||
- **🧩 OpenWebUI Skills 桥接**: 将简单的 OpenWebUI Markdown 指令转化为包含脚本、模板和数据的强大 SDK 技能文件夹。
|
- **🧩 OpenWebUI Skills 桥接**: 将简单的 OpenWebUI Markdown 指令转化为包含脚本、模板 and 数据的强大 SDK 技能文件夹。
|
||||||
- **♾️ 无限会话管理**: 先进的上下文窗口管理，支持自动“压缩”（摘要提取 + TODO 列表持久化）。支持长达数周的项目跟踪而不会丢失核心上下文。
|
- **♾️ 无限会话管理**: 先进的上下文窗口管理，支持自动“压缩”（摘要提取 + TODO 列表持久化）。支持长达数周的项目跟踪而不会丢失核心上下文。
|
||||||
- **📊 交互式产物与发布**:
|
- **📊 交互式产物与发布**:
|
||||||
- **实时 HTML/JS**: 瞬间渲染并交互 Agent 生成的应用程序、可视化看板或报告。
|
- **实时 HTML/JS**: 瞬间渲染并交互 Agent 生成的应用程序、可视化看板或报告。
|
||||||
- **持久化发布**: Agent 可将生成的产物（Excel, CSV, 文档）发布至 OpenWebUI 文件存储，并在聊天中提供永久下载链接。
|
- **持久化发布**: Agent 可将生成的产物（Excel, CSV, 文档）发布至 OpenWebUI 文件存储，并在聊天中提供永久下载链接。
|
||||||
- **🌊 极致交互体验**: 完整支持深度思考过程 (Thinking Process) 流式渲染、状态指示器以及长任务实时进度条。
|
- **🌊 极致交互体验**: 完整支持深度思考过程 (Thinking Process) 流式渲染、状态指示器以及长任务实时进度条。
|
||||||
- **🧠 深度数据库集成**: TOD·O 列表与会话元数据的实时持久化，确保任务执行状态在 UI 上清晰可见。
|
- **🧠 深度数据库集成**: TODO 列表与会话元数据的实时持久化，确保任务执行状态在 UI 上清晰可见。
|
||||||
|
|
||||||
|
> [!TIP]
|
||||||
|
> **💡 增强渲染建议**
|
||||||
|
> 为了获得最精美的 **HTML Artifacts** 与 **RichUI** 效果，建议在对话中通过提供的 GitHub 链接直接命令 Agent 安装：
|
||||||
|
> “请安装此技能：https://github.com/nicobailon/visual-explainer”。
|
||||||
|
> 该技能专为生成高质量可视化组件而设计，能够与本 Pipe 完美协作。
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -43,162 +60,51 @@
|
|||||||
`GitHub Copilot SDK Files Filter` 是本 Pipe 的配套插件，用于阻止 OpenWebUI 默认 RAG 在 Pipe 接手前抢先处理上传文件。
|
`GitHub Copilot SDK Files Filter` 是本 Pipe 的配套插件，用于阻止 OpenWebUI 默认 RAG 在 Pipe 接手前抢先处理上传文件。
|
||||||
|
|
||||||
- **作用**: 将上传文件移动到 `copilot_files`，让 Pipe 能直接读取原始二进制。
|
- **作用**: 将上传文件移动到 `copilot_files`，让 Pipe 能直接读取原始二进制。
|
||||||
- **必要性**: 若未安装，文件可能被提前解析/向量化，Agent 难以拿到原始文件。
|
- **必要性**: 若未安装，文件可能被提前解析/向量化，Agent 拿到原始文件。
|
||||||
- **v0.1.3 重点**:
|
- **v0.1.3 重点**:
|
||||||
- 修复 BYOK 模型 ID 识别（支持 `github_copilot_official_sdk_pipe.xxx` 前缀匹配）。
|
- 修复 BYOK 模型 ID 识别（支持 `github_copilot_official_sdk_pipe.xxx` 前缀匹配）。
|
||||||
- 新增双通道调试日志（`show_debug_log`）：后端 logger + 浏览器控制台。
|
- 新增双通道调试日志（`show_debug_log`）：后端 logger + 浏览器控制台。
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## ⚙️ 核心配置参数 (Valves)
|
## 🚀 快速开始 (Quick Start)
|
||||||
|
|
||||||
### 1. 管理员配置 (基础设置)
|
1. **安装本插件**: 在 OpenWebUI 管道管理界面添加并启用。
|
||||||
|
2. **安装 [Files Filter](https://openwebui.com/posts/403a62ee-a596-45e7-be65-fab9cc249dd6)** (必须): 以获得文件处理能力。
|
||||||
|
3. **配置凭据**:
|
||||||
|
- **官方模式**: 默认即可。确保环境中安装了 `github-copilot-sdk`。
|
||||||
|
- **BYOK 模式**: 填入 OpenAI/Anthropic/DeepSeek 的 Base URL 与 Key。
|
||||||
|
4. **选择模型**: 在聊天界面选择 `GitHub Copilot Official SDK Pipe` 系列模型。
|
||||||
|
5. **开始对话**: 直接上传文件或发送复杂指令。
|
||||||
|
|
||||||
管理员可在函数设置中定义全局默认行为。
|
---
|
||||||
|
|
||||||
| 参数 | 默认值 | 说明 |
|
## ⚙️ 配置参数 (Configuration Valves)
|
||||||
|
|
||||||
|
| 参数 | 默认值 | 描述 |
|
||||||
| :--- | :--- | :--- |
|
| :--- | :--- | :--- |
|
||||||
| `GH_TOKEN` | `""` | 全局 GitHub Token (需具备 'Copilot Requests' 权限)。 |
|
| `github_token` | - | GitHub Copilot 官方 Token (如果您有官方订阅且不方便本地登录时填入)。 |
|
||||||
| `COPILOTSDK_CONFIG_DIR` | `""` | SDK 配置与会话状态持久化目录 (例如: `/app/backend/data/.copilot`)。 |
|
| `llm_base_url` | - | BYOK 模式的基础 URL。填入后将绕过 GitHub 官方服务。 |
|
||||||
| `ENABLE_OPENWEBUI_TOOLS` | `True` | 启用 OpenWebUI 工具 (包括定义工具和内置工具)。 |
|
| `llm_api_key` | - | BYOK 模式的 API 密钥。 |
|
||||||
| `ENABLE_OPENAPI_SERVER` | `True` | 启用 OpenAPI 工具服务器连接。 |
|
| `llm_model_id` | `gpt-4o` | 使用的模型 ID (官方、BYOK 均适用)。 |
|
||||||
| `ENABLE_MCP_SERVER` | `True` | 启用直接 MCP 客户端连接 (推荐)。 |
|
| `workspace_root` | `./copilot_workspaces` | 所有会话沙盒的根目录。 |
|
||||||
| `ENABLE_OPENWEBUI_SKILLS` | `True` | 开启与 OpenWebUI **工作区 > Skills** 的双向同步桥接。 |
|
| `skills_directory` | `./copilot_skills` | 自定义 SDK 技能文件夹所在的目录。 |
|
||||||
| `OPENWEBUI_SKILLS_SHARED_DIR` | `/app/backend/data/cache/copilot-openwebui-skills` | OpenWebUI skills 转换后的共享缓存目录。 |
|
| `show_status` | `True` | 是否在 UI 显示 Agent 的实时运行状态和思考过程。 |
|
||||||
| `GITHUB_SKILLS_SOURCE_URL` | `""` | 可选 GitHub tree 地址，用于批量导入 skills（例如 anthropic/skills）。 |
|
| `enable_infinite_session` | `True` | 是否开启自动上下文压缩和 TODO 列表持久化。 |
|
||||||
| `DISABLED_SKILLS` | `""` | 逗号分隔的 skill 名称黑名单（如 `docs-writer,webapp-testing`）。 |
|
| `enable_html_artifacts` | `True` | 是否允许 Agent 生成并实时预览 HTML 应用。 |
|
||||||
| `REASONING_EFFORT` | `medium` | 推理强度：low, medium, high。 |
|
| `enable_rich_ui` | `True` | 是否启用进度条和增强型工具调用面板。 |
|
||||||
| `SHOW_THINKING` | `True` | 显示模型推理/思考过程。 |
|
|
||||||
| `INFINITE_SESSION` | `True` | 启用无限会话 (自动上下文压缩)。 |
|
|
||||||
| `MAX_MULTIPLIER` | `1.0` | 最大允许的模型计费倍率 (0x 为仅限免费模型)。 |
|
|
||||||
| `EXCLUDE_KEYWORDS` | `""` | 排除包含这些关键字的模型 (逗号分隔)。 |
|
|
||||||
| `TIMEOUT` | `300` | 每个流数据块的超时时间 (秒)。 |
|
|
||||||
| `BYOK_TYPE` | `openai` | BYOK 服务商类型：`openai`, `anthropic`。 |
|
|
||||||
| `BYOK_BASE_URL` | `""` | BYOK 基础 URL (例如: <https://api.openai.com/v1)。> |
|
|
||||||
| `BYOK_MODELS` | `""` | BYOK 模型列表 (逗号分隔)。留空则从 API 获取。 |
|
|
||||||
| `CUSTOM_ENV_VARS` | `""` | 自定义环境变量 (JSON 格式)。 |
|
|
||||||
| `DEBUG` | `False` | 开启此项以在前端控制台输出详细调试日志。 |
|
|
||||||
|
|
||||||
### 2. 用户配置 (个人覆盖)
|
|
||||||
|
|
||||||
普通用户可在各自的个人设置中根据需要覆盖以下参数。
|
|
||||||
|
|
||||||
| 参数 | 说明 |
|
|
||||||
| :--- | :--- |
|
|
||||||
| `GH_TOKEN` | 使用个人的 GitHub Token。 |
|
|
||||||
| `REASONING_EFFORT` | 个人偏好的推理强度。 |
|
|
||||||
| `SHOW_THINKING` | 显示模型推理/思考过程。 |
|
|
||||||
| `MAX_MULTIPLIER` | 最大允许的模型计费倍率覆盖。 |
|
|
||||||
| `EXCLUDE_KEYWORDS` | 排除包含这些关键字的模型。 |
|
|
||||||
| `ENABLE_OPENWEBUI_SKILLS` | 启用将当前用户可读的全部已启用 OpenWebUI skills 转换并加载为 SDK `SKILL.md` 目录。 |
|
|
||||||
| `GITHUB_SKILLS_SOURCE_URL` | 为当前用户会话设置可选 GitHub tree 地址以批量导入 skills。 |
|
|
||||||
| `DISABLED_SKILLS` | 为当前用户会话禁用指定 skills（逗号分隔）。 |
|
|
||||||
| `BYOK_API_KEY` | 使用个人的 OpenAI/Anthropic API Key。 |
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
### 🌊 细粒度反馈与流畅体验 (Fluid UX)
|
## 🤝 支持 (Support)
|
||||||
|
|
||||||
彻底告别复杂任务执行过程中的“卡顿”感：
|
如果这个插件对你有帮助，欢迎到 [OpenWebUI Extensions](https://github.com/Fu-Jie/openwebui-extensions) 点个 Star，这将是我持续改进的动力，感谢支持。
|
||||||
|
|
||||||
- **🔄 实时状态气泡**: 将 SDK 内部事件（如 `turn_start`, `compaction`, `subagent_started`）直接映射为 OpenWebUI 的状态栏信息。
|
|
||||||
- **🧭 分阶段状态描述增强**: 状态栏会明确显示处理阶段（处理中、技能触发、工具执行、工具完成/失败、发布中、任务完成）。
|
|
||||||
- **⏱️ 长任务心跳提示**: 长时间处理中会周期性显示“仍在处理中（已耗时 X 秒）”，避免用户误判为卡死。
|
|
||||||
- **📈 工具执行进度追踪**: 长耗时工具（如代码分析）会在状态栏实时显示进度百分比及当前子任务描述。
|
|
||||||
- **⚡ 即时响应反馈**: 从响应开始第一秒即显示“助手正在处理您的请求...”，减少等待空窗感。
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
### 🛡️ 智能版本兼容
|
## ⚠️ 故障排除 (Troubleshooting)
|
||||||
|
|
||||||
插件会自动根据您的 OpenWebUI 版本调整功能集：
|
- **工具无法使用?** 请检查是否安装了 `github-copilot-sdk`。
|
||||||
|
- **文件找不到?** 确保已启用配套的 `Files Filter` 插件。
|
||||||
- **v0.8.0+**: 开启 Rich UI、实时状态气泡及集成 HTML 预览。
|
- **BYOK 报错?** 确认 `llm_base_url` 包含协议前缀（如 `https://`）且模型 ID 准确无误。
|
||||||
- **旧版本**: 自动回退至标准 Markdown 代码块模式，确保最大稳定性。
|
- **卡在 "Thinking..."?** 检查后端网络连接，流式传输可能受某些代理拦截。
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 🎯 典型应用场景 (Use Cases)
|
|
||||||
|
|
||||||
- **📁 全自主仓库维护**: Agent 在隔离工作区内自动分析代码、运行测试并应用补丁。
|
|
||||||
- **📊 深度财务数据审计**: 直接通过 Python 加载 Excel/CSV 原始数据（绕过 RAG），生成图表并实时预览。
|
|
||||||
- **📝 长任务项目管理**: 自动拆解复杂任务并持久化 TOD·O 进度，跨会话跟踪执行状态。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## ⭐ 支持与交流 (Support)
|
|
||||||
|
|
||||||
如果这个插件对您有所帮助，请在 [OpenWebUI Extensions](https://github.com/Fu-Jie/openwebui-extensions) 项目上点个 **Star** 💫，这是对我最大的鼓励。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 🚀 安装与配置 (Installation)
|
|
||||||
|
|
||||||
### 1) 导入函数
|
|
||||||
|
|
||||||
1. 打开 OpenWebUI，前往 **工作区** -> **函数**。
|
|
||||||
2. 点击 **+** (创建函数)，完整粘贴 `github_copilot_sdk.py` 的内容。
|
|
||||||
3. 点击保存并确保已启用。
|
|
||||||
|
|
||||||
### 2) 获取 Token (Get Token)
|
|
||||||
|
|
||||||
1. 访问 [GitHub Token 设置](https://github.com/settings/tokens?type=beta)。
|
|
||||||
2. 创建 **Fine-grained token**，授予 **Account permissions** -> **Copilot Requests** 访问权限。
|
|
||||||
3. 将生成的 Token 填入插件的 `GH_TOKEN` 配置项中。
|
|
||||||
|
|
||||||
### 3) 认证配置要求（必填）
|
|
||||||
|
|
||||||
你必须至少配置以下一种凭据：
|
|
||||||
|
|
||||||
- `GH_TOKEN`（GitHub Copilot 官方订阅路径），或
|
|
||||||
- `BYOK_API_KEY`（OpenAI/Anthropic 自带 Key 路径）。
|
|
||||||
|
|
||||||
如果两者都未配置，模型列表将不会出现。
|
|
||||||
|
|
||||||
### 4) 配套插件 (强烈推荐)
|
|
||||||
|
|
||||||
为了获得最佳的文件处理体验，请安装 [GitHub Copilot SDK Files Filter](https://openwebui.com/posts/403a62ee-a596-45e7-be65-fab9cc249dd6)。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### 📤 增强型发布工具与交互式组件
|
|
||||||
|
|
||||||
`publish_file_from_workspace` 现采用更清晰、可落地的交付规范：
|
|
||||||
|
|
||||||
- **Artifacts 模式（`artifacts`，默认）**：返回 `[Preview]` + `[Download]`，并可附带 `html_embed`，在 ```html 代码块中直接渲染。
|
|
||||||
- **Rich UI 模式（`richui`）**：仅返回 `[Preview]` + `[Download]`，由发射器自动触发集成式预览（消息中不输出 iframe 代码块）。
|
|
||||||
- **📄 PDF 安全交付规则**：仅输出 Markdown 链接（可用时为 `[Preview]` + `[Download]`）。**禁止通过 iframe/html 方式嵌入 PDF。**
|
|
||||||
- **⚡ 稳定双通道发布**：在本地与对象存储后端下，保持交互预览与持久下载链接一致可用。
|
|
||||||
- **✅ 状态集成**：通过 OpenWebUI 状态栏实时反馈发布进度与完成状态。
|
|
||||||
- **📘 发布工具指南（GitHub）**：[publish_file_from_workspace 工具指南（中文）](https://github.com/Fu-Jie/openwebui-extensions/blob/main/plugins/pipes/github-copilot-sdk/PUBLISH_FILE_FROM_WORKSPACE_CN.md)
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### 🧩 OpenWebUI Skills 桥接与 `manage_skills` 工具
|
|
||||||
|
|
||||||
SDK 现在具备与 OpenWebUI **工作区 > Skills** 的双向同步能力：
|
|
||||||
|
|
||||||
- **🔄 自动同步**: 每次请求时，前端定义的技能会自动作为 `SKILL.md` 文件夹同步至 SDK 共享缓存，Agent 可直接调用。
|
|
||||||
- **🛠️ `manage_skills` 工具**: 内置专业工具，赋予 Agent (或用户) 绝对的技能管理权。
|
|
||||||
- `list`: 列出所有已安装技能及描述。
|
|
||||||
- `install`: 从 GitHub URL (自动转换归档链接) 或直接从 `.zip`/`.tar.gz` 安装。
|
|
||||||
- `create`: 从当前会话内容创建新技能目录，支持写入 `SKILL.md` 及辅助资源文件 (脚本、模板)。
|
|
||||||
- `edit`: 更新现有技能文件夹。
|
|
||||||
- `delete`: 原子化删除本地目录及关联的数据库条目，防止僵尸技能复活。
|
|
||||||
- **📁 完整的文件夹支持**: 不同于数据库中单文件存储，SDK 会加载技能的**整个目录**。这使得技能可以携带二进制脚本、数据文件或复杂模板。
|
|
||||||
- **🌐 持久化共享缓存**: 技能存储在 `OPENWEBUI_SKILLS_SHARED_DIR/shared/`，跨会话及容器重启持久存在。
|
|
||||||
- **📚 技能完整文档（GitHub）**: [manage_skills 工具指南（中文）](https://github.com/Fu-Jie/openwebui-extensions/blob/main/plugins/pipes/github-copilot-sdk/SKILLS_MANAGER_CN.md) | [Skills Best Practices（中文）](https://github.com/Fu-Jie/openwebui-extensions/blob/main/plugins/pipes/github-copilot-sdk/SKILLS_BEST_PRACTICES_CN.md)
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 📋 常见问题与依赖 (Troubleshooting)
|
|
||||||
|
|
||||||
- **Agent 无法识别文件？**: 请确保已安装并启用了 Files Filter 插件，否则原始文件会被 RAG 干扰。
|
|
||||||
- **看不到状态更新或 TODO 进度条？**: 状态气泡会覆盖处理/工具阶段；而 TODO 进度条仅在 Agent 使用 `update_todo` 工具（通常是复杂任务）时出现。
|
|
||||||
- **依赖安装**: 本管道会自动管理 `github-copilot-sdk` (Python 包) 并优先直接使用内置的二进制 CLI，无需手动干预。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 更新日志 (Changelog)
|
|
||||||
|
|
||||||
完整历史记录请见 GitHub: [OpenWebUI Extensions](https://github.com/Fu-Jie/openwebui-extensions)
|
|
||||||
|
|||||||
@@ -2,7 +2,13 @@
|
|||||||
|
|
||||||
**Author:** [Fu-Jie](https://github.com/Fu-Jie) | **Version:** 0.9.1 | **Project:** [OpenWebUI Extensions](https://github.com/Fu-Jie/openwebui-extensions) | **License:** MIT
|
**Author:** [Fu-Jie](https://github.com/Fu-Jie) | **Version:** 0.9.1 | **Project:** [OpenWebUI Extensions](https://github.com/Fu-Jie/openwebui-extensions) | **License:** MIT
|
||||||
|
|
||||||
This is an advanced Pipe function for [OpenWebUI](https://github.com/open-webui/open-webui) that integrates the official [GitHub Copilot SDK](https://github.com/github/copilot-sdk). It enables you to use **GitHub Copilot models** (e.g., `gpt-5.2-codex`, `claude-sonnet-4.5`,`gemini-3-pro`, `gpt-5-mini`) **AND** your own models via **BYOK** (OpenAI, Anthropic) directly within OpenWebUI, providing a unified agentic experience with **strict User & Chat-level Workspace Isolation**.
|
This is a powerful **GitHub Copilot SDK** Pipe for **OpenWebUI** that provides a unified **Agentic experience**. It goes beyond simple model access by enabling autonomous **Intent Recognition**, **Web Search**, and **Context Compaction**. It seamlessly reuses your existing **Tools, MCP servers, OpenAPI servers, and Skills** from OpenWebUI to create a truly integrated ecosystem.
|
||||||
|
|
||||||
|
- **🧠 Autonomous Intent Recognition**: The Agent independently analyzes user goals to determine the most effective path forward.
|
||||||
|
- **🌐 Smart Web Search**: Built-in capability to trigger web searches autonomously based on task requirements.
|
||||||
|
- **♾️ Infinite Session (Context Compaction)**: Automatically manages long-running conversations by compacting context (summarization + TODO persistence) to maintain project focus.
|
||||||
|
- **🧩 Ecosystem Injection**: Directly reads and leverages your configured **OpenWebUI Tools, MCPs, OpenAPI Servers, and Skills**.
|
||||||
|
- **🎨 Interactive Delivery**: Native support for **HTML Artifacts** and **RichUI** components for real-time visualization and reporting.
|
||||||
|
|
||||||
> [!IMPORTANT]
|
> [!IMPORTANT]
|
||||||
> **Essential Companion**
|
> **Essential Companion**
|
||||||
@@ -14,11 +20,13 @@ This is an advanced Pipe function for [OpenWebUI](https://github.com/open-webui/
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## ✨ v0.9.1: MCP Tool Filtering & Web Search Reliability Fix
|
## ✨ v0.9.1: Autonomous Web Search & Reliability Fix
|
||||||
|
|
||||||
- **🐛 Fixed MCP tool filtering logic**: Resolved a critical issue where configuring `function_name_filter_list` (or selecting specific tools in UI) would cause all tools from that MCP server to be incorrectly hidden due to ID prefix mismatches (`server:mcp:`).
|
- **🌐 Autonomous Web Search**: `web_search` is now always enabled for the Agent (bypassing the UI toggle), leveraging the Copilot SDK's native ability to decide when to search.
|
||||||
- **🌐 Autonomous Web Search**: `web_search` is now always enabled for the agent (bypassing the UI toggle), leveraging the Copilot SDK's native ability to decide when to search.
|
- **🛠️ Terminology Alignment**: Standardized all references to **"Agent"** and **"Context Compaction"** (for Infinite Session) across all languages to better reflect the technical capabilities.
|
||||||
- **🔍 Improved filter stability**: Ensured tool-level whitelists apply reliably without breaking the entire server connection.
|
- **🌐 Language Consistency**: System prompts mandate that Agent output language remains strictly consistent with user input.
|
||||||
|
- **🐛 Fixed MCP Tool Filtering**: Resolved a critical issue where configuring `function_name_filter_list` (or selecting specific tools in UI) would cause all tools from that MCP server to be incorrectly hidden due to ID prefix mismatches (`server:mcp:`).
|
||||||
|
- **🔍 Improved Filter Stability**: Ensured tool-level whitelists apply reliably without breaking the entire server connection.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -36,7 +44,13 @@ This is an advanced Pipe function for [OpenWebUI](https://github.com/open-webui/
|
|||||||
- **Live HTML/JS**: Instantly render and interact with apps, dashboards, or reports generated by the Agent.
|
- **Live HTML/JS**: Instantly render and interact with apps, dashboards, or reports generated by the Agent.
|
||||||
- **Persistent Publishing**: Agents can "publish" generated files (Excel, CSV, docs) to OpenWebUI's file storage, providing permanent download links.
|
- **Persistent Publishing**: Agents can "publish" generated files (Excel, CSV, docs) to OpenWebUI's file storage, providing permanent download links.
|
||||||
- **🌊 UX-First Streaming**: Full support for "Thinking" processes (Chain of Thought), status indicators, and real-time progress bars for long-running tasks.
|
- **🌊 UX-First Streaming**: Full support for "Thinking" processes (Chain of Thought), status indicators, and real-time progress bars for long-running tasks.
|
||||||
- **🧠 Deep Database Integration**: Real-time persistence of TOD·O lists and session metadata ensures your workflow state is always visible in the UI.
|
- **🧠 Deep Database Integration**: Real-time persistence of TODO lists and session metadata ensures your workflow state is always visible in the UI.
|
||||||
|
|
||||||
|
> [!TIP]
|
||||||
|
> **💡 Visualization Pro-Tip**
|
||||||
|
> To get the most out of **HTML Artifacts** and **RichUI**, we highly recommend asking the Agent to install the skill via its GitHub URL:
|
||||||
|
> "Install this skill: https://github.com/nicobailon/visual-explainer".
|
||||||
|
> This skill is specifically optimized for generating high-quality visual components and integrates perfectly with this Pipe.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|||||||
@@ -1,8 +1,16 @@
|
|||||||
# GitHub Copilot SDK 官方管道
|
# GitHub Copilot Official SDK Pipe
|
||||||
|
|
||||||
**作者:** [Fu-Jie](https://github.com/Fu-Jie/openwebui-extensions) | **版本:** 0.9.1 | **项目:** [OpenWebUI Extensions](https://github.com/Fu-Jie/openwebui-extensions) | **许可证:** MIT
|
**作者:** [Fu-Jie](https://github.com/Fu-Jie/openwebui-extensions) | **版本:** 0.9.1 | **项目:** [OpenWebUI Extensions](https://github.com/Fu-Jie/openwebui-extensions) | **许可证:** MIT
|
||||||
|
|
||||||
这是一个用于 [OpenWebUI](https://github.com/open-webui/open-webui) 的高级 Pipe 函数，深度集成了 **GitHub Copilot SDK**。它不仅支持 **GitHub Copilot 官方模型**（如 `gpt-5.2-codex`, `claude-sonnet-4.5`, `gemini-3-pro`, `gpt-5-mini`），还支持 **BYOK (自带 Key)** 模式对接自定义服务商（OpenAI, Anthropic），并具备**严格的用户与会话级工作区隔离**能力，提供统一且安全的 Agent 交互体验。
|
这是一个将 **GitHub Copilot SDK** 深度集成到 **OpenWebUI** 中的强大 Agent SDK 管道。它不仅实现了 SDK 的核心功能，还支持 **智能意图识别**、**自主网页搜索** 与 **自动上下文压缩**，并能够无缝读取 OpenWebUI 已有的配置进行智能注入，让 Agent 能够具备以下能力：
|
||||||
|
|
||||||
|
- **🧠 智能意图识别**：Agent 能自主分析用户任务的深层意图，决定最有效的处理路径。
|
||||||
|
- **🌐 自主网页搜索**：具备独立的网页搜索触发判断力，无需用户手动干预。
|
||||||
|
- **♾️ 自动压缩上下文**：支持 Infinite Session，自动对长对话进行上下文压缩与摘要，确保长期任务跟进。
|
||||||
|
- **🛠️ 全功能 Skill 体系**：完美支持本地自定义 Skill 目录，通过脚本与资源的结合实现真正的功能增强。
|
||||||
|
- **🧩 深度生态复用**：直接复用您在 OpenWebUI 中配置的各种 **工具 (Tools)**、**MCP**、**OpenAPI Server** 和 **技能 (Skills)**。
|
||||||
|
|
||||||
|
为您带来更强、更完整的交互体验。
|
||||||
|
|
||||||
> [!IMPORTANT]
|
> [!IMPORTANT]
|
||||||
> **核心伴侣组件**
|
> **核心伴侣组件**
|
||||||
@@ -13,11 +21,13 @@
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## ✨ 0.9.1 最新更新：MCP 工具过滤与网页搜索可靠性修复
|
## ✨ 0.9.1 最新更新：自主网页搜索与可靠性修复
|
||||||
|
|
||||||
- **🐛 修复 MCP 工具过滤逻辑**：解决了在管理员后端配置 `function_name_filter_list`（或在聊天界面勾选特定工具）时，因 ID 前缀（`server:mcp:`）识别逻辑错误导致所选服务器下的全部工具意外失效的问题。
|
- **🌐 强化自主网页搜索**：`web_search` 工具现已强制对 Agent 开启（绕过 UI 网页搜索开关），充分利用 Copilot 自身具备的搜索判断能力。
|
||||||
- **🌐 自主网页搜索**：`web_search` 工具现已强制对 Agent 开启（绕过 UI 网页搜索开关），充分利用 Copilot 自身具备的搜索判断能力。
|
- **🛠️ 术语一致性优化**：全语种同步将“助手”更改为 **"Agent"**，并将“优化会话”统一为 **"压缩上下文"**，更准确地描述 Infinite Session 的技术本质。
|
||||||
- **🔍 提升过滤稳定性**：由于修复了 ID 归一化逻辑，现在手动点选或后端配置的工具白名单均能稳定生效，不再会导致整个服务被排除。
|
- **🌐 语言一致性**：内置指令确保 Agent 输出语言与用户输入严格对齐，提供无缝的国际化交互体验。
|
||||||
|
- **🐛 修复 MCP 工具过滤逻辑**：解决了在管理员后端配置 `function_name_filter_list`（或在聊天界面勾选特定工具）时，因 ID 前缀（`server:mcp:`）识别逻辑错误导致工具意外失效的问题。
|
||||||
|
- **🔍 提升过滤稳定性**：修复了工具 ID 归一化逻辑，确保点选的工具白名单在 SDK 会话中精确生效。
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -29,13 +39,19 @@
|
|||||||
- **原生 MCP**: 高性能直连 Model Context Protocol 服务器。
|
- **原生 MCP**: 高性能直连 Model Context Protocol 服务器。
|
||||||
- **OpenAPI 桥接**: 将任何外部 REST API 一键转换为 Agent 可调用的工具。
|
- **OpenAPI 桥接**: 将任何外部 REST API 一键转换为 Agent 可调用的工具。
|
||||||
- **OpenWebUI 原生桥接**: 零配置接入现有的 OpenWebUI 工具及内置功能（网页搜索、记忆等）。
|
- **OpenWebUI 原生桥接**: 零配置接入现有的 OpenWebUI 工具及内置功能（网页搜索、记忆等）。
|
||||||
- **🧩 OpenWebUI Skills 桥接**: 将简单的 OpenWebUI Markdown 指令转化为包含脚本、模板和数据的强大 SDK 技能文件夹。
|
- **🧩 OpenWebUI Skills 桥接**: 将简单的 OpenWebUI Markdown 指令转化为包含脚本、模板 and 数据的强大 SDK 技能文件夹。
|
||||||
- **♾️ 无限会话管理**: 先进的上下文窗口管理，支持自动“压缩”（摘要提取 + TODO 列表持久化）。支持长达数周的项目跟踪而不会丢失核心上下文。
|
- **♾️ 无限会话管理**: 先进的上下文窗口管理，支持自动“压缩”（摘要提取 + TODO 列表持久化）。支持长达数周的项目跟踪而不会丢失核心上下文。
|
||||||
- **📊 交互式产物与发布**:
|
- **📊 交互式产物与发布**:
|
||||||
- **实时 HTML/JS**: 瞬间渲染并交互 Agent 生成的应用程序、可视化看板或报告。
|
- **实时 HTML/JS**: 瞬间渲染并交互 Agent 生成的应用程序、可视化看板或报告。
|
||||||
- **持久化发布**: Agent 可将生成的产物（Excel, CSV, 文档）发布至 OpenWebUI 文件存储，并在聊天中提供永久下载链接。
|
- **持久化发布**: Agent 可将生成的产物（Excel, CSV, 文档）发布至 OpenWebUI 文件存储，并在聊天中提供永久下载链接。
|
||||||
- **🌊 极致交互体验**: 完整支持深度思考过程 (Thinking Process) 流式渲染、状态指示器以及长任务实时进度条。
|
- **🌊 极致交互体验**: 完整支持深度思考过程 (Thinking Process) 流式渲染、状态指示器以及长任务实时进度条。
|
||||||
- **🧠 深度数据库集成**: TOD·O 列表与会话元数据的实时持久化，确保任务执行状态在 UI 上清晰可见。
|
- **🧠 深度数据库集成**: TODO 列表与会话元数据的实时持久化，确保任务执行状态在 UI 上清晰可见。
|
||||||
|
|
||||||
|
> [!TIP]
|
||||||
|
> **💡 增强渲染建议**
|
||||||
|
> 为了获得最精美的 **HTML Artifacts** 与 **RichUI** 效果，建议在对话中通过提供的 GitHub 链接直接命令 Agent 安装：
|
||||||
|
> “请安装此技能：https://github.com/nicobailon/visual-explainer”。
|
||||||
|
> 该技能专为生成高质量可视化组件而设计，能够与本 Pipe 完美协作。
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -44,162 +60,51 @@
|
|||||||
`GitHub Copilot SDK Files Filter` 是本 Pipe 的配套插件，用于阻止 OpenWebUI 默认 RAG 在 Pipe 接手前抢先处理上传文件。
|
`GitHub Copilot SDK Files Filter` 是本 Pipe 的配套插件，用于阻止 OpenWebUI 默认 RAG 在 Pipe 接手前抢先处理上传文件。
|
||||||
|
|
||||||
- **作用**: 将上传文件移动到 `copilot_files`，让 Pipe 能直接读取原始二进制。
|
- **作用**: 将上传文件移动到 `copilot_files`，让 Pipe 能直接读取原始二进制。
|
||||||
- **必要性**: 若未安装，文件可能被提前解析/向量化，Agent 难以拿到原始文件。
|
- **必要性**: 若未安装，文件可能被提前解析/向量化，Agent 拿到原始文件。
|
||||||
- **v0.1.3 重点**:
|
- **v0.1.3 重点**:
|
||||||
- 修复 BYOK 模型 ID 识别（支持 `github_copilot_official_sdk_pipe.xxx` 前缀匹配）。
|
- 修复 BYOK 模型 ID 识别（支持 `github_copilot_official_sdk_pipe.xxx` 前缀匹配）。
|
||||||
- 新增双通道调试日志（`show_debug_log`）：后端 logger + 浏览器控制台。
|
- 新增双通道调试日志（`show_debug_log`）：后端 logger + 浏览器控制台。
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## ⚙️ 核心配置参数 (Valves)
|
## 🚀 快速开始 (Quick Start)
|
||||||
|
|
||||||
### 1. 管理员配置 (基础设置)
|
1. **安装本插件**: 在 OpenWebUI 管道管理界面添加并启用。
|
||||||
|
2. **安装 [Files Filter](https://openwebui.com/posts/403a62ee-a596-45e7-be65-fab9cc249dd6)** (必须): 以获得文件处理能力。
|
||||||
|
3. **配置凭据**:
|
||||||
|
- **官方模式**: 默认即可。确保环境中安装了 `github-copilot-sdk`。
|
||||||
|
- **BYOK 模式**: 填入 OpenAI/Anthropic/DeepSeek 的 Base URL 与 Key。
|
||||||
|
4. **选择模型**: 在聊天界面选择 `GitHub Copilot Official SDK Pipe` 系列模型。
|
||||||
|
5. **开始对话**: 直接上传文件或发送复杂指令。
|
||||||
|
|
||||||
管理员可在函数设置中定义全局默认行为。
|
---
|
||||||
|
|
||||||
| 参数 | 默认值 | 说明 |
|
## ⚙️ 配置参数 (Configuration Valves)
|
||||||
|
|
||||||
|
| 参数 | 默认值 | 描述 |
|
||||||
| :--- | :--- | :--- |
|
| :--- | :--- | :--- |
|
||||||
| `GH_TOKEN` | `""` | 全局 GitHub Token (需具备 'Copilot Requests' 权限)。 |
|
| `github_token` | - | GitHub Copilot 官方 Token (如果您有官方订阅且不方便本地登录时填入)。 |
|
||||||
| `COPILOTSDK_CONFIG_DIR` | `""` | SDK 配置与会话状态持久化目录 (例如: `/app/backend/data/.copilot`)。 |
|
| `llm_base_url` | - | BYOK 模式的基础 URL。填入后将绕过 GitHub 官方服务。 |
|
||||||
| `ENABLE_OPENWEBUI_TOOLS` | `True` | 启用 OpenWebUI 工具 (包括定义工具和内置工具)。 |
|
| `llm_api_key` | - | BYOK 模式的 API 密钥。 |
|
||||||
| `ENABLE_OPENAPI_SERVER` | `True` | 启用 OpenAPI 工具服务器连接。 |
|
| `llm_model_id` | `gpt-4o` | 使用的模型 ID (官方、BYOK 均适用)。 |
|
||||||
| `ENABLE_MCP_SERVER` | `True` | 启用直接 MCP 客户端连接 (推荐)。 |
|
| `workspace_root` | `./copilot_workspaces` | 所有会话沙盒的根目录。 |
|
||||||
| `ENABLE_OPENWEBUI_SKILLS` | `True` | 开启与 OpenWebUI **工作区 > Skills** 的双向同步桥接。 |
|
| `skills_directory` | `./copilot_skills` | 自定义 SDK 技能文件夹所在的目录。 |
|
||||||
| `OPENWEBUI_SKILLS_SHARED_DIR` | `/app/backend/data/cache/copilot-openwebui-skills` | OpenWebUI skills 转换后的共享缓存目录。 |
|
| `show_status` | `True` | 是否在 UI 显示 Agent 的实时运行状态和思考过程。 |
|
||||||
| `GITHUB_SKILLS_SOURCE_URL` | `""` | 可选 GitHub tree 地址，用于批量导入 skills（例如 anthropic/skills）。 |
|
| `enable_infinite_session` | `True` | 是否开启自动上下文压缩和 TODO 列表持久化。 |
|
||||||
| `DISABLED_SKILLS` | `""` | 逗号分隔的 skill 名称黑名单（如 `docs-writer,webapp-testing`）。 |
|
| `enable_html_artifacts` | `True` | 是否允许 Agent 生成并实时预览 HTML 应用。 |
|
||||||
| `REASONING_EFFORT` | `medium` | 推理强度：low, medium, high。 |
|
| `enable_rich_ui` | `True` | 是否启用进度条和增强型工具调用面板。 |
|
||||||
| `SHOW_THINKING` | `True` | 显示模型推理/思考过程。 |
|
|
||||||
| `INFINITE_SESSION` | `True` | 启用无限会话 (自动上下文压缩)。 |
|
|
||||||
| `MAX_MULTIPLIER` | `1.0` | 最大允许的模型计费倍率 (0x 为仅限免费模型)。 |
|
|
||||||
| `EXCLUDE_KEYWORDS` | `""` | 排除包含这些关键字的模型 (逗号分隔)。 |
|
|
||||||
| `TIMEOUT` | `300` | 每个流数据块的超时时间 (秒)。 |
|
|
||||||
| `BYOK_TYPE` | `openai` | BYOK 服务商类型：`openai`, `anthropic`。 |
|
|
||||||
| `BYOK_BASE_URL` | `""` | BYOK 基础 URL (例如: <https://api.openai.com/v1)。> |
|
|
||||||
| `BYOK_MODELS` | `""` | BYOK 模型列表 (逗号分隔)。留空则从 API 获取。 |
|
|
||||||
| `CUSTOM_ENV_VARS` | `""` | 自定义环境变量 (JSON 格式)。 |
|
|
||||||
| `DEBUG` | `False` | 开启此项以在前端控制台输出详细调试日志。 |
|
|
||||||
|
|
||||||
### 2. 用户配置 (个人覆盖)
|
|
||||||
|
|
||||||
普通用户可在各自的个人设置中根据需要覆盖以下参数。
|
|
||||||
|
|
||||||
| 参数 | 说明 |
|
|
||||||
| :--- | :--- |
|
|
||||||
| `GH_TOKEN` | 使用个人的 GitHub Token。 |
|
|
||||||
| `REASONING_EFFORT` | 个人偏好的推理强度。 |
|
|
||||||
| `SHOW_THINKING` | 显示模型推理/思考过程。 |
|
|
||||||
| `MAX_MULTIPLIER` | 最大允许的模型计费倍率覆盖。 |
|
|
||||||
| `EXCLUDE_KEYWORDS` | 排除包含这些关键字的模型。 |
|
|
||||||
| `ENABLE_OPENWEBUI_SKILLS` | 启用将当前用户可读的全部已启用 OpenWebUI skills 转换并加载为 SDK `SKILL.md` 目录。 |
|
|
||||||
| `GITHUB_SKILLS_SOURCE_URL` | 为当前用户会话设置可选 GitHub tree 地址以批量导入 skills。 |
|
|
||||||
| `DISABLED_SKILLS` | 为当前用户会话禁用指定 skills（逗号分隔）。 |
|
|
||||||
| `BYOK_API_KEY` | 使用个人的 OpenAI/Anthropic API Key。 |
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
### 🌊 细粒度反馈与流畅体验 (Fluid UX)
|
## 🤝 支持 (Support)
|
||||||
|
|
||||||
彻底告别复杂任务执行过程中的“卡顿”感：
|
如果这个插件对你有帮助，欢迎到 [OpenWebUI Extensions](https://github.com/Fu-Jie/openwebui-extensions) 点个 Star，这将是我持续改进的动力，感谢支持。
|
||||||
|
|
||||||
- **🔄 实时状态气泡**: 将 SDK 内部事件（如 `turn_start`, `compaction`, `subagent_started`）直接映射为 OpenWebUI 的状态栏信息。
|
|
||||||
- **🧭 分阶段状态描述增强**: 状态栏会明确显示处理阶段（处理中、技能触发、工具执行、工具完成/失败、发布中、任务完成）。
|
|
||||||
- **⏱️ 长任务心跳提示**: 长时间处理中会周期性显示“仍在处理中（已耗时 X 秒）”，避免用户误判为卡死。
|
|
||||||
- **📈 工具执行进度追踪**: 长耗时工具（如代码分析）会在状态栏实时显示进度百分比及当前子任务描述。
|
|
||||||
- **⚡ 即时响应反馈**: 从响应开始第一秒即显示“助手正在处理您的请求...”，减少等待空窗感。
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
### 🛡️ 智能版本兼容
|
## ⚠️ 故障排除 (Troubleshooting)
|
||||||
|
|
||||||
插件会自动根据您的 OpenWebUI 版本调整功能集：
|
- **工具无法使用?** 请检查是否安装了 `github-copilot-sdk`。
|
||||||
|
- **文件找不到?** 确保已启用配套的 `Files Filter` 插件。
|
||||||
- **v0.8.0+**: 开启 Rich UI、实时状态气泡及集成 HTML 预览。
|
- **BYOK 报错?** 确认 `llm_base_url` 包含协议前缀（如 `https://`）且模型 ID 准确无误。
|
||||||
- **旧版本**: 自动回退至标准 Markdown 代码块模式，确保最大稳定性。
|
- **卡在 "Thinking..."?** 检查后端网络连接，流式传输可能受某些代理拦截。
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 🎯 典型应用场景 (Use Cases)
|
|
||||||
|
|
||||||
- **📁 全自主仓库维护**: Agent 在隔离工作区内自动分析代码、运行测试并应用补丁。
|
|
||||||
- **📊 深度财务数据审计**: 直接通过 Python 加载 Excel/CSV 原始数据（绕过 RAG），生成图表并实时预览。
|
|
||||||
- **📝 长任务项目管理**: 自动拆解复杂任务并持久化 TOD·O 进度，跨会话跟踪执行状态。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## ⭐ 支持与交流 (Support)
|
|
||||||
|
|
||||||
如果这个插件对您有所帮助，请在 [OpenWebUI Extensions](https://github.com/Fu-Jie/openwebui-extensions) 项目上点个 **Star** 💫，这是对我最大的鼓励。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 🚀 安装与配置 (Installation)
|
|
||||||
|
|
||||||
### 1) 导入函数
|
|
||||||
|
|
||||||
1. 打开 OpenWebUI，前往 **工作区** -> **函数**。
|
|
||||||
2. 点击 **+** (创建函数)，完整粘贴 `github_copilot_sdk.py` 的内容。
|
|
||||||
3. 点击保存并确保已启用。
|
|
||||||
|
|
||||||
### 2) 获取 Token (Get Token)
|
|
||||||
|
|
||||||
1. 访问 [GitHub Token 设置](https://github.com/settings/tokens?type=beta)。
|
|
||||||
2. 创建 **Fine-grained token**，授予 **Account permissions** -> **Copilot Requests** 访问权限。
|
|
||||||
3. 将生成的 Token 填入插件的 `GH_TOKEN` 配置项中。
|
|
||||||
|
|
||||||
### 3) 认证配置要求（必填）
|
|
||||||
|
|
||||||
你必须至少配置以下一种凭据：
|
|
||||||
|
|
||||||
- `GH_TOKEN`（GitHub Copilot 官方订阅路径），或
|
|
||||||
- `BYOK_API_KEY`（OpenAI/Anthropic 自带 Key 路径）。
|
|
||||||
|
|
||||||
如果两者都未配置，模型列表将不会出现。
|
|
||||||
|
|
||||||
### 4) 配套插件 (强烈推荐)
|
|
||||||
|
|
||||||
为了获得最佳的文件处理体验，请安装 [GitHub Copilot SDK Files Filter](https://openwebui.com/posts/403a62ee-a596-45e7-be65-fab9cc249dd6)。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### 📤 增强型发布工具与交互式组件
|
|
||||||
|
|
||||||
`publish_file_from_workspace` 现采用更清晰、可落地的交付规范：
|
|
||||||
|
|
||||||
- **Artifacts 模式（`artifacts`，默认）**：返回 `[Preview]` + `[Download]`，并可附带 `html_embed`，在 ```html 代码块中直接渲染。
|
|
||||||
- **Rich UI 模式（`richui`）**：仅返回 `[Preview]` + `[Download]`，由发射器自动触发集成式预览（消息中不输出 iframe 代码块）。
|
|
||||||
- **📄 PDF 安全交付规则**：仅输出 Markdown 链接（可用时为 `[Preview]` + `[Download]`）。**禁止通过 iframe/html 方式嵌入 PDF。**
|
|
||||||
- **⚡ 稳定双通道发布**：在本地与对象存储后端下，保持交互预览与持久下载链接一致可用。
|
|
||||||
- **✅ 状态集成**：通过 OpenWebUI 状态栏实时反馈发布进度与完成状态。
|
|
||||||
- **📘 发布工具指南（GitHub）**：[publish_file_from_workspace 工具指南（中文）](https://github.com/Fu-Jie/openwebui-extensions/blob/main/plugins/pipes/github-copilot-sdk/PUBLISH_FILE_FROM_WORKSPACE_CN.md)
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### 🧩 OpenWebUI Skills 桥接与 `manage_skills` 工具
|
|
||||||
|
|
||||||
SDK 现在具备与 OpenWebUI **工作区 > Skills** 的双向同步能力：
|
|
||||||
|
|
||||||
- **🔄 自动同步**: 每次请求时，前端定义的技能会自动作为 `SKILL.md` 文件夹同步至 SDK 共享缓存，Agent 可直接调用。
|
|
||||||
- **🛠️ `manage_skills` 工具**: 内置专业工具，赋予 Agent (或用户) 绝对的技能管理权。
|
|
||||||
- `list`: 列出所有已安装技能及描述。
|
|
||||||
- `install`: 从 GitHub URL (自动转换归档链接) 或直接从 `.zip`/`.tar.gz` 安装。
|
|
||||||
- `create`: 从当前会话内容创建新技能目录，支持写入 `SKILL.md` 及辅助资源文件 (脚本、模板)。
|
|
||||||
- `edit`: 更新现有技能文件夹。
|
|
||||||
- `delete`: 原子化删除本地目录及关联的数据库条目，防止僵尸技能复活。
|
|
||||||
- **📁 完整的文件夹支持**: 不同于数据库中单文件存储，SDK 会加载技能的**整个目录**。这使得技能可以携带二进制脚本、数据文件或复杂模板。
|
|
||||||
- **🌐 持久化共享缓存**: 技能存储在 `OPENWEBUI_SKILLS_SHARED_DIR/shared/`，跨会话及容器重启持久存在。
|
|
||||||
- **📚 技能完整文档（GitHub）**: [manage_skills 工具指南（中文）](https://github.com/Fu-Jie/openwebui-extensions/blob/main/plugins/pipes/github-copilot-sdk/SKILLS_MANAGER_CN.md) | [Skills Best Practices（中文）](https://github.com/Fu-Jie/openwebui-extensions/blob/main/plugins/pipes/github-copilot-sdk/SKILLS_BEST_PRACTICES_CN.md)
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 📋 常见问题与依赖 (Troubleshooting)
|
|
||||||
|
|
||||||
- **Agent 无法识别文件？**: 请确保已安装并启用了 Files Filter 插件，否则原始文件会被 RAG 干扰。
|
|
||||||
- **看不到状态更新或 TODO 进度条？**: 状态气泡会覆盖处理/工具阶段；而 TODO 进度条仅在 Agent 使用 `update_todo` 工具（通常是复杂任务）时出现。
|
|
||||||
- **依赖安装**: 本管道会自动管理 `github-copilot-sdk` (Python 包) 并优先直接使用内置的二进制 CLI，无需手动干预。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 更新日志 (Changelog)
|
|
||||||
|
|
||||||
完整历史记录请见 GitHub: [OpenWebUI Extensions](https://github.com/Fu-Jie/openwebui-extensions)
|
|
||||||
|
|||||||
@@ -4,7 +4,7 @@ author: Fu-Jie
|
|||||||
author_url: https://github.com/Fu-Jie/openwebui-extensions
|
author_url: https://github.com/Fu-Jie/openwebui-extensions
|
||||||
funding_url: https://github.com/open-webui
|
funding_url: https://github.com/open-webui
|
||||||
openwebui_id: ce96f7b4-12fc-4ac3-9a01-875713e69359
|
openwebui_id: ce96f7b4-12fc-4ac3-9a01-875713e69359
|
||||||
description: Integrate GitHub Copilot SDK. Supports dynamic models, multi-turn conversation, streaming, multimodal input, infinite sessions, bidirectional OpenWebUI Skills bridge, and manage_skills tool.
|
description: A powerful Agent SDK integration for OpenWebUI. It deeply bridges GitHub Copilot SDK with OpenWebUI's ecosystem, enabling the Agent to autonomously perform intent recognition, web search, and context compaction. It seamlessly reuses your existing Tools, MCP servers, OpenAPI servers, and Skills for a professional, full-featured experience.
|
||||||
version: 0.9.1
|
version: 0.9.1
|
||||||
requirements: github-copilot-sdk==0.1.25
|
requirements: github-copilot-sdk==0.1.25
|
||||||
"""
|
"""
|
||||||
@@ -634,8 +634,8 @@ class Pipe:
|
|||||||
"id-ID": {
|
"id-ID": {
|
||||||
"status_conn_est": "Koneksi terjalin, menunggu respons...",
|
"status_conn_est": "Koneksi terjalin, menunggu respons...",
|
||||||
"status_reasoning_inj": "Upaya penalaran dimasukkan: {effort}",
|
"status_reasoning_inj": "Upaya penalaran dimasukkan: {effort}",
|
||||||
"status_assistant_start": "Agén mulai berpikir...",
|
"status_assistant_start": "Agen mulai berpikir...",
|
||||||
"status_assistant_processing": "Agén sedang memproses permintaan Anda...",
|
"status_assistant_processing": "Agen sedang memproses permintaan Anda...",
|
||||||
"status_skill_invoked": "Keahlian terdeteksi và digunakan: {skill}",
|
"status_skill_invoked": "Keahlian terdeteksi và digunakan: {skill}",
|
||||||
"status_compaction_start": "Memadatkan konteks sesi...",
|
"status_compaction_start": "Memadatkan konteks sesi...",
|
||||||
"status_compaction_complete": "Pemadatan konteks selesai.",
|
"status_compaction_complete": "Pemadatan konteks selesai.",
|
||||||
|
|||||||
32
plugins/pipes/github-copilot-sdk/v0.9.1.md
Normal file
32
plugins/pipes/github-copilot-sdk/v0.9.1.md
Normal file
@@ -0,0 +1,32 @@
|
|||||||
|
# v0.9.1 Release Notes
|
||||||
|
|
||||||
|
## Overview
|
||||||
|
This release upgrades the GitHub Copilot SDK Pipe into a more autonomous and ecosystem-aware Agent integration for OpenWebUI, with stronger web-search behavior, clearer terminology, and improved tool-filtering reliability.
|
||||||
|
|
||||||
|
## New Features
|
||||||
|
- Prioritize autonomous web search by always enabling `web_search` for Agent-side decision making.
|
||||||
|
- Add explicit ecosystem injection messaging for OpenWebUI Tools, MCP servers, OpenAPI servers, and Skills.
|
||||||
|
- Improve interactive delivery guidance for HTML Artifacts and RichUI workflows.
|
||||||
|
- Add recommendation for installing the Visual Explainer skill for high-quality visual rendering.
|
||||||
|
- Restore top-level onboarding callouts (`IMPORTANT` + `TIP`) in plugin docs for companion dependency and BYOK guidance.
|
||||||
|
- Refresh root README and root README_CN feature highlights to reflect the Agent-focused v0.9.1 positioning.
|
||||||
|
- Add/align docs mirrors so plugin README and `docs/plugins/pipes/` content stay synchronized.
|
||||||
|
|
||||||
|
## Bug Fixes
|
||||||
|
- Fix MCP tool filtering reliability when `function_name_filter_list` or UI-selected tool scopes are used.
|
||||||
|
- Normalize tool ID handling to avoid accidental filtering failures with `server:mcp:` prefixes.
|
||||||
|
- Standardize TODO terminology presentation to avoid malformed text artifacts.
|
||||||
|
- Remove duplicated language-consistency statements in both English and Chinese docs while keeping the intended single statement.
|
||||||
|
- Fix malformed CN Visual Explainer installation text formatting.
|
||||||
|
- Correct Indonesian status wording (`Agén` -> `Agen`) for better locale consistency.
|
||||||
|
|
||||||
|
## Migration Notes
|
||||||
|
- No breaking changes in Valve keys or runtime behavior are introduced in this release.
|
||||||
|
- Existing deployments can upgrade directly to `0.9.1`.
|
||||||
|
|
||||||
|
## Companion Plugins
|
||||||
|
- GitHub Copilot SDK Files Filter remains the required companion for raw-file handling before RAG interception.
|
||||||
|
|
||||||
|
## Documentation Scope
|
||||||
|
- Updated plugin docs: `README.md`, `README_CN.md`, and mirrored docs pages (`github-copilot-sdk.md`, `github-copilot-sdk.zh.md`).
|
||||||
|
- Updated project-level highlights in root `README.md` and `README_CN.md`.
|
||||||
32
plugins/pipes/github-copilot-sdk/v0.9.1_CN.md
Normal file
32
plugins/pipes/github-copilot-sdk/v0.9.1_CN.md
Normal file
@@ -0,0 +1,32 @@
|
|||||||
|
# v0.9.1 版本发布说明
|
||||||
|
|
||||||
|
## 概览
|
||||||
|
本次版本将 GitHub Copilot SDK Pipe 升级为更自主、与 OpenWebUI 生态深度融合的 Agent 集成方案，重点强化了网页搜索行为、术语一致性与工具过滤稳定性。
|
||||||
|
|
||||||
|
## 新功能
|
||||||
|
- 将 `web_search` 设为 Agent 侧始终可用，优先发挥自主网页搜索能力。
|
||||||
|
- 明确强调对 OpenWebUI 工具、MCP、OpenAPI Server 与 Skills 的生态注入与复用能力。
|
||||||
|
- 完善 HTML Artifacts 与 RichUI 的交互交付说明。
|
||||||
|
- 增加 Visual Explainer 技能安装建议，用于提升可视化渲染质量。
|
||||||
|
- 恢复插件文档顶部引导区块（`IMPORTANT` + `TIP`），强化配套插件与 BYOK 使用指引。
|
||||||
|
- 更新根 README 与 README_CN 的功能亮点文案，使其与 v0.9.1 的 Agent 定位保持一致。
|
||||||
|
- 同步并对齐插件 README 与 `docs/plugins/pipes/` 镜像文档内容。
|
||||||
|
|
||||||
|
## 问题修复
|
||||||
|
- 修复在使用 `function_name_filter_list` 或聊天界面选择工具时的 MCP 工具过滤失效问题。
|
||||||
|
- 修复 `server:mcp:` 前缀场景下的工具 ID 归一化逻辑，避免误过滤。
|
||||||
|
- 统一 TODO 术语展示，消除异常字符导致的显示问题。
|
||||||
|
- 去除中英文文档中的“语言一致性”重复条目，保留单一有效描述。
|
||||||
|
- 修复中文文档中 Visual Explainer 安装示例的格式异常。
|
||||||
|
- 修正印尼语状态文案（`Agén` -> `Agen`），提升多语言一致性。
|
||||||
|
|
||||||
|
## 迁移说明
|
||||||
|
- 本版本未引入 Valve 配置键或运行时行为的破坏性变更。
|
||||||
|
- 现有部署可直接升级到 `0.9.1`。
|
||||||
|
|
||||||
|
## 配套插件
|
||||||
|
- GitHub Copilot SDK Files Filter 仍为必备配套插件，用于在 RAG 预处理前保留原始文件访问能力。
|
||||||
|
|
||||||
|
## 文档覆盖范围
|
||||||
|
- 已更新插件文档：`README.md`、`README_CN.md` 及其镜像页（`github-copilot-sdk.md`、`github-copilot-sdk.zh.md`）。
|
||||||
|
- 已更新项目根文档亮点：`README.md` 与 `README_CN.md`。
|
||||||
Reference in New Issue
Block a user