WechatHookBot/docs/MemoryBank/01-项目概述.md

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 管理界面
• 数据统计功能