wd666/README.md

# Multi-Agent Council & Debate Workshop (V4)

一个极简而强大的多智能体（Multi-Agent）决策辅助系统。
**V4 版本**将传统的 "线性研究" 进化为 **"多模型智囊团 (Council V4)"**，支持多轮对话讨论、动态专家组建、以及多 API 平台接入。

## ✨ 核心功能 (V4 Update)

### 1. 🧪 Multi-Model Council V4 (多模型智囊团)
摒弃了单一的"规划-执行"模式，现在的系统是一个真正的**圆桌会议**：
*   **多轮对话讨论**: 专家不再是各自为战，而是像真实会议一样进行多轮（Round-Robin）对话，互相批判、补充观点。
*   **动态专家组建**: 你可以自定义 **2-5 位** 不同的专家（如 CEO, CTO, 法务）。
*   **自定义模型分配**: 为每个专家指定最擅长的模型（例如：让 DeepSeek-Coder 担任技术专家，让 GPT-4o 担任产品专家）。
*   **最终决策合成**: 讨论结束后，最后一位专家（Synthesizer）会综合全场观点，生成最终决策方案，并绘制 **Mermaid 路线图**。

### 2. 🎭 Debate Workshop (辩论工作坊)
经典的辩论模式，让 AI 扮演不同立场的角色（如正方、反方、评审），通过激烈的辩论帮助你厘清复杂决策的利弊。

### 3. 🌐 Multi-Provider Support (多平台支持)
不再局限于单一平台，系统原生支持多种 API 源，随心切换：
*   **DeepSeek Official**: 直接连接 `api.deepseek.com`
*   **SiliconFlow (硅基流动)**: 连接 `api.siliconflow.cn`
*   **AIHubMix**: 聚合平台
*   **OpenAI / Custom**: 支持标准 OpenAI 接口或本地 vLLM/Ollama

---

## 🛠️ 安装

```bash
# 1. 克隆项目
git clone https://github.com/HomoDeusss/multi-agent.git
cd multi-agent

# 2. 安装依赖
pip install -r requirements.txt
```

## 🚀 快速开始

### 1. 启动应用
```bash
streamlit run app.py
```

### 2. 配置 API (V4 新特性)
无需手动修改 `.env` 文件（可选），直接在 Web 界面侧边栏配置：
1.  在侧边栏选择 **"API Provider"** (例如 `DeepSeek` 或 `SiliconFlow`)。
2.  输入对应的 **API Key**。
3.  系统会自动配置好 Base URL。

### 3. 使用 Council V4 模式
1.  选择 **"Deep Research" (现已升级为 Council V4)**。
2.  **设定专家**: 选择专家人数（例如 3 人），并为每位专家命名并指定模型。
    *   *Tip: 建议最后一位专家选一个逻辑能力强的模型（如 Claude 3.5 Sonnet）作为决策者。*
3.  **设定轮数**: 选择讨论轮数（建议 2-3 轮）。
4.  输入议题，点击开始。观察专家们如何互相对话！

### 4. 使用 Debate 模式
1.  切换到 **"Debate Workshop"**。
2.  输入议题（如“是否应该全职做独立开发？”）。
3.  选择参与辩论的角色。
4.  点击开始，观看唇枪舌战。

---

## 🤖 支持的模型 (V4 Expanded)

系统内置了最新的模型配置，支持在界面直接选择：
*   **DeepSeek**: V3 (`deepseek-chat`), R1 (`deepseek-reasoner`), Coder V2
*   **OpenAI**: GPT-4o, GPT-4o-mini
*   **Anthropic**: Claude 3.5 Sonnet, Claude 3 Opus
*   **Google**: Gemini 1.5 Pro/Flash
*   **Meta/Alibaba**: Llama 3.3, Qwen 2.5

## 📝 License
[MIT License](LICENSE)