nonebot-plugin-alconna 0.46.2

Alconna Adapter for Nonebot

NoneBot Plugin Alconna

✨ Alconna Usage For NoneBot2 ✨

该插件提供了 Alconna 的 NoneBot2 适配版本与工具

特性

• 完整的 Alconna 特性支持
• 自动回复命令帮助信息选项
• 跨平台的接收与发送消息(被动+主动)
• 对20种适配器的收发消息支持
• 比 got-reject 更强大的补全会话机制
• 多种内置插件 (echo，help，lang)
• i18n 支持

讨论

QQ 交流群: 链接

使用方法

NoneBot 文档: 📖这里 仓库内介绍: 📦这里

跨平台消息

from nonebot import get_driver
from nonebot_plugin_alconna import UniMessage, SupportScope, on_alconna

driver = get_driver
test = on_alconna("test")

@test.handle()
async def handle_test():
    r = await UniMessage.image(path="path/to/img").send()
    if r.recallable:
        await r.reply("图片已发送，10秒后撤回")
        await r.recall(delay=10, index=0)

@test.got("foo", prompt=UniMessage.template("{:Reply($message_id)}请输入图片"))
async def handle_foo():
    await test.send("图片已收到")

@driver.on_startup
async def_():
    await Target.group("123456789", SupportScope.qq_client).send(UniMessage.image(path="test.png"))

支持的适配器:

协议名称	路径
OneBot 协议	adapters.onebot11, adapters.onebot12
Telegram	adapters.telegram
飞书	adapters.feishu
GitHub	adapters.github
QQ bot	adapters.qq
钉钉	adapters.ding
Console	adapters.console
开黑啦	adapters.kook
Mirai	adapters.mirai, adapters.mirai2
Ntchat	adapters.ntchat
MineCraft	adapters.minecraft
BiliBili Live	adapters.bilibili
Walle-Q	adapters.onebot12
Discord	adapters.discord
Red 协议	adapters.red
Satori	adapters.satori
Dodo IM	adapters.dodo
Kritor	adapters.kritor
Tailchat	adapters.tailchat

配置项

• ALCONNA_AUTO_SEND_OUTPUT : 是否全局启用输出信息自动发送
• ALCONNA_USE_COMMAND_START : 是否将 COMMAND_START 作为全局命令前缀
• ALCONNA_AUTO_COMPLETION: 是否全局启用补全会话功能
• ALCONNA_USE_ORIGIN: 是否全局使用原始消息 (即未经过 to_me 等处理的)
• ALCONNA_USE_PARAM: 是否使用特制的 Param 提供更好的依赖注入
• ALCONNA_USE_CMD_SEP: 是否将 COMMAND_SEP 作为全局命令分隔符
• ALCONNA_GLOBAL_EXTENSIONS: 全局加载的扩展, 路径以 . 分隔, 如 foo.bar.baz:DemoExtension
• ALCONNA_CONTEXT_STYLE: 全局命令上下文插值的风格，None 为关闭，bracket 为 {...}，parentheses 为 $(...)
• ALCONNA_ENABLE_SAA_PATCH: 是否启用 SAA 补丁
• ALCONNA_APPLY_FILEHOST: 是否启用文件托管
• ALCONNA_APPLY_FETCH_TARGETS: 是否启动时拉取一次发送对象列表

插件示例

demo bot

# echo 插件
from nonebot_plugin_alconna import UniMessage, Command

@Command("echo <...content>").build(auto_send_output=True).handle()
async def _(content: UniMessage):
    await content.finish()