## 🎉 发布概览

Qidi Agent v2.0.0 正式发布！这次更新带来了革命性的 **Multi-Provider 并行执行模式**，让多个免费 AI 模型协同工作，输出质量堪比顶级商业模型。

> **核心价值**：单个免费模型能力有限，但通过智能编排、质量检测和择优合并，最终输出可以媲美世界排名前 10 的模型——**无需支付昂贵的 API 费用**。

---

## ✨ 核心新特性

### 1. Multi-Provider 并行执行模式

这是 v2.0.0 最核心的功能！系统会自动将复杂任务拆分，分发到多个 AI 编程工具并行执行，然后通过 AI 质量检测和智能合并产出高质量代码。

**架构设计**：

```
Task Input → Task Splitter → Multi-Provider Dispatch
                                    │
         ┌─────────┐  ┌─────────┐  ┌─────────┐
         │ Ollama  │  │ DeepSeek│  │ Claude  │
         └────┬────┘  └────┬────┘  └────┬────┘
              │            │            │
              └────────────┼────────────┘
                           ↓
                  MultiProviderRunner
                           ↓
                  Quality Checker
                           ↓
                     Merge Engine
                           ↓
                  Final Code Output
```

**关键改进**：
- 抽出 `MultiProviderRunner.js`（244行），消除动态 `require()` 调用
- `TaskExecutor` 从 678 行精简到 526 行
- 支持多种路由策略：轮询、能力匹配、手动路由、广播

### 2. 新增三大工具适配器

新增对主流 AI 编程工具的支持：

| 适配器 | 支持平台 | 功能特点 |
|--------|----------|----------|
| **KimiWorkAdapter** | KimiWork | 智能编程助手，支持代码补全与生成 |
| **WorkBuddyAdapter** | WorkBuddy | 智能编程助手，支持多语言开发 |
| **ZCodeAdapter** | ZCode | AI 代码编辑器，实时协作与智能提示 |

### 3. 国际化与 Star 优化

- **英文 README.md** 作为主入口，提升国际可见性
- **中文 README.zh-CN.md** 方便国内用户
- **Docker 三件套**：Dockerfile + docker-compose.yml + .devcontainer
- **GitHub Codespaces** 一键云端开发环境

---

## 📊 技术指标

| 指标 | v1.3.x | v2.0.0 | 提升 |
|------|--------|--------|------|
| **测试覆盖率** | 53/53 | 58/58 | +5个测试 |
| **TaskExecutor 行数** | 678 | 526 | -22% |
| **适配器数量** | 8 | 11 | +3个 |
| **CI 状态** | ❌ lint 失败 | ✅ 通过 | 修复 |
| **多 Provider 支持** | ❌ | ✅ | 新增 |

---

## 🚀 快速开始

### 方式一：本地安装

```bash
# 克隆仓库
git clone https://github.com/qidiai/QiDi-Agent.git
cd QiDi-Agent

# 安装依赖
npm install

# 启动（使用 Ollama 本地模型）
npm start

# 启动 WebUI
npm run web
```

### 方式二：Docker 一键启动

```bash
# 使用 Docker Compose（推荐）
docker-compose up

# 或手动构建
docker build -t qidi-agent .
docker run -p 3000:3000 qidi-agent
```

### 方式三：GitHub Codespaces

点击 GitHub 仓库的 **"Code" → "Create codespace on main"**，一键启动云端开发环境。

---

## 🔧 配置说明

### 环境变量配置

```bash
# Ollama（本地，免费）
OLLAMA_BASE_URL=http://localhost:11434
OLLAMA_MODEL=qwen2.5:7b

# DeepSeek（云端，需 API Key）
DEEPSEEK_API_KEY=your-api-key

# Anthropic Claude（云端，需 API Key）
ANTHROPIC_API_KEY=your-api-key
```

### 多 Provider 配置

编辑 `config/agents.json`：

```json
{
  "dispatch": {
    "mode": "parallel",
    "parallelLimit": 3,
    "compareResults": true,
    "selectBest": true
  }
}
```

---

## 🐛 Bug 修复

本次更新修复了 4 个 P0 级问题：

1. **GIF 裂图问题**：README 引用的 3 个 GIF 文件不存在，已替换为静态截图占位
2. **Benchmark 占位数据**：暂时移除链接，待获取真实数据后恢复
3. **CI lint 失败**：排除前端浏览器代码，修复模板字符串错误
4. **配置文件被覆盖**：`config/tools.json` 加入 `.gitignore`

---

## 📝 后续计划

- [ ] 录制真实 Demo GIF 替换占位截图
- [ ] 运行 Benchmark 获取真实性能数据
- [ ] 继续拆分 TaskExecutor（目标 <400 行）
- [ ] e2e 测试纳入 nightly CI

---

## 🌟 项目链接

- **GitHub**: https://github.com/qidiai/QiDi-Agent
- **Gitee**: https://gitee.com/xuchangming/qidi-agent
- **文档**: https://github.com/qidiai/QiDi-Agent/blob/main/docs/

---

> 💡 **欢迎 Star、Fork、PR！** 如果你觉得这个项目有用，请给个 Star 支持一下！