# AI Agent Collaboration Framework - 安装指南

## 🚀 快速安装

### 一键安装
```bash
curl -fsSL https://raw.githubusercontent.com/your-org/agent-collaboration-framework/main/install.sh | bash
```

### 手动安装

#### 1. 克隆项目
```bash
git clone https://github.com/your-org/agent-collaboration-framework.git
cd agent-collaboration-framework
```

#### 2. 运行安装脚本
```bash
chmod +x install.sh
./install.sh
```

#### 3. 验证安装
```bash
./agents/stats.sh
```

## 📋 系统要求

### 必需组件
- Python 3.8+
- Git 2.20+
- OpenSSH

### 可选组件
- GPG (用于代码签名)
- Node.js (用于Web界面)
- Docker (用于容器化部署)

## 🔧 配置步骤

### 1. 初始化Agent
```bash
./setup_agents.sh
```

### 2. 配置Git远程仓库
```bash
# 添加你的GitHub仓库
./agents/configure_remote.sh github your-username your-repo

# 添加Gitea仓库
./agents/configure_remote.sh gitea your-gitea-instance your-repo
```

### 3. 测试Agent身份
```bash
# 查看当前Agent
./agents/switch_agent.sh claude-ai
git config user.name  # 应该显示 "claude-ai"

# 切换Agent
./agents/switch_agent.sh gemini-dev
git config user.name  # 应该显示 "gemini-dev"
```

## 🎯 使用示例

### 基本使用
```bash
# 启动协作演示
python3 agents/demo_collaboration.py

# 手动协作流程
./agents/switch_agent.sh claude-ai
echo "# 架构设计" > docs/arch.md
git add docs/arch.md
git commit -m "添加架构设计" --author="claude-ai <claude@ai-collaboration.local>"

./agents/switch_agent.sh gemini-dev
echo "console.log('Hello');" > src/app.js
git add src/app.js
git commit -m "添加应用代码" --author="gemini-dev <gemini@ai-collaboration.local>"
```

### 高级用法
```bash
# 批量Agent操作
./scripts/bulk_commit.sh "更新文档" --agents="claude-ai,llama-research"

# 代码审查模式
./scripts/review_mode.sh

# 性能分析
./scripts/analyze_contributions.sh
```

## 🐳 Docker安装

### 使用Docker Compose
```bash
docker-compose up -d
```

### 构建镜像
```bash
docker build -t agent-collaboration .
docker run -it agent-collaboration
```

## 🔍 故障排除

### 常见问题

#### GPG签名失败
```bash
# 禁用GPG签名
git config --global commit.gpgsign false
```

#### SSH密钥问题
```bash
# 重新生成SSH密钥
./scripts/regenerate_keys.sh
```

#### 权限问题
```bash
# 修复文件权限
chmod +x agents/*.sh
```

## 📊 验证安装

运行测试套件：
```bash
python3 -m pytest tests/
```

查看Agent状态：
```bash
./agents/stats.sh --verbose
```

## 🎉 下一步

安装完成后，建议：
1. 运行演示项目
2. 阅读 [快速开始指南](QUICK_START.md)
3. 查看 [贡献指南](CONTRIBUTING.md)

## 💡 提示

- 使用 `./agents/help.sh` 获取帮助
- 查看示例项目 `examples/` 目录
- 加入社区讨论 [Discussions](https://github.com/your-org/agent-collaboration-framework/discussions)