项目架构
GracyBot 项目架构
项目结构
GracyBot/
├── bot.py # 主程序入口
├── requirements.txt # Python依赖列表
├── core/ # 核心框架
│ ├── config.py # 配置文件
│ ├── handler.py # 消息处理器
│ ├── plugin_manager.py # 插件管理器
│ ├── security.py # 安全模块
│ └── utils.py # 工具函数
└── plugins/ # 插件目录
└── [插件目录]/ # 标准插件结构
├── __init__.py # 插件元数据
├── [插件名].py # 插件功能实现
└── others/ # 插件资源目录（根据开发需求自选）
框架构造简述
核心架构：
- bot.py：Flask服务器入口，处理NapCat的HTTP回调请求
- core/handler.py：消息分发中心，解析并路由到对应插件
- core/plugin_manager.py：动态插件加载器，管理插件生命周期
- core/config.py：统一配置管理中心
- core/security.py：安全防护模块
- core/utils.py：通用工具函数库
工作流程：
QQ消息 → NapCat → HTTP回调 → bot.py → handler.py → plugin_manager → 匹配插件处理 → 返回响应
框架特色
模块化设计
核心框架与业务逻辑分离，结构清晰易维护
动态插件系统
支持热加载和独立开发，扩展灵活
统一配置管理
集中式配置，便于部署和参数调整
内置安全机制
保障系统稳定运行，抵御常见风险
双场景支持
兼容私聊、群聊消息处理，适配多场景
插件资源独立
插件资源单独管理，降低开发耦合度
框架采用简洁高效的设计理念，为插件开发提供稳定基础，同时保持核心功能的轻量化和可扩展性，兼顾易用性与灵活性。