## 项目介绍

AutoPilot 企业自动化引擎是一款基于 PyQt5 开发的企业级定时任务管理系统，专为企业自动化办公场景设计。系统采用直观的图形化界面，支持任务的增删改查、定时调度、执行监控、日志追踪等功能，帮助企业实现日常工作流程的自动化。

### 核心特性

- 任务管理：完整的 CRUD 操作，支持任务分类（财务类、人事类、行政类等）

- 定时调度：基于 APScheduler 的 Cron 表达式调度，灵活配置执行时间

- 安全认证：启动密码验证，防止未授权访问

- 系统托盘：最小化到系统托盘，不占用桌面空间

- 日志持久化：完整记录任务执行历史，支持查询和清除

- 企业微信通知：任务执行完成或失败时自动推送通知，包含完整执行日志

- 批量操作：支持 Ctrl+鼠标多选，右键批量执行任务

- 日志查询：按分类、名称、日期筛选查询执行日志

- 月度报表：自动生成月度执行统计报表，包含执行次数、成功率等指标

- 开机自启：支持配置开机自动启动

- 备注管理：支持多行备注输入，鼠标悬停预览，双击查看完整内容

### 技术栈

- GUI 框架：PyQt5

- 任务调度：APScheduler

- 配置管理：PyYAML

- 数据持久化：JSON

- 桌面通知：win10toast

- 数据处理：pandas

---

## 使用说明

### 一、环境要求

- Python 3.10+

- Windows 操作系统

- 企业微信机器人（可选，用于任务通知）

### 二、安装步骤

1. 克隆或下载项目，将项目文件解压到指定目录

2. 安装依赖：双击运行 install.bat 脚本，或手动执行 pip install -r requirements.txt

3. 配置应用：编辑 config/app.yaml 文件，修改默认密码等配置

4. 配置企业微信通知（可选）：编辑 config/wechat.yaml 文件，填入企业微信机器人 Webhook 地址

### 三、快速开始

1. 启动程序：双击运行 start.bat 脚本

2. 密码验证：首次启动需要输入密码（默认：admin123）

3. 添加任务：

   - 在主界面右键点击空白区域，选择添加任务

   - 填写任务信息：分类、名称、Cron 表达式、脚本路径、备注等

   - 勾选启用后任务将自动调度

4. 执行任务：

   - 自动执行：任务按 Cron 表达式自动调度

   - 手动执行：右键点击任务，选择执行

   - 批量执行：按住 Ctrl+鼠标左键多选任务，右键选择批量执行

### 四、功能详解

#### 1. 任务管理

| 功能 | 操作方式 |

|------|----------|

| 添加任务 | 右键菜单 -> 添加任务 |

| 编辑任务 | 右键点击任务 -> 编辑 |

| 删除任务 | 右键点击任务 -> 删除 |

| 启用/禁用 | 右键点击任务 -> 启用/禁用 |

| 查看备注 | 鼠标悬停预览，双击查看完整内容 |

#### 2. 菜单栏功能

- 设置 -> 企业微信配置：配置企业微信机器人 Webhook

- 日志 -> 日志查询：按分类、名称、日期筛选查询执行日志

- 报表 -> 生成月度报表：生成月度执行统计报表

#### 3. 状态栏

底部状态栏实时显示本月执行统计：总执行次数、成功次数、失败次数、成功率

#### 4. Cron 表达式示例

| 表达式 | 说明 |

|--------|------|

| 0 9 * * * | 每天 9:00 执行 |

| 0 9,17 * * * | 每天 9:00 和 17:00 执行 |

| 0 9 * * 1-5 | 工作日（周一至周五）9:00 执行 |

| 0 9 1 * * | 每月 1 号 9:00 执行 |

| */5 * * * * | 每 5 分钟执行一次 |

#### 5. 系统托盘

- 点击关闭按钮，程序最小化到系统托盘

- 右键托盘图标可显示主窗口或退出程序

### 五、脚本编写规范

将您的 Python 脚本放置在 scripts/ 目录下，脚本应满足以下要求：

1. 脚本可以独立运行

2. 使用 print() 输出执行日志（会被捕获并发送到企业微信）

3. 脚本执行成功返回 0，失败返回非 0

示例脚本：

```python

#!/usr/bin/env python

# -*- coding: utf-8 -*-

print("开始执行任务")

try:

    # 您的业务逻辑

    print("任务执行成功")

    exit(0)

except Exception as e:

    print(f"任务执行失败：{e}")

    exit(1)

```

### 六、配置开机自启

双击运行 setup_autostart.bat 脚本，程序将自动添加到 Windows 启动项。

### 七、数据目录说明

```

定时任务/

├── config/              # 配置文件目录

│   ├── app.yaml        # 应用配置

│   ├── tasks.yaml      # 任务配置

│   └── wechat.yaml     # 企业微信配置

├── scripts/             # 脚本目录

├── logs/                # 日志目录

│   └── app.log         # 应用日志

├── data/                # 数据目录

│   └── task_history.json  # 任务执行历史

└── backup/              # 备份目录

```

### 八、常见问题

Q: 如何修改启动密码？

A: 编辑 config/app.yaml 文件中的 password 字段。

Q: 企业微信通知收不到怎么办？

A: 检查 config/wechat.yaml 中的 Webhook 地址是否正确，确保网络连接正常。

Q: 任务执行失败在哪里查看日志？

A: 可以通过菜单栏日志 -> 日志查询查看详细执行日志，或直接查看 logs/app.log 文件。

Q: 如何清空执行历史？

A: 可以在日志查询界面点击清除日志按钮，或手动删除 data/task_history.json 文件。

---

## 版本信息

- 当前版本：1.0.0

- 最后更新：2026-02-28

## 许可证

本项目仅供企业内部使用。