# AutoAgent

**Repository Path**: kk357924266/AutoAgent

## Basic Information

- **Project Name**: AutoAgent
- **Description**: 自动监测电脑版本界面
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-16
- **Last Updated**: 2026-04-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🤖 AutoAgent - 智能自动化平台

> **视觉监控机器人 + Agent任务自动化 - 双引擎驱动**

一个集成了视觉监控和Agent任务自动化的智能平台，支持实时监控界面状态并执行操作，以及批量自动化处理Markdown任务列表。

---

## 📚 功能模块

### 1️⃣ 视觉监控机器人

纯本地、零LLM依赖的自动化编程助手监控系统。

**核心功能：**
- 👁️ **自动感知** - 实时监控界面，识别"完成"、"暂停"、"报错"等状态
- 🖱️ **自动干预** - 模拟鼠标点击弹窗/按钮，自动激活窗口焦点
- ⌨️ **自动下发** - 任务完成后自动在终端执行预设指令
- 🔄 **批量质检** - 每完成10个任务自动触发代码检查（Lint/Test/Build）
- 🛡️ **安全保护** - 白名单机制、危险命令拦截、熔断保护

**快速开始：**
```bash
python main.py
# 或双击 start.bat
```

详细文档请查看 [docs/](docs/) 目录。

---

### 2️⃣ Agent任务自动化 GUI

强大的可视化任务自动化系统，支持批量处理Markdown格式的任务列表，具备闭环验证、无人值守等高级功能。

#### ✨ 核心特性

**🎯 任务自动化执行**
- 解析Markdown任务列表（支持 `- [ ]` 未完成和 `- [x]` 已完成标记）
- 按优先级排序（P0 > P1 > P2 > P3）
- 分页显示任务列表（5/10/15/20/30条每页可选）
- 实时进度跟踪和统计信息展示

**🔍 闭环验证机制**
- 每完成N个任务自动触发AI验证（可配置间隔）
- 自定义验证指令编辑器
- 验证状态实时监控
- 自动发送验证指令给AI并等待响应

**🤖 无人值守模式**
- 启用后自动处理弹窗和异常
- 失败任务自动重试（可配置最大重试次数）
- 进程健康监控和僵尸进程清理
- 长时间运行稳定性保障

**📍 智能坐标配置**
- 实时鼠标坐标追踪显示
- **右键点击自动填入坐标**（避免与左键操作混淆）
- 手动输入坐标设置
- 从配置文件加载/保存坐标
- 坐标持久化存储

**🎨 主题系统**
- 支持多主题切换（Dark/Light/Purple）
- 统一配色方案和视觉层次
- 下拉框、表格、按钮全面美化
- 丝滑的标签页切换动画

**📊 实时监控面板**
- 进度条可视化展示
- 总任务数/已完成数/成功率统计
- 用时和速度计算（秒/任务）
- 当前任务名称显示
- 底部监测信息栏实时更新

**📝 日志系统**
- 双日志视图（任务执行日志 + 运行日志）
- 时间戳和级别标识（INFO/SUCCESS/WARNING/ERROR）
- 日志复制、保存、清空功能
- 自动滚动到最新日志

#### 🚀 快速开始

**方式1：使用启动脚本**
```bash
# Windows
start_v14.bat
```

**方式2：直接运行**
```bash
python tools/agent_gui_v14.py
```

**首次使用步骤：**

1. **准备任务文件**
   ```markdown
   # 示例任务文件 (tasks/default_tasks_30.md)
   
   ## 待办任务
   
   - [ ] P0 | 修复登录页面bug | 用户无法通过手机号登录
   - [ ] P1 | 优化搜索功能 | 搜索结果加载过慢
   - [ ] P2 | 添加单元测试 | 覆盖核心业务逻辑
   - [x] P0 | 数据库迁移 | 已完成 ✅
   ```

2. **配置坐标**
   - 打开【配置】标签页
   - 启动鼠标追踪
   - 移动鼠标到目标输入框位置
   - **点击右键**自动填入坐标（或手动输入后点击"设置坐标"）

3. **加载任务**
   - 切换到【任务列表】标签页
   - 点击"浏览"选择任务文件
   - 点击"加载任务"按钮

