群里发 /绑定课表 没反应:filter.command 的唤醒前提与正则锚定
本文目录(2 节)
给课程表插件加了个 /绑定课表 指令,用来在群里生成带一次性 token 的网页导入链接。写完重启容器,在群里发:
/绑定课表
机器人一点反应都没有,容器日志里也搜不到任何异常或 traceback。
为什么连处理器都没进
没有报错说明函数根本没被调用。回去看插件里的装饰器写法:
@filter.command("绑定课表")
async def bind_course(self, event: AstrMessageEvent):
...
在当时那套 QQ 群聊配置下,标准 filter.command 要求消息先满足机器人的唤醒条件(比如 @机器人 或特定的唤醒策略),否则群里不带 @ 的消息不会进入该命令处理器,而是直接落到后面的普通聊天分支或者被忽略。但群友的使用习惯是直接敲 /绑定课表 或 绑定课表。
改用正则并收紧首尾边界
为了让群友不用每次先 @ 机器人,我把入口改成了直接匹配消息文本的 filter.regex。第一版随手写成了:
@filter.regex(r"^/?绑定课表")
这样虽然能触发,但只有开头锚定 ^,没有结尾边界,别人聊到「绑定课表那个网页怎么填」也会误触发。后来把无参数命令统一收紧为首尾完整匹配(或允许末尾空白):
@filter.regex(r"^/?绑定课表\s*$")
async def bind_course(self, event: AstrMessageEvent):
...
改完重启,在群里直接发 /绑定课表 就能正常吐出绑定链接,平时群聊提到这四个字也不会再误触发。遇到「指令发出去没反应且日志全空」,先看消息有没有满足当前平台的唤醒过滤条件,比在函数体内部找 bug 直接得多。