SWE-agent 自动修复 Issue 完整指南从克隆仓库到跑通首个修复【免费下载链接】SWE-agentSWE-agent takes a GitHub issue and tries to automatically fix it, using your LM of choice. It can also be employed for offensive cybersecurity or competitive coding challenges. [NeurIPS 2024]项目地址: https://gitcode.com/GitHub_Trending/sw/SWE-agentSWE-agent 是一个 AI 驱动的自动修复工具给它一个 issue 描述和一份代码仓库它会自己读代码、写补丁、跑验证最后交付一份可应用的 diff。开源项目维护者可以拿它批量处理积压的 issue你也可以用它驱动 GPT、Claude 这类模型去干任何写代码的活。用它的意义不在替你打字而在替你试错复现、修改、再验证这条循环由模型在沙箱里自己跑完你只在结尾花一分钟检查补丁。 安装步骤四个前置条件加一条命令跑之前先确认四件事Python 3.11 或更高版本Git 可用一个你打算使用的 LM 的 API 密钥Anthropic、OpenAI 等均可Docker 已启动默认沙箱不想装 Docker 也可以切到云端执行然后克隆并安装git clone https://gitcode.com/GitHub_Trending/sw/SWE-agent cd SWE-agent python -m pip install --upgrade pip pip install --editable .装好与否一条命令就能验证sweagent --help看到 run、run-batch、inspect 等子命令列表说明环境已经通了。 首次运行修好第一个小 issue先让密钥生效任选一种方式export ANTHROPIC_API_KEY你的密钥或把同样的两行写进当前目录的.env文件。接着发起第一次运行。命令里三段参数对应三件事模型、仓库、问题描述sweagent run \ --agent.model.nameclaude-sonnet-4-20250514 \ --agent.model.per_instance_cost_limit2.00 \ --env.repo.path/path/to/your/repo \ --problem_statement.path/path/to/issue.md注意带上单次成本上限避免测试阶段跑飞。运行过程会在终端依次刷出沙箱启动、工具安装、主循环最后提交补丁同时把完整过程存成.traj文件放进trajectories/目录。跑完别急着关终端打开轨迹检查器回看全过程sweagent inspector浏览器里可以逐步翻模型的每步思考、每次命令和输出。如果 issue 不止一个换成sweagent run-batch就能批量跑输出目录结构完全相同。 看懂原理三个模块各司其职整条链路只有三个角色在接力环境SWEEnv负责在 Docker 沙箱里执行命令、读写文件代理Agent拿着模型输出的下一个动作去环境里执行再把观察结果喂回模型如此循环直到模型调用 submit历史处理器负责把每一步压缩整理进轨迹既控制上下文长度也留下可回放的记录。部署和沙箱管理由 SWE-ReX 托管你不需要关心细节。⚠️ 排查高频问题卡住时先查这三处遇到sweagent: command not found多半是跑命令的 Python 不是装 SWE-agent 的那个用which python对比一下实在不行改用python -m sweagent兜底。遇到一长串列满配置项的报错别慌这是联合类型在逐个尝试不同输入方式报错文本本身就写着每种方式失败的原因看最后一段即可。卡在 starting runtime 或容器起不来默认沙箱是 Docker先确认本地 Docker 在运行没有 Docker 就改用云端执行文档里有对应开关。 继续深入值得收藏的仓库内资料docs/usage/hello_world.md装完环境后的第一份教程走通修复 issue 的完整流程。docs/config/config.md想改模板、换解析器、调历史处理策略时来看所有行为都由这套 yaml 体系控制。docs/usage/inspector.md想对比多次运行、查看评测结果时命令版 inspect 与网页版 inspector 的差异都在这里。tools/registry/想给代理加自定义工具时照着这个目录的结构建一个即可。issue 修完了剩下的批量评测、开 PR、接入多模态都从上面这些入口进。【免费下载链接】SWE-agentSWE-agent takes a GitHub issue and tries to automatically fix it, using your LM of choice. It can also be employed for offensive cybersecurity or competitive coding challenges. [NeurIPS 2024]项目地址: https://gitcode.com/GitHub_Trending/sw/SWE-agent创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
