ai-roundtable 0.0.38__tar.gz

ai_roundtable-0.0.38/.gitignore

@@ -0,0 +1,11 @@
+# dependencies
+.venv/
+
+# reference materials (local only)
+reference/
+
+# python cache
+__pycache__/
+*.pyc
+*.pyo
+.DS_Store

ai_roundtable-0.0.38/CLAUDE.md

@@ -0,0 +1,16 @@
+# CLAUDE.md — AI Roundtable 项目协作规则
+
+## 版本号规则
+
+格式：`Major.Minor.Build`，存储在 `config.yml` 的 `version` 字段。
+
+- **Build**：每次 git push 前自动 +1，由 Claude 负责
+- **Minor / Major**：由用户决定何时升级
+
+## 项目结构
+
+- `src/tui.py` — TUI 主界面（Textual）
+- `src/quick.py` — Rapid Fire 模式逻辑
+- `src/orchestrator.py` — Deep Dive 模式编排
+- `config.yml` — 配置文件，含版本号
+- `prompts/` — Prompt 模板

ai_roundtable-0.0.38/PKG-INFO

@@ -0,0 +1,138 @@
+Metadata-Version: 2.4
+Name: ai-roundtable
+Version: 0.0.38
+Summary: A terminal UI that runs Claude, Gemini, and Codex side-by-side in parallel deliberation
+Project-URL: Homepage, https://github.com/HiJiangChuan/ai-roundtable
+Project-URL: Repository, https://github.com/HiJiangChuan/ai-roundtable
+Author-email: HiJiangChuan <hijiangchuan@gmail.com>
+License: MIT
+Keywords: ai,claude,codex,gemini,llm,multi-agent,terminal,tui
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Terminals
+Requires-Python: >=3.10
+Requires-Dist: pillow>=10.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: textual>=0.47.0
+Description-Content-Type: text/markdown
+
+# AI Roundtable
+
+让 Claude、Gemini、Codex 围坐一桌，就任意议题展开真正的多轮辩论。
+
+## 效果
+
+```
+🔵 CLAUDE                        🟢 GEMINI                        🟡 CODEX
+─────────────────────────────    ─────────────────────────────    ──────────────────────────
+── 快问 ──                        ── 快问 ──                        ── 快问 ──
+大模型的核心竞争力在于推理能力，     我认为数据飞轮才是护城河所在，      工程落地能力被严重低估……
+```
+
+## 两种模式
+
+### 快问（默认）
+三个 AI **并行**回答同一个问题，适合快速对比不同视角。
+
+- `/compare` — 让三个 AI 互评彼此的回答
+- `^t` — 将当前问题升级为深度讨论
+
+### 深度讨论
+主持人轮换制（Gemini → Codex → Claude → …），每轮结束后主持人分析矛盾点、分配行动类型，推动讨论深入。
+
+**行动类型**：陈述立场 / 反驳 / 补充 / 追问 / 挑战前提 / 综合
+
+**轮次指令**：
+| 输入 | 作用 |
+|------|------|
+| `可` | 开始下一轮 |
+| `止` | 结束会话并生成总结 |
+| `深入此节` | 不推进轮次，围绕当前矛盾点再挖一层 |
+| `@claude 你的看法？` | 单独问某个 AI |
+
+## 安装
+
+**前置条件**：已安装并登录 `claude`、`gemini`、`codex` CLI。
+
+```bash
+git clone https://github.com/yourname/ai-roundtable
+cd ai-roundtable
+python3 -m venv .venv
+.venv/bin/pip install -r requirements.txt
+chmod +x bin/roundtable
+```
+
+## 使用
+
+```bash
+./bin/roundtable          # 快问模式启动
+./bin/roundtable --deep   # 直接进入深度讨论
+```
+
+**快捷键**：
+
+| 快捷键 | 功能 |
+|--------|------|
+| `Ctrl+T` | 切换模式 |
+| `Ctrl+Y` | 复制当前面板内容（先点击面板） |
+| `Ctrl+E` | 导出会话为 Markdown |
+| `Ctrl+N` | 新建会话 |
+| `Ctrl+Q` | 退出 |
+
+## 配置
+
+`config.yml` 可调整：
+
+```yaml
+ais:
+  claude:
+    cmd: "claude"
+    flags: ["--dangerously-skip-permissions"]
+
+deep:
+  moderator_rotation: ["gemini", "codex", "claude"]  # 主持人轮换顺序
+  speaking_order: ["claude", "codex", "gemini"]       # 嘉宾发言顺序
+  full_rounds_kept: 3                                  # 保留完整的最近 N 轮
+  timeout_seconds: 30                                  # 每个 AI 的超时时间
+
+history:
+  save_dir: "~/.ai-roundtable/history"   # 会话记录保存位置
+```
+
+## 会话记录
+
+每次会话自动保存到 `~/.ai-roundtable/history/`，JSON + Markdown 各一份，也可按 `Ctrl+E` 随时导出。
+
+## 项目结构
+
+```
+ai-roundtable/
+├── bin/roundtable        # 启动脚本
+├── config.yml            # 配置文件
+├── prompts/              # Prompt 模板
+│   ├── opening.md        # 开场（第0轮）
+│   ├── guest.md          # 嘉宾发言（深度模式）
+│   ├── guest_quick.md    # 嘉宾发言（快问模式）
+│   ├── moderator.md      # 主持人综述
+│   ├── compare.md        # 互评
+│   └── compress.md       # 上下文压缩
+├── src/
+│   ├── main.py           # 入口
+│   ├── tui.py            # 终端界面
+│   ├── orchestrator.py   # 深度讨论状态机
+│   ├── quick.py          # 快问模式
+│   ├── cli_caller.py     # AI CLI 调用
+│   ├── context_manager.py# 上下文压缩管理
+│   ├── history.py        # 会话历史
+│   └── prompt_loader.py  # Prompt 加载渲染
+└── requirements.txt
+```

