05. 触发条件与流水线

核心现象

如果 LangBot 日志出现:

No pipeline_uuid for query ..., query dropped

说明:

消息已经进入 LangBot,但没有匹配到任何流水线。

这不是 NapCat 连接失败,也不是模型失败,而是 LangBot 的触发条件没有命中。

触发条件页面

路径:

流水线 -> qq bot -> 配置 -> 触发条件

本次看到的关键配置:

  • 群响应规则
  • @ 开关
  • 前缀
  • 正则表达式
  • 随机
  • 访问控制
  • 黑名单 / 白名单
  • 消息忽略规则

测试阶段配置

为了确认链路先跑通,可以先放宽:

群响应规则:
@:开启
随机:1

前缀:空
正则表达式:空

访问控制:
模式:黑名单
黑名单:空
白名单:空

随机=1 表示其它规则未匹配的消息也 100% 响应。这样适合排查。

跑通后不要长期保持 随机=1,否则群里会乱回。

最终推荐配置

个人小群使用:

私聊:直接响应
群聊:@ 开启
随机:0
访问控制:黑名单,名单留空

这样:

私聊:你好

可以回复。

群聊:@神盾局特工26号 你好

可以回复。

普通群消息不会乱回。

前缀模式

如果想更严格:

前缀:/ai
随机:0

使用:

@机器人 /ai 帮我总结一下

适合大群,能进一步降低误触发。

访问控制

访问控制里有黑名单/白名单。

本次先用:

模式:黑名单
黑名单:空
白名单:空

这表示默认允许,只有黑名单中的会话被忽略。

如果要限制只在某个群生效,可以改成白名单,填会话格式。页面提示类似:

person_123
group_456
person_*
group_*
*_123

先跑通再收紧,避免配置过严导致消息全被丢弃。