K2cr2O1
7f331970dd
- 简化插件开发指南中的描述，移除冗余内容 - 调整部署文档中的Python版本说明 - 优化最佳实践文档的措辞和格式 - 更新性能优化文档，删除不准确的数据 - 重构核心概念文档，使用更简洁的语言 - 修正README中的项目描述和技术栈说明 - 更新快速上手文档，简化安装步骤 - 调整事件流转文档的描述方式 - 简化架构文档内容 - 更新指令处理文档，添加参数注入示例 - 优化单例管理器文档的表述
3.5 KiB
3.5 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里。 - 会自动变通: 查权限的时候，它会把
AdminManager里的超管也当成ADMIN。
- 划分三六九等:
3. AdminManager (admin_manager)
- 怎么找:
from core.managers.admin_manager import admin_manager - 管啥:
- 钦差大臣: 专门管机器人的超级管理员，增删改查都在这。
- 三级缓存: 内存 -> 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就行。
咋用？
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("你没权限看这个。")