Melobot

Latest version: v3.0.0

Safety actively analyzes 693883 Python packages for vulnerabilities to keep your Python projects secure.

Scan your dependencies

Page 1 of 2

3.0.0

⚠️特别:
- **melobot v3 是跨平台、跨协议、支持多路 IO 及其他高级特性的 bot 开发框架,与 v2 完全不兼容。**
- v3 文档教程:[melobot docs](https://docs.melobot.org)

| 特色 | 描述 |
| -------------- | ------------------------------------------------------------ |
| 实用接口 | 封装高频使用的异步逻辑,使业务开发更简洁 |
| 插件管理 | 低耦合度、无序的插件加载与通信 |
| 处理流设计 | 可自由组合“处理中间件”为处理流,提升了各组件的复用率 |
| 热插拔/重启 | 处理流支持动态热插拔,支持 bot 级别的重启 |
| 会话支持 | 可在处理流中自动传递的、可自定义的会话上下文 |
| 协议支持 | 所有协议被描述为 IO 过程,因此支持各类协议 |
| 跨平台 | 更简洁的跨平台接口,便捷实现跨平台插件开发 |
| 跨协议 IO | 支持多个协议实现端同时输入,自由输出到指定协议实现端 |
| 日志支持 | 日志记录兼容标准库和绝大多数日志框架,可自行选择 |

✨ 特性

3.0.0rc21

- 项目各处类型注解的改进 1bd87605299384147914081a024b8a3b961e16e6
- OneBot v11 协议中自定义消息段类型创建和解析 3026543d58cc7515260819c23cc4b8473e11864a 51f7cbec097a559be2d4ae401ccfeaf14b8e06f3 f006ee0ccfbf21e84c56456ab09618477f29582a 819489f43a8b5098ed141429d81448c67d8dd9b5
- OneBot v11 正向 websocket IO 源忽略 bot 停止信号 da0e3df2bd7c0e8deaaf594c3901bc2263a3aaed
- 文档与内置异常提示更正

♥️新贡献者
* Asankilp 首次提交 https://github.com/Meloland/melobot/pull/14
* NingmengLemon 首次提交 https://github.com/Meloland/melobot/pull/15

2.2.0

⚠️特别:
- **从 melobot v2.2.0 开始,版本支持为 python >= 3.10。**

✨ 新增
- 新增 api:`notice_event()`, `req_event()`, `meta_event()`, `msg_event()`。用于获取不同情景下的事件。
- event 和 action 现提供 `mark()` 和 `flag_check()` 方法,用于添加标记、进行标记检查。
- MessageEvent 现支持 `get_cq_params()` 和 `get_cq()` 方法,用于从 event 中提取 cq 消息段和 cq 消息参数。
- 各类文本匹配器(matcher)现支持字符串列表(**list[str]**)入参,同时对于 **list[str]** 型参数,可启用指定逻辑模式进行工作(and, or, not, xor)。

⏩变更
- 获取事件接口 event() 现已细化为四个接口:`notice_event()`, `req_event()`, `meta_event()`, `msg_event()`。实质上都是返回当前 session 下的 event,但新的 api 对 IDE 类型提示功能更友好。
- 获取 cq 参数方法 `get_cq()` 现已改为 `cq_get_params()`。
- **PriorityLevel** 类更名为 **PriorLevel**。
- **MsgEvent** 类更名为 **MessageEvent**。
- bot 生命周期阶段 `BotLife.EVENT_RECEIVED` 更名为 `BotLife.EVENT_BUILT`。
- 修改了 **session.args** 的返回类型,现在的返回类型为 **Dict[str, ParseArgs] | List[Any] | None**。若为 **Dict[str, ParseArgs]** 类型,可使用支持该类型的内置格式化器 **ArgFormatter** 进行格式化。

👍修复
- 修复了在 session 下发送 action 时尝试附加不存在的 event 的错误。
- 修复了 **MessageEvent** 在格式化化 cq 参数时,将 int 类型进一步转换为 float 类型的错误。
- 修复了加载插件时,因加载顺序导致的 **PluginStore** 共享对象重复创建的错误。
- 重写了部分不具体、不清晰、拥有潜在运行隐患的类型标注。
- 修改了部分设计逻辑不合理的内部组件。

2.1.0

> 不重要:修改了内部某些方法的类型标注和定义

2.0.0

v2 版本现已发布!(\*^▽^\*)

✨ v2 新版特色
- 基于 asyncio 的高性能异步
- 插件化管理
- 异步的自动上下文(会话)
- 可高度自定义的中间件功能
- 权限检查、规则校验、解析组件等
- 支持生命周期 hook
- 人性化、丰富的接口设计

📦️ 食用方法
python
pip install melobot


版本支持:
- python >= 3.8
- platform == All(mac 平台未测试)
- OneBot 标准 >= 11

1.2.1

- 修复了向不在白名单的群聊发送命令后,响应“权限不足”提示消息的 bug
- 修复了 logs 日志文件夹不会自动创建的 bug

Page 1 of 2

© 2025 Safety CLI Cybersecurity Inc. All Rights Reserved.