feat:初版

This commit is contained in:
2025-12-03 15:48:44 +08:00
commit b4df26f61d
199 changed files with 23434 additions and 0 deletions

View File

@@ -0,0 +1,84 @@
# WechatHookBot 项目概述
## 项目信息
- **项目名称**: WechatHookBot
- **版本**: v1.0.0
- **创建时间**: 2025-11-12
- **项目类型**: 微信机器人框架
- **技术栈**: Python 3.11 (32位), asyncio, ctypes
## 项目简介
基于个微大客户版 Hook API 的微信机器人框架,通过 DLL 注入方式实现微信消息的接收和发送。
## 核心特性
1. **DLL Hook 技术**
- 使用 Loader.dll 和 Helper.dll 注入微信进程
- 通过 Socket 回调接收消息
- 支持微信版本: 2.84.18.17
2. **插件系统**
- 基于事件驱动的插件架构
- 支持热重载(无需重启)
- 装饰器风格的事件处理
- 插件启用/禁用管理
3. **消息处理**
- 支持文本、图片、视频、文件等多种消息类型
- 群聊和私聊消息处理
- 消息过滤(白名单/黑名单)
- @消息识别
4. **AI 集成**
- 支持自定义 AI API
- 可切换人设(通过 txt 文件)
- 多种触发模式(全部/提及/@/关键词
## 项目结构
```
WechatHookBot/
├── bot.py # 主入口
├── main_config.toml # 主配置文件
├── requirements.txt # 依赖列表
├── libs/ # DLL 文件
│ ├── Loader.dll
│ └── Helper.dll
├── WechatHook/ # Hook API 封装
│ ├── loader.py # DLL 加载器
│ ├── client.py # API 客户端
│ ├── callbacks.py # 回调处理
│ └── message_types.py # 消息类型定义
├── utils/ # 工具模块
│ ├── hookbot.py # 机器人核心
│ ├── plugin_manager.py # 插件管理器
│ ├── event_manager.py # 事件管理器
│ └── decorators.py # 装饰器
├── plugins/ # 插件目录
│ ├── AIChat/ # AI 聊天插件
│ ├── ManagePlugin/ # 插件管理插件
│ └── ExamplePlugin/ # 示例插件
└── docs/ # 文档目录
└── MemoryBank/ # 内存银行
```
## 当前状态
**已完成**:
- DLL Hook 集成
- 消息接收和发送
- 插件系统框架
- AI 聊天插件
- 插件管理功能
- 热重载支持
🚧 **进行中**:
- 测试和调试
- 文档完善
📋 **待开发**:
- 更多插件功能
- Web 管理界面
- 数据统计功能