105 lines
2.2 KiB
Markdown
105 lines
2.2 KiB
Markdown
# WechatHookBot
|
||
|
||
基于个微大客户版 Hook API 的微信机器人框架，参考 XYBotV2 架构设计。
|
||
|
||
## 项目特点
|
||
|
||
- 🎯 **无需登录**：Hook 已登录的微信客户端，无需二维码登录
|
||
- 🔌 **插件化**：完全兼容 XYBotV2 插件系统
|
||
- ⚡ **实时回调**：Socket 回调机制，消息接收更及时
|
||
- 🚀 **轻量级**：无需 Redis，架构更简单
|
||
|
||
## 技术栈
|
||
|
||
- Python 3.x (32位)
|
||
- asyncio 异步编程
|
||
- ctypes DLL 调用
|
||
- SQLite 数据库
|
||
- APScheduler 定时任务
|
||
- Flask + SocketIO (WebUI)
|
||
|
||
## 快速开始
|
||
|
||
### 环境要求
|
||
|
||
- Windows 系统
|
||
- Python 3.x (32位版本)
|
||
- 微信客户端已登录
|
||
|
||
### 安装
|
||
|
||
```bash
|
||
cd WechatHookBot
|
||
pip install -r requirements.txt
|
||
```
|
||
|
||
### 配置
|
||
|
||
编辑 `main_config.toml` 配置文件：
|
||
|
||
```toml
|
||
[WechatHook]
|
||
loader-dll = "libs/Loader.dll"
|
||
helper-dll = "libs/Helper.dll"
|
||
|
||
[Bot]
|
||
admins = ["your_wxid"]
|
||
disabled-plugins = []
|
||
```
|
||
|
||
### 运行
|
||
|
||
```bash
|
||
# 简单启动（无 WebUI）
|
||
python bot.py
|
||
|
||
# 完整启动（带 WebUI）
|
||
python app.py
|
||
```
|
||
|
||
## 项目结构
|
||
|
||
```
|
||
WechatHookBot/
|
||
├── docs/ # 文档目录
|
||
│ ├── 架构设计.md
|
||
│ ├── 插件开发.md
|
||
│ └── API文档.md
|
||
├── WechatHook/ # Hook 层
|
||
├── utils/ # 工具类
|
||
├── database/ # 数据库
|
||
├── plugins/ # 插件目录
|
||
├── WebUI/ # Web 管理界面
|
||
├── libs/ # DLL 文件
|
||
├── bot.py # 主入口
|
||
├── app.py # WebUI 入口
|
||
└── main_config.toml # 主配置
|
||
```
|
||
|
||
## 文档
|
||
|
||
- [架构设计](docs/架构设计.md) - 技术架构和设计思路
|
||
- [插件开发](docs/插件开发.md) - 插件开发指南
|
||
- [API 文档](docs/API文档.md) - WechatHook API 说明
|
||
|
||
## 注意事项
|
||
|
||
⚠️ **重要提示**
|
||
|
||
- 必须使用 32位 Python
|
||
- 需要微信客户端在运行
|
||
- DLL 可能被杀毒软件拦截，需添加信任
|
||
- Hook 方式风控风险较高，谨慎使用
|
||
|
||
## 免责声明
|
||
|
||
本项目仅供学习和技术研究使用，不得用于任何商业或非法行为。使用本工具造成的任何后果由使用者自行承担。
|
||
|
||
## 开发状态
|
||
|
||
🚧 项目开发中...
|
||
|
||
## License
|
||
|
||
MIT License
|