WechatHookBot/Memory Bank/projectBrief.md

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     # 配置文件

关键里程碑

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

联系方式

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