nonebot-plugin-aigf-master 2.0.0b0__tar.gz → 2.0.0b2__tar.gz

{nonebot_plugin_aigf_master-2.0.0b0 → nonebot_plugin_aigf_master-2.0.0b2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nonebot-plugin-aigf-master
-Version: 2.0.0b0
+Version: 2.0.0b2
 Summary: 群聊特化LLM聊天机器人（增强版），具有记忆、表情包、跨插件调用、跨bot通信与跨适配器支持
 License-Expression: MIT
 Requires-Python: <4.0,>=3.10
@@ -67,7 +67,7 @@ Dynamic: license-file
 - ⏱️ **不完整消息检测**：纯 @ 消息或连续发送时自动延长等待时间
 - 🕐 **消息时间标注**：可选为 LLM 看到的消息加上 `[MM-DD HH:MM]` 时间前缀（`AIGFM_SHOW_MESSAGE_TIME`）
 - 📄 **完整消息类型**：合并聊天记录、小程序/卡片、XML，以及 QQ 表情/语音/视频/群文件/链接分享/推荐名片/位置/音乐/骰子等共 18 种消息段均可解析（纯此类消息不再被丢弃）
-- 🔔 **群系统通知**：戳一戳、禁言/解禁、新人进群、退群被踢、消息撤回会以 `[系统]` 消息进入 LLM 上下文
+- 🔔 **群系统通知**：戳一戳、禁言/解禁、新人进群、退群被踢、消息撤回等会以 `[系统]` 消息进入 LLM 上下文（OneBot V11 文案最细，其它适配器按通知类别映射成中文，见「多适配器支持」）
 - 🔒 **强制 JSON 输出**：确保 LLM 始终返回正确格式
 - ⚡ **轻量高效**：单次 LLM 调用完成对话 + 记忆管理 + 命令学习
 
@@ -80,9 +80,9 @@ Dynamic: license-file
 >
 > 从 2.0 起插件还依赖 `nonebot-plugin-alconna` 与 `nonebot-plugin-uninfo`（跨适配器收发与会话/成员信息），用下面的方式安装时会自动装上。
 
-### 安装 beta 版本（2.0.0b0）
+### 安装 beta 版本（2.0.0b2）
 
-`2.0.0b0` 是**预发布（pre-release）版本**，因此：
+`2.0.0b2` 是**预发布（pre-release）版本**，因此：
 
 - `pip install nonebot-plugin-aigf-master` 装的仍是稳定版 **1.6.x**
 - `nb plugin install nonebot-plugin-aigf-master` 同样只装稳定版，而且 nb-cli **不支持指定版本**，所以 beta 只能用 pip 装
@@ -90,7 +90,7 @@ Dynamic: license-file
 要装 beta，**必须显式写出版本号**：
 
 ```bash
-pip install nonebot-plugin-aigf-master==2.0.0b0
+pip install nonebot-plugin-aigf-master==2.0.0b2
 ```
 
 在 `pyproject.toml` 中添加：
@@ -248,18 +248,67 @@ AIGFM_PEER_CAPTURE_PLUGINS=[]          # 要捕获输出的插件名列表，为
 - 落盘目录名不能含 `:`，因此磁盘上写作 `onebot11_617770183`；`memory/` 下旧版裸数字目录会在启动时**一次性自动迁移**（目标已存在则跳过，幂等）
 - 非启用会话不发请求、不入缓冲：插件只会为启用的会话解析成员信息与图片
 
-### 各能力在非 OneBot 适配器上的边界
-
-| 能力 | 其它适配器 | 说明 |
-|---|---|---|
-| 聊天、记忆、表情包、生图、命令学习、管理命令 | ✅ 可用 | `status` / `reset` / `set_role` / `presets` / `set_preset` / `reload_meme` 已改为 alconna 响应器，各适配器通用 |
-| 跨插件感知（捕获其它插件的输出） | ✅ 一般可用 | 依赖 NoneBot 基类的 `on_calling_api` 钩子（所有适配器）；会话取自当前事件，消息取自适配器消息对象，取不到就静默跳过 |
-| 插件调用（`invoke_plugin`） | ⚠️ 尽力支持 | 通过复制该会话最近一条真实事件来投递命令；事件类型、消息类都由适配器自己决定，不需 onebot 专属类型。目标插件若依赖适配器特有能力（例如 OneBot 的 `get_msg`）仍可能失败 |
-| 群系统通知（戳一戳/禁言/进出群/撤回） | ❌ 仅 OneBot | 这些是 OneBot 专属事件类型，其它适配器没有统一的通知模型，不处理 |
-| 跨 bot 通信（子插件 `/peer/capture`） | ❌ 仅 OneBot | 其它 bot 都是同号 OneBot 实例，推送按 `onebot11:` 会话映射 |
-| 群名片记录 | ✅ 有则记录 | 成员信息来自 uninfo，适配器不提供名片时该项为空 |
-
-> 适配器完全不被 alconna/uninfo 支持时，该会话的消息会被静默跳过（只留 debug 日志），不会报错、也不会影响其它适配器。
+### 功能 × 适配器支持表（2026-09-25 实测）
+
+为每个适配器**构造真实事件**跑同一套功能路径（会话解析 → 渲染 → 回复发送 → 跨插件捕获 → 插件调用），bot 是记录型 mock，**未连真实平台**。
+
+| 适配器 | 会话解析 | 收发/渲染 | 回复发送 | 私聊 | @ 按昵称 | 跨插件捕获 | 插件调用 | 群通知 | 跨 bot |
+|---|---|---|---|---|---|---|---|---|---|
+| OneBot V11 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
+| OneBot V12 | ✅ | ✅ | ✅ | ✅ | ⚠️ | ✅ | ✅ | ✅ | ✅ |
+| Console | ✅ | ✅ | ✅ | ✅ | ⚠️ | ✅ | ✅ | ❌ | ✅ |
+| Satori | ✅ | ✅ | ✅ | ✅ | ⚠️ | ✅ | ⚠️ | ✅ | ✅ |
+| Telegram | ✅ | ✅ | ✅ | ✅ | ⚠️ | ✅ | ✅ | ✅ | ✅ |
+| Discord | ✅ | ✅ | ✅ | ✅ | ⚠️ | ✅ | ✅ | ⚠️ | ✅ |
+| QQ（频道/C2C/群） | ✅ | ✅ | ✅ | ✅ | ⚠️ | ✅ | ✅ | ✅ | ✅ |
+| Feishu | ✅ | ✅ | ✅ | ✅ | ⚠️ | ✅ | ✅ | ❌ | ✅ |
+| Milky | ✅ | ✅ | ✅ | ✅ | ⚠️ | ✅ | ✅ | ✅ | ✅ |
+| Mirai | ✅ | ✅ | ✅ | ✅ | ⚠️ | ✅ | ✅ | ✅ | ✅ |
+| Kaiheila（Kook） | ✅ | ✅ | ✅ | 未测 | ⚠️ | ✅ | ⚠️ | ✅ | ✅ |
+| DoDo | ✅ | ✅ | ✅ | ✅ | ⚠️ | ✅ | ✅ | ✅ | ✅ |
+| Kritor | ✅ | ✅ | ✅ | 未测 | ⚠️ | ✅ | ✅ | ❌ | ✅ |
+| Mail | ✅（仅私聊） | ✅ | ✅ | ✅ | ⚠️ | ✅ | ✅ | ❌ | ✅ |
+| Minecraft | ✅（仅私聊） | ✅ | ✅ | ✅ | ⚠️ | ✅ | ✅ | ❌ | ✅ |
+| WXMP | ✅（仅私聊） | ✅ | ✅ | ✅ | ⚠️ | ✅ | ✅ | ❌ | ✅ |
+| EFChat | ✅ | ✅ | ✅ | ✅ | ⚠️ | ✅ | ✅ | ❌ | ✅ |
+| YunHu | ✅ | ✅ | ✅ | 未测 | ⚠️ | ✅ | ✅ | ✅ | ✅ |
+| bilibili Live | ✅ | ✅ | ✅ | ❌ 无好友私聊类型 | ⚠️ | ✅ | ✅ | ⚠️ | ✅ |
+
+图例：**✅ 已实测通过** ｜ **⚠️ 已实现但未验证通过**（离线构造不出该适配器的事件，或需要真实 API / 真机）｜ **❌ 该适配器没有这类事件，或库层无法把该通知定位到群/频道会话（通知会被跳过）** ｜ **未测** 本次未构造该场景。
+
+**已知特例**
+
+- **@ 按昵称**：只有 OneBot V11 能按群昵称反查用户 id，其余适配器请让 LLM 直接用用户 id
+- **插件调用**：Satori / Kaiheila 的事件结构特殊，离线未验证通过；其余 14 个已实测目标响应器收到命令
+- **群通知**：为每个适配器构造真实通知事件实测，**10 个通过**（OneBot V11/V12、Satori、Telegram、QQ、Milky、Mirai、Kaiheila、DoDo、YunHu）；Discord / bilibili 未验证（离线 mock 不够 / 只有部分通知类在库的覆盖范围内）；**Feishu、Kritor、EFChat** 的通知 uninfo 与 alconna 都无法定位到群/频道会话，**Minecraft、WXMP** 的通知事件没有群/频道字段（会话按私聊处理）——这几种会被跳过（库层限制，非本插件可修）
+- **YunHu / bilibili Live**：需要把 bot 跑在 **Python ≥ 3.12**（3.10 里导入即失败；这两行的 ✅ 是在 3.14 实测的）
+- **Kaiheila**：请装 `nonebot-adapter-kaiheila`（社区包 `nonebot-adapter-kook` 的模块名与 alconna/uninfo 期望的不一致）
+- **跨 bot**：按 peer 0.4.0+ 的 `session` 协议可用；旧 peer（0.3.x）只有 OneBot V11 的会话能对上
+- 适配器不被 alconna/uninfo 支持时，该会话的消息静默跳过（只留 debug 日志），不影响其它适配器
+
+<details>
+<summary>实测到的各适配器发送接口（供排查用）</summary>
+
+| 适配器 | 回复发送最终调用的接口 |
+|---|---|
+| OneBot V11 / V12 | `send_msg` / `send_message` |
+| Console | `send_message`（私聊 `send_private_message`） |
+| Satori | `send_message`（私聊 `send_private_message`） |
+| Telegram | `send_to` |
+| Discord | `send_to` |
+| QQ | `send_to_group` / `send_to_channel` / `send_to_c2c` |
+| Feishu | `send_msg` |
+| Milky | `send_group_message` / `send_private_message` |
+| Mirai | `send_group_message` / `send_friend_message` |
+| Kaiheila | `send_msg`（按 channel/private 区分） |
+| DoDo | `send_to_channel` / `send_to_personal` |
+| Kritor | `send_message` / `send_channel_message` |
+| Mail | `send_to` |
+| Minecraft | `send_msg` |
+| WXMP | `send_custom_message` |
+| EFChat | `send_chat_message` |
+
+</details>
 
 ## 🔌 跨插件感知
 

{nonebot_plugin_aigf_master-2.0.0b0 → nonebot_plugin_aigf_master-2.0.0b2}/README.md

@@ -45,7 +45,7 @@
 - ⏱️ **不完整消息检测**：纯 @ 消息或连续发送时自动延长等待时间
 - 🕐 **消息时间标注**：可选为 LLM 看到的消息加上 `[MM-DD HH:MM]` 时间前缀（`AIGFM_SHOW_MESSAGE_TIME`）
 - 📄 **完整消息类型**：合并聊天记录、小程序/卡片、XML，以及 QQ 表情/语音/视频/群文件/链接分享/推荐名片/位置/音乐/骰子等共 18 种消息段均可解析（纯此类消息不再被丢弃）
-- 🔔 **群系统通知**：戳一戳、禁言/解禁、新人进群、退群被踢、消息撤回会以 `[系统]` 消息进入 LLM 上下文
+- 🔔 **群系统通知**：戳一戳、禁言/解禁、新人进群、退群被踢、消息撤回等会以 `[系统]` 消息进入 LLM 上下文（OneBot V11 文案最细，其它适配器按通知类别映射成中文，见「多适配器支持」）
 - 🔒 **强制 JSON 输出**：确保 LLM 始终返回正确格式
 - ⚡ **轻量高效**：单次 LLM 调用完成对话 + 记忆管理 + 命令学习
 
@@ -58,9 +58,9 @@
 >
 > 从 2.0 起插件还依赖 `nonebot-plugin-alconna` 与 `nonebot-plugin-uninfo`（跨适配器收发与会话/成员信息），用下面的方式安装时会自动装上。
 
-### 安装 beta 版本（2.0.0b0）
+### 安装 beta 版本（2.0.0b2）
 
-`2.0.0b0` 是**预发布（pre-release）版本**，因此：
+`2.0.0b2` 是**预发布（pre-release）版本**，因此：
 
 - `pip install nonebot-plugin-aigf-master` 装的仍是稳定版 **1.6.x**
 - `nb plugin install nonebot-plugin-aigf-master` 同样只装稳定版，而且 nb-cli **不支持指定版本**，所以 beta 只能用 pip 装
@@ -68,7 +68,7 @@
 要装 beta，**必须显式写出版本号**：
 
 ```bash
-pip install nonebot-plugin-aigf-master==2.0.0b0
+pip install nonebot-plugin-aigf-master==2.0.0b2
 ```
 
 在 `pyproject.toml` 中添加：
@@ -226,18 +226,67 @@ AIGFM_PEER_CAPTURE_PLUGINS=[]          # 要捕获输出的插件名列表，为
 - 落盘目录名不能含 `:`，因此磁盘上写作 `onebot11_617770183`；`memory/` 下旧版裸数字目录会在启动时**一次性自动迁移**（目标已存在则跳过，幂等）
 - 非启用会话不发请求、不入缓冲：插件只会为启用的会话解析成员信息与图片
 
-### 各能力在非 OneBot 适配器上的边界
-
-| 能力 | 其它适配器 | 说明 |
-|---|---|---|
-| 聊天、记忆、表情包、生图、命令学习、管理命令 | ✅ 可用 | `status` / `reset` / `set_role` / `presets` / `set_preset` / `reload_meme` 已改为 alconna 响应器，各适配器通用 |
-| 跨插件感知（捕获其它插件的输出） | ✅ 一般可用 | 依赖 NoneBot 基类的 `on_calling_api` 钩子（所有适配器）；会话取自当前事件，消息取自适配器消息对象，取不到就静默跳过 |
-| 插件调用（`invoke_plugin`） | ⚠️ 尽力支持 | 通过复制该会话最近一条真实事件来投递命令；事件类型、消息类都由适配器自己决定，不需 onebot 专属类型。目标插件若依赖适配器特有能力（例如 OneBot 的 `get_msg`）仍可能失败 |
-| 群系统通知（戳一戳/禁言/进出群/撤回） | ❌ 仅 OneBot | 这些是 OneBot 专属事件类型，其它适配器没有统一的通知模型，不处理 |
-| 跨 bot 通信（子插件 `/peer/capture`） | ❌ 仅 OneBot | 其它 bot 都是同号 OneBot 实例，推送按 `onebot11:` 会话映射 |
-| 群名片记录 | ✅ 有则记录 | 成员信息来自 uninfo，适配器不提供名片时该项为空 |
-
-> 适配器完全不被 alconna/uninfo 支持时，该会话的消息会被静默跳过（只留 debug 日志），不会报错、也不会影响其它适配器。
+### 功能 × 适配器支持表（2026-09-25 实测）
+
+为每个适配器**构造真实事件**跑同一套功能路径（会话解析 → 渲染 → 回复发送 → 跨插件捕获 → 插件调用），bot 是记录型 mock，**未连真实平台**。
+
+| 适配器 | 会话解析 | 收发/渲染 | 回复发送 | 私聊 | @ 按昵称 | 跨插件捕获 | 插件调用 | 群通知 | 跨 bot |
+|---|---|---|---|---|---|---|---|---|---|
+| OneBot V11 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
+| OneBot V12 | ✅ | ✅ | ✅ | ✅ | ⚠️ | ✅ | ✅ | ✅ | ✅ |
+| Console | ✅ | ✅ | ✅ | ✅ | ⚠️ | ✅ | ✅ | ❌ | ✅ |
+| Satori | ✅ | ✅ | ✅ | ✅ | ⚠️ | ✅ | ⚠️ | ✅ | ✅ |
+| Telegram | ✅ | ✅ | ✅ | ✅ | ⚠️ | ✅ | ✅ | ✅ | ✅ |
+| Discord | ✅ | ✅ | ✅ | ✅ | ⚠️ | ✅ | ✅ | ⚠️ | ✅ |
+| QQ（频道/C2C/群） | ✅ | ✅ | ✅ | ✅ | ⚠️ | ✅ | ✅ | ✅ | ✅ |
+| Feishu | ✅ | ✅ | ✅ | ✅ | ⚠️ | ✅ | ✅ | ❌ | ✅ |
+| Milky | ✅ | ✅ | ✅ | ✅ | ⚠️ | ✅ | ✅ | ✅ | ✅ |
+| Mirai | ✅ | ✅ | ✅ | ✅ | ⚠️ | ✅ | ✅ | ✅ | ✅ |
+| Kaiheila（Kook） | ✅ | ✅ | ✅ | 未测 | ⚠️ | ✅ | ⚠️ | ✅ | ✅ |
+| DoDo | ✅ | ✅ | ✅ | ✅ | ⚠️ | ✅ | ✅ | ✅ | ✅ |
+| Kritor | ✅ | ✅ | ✅ | 未测 | ⚠️ | ✅ | ✅ | ❌ | ✅ |
+| Mail | ✅（仅私聊） | ✅ | ✅ | ✅ | ⚠️ | ✅ | ✅ | ❌ | ✅ |
+| Minecraft | ✅（仅私聊） | ✅ | ✅ | ✅ | ⚠️ | ✅ | ✅ | ❌ | ✅ |
+| WXMP | ✅（仅私聊） | ✅ | ✅ | ✅ | ⚠️ | ✅ | ✅ | ❌ | ✅ |
+| EFChat | ✅ | ✅ | ✅ | ✅ | ⚠️ | ✅ | ✅ | ❌ | ✅ |
+| YunHu | ✅ | ✅ | ✅ | 未测 | ⚠️ | ✅ | ✅ | ✅ | ✅ |
+| bilibili Live | ✅ | ✅ | ✅ | ❌ 无好友私聊类型 | ⚠️ | ✅ | ✅ | ⚠️ | ✅ |
+
+图例：**✅ 已实测通过** ｜ **⚠️ 已实现但未验证通过**（离线构造不出该适配器的事件，或需要真实 API / 真机）｜ **❌ 该适配器没有这类事件，或库层无法把该通知定位到群/频道会话（通知会被跳过）** ｜ **未测** 本次未构造该场景。
+
+**已知特例**
+
+- **@ 按昵称**：只有 OneBot V11 能按群昵称反查用户 id，其余适配器请让 LLM 直接用用户 id
+- **插件调用**：Satori / Kaiheila 的事件结构特殊，离线未验证通过；其余 14 个已实测目标响应器收到命令
+- **群通知**：为每个适配器构造真实通知事件实测，**10 个通过**（OneBot V11/V12、Satori、Telegram、QQ、Milky、Mirai、Kaiheila、DoDo、YunHu）；Discord / bilibili 未验证（离线 mock 不够 / 只有部分通知类在库的覆盖范围内）；**Feishu、Kritor、EFChat** 的通知 uninfo 与 alconna 都无法定位到群/频道会话，**Minecraft、WXMP** 的通知事件没有群/频道字段（会话按私聊处理）——这几种会被跳过（库层限制，非本插件可修）
+- **YunHu / bilibili Live**：需要把 bot 跑在 **Python ≥ 3.12**（3.10 里导入即失败；这两行的 ✅ 是在 3.14 实测的）
+- **Kaiheila**：请装 `nonebot-adapter-kaiheila`（社区包 `nonebot-adapter-kook` 的模块名与 alconna/uninfo 期望的不一致）
+- **跨 bot**：按 peer 0.4.0+ 的 `session` 协议可用；旧 peer（0.3.x）只有 OneBot V11 的会话能对上
+- 适配器不被 alconna/uninfo 支持时，该会话的消息静默跳过（只留 debug 日志），不影响其它适配器
+
+<details>
+<summary>实测到的各适配器发送接口（供排查用）</summary>
+
+| 适配器 | 回复发送最终调用的接口 |
+|---|---|
+| OneBot V11 / V12 | `send_msg` / `send_message` |
+| Console | `send_message`（私聊 `send_private_message`） |
+| Satori | `send_message`（私聊 `send_private_message`） |
+| Telegram | `send_to` |
+| Discord | `send_to` |
+| QQ | `send_to_group` / `send_to_channel` / `send_to_c2c` |
+| Feishu | `send_msg` |
+| Milky | `send_group_message` / `send_private_message` |
+| Mirai | `send_group_message` / `send_friend_message` |
+| Kaiheila | `send_msg`（按 channel/private 区分） |
+| DoDo | `send_to_channel` / `send_to_personal` |
+| Kritor | `send_message` / `send_channel_message` |
+| Mail | `send_to` |
+| Minecraft | `send_msg` |
+| WXMP | `send_custom_message` |
+| EFChat | `send_chat_message` |
+
+</details>
 
 ## 🔌 跨插件感知
 

{nonebot_plugin_aigf_master-2.0.0b0 → nonebot_plugin_aigf_master-2.0.0b2}/nonebot_plugin_aigf_master/__init__.py

@@ -15,12 +15,8 @@ import anyio
 import httpx
 from nonebot import get_driver, logger, on_message, on_notice, require
 from nonebot.adapters import Bot, Event
-from nonebot.adapters.onebot.v11 import (
-    GroupBanNoticeEvent, GroupDecreaseNoticeEvent, GroupIncreaseNoticeEvent,
-    GroupRecallNoticeEvent, PokeNotifyEvent,
-)
 from nonebot.permission import SUPERUSER
-from nonebot.plugin import PluginMetadata
+from nonebot.plugin import PluginMetadata, inherit_supported_adapters
 
 # require 必须先于任何 import（否则库会以「先被 import」的方式装载，require 会判定它不是插件）
 require("nonebot_plugin_localstore")
@@ -43,6 +39,7 @@ from .image_gen_client import ImageGenClient
 from .meme_store import MemeStore
 from .memory_store import MemoryStore
 from .models import ChatMessage
+from .notice import is_group_notice, notice_text
 from .peer_client import PeerClient
 from .plugin_invoker import PluginInvoker
 from .preset_store import PresetStore
@@ -58,8 +55,12 @@ __plugin_meta__ = PluginMetadata(
     name="AI群友（增强版）", description="群聊特化LLM聊天机器人（增强版），具备表情包管理、记忆存储、联网搜索、跨插件感知、插件调用、命令学习等能力。",
     usage="群聊特化LLM聊天机器人", type="application",
     config=PluginConfig,
-    # 通用适配器支持：收发走 alconna、会话/成员信息走 uninfo，两者不支持的适配器会静默跳过
-    supported_adapters=None,
+    # 收发走 alconna 的 uniseg、会话/成员信息走 uninfo，因此只声明两者共同支持的适配器
+    # （两者都不支持的适配器上本插件无法工作；inherit_supported_adapters 取交集，需在上面的 require 之后调用）
+    supported_adapters=inherit_supported_adapters(
+        "nonebot_plugin_alconna",
+        "nonebot_plugin_uninfo",
+    ),
     homepage="https://github.com/Funny1Potato/nonebot-plugin-aigf-master",
     extra={"author": "Funny1Potato"},
 )
@@ -430,60 +431,6 @@ def _is_message(event: Event) -> bool:
         return True
 
 
-_NOTICE_TYPES = (
-    PokeNotifyEvent, GroupBanNoticeEvent, GroupIncreaseNoticeEvent,
-    GroupDecreaseNoticeEvent, GroupRecallNoticeEvent,
-)
-
-
-def _is_group_notice(event: Event) -> bool:
-    """只收群内系统通知；PokeNotifyEvent 的 group_id 可能为空（私聊戳一戳），过滤掉
-
-    群 notice 是 onebot 专属事件类型，其它适配器暂不处理（没有统一的通用通知模型）。
-    """
-    if not isinstance(event, _NOTICE_TYPES):
-        return False
-    return bool(getattr(event, "group_id", None))
-
-
-async def _resolve_notice_text(bot: Bot, event: Event) -> str | None:
-    """把群 notice 事件渲染成一行文本；昵称查询失败回落用户 id"""
-    group_id = int(getattr(event, "group_id"))
-    info = SessionInfo(
-        key=session_key("onebot11", str(group_id)), slug="onebot11", scene_path=str(group_id),
-        native_chat_id=str(group_id), adapter_name=bot.adapter.get_name(),
-    )
-
-    async def _name(user_id) -> str:
-        from .session import display_user
-        name = await display_user(bot, info, user_id)
-        return name or str(user_id)
-
-    if isinstance(event, PokeNotifyEvent):
-        return f"{await _name(event.user_id)} 戳了戳 {await _name(event.target_id)}"
-    if isinstance(event, GroupBanNoticeEvent):
-        if event.sub_type == "self_ban":
-            return f"我被禁言 {event.duration} 分钟"
-        if event.sub_type == "self_lift_ban":
-            return "我被解除禁言"
-        if event.sub_type == "lift_ban":
-            return f"{await _name(event.operator_id)} 解除了 {await _name(event.user_id)} 的禁言"
-        return f"{await _name(event.operator_id)} 将 {await _name(event.user_id)} 禁言 {event.duration} 分钟"
-    if isinstance(event, GroupIncreaseNoticeEvent):
-        return f"{await _name(event.user_id)} 加入了群聊"
-    if isinstance(event, GroupDecreaseNoticeEvent):
-        if event.sub_type == "kick_me":
-            return "我被移出了群聊"
-        if event.sub_type == "kick":
-            return f"{await _name(event.user_id)} 被 {await _name(event.operator_id)} 移出了群聊"
-        return f"{await _name(event.user_id)} 退出了群聊"
-    if isinstance(event, GroupRecallNoticeEvent):
-        if event.user_id == event.operator_id:
-            return f"{await _name(event.user_id)} 撤回了一条消息"
-        return f"{await _name(event.operator_id)} 撤回了 {await _name(event.user_id)} 的一条消息"
-    return None
-
-
 async def _command_session(bot: Bot, event: Event) -> SessionInfo | None:
     """管理命令用：解析当前会话（解析不出时给用户一句可读的提示）"""
     return await resolve_session(bot, event)
@@ -521,7 +468,9 @@ set_preset_cmd = on_alconna(_cmd("set_preset", Args["rest", MultiVar(str, "*")])
 reload_meme_cmd = on_alconna(_cmd("reload_meme", Args["rest", MultiVar(str, "*")]),
                              aliases={"重载表情包"}, permission=SUPERUSER, priority=0, block=True)
 auto_chat = on_message(rule=_is_message, priority=1, block=False)
-group_notice = on_notice(rule=_is_group_notice, priority=1, block=False)
+# 类型闸门是内核给的（Matcher.check_rule 按 event.get_type() == "notice" 过滤，见 notice.py 开头），
+# 所以这里收的是所有适配器的通知事件；rule 只做「带会话线索」的廉价预筛
+group_notice = on_notice(rule=is_group_notice, priority=1, block=False)
 
 
 @status_cmd.handle()
@@ -683,23 +632,23 @@ async def handle_auto_chat(bot: Bot, event: Event):
 
 @group_notice.handle()
 async def handle_group_notice(bot: Bot, event: Event):
-    """群系统通知（戳一戳/禁言/进出群/消息撤回）→ 渲染后入缓冲区
+    """群/频道系统通知（戳一戳/禁言/进出群/消息撤回等）→ 渲染后入缓冲区
 
-    notice 事件没有用户消息上下文：不更新 processor._current_user_id（避免污染工具调用身份），
+    通知事件没有用户消息上下文：不更新 processor._current_user_id（避免污染工具调用身份），
     批处理触发依赖该会话最近一次真实用户消息（与 peer 推送的等待行为一致）
     """
-    key = session_key("onebot11", str(getattr(event, "group_id")))
-    if key not in _enabled_keys():
+    info = await resolve_session(bot, event)
+    if info is None or info.is_private or not is_enabled(info, plugin_config):
         return
     try:
-        text = await _resolve_notice_text(bot, event)
+        text = await notice_text(bot, info, event)
     except Exception as e:
         logger.error(f"[通知] 事件渲染失败: {e}")
         return
     if not text:
         return
-    logger.info(f"[通知] {key}: {text}")
-    _add_notice_message(key, text)
+    logger.info(f"[通知] {info.key}: {text}")
+    _add_notice_message(info.key, text)
 
 
 # ========== 启动 ==========

nonebot_plugin_aigf_master-2.0.0b2/nonebot_plugin_aigf_master/notice.py

@@ -0,0 +1,233 @@
+"""群/频道系统通知的渲染层
+
+NoneBot 的 `on_notice` 已经按 `event.get_type() == "notice"` 过滤（内核
+`Matcher.check_rule` 里就是 `event_type == (cls.type or event_type)`），所以事件类型闸门
+本身就是跨适配器的；留给本插件的是两件事：
+
+1. 这条通知属于哪个会话 —— 交给 `session.resolve_session`（uninfo → alconna Target 回落）
+2. 渲染成一行中文 —— OneBot V11 走下面这份最详细的分支；其它适配器用一张类别关键词表，
+   映射不到才回落到适配器自带的事件描述/事件名。
+
+多数适配器的 `get_event_description()` 是整段 `model_dump` 的 JSON，直接进 prompt 会灌水，
+所以这里一律丢弃 dump 形态的描述（只有 kritor/minecraft/efchat 这类真正写了句子的才采用）。
+"""
+
+from __future__ import annotations
+
+import re
+from collections.abc import Mapping
+
+from nonebot.adapters import Bot, Event
+from nonebot.adapters.onebot.v11 import (
+    GroupBanNoticeEvent, GroupDecreaseNoticeEvent, GroupIncreaseNoticeEvent,
+    GroupRecallNoticeEvent, PokeNotifyEvent,
+)
+
+from .session import SessionInfo, display_user
+
+# OneBot V11 有结构化字段（sub_type/operator_id/target_id），文案做得最细
+_ONEBOT_NOTICE_TYPES = (
+    PokeNotifyEvent, GroupBanNoticeEvent, GroupIncreaseNoticeEvent,
+    GroupDecreaseNoticeEvent, GroupRecallNoticeEvent,
+)
+
+# 「会话线索」的字段/键名（比较前统一规范化：去掉非字母数字并小写，因此
+# group_id / groupId / chat_id / chatId 都等价）。命中且取值非空即认为不是纯好友/私聊类通知。
+_SCENE_FIELDS = frozenset({
+    "groupid", "channelid", "guildid", "chatid", "roomid",
+    "group", "channel", "guild", "chat", "room", "scene",
+})
+
+# 递归查找的深度与每个容器的取样条数（只为便宜预筛，不需要穷举）
+_SCENE_DEPTH = 3
+_SCENE_SAMPLE = 8
+
+# 递归时跳过的字段：消息体/回复体又大又不会带会话线索
+_SKIP_FIELDS = frozenset({"message", "original_message", "raw_message", "reply"})
+
+# 通用主体 id 的候选路径（`event.get_user_id()` 拿不到时依次尝试；整数表示列表下标）。
+# 列表型（Telegram 的 new_chat_members[0] / left_chat_member）要排在通用字段前，否则会拿错人
+_SUBJECT_PATHS = (
+    ("new_chat_members", 0, "id"), ("left_chat_member", "id"),
+    ("user_id",), ("user", "id"), ("member", "id"), ("member", "user", "id"),
+    ("target_id",), ("operator_id",), ("operator", "id"), ("member_id",), ("uin",), ("from_id",),
+)
+
+# 类别关键词表：`type(event).__name__ + get_event_name()` 规范化（只留小写字母数字）后按序匹配，
+# 关键词自身也已是规范化形态。命中的模板即渲染文案，`{who}` 换主体昵称（拿不到则留空）。
+# 顺序有意义：消息撤回要排在「成员删除/配置变更」之前，bilibili 直播类要排在通用类和之前。
+_NOTICE_RULES: tuple[tuple[tuple[str, ...], str], ...] = (
+    (("poke", "nudge"), "{who} 被戳了戳"),
+    (("recall", "messagedelete", "messagemdelete", "deleterecall"), "{who} 撤回了一条消息"),
+    (("userenter", "userenterv"), "{who} 进入了直播间"),
+    (("userfollow",), "{who} 关注了直播间"),
+    (("guardbuy", "sendgift", "specialgift"), "{who} 赠送了礼物"),
+    (("wholeban", "liftban", "unmute", "unban", "mute", "ban", "silent"), "{who} 的禁言状态发生了变化"),
+    (
+        (
+            "memberincrease", "memberadded", "memberadd", "memberjoin", "newchatmember",
+            "newmember", "groupjoin", "useradded", "join", "increase", "added", "enter",
+        ),
+        "{who} 加入了群聊",
+    ),
+    (
+        (
+            "memberdecrease", "memberremoved", "memberremove", "memberleave", "memberquit",
+            "memberkick", "leftchatmember", "groupmemberdeleted", "groupmemberwithdrawn",
+            "groupdecrease", "leave", "quit", "kick", "remove", "decrease", "deleted", "withdrawn",
+        ),
+        "{who} 离开了群聊",
+    ),
+    (("adminchange", "adminchanged", "permissionchange", "roleadd", "roledelete", "roleupdate"),
+     "{who} 的管理权限发生了变化"),
+    (("reaction", "reactmessage"), "{who} 对消息添加了表情回应"),
+    (("essence", "pin", "pinned"), "消息的置顶/精华状态发生了变化"),
+    (("groupnamechange", "roomchangeinfo", "chatphoto", "chattitle", "namechange",
+      "configupdated", "cardchanged", "specialtitle", "updated", "change"),
+     "会话信息发生了变化"),
+)
+
+# 描述形态的 JSON dump 一律不用（`str(model_dump(...))` / `str(self.dict())` 都以 `{` 开头）
+_DESCRIPTION_MAX = 200
+
+
+def is_group_notice(event: Event) -> bool:
+    """`on_notice` 的规则：只看事件里有没有会话线索，不发任何请求
+
+    真正的「是否启用/是否私聊」判断在 handler 里做（需要 uninfo，可能有 API 调用）。
+    这里必须**递归**找：多数适配器把会话 id 放在顶层（`group_id`/`channel_id`…），但
+    Feishu 在 `event.event.chat_id`、Milky 在 `data.group_id`、YunHu 在 `event.chatId`。
+    放宽的代价只是多查一次 uninfo（handler 还会按 `is_private` 复核），漏判才会真的丢通知。
+    """
+    return _has_scene_hint(event, _SCENE_DEPTH)
+
+
+def _has_scene_hint(value, depth: int) -> bool:
+    if depth < 0 or value is None or isinstance(value, (str, bytes, int, float, bool)):
+        return False
+    if isinstance(value, Mapping):
+        for key, item in value.items():
+            if _norm_key(key) in _SCENE_FIELDS and item:
+                return True
+            if _has_scene_hint(item, depth - 1):
+                return True
+        return False
+    if isinstance(value, (list, tuple, set, frozenset)):
+        return any(_has_scene_hint(item, depth - 1) for item in list(value)[:_SCENE_SAMPLE])
+    fields = getattr(value, "model_fields", None)
+    if fields is not None:  # pydantic 模型（事件/嵌套模型）
+        for name in fields:
+            if name.startswith("_") or name in _SKIP_FIELDS:
+                continue
+            try:
+                item = getattr(value, name, None)
+            except Exception:
+                continue
+            if _norm_key(name) in _SCENE_FIELDS and item:
+                return True
+            if _has_scene_hint(item, depth - 1):
+                return True
+        extra = getattr(value, "__pydantic_extra__", None)
+        return bool(extra) and _has_scene_hint(extra, depth - 1)
+    return False
+
+
+def _norm_key(name) -> str:
+    return re.sub(r"[^a-z0-9]", "", str(name).lower())
+
+
+async def notice_text(bot: Bot, info: SessionInfo, event: Event) -> str | None:
+    """把一条通知渲染成一行文本；渲染不出返回 None（调用方跳过该条）"""
+    if isinstance(event, _ONEBOT_NOTICE_TYPES):
+        return await _onebot_notice_text(bot, info, event)
+    return await _generic_notice_text(bot, info, event)
+
+
+async def _onebot_notice_text(bot: Bot, info: SessionInfo, event: Event) -> str | None:
+    async def _name(user_id) -> str:
+        name = await display_user(bot, info, user_id)
+        return name or str(user_id)
+
+    if isinstance(event, PokeNotifyEvent):
+        return f"{await _name(event.user_id)} 戳了戳 {await _name(event.target_id)}"
+    if isinstance(event, GroupBanNoticeEvent):
+        if event.sub_type == "self_ban":
+            return f"我被禁言 {event.duration} 分钟"
+        if event.sub_type == "self_lift_ban":
+            return "我被解除禁言"
+        if event.sub_type == "lift_ban":
+            return f"{await _name(event.operator_id)} 解除了 {await _name(event.user_id)} 的禁言"
+        return f"{await _name(event.operator_id)} 将 {await _name(event.user_id)} 禁言 {event.duration} 分钟"
+    if isinstance(event, GroupIncreaseNoticeEvent):
+        return f"{await _name(event.user_id)} 加入了群聊"
+    if isinstance(event, GroupDecreaseNoticeEvent):
+        if event.sub_type == "kick_me":
+            return "我被移出了群聊"
+        if event.sub_type == "kick":
+            return f"{await _name(event.user_id)} 被 {await _name(event.operator_id)} 移出了群聊"
+        return f"{await _name(event.user_id)} 退出了群聊"
+    if isinstance(event, GroupRecallNoticeEvent):
+        if event.user_id == event.operator_id:
+            return f"{await _name(event.user_id)} 撤回了一条消息"
+        return f"{await _name(event.operator_id)} 撤回了 {await _name(event.user_id)} 的一条消息"
+    return None
+
+
+async def _generic_notice_text(bot: Bot, info: SessionInfo, event: Event) -> str | None:
+    event_name = ""
+    try:
+        event_name = str(event.get_event_name() or "")
+    except Exception:
+        pass
+    key = re.sub(r"[^a-z0-9]+", "", f"{type(event).__name__} {event_name}".lower())
+    for keywords, template in _NOTICE_RULES:
+        if any(kw in key for kw in keywords):
+            return _fill(template, await _subject_name(bot, info, event))
+    return _prose_description(event, event_name) or event_name or None
+
+
+def _fill(template: str, who: str) -> str:
+    text = template.replace("{who}", who).strip()
+    return re.sub(r"\s{2,}", " ", text)
+
+
+async def _subject_name(bot: Bot, info: SessionInfo, event: Event) -> str:
+    """通知主体（被禁言/被移出/撤回消息的那位）的显示名"""
+    uid = _subject_id(event)
+    if not uid:
+        return ""
+    return await display_user(bot, info, uid) or uid
+
+
+def _subject_id(event: Event) -> str:
+    try:
+        uid = event.get_user_id()
+    except Exception:
+        uid = ""
+    if uid:
+        return str(uid)
+    for path in _SUBJECT_PATHS:
+        obj: object = event
+        for attr in path:
+            if isinstance(attr, int):
+                obj = obj[attr] if isinstance(obj, (list, tuple)) and len(obj) > attr else None
+            else:
+                obj = getattr(obj, attr, None)
+            if obj is None:
+                break
+        if obj not in (None, ""):
+            return str(obj)
+    return ""
+
+
+def _prose_description(event: Event, event_name: str) -> str | None:
+    """适配器自带的事件描述；只有像句子的才用（dump 形态与空描述丢弃）"""
+    try:
+        desc = str(event.get_event_description() or "").strip()
+    except Exception:
+        return None
+    if not desc or desc == event_name or len(desc) > _DESCRIPTION_MAX:
+        return None
+    if desc.startswith("{") or desc.startswith("["):
+        return None
+    return desc

{nonebot_plugin_aigf_master-2.0.0b0 → nonebot_plugin_aigf_master-2.0.0b2}/nonebot_plugin_aigf_master/plugin_invoker.py

@@ -6,10 +6,13 @@
 """
 
 import asyncio
+from copy import deepcopy
 from typing import Literal
+from collections.abc import MutableMapping
 
 from nonebot import get_driver, logger
 from nonebot.message import handle_event
+from nonebot_plugin_alconna import UniMessage
 from nonebot_plugin_uninfo import get_interface
 
 from .session import SessionInfo, display_name
@@ -100,6 +103,129 @@ async def _sender_update(bot, session: SessionInfo | None, user_id) -> dict:
     return update
 
 
+def _can_hold_message(template, message, expected_text: str) -> bool:
+    """事件的 `message` 字段能否直接放本适配器的 Message
+
+    多数适配器（onebot/telegram/discord…）可以；但 **Satori** 这类事件的 `message` 是 `{id, content}`
+    结构体，真正的消息由 `get_message()` 解析出来——硬塞 Message 进去会把事件弄坏
+    （`get_message()` 报错、`get_message_id()` 取不到 id），目标插件也就读不到命令。
+
+    做法是**实测**：塞进副本后能取到非空 `get_message()` 就认（拿不准时保留原行为、由文本替换兜底）。
+    """
+    try:
+        probe = template.model_copy(update={"message": message})
+        text = str(probe.get_message())
+    except Exception as e:
+        logger.debug(f"[Invoker] message 字段不接受统一消息，改用文本替换: {e}")
+        return False
+    if not text.strip():
+        return False
+    # 能读到新内容才认为放得下：纯文本比对（at/图片段在 extract 里看不到）或整串比对
+    return expected_text.strip() in text or str(message) in text
+
+
+def _plain_incoming(bot, event) -> str:
+    """取事件里原来的纯文本（用于「把旧文本替换成命令文本」）
+
+    先用 alconna 的通用层解析（各适配器都可靠），拿不到再退回适配器自己的 `extract_plain_text()`
+    —— 部分适配器的 `extract_plain_text()` 会返回空串（实测 Satori），直接用它会让替换失效。
+    """
+    try:
+        unimsg = UniMessage.of(event.get_message(), bot=bot)
+        text = unimsg.extract_plain_text().strip()
+        if not text:
+            # 个别适配器（Satori）的 extract_plain_text 取不到文本，直接拼 Text 段
+            text = "".join(str(getattr(seg, "text", "") or "") for seg in unimsg).strip()
+        if text:
+            return text
+    except Exception as e:
+        logger.debug(f"[Invoker] 通用层取原文失败: {e}")
+    try:
+        return event.get_message().extract_plain_text().strip()
+    except Exception:
+        return ""
+
+
+def _is_patchable(value) -> bool:
+    """能继续往里找文本字段的容器：映射 / 列表 / pydantic 模型"""
+    return (isinstance(value, (MutableMapping, list))
+            or bool(getattr(type(value), "model_fields", None)))
+
+
+def _patch_text_fields(event, old_text: str, new_text: str) -> None:
+    """把事件里出现的旧消息文本替换成新文本（递归进嵌套模型/字典/列表，先复制再改以免污染原事件）
+
+    消息文本不总在统一的 `message` 字段里：discord 用 `content`、dodo 用 `message_body`、
+    feishu 在嵌套的 `event.event.message.content`、**Satori 的 `message` 是 `{id, content}` 结构体**。
+    只替换 `message` 的话，目标插件 `get_message()` 读到的仍是原来那条用户消息，命令永远匹配不上。
+    这里采用「旧文本出现在哪个字符串槽位就替换哪个」的通用兜底（不做适配器特判）。
+    """
+    if not old_text:
+        return
+
+    def visit(parent, name, value, depth: int, setter) -> None:
+        if isinstance(value, str):
+            if old_text in value:
+                try:
+                    setter(name, value.replace(old_text, new_text))
+                except Exception as e:
+                    logger.debug(f"[Invoker] 替换文本字段 {name} 失败: {e}")
+            return
+        if not _is_patchable(value):
+            return
+        if getattr(type(parent), "model_fields", None):
+            # 从模型往下走时复制一份，避免改到用于下次调用的模板事件
+            try:
+                copied = deepcopy(value)
+                setter(name, copied)
+                value = copied
+            except Exception:
+                pass
+        walk(value, depth + 1)
+
+    def walk(obj, depth: int = 0) -> None:
+        if depth > 4:
+            return
+        fields = list(getattr(type(obj), "model_fields", None) or [])
+        if fields:
+            for name in fields:
+                try:
+                    value = getattr(obj, name)
+                except Exception:
+                    continue
+                visit(obj, name, value, depth, lambda n, v, o=obj: setattr(o, n, v))
+        elif isinstance(obj, MutableMapping):
+            for name in list(obj.keys()):
+                visit(obj, name, obj.get(name), depth,
+                      lambda n, v: obj.__setitem__(n, v))
+        elif isinstance(obj, list):
+            for item in obj:
+                if _is_patchable(item):
+                    walk(item, depth + 1)
+
+    walk(event)
+
+
+def _reset_message_cache(event) -> None:
+    """清掉适配器「懒加载的消息缓存」私有属性（如 Discord 的 `_message` / `_original_message`）
+
+    Discord 的 `get_message()` 是 `if not hasattr(self, "_message"): self._message = ...` —— 结果会
+    缓存在私有属性里，而 `model_copy` 会把这份缓存一起带过来。不清理的话，即使我们换掉了消息体，
+    目标插件调用 `get_message()` 读到的仍是**原来那条消息**，命令永远匹配不上。
+    只动「名字里带 message 的私有属性」，不碰任何协议字段。
+    """
+    for holder in (getattr(event, "__dict__", None), getattr(event, "__pydantic_private__", None)):
+        if not isinstance(holder, dict):
+            continue
+        stale = [k for k in holder
+                 if k.startswith("_") and not k.startswith("__") and "message" in k.lower()]
+        for key in stale:
+            try:
+                holder.pop(key, None)
+            except Exception as e:
+                logger.debug(f"[Invoker] 清理消息缓存 {key} 失败: {e}")
+
+
 class PluginInvoker:
     """调用本实例的其它插件
 
@@ -165,13 +291,16 @@ class PluginInvoker:
         unimsg = messages[0] if messages else None
         message = await unimsg.export(bot=bot) if unimsg is not None else bot.adapter.get_message_class()()
 
-        update: dict = {"message": message}
+        update: dict = {}
+        command_text = plain_text(unimsg) if unimsg is not None else command
+        if _can_hold_message(template, message, command_text):
+            update["message"] = message
+            # 部分适配器（onebot 等）另有 original_message（@ 机器人时保留的原文），一并换掉，
+            # 否则 alconna 的 use_origin 路径仍会读到原来的用户消息
+            if hasattr(template, "original_message"):
+                update["original_message"] = message
         if hasattr(template, "raw_message"):
-            update["raw_message"] = plain_text(unimsg) if unimsg is not None else command
-        # 部分适配器（onebot 等）另有 original_message（@ 机器人时保留的原文），一并换掉，
-        # 否则 alconna 的 use_origin 路径仍会读到原来的用户消息
-        if hasattr(template, "original_message"):
-            update["original_message"] = message
+            update["raw_message"] = command_text
         # 合成消息没有引用关系：清掉被复制消息的 reply，避免目标插件以为它在回复某条消息
         if hasattr(template, "reply"):
             update["reply"] = None
@@ -193,6 +322,10 @@ class PluginInvoker:
                 setattr(event, SYNTHETIC_FLAG, True)
             except Exception:
                 pass
+        # 消息文本不总在 `message` 字段里（见 _patch_text_fields），补齐后才对得上目标插件
+        old_text = _plain_incoming(bot, template)
+        _patch_text_fields(event, old_text, plain_text(unimsg) if unimsg is not None else command)
+        _reset_message_cache(event)
         _refresh_uniseg_cache(event, bot)
         logger.debug(f"[Invoker] 创建 synthetic event: command={command}, session="
                      f"{getattr(session, 'key', '')}, user={user_id}, parts={parts}")

{nonebot_plugin_aigf_master-2.0.0b0 → nonebot_plugin_aigf_master-2.0.0b2}/nonebot_plugin_aigf_master/session.py

@@ -110,6 +110,14 @@ class SessionInfo:
         return int(self.native_chat_id) if self.native_chat_id.isdigit() else 0
 
 
+def event_user_id(event: Event) -> str:
+    """事件主体 id；通知类事件的 `get_user_id()` 常常直接抛 ValueError（OneBot V12 / Telegram / EFChat 等）"""
+    try:
+        return str(event.get_user_id() or "")
+    except Exception:
+        return ""
+
+
 def _from_uninfo(bot: Bot, event: Event, sess) -> SessionInfo:
     scene = sess.scene
     member_scene = scene.parent or scene
@@ -134,7 +142,7 @@ def _from_uninfo(bot: Bot, event: Event, sess) -> SessionInfo:
         scene_type=scene.type,
         member_scene_type=member_scene.type,
         member_scene_id=str(member_scene.id),
-        user_id=str(event.get_user_id() or user.id or ""),
+        user_id=event_user_id(event) or user.id or "",
         user_name=display_name(user),
         card=card,
         target=target,
@@ -173,7 +181,7 @@ async def resolve_session(bot: Bot, event: Event) -> SessionInfo | None:
         adapter_name=bot.adapter.get_name(),
         is_private=bool(target.private),
         is_channel=bool(target.channel),
-        user_id=str(event.get_user_id() or ""),
+        user_id=event_user_id(event),
         target=target,
     )
 

{nonebot_plugin_aigf_master-2.0.0b0 → nonebot_plugin_aigf_master-2.0.0b2}/nonebot_plugin_aigf_master/unimsg.py

@@ -255,15 +255,33 @@ async def build_unimsg(bot: Bot, event: Event) -> UniMessage | None:
 
 
 def _sender_label(sender) -> str:
-    """从 sender（对象或 dict）里取「昵称(用户id)」标签"""
+    """从 sender（对象或 dict）里取「昵称(用户id)」标签
+
+    只接受**字符串**取值：部分适配器（如 Kaiheila）原始回复段上的 sender 是对象/方法甚至占位值，
+    直接 `value.strip()` 会抛 TypeError 把整条消息的渲染打挂（实测踩过）。
+    """
     if sender is None:
         return ""
-    if isinstance(sender, dict):
-        nick = (sender.get("nickname") or sender.get("name") or "").strip()
-        uid = str(sender.get("user_id") or "")
-    else:
-        nick = (getattr(sender, "nickname", None) or getattr(sender, "name", None) or "").strip()
-        uid = str(getattr(sender, "user_id", "") or "")
+
+    def pick(obj, name: str) -> str:
+        try:
+            value = obj.get(name) if isinstance(obj, dict) else getattr(obj, name, None)
+        except Exception:
+            return ""
+        return value.strip() if isinstance(value, str) else ""
+
+    def pick_id(obj, name: str) -> str:
+        """用户 id 可能是 int（onebot）也可能是 str（多数平台），只拒掉非标量"""
+        try:
+            value = obj.get(name) if isinstance(obj, dict) else getattr(obj, name, None)
+        except Exception:
+            return ""
+        if isinstance(value, bool) or not isinstance(value, (str, int)):
+            return ""
+        return str(value).strip()
+
+    nick = pick(sender, "nickname") or pick(sender, "name")
+    uid = pick_id(sender, "user_id")
     if uid and nick:
         return f"{nick}({uid})"
     return nick or uid

{nonebot_plugin_aigf_master-2.0.0b0 → nonebot_plugin_aigf_master-2.0.0b2}/nonebot_plugin_aigf_master.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nonebot-plugin-aigf-master
-Version: 2.0.0b0
+Version: 2.0.0b2
 Summary: 群聊特化LLM聊天机器人（增强版），具有记忆、表情包、跨插件调用、跨bot通信与跨适配器支持
 License-Expression: MIT
 Requires-Python: <4.0,>=3.10
@@ -67,7 +67,7 @@ Dynamic: license-file
 - ⏱️ **不完整消息检测**：纯 @ 消息或连续发送时自动延长等待时间
 - 🕐 **消息时间标注**：可选为 LLM 看到的消息加上 `[MM-DD HH:MM]` 时间前缀（`AIGFM_SHOW_MESSAGE_TIME`）
 - 📄 **完整消息类型**：合并聊天记录、小程序/卡片、XML，以及 QQ 表情/语音/视频/群文件/链接分享/推荐名片/位置/音乐/骰子等共 18 种消息段均可解析（纯此类消息不再被丢弃）
-- 🔔 **群系统通知**：戳一戳、禁言/解禁、新人进群、退群被踢、消息撤回会以 `[系统]` 消息进入 LLM 上下文
+- 🔔 **群系统通知**：戳一戳、禁言/解禁、新人进群、退群被踢、消息撤回等会以 `[系统]` 消息进入 LLM 上下文（OneBot V11 文案最细，其它适配器按通知类别映射成中文，见「多适配器支持」）
 - 🔒 **强制 JSON 输出**：确保 LLM 始终返回正确格式
 - ⚡ **轻量高效**：单次 LLM 调用完成对话 + 记忆管理 + 命令学习
 
@@ -80,9 +80,9 @@ Dynamic: license-file
 >
 > 从 2.0 起插件还依赖 `nonebot-plugin-alconna` 与 `nonebot-plugin-uninfo`（跨适配器收发与会话/成员信息），用下面的方式安装时会自动装上。
 
-### 安装 beta 版本（2.0.0b0）
+### 安装 beta 版本（2.0.0b2）
 
-`2.0.0b0` 是**预发布（pre-release）版本**，因此：
+`2.0.0b2` 是**预发布（pre-release）版本**，因此：
 
 - `pip install nonebot-plugin-aigf-master` 装的仍是稳定版 **1.6.x**
 - `nb plugin install nonebot-plugin-aigf-master` 同样只装稳定版，而且 nb-cli **不支持指定版本**，所以 beta 只能用 pip 装
@@ -90,7 +90,7 @@ Dynamic: license-file
 要装 beta，**必须显式写出版本号**：
 
 ```bash
-pip install nonebot-plugin-aigf-master==2.0.0b0
+pip install nonebot-plugin-aigf-master==2.0.0b2
 ```
 
 在 `pyproject.toml` 中添加：
@@ -248,18 +248,67 @@ AIGFM_PEER_CAPTURE_PLUGINS=[]          # 要捕获输出的插件名列表，为
 - 落盘目录名不能含 `:`，因此磁盘上写作 `onebot11_617770183`；`memory/` 下旧版裸数字目录会在启动时**一次性自动迁移**（目标已存在则跳过，幂等）
 - 非启用会话不发请求、不入缓冲：插件只会为启用的会话解析成员信息与图片
 
-### 各能力在非 OneBot 适配器上的边界
-
-| 能力 | 其它适配器 | 说明 |
-|---|---|---|
-| 聊天、记忆、表情包、生图、命令学习、管理命令 | ✅ 可用 | `status` / `reset` / `set_role` / `presets` / `set_preset` / `reload_meme` 已改为 alconna 响应器，各适配器通用 |
-| 跨插件感知（捕获其它插件的输出） | ✅ 一般可用 | 依赖 NoneBot 基类的 `on_calling_api` 钩子（所有适配器）；会话取自当前事件，消息取自适配器消息对象，取不到就静默跳过 |
-| 插件调用（`invoke_plugin`） | ⚠️ 尽力支持 | 通过复制该会话最近一条真实事件来投递命令；事件类型、消息类都由适配器自己决定，不需 onebot 专属类型。目标插件若依赖适配器特有能力（例如 OneBot 的 `get_msg`）仍可能失败 |
-| 群系统通知（戳一戳/禁言/进出群/撤回） | ❌ 仅 OneBot | 这些是 OneBot 专属事件类型，其它适配器没有统一的通知模型，不处理 |
-| 跨 bot 通信（子插件 `/peer/capture`） | ❌ 仅 OneBot | 其它 bot 都是同号 OneBot 实例，推送按 `onebot11:` 会话映射 |
-| 群名片记录 | ✅ 有则记录 | 成员信息来自 uninfo，适配器不提供名片时该项为空 |
-
-> 适配器完全不被 alconna/uninfo 支持时，该会话的消息会被静默跳过（只留 debug 日志），不会报错、也不会影响其它适配器。
+### 功能 × 适配器支持表（2026-09-25 实测）
+
+为每个适配器**构造真实事件**跑同一套功能路径（会话解析 → 渲染 → 回复发送 → 跨插件捕获 → 插件调用），bot 是记录型 mock，**未连真实平台**。
+
+| 适配器 | 会话解析 | 收发/渲染 | 回复发送 | 私聊 | @ 按昵称 | 跨插件捕获 | 插件调用 | 群通知 | 跨 bot |
+|---|---|---|---|---|---|---|---|---|---|
+| OneBot V11 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
+| OneBot V12 | ✅ | ✅ | ✅ | ✅ | ⚠️ | ✅ | ✅ | ✅ | ✅ |
+| Console | ✅ | ✅ | ✅ | ✅ | ⚠️ | ✅ | ✅ | ❌ | ✅ |
+| Satori | ✅ | ✅ | ✅ | ✅ | ⚠️ | ✅ | ⚠️ | ✅ | ✅ |
+| Telegram | ✅ | ✅ | ✅ | ✅ | ⚠️ | ✅ | ✅ | ✅ | ✅ |
+| Discord | ✅ | ✅ | ✅ | ✅ | ⚠️ | ✅ | ✅ | ⚠️ | ✅ |
+| QQ（频道/C2C/群） | ✅ | ✅ | ✅ | ✅ | ⚠️ | ✅ | ✅ | ✅ | ✅ |
+| Feishu | ✅ | ✅ | ✅ | ✅ | ⚠️ | ✅ | ✅ | ❌ | ✅ |
+| Milky | ✅ | ✅ | ✅ | ✅ | ⚠️ | ✅ | ✅ | ✅ | ✅ |
+| Mirai | ✅ | ✅ | ✅ | ✅ | ⚠️ | ✅ | ✅ | ✅ | ✅ |
+| Kaiheila（Kook） | ✅ | ✅ | ✅ | 未测 | ⚠️ | ✅ | ⚠️ | ✅ | ✅ |
+| DoDo | ✅ | ✅ | ✅ | ✅ | ⚠️ | ✅ | ✅ | ✅ | ✅ |
+| Kritor | ✅ | ✅ | ✅ | 未测 | ⚠️ | ✅ | ✅ | ❌ | ✅ |
+| Mail | ✅（仅私聊） | ✅ | ✅ | ✅ | ⚠️ | ✅ | ✅ | ❌ | ✅ |
+| Minecraft | ✅（仅私聊） | ✅ | ✅ | ✅ | ⚠️ | ✅ | ✅ | ❌ | ✅ |
+| WXMP | ✅（仅私聊） | ✅ | ✅ | ✅ | ⚠️ | ✅ | ✅ | ❌ | ✅ |
+| EFChat | ✅ | ✅ | ✅ | ✅ | ⚠️ | ✅ | ✅ | ❌ | ✅ |
+| YunHu | ✅ | ✅ | ✅ | 未测 | ⚠️ | ✅ | ✅ | ✅ | ✅ |
+| bilibili Live | ✅ | ✅ | ✅ | ❌ 无好友私聊类型 | ⚠️ | ✅ | ✅ | ⚠️ | ✅ |
+
+图例：**✅ 已实测通过** ｜ **⚠️ 已实现但未验证通过**（离线构造不出该适配器的事件，或需要真实 API / 真机）｜ **❌ 该适配器没有这类事件，或库层无法把该通知定位到群/频道会话（通知会被跳过）** ｜ **未测** 本次未构造该场景。
+
+**已知特例**
+
+- **@ 按昵称**：只有 OneBot V11 能按群昵称反查用户 id，其余适配器请让 LLM 直接用用户 id
+- **插件调用**：Satori / Kaiheila 的事件结构特殊，离线未验证通过；其余 14 个已实测目标响应器收到命令
+- **群通知**：为每个适配器构造真实通知事件实测，**10 个通过**（OneBot V11/V12、Satori、Telegram、QQ、Milky、Mirai、Kaiheila、DoDo、YunHu）；Discord / bilibili 未验证（离线 mock 不够 / 只有部分通知类在库的覆盖范围内）；**Feishu、Kritor、EFChat** 的通知 uninfo 与 alconna 都无法定位到群/频道会话，**Minecraft、WXMP** 的通知事件没有群/频道字段（会话按私聊处理）——这几种会被跳过（库层限制，非本插件可修）
+- **YunHu / bilibili Live**：需要把 bot 跑在 **Python ≥ 3.12**（3.10 里导入即失败；这两行的 ✅ 是在 3.14 实测的）
+- **Kaiheila**：请装 `nonebot-adapter-kaiheila`（社区包 `nonebot-adapter-kook` 的模块名与 alconna/uninfo 期望的不一致）
+- **跨 bot**：按 peer 0.4.0+ 的 `session` 协议可用；旧 peer（0.3.x）只有 OneBot V11 的会话能对上
+- 适配器不被 alconna/uninfo 支持时，该会话的消息静默跳过（只留 debug 日志），不影响其它适配器
+
+<details>
+<summary>实测到的各适配器发送接口（供排查用）</summary>
+
+| 适配器 | 回复发送最终调用的接口 |
+|---|---|
+| OneBot V11 / V12 | `send_msg` / `send_message` |
+| Console | `send_message`（私聊 `send_private_message`） |
+| Satori | `send_message`（私聊 `send_private_message`） |
+| Telegram | `send_to` |
+| Discord | `send_to` |
+| QQ | `send_to_group` / `send_to_channel` / `send_to_c2c` |
+| Feishu | `send_msg` |
+| Milky | `send_group_message` / `send_private_message` |
+| Mirai | `send_group_message` / `send_friend_message` |
+| Kaiheila | `send_msg`（按 channel/private 区分） |
+| DoDo | `send_to_channel` / `send_to_personal` |
+| Kritor | `send_message` / `send_channel_message` |
+| Mail | `send_to` |
+| Minecraft | `send_msg` |
+| WXMP | `send_custom_message` |
+| EFChat | `send_chat_message` |
+
+</details>
 
 ## 🔌 跨插件感知
 

{nonebot_plugin_aigf_master-2.0.0b0 → nonebot_plugin_aigf_master-2.0.0b2}/nonebot_plugin_aigf_master.egg-info/SOURCES.txt

@@ -15,6 +15,7 @@ nonebot_plugin_aigf_master/llm_client.py
 nonebot_plugin_aigf_master/meme_store.py
 nonebot_plugin_aigf_master/memory_store.py
 nonebot_plugin_aigf_master/models.py
+nonebot_plugin_aigf_master/notice.py
 nonebot_plugin_aigf_master/peer_client.py
 nonebot_plugin_aigf_master/plugin_discovery.py
 nonebot_plugin_aigf_master/plugin_invoker.py

{nonebot_plugin_aigf_master-2.0.0b0 → nonebot_plugin_aigf_master-2.0.0b2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "nonebot-plugin-aigf-master"
-version = "2.0.0b0"
+version = "2.0.0b2"
 description = "群聊特化LLM聊天机器人（增强版），具有记忆、表情包、跨插件调用、跨bot通信与跨适配器支持"
 readme = "README.md"
 license = "MIT"