6b9bdeeff2
* fix(discord): 修复 WebSocket 连接检测并增强跨平台文件处理 修复 Discord WebSocket 连接检测逻辑，使用正确的属性检查连接状态 为跨平台消息处理添加文件类型支持，并增加详细的调试日志 优化附件处理逻辑，确保所有文件类型都能正确识别和转发 * feat(跨平台): 优化消息处理并添加纯文本提取功能 添加 extract_text_only 函数过滤非文本标记 修改翻译逻辑仅处理纯文本内容 完善附件处理和消息内容拼接 修复仅包含表情时的消息处理问题 * refactor(discord-cross): 使用模块专用日志记录器替换全局日志记录器 将各模块中的全局日志记录器替换为模块专用日志记录器，以提供更清晰的日志来源标识 同时在适配器中添加会话状态检查和重连机制，提升消息发送的可靠性 * feat(翻译): 改进翻译功能，同时显示原文和译文 修改翻译功能，不再替换原文而是同时显示原文和翻译内容，方便用户对照 更新 DeepSeek API 配置为官方地址和模型 优化 Discord 适配器的重连逻辑，直接关闭 WebSocket 触发重连 修复 Discord 频道 ID 转换逻辑，简化处理流程 * feat(cross-platform): 添加跨平台功能支持及配置优化 - 新增跨平台配置模型和全局配置支持 - 优化 Discord 适配器的连接管理和错误处理 - 添加 watchdog 和 discord.py 依赖 - 创建 DeepSeek API 配置文档 - 移除重复的同步帮助图片代码 - 改进跨平台插件配置加载逻辑 * fix(jrcd): 修正群组ID检查条件 删除不再使用的示例插件文件 * feat: 改进配置加载逻辑并更新项目配置 当配置文件不存在时自动生成示例配置 添加pyproject.toml作为项目构建配置 更新.gitignore忽略更多文件类型 删除不再使用的反向WebSocket示例文件 * docs: 更新架构文档和项目结构说明 添加反向WebSocket连接模式说明 补充核心管理器文档 更新项目结构文件 在文档首页添加特色功能说明 * fix(discord): 修复WebSocket连接检查并添加错误日志 refactor(config): 更新配置文件的网络和认证信息 feat(cross-platform): 为跨平台消息处理添加异常捕获和日志
4.7 KiB
4.7 KiB
核心概念：单例管理器
core/managers/ 这地方，放的都是些管事的。它们是 NEO Bot 的核心。梨花飘落在你窗前。。。
为啥是单例？
就是全局独一份。
- 到处都能用: 在插件里
import就行，不用传来传去。 - 数据不打架: 权限、命令这些东西，全局就一份，改了都认。
- 省资源: Redis 连接池、浏览器这种东西，开一个就够了，多了浪费。
我专门在 core/utils/singleton.py 搞了个基类，继承一下就行，你会的，加油。。。
认识一下
1. CommandManager (matcher)
- 怎么找:
from core.managers.command_manager import matcher - 管啥:
- 总调度: 所有消息都得从它这过一遍
- 发牌的: 你用的
@matcher.command()这种装饰器，就是它发的。 - 对号入座: 消息来了，它负责对一下，看是哪个插件的。
写插件天天都得跟它打交道。
2. PermissionManager (permission_manager)
- 怎么找:
from core.managers.permission_manager import permission_manager - 管啥:
- 划分三六九等:
ADMIN,OP,USER这些等级都是它定的。 - 管理权限: 谁有啥权限，都记在
core/data/permissions.json里。 - 管理员管理: 超级管理员的增删改查也在这里，统一管理。
- 双重存储: 普通权限存储在 Redis Hash 中，管理员列表存储在 Redis Set 中。
- 原子操作: 所有写操作都采用原子操作，确保数据一致性。详见 Redis 原子操作与数据一致性
- 划分三六九等:
4. PluginManager
- 管啥:
- 拉人头: 启动时把
plugins/目录下的插件都拉进来。 - 热更新: 你改了插件代码，它负责重载，不用重启机器人。
- 拉人头: 启动时把
这一般在幕后，你基本不用找它。
5. RedisManager (redis_manager)
- 怎么找:
from core.managers.redis_manager import redis_manager - 管啥:
- 接线员: 管着和 Redis 的连接。
- 提供工具: 你要用 Redis，就找
redis_manager.redis。
6. BrowserManager (browser_manager)
- 怎么找:
from core.managers.browser_manager import browser_manager - 管啥:
- 浏览器: 负责启动和关闭 Playwright。
- 页面池: 提前准备好几个空白页面（默认3个），你要用直接拿
- 循环利用: 用完记得还回来 (
release_page)
7. ImageManager (image_manager)
- 怎么找:
from core.managers.image_manager import image_manager - 管啥:
- 美工: 把数据塞进网页模板
- 记性好: 模板用一次就记住，下次直接用缓存。
- 自动借还: 它会自动找
BrowserManager借页面，你只管render_template就行。
8. BotManager (bot_manager)
- 怎么找:
from core.managers.bot_manager import bot_manager - 管啥:
- Bot 实例管理: 统一管理 Bot 实例，方便在任何地方获取当前运行的 Bot。
- 生命周期: 协助管理 Bot 的启动和关闭流程。
9. MysqlManager (mysql_manager)
- 怎么找:
from core.managers.mysql_manager import mysql_manager - 管啥:
- 数据库连接: 管理与 MySQL 数据库的异步连接池。
- 数据持久化: 提供执行 SQL 语句的接口，用于需要长期保存的数据。
10. ReverseWsManager (reverse_ws_manager)
- 怎么找:
from core.managers.reverse_ws_manager import reverse_ws_manager - 管啥:
- 反向 WS 服务: 启动并管理反向 WebSocket 服务器，允许 OneBot 客户端主动连接 Bot。
- 连接管理: 处理客户端的连接、断开和消息接收。
11. ThreadManager (thread_manager)
- 怎么找:
from core.managers.thread_manager import thread_manager - 管啥:
- 线程池管理: 提供全局的线程池执行器，用于执行阻塞的同步任务。
- 异步桥接: 方便地将同步函数转换为异步调用，避免阻塞事件循环。
咋用？
import
例子: 查查这人是不是op
# plugins/my_plugin.py
from core.managers.command_manager import matcher
from core.managers.permission_manager import permission_manager, ADMIN
from models.events.message import MessageEvent
@matcher.command("secret")
async def secret_command(event: MessageEvent):
# 只有管理员能看
is_admin = await permission_manager.check_permission(event.user_id, ADMIN)
if is_admin:
await event.reply("这是秘密！")
else:
await event.reply("你没权限看这个。")