4. **开始执行**
   - 点击"▶ 开始"按钮
   - 实时监控执行进度
   - 可随时暂停/停止

#### ⚙️ 配置说明

**基本配置：**
- **发送间隔**：每个任务之间的等待时间（秒），默认5秒
- **最大任务数**：单次执行的最大任务数量，默认30个
- **等待超时**：单个任务的最大等待时间（秒），默认120秒

**闭环验证配置：**
- **验证间隔**：每完成多少个任务触发一次验证，默认5个
- **启用闭环验证**：勾选后自动执行验证流程
- **验证指令**：自定义发送给AI的验证提示词

**复选框选项：**
- ✅ **启用无人值守模式**：自动处理弹窗和异常
- ✅ **自动点击运行按钮**：自动触发任务执行
- ✅ **失败后自动重试**：任务失败时自动重试
- ✅ **启用闭环验证**：开启周期性验证

#### 📦 项目结构

```
AutoAgent/
├── tools/
│   ├── agent_gui_v14.py          # Agent自动化GUI V14（最新版）
│   ├── agent_gui_v13.py          # V13版本（主题美化版）
│   ├── agent_gui_v11.py          # V11版本（功能参考版）
│   ├── crm_task_automation_v3.py # 核心自动化引擎
│   └── theme_manager.py          # 主题管理系统
├── tasks/
│   └── default_tasks_30.md       # 示例任务文件
├── config/
│   └── automation_config.json    # 自动化配置文件（自动生成）
├── docs/                         # 视觉监控机器人文档
└── README.md                     # 本文件
```

#### 🔧 依赖安装

```bash
pip install customtkinter pyautogui pynput psutil pywin32
```

#### 💡 使用技巧

1. **坐标设置技巧**
   - 推荐使用**右键点击**方式，避免与暂停按钮冲突
   - 启动鼠标追踪后，移动鼠标到精确位置再点击右键
   - 坐标会自动保存到配置文件，下次启动自动加载

2. **任务文件格式**
   - 使用标准Markdown复选框语法：`- [ ]` 或 `- [x]`
   - 支持优先级标记：`P0 | 任务名 | 描述`
   - 未完成任务会被自动提取并按优先级排序

3. **闭环验证最佳实践**
   - 验证间隔建议设置为5-10个任务
   - 编写详细的验证指令，包含代码检查、功能测试、性能优化等维度
   - 验证超时应大于单个任务的平均执行时间

4. **无人值守模式**
   - 适合长时间批量任务处理
   - 建议配合日志监控使用
   - 定期检查成功率统计，发现异常及时干预

#### 🐛 常见问题

**Q1: 加载任务后底部显示0/0？**
A: V14已修复此问题。确保使用最新版本，加载任务后会自动同步统计信息。

**Q2: 点击暂停时会误触设置坐标？**
A: V14已改为**右键点击**设置坐标，避免与左键操作（如暂停按钮）混淆。

**Q3: 自定义指令框太拥挤？**
A: V14已优化布局，增加文本框高度到200px，减少上方空白区域。

**Q4: 执行监控页面空间浪费？**
A: V14已将所有区域的padding从15/10减小到10/5，布局更紧凑。

**Q5: 如何保存和加载配置？**
A: 在【配置】标签页中，点击"💾 保存配置"导出JSON文件，下次点击"📂 加载配置"导入。

---

## 🎯 下一步

### 视觉监控机器人
1. 📖 阅读 [docs/01-项目说明.md](docs/01-项目说明.md) 了解项目
2. 🔧 按照 [docs/04-安装测试指南.md](docs/04-安装测试指南.md) 安装环境
3. 📸 参考 [docs/03-模板准备指南.md](docs/03-模板准备指南.md) 准备素材
4. ⚙️ 查看 [docs/02-使用指南.md](docs/02-使用指南.md) 配置参数
5. 🚀 运行 `python main.py` 开始使用

### Agent任务自动化
1. 📝 准备Markdown格式的任务文件
2. ⚙️ 配置坐标和基本参数
3. 🚀 运行 `python tools/agent_gui_v14.py` 或双击 `start_v14.bat`
4. 📊 监控执行进度和验证状态

---

**祝使用愉快！** 🎉