# WechatHookBot 项目简介

## 项目概述

**项目名称：** WechatHookBot
**创建时间：** 2025-01-12
**当前版本：** v0.1.0-dev
**项目状态：** 🚧 开发中

## 项目目标

基于个微大客户版 Hook API 构建一个类似 XYBotV2 的微信机器人框架，实现插件化、事件驱动的架构。

## 核心特性

- ✅ **无需登录系统**：Hook 已登录的微信客户端
- ✅ **插件化架构**：完全兼容 XYBotV2 插件系统
- ✅ **实时消息回调**：Socket 回调机制
- ✅ **轻量级设计**：无需 Redis 依赖

## 技术栈

- **语言：** Python 3.x (32位)
- **异步框架：** asyncio
- **DLL 调用：** ctypes
- **数据库：** SQLite + aiosqlite
- **定时任务：** APScheduler
- **Web 框架：** Flask + SocketIO (可选)

## 架构设计

```
DLL Hook 层 → WechatHook 层 → Bot 核心层 → 插件层 → WebUI 层
```

## 参考项目

- **XYBotV2** - 插件系统、事件管理、数据库架构
- **个微大客户版** - DLL Hook API 和调用示例

## 开发原则

1. **代码复用优先**：最大化复用 XYBotV2 代码
2. **最小化实现**：只写必要的代码
3. **不本地测试**：所有测试在远程设备进行
4. **文档先行**：保持 Memory Bank 实时更新

## 项目结构

```
WechatHookBot/
├── Memory Bank/          # 项目管理和进度跟踪
├── docs/                 # 技术文档
├── WechatHook/          # Hook 层实现
├── utils/               # 工具类（复用 XYBot）
├── database/            # 数据库（复用 XYBot）
├── plugins/             # 插件目录
├── WebUI/               # Web 界面（可选）
├── libs/                # DLL 文件
├── bot.py               # 主入口
└── main_config.toml     # 配置文件
```

## 关键里程碑

- [x] 文档系统完成
- [x] DLL 文件准备
- [ ] WechatHook 层实现
- [ ] Bot 核心层实现
- [ ] 插件系统集成
- [ ] 基础功能测试
- [ ] WebUI 实现（可选）

## 联系方式

**开发者：** Claude
**项目路径：** D:\project\shrobot\WechatHookBot\