Skip to content

Commit 69b6dd6

Browse files
committed
docs(advanced): 更新 to_me 事件处理器的匹配条件说明
- 修改了 to_me 事件处理器的匹配条件描述,使其更加准确和清晰 - 更新了条件判断逻辑,明确了 MessageEvent 实例的前提 - 调整了对 message_type 的判断标准 - 修正了 At 段中 qq 数据的比较对象,使用 ConfigManager.GlobalConfig().account.user_id 替代 self_id
1 parent 48fe39d commit 69b6dd6

File tree

1 file changed

+3
-2
lines changed

1 file changed

+3
-2
lines changed

docs/advanced/event-handlers.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -339,8 +339,9 @@ def handle_checkin(event_data: EventClassifier.MessageEvent):
339339

340340
**匹配条件:** (内部实现细节)
341341

342-
* 事件对象是 `PrivateMessageEvent` 的实例。
343-
* **或者** 事件对象是 `GroupMessageEvent` 的实例,并且其 `message.rich_array` 中包含一个 `QQRichText.At` 段,其 `qq` 数据等于 `event_data.self_id`
342+
* 前提:事件对象是 `MessageEvent` 的实例,否则会日志警告并返回 `False`
343+
* 事件对象的 `message_type``"private"`
344+
* **或者** 事件对象的 `message_type``"group"`,并且其 `message.rich_array` 中包含一个 `QQRichText.At` 段,其 `qq` 数据等于 `ConfigManager.GlobalConfig().account.user_id`
344345

345346
**使用场景:** 通常用于确保命令或交互只在用户直接与机器人沟通时触发,避免响应群内无关的消息。
346347

0 commit comments

Comments
 (0)