ai-battle 0.1.0 → 0.1.2

package/README.md

@@ -1,37 +1,50 @@
-# ai-battle 🎯
+<h1 align="center">⚔️ ai-battle</h1>
 
-> 让多个 AI Agent 对同一问题进行结构化圆桌讨论，自动管理轮次、检测共识、保存全部记录。
+<p align="center">
+  <strong>让多个 AI Agent 对同一问题进行结构化圆桌讨论</strong>
+</p>
 
-![Bash](https://img.shields.io/badge/Bash-4%2B-green?logo=gnubash&logoColor=white)
-![License](https://img.shields.io/badge/License-MIT-blue)
-![jq](https://img.shields.io/badge/Dep-jq-orange)
+<p align="center">
+  自动管理轮次 · 检测共识 · 保存全部记录
+</p>
 
-## ✨ 特性
+<p align="center">
+  <a href="https://www.npmjs.com/package/ai-battle"><img src="https://img.shields.io/npm/v/ai-battle?style=flat-square&logo=npm&logoColor=white&color=CB3837" alt="npm version" /></a>
+  <img src="https://img.shields.io/badge/Bash-4%2B-4EAA25?style=flat-square&logo=gnubash&logoColor=white" alt="Bash 4+" />
+  <img src="https://img.shields.io/badge/Dep-jq-blue?style=flat-square" alt="jq" />
+  <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-yellow?style=flat-square" alt="MIT License" /></a>
+</p>
 
-- 🤖 **多 Agent 圆桌** — 支持 Claude / Codex / Gemini，可自由组合
-- 🔁 **同类自辩** — 同一 Agent 可参加多席位（如 `gemini,gemini`）
-- 🔨 **裁判模式** — 独立裁判每轮总结差异、自动检测共识、生成最终报告
-- 👁️ **上帝视角** — 每轮结束后可人工注入补充信息引导讨论方向
-- 💾 **Session 录制** — 保存 Agent CLI 原始输出（stream-json/json/raw）
-- 🔄 **断点续讨** — 中断后自动恢复到上次轮次继续讨论
-- 🔌 **可扩展** — 实现 3 个函数 + 注册即可接入新 Agent
+---
 
-## 🚀 快速开始
+## ✨ Features
+
+| Feature | Description |
+| :--- | :--- |
+| 🤖 **多 Agent 圆桌** | 支持 Claude / Codex / Gemini 自由组合 |
+| 🔁 **同类自辩** | 同一 Agent 可参加多席位（如 `gemini,gemini`） |
+| 🔨 **裁判模式** | 独立裁判每轮总结差异、自动检测共识、生成最终报告 |
+| 👁️ **上帝视角** | 每轮结束后人工注入补充信息引导讨论方向 |
+| 💾 **Session 录制** | 保存 Agent CLI 原始输出（stream-json / json / raw） |
+| 🔄 **断点续讨** | 中断后自动恢复到上次轮次继续讨论 |
+| 🔌 **可扩展** | 实现 3 个函数 + 注册即可接入新 Agent |
+
+## 🚀 Quick Start
 
 ```bash
-# 1. 创建讨论目录
+# 创建讨论目录
 mkdir my-topic && cd my-topic
 
-# 2. 写入问题
+# 写入问题
 echo "微服务 vs 单体架构的优缺点？" > problem.md
 
-# 3. 启动讨论（自动拉取最新版）
+# 启动讨论（自动拉取最新版）
 npx ai-battle --agents claude,gemini --rounds 8
 ```
 
-## 📦 安装
+## 📦 Installation
 
-**无需安装，直接使用 npx（推荐）：**
+**推荐：无需安装，直接使用 npx**
 
 ```bash
 npx ai-battle --agents claude,gemini --rounds 5
@@ -45,21 +58,27 @@ npx ai-battle --agents claude,gemini --rounds 5
 npm install -g ai-battle
 ```
 
-## 📖 用法
+### 前置依赖
 
-```text
+- `bash` 4+
+- [`jq`](https://jqlang.github.io/jq/)
+- Agent CLI 工具（至少安装 2 个）：`claude` / `codex` / `gemini`
+
+## 📖 Usage
+
+```
 ai-battle [options]
 ai-battle help
 ```
 
-| 参数 | 说明 |
-|------|------|
-| `--agents, -a <a1,a2>` | 选择参与的 Agent（默认: `claude,codex`），支持同类: `--agents gemini,gemini` |
-| `--rounds, -r <N>` | 最大讨论轮次（默认: 10） |
-| `--god, -g` | 开启上帝视角（每轮结束后可注入补充信息） |
-| `--referee [agent]` | 开启裁判模式（每轮总结差异/检测共识，结束时生成 SUMMARY.md） |
+| 参数 | 说明 | 默认值 |
+| :--- | :--- | :--- |
+| `--agents, -a <a1,a2>` | 选择参与的 Agent，支持同类 | `claude,codex` |
+| `--rounds, -r <N>` | 最大讨论轮次 | `10` |
+| `--god, -g` | 开启上帝视角（每轮可注入补充信息） | — |
+| `--referee [agent]` | 开启裁判模式（每轮总结 + 生成 SUMMARY.md） | — |
 
-## 💡 使用示例
+### 💡 Examples
 
 ```bash
 # 同类 Agent 自我辩论
@@ -68,7 +87,7 @@ ai-battle --agents gemini,gemini
 # 三方圆桌讨论
 ai-battle --agents claude,codex,gemini --rounds 5
 
-# 裁判模式（每轮总结 + 结束时生成 SUMMARY.md）
+# 裁判模式
 ai-battle --agents claude,codex,gemini --referee --rounds 5
 
 # 指定 claude 做裁判
@@ -78,7 +97,7 @@ ai-battle --agents codex,gemini --referee claude --rounds 5
 ai-battle --agents claude,codex --referee --god
 ```
 
-## 🔄 工作流程
+## 🔄 How It Works
 
 ```mermaid
 sequenceDiagram
@@ -95,7 +114,6 @@ sequenceDiagram
         S->>S: 加载 .env / 检查 problem.md
         S->>A: check_A() 可用性检查
         S->>B: check_B() 可用性检查
-        S->>S: 生成指令文件 / 初始化配置
     end
 
     rect rgb(30, 50, 40)
@@ -107,7 +125,6 @@ sequenceDiagram
             S->>B: call_B(problem)
             B-->>S: 回复 B
         end
-        S->>S: 保存至 rounds/ 和 .sessions/
     end
 
     rect rgb(40, 40, 60)
@@ -139,83 +156,68 @@ sequenceDiagram
         S->>U: 🎉 达成共识！
     else 未达成
         S->>U: 是否追加轮次？
-        alt 追加
-            U-->>S: 追加 N 轮
-            Note over S: 继续 Round 循环
-        else 结束
-            opt 裁判模式
-                S->>R: generate_final_summary()
-                R-->>S: SUMMARY.md
-            end
-            S->>U: 讨论结束
-        end
     end
 ```
 
-## 🤖 内置 Agent
+## 🤖 Built-in Agents
 
-| Agent | 后端 | 检查方式 |
-|-------|------|----------|
-| **claude** | Claude CLI | `claude -p "hello"` |
-| **codex** | Codex CLI | `codex exec "hello"` |
-| **gemini** | Gemini CLI | `gemini -p "hello"` |
+| Agent | Backend | Check Command |
+| :--- | :--- | :--- |
+| `claude` | Claude CLI | `claude -p "hello"` |
+| `codex` | Codex CLI | `codex exec "hello"` |
+| `gemini` | Gemini CLI | `gemini -p "hello"` |
 
-## 📁 产出文件
+## 📁 Output Structure
 
 ```text
-./
-├── problem.md             # 讨论问题（用户创建）
-├── rounds/                # 讨论轮次
+my-topic/
+├── problem.md              # 讨论问题（用户创建）
+├── referee.md              # 裁判自定义提示词（可选）
+├── rounds/                 # 讨论轮次记录
 │   ├── round_1_claude.md
 │   ├── round_1_gemini.md
-│   ├── referee_round_2.md # 裁判总结（--referee）
-│   ├── god_round_1.md     # 上帝注入（--god）
-│   └── ...
-├── .sessions/             # Agent CLI 原始输出
-├── consensus.md           # 共识结论（如达成）
-├── SUMMARY.md             # 最终总结（裁判自动生成）
-├── .debate.json           # 配置/状态
-└── .debate.log            # 运行日志（tail -f 实时查看）
+│   ├── referee_round_2.md  # 裁判总结（--referee）
+│   └── god_round_1.md      # 上帝注入（--god）
+├── .sessions/              # Agent CLI 原始输出
+├── consensus.md            # 共识结论（如达成）
+├── SUMMARY.md              # 最终总结（裁判自动生成）
+├── .debate.json            # 状态配置
+└── .debate.log             # 运行日志（tail -f 实时查看）
 ```
 
-## ⚙️ 配置文件
-
-| 文件 | 说明 |
-|------|------|
-| `.env` | 自动加载环境变量（启动时） |
-| `referee.md` | 裁判自定义提示词（开启 `--referee` 时） |
+## 🔌 Extend Agent
 
-## 🔌 扩展 Agent
+只需实现 3 个函数并注册：
 
 ```bash
-# 1. 实现三个函数
+# 1. 实现函数
 check_myagent()          { ... }  # 可用性检查，返回 0/1
-call_myagent()           { ... }  # 调用 Agent，$1=system_prompt $2=user_msg $3=session_tag
-generate_myagent_md()    { ... }  # 生成指令文件，$1=max_rounds $2=problem
+call_myagent()           { ... }  # 调用 Agent: $1=system_prompt $2=user_msg $3=session_tag
+generate_myagent_md()    { ... }  # 生成指令文件: $1=max_rounds $2=problem
 
 # 2. 注册
 register_agent "myagent"
 ```
 
-## 🔑 环境变量
+## 🔑 Environment Variables
 
 <details>
 <summary><b>Claude</b></summary>
 
-```bash
-export ANTHROPIC_BASE_URL="https://open.bigmodel.cn/api/anthropic"
-export ANTHROPIC_AUTH_TOKEN="your-token"
-export ANTHROPIC_DEFAULT_SONNET_MODEL="glm-4.7"
-export API_TIMEOUT_MS=600000
-```
+| Variable | Description |
+| :--- | :--- |
+| `ANTHROPIC_BASE_URL` | API 地址 |
+| `ANTHROPIC_AUTH_TOKEN` | 认证 Token |
+| `ANTHROPIC_DEFAULT_SONNET_MODEL` | 模型名称 |
+| `API_TIMEOUT_MS` | 超时时间（毫秒） |
 
 </details>
 
 <details>
 <summary><b>Codex</b></summary>
 
-| 变量 | 说明 | 默认值 |
-|------|------|--------|
+| Variable | Description | Default |
+| :--- | :--- | :--- |
 | `CODEX_MODEL` | Codex 模型 | `gpt-5.3-codex` |
 
 </details>
@@ -223,18 +225,16 @@ export API_TIMEOUT_MS=600000
 <details>
 <summary><b>Gemini</b></summary>
 
-| 变量 | 说明 |
-|------|------|
+| Variable | Description |
+| :--- | :--- |
 | `GEMINI_API_KEY` | API Key（如需自定义） |
 
 </details>
 
-## 📦 依赖
+## 🤝 Contributing
 
-- `bash` 4+
-- `jq`
-- Agent CLI 工具：`claude` / `codex` / `gemini`（至少安装 2 个）
+欢迎提交 [Issue](https://github.com/Alfonsxh/ai-battle/issues) 和 [Pull Request](https://github.com/Alfonsxh/ai-battle/pulls)！
 
 ## 📄 License
 
-[MIT](LICENSE)
+[MIT](LICENSE) © [Alfons](https://github.com/Alfonsxh)

package/ai-battle.sh

@@ -254,8 +254,20 @@ $user_msg
 
     local text=""
 
-    # 从输出中提取有效内容（跳过 codex 元数据行）
-    text=$(grep -v '^\(thinking\|exec\|mcp startup\|OpenAI Codex\|--------\|workdir:\|model:\|provider:\|approval:\|sandbox:\|reasoning\|session id:\|user$\|tokens used\|Exit code:\|^$\)' "$tmpout" 2>/dev/null | sed '/^$/d')
+    # 从输出中提取有效内容
+    # 1. 先截取 codex 标记行之后的内容（跳过 prompt 回显和 thinking 块）
+    # 2. 再过滤掉元数据行和 token 统计
+    if grep -qn '^codex$' "$tmpout" 2>/dev/null; then
+      # 找到最后一个 "codex" 标记行，取其后所有内容（即真正回复）
+      local codex_line
+      codex_line=$(grep -n '^codex$' "$tmpout" | tail -1 | cut -d':' -f1)
+      text=$(tail -n "+$((codex_line + 1))" "$tmpout" \
+        | grep -v '^\(tokens used\|Exit code:\|[0-9,]*$\)' \
+        | sed '/^$/d')
+    else
+      # 兜底: 无 codex 标记时沿用原始过滤
+      text=$(grep -v '^\(thinking\|exec\|mcp startup\|OpenAI Codex\|--------\|workdir:\|model:\|provider:\|approval:\|sandbox:\|reasoning\|session id:\|user$\|tokens used\|Exit code:\|^$\)' "$tmpout" 2>/dev/null | sed '/^$/d')
+    fi
 
     rm -f "$tmpout"
 
@@ -489,15 +501,26 @@ log_and_print() {
   echo -e "$1" | sed 's/\x1b\[[0-9;]*m//g' >> "$LOG_FILE"
 }
 
-# 检查 AGREED 关键字（支持行内匹配，不要求行首）
+# 检查 AGREED 关键字（要求行首匹配，避免误触发）
 has_agreed() {
-  echo "$1" | grep -qiE '\*{0,2}AGREED:'
+  # 要求 AGREED: 出现在行首（允许 ** 加粗），避免匹配标题或 prompt 模板中的 AGREED
+  echo "$1" | grep -qE '^\*{0,2}AGREED:[[:space:]]'
 }
 
 # 提取 AGREED 后的结论
 extract_agreed() {
-  echo "$1" | grep -ioE '\*{0,2}AGREED:[[:space:]]*.*' | head -1 \
-    | sed 's/^\*\{0,2\}[Aa][Gg][Rr][Ee][Ee][Dd]:[[:space:]]*//' | sed 's/[[:space:]]*$//' | sed 's/\*\{1,2\}$//'
+  # 提取行首 AGREED: 后面的结论文本
+  local raw
+  raw=$(echo "$1" | grep -oE '^\*{0,2}AGREED:[[:space:]]*.*' | head -1 \
+    | sed 's/^\*\{0,2\}AGREED:[[:space:]]*//' | sed 's/[[:space:]]*$//' | sed 's/\*\{1,2\}$//')
+
+  # 校验: 拒绝占位符结论（如 <共识结论>, <xxx> 等）
+  if echo "$raw" | grep -qE '^<[^>]+>$'; then
+    echo ""
+    return
+  fi
+
+  echo "$raw"
 }
 
 # Agent 颜色映射（自动提取基础类型）

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "ai-battle",
-    "version": "0.1.0",
+    "version": "0.1.2",
     "description": "让多个 AI Agent 对同一问题进行结构化圆桌讨论",
     "bin": {
         "ai-battle": "./ai-battle.sh"