SWE-agent — 自动代码修复 Agent¶

# === 方法一：pip 安装 ===
pip install sweagent  # 安装 SWE-agent

# === 方法二：从源码安装（获取最新功能） ===
git clone https://github.com/SWE-agent/SWE-agent.git  # 克隆仓库
cd SWE-agent  # 进入目录
pip install -e .  # 以可编辑模式安装

# === 配置 API Key ===
export ANTHROPIC_API_KEY="sk-ant-你的密钥"  # Claude API Key
# 或
export OPENAI_API_KEY="sk-你的密钥"  # OpenAI API Key

# 创建配置文件 ~/.sweagent/config.yaml
model:
  name: claude-sonnet-4-20250514  # 使用 Claude Sonnet 4
  api_key: ${ANTHROPIC_API_KEY}  # 从环境变量读取

# 执行环境
environment:
  type: docker  # 使用 Docker 沙盒（推荐）
  # type: local  # 或直接在本地执行（不推荐）

# 最基本的用法：给一个 GitHub Issue，让 AI 修复
sweagent run \
  --model claude-sonnet-4-20250514 \
  --data-path https://github.com/用户名/仓库名/issues/42  # 修复 Issue #42

# SWE-agent 会自动：
# 1. 读取 Issue 描述
# 2. 克隆仓库代码
# 3. 在 Docker 沙盒中分析代码
# 4. 定位 Bug 所在文件和行数
# 5. 编写修复代码
# 6. 运行测试验证
# 7. 生成补丁文件

# 指定本地目录和问题描述
sweagent run \
  --model claude-sonnet-4-20250514 \
  --repo /path/to/my-project \
  --problem "用户提交表单时，如果邮箱字段为空会导致服务器500错误"

# 也可以直接用命令行交互
sweagent run \
  --model claude-sonnet-4-20250514 \
  --repo . \
  --interactive  # 交互模式，可以实时对话

# mini-swe-agent 只有 100 行代码，但 SWE-Bench 得分 74%+！

# 安装
pip install mini-swe-agent  # 安装 mini 版本

# 使用
mini-swe-agent "修复这个 Bug：列表索引越界"  # 直接描述问题

# 也可以用来做日常命令行助手
mini-swe-agent "帮我写一个 Python 脚本统计目录下所有文件大小"

SWE-agent 的核心创新是 ACI（Agent-Computer Interface），
类比理解：

普通 AI 工具 = 人在电脑前打字
SWE-agent = 给 AI 设计了一套专用的键盘和屏幕

ACI 提供的专用命令：
- find_file：在仓库中搜索文件
- search_dir：搜索目录中的内容
- open_file：打开并查看文件
- goto_line：跳转到指定行
- edit_file：精确编辑文件
- create_file：创建新文件
- scroll_up/down：上下滚动查看代码
- submit：提交最终修复

这些命令比让 AI 直接用 bash 更高效、更准确

# 可以一次给 SWE-agent 多个 Issue 让它批量修复
sweagent run \
  --model claude-sonnet-4-20250514 \
  --data-path issues.json  # JSON 文件包含多个 Issue 信息

# issues.json 格式：
# [
#   {"repo": "user/repo", "issue_id": 42},
#   {"repo": "user/repo", "issue_id": 43},
#   {"repo": "user/repo", "issue_id": 44}
# ]

# Docker 容器（最安全）
sweagent run --env docker --model sonnet ...

# 本地环境（快但不安全）
sweagent run --env local --model sonnet ...

# Singularity/Apptainer（HPC 集群常用）
sweagent run --env singularity --model sonnet ...

# Podman（Docker 替代品）
sweagent run --env podman --model sonnet ...

# 通过 Ollama 使用本地模型
sweagent run \
  --model ollama/deepseek-coder-v2 \
  --repo . \
  --problem "修复这个 TypeError"

# 通过 OpenRouter 使用多种模型
export OPENROUTER_API_KEY="你的Key"
sweagent run \
  --model openrouter/anthropic/claude-sonnet-4

SWE-agent 团队还训练了专用的开源模型：
- SWE-agent-LM-32b：开源权重 SoTA
- 专门为代码修复任务优化
- 可以在本地运行，不需要 API

用法：
sweagent run --model swe-agent-lm-32b --repo .