ai_roundtable-0.0.38/README.md

@@ -0,0 +1,111 @@
+# AI Roundtable
+
+让 Claude、Gemini、Codex 围坐一桌，就任意议题展开真正的多轮辩论。
+
+## 效果
+
+```
+🔵 CLAUDE                        🟢 GEMINI                        🟡 CODEX
+─────────────────────────────    ─────────────────────────────    ──────────────────────────
+── 快问 ──                        ── 快问 ──                        ── 快问 ──
+大模型的核心竞争力在于推理能力，     我认为数据飞轮才是护城河所在，      工程落地能力被严重低估……
+```
+
+## 两种模式
+
+### 快问（默认）
+三个 AI **并行**回答同一个问题，适合快速对比不同视角。
+
+- `/compare` — 让三个 AI 互评彼此的回答
+- `^t` — 将当前问题升级为深度讨论
+
+### 深度讨论
+主持人轮换制（Gemini → Codex → Claude → …），每轮结束后主持人分析矛盾点、分配行动类型，推动讨论深入。
+
+**行动类型**：陈述立场 / 反驳 / 补充 / 追问 / 挑战前提 / 综合
+
+**轮次指令**：
+| 输入 | 作用 |
+|------|------|
+| `可` | 开始下一轮 |
+| `止` | 结束会话并生成总结 |
+| `深入此节` | 不推进轮次，围绕当前矛盾点再挖一层 |
+| `@claude 你的看法？` | 单独问某个 AI |
+
+## 安装
+
+**前置条件**：已安装并登录 `claude`、`gemini`、`codex` CLI。
+
+```bash
+git clone https://github.com/yourname/ai-roundtable
+cd ai-roundtable
+python3 -m venv .venv
+.venv/bin/pip install -r requirements.txt
+chmod +x bin/roundtable
+```
+
+## 使用
+
+```bash
+./bin/roundtable          # 快问模式启动
+./bin/roundtable --deep   # 直接进入深度讨论
+```
+
+**快捷键**：
+
+| 快捷键 | 功能 |
+|--------|------|
+| `Ctrl+T` | 切换模式 |
+| `Ctrl+Y` | 复制当前面板内容（先点击面板） |
+| `Ctrl+E` | 导出会话为 Markdown |
+| `Ctrl+N` | 新建会话 |
+| `Ctrl+Q` | 退出 |
+
+## 配置
+
+`config.yml` 可调整：
+
+```yaml
+ais:
+  claude:
+    cmd: "claude"
+    flags: ["--dangerously-skip-permissions"]
+
+deep:
+  moderator_rotation: ["gemini", "codex", "claude"]  # 主持人轮换顺序
+  speaking_order: ["claude", "codex", "gemini"]       # 嘉宾发言顺序
+  full_rounds_kept: 3                                  # 保留完整的最近 N 轮
+  timeout_seconds: 30                                  # 每个 AI 的超时时间
+
+history:
+  save_dir: "~/.ai-roundtable/history"   # 会话记录保存位置
+```
+
+## 会话记录
+
+每次会话自动保存到 `~/.ai-roundtable/history/`，JSON + Markdown 各一份，也可按 `Ctrl+E` 随时导出。
+
+## 项目结构
+
+```
+ai-roundtable/
+├── bin/roundtable        # 启动脚本
+├── config.yml            # 配置文件
+├── prompts/              # Prompt 模板
+│   ├── opening.md        # 开场（第0轮）
+│   ├── guest.md          # 嘉宾发言（深度模式）
+│   ├── guest_quick.md    # 嘉宾发言（快问模式）
+│   ├── moderator.md      # 主持人综述
+│   ├── compare.md        # 互评
+│   └── compress.md       # 上下文压缩
+├── src/
+│   ├── main.py           # 入口
+│   ├── tui.py            # 终端界面
+│   ├── orchestrator.py   # 深度讨论状态机
+│   ├── quick.py          # 快问模式
+│   ├── cli_caller.py     # AI CLI 调用
+│   ├── context_manager.py# 上下文压缩管理
+│   ├── history.py        # 会话历史
+│   └── prompt_loader.py  # Prompt 加载渲染
+└── requirements.txt
+```

