Skip to content

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

Open
lingyun14beta wants to merge 2 commits intoAstrBotDevs:masterfrom
lingyun14beta:patch-1
Open

docs: 补充隔离会话对 unified_msg_origin 格式影响的说明#7947
lingyun14beta wants to merge 2 commits intoAstrBotDevs:masterfrom
lingyun14beta:patch-1

Conversation

@lingyun14beta
Copy link
Copy Markdown
Contributor

@lingyun14beta lingyun14beta commented May 1, 2026

当用户开启隔离会话时,群消息的 unified_msg_origin 格式会发生变化,但文档中未说明此行为,导致插件开发者在以群为单位存储数据时出现数据不一致的问题。

Modifications / 改动点

  • 在 docs/zh/dev/star/guides/listen-message-event.md 的 AstrBotMessage 说明后添加 WARNING,说明隔离会话对 session_id 和 unified_msg_origin 格式的影响,并建议开发者使用 event.get_group_id() 获取纯群ID。
  • This is NOT a breaking change. / 这不是一个破坏性变更。

Screenshots or Test Results / 运行截图或测试结果

preview

Checklist / 检查清单

  • 😊 If there are new features added in the PR, I have discussed it with the authors through issues/emails, etc.
    / 如果 PR 中有新加入的功能,已经通过 Issue / 邮件等方式和作者讨论过。

  • 👀 My changes have been well-tested, and "Verification Steps" and "Screenshots" have been provided above.
    / 我的更改经过了良好的测试,并已在上方提供了“验证步骤”和“运行截图”

  • 🤓 I have ensured that no new dependencies are introduced, OR if new dependencies are introduced, they have been added to the appropriate locations in requirements.txt and pyproject.toml.
    / 我确保没有引入新依赖库,或者引入了新依赖库的同时将其添加到 requirements.txtpyproject.toml 文件相应位置。

  • 😮 My changes do not introduce malicious code.
    / 我的更改没有引入恶意代码。

Summary by Sourcery

Documentation:

  • Add a warning explaining how enabling isolated sessions changes group message session_id and unified_msg_origin formats, and recommend using event.get_group_id() for group-based data storage and queries.

@dosubot dosubot Bot added the size:XS This PR changes 0-9 lines, ignoring generated files. label May 1, 2026
Copy link
Copy Markdown
Contributor

@sourcery-ai sourcery-ai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hey - I've reviewed your changes and they look great!


Sourcery is free for open source - if you like our reviews please consider sharing them ✨
Help me be more useful! Please click 👍 or 👎 on each comment and I'll use the feedback to improve your reviews.

Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request updates the documentation for message event handling to include a warning regarding 'Isolated Sessions'. It explains how session IDs and message origins change when this feature is enabled and advises developers to use the event.get_group_id() method for group-specific data. A review comment suggests extending this warning to explicitly advise against using session_id directly as a group identifier to prevent logic errors.

Comment thread docs/zh/dev/star/guides/listen-message-event.md Outdated
@lingyun14beta
Copy link
Copy Markdown
Contributor Author

session_id 不会因隔离会话而改变的……吧?

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
@lingyun14beta
Copy link
Copy Markdown
Contributor Author

是我考虑不周了

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size:XS This PR changes 0-9 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant