过时的功能
session.get() 和参数解析器
在指南中我们提到了我们可以使用 CommandSession.aget 来在命令会话中与用户交互，那么为什么它的名字前面有一个 a 呢？
因为这代表着 「异步地取得」 (opens new window)。同样地，在 1.8.0 之前我们普遍使用的是同步的 get 方法，例如在那里所提及的天气插件，实现类似的功能我们要使用如下的代码：
from nonebot import on_command, CommandSession
@on_command('weather', aliases=('天气', '天气预报', '查天气'))
async def weather(session: CommandSession):
# 从会话状态（session.state）中获取城市名称（city），如果当前不存在，则询问用户
city = session.get('city', prompt='你想查询哪个城市的天气呢？')
weather_report = await get_weather_of_city(city)
await session.send(weather_report)
# weather.args_parser 装饰器将函数声明为 weather 命令的参数解析器
# 命令解析器用于将用户输入的参数解析成命令真正需要的数据
@weather.args_parser
async def _(session: CommandSession):
# 去掉消息首尾的空白符
stripped_arg = session.current_arg_text.strip()
if session.is_first_run:
# 该命令第一次运行（第一次进入命令会话）
if stripped_arg:
# 第一次运行参数不为空，意味着用户直接将城市名跟在命令名后面，作为参数传入
# 例如用户可能发送了：天气 南京
session.state['city'] = stripped_arg
return
if not stripped_arg:
# 用户没有发送有效的城市名称（而是发送了空白字符），则提示重新输入
# 这里 session.pause() 将会发送消息并暂停当前会话（该行后面的代码不会被运行）
session.pause('要查询的城市名称不能为空呢，请重新输入')
# 如果当前正在向用户询问更多信息（例如本例中的要查询的城市），且用户输入有效，则放入会话状态
session.state[session.current_key] = stripped_arg
async def get_weather_of_city(city: str) -> str:
# 这里简单返回一个字符串
# 实际应用中，这里应该调用返回真实数据的天气 API，并拼接成天气预报内容
return f'{city}的天气是……'
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
在这里，我们有三个概念需要介绍：session.get，会话的状态 (state)，和参数解析器。
@on_command('weather', aliases=('天气', '天气预报', '查天气'))
async def weather(session: CommandSession):
2
首先，session.get() 函数调用尝试从当前会话（Session）的状态中获取 city 这个参数，所有的参数和会话中需要暂存的临时数据都被存储在 session.state 变量（一个 dict）中，如果发现存在，则直接返回，并赋值给 city 变量，而如果 city 参数不存在，session.get() 会中断这次命令处理的流程，并保存当前会话，然后向用户发送 prompt 参数的内容。这里的「中断」，意味着如果当前不存在 city 参数，session.get() 之后的代码将不会被执行，这是通过抛出异常做到的。
向用户发送 prompt 中的提示之后，会话会进入等待状态，此时我们称之为「当前用户正在 weather 命令的会话中」，当用户再次发送消息时，NoneBot 会唤起这个等待中的会话，并重新执行命令，也就是从头开始重新执行上面的这个函数，如果用户在一定时间内都没有再次跟机器人发消息，则会话因超时被关闭。
使用此方式实现交互的命令会同时可选地搭配一个参数解析器：
@weather.args_parser
async def _(session: CommandSession):
2
参数解析器的 session 参数和命令处理函数一样，都是当前命令的会话对象。并且，参数解析器会在命令处理函数之前执行，以确保正确解析参数以供后者使用。
上面的例子中，参数解析器会判断当前是否是该会话第一次运行（用户刚发送 /天气，触发了天气命令）。如果是，则检查用户触发天气命令时有没有附带参数（即 stripped_arg 是否有内容），如果带了参数（例如用户发送了 /天气 南京），则把附带的参数当做要查询的城市放进会话状态 session.state，以 city 作为状态的 key——也就是说，如果用户触发命令时就给出了城市，则命令处理函数中的 session.get('city') 就能直接返回结果，而不用提示用户输入。
如果该会话不是第一次运行，那就说明命令处理函数中向用户询问了更多信息，导致会话被中断，并等待用户回复（也就是 session.get() 的效果）。这时候需要判断用户输入是不是有效，因为我们已经明确地询问了，如果用户此时发送了空白字符，显然这是没有意义的内容，需要提示用户重新发送。相反，如果有效的话，则直接以 session.current_key 作为 key（也就是 session.get() 的第一个参数，上例中只有可能是 city），将输入内容存入会话状态。
此时，对机器人说话其响应应为：
> /天气 南京
南京的天气是……
> /天气
你想查询哪个城市的天气呢？
> 南京
南京的天气是……
2
3
4
5
6
7
使用此方式编写命令通常比较复杂且需要维持状态机，所以一般我们偏好使用 aget 或 apause。
权限声明常量
在 1.9.0 版本之前，NoneBot 是使用 int 类型的枚举来表示权限的。在 on_command 和 on_natural_language 中的 permission 参数曾经也是 int 类型。例如 PRIVATE == 0b0000 0000 1111, GROUP_ADMIN == 0b0010 0000 0000 (opens new window) 等。这样做的好处是仅需一个整形值就可以方便地表示多种可能性，以及支持使用 | 操作符组合。
当 NoneBot 收到用户的消息时，其会根据上报的事件为此用户生成一个权限值。假设此消息为好友私聊，则此用户的权限值为 PRIVATE_FRIEND == 0b0000 0000 0001。如果一个命令设置了其权限为 PRIVATE | GROUP_ADMIN == 0b0010 0000 1111，则在两值取与运算后结果不为 0，命令得以触发。
很多工具都使用这种方法来节省空间。然而仅利用这种方式还不足以发挥权限控制所能做到的，例如针对 QQ 号的黑白名单，例如取与运算等，使得用户不得不在命令处理器中再次检查一遍触发逻辑的条件。于是我们改用了 用函数声明命令权限 (opens new window) 的方法，此方法在 1.8.0 版本中引入与上面提到的旧常量并存，在 1.9.0 版本中为保持兼容在实现中默默替换了这些旧常量（即使用函数来声明这些变量，而非 int）。在 1.9.0 后，使用函数定义权限是推荐的办法，而非这些常量。
← 部署