Bugfix Agent

BugfixAgent — 容器报错自动修复系统

监听远程服务器 Docker 容器的报错日志（如后端 500），自动完成：**AI 识别错误 → 拉取代码仓库 → Claude CLI 自动修复 → 推送分支并创建 MR/PR → 邮件通知**，并提供 Web 面板跟踪任务状态。

功能亮点

• 🔍 自动巡检：轮询远程服务器 docker logs 增量日志，Claude CLI 智能识别需要修复的服务端错误（自动忽略 4xx、噪音日志）
• 🧠 AI 自动修复：按容器绑定的仓库（极狐 GitLab / GitHub）克隆代码，Claude CLI 最小化修改并验证，推送 bugfix/agent-* 分支后自动创建 MR/PR
• 🔁 指纹去重：错误签名规范化 + 冷却期机制，同一报错不会反复触发修复；同容器串行执行避免冲突
• 📊 Web 面板：任务看板 + 各阶段执行时间线（识别→克隆→修复→推送→MR→通知）、一键重试、服务器/容器/设置全图形化管理
• 📧 邮件通知：修复结果（含 MR 链接）自动推送邮箱，开关与收件人可配置
• 🐳 一键部署：所有依赖（Python/Node/git/Claude CLI）打包进单个 Docker 镜像，SQLite 零外部依赖，本地构建 tar 传输即可上线

界面预览

任务面板	任务详情（时间线 / AI 修复说明）

容器监控	系统设置

技术栈

Python (FastAPI + SQLAlchemy + SQLite + paramiko) · Vue 3 (Vite + TypeScript + Element Plus) · Claude CLI

快速开始

1. 后端

# 使用项目自带 .venv（或自建虚拟环境）
cd backend
pip install -r requirements.txt
uvicorn app.main:app --port 8787

首次启动会自动建表（`data/bugfix_agent.db`）并写入默认配置。

2. 前端

cd frontend
npm install
npm run dev          # http://localhost:5173（/api 已代理到 8787）

生产部署可 `npm run build`，后端会自动托管 `frontend/dist`，单端口访问。

3. 配置向导（Web 面板操作）

1. 服务器 页：添加目标服务器（SSH IP/端口/用户名/密码），点"测试连接"验证。
2. 容器监控 页：添加容器 —— 选择服务器、填容器名（docker ps 中的名字）、 代码托管类型（极狐 GitLab / GitHub）、仓库 URL、访问 Token、默认分支、轮询间隔。 "测试仓库"验证 token 可用，"立即轮询"手动触发一次采集分析。
3. 系统设置 页：配置邮件通知（SMTP 授权码，126 邮箱示例默认值）、去重冷却时间、 Claude CLI 认证与路径等。

4. 邮件通知（以 126 邮箱为例）

设置页填：`smtp.host=smtp.126.com`、`smtp.port=465`、`smtp.secure=ssl`、 `smtp.user=你的邮箱`、`smtp.pass=SMTP 授权码`（非登录密码，需在邮箱后台开启 SMTP 并生成）、 `notify.recipients=你的邮箱`。`notify.enabled` 控制是否通知，可点"发送测试邮件"验证。

工作流程

轮询 docker logs --since <锚点> --timestamps（增量，锚点存库，重启不丢）
  → Claude CLI 分析该时段日志，识别需修复的错误并生成规范化指纹
  → 指纹去重（同指纹存在进行中任务 或 完成未过冷却期 → 跳过）
  → clone 仓库 → bugfix/age