AgentRound

<div align="center">

# 🗣️ AgentRound

**多模型 AI 圆桌讨论框架**

让多个 AI 模型围绕同一主题展开多轮辩论、碰撞观点、产出洞察

[![Python](https://img.shields.io/badge/Python-3.8+-3776AB?style=flat-square&logo=python&logoColor=white)](https://python.org)
[![OpenAI](https://img.shields.io/badge/OpenAI-Compatible-412991?style=flat-square&logo=openai&logoColor=white)](https://openai.com)
[![License](https://img.shields.io/badge/License-AGPLv3-blue?style=flat-square)](LICENSE)
[![GitHub](https://img.shields.io/github/stars/XueJourney/AgentRound?style=flat-square&logo=github)](https://github.com/XueJourney/AgentRound)

<img src="https://raw.githubusercontent.com/XueJourney/AgentRound/main/assets/demo.gif" alt="demo" width="680">

[快速开始](#-快速开始) · [功能特性](#-功能特性) · [配置说明](#%EF%B8%8F-配置说明) · [提示词工程](#-提示词工程) · [输出示例](#-输出示例)

</div>

---

## ✨ 功能特性

```
┌─────────────────────────────────────────────────────┐
│                    AgentRound                       │
├──────────────┬──────────────┬───────────────────────┤
│  🤖 多模型    │  🧑 人类介入  │  📊 Token 管理         │
│  并发讨论     │  实时指导     │  自动裁剪上下文         │
├──────────────┼──────────────┼───────────────────────┤
│  📝 Markdown │  🎨 Rich     │  🔧 全配置化            │
│  完整记录     │  终端渲染     │  .env 一站式管理        │
└──────────────┴──────────────┴───────────────────────┘
```

- **多模型并发** — 基于 `ThreadPoolExecutor`，多个模型同时生成回复，不串行等待
- **人类介入** — 每轮结束后可注入指导意见，引导讨论方向
- **智能裁剪** — 对话超出 Token 上限时自动移除最早的非 System 消息，保证 System Prompt 不丢失
- **Rich 渲染** — 每个模型独立配色，Panel + Markdown 渲染，终端阅读体验拉满
- **Markdown 导出** — 实时保存完整讨论记录，支持分享 / 复盘 / 归档
- **结构化日志** — 终端仅显示 WARNING+，详细日志写入文件，互不干扰
- **Token 容错** — API 不返回 usage 时自动回退 tiktoken 本地估算
- **全 .env 配置** — API、模型、参数、提示词模板全部可配置，零硬编码

---

## 🚀 快速开始

### 环境要求

- Python 3.8+
- 任意 OpenAI 兼容 API（OpenAI / DeepSeek / Ollama / vLLM / OneAPI ...）

### 安装

```bash
git clone https://github.com/XueJourney/AgentRound.git
cd AgentRound
pip install -r requirements.txt
```

### 依赖

`