ai_roundtable-0.0.38/ROADMAP.md

@@ -0,0 +1,15 @@
+# Roadmap
+
+## Phase 1 — 历史记录补全
+- [ ] Quick 模式存历史（目前完全无记录）
+- [ ] MD 实时写入（每轮结束追加，不等 `止` 命令）
+- [ ] 会话自动命名：话题前 20 字作为文件名（`2026-03-30 AI会取代程序员吗.md`）
+
+## Phase 2 — Obsidian 支持
+- [ ] YAML frontmatter（日期、话题、模式、轮数、标签）
+- [ ] Callout 格式区分三个 AI（`> [!note]` 不依赖 CSS 插件）
+- [ ] `config.yml` 新增 `obsidian_vault` 路径配置
+
+## Phase 3 — 可选增强
+- [ ] 每月 Index 文件（自动生成 `2026-03 目录.md`，wikilink 到当月会话）
+- [ ] TUI 内会话历史列表

ai_roundtable-0.0.38/bin/roundtable

@@ -0,0 +1,10 @@
+#!/usr/bin/env bash
+set -euo pipefail
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+ROOT="$SCRIPT_DIR/.."
+if [[ -x "$ROOT/.venv/bin/python3" ]]; then
+    PYTHON="$ROOT/.venv/bin/python3"
+else
+    PYTHON="python3"
+fi
+exec "$PYTHON" "$ROOT/src/main.py" "$@"

ai_roundtable-0.0.38/config.yml

@@ -0,0 +1,32 @@
+ais:
+  claude:
+    cmd: "claude"
+    prompt_flag: "-p"
+    flags: ["--dangerously-skip-permissions"]
+    color: "blue"
+    icon: "🔵"
+    timeout: 60
+  gemini:
+    cmd: "gemini"
+    prompt_flag: "-p"
+    flags: ["--yolo"]
+    color: "green"
+    icon: "🟢"
+    timeout: 90
+  codex:
+    cmd: "codex"
+    subcommand: "exec"
+    flags: []
+    color: "yellow"
+    icon: "🟡"
+    timeout: 60
+
+deep:
+  full_rounds_kept: 3
+  compress_summary_max: 80
+  timeout_seconds: 60
+
+history:
+  obsidian_vault: "/Users/chuan/Workspace/notes"  # 留空则默认存至 ~/Documents/ai-roundtable/
+
+version: "0.0.38"

ai_roundtable-0.0.38/prompts/README.md

@@ -0,0 +1,36 @@
+# Prompts Directory
+
+This directory contains prompt templates for the AI Roundtable system.
+
+## Templates
+
+- `opening.md` — Opening moderator prompt (Round 0)
+- `guest.md` — Guest AI speaking prompt
+- `moderator.md` — Moderator summary prompt
+- `compress.md` — Context compression prompt
+
+## Template Variables
+
+Variables are written as `{{variable_name}}` and replaced at runtime.
+
+### opening.md
+- `{{moderator_name}}` — Name of the moderator AI
+- `{{topic}}` — The discussion topic
+
+### guest.md
+- `{{agent_name}}` — Name of this guest AI
+- `{{context}}` — Current context (topic summary + history + recent rounds)
+- `{{round_num}}` — Current round number
+- `{{moderator_question}}` — The moderator's guiding question
+- `{{action_type}}` — Assigned action type for this round
+- `{{action_instruction}}` — Detailed action instruction
+- `{{prior_speeches}}` — Speeches from earlier speakers this round (empty in round 1)
+
+### moderator.md
+- `{{moderator_name}}` — Name of the moderator AI
+- `{{context}}` — Current context
+- `{{round_num}}` — Current round number
+- `{{round_speeches}}` — All guest speeches from this round
+
+### compress.md
+- `{{round_content}}` — Full round content to compress

ai_roundtable-0.0.38/prompts/compare.md

@@ -0,0 +1,13 @@
+你是 {{agent_name}}，刚才你已经回答了一个问题。现在请评价其他 AI 的回答。
+
+原始问题：{{question}}
+
+其他 AI 的回答：
+{{others_answers}}
+
+请分析：
+1. 哪些观点你认同？为什么？
+2. 哪些观点你认为有缺陷或遗漏？为什么？
+3. 综合来看，你认为最关键的角度是什么？
+
+简洁直接，200字以内。

ai_roundtable-0.0.38/prompts/compress.md

@@ -0,0 +1,17 @@
+请将以下一轮圆桌讨论内容压缩为不超过80字的摘要。
+
+## 压缩要求
+
+1. 保留核心矛盾和各方立场
+2. 保留关键论点（数据、案例、核心逻辑）
+3. 丢弃重复内容和细节展开
+4. 保留主持人指出的矛盾点
+5. 用客观、概括性语言
+
+## 待压缩内容
+
+{{round_content}}
+
+## 输出
+
+直接输出压缩摘要，不要添加任何说明或标题，不超过80字：

ai_roundtable-0.0.38/prompts/guest.md

@@ -0,0 +1,35 @@
+你是 {{agent_name}}，参加 AI 圆桌讨论的嘉宾。
+
+## 当前上下文
+
+{{context}}
+
+## 本轮信息
+
+- 轮次：第 {{round_num}} 轮
+- 主持人问题：{{moderator_question}}
+- 你的行动类型：{{action_type}}
+- 行动说明：{{action_instruction}}
+
+## 本轮已发言内容
+
+{{prior_speeches}}
+
+## 行动类型说明
+
+- **陈述立场**：清晰表明你对议题的核心观点，有理有据
+- **反驳**：针对已有观点提出直接反驳，指出其错误或局限
+- **补充**：在已有观点基础上补充新的维度或证据
+- **追问**：提出一个深度问题，挑战或深化讨论
+- **挑战前提**：质疑讨论的基本假设，提出不同框架
+- **综合**：整合多方观点，提炼共识与分歧
+
+## 要求
+
+1. 严格按照分配的行动类型发言
+2. 发言聚焦、有观点、不废话，200字以内
+3. 如果有先发言者的内容，你的发言应回应或参照他们的观点
+4. 不要重复行动类型说明，直接发言
+5. 用第一人称，语气自然、有主见
+
+请直接输出你的发言内容：

ai_roundtable-0.0.38/prompts/guest_quick.md

@@ -0,0 +1,7 @@
+你是 {{agent_name}}，正在参与一个 Rapid Fire 环节。
+
+{{context_history}}
+
+用户提问：{{question}}
+
+请直接、简洁地回答这个问题。不需要介绍自己，不需要客套，直接给出你的核心答案和判断。300字以内。

ai_roundtable-0.0.38/prompts/moderator.md

