# wxqunfa **Repository Path**: lisonsong/wxqunfa ## Basic Information - **Project Name**: wxqunfa - **Description**: 微信群发工具 这是一个基于PyQt5和UI自动化的微信消息批量发送工具，采用标准的Python项目结构，便于维护和扩展。 支持微信PC端版本：V3.9 V4.1 - **Primary Language**: Python - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2025-10-15 - **Last Updated**: 2025-10-17 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 微信自动群发工具 ## 项目概述 这是一个基于PyQt5和UI自动化的微信消息批量发送工具，采用标准的Python项目结构，便于维护和扩展。 支持微信PC端版本：V3.9 V4.1 ## 项目结构 项目按照标准的Python包结构组织，遵循最佳实践： ``` wxqunfa/ ├── src/ # 源代码目录 │ └── wxqunfa/ # 主包 │ ├── __init__.py # 包初始化文件 │ ├── core/ # 核心功能模块 │ │ ├── __init__.py │ │ ├── window_manager.py # 窗口管理 │ │ ├── ui_automation.py # UI自动化 │ │ ├── calibration_manager.py # 坐标校准管理 │ │ ├── config_manager.py # 配置管理 │ │ └── thread_manager.py # 信息发送管理 │ ├── ui/ # 用户界面模块 │ │ ├── __init__.py │ │ └── main_window.py # 主窗口界面 │ └── utils/ # 工具模块 │ ├── __init__.py │ └── calibration_tool.py # 坐标校准工具 ├── tests/ # 测试文件 │ ├── test_mouse.py # 鼠标监听测试 │ └── test_wechat.py # 微信窗口检测测试 ├── data/ # 数据文件 │ ├── calibration_data.pkl # 校准数据 │ └── contacts.txt # 联系人列表 ├── config/ # 配置文件 │ └── config.json # 应用配置 ├── docs/ # 文档目录 ├── main.py # 程序入口 ├── requirements.txt # 依赖包列表 └── README.md # 项目说明 ``` ### 功能界面 ![功能界面](docs/wechat_2025-10-15_153650_758.png) ### 模块功能说明 #### 核心模块 (src/wxqunfa/core/) - **window_manager.py**: 微信窗口检测和管理 - **ui_automation.py**: 微信界面自动化操作 - **calibration_manager.py**: 坐标校准数据管理 - **config_manager.py**: 应用配置管理 - **thread_manager.py**: 消息发送管理 #### 用户界面模块 (src/wxqunfa/ui/) - **main_window.py**: GUI主界面实现 #### 工具模块 (src/wxqunfa/utils/) - **calibration_tool.py**: 坐标校准工具界面 ## 模块依赖关系 ``` main.py → wxqunfa.ui.main_window → wxqunfa.core.window_manager → wxqunfa.utils.calibration_tool → wxqunfa.core.thread_manager → wxqunfa.core.ui_automation ``` ## 安装说明 ### 1. 安装Python依赖 ```bash pip install -r requirements.txt ``` ### 2. 运行程序 ```bash python main.py ``` ### 3. 运行测试 ```bash # 测试鼠标监听功能 python tests/test_mouse.py # 测试微信窗口检测 python tests/test_wechat.py ``` ## 使用说明 1. **启动微信**: 确保微信PC版已登录并处于可见状态 2. **运行程序**: 执行 `python main.py` 启动工具 3. **坐标校准**: 首次使用需要进行坐标校准 4. **导入联系人**: 准备联系人列表文件 5. **设置消息**: 输入要发送的消息内容 6. **开始发送**: 设置发送间隔后开始批量发送 ## 功能特性 - ✅ 微信窗口自动检测和激活 - ✅ 联系人搜索和选择 - ✅ 消息批量发送 - ✅ 发送间隔控制 - ✅ 坐标自动校准 - ✅ 配置化管理 ## 开发规范 项目遵循以下开发规范： 1. **代码风格**: 严格遵循PEP 8规范 2. **命名规范**: 类名使用PascalCase，变量和函数名使用camelCase 3. **注释规范**: 所有函数都有详细的文档字符串 4. **模块职责**: 每个模块有明确的单一职责 5. **错误处理**: 完善的异常捕获和处理机制 6. **项目结构**: 采用标准的Python包结构 ## 注意事项 - 请确保微信窗口未被其他程序遮挡 - 发送间隔建议设置在3秒以上，避免被微信限制 - 使用前请先进行坐标校准以确保功能正常 - 建议在非工作时间使用，避免影响正常聊天 ## 许可证 本项目仅供学习和研究使用，请遵守相关法律法规。