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

将核心模块按功能重新组织为更清晰的结构，包括 managers、handlers 和 utils 目录
添加完整的开发文档，涵盖快速开始、项目结构、核心概念和插件开发指南
更新所有相关模块的导入路径以匹配新的结构
将单例模式实现提取到单独的 singleton.py 文件

plugins/admin.py

@@ -4,8 +4,8 @@
 提供通过聊天指令动态添加或移除机器人管理员的功能。
 """
 from core.bot import Bot
-from core.command_manager import matcher
-from core.admin_manager import admin_manager
+from core.managers.command_manager import matcher
+from core.managers.admin_manager import admin_manager
 from models.events.message import MessageEvent
 
 __plugin_meta__ = {

plugins/bili_parser.py

@@ -5,8 +5,8 @@ import requests
 from bs4 import BeautifulSoup
 from typing import Optional, Dict, Any
 
-from core.logger import logger
-from core.command_manager import matcher
+from core.utils.logger import logger
+from core.managers.command_manager import matcher
 from models import MessageEvent, MessageSegment
 
 __plugin_meta__ = {

plugins/broadcast.py

@@ -7,10 +7,10 @@
 - 此插件不写入 __plugin_meta__，保持隐藏。
 """
 import asyncio
-from core.command_manager import matcher
+from core.managers.command_manager import matcher
 from models import MessageEvent, PrivateMessageEvent
-from core.permission_manager import ADMIN
-from core.logger import logger
+from core.managers.permission_manager import ADMIN
+from core.utils.logger import logger
 
 # --- 会话状态管理 ---
 # 结构: {user_id: asyncio.TimerHandle}

plugins/code_py.py

@@ -4,10 +4,10 @@ import textwrap
 import asyncio
 from typing import Dict
 
-from core.command_manager import matcher
+from core.managers.command_manager import matcher
 from models import MessageEvent
-from core.permission_manager import ADMIN
-from core.logger import logger
+from core.managers.permission_manager import ADMIN
+from core.utils.logger import logger
 
 __plugin_meta__ = {
     "name": "Python 代码执行",

plugins/echo.py

@@ -3,7 +3,7 @@ Echo 与交互插件
 
 提供 /echo 和 /赞我 指令。
 """
-from core.command_manager import matcher
+from core.managers.command_manager import matcher
 from core.bot import Bot
 from models import MessageEvent
 

plugins/forward_test.py

@@ -1,7 +1,7 @@
 """
 合并转发消息测试插件
 """
-from core.command_manager import matcher
+from core.managers.command_manager import matcher
 from core.bot import Bot
 from models import MessageEvent
 from models.message import MessageSegment

plugins/jrcd.py

@@ -8,8 +8,8 @@ import random
 from datetime import datetime
 
 from core.bot import Bot
-from core.command_manager import matcher
-from core.executor import run_in_thread_pool
+from core.managers.command_manager import matcher
+from core.utils.executor import run_in_thread_pool
 from models import MessageEvent, MessageSegment
 
 __plugin_meta__ = {

plugins/sync_async_test_plugin.py

@@ -5,10 +5,10 @@
 """
 import time
 from typing import Any
-from core.command_manager import matcher
-from core.executor import run_in_thread_pool
+from core.managers.command_manager import matcher
+from core.utils.executor import run_in_thread_pool
 from core.bot import Bot
-from core.logger import logger
+from core.utils.logger import logger
 
 # 插件元数据
 __plugin_meta__ = {

plugins/thpic.py

@@ -6,7 +6,7 @@ thpic 插件
 """
 
 from core.bot import Bot
-from core.command_manager import matcher
+from core.managers.command_manager import matcher
 from models import MessageEvent, MessageSegment
 
 __plugin_meta__ = {