From 3ef4d4fcd985e027b2efd8f44b7c93e235dbecca Mon Sep 17 00:00:00 2001 From: lingyun14 Date: Fri, 1 May 2026 23:58:24 +0800 Subject: [PATCH 1/2] =?UTF-8?q?docs:=20=E8=A1=A5=E5=85=85=E9=9A=94?= =?UTF-8?q?=E7=A6=BB=E4=BC=9A=E8=AF=9D=E5=AF=B9=20unified=5Fmsg=5Forigin?= =?UTF-8?q?=20=E6=A0=BC=E5=BC=8F=E5=BD=B1=E5=93=8D=E7=9A=84=E8=AF=B4?= =?UTF-8?q?=E6=98=8E?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/zh/dev/star/guides/listen-message-event.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/docs/zh/dev/star/guides/listen-message-event.md b/docs/zh/dev/star/guides/listen-message-event.md index 35030869bd..c772c1aff0 100644 --- a/docs/zh/dev/star/guides/listen-message-event.md +++ b/docs/zh/dev/star/guides/listen-message-event.md @@ -1,4 +1,3 @@ - # 处理消息事件 事件监听器可以收到平台下发的消息内容，可以实现指令、指令组、事件监听等功能。 @@ -40,6 +39,10 @@ class AstrBotMessage: 其中，`raw_message` 是消息平台适配器的**原始消息对象**。 +> [!WARNING] +> 当用户开启**隔离会话**时，群消息的 `session_id` 格式会从纯群号变为 `用户ID_群ID`，`unified_msg_origin` 也会随之变化（例如 `default:GroupMessage:123456789_987654321`）。 +> 如果插件需要以群为单位存储或查询数据，请使用 `event.get_group_id()` 获取纯群ID，而不是直接使用或解析 `unified_msg_origin`，否则在隔离会话开启时会导致查询不到对应数据。 + ### 消息链 ![message-chain](https://files.astrbot.app/docs/zh/dev/star/guides/message-chain.svg) From 0de1d3410950b9d0405dedf13b54835544d83791 Mon Sep 17 00:00:00 2001 From: lingyun14 Date: Sat, 2 May 2026 13:10:32 +0800 Subject: [PATCH 2/2] Apply suggestions from code review Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com> --- docs/zh/dev/star/guides/listen-message-event.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/zh/dev/star/guides/listen-message-event.md b/docs/zh/dev/star/guides/listen-message-event.md index c772c1aff0..1e254e52d2 100644 --- a/docs/zh/dev/star/guides/listen-message-event.md +++ b/docs/zh/dev/star/guides/listen-message-event.md @@ -41,7 +41,7 @@ class AstrBotMessage: > [!WARNING] > 当用户开启**隔离会话**时，群消息的 `session_id` 格式会从纯群号变为 `用户ID_群ID`，`unified_msg_origin` 也会随之变化（例如 `default:GroupMessage:123456789_987654321`）。 -> 如果插件需要以群为单位存储或查询数据，请使用 `event.get_group_id()` 获取纯群ID，而不是直接使用或解析 `unified_msg_origin`，否则在隔离会话开启时会导致查询不到对应数据。 +> 如果插件需要以群为单位存储或查询数据，请使用 `event.get_group_id()` 获取纯群ID，而不是直接使用 `session_id` 或解析 `unified_msg_origin`，否则在隔离会话开启时会导致查询不到对应数据。 ### 消息链