refactor(core): 重构核心模块结构并添加开发文档

将核心模块按功能重新组织为更清晰的结构,包括 managers、handlers 和 utils 目录
添加完整的开发文档,涵盖快速开始、项目结构、核心概念和插件开发指南
更新所有相关模块的导入路径以匹配新的结构
将单例模式实现提取到单独的 singleton.py 文件
This commit is contained in:
2026-01-07 22:51:27 +08:00
parent c708761726
commit 56b1014419
45 changed files with 772 additions and 104 deletions

17
main.py
View File

@@ -5,19 +5,24 @@ NEO Bot 主程序入口
"""
import asyncio
import os
import sys
import time
# 将项目根目录添加到 sys.path
ROOT_DIR = os.path.dirname(os.path.abspath(__file__))
sys.path.insert(0, ROOT_DIR)
from watchdog.observers import Observer
from watchdog.events import FileSystemEventHandler
# 初始化日志系统,必须在其他 core 模块导入之前执行
from core.logger import logger
from core.utils.logger import logger
from core.admin_manager import admin_manager
from core.managers.admin_manager import admin_manager
from core.ws import WS
from core.plugin_manager import load_all_plugins
from core.redis_manager import redis_manager
from core.executor import run_in_thread_pool
from core.managers.plugin_manager import load_all_plugins
from core.managers.redis_manager import redis_manager
from core.utils.executor import run_in_thread_pool
class PluginReloadHandler(FileSystemEventHandler):
@@ -111,7 +116,7 @@ async def main():
# 初始化代码执行器
from core.config_loader import global_config as config
from core.executor import initialize_executor
from core.utils.executor import initialize_executor
code_executor = initialize_executor(bot, config)
bot.bot.code_executor = code_executor # 将执行器实例附加到 bot.bot 对象上