# 🚀 GitHub Copilot SDK Pipe v0.7.0: 原生工具 UI 与零配置 CLI 🛠️

**GitHub Copilot SDK Pipe v0.7.0** — 一次重大的基建与体验升级。本次更新彻底告别了手动管理 CLI 的繁琐，全面适配 OpenWebUI 原生工具调用 UI，并确保了与 OpenWebUI 最新版本的无缝兼容。

---

## 📦 快速安装

- **GitHub Copilot SDK (Pipe 插件)**: [安装 v0.7.0](https://openwebui.com/posts/ce96f7b4-12fc-4ac3-9a01-875713e69359)
- **GitHub Copilot SDK (Filter 插件)**: [安装 v0.1.2](https://openwebui.com/posts/403a62ee-a596-45e7-be65-fab9cc249dd6)

---

## 🚀 v0.7.0 更新内容

### 1. 零维护 CLI 集成

这是最重大的基建变更：您不再需要担心 CLI 版本或后台下载失败。

| 之前 (v0.6.x) | 之后 (v0.7.0) |
| :--- | :--- |
| 通过后台 `curl \| bash` 安装 | 直接内置在 `github-copilot-sdk` pip 包中 |
| SDK 与 CLI 版本可能不匹配 | 版本始终自动保持同步 |
| 在受限网络环境下容易失败 | 只要能 `pip install` 就能工作 |

**工作原理**：当您安装 `github-copilot-sdk==0.1.25` 时，匹配的 `copilot-cli v0.0.411` 已包含在内。插件会自动发现路径并将其注入环境——实现“零配置”运行。

### 2. OpenWebUI 原生工具调用 UI

来自 Copilot Agent 的工具调用现在使用 **OpenWebUI 内置的工具调用 UI** 进行渲染：

- **原生展示**：工具执行状态直接集成在聊天界面中。
- **思维链可视化**：模型的思考过程（Chain of Thought）使用标准的折叠 UI 展示。
- **一致体验**：视觉风格与 OpenWebUI 整体环境完美融合。

### 3. OpenWebUI v0.8.0+ 兼容性修复 (Bug Fix)

彻底解决了用户升级到 OpenWebUI v0.8.0 或更高版本后出现的 **"Error getting file content"** 下载失败问题。

- **问题核心**：旧版本使用相对路径注册发布文件，OpenWebUI v0.8.0+ 无法正确识别。
- **修复方案**：切换为 **绝对路径注册**，恢复了将 Agent 生成的产物正常下载到本地的能力。

### 4. 全面的多语言支持 (i18n)

对状态消息和 UI 提示进行了 **11 国语言** 的原生本地化支持：
*包括：简体中文、繁体中文（港/台）、英语、日语、韩语、法语、德语、西班牙语、意大利语、俄语、越南语和印尼语。*

### 5. 推理状态与体验优化

- **智能状态显示**：`Reasoning Effort injected` 状态仅在原生推理模型（如 `o3`, `claude-3.7`）上显示。
- **纯净 UI**：移除了 BYOK 和标准模型中冗余的调试/状态噪音。
- **架构精简**：重构了初始化逻辑，移除了陈旧的安装代码，提供更稳健的“一键式”体验。

---

## 🛠️ 核心能力

| 特性 | 描述 |
| :--- | :--- |
| **通用工具协议** | 原生支持 **MCP**、**OpenAPI** 以及 **OpenWebUI 内置工具**。 |
| **原生工具 UI** | 完美适配 OpenWebUI 内置的工具调用渲染。 |
| **物理隔离工作区** | 为每个会话提供严格的沙箱环境，保护数据隐私与安全。 |
| **工作区产物工具** | Agent 可生成文件（Excel/CSV/HTML）并通过 `publish_file_from_workspace` 提供持久化下载。 |
| **原生工具执行** | 直接调用系统二进制工具（Python, FFmpeg, Git 等）。 |
| **11 国语言本地化** | 自动检测并显示原生语言的状态消息。 |
| **OpenWebUI v0.8.0+ 支持** | 针对 OpenWebUI 最新平台的稳健文件处理方案。 |

---

## 📥 导入对话模板

您可以下载并导入真实案例的 JSON 对话日志，直观查看模型如何调用工具：

- [📥 对话日志：GitHub 增长预测](https://fu-jie.github.io/awesome-openwebui/plugins/pipes/star-prediction-chat.json)
- [📥 对话日志：视频高质量 GIF 转换](https://fu-jie.github.io/awesome-openwebui/plugins/pipes/video-processing-chat.json)

*导入方式：前往 `设置 -> 数据 -> 导入对话`。*

---

## 🔗 相关资源

- **GitHub 仓库**: [openwebui-extensions](https://github.com/Fu-Jie/openwebui-extensions)
- **完整变更日志**: [README_CN.md](https://github.com/Fu-Jie/openwebui-extensions/blob/main/plugins/pipes/github-copilot-sdk/README_CN.md)
