feat: implement council v3 round-table mode

README.md

@@ -1,83 +1,76 @@
-# Multi-Agent Decision Workshop & Deep Research
+# Multi-Agent Council & Debate Workshop (V4)
-# V4
 
-这是一个基于多智能体（Multi-Agent）的决策辅助和深度研究系统。它包含两个核心模式：
+一个极简而强大的多智能体（Multi-Agent）决策辅助系统。
-1.  **Deep Research Mode (Deep Research)**: 模仿 Gemini 研究模式，通过规划、执行、撰写三个阶段进行深度分析。
+**V4 版本**将传统的 "线性研究" 进化为 **"多模型智囊团 (Council V4)"**，支持多轮对话讨论、动态专家组建、以及多 API 平台接入。
-2.  **Debate Workshop (辩论工作坊)**: 让多个 AI 角色从不同视角辩论，帮助你做出更全面的决策。
 
-## ✨ 功能特性
+## ✨ 核心功能 (V4 Update)
 
--   **双模式切换**: 侧边栏一键切换 "Deep Research" 和 "Debate Workshop"。
+### 1. 🧪 Multi-Model Council V4 (多模型智囊团)
--   **自定义模型角色**:
+摒弃了单一的"规划-执行"模式，现在的系统是一个真正的**圆桌会议**：
-    -   在 Deep Research 模式下，可以分别指定 `Planner` (规划者), `Researcher` (研究员), `Writer` (作家) 使用不同的 LLM。
+*   **多轮对话讨论**: 专家不再是各自为战，而是像真实会议一样进行多轮（Round-Robin）对话，互相批判、补充观点。
--   **多模型支持**: 支持 OpenAI (GPT-4o), Anthropic (Claude 3.5), Gemini 等主流模型。
+*   **动态专家组建**: 你可以自定义 **2-5 位** 不同的专家（如 CEO, CTO, 法务）。
--   **交互式研究**: 生成研究计划后，用户可以介入修改，确保研究方向正确。
+*   **自定义模型分配**: 为每个专家指定最擅长的模型（例如：让 DeepSeek-Coder 担任技术专家，让 GPT-4o 担任产品专家）。
--   **流式输出**: 实时展示研究进度和辩论过程。
+*   **最终决策合成**: 讨论结束后，最后一位专家（Synthesizer）会综合全场观点，生成最终决策方案，并绘制 **Mermaid 路线图**。
 
-## 🛠️ 安装与使用
+### 2. 🎭 Debate Workshop (辩论工作坊)
+经典的辩论模式，让 AI 扮演不同立场的角色（如正方、反方、评审），通过激烈的辩论帮助你厘清复杂决策的利弊。
 
-### 1. 克隆项目
+### 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. 安装依赖
+# 2. 安装依赖
-
-确保你安装了 Python 3.8+。
-
-```bash
 pip install -r requirements.txt
 ```
 
-### 3. 配置 API Key
+## 🚀 快速开始
-
-你可以通过以下两种方式配置 API Key：
-
-**方式 A: 创建 `.env` 文件 (推荐)**
-复制 `.env.example` 为 `.env`，并填入你的 API Key。
-
-```bash
-cp .env.example .env
-```
-
-编辑 `.env` 文件:
-```env
-AIHUBMIX_API_KEY=your_api_key_here
-```
-
-**方式 B: 在 UI 中输入**
-启动应用后，在侧边栏的 "设置" -> "API Key" 输入框中填入。
-
-### 4. 启动应用
-
-运行 Streamlit 应用：
 
+### 1. 启动应用
 ```bash
 streamlit run app.py
 ```
 
-会自动在浏览器打开 `http://localhost:8501`。
+### 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.  输入议题，点击开始。观察专家们如何互相对话！
 
-### 🧪 Deep Research Mode (深度研究模式)
+### 4. 使用 Debate 模式
-1.  在侧边栏选择模式为 **"Deep Research"**。
+1.  切换到 **"Debate Workshop"**。
-2.  在 "研究模型配置" 中，为 Planner, Researcher, Writer 选择合适的模型（推荐分别使用 GPT-4o, Gemini-1.5-pro, Claude-3.5-sonnet）。
+2.  输入议题（如“是否应该全职做独立开发？”）。
-3.  输入你的**研究主题** (例如: "2025年量子计算商业化前景")。
+3.  选择参与辩论的角色。
-4.  点击 **"生成研究计划"**。
+4.  点击开始，观看唇枪舌战。
-5.  系统生成计划后，你可以直接在文本框中**修改计划步骤**。
-6.  点击 **"开始深度研究"**，观察 Agent 逐步执行研究任务。
-7.  下载最终生成的 Markdown 报告。
 
-### 🎭 Debate Workshop (辩论工作坊)
+---
-1.  在侧边栏选择模式为 **"Debate Workshop"**。
+
-2.  输入**决策议题** (例如: "我是否应该辞职创业？")。
+## 🤖 支持的模型 (V4 Expanded)
-3.  选择参与辩论的 **AI 角色** (如: CEO, 风险控制专家, 职业顾问)。
+
-4.  点击 **"开始辩论"**。
+系统内置了最新的模型配置，支持在界面直接选择：
-5.  观看不同角色之间的唇枪舌战，最后生成综合决策建议。
+*   **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)