Skip to content

docs: 补充隔离会话对 unified_msg_origin 格式影响的说明 #7947

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
lingyun14beta wants to merge 2 commits into
base: master
Choose a base branch
from
+4 −1
Open

docs: 补充隔离会话对 unified_msg_origin 格式影响的说明 #7947

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
3ef4d4f
docs: 补充隔离会话对 unified_msg_origin 格式影响的说明
lingyun14beta May 1, 2026
0de1d34
Apply suggestions from code review
lingyun14beta May 2, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 4 additions & 1 deletion docs/zh/dev/star/guides/listen-message-event.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,4 +1,3 @@

# 处理消息事件

事件监听器可以收到平台下发的消息内容，可以实现指令、指令组、事件监听等功能。
Expand Down Expand Up @@ -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，而不是直接使用 `session_id` 或解析 `unified_msg_origin`，否则在隔离会话开启时会导致查询不到对应数据。

### 消息链

![message-chain](https://files.astrbot.app/docs/zh/dev/star/guides/message-chain.svg)
Expand Down
Loading