@aalis/plugin-trigger-policy
平台无关的群聊触发策略 —— @ 提及 / 名字命中 / 关键词禁言 / 计数 / 评分阈值
定位
回答的是"这条消息要不要让 agent 接管？"这个问题。基于 flow-control 暴露的会话快照，结合自身的 @ / 名字 / 关键词检测，决定 swallow 还是放行（并标记 triggerType）。
注册的服务
| 服务名 | 接口 | 说明 |
|---|---|---|
trigger-policy | TriggerPolicyService | decide(message) / getBotNames() / detectMuteKeyword(content) |
接入相位
inbound:trigger （由 plugin-gateway 在 inbound:flow 之后、inbound:dispatch 之前触发）依赖 flow-control 的状态快照：进入此相位意味着已经通过冷却/限速闸门。
判定流程：
- mute 关键词命中 → 调
flow.setMuted(cfg.muteTimeSeconds)→shadowArchive→ swallow - 非群会话 →
next()直接放行 decide(message)：immediate（@ 自己 / 名字命中）→flow.recordTriggered→ 设triggerType='immediate'→next()interval（达到intervalMode判定）→flow.recordTriggered→ 设triggerType='interval'→next()swallow（未达阈值）→shadowArchive→ 不next()
内部消息 (
source === 'idle-trigger') 一律next()跳过策略。
配置
| 字段 | 默认 | 说明 |
|---|---|---|
enabled | true | |
platforms | [] | 空=所有平台 |
intervalMode | both | fixed(按计数) / dynamic(按评分阈值) / both(任一满足) |
triggerOnAt | true | 检测 <at> / [CQ:at] / @xxx |
triggerNames | [] | 触发名别名；自动追加 persona name + nickNames |
muteKeywords | [] | 关键词；自动追加 persona.getMuteKeywords() |
muteTimeSeconds | 60 | 关键词命中时通知 flow-control 的禁言时长 |
与 persona 的协作
getBotNames()自动合并persona.getPersonaName()+persona.getNickNames()detectMuteKeyword()自动合并persona.getMuteKeywords()
允许角色卡里直接声明触发名 / 静音关键词，无需在两处重复配置。