# wwwchat-automation-rabbitmq-api

**Repository Path**: jingjiantlm/wwwchat-automation-rabbitmq-api

## Basic Information

- **Project Name**: wwwchat-automation-rabbitmq-api
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-08
- **Last Updated**: 2026-02-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 项目结构

## 📁 目录结构

```
wwwchat-automation-rabbitmq-api/
│
├── 📄 README.md                 # 项目主说明文档（中文）
├── 📄 README.en.md              # 项目说明（英文）
├── 📄 main.py                   # 统一启动入口
├── 📄 启动GUI.bat                # 快速启动GUI界面
├── 📄 一键打包.bat                # 一键打包成exe
│
├── 📂 src/                      # 源代码目录
│   ├── 📂 core/                 # 核心功能模块
│   │   ├── wechat_controller.py  # 微信控制器
│   │   ├── window_manager.py     # 窗口管理器
│   │   └── message_queue.py      # 消息队列
│   │
│   ├── 📂 api/                  # API接口模块
│   │   ├── app.py               # Flask HTTP API
│   │   └── uiauto.py            # UI自动化API
│   │
│   ├── 📂 rabbitmq/             # RabbitMQ模块
│   │   ├── rabbitmq_consumer.py  # 消息消费者
│   │   └── rabbitmq_manager.py   # 队列管理器
│   │
│   ├── 📂 gui/                  # GUI界面模块
│   │   └── gui_main.py          # PyQt5主程序
│   │
│   └── 📂 utils/                # 工具类模块
│       ├── build_gui.py         # 构建工具
│       └── create_icon.py       # 图标工具
│
├── 📂 config/                   # 配置文件目录
│   ├── config.json              # 主配置文件
│   ├── config.example.json      # 配置模板
│   ├── requirements.txt         # Python依赖（API）
│   └── requirements_gui.txt     # Python依赖（GUI）
│
├── 📂 tests/                    # 测试代码目录
│   ├── test_api.py              # API测试
│   ├── test_rabbitmq.py         # RabbitMQ测试
│   └── test_rabbitmq_cleanup.py # 清理测试
│
├── 📂 examples/                 # 示例代码目录
│   ├── rabbitmq_example.py      # RabbitMQ示例
│   ├── send_simple.py           # 简单发送示例
│   └── ...                      # 更多示例
│
├── 📂 scripts/                  # 脚本文件目录
│   ├── install_rabbitmq.ps1     # RabbitMQ安装脚本
│   ├── disconnect_rdp.bat       # 远程桌面断开脚本
│   └── 微信机器人.spec           # PyInstaller配置
│
└── 📂 docs/                     # 文档目录
    ├── 🎉重构完成.md             # 重构完成说明
    ├── 📚文档索引.md             # 文档索引
    ├── 使用说明.md              # 详细使用说明
    ├── GUI使用手册.md           # GUI使用手册
    ├── RabbitMQ使用说明.md      # RabbitMQ说明
    ├── 快速启动指南.md          # 快速启动
    ├── 打包说明.md              # 打包说明
    └── ...                     # 更多文档
```

## 🚀 快速开始

### 安装依赖

```bash
# API版本
pip install -r config/requirements.txt

# GUI版本（包含API依赖）
pip install -r config/requirements_gui.txt
```


### 方式1：GUI 界面（推荐新手）

直接双击根目录下的 **`启动GUI.bat`**

### 方式2：命令行启动

```bash
# 启动 GUI 界面
python main.py gui

# 启动 HTTP API 服务
python main.py api

# 启动 RabbitMQ 消费者
python main.py rabbitmq
```

### 方式3：模块方式启动

```bash
python -m src.gui.gui_main
python -m src.api.app
python -m src.rabbitmq.rabbitmq_consumer
```

## 📋 核心文件说明

### 根目录文件

| 文件 | 说明 |
|------|------|
| `README.md` | 项目主说明文档 |
| `main.py` | 统一启动入口，支持 api/gui/rabbitmq 三种模式 |
| `启动GUI.bat` | 一键启动GUI界面（自动检查依赖） |
| `一键打包.bat` | 一键打包成可执行文件 |

### 核心模块

| 模块 | 作用 |
|------|------|
| `src/core/` | 核心业务逻辑（微信控制、窗口管理、消息队列） |
| `src/api/` | 对外API接口（HTTP API、UI自动化） |
| `src/rabbitmq/` | 消息队列集成（消费者、管理器） |
| `src/gui/` | 图形用户界面 |
| `src/utils/` | 辅助工具 |

### 配置与依赖

| 目录/文件 | 说明 |
|-----------|------|
| `config/config.json` | 主配置文件（token、端口、联系人等） |
| `config/requirements.txt` | API版本的Python依赖 |
| `config/requirements_gui.txt` | GUI版本的Python依赖 |

## 📚 文档说明

所有详细文档都在 `docs/` 目录下：

| 文档 | 说明 |
|------|------|
| `docs/使用说明.md` | 完整的使用说明 |
| `docs/GUI使用手册.md` | GUI界面使用手册 |
| `docs/RabbitMQ使用说明.md` | RabbitMQ集成说明 |
| `docs/快速启动指南.md` | 快速上手指南 |
| `docs/打包说明.md` | 打包部署说明 |
| `docs/🎉重构完成.md` | 重构完成说明 |
| `docs/📚文档索引.md` | 完整文档索引 |

## 🔧 开发说明


### 运行测试

```bash
# 运行所有测试
python -m pytest tests/

# 运行特定测试
python tests/test_api.py
python tests/test_rabbitmq.py
```

### 打包发布

```bash
# 方式1：使用批处理脚本
.\一键打包.bat

# 方式2：直接运行打包脚本
python src\utils\build_gui.py
```

## 📦 输出目录

| 目录 | 说明 |
|------|------|
| `build/` | PyInstaller 构建临时文件 |
| `dist/` | 打包输出目录 |
| `dist/微信机器人.exe` | 单文件可执行程序 |
| `dist/微信机器人_便携版/` | 便携版程序包 |

## ⚠️ 注意事项

1. **运行位置**：所有命令必须在项目根目录运行
2. **配置文件**：首次使用需从 `config.example.json` 复制并配置
3. **微信登录**：使用前确保微信PC客户端已登录
4. **Python版本**：需要 Python 3.7+

## 🎯 项目特点

- ✅ 模块化设计，结构清晰
- ✅ 支持 HTTP API 和 RabbitMQ 双模式
- ✅ 提供图形界面，易于使用
- ✅ 完善的文档和示例
- ✅ 支持打包成独立可执行文件

---

**更多信息请查看 `docs/` 目录下的详细文档**