NoneBot2 进阶教程：深入理解会话更新机制-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00245/article/details/148465443

NoneBot2 进阶教程：深入理解会话更新机制

nonebot2 跨平台 Python 异步聊天机器人框架 / Asynchronous multi-platform chatbot framework written in Python 项目地址: https://gitcode.com/gh_mirrors/no/nonebot2

什么是会话更新

在 NoneBot2 框架中，会话更新是一个核心概念，它决定了机器人如何与用户进行持续交互。当用户触发一个事件响应器后，系统就进入了会话状态，这个状态会持续到整个交互流程结束。在这个过程中，NoneBot2 通过会话更新机制来动态调整机器人的响应行为。

会话更新的两个维度

1. 事件响应器类型更新

默认情况下，会话更新后会响应所有消息类型（message）。但有时我们需要更精确地控制响应类型：

from nonebot import on_message

# 创建一个消息事件响应器
weather_query = on_message()

@weather_query.type_updater
async def update_type() -> str:
    # 修改为只响应通知类型事件
    return "notice"

实际应用场景：

当需要用户发送特定格式的消息时
在等待系统通知而非用户输入时
实现多步骤表单填写流程

2. 事件触发权限更新

权限更新决定了哪些用户可以继续与会话交互：

from nonebot import on_message
from nonebot.permission import User, Permission

game_session = on_message()

@game_session.permission_updater
async def update_permission(event: Event) -> Permission:
    # 只允许触发事件的用户继续交互
    return User.from_event(event)

高级会话控制技巧

多用户会话实现

通过自定义权限更新函数，可以实现多人参与的会话场景：

from nonebot.permission import USER

group_game = on_message()

@group_game.permission_updater
async def multi_user_permission() -> Permission:
    # 允许session1和session2两个用户参与
    return USER("session1", "session2")

应用场景：

多人游戏房间
小组协作任务
群组投票系统

动态会话控制

结合状态管理，可以实现更智能的会话流程：

from nonebot.params import Depends
from nonebot.matcher import Matcher

order_process = on_message()

@order_process.type_updater
async def dynamic_type(matcher: Matcher = Depends()) -> str:
    # 根据当前步骤决定响应类型
    current_step = matcher.state.get("step", 0)
    return "message" if current_step < 3 else "notice"