@@ -0,0 +1,39 @@
+你是 {{moderator_name}}，担任第 {{round_num}} 轮的主持人。
+
+## 当前上下文
+
+{{context}}
+
+## 本轮嘉宾发言
+
+{{round_speeches}}
+
+## 你的任务
+
+分析本轮嘉宾（{{guests_list}}）的发言，完成主持人综述。
+
+## 行动类型规则
+
+可用行动类型：陈述立场、反驳、补充、追问、挑战前提、综合
+
+约束：
+- 不能让所有人都是"补充"
+- 至少一人分配"反驳"或"挑战前提"
+- "综合"只在第4轮之后才可使用（当前第 {{round_num}} 轮）
+- 行动分配要制造张力，推动讨论深入
+
+## 输出格式
+
+请严格按照以下格式输出，每个字段都必须填写，不要添加额外说明或标题：
+
+【矛盾点】
+（用一句话指出本轮最核心的分歧或张力点）
+
+【下一问】
+（针对矛盾点提出一个引导性问题，要具体、可辩论）
+
+【行动分配】
+{{guests_action_format}}
+
+【本轮摘要】
+（100字以内，概括本轮核心观点和主要分歧，保留立场差异）

ai_roundtable-0.0.38/prompts/opening.md

@@ -0,0 +1,25 @@
+你是 {{moderator_name}}，担任本次 AI 圆桌的主持人。
+
+议题：{{topic}}
+
+你的任务是主持开场。请完成以下事项：
+
+1. 用不超过50字定义议题边界（核心问题是什么、不讨论什么）
+2. 提出一个开场引导问题，激发嘉宾思考
+3. 为第1轮分配行动（开场轮所有人均为"陈述立场"）
+
+嘉宾：{{guests_list}}（你自己也是嘉宾之一）
+
+请严格按照以下格式输出，不要添加任何额外说明：
+
+【矛盾点】
+议题初始
+
+【下一问】
+（你的开场引导问题，要具体、有启发性）
+
+【行动分配】
+{{guests_action_format}}
+
+【本轮摘要】
+议题：{{topic}}。各方将在第1轮各自陈述立场。

ai_roundtable-0.0.38/prompts/solo_roundtable.md

@@ -0,0 +1,37 @@
+你将主持并扮演一场圆桌讨论。议题是：
+
+**{{topic}}**
+
+## 你的任务
+
+1. **担任主持人**：冷静客观，引导讨论朝向更深邃的层面。
+2. **发明3位典型代表人物**：根据议题推荐最能产生思想张力的人物（历史人物、思想流派代表、或典型角色），每人附上立场和性格特征。
+3. **扮演每位人物发言**：各自从其世界观出发，200字以内，直接有力。
+4. **主持人综述**：指出本轮核心矛盾，提出下一个更深的问题。
+
+{{context}}
+
+## 当前轮次信息
+
+- 轮次：第 {{round_num}} 轮
+- 当前焦点问题：{{moderator_question}}
+
+## 输出格式
+
+**【主持人开场/过渡】**
+（简短引入本轮焦点）
+
+**【人物甲 · 姓名/角色】**
+（发言内容）
+
+**【人物乙 · 姓名/角色】**
+（发言内容）
+
+**【人物丙 · 姓名/角色】**
+（发言内容）
+
+**【主持人综述】**
+核心矛盾：（一句话）
+下一个问题：（引导性问题，更深一层）
+
+请直接开始输出，不要解释格式：

ai_roundtable-0.0.38/pyproject.toml

@@ -0,0 +1,46 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "ai-roundtable"
+version = "0.0.38"
+description = "A terminal UI that runs Claude, Gemini, and Codex side-by-side in parallel deliberation"
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.10"
+authors = [{ name = "HiJiangChuan", email = "hijiangchuan@gmail.com" }]
+keywords = ["ai", "claude", "gemini", "codex", "tui", "terminal", "llm", "multi-agent"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: MacOS",
+    "Operating System :: POSIX :: Linux",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Terminals",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+dependencies = [
+    "textual>=0.47.0",
+    "pyyaml>=6.0",
+    "Pillow>=10.0",
+]
+
+[project.scripts]
+ai-roundtable = "ai_roundtable.main:main"
+
+[project.urls]
+Homepage = "https://github.com/HiJiangChuan/ai-roundtable"
+Repository = "https://github.com/HiJiangChuan/ai-roundtable"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src"]
+
+[tool.hatch.build.targets.wheel.sources]
+"src" = "ai_roundtable"
+

ai_roundtable-0.0.38/requirements.txt

@@ -0,0 +1,4 @@
+textual>=0.47.0
+pyyaml>=6.0
+pyperclip>=1.8.0
+Pillow>=10.0