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

{nonebot_plugin_aigf_master-2.0.0b1 → 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.0b1
+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.0b1）
+### 安装 beta 版本（2.0.0b2）
 
-`2.0.0b1` 是**预发布（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.0b1
+pip install nonebot-plugin-aigf-master==2.0.0b2
 ```
 
 在 `pyproject.toml` 中添加：
@@ -250,42 +250,41 @@ AIGFM_PEER_CAPTURE_PLUGINS=[]          # 要捕获输出的插件名列表，为
 
 ### 功能 × 适配器支持表（2026-09-25 实测）
 
-测试方式：本机用 `nb`/pip 装上各适配器包后，为每个适配器**构造真实事件**（各适配器的消息/事件模型），跑本插件同一套功能路径——会话解析（uninfo）→ 消息渲染（uniseg）→ 回复发送（alconna exporter）→ 跨插件捕获（`on_calling_api`）→ 插件调用（复制真实事件 + 目标响应器实际收到命令）。bot 为记录型 mock（拦下所有 API 调用并断言调用的接口名），**未连真实平台**，因此"需要真实 API 才有数据"的项目另标 ⚠。
+为每个适配器**构造真实事件**跑同一套功能路径（会话解析 → 渲染 → 回复发送 → 跨插件捕获 → 插件调用），bot 是记录型 mock，**未连真实平台**。
 
-| 适配器 | 会话解析 | 收发/渲染 | 回复发送 | 私聊 | @ 按昵称 | 跨插件捕获 | 插件调用 | 群通知¹ | 跨 bot² |
+| 适配器 | 会话解析 | 收发/渲染 | 回复发送 | 私聊 | @ 按昵称 | 跨插件捕获 | 插件调用 | 群通知 | 跨 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⁴ | ✅ | ✅ | ✅ | ❌ 无好友私聊类型 | ⚠ | ✅ | ✅ | ❌ | ✅ |
-
-**读表说明**
-
-- **✅ 已实测通过**：会话键、渲染文本、发送接口、捕获入缓冲、目标插件确实收到了命令，逐项断言过。**本表 17 行在 Python 3.10 实测（167 项检查）**；**YunHu / bilibili Live 两行在 Python 3.14 实测**（3.10 装不上，见下），19 个适配器合计 **187 项检查、只有 2 项未通过**（Satori / Kaiheila 的插件调用）
-- **整套依赖栈在 Python 3.14 上跑通**：`nonebot2 2.5.0` + `nonebot-plugin-alconna 0.62.1` + `nonebot-plugin-uninfo 0.11.2` 在 **Python 3.14.3** 上通过了全部回归——主插件 150 项、peer 子插件 67 项、适配器矩阵 187 项（仅上述 2 项未通过）
-- **⚠ 需真机/特例**：
-  - **@ 按昵称**：只有 OneBot V11 实测能按群昵称反查出用户 id（走 `get_group_member_list`）；其它适配器需要 uninfo 的成员列表查询实现（多数适配器没有），因此**让 LLM 直接用用户 id 更稳**；渲染 @ 时昵称拿不到会回落成 id
-  - **插件调用（Satori / Kaiheila）**：这两类适配器的事件结构特殊（Satori 的 `message` 是 `{id, content}` 结构体、Kaiheila 的消息在嵌套的 `event` 里），离线构造"uninfo 与 alconna 都认可"的事件未能复现，因此**未验证通过**；其余 14 个适配器已实测目标响应器收到命令。真机使用请以实际表现为准
-- **❌ 不支持**：群系统通知¹（戳一戳/禁言/进出群/撤回是 OneBot 专属事件类型）
-- **⚠ Python 版本要求**（上表 YunHu / bilibili Live）：这两个适配器包**需要 Python ≥ 3.12**——`bilibili Live` 用了 `typing.TypedDict`（pydantic 在 Python < 3.12 直接拒绝），`YunHu` 还额外用到 `typing.NotRequired`（Python 3.11+），所以在 Python 3.10 的 bot 里**导入即失败**。上表这两行的 ✅ 是**在本机 Python 3.14.3 上实测的结果**：两个包都能导入，`alconna` 的 builder/exporter 与 `uninfo` 的 fetcher 三者齐备，会话解析/渲染/发送/捕获/插件调用全部通过（`bilibili Live` 的场景路径＝房间号；`YunHu` 的群资料需要真实 API 才有昵称）。**要用这两个平台就把 bot 跑在 Python 3.12+/3.14 上**（本工作目录另建了参考环境 `.venv314`：Python 3.14.3 + `nonebot2 2.5.0` + `alconna 0.62.1` + `uninfo 0.11.2` + 全部 19 个适配器包，回归与矩阵都在里面跑过）
-- **Kook 注意**：社区包 `nonebot-adapter-kook` 的模块名是 `nonebot.adapters.kook`、`get_name()` 报 `Kook`，而 alconna/uninfo 期望的是 `nonebot.adapters.kaiheila`（`Kaiheila`）——**请安装 `nonebot-adapter-kaiheila`**，否则该平台等同于"不被支持"
-- **昵称/群名片**：取决于适配器的 uninfo fetcher 能取到什么（很多要真实 API 调用，离线 mock 拿不到），拿不到时回落成用户 id，功能不受影响
-- 适配器完全不被 alconna/uninfo 支持时，该会话的消息会被静默跳过（只留 debug 日志），不会报错、也不会影响其它适配器
+| 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>
@@ -311,11 +310,6 @@ AIGFM_PEER_CAPTURE_PLUGINS=[]          # 要捕获输出的插件名列表，为
 
 </details>
 
-> ¹ 群系统通知 = 戳一戳/禁言/进出群/消息撤回。
-> ² 跨 bot = 子插件 [nonebot-plugin-aigfm-peer](https://github.com/Funny1Potato/nonebot-plugin-aigfm-peer) 的推送与远程调用。上表按 **peer 0.4.0+** 的协议标 ✅：推送与调用都会带 `session`（`适配器:会话id`）、主插件按会话键落位，因此各适配器都可用。**用旧 peer（0.3.x）时只有 OneBot V11 的会话能对上**（旧协议只带 `group_id`，按 `onebot11:{group_id}` 映射）。peer 侧捕获/推送与主插件侧落位各自实测过，端到端的「复制事件执行命令」在 OneBot V11 与 Console 上跑通。
-> ³ Kritor / Kaiheila 的私聊事件本次未构造，故未测；它们的私聊类型在 alconna/uninfo 里是有实现的。
-> ⁴ 这两个适配器**需要 Python ≥ 3.12**（3.10 环境里导入即失败），表里这两行是在 **Python 3.14.3** 下实测的结果，见下方说明。
-
 ## 🔌 跨插件感知
 
 ### 工作原理

{nonebot_plugin_aigf_master-2.0.0b1 → 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.0b1）
+### 安装 beta 版本（2.0.0b2）
 
-`2.0.0b1` 是**预发布（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.0b1
+pip install nonebot-plugin-aigf-master==2.0.0b2
 ```
 
 在 `pyproject.toml` 中添加：
@@ -228,42 +228,41 @@ AIGFM_PEER_CAPTURE_PLUGINS=[]          # 要捕获输出的插件名列表，为
 
 ### 功能 × 适配器支持表（2026-09-25 实测）
 
-测试方式：本机用 `nb`/pip 装上各适配器包后，为每个适配器**构造真实事件**（各适配器的消息/事件模型），跑本插件同一套功能路径——会话解析（uninfo）→ 消息渲染（uniseg）→ 回复发送（alconna exporter）→ 跨插件捕获（`on_calling_api`）→ 插件调用（复制真实事件 + 目标响应器实际收到命令）。bot 为记录型 mock（拦下所有 API 调用并断言调用的接口名），**未连真实平台**，因此"需要真实 API 才有数据"的项目另标 ⚠。
+为每个适配器**构造真实事件**跑同一套功能路径（会话解析 → 渲染 → 回复发送 → 跨插件捕获 → 插件调用），bot 是记录型 mock，**未连真实平台**。
 
-| 适配器 | 会话解析 | 收发/渲染 | 回复发送 | 私聊 | @ 按昵称 | 跨插件捕获 | 插件调用 | 群通知¹ | 跨 bot² |
+| 适配器 | 会话解析 | 收发/渲染 | 回复发送 | 私聊 | @ 按昵称 | 跨插件捕获 | 插件调用 | 群通知 | 跨 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⁴ | ✅ | ✅ | ✅ | ❌ 无好友私聊类型 | ⚠ | ✅ | ✅ | ❌ | ✅ |
-
-**读表说明**
-
-- **✅ 已实测通过**：会话键、渲染文本、发送接口、捕获入缓冲、目标插件确实收到了命令，逐项断言过。**本表 17 行在 Python 3.10 实测（167 项检查）**；**YunHu / bilibili Live 两行在 Python 3.14 实测**（3.10 装不上，见下），19 个适配器合计 **187 项检查、只有 2 项未通过**（Satori / Kaiheila 的插件调用）
-- **整套依赖栈在 Python 3.14 上跑通**：`nonebot2 2.5.0` + `nonebot-plugin-alconna 0.62.1` + `nonebot-plugin-uninfo 0.11.2` 在 **Python 3.14.3** 上通过了全部回归——主插件 150 项、peer 子插件 67 项、适配器矩阵 187 项（仅上述 2 项未通过）
-- **⚠ 需真机/特例**：
-  - **@ 按昵称**：只有 OneBot V11 实测能按群昵称反查出用户 id（走 `get_group_member_list`）；其它适配器需要 uninfo 的成员列表查询实现（多数适配器没有），因此**让 LLM 直接用用户 id 更稳**；渲染 @ 时昵称拿不到会回落成 id
-  - **插件调用（Satori / Kaiheila）**：这两类适配器的事件结构特殊（Satori 的 `message` 是 `{id, content}` 结构体、Kaiheila 的消息在嵌套的 `event` 里），离线构造"uninfo 与 alconna 都认可"的事件未能复现，因此**未验证通过**；其余 14 个适配器已实测目标响应器收到命令。真机使用请以实际表现为准
-- **❌ 不支持**：群系统通知¹（戳一戳/禁言/进出群/撤回是 OneBot 专属事件类型）
-- **⚠ Python 版本要求**（上表 YunHu / bilibili Live）：这两个适配器包**需要 Python ≥ 3.12**——`bilibili Live` 用了 `typing.TypedDict`（pydantic 在 Python < 3.12 直接拒绝），`YunHu` 还额外用到 `typing.NotRequired`（Python 3.11+），所以在 Python 3.10 的 bot 里**导入即失败**。上表这两行的 ✅ 是**在本机 Python 3.14.3 上实测的结果**：两个包都能导入，`alconna` 的 builder/exporter 与 `uninfo` 的 fetcher 三者齐备，会话解析/渲染/发送/捕获/插件调用全部通过（`bilibili Live` 的场景路径＝房间号；`YunHu` 的群资料需要真实 API 才有昵称）。**要用这两个平台就把 bot 跑在 Python 3.12+/3.14 上**（本工作目录另建了参考环境 `.venv314`：Python 3.14.3 + `nonebot2 2.5.0` + `alconna 0.62.1` + `uninfo 0.11.2` + 全部 19 个适配器包，回归与矩阵都在里面跑过）
-- **Kook 注意**：社区包 `nonebot-adapter-kook` 的模块名是 `nonebot.adapters.kook`、`get_name()` 报 `Kook`，而 alconna/uninfo 期望的是 `nonebot.adapters.kaiheila`（`Kaiheila`）——**请安装 `nonebot-adapter-kaiheila`**，否则该平台等同于"不被支持"
-- **昵称/群名片**：取决于适配器的 uninfo fetcher 能取到什么（很多要真实 API 调用，离线 mock 拿不到），拿不到时回落成用户 id，功能不受影响
-- 适配器完全不被 alconna/uninfo 支持时，该会话的消息会被静默跳过（只留 debug 日志），不会报错、也不会影响其它适配器
+| 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>
@@ -289,11 +288,6 @@ AIGFM_PEER_CAPTURE_PLUGINS=[]          # 要捕获输出的插件名列表，为
 
 </details>
 
-> ¹ 群系统通知 = 戳一戳/禁言/进出群/消息撤回。
-> ² 跨 bot = 子插件 [nonebot-plugin-aigfm-peer](https://github.com/Funny1Potato/nonebot-plugin-aigfm-peer) 的推送与远程调用。上表按 **peer 0.4.0+** 的协议标 ✅：推送与调用都会带 `session`（`适配器:会话id`）、主插件按会话键落位，因此各适配器都可用。**用旧 peer（0.3.x）时只有 OneBot V11 的会话能对上**（旧协议只带 `group_id`，按 `onebot11:{group_id}` 映射）。peer 侧捕获/推送与主插件侧落位各自实测过，端到端的「复制事件执行命令」在 OneBot V11 与 Console 上跑通。
-> ³ Kritor / Kaiheila 的私聊事件本次未构造，故未测；它们的私聊类型在 alconna/uninfo 里是有实现的。
-> ⁴ 这两个适配器**需要 Python ≥ 3.12**（3.10 环境里导入即失败），表里这两行是在 **Python 3.14.3** 下实测的结果，见下方说明。
-
 ## 🔌 跨插件感知
 
 ### 工作原理

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

@@ -15,10 +15,6 @@ 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, inherit_supported_adapters
 
@@ -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
@@ -434,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)
@@ -525,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()
@@ -687,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.0b1 → 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.0b1 → 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.0b1
+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.0b1）
+### 安装 beta 版本（2.0.0b2）
 
-`2.0.0b1` 是**预发布（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.0b1
+pip install nonebot-plugin-aigf-master==2.0.0b2
 ```
 
 在 `pyproject.toml` 中添加：
@@ -250,42 +250,41 @@ AIGFM_PEER_CAPTURE_PLUGINS=[]          # 要捕获输出的插件名列表，为
 
 ### 功能 × 适配器支持表（2026-09-25 实测）
 
-测试方式：本机用 `nb`/pip 装上各适配器包后，为每个适配器**构造真实事件**（各适配器的消息/事件模型），跑本插件同一套功能路径——会话解析（uninfo）→ 消息渲染（uniseg）→ 回复发送（alconna exporter）→ 跨插件捕获（`on_calling_api`）→ 插件调用（复制真实事件 + 目标响应器实际收到命令）。bot 为记录型 mock（拦下所有 API 调用并断言调用的接口名），**未连真实平台**，因此"需要真实 API 才有数据"的项目另标 ⚠。
+为每个适配器**构造真实事件**跑同一套功能路径（会话解析 → 渲染 → 回复发送 → 跨插件捕获 → 插件调用），bot 是记录型 mock，**未连真实平台**。
 
-| 适配器 | 会话解析 | 收发/渲染 | 回复发送 | 私聊 | @ 按昵称 | 跨插件捕获 | 插件调用 | 群通知¹ | 跨 bot² |
+| 适配器 | 会话解析 | 收发/渲染 | 回复发送 | 私聊 | @ 按昵称 | 跨插件捕获 | 插件调用 | 群通知 | 跨 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⁴ | ✅ | ✅ | ✅ | ❌ 无好友私聊类型 | ⚠ | ✅ | ✅ | ❌ | ✅ |
-
-**读表说明**
-
-- **✅ 已实测通过**：会话键、渲染文本、发送接口、捕获入缓冲、目标插件确实收到了命令，逐项断言过。**本表 17 行在 Python 3.10 实测（167 项检查）**；**YunHu / bilibili Live 两行在 Python 3.14 实测**（3.10 装不上，见下），19 个适配器合计 **187 项检查、只有 2 项未通过**（Satori / Kaiheila 的插件调用）
-- **整套依赖栈在 Python 3.14 上跑通**：`nonebot2 2.5.0` + `nonebot-plugin-alconna 0.62.1` + `nonebot-plugin-uninfo 0.11.2` 在 **Python 3.14.3** 上通过了全部回归——主插件 150 项、peer 子插件 67 项、适配器矩阵 187 项（仅上述 2 项未通过）
-- **⚠ 需真机/特例**：
-  - **@ 按昵称**：只有 OneBot V11 实测能按群昵称反查出用户 id（走 `get_group_member_list`）；其它适配器需要 uninfo 的成员列表查询实现（多数适配器没有），因此**让 LLM 直接用用户 id 更稳**；渲染 @ 时昵称拿不到会回落成 id
-  - **插件调用（Satori / Kaiheila）**：这两类适配器的事件结构特殊（Satori 的 `message` 是 `{id, content}` 结构体、Kaiheila 的消息在嵌套的 `event` 里），离线构造"uninfo 与 alconna 都认可"的事件未能复现，因此**未验证通过**；其余 14 个适配器已实测目标响应器收到命令。真机使用请以实际表现为准
-- **❌ 不支持**：群系统通知¹（戳一戳/禁言/进出群/撤回是 OneBot 专属事件类型）
-- **⚠ Python 版本要求**（上表 YunHu / bilibili Live）：这两个适配器包**需要 Python ≥ 3.12**——`bilibili Live` 用了 `typing.TypedDict`（pydantic 在 Python < 3.12 直接拒绝），`YunHu` 还额外用到 `typing.NotRequired`（Python 3.11+），所以在 Python 3.10 的 bot 里**导入即失败**。上表这两行的 ✅ 是**在本机 Python 3.14.3 上实测的结果**：两个包都能导入，`alconna` 的 builder/exporter 与 `uninfo` 的 fetcher 三者齐备，会话解析/渲染/发送/捕获/插件调用全部通过（`bilibili Live` 的场景路径＝房间号；`YunHu` 的群资料需要真实 API 才有昵称）。**要用这两个平台就把 bot 跑在 Python 3.12+/3.14 上**（本工作目录另建了参考环境 `.venv314`：Python 3.14.3 + `nonebot2 2.5.0` + `alconna 0.62.1` + `uninfo 0.11.2` + 全部 19 个适配器包，回归与矩阵都在里面跑过）
-- **Kook 注意**：社区包 `nonebot-adapter-kook` 的模块名是 `nonebot.adapters.kook`、`get_name()` 报 `Kook`，而 alconna/uninfo 期望的是 `nonebot.adapters.kaiheila`（`Kaiheila`）——**请安装 `nonebot-adapter-kaiheila`**，否则该平台等同于"不被支持"
-- **昵称/群名片**：取决于适配器的 uninfo fetcher 能取到什么（很多要真实 API 调用，离线 mock 拿不到），拿不到时回落成用户 id，功能不受影响
-- 适配器完全不被 alconna/uninfo 支持时，该会话的消息会被静默跳过（只留 debug 日志），不会报错、也不会影响其它适配器
+| 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>
@@ -311,11 +310,6 @@ AIGFM_PEER_CAPTURE_PLUGINS=[]          # 要捕获输出的插件名列表，为
 
 </details>
 
-> ¹ 群系统通知 = 戳一戳/禁言/进出群/消息撤回。
-> ² 跨 bot = 子插件 [nonebot-plugin-aigfm-peer](https://github.com/Funny1Potato/nonebot-plugin-aigfm-peer) 的推送与远程调用。上表按 **peer 0.4.0+** 的协议标 ✅：推送与调用都会带 `session`（`适配器:会话id`）、主插件按会话键落位，因此各适配器都可用。**用旧 peer（0.3.x）时只有 OneBot V11 的会话能对上**（旧协议只带 `group_id`，按 `onebot11:{group_id}` 映射）。peer 侧捕获/推送与主插件侧落位各自实测过，端到端的「复制事件执行命令」在 OneBot V11 与 Console 上跑通。
-> ³ Kritor / Kaiheila 的私聊事件本次未构造，故未测；它们的私聊类型在 alconna/uninfo 里是有实现的。
-> ⁴ 这两个适配器**需要 Python ≥ 3.12**（3.10 环境里导入即失败），表里这两行是在 **Python 3.14.3** 下实测的结果，见下方说明。
-
 ## 🔌 跨插件感知
 
 ### 工作原理

{nonebot_plugin_aigf_master-2.0.0b1 → 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.0b1 → 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.0b1"
+version = "2.0.0b2"
 description = "群聊特化LLM聊天机器人（增强版），具有记忆、表情包、跨插件调用、跨bot通信与跨适配器支持"
 readme = "README.md"
 license = "MIT"