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

---

🛠️ 安装

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

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

🚀 快速开始

1. 启动应用

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