内容
<div align="center">
# 圆桌会议
### 一个前沿模型的委员会 — 用于做出重要的决策。
[](./LICENSE)
[](https://frontierinfra.org)
[](https://roundtable.sh)
[](#mcp--wire-into-your-harness)
**一个问题 → 许多想法 → 一个决策。**
将一个问题提交给 **Grok, Codex/OpenAI, GLM, MiniMax, Claude, 和 Gemini** 进行并行处理，
可选地 **商讨达成共识** 通过主席投票，并从命令行或任何支持MCP的编码工具中获取一个决策结果。
</div>
```bash
curl -fsSL https://roundtable.sh/install.sh | bash
```
---
## 为什么是圆桌会议？
每个模型都有它无法看到的盲点。就在做出不可逆转的决定之前 — 架构、迁移、重写 — 正是需要对一个模型的自信答案进行二次（甚至三次、四次）审视的时刻。
圆桌会议汇集了一个 **前沿模型的委员会**。每个模型独立给出答案；然后，对于高风险的决策，一个 **多轮商讨** 让每个模型审阅整个讨论并修订，直到 **Claude主席** 宣布 `CONSENSUS` 或指出剩余的分歧。分歧是信号，而不是噪音。
- **🗳️ 咨询** *(默认)* — 每个模型一次独立回答，彼此不知晓对方的答案。原始、独立的意见。
- **⚖️ 商讨** (`--rounds N`) — 模型之间可以看到彼此的答案并修订；中立的主席裁定 `CONSENSUS` / `CONTINUE` 并在达成一致时提前停止。
- **🔑 API密钥就足够** — 不需要本地命令行工具。缺少的模型将被跳过；委员会运行在您配置的任意子集上。
- **📦 一个二进制文件，无处不在** — 一个命令行工具、一个MCP服务器和一个一键安装程序，可以连接到您的编码工具。
## 示例
```text
$ roundtable "回复时请准确地使用三个字: OK three words" --heads claude,gemini
# 🪑 圆桌会议 — 2个模型 — 咨询
## 🔵 Claude (claude-opus-4-8, Anthropic) → OK three words
## ✨ Gemini (gemini-3.1-pro-preview, Google) → OK three words
```
添加 `--rounds 3` 并让模型们进行商讨；主席打印 `VERDICT: CONSENSUS` （或 `CONTINUE`）以及他们达成一致的要点和任何异议。
## 安装
```bash
curl -fsSL https://roundtable.sh/install.sh | bash
```
或者选择您的包管理器 — 所有四个包都提供相同的引擎：
```bash
pip install roundtable
uv tool install roundtable
brew install frontier-infra/tap/roundtable
```
安装程序将引擎放置在 `${XDG_DATA_HOME:-~/.local/share}/roundtable`，将 `roundtable` 符号链接到 `~/.local/bin`，并在需要时打印 `PATH` 提示。
## 快速开始
```bash
# 1. 配置密钥（屏蔽提示；显示哪些模型可用/不可用）。存储在 ~/.config/roundtable/config.env 中，权限为 chmod-600。
# 任何子集都有效 — 缺少的模型将被跳过。
roundtable auth
# 2. 向委员会提问
roundtable "Postgres 或 SQLite 用于单租户内部工具？"
# 3. 对高风险决策进行商讨以达成共识
roundtable ask -q "我们应该用 Go 重写计费服务吗？" --rounds 3
```
`roundtable doctor` 显示哪些模型已配置并对每个模型进行可达性测试。
### 标志
`-q/--question` · `-c/--context <file>` （共享背景信息适用于所有模型） ·
`--heads grok,codex,openai,glm,minimax,claude,gemini` · `--rounds N` （商讨） ·
`--research` （启用网络搜索，多步骤） · `--timeout <secs>` · `--out <file>`。
如果至少有一个模型给出答案，则退出状态码为0。
## 模型列表
| 模型 | 提供商 | 密钥/认证 |
|------|----------|------------|
| 🤖 **Grok** | xAI | `XAI_API_KEY` （或本地 `grok` 命令行工具 / Hermes OAuth） |
| 🧠 **Codex** | OpenAI | 本地 `codex` 命令行工具（只读） |
| 🧠 **OpenAI** | OpenAI | `OPENAI_API_KEY` （直接API — 不需要本地命令行工具） |
| 🟣 **GLM** | Z.AI | `ZAI_API_KEY` |
| 🟠 **MiniMax** | MiniMax | `MINIMAX_API_KEY` |
| 🔵 **Claude** | Anthropic | `ANTHROPIC_API_KEY` （也是商讨的 **主席**） |
| ✨ **Gemini** | Google | `GEMINI_API_KEY` / `GOOGLE_API_KEY` |
没有密钥/命令行工具的模型将被跳过 — 委员会运行在您配置的任意子集上，因此 **仅需API密钥** （不需要本地命令行工具）。
## MCP + 连接到您的工具
圆桌会议提供了一个MCP服务器作为一个子命令：
```bash
roundtable mcp serve # stdio JSON-RPC; 一个工具： roundtable(question, heads?, rounds?, research?)
roundtable mcp config # 打印服务器JSON块以手动粘贴
```
自动连接检测到的工具（幂等 — 先备份，再连接）：
```bash
roundtable install # 检测并连接所有现有的工具
roundtable install --harness cursor,codex
roundtable install --all # 非交互式
```
连接 **Claude Code** （技能 + MCP）、 **Cursor** (`~/.cursor/mcp.json`)、
**Codex CLI** (`~/.codex/config.toml`)，并打印一个通用的JSON块用于其他工具：
```json
{ "command": "roundtable", "args": ["mcp", "serve"] }
```
## 在Claude Code中使用
圆桌会议作为一个 **Claude Code插件** — 一个 `roundtable` 技能，用于驱动命令行工具。
有两种方法添加它：
**A — 插件市场** （在Claude Code内部）：
```text
/plugin marketplace add frontier-infra/roundtable
/plugin install roundtable@roundtable
```
该技能调用 **全局安装的 `roundtable` 命令行工具**，因此请先安装它：
`curl -fsSL https://roundtable.sh/install.sh | bash`.
**B — `roundtable install`** — 在一步中自动连接该技能 **和** MCP服务器到Claude Code（以及Cursor / Codex）：
```bash
roundtable install
```
## 命令
```
roundtable "问题" `ask` 的简写
roundtable ask 运行委员会（所有引擎标志）
roundtable auth [提供商] 配置API密钥（屏蔽，chmod-600）
roundtable models 每个模型的选取器
roundtable heads 启用/禁用模型
roundtable doctor 哪些模型已配置 + 可达性测试
roundtable config 显示/编辑 config.env
roundtable mcp serve|config MCP_stdio服务器 / 打印配置
roundtable install 自动连接检测到的工具
roundtable version | update 显示版本 / 就地升级
```
## 适用于代理
在圆桌会议的基础上进行构建？请参阅 [`AGENTS.md`](./AGENTS.md) — 一个简明的指南，介绍代理如何安装、配置、运行和将圆桌会议连接到其自身的工具。
## 链接
- **网站和文档** — https://roundtable.sh
- **源码** — https://github.com/frontier-infra/roundtable
- **前沿基础设施** — https://frontierinfra.org
## 许可证
[MIT](./LICENSE) © 前沿基础设施
