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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nonebot-plugin-aigf-master
-Version: 2.0.0b2
+Version: 2.0.0b3
 Summary: 群聊特化LLM聊天机器人（增强版），具有记忆、表情包、跨插件调用、跨bot通信与跨适配器支持
 License-Expression: MIT
 Requires-Python: <4.0,>=3.10
@@ -80,9 +80,9 @@ Dynamic: license-file
 >
 > 从 2.0 起插件还依赖 `nonebot-plugin-alconna` 与 `nonebot-plugin-uninfo`（跨适配器收发与会话/成员信息），用下面的方式安装时会自动装上。
 
-### 安装 beta 版本（2.0.0b2）
+### 安装 beta 版本（2.0.0b3）
 
-`2.0.0b2` 是**预发布（pre-release）版本**，因此：
+`2.0.0b3` 是**预发布（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.0b2
+pip install nonebot-plugin-aigf-master==2.0.0b3
 ```
 
 在 `pyproject.toml` 中添加：
@@ -115,8 +115,8 @@ plugins = ["nonebot-plugin-aigf-master"]
 AIGFM_LLM_API_KEY="sk-xxxxxxxxxxxx"                               # LLM API Key
 AIGFM_LLM_BASE_URL="https://api.deepseek.com"                     # LLM API 地址
 AIGFM_LLM_MODEL="deepseek-v4-flash"                               # LLM 模型名称
-AIGFM_ENABLED_GROUPS=[123456, 789012]                             # 启用的群/频道会话（可写 `适配器:会话id`，只写数字按 OneBot V11 识别）
-AIGFM_ENABLED_PRIVATE=[]                                          # 启用的私聊会话（同上写法；留空则私聊不响应）
+AIGFM_ENABLED_GROUPS=["onebot11:123456789", "console:console-chat"]  # 启用的群/频道会话（`适配器:会话id`；也可只写数字，按 OneBot V11 识别）
+AIGFM_ENABLED_PRIVATE=["onebot11:20001"]                          # 启用的私聊会话（同上写法；留空则私聊不响应）
 
 # --- 图片理解（VLM） ---
 AIGFM_IMAGE_MODE="vlm"                  # 图片模式: vlm / llm（默认 vlm）
@@ -234,7 +234,7 @@ AIGFM_PEER_CAPTURE_PLUGINS=[]          # 要捕获输出的插件名列表，为
 - 纯 @ 消息或检测到同一用户连续发送时，以及调用的插件返回图片时，等待时间会用 `AIGFM_INCOMPLETE_TIMEOUT`（默认 40 秒）**替代**默认的 30 秒（非叠加）
 - **有图片正在解析时整批推迟触发**：等到 VLM 描述填好后随**同一批**发给 LLM，不会把没有描述的空消息发出去；"图片进入解析"这一特例最长等待 `AIGFM_BATCH_TIMEOUT + AIGFM_INCOMPLETE_TIMEOUT`（默认 70 秒）后仍会放行，此时该图片以 `[图片解析中]` 进入上下文
 - 消息合并窗口内的同一用户连续消息会被合并为一条
-- 每次处理时，LLM 收到最近 **20 条**（可配置）历史聊天记录 + 四层记忆 + 预设 + 表情包列表 + 其它插件响应；本批消息只出现在「新消息」段，同一条插件响应也只注入一次（不会在历史与新消息里重复）
+- 每次处理时，LLM 收到最近 **20 条**（可配置）历史聊天记录 + 四层记忆 + 预设 + 表情包列表 + 其它插件响应；本批消息只出现在「新消息」段，同一条插件响应也只注入一次（不会在历史与新消息里重复）。历史聊天记录会落盘（`memory/<群号>/recent.json`），**机器人重启后仍能读回**
 - LLM 一次调用同时完成：回复决策 + 记忆管理 + 表情包选择 + 命令学习
 
 ## 🧩 多适配器支持
@@ -243,9 +243,9 @@ AIGFM_PEER_CAPTURE_PLUGINS=[]          # 要捕获输出的插件名列表，为
 
 ### 会话与启用清单
 
-- 会话以 **`适配器:会话id`** 为键，例如 `onebot11:617770183`（群）、`console:console-chat`（频道）、`onebot11:20001`（私聊）
+- 会话以 **`适配器:会话id`** 为键，例如 `onebot11:123456789`（群）、`console:console-chat`（频道）、`onebot11:20001`（私聊）
 - `AIGFM_ENABLED_GROUPS` 管群/频道会话、`AIGFM_ENABLED_PRIVATE` 管私聊会话；条目可写带前缀的完整键，也可以只写 id（**按 OneBot V11 识别**，旧配置无需改动）
-- 落盘目录名不能含 `:`，因此磁盘上写作 `onebot11_617770183`；`memory/` 下旧版裸数字目录会在启动时**一次性自动迁移**（目标已存在则跳过，幂等）
+- 落盘目录名不能含 `:`，因此磁盘上写作 `onebot11_123456789`；`memory/` 下旧版裸数字目录会在启动时**一次性自动迁移**（目标已存在则跳过，幂等）
 - 非启用会话不发请求、不入缓冲：插件只会为启用的会话解析成员信息与图片
 
 ### 功能 × 适配器支持表（2026-09-25 实测）
@@ -590,6 +590,10 @@ LLM 可以：
 
 存储在 `<插件数据目录>/memory/<群号>/culture.json`，记录梗、网络用语、流行语。LLM 主动学习和存储，根据聊天内容自动匹配。
 
+### 最近聊天记录
+
+上面四层记忆之外的**滚动窗口**：最近 50 条消息（含机器人自己的回复与插件响应）会落盘在 `<插件数据目录>/memory/<群号>/recent.json`，**机器人重启后会读回**，因此刚重启的会话也能接上之前的上下文（注入 prompt 的条数由 `AIGFM_RECENT_MESSAGES` 控制，默认 20）。`/reset` 会连这份记录一起清空。
+
 ## 🖼️ 表情包功能
 
 ### 工作原理
@@ -766,6 +770,7 @@ LLM 支持以下回复类型：
       short_term.json       # 短期记忆
       long_term.json        # 长期记忆
       culture.json          # 文化记忆
+      recent.json           # 最近的聊天记录（重启后仍可读）
     friends/
       {user_id}.json        # 群友信息
   memes/

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

@@ -58,9 +58,9 @@
 >
 > 从 2.0 起插件还依赖 `nonebot-plugin-alconna` 与 `nonebot-plugin-uninfo`（跨适配器收发与会话/成员信息），用下面的方式安装时会自动装上。
 
-### 安装 beta 版本（2.0.0b2）
+### 安装 beta 版本（2.0.0b3）
 
-`2.0.0b2` 是**预发布（pre-release）版本**，因此：
+`2.0.0b3` 是**预发布（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.0b2
+pip install nonebot-plugin-aigf-master==2.0.0b3
 ```
 
 在 `pyproject.toml` 中添加：
@@ -93,8 +93,8 @@ plugins = ["nonebot-plugin-aigf-master"]
 AIGFM_LLM_API_KEY="sk-xxxxxxxxxxxx"                               # LLM API Key
 AIGFM_LLM_BASE_URL="https://api.deepseek.com"                     # LLM API 地址
 AIGFM_LLM_MODEL="deepseek-v4-flash"                               # LLM 模型名称
-AIGFM_ENABLED_GROUPS=[123456, 789012]                             # 启用的群/频道会话（可写 `适配器:会话id`，只写数字按 OneBot V11 识别）
-AIGFM_ENABLED_PRIVATE=[]                                          # 启用的私聊会话（同上写法；留空则私聊不响应）
+AIGFM_ENABLED_GROUPS=["onebot11:123456789", "console:console-chat"]  # 启用的群/频道会话（`适配器:会话id`；也可只写数字，按 OneBot V11 识别）
+AIGFM_ENABLED_PRIVATE=["onebot11:20001"]                          # 启用的私聊会话（同上写法；留空则私聊不响应）
 
 # --- 图片理解（VLM） ---
 AIGFM_IMAGE_MODE="vlm"                  # 图片模式: vlm / llm（默认 vlm）
@@ -212,7 +212,7 @@ AIGFM_PEER_CAPTURE_PLUGINS=[]          # 要捕获输出的插件名列表，为
 - 纯 @ 消息或检测到同一用户连续发送时，以及调用的插件返回图片时，等待时间会用 `AIGFM_INCOMPLETE_TIMEOUT`（默认 40 秒）**替代**默认的 30 秒（非叠加）
 - **有图片正在解析时整批推迟触发**：等到 VLM 描述填好后随**同一批**发给 LLM，不会把没有描述的空消息发出去；"图片进入解析"这一特例最长等待 `AIGFM_BATCH_TIMEOUT + AIGFM_INCOMPLETE_TIMEOUT`（默认 70 秒）后仍会放行，此时该图片以 `[图片解析中]` 进入上下文
 - 消息合并窗口内的同一用户连续消息会被合并为一条
-- 每次处理时，LLM 收到最近 **20 条**（可配置）历史聊天记录 + 四层记忆 + 预设 + 表情包列表 + 其它插件响应；本批消息只出现在「新消息」段，同一条插件响应也只注入一次（不会在历史与新消息里重复）
+- 每次处理时，LLM 收到最近 **20 条**（可配置）历史聊天记录 + 四层记忆 + 预设 + 表情包列表 + 其它插件响应；本批消息只出现在「新消息」段，同一条插件响应也只注入一次（不会在历史与新消息里重复）。历史聊天记录会落盘（`memory/<群号>/recent.json`），**机器人重启后仍能读回**
 - LLM 一次调用同时完成：回复决策 + 记忆管理 + 表情包选择 + 命令学习
 
 ## 🧩 多适配器支持
@@ -221,9 +221,9 @@ AIGFM_PEER_CAPTURE_PLUGINS=[]          # 要捕获输出的插件名列表，为
 
 ### 会话与启用清单
 
-- 会话以 **`适配器:会话id`** 为键，例如 `onebot11:617770183`（群）、`console:console-chat`（频道）、`onebot11:20001`（私聊）
+- 会话以 **`适配器:会话id`** 为键，例如 `onebot11:123456789`（群）、`console:console-chat`（频道）、`onebot11:20001`（私聊）
 - `AIGFM_ENABLED_GROUPS` 管群/频道会话、`AIGFM_ENABLED_PRIVATE` 管私聊会话；条目可写带前缀的完整键，也可以只写 id（**按 OneBot V11 识别**，旧配置无需改动）
-- 落盘目录名不能含 `:`，因此磁盘上写作 `onebot11_617770183`；`memory/` 下旧版裸数字目录会在启动时**一次性自动迁移**（目标已存在则跳过，幂等）
+- 落盘目录名不能含 `:`，因此磁盘上写作 `onebot11_123456789`；`memory/` 下旧版裸数字目录会在启动时**一次性自动迁移**（目标已存在则跳过，幂等）
 - 非启用会话不发请求、不入缓冲：插件只会为启用的会话解析成员信息与图片
 
 ### 功能 × 适配器支持表（2026-09-25 实测）
@@ -568,6 +568,10 @@ LLM 可以：
 
 存储在 `<插件数据目录>/memory/<群号>/culture.json`，记录梗、网络用语、流行语。LLM 主动学习和存储，根据聊天内容自动匹配。
 
+### 最近聊天记录
+
+上面四层记忆之外的**滚动窗口**：最近 50 条消息（含机器人自己的回复与插件响应）会落盘在 `<插件数据目录>/memory/<群号>/recent.json`，**机器人重启后会读回**，因此刚重启的会话也能接上之前的上下文（注入 prompt 的条数由 `AIGFM_RECENT_MESSAGES` 控制，默认 20）。`/reset` 会连这份记录一起清空。
+
 ## 🖼️ 表情包功能
 
 ### 工作原理
@@ -744,6 +748,7 @@ LLM 支持以下回复类型：
       short_term.json       # 短期记忆
       long_term.json        # 长期记忆
       culture.json          # 文化记忆
+      recent.json           # 最近的聊天记录（重启后仍可读）
     friends/
       {user_id}.json        # 群友信息
   memes/

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

@@ -507,6 +507,8 @@ async def _(bot: Bot, event: Event):
     processor.bot_name = "小助手"
     processor.bot_role = "一个友好的群聊助手"
     processor.recent_messages.clear()
+    # 落盘的聊天记录一起清，否则重置后重启又会把旧历史读回来
+    await processor.memory.clear_recent()
     # 插件响应另有一份存在 ContextBus 里，不清会跨 reset 残留进后续 prompt
     processor.context_bus.clear(session.key)
     # 图片缓存索引随聊天记录一起清（历史 id 已不在 prompt 中，留着也无可收藏的上下文）

{nonebot_plugin_aigf_master-2.0.0b2 → nonebot_plugin_aigf_master-2.0.0b3}/nonebot_plugin_aigf_master/memory_store.py

@@ -10,7 +10,7 @@ from pathlib import Path
 import anyio
 from nonebot import logger
 
-from .models import MemoryOps
+from .models import ChatMessage, MemoryOps
 
 
 class MemoryStore:
@@ -59,6 +59,53 @@ class MemoryStore:
         async with await anyio.open_file(path, "w", encoding="utf-8") as f:
             await f.write(json.dumps({"facts": facts}, ensure_ascii=False, indent=2))
 
+    # ========== 最近的聊天记录（重启后仍可读） ==========
+
+    async def load_recent(self) -> list[ChatMessage]:
+        """读回落盘的聊天记录；文件缺失/损坏时返回空列表"""
+        path = self._group_dir / "recent.json"
+        if not path.exists():
+            return []
+        try:
+            async with await anyio.open_file(path, encoding="utf-8") as f:
+                raw = json.loads(await f.read()).get("messages", [])
+        except Exception as e:
+            logger.error(f"加载聊天记录失败: {e}")
+            return []
+        messages = []
+        for item in raw if isinstance(raw, list) else []:
+            try:
+                messages.append(ChatMessage(
+                    time=datetime.fromisoformat(item["time"]),
+                    user_name=item.get("user_name", ""),
+                    content=item.get("content", ""),
+                    user_id=str(item.get("user_id", "")),
+                    is_at_only=bool(item.get("is_at_only", False)),
+                ))
+            except Exception:
+                continue          # 单条坏数据丢弃，不影响其余记录
+        return messages
+
+    async def save_recent(self, messages: list[ChatMessage]):
+        path = self._group_dir / "recent.json"
+        data = {"messages": [
+            {
+                "time": m.time.isoformat(), "user_name": m.user_name, "content": m.content,
+                "user_id": m.user_id, "is_at_only": m.is_at_only,
+            }
+            for m in messages
+        ]}
+        async with await anyio.open_file(path, "w", encoding="utf-8") as f:
+            await f.write(json.dumps(data, ensure_ascii=False, indent=2))
+
+    async def clear_recent(self):
+        path = self._group_dir / "recent.json"
+        try:
+            if path.exists():
+                path.unlink()
+        except Exception as e:
+            logger.error(f"清除聊天记录失败: {e}")
+
     # ========== 群友信息 ==========
 
     async def load_friend(self, user_id: str) -> dict | None:

{nonebot_plugin_aigf_master-2.0.0b2 → nonebot_plugin_aigf_master-2.0.0b3}/nonebot_plugin_aigf_master/processor.py

@@ -146,6 +146,9 @@ def _parts_key(parts: list[dict] | None) -> str:
 # 调用台账注入 prompt 时最多展示的条数（比对的台账条数由 aigfm_invoke_dedup_records 控制）
 _LEDGER_DISPLAY = 10
 
+# 「最近的聊天记录」在内存与落盘文件中保留的条数上限（注入 prompt 的条数另由 aigfm_recent_messages 控制）
+_RECENT_KEEP = 50
+
 
 class MessageProcessor:
     """消息处理编排器，协调所有组件"""
@@ -186,6 +189,8 @@ class MessageProcessor:
         self.bot_role = "一个友好的群聊助手"
         self.current_preset = ""
         self.recent_messages: list[ChatMessage] = []
+        # 「最近的聊天记录」在首次处理时从 memory/{会话}/recent.json 读回（重启后不丢历史）
+        self._recent_loaded = False
         # 代为执行过的命令台账：既注入 prompt 让模型「看得见自己刚调过什么」，
         # 也作为「最近调用过相同命令」去重的比对依据（见 _find_recent_same）
         self._invoke_log: list[_Invocation] = []
@@ -325,10 +330,22 @@ class MessageProcessor:
         for msg in messages:
             logger.debug(f"[处理] 消息: [{msg.user_name}] {msg.content[:80]}")
 
-        # 更新最近消息
+        # 更新最近消息（首次处理时先读回上次落盘的记录，这样重启后 LLM 仍能看到历史）
+        if not self._recent_loaded:
+            self._recent_loaded = True
+            try:
+                restored = await self.memory.load_recent()
+            except Exception as e:
+                logger.error(f"[记忆] 加载聊天记录失败: {e}")
+                restored = []
+            if restored:
+                self.recent_messages = restored + self.recent_messages
+                logger.info(f"[记忆] {self.session_key} 恢复聊天记录 {len(restored)} 条")
         self.recent_messages.extend(messages)
-        if len(self.recent_messages) > 50:
-            self.recent_messages = self.recent_messages[-50:]
+        if len(self.recent_messages) > _RECENT_KEEP:
+            self.recent_messages = self.recent_messages[-_RECENT_KEEP:]
+        # 先落盘一次：后面任何提前 return（没回复/解析失败）都不影响历史的保存
+        await self._persist_recent()
 
         # 加载记忆
         short_term = await self.memory.load_short_term()
@@ -512,6 +529,7 @@ class MessageProcessor:
 
         # 更新最近消息
         self._record_bot_reply(reply_segments)
+        await self._persist_recent()
 
         # 消耗社交能量
         text_length = sum(len(s.content) for s in reply_segments if s.type == "text")
@@ -783,6 +801,19 @@ class MessageProcessor:
                 # 索引常驻后 LLM 会引用历史 id，被上限淘汰或不存在时在此暴露，避免静默失败无从排查
                 logger.warning(f"[表情包收藏] 跳过: id={cache_id} 不在缓存索引中（已淘汰或不存在）")
 
+    async def _persist_recent(self):
+        """把「最近的聊天记录」落盘，让重启后的会话仍带着上下文（条数与内存里一致）
+
+        落盘前后都按 `_RECENT_KEEP` 截断：批次内还会追加机器人的回复/自述等，
+        不在这里截一次的话内存与文件都会慢慢超过上限。
+        """
+        if len(self.recent_messages) > _RECENT_KEEP:
+            self.recent_messages = self.recent_messages[-_RECENT_KEEP:]
+        try:
+            await self.memory.save_recent(self.recent_messages)
+        except Exception as e:
+            logger.error(f"[记忆] 保存聊天记录失败: {e}")
+
     def _record_bot_reply(self, segments: list[ReplySegment]):
         for seg in segments:
             if seg.type == "text":

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nonebot-plugin-aigf-master
-Version: 2.0.0b2
+Version: 2.0.0b3
 Summary: 群聊特化LLM聊天机器人（增强版），具有记忆、表情包、跨插件调用、跨bot通信与跨适配器支持
 License-Expression: MIT
 Requires-Python: <4.0,>=3.10
@@ -80,9 +80,9 @@ Dynamic: license-file
 >
 > 从 2.0 起插件还依赖 `nonebot-plugin-alconna` 与 `nonebot-plugin-uninfo`（跨适配器收发与会话/成员信息），用下面的方式安装时会自动装上。
 
-### 安装 beta 版本（2.0.0b2）
+### 安装 beta 版本（2.0.0b3）
 
-`2.0.0b2` 是**预发布（pre-release）版本**，因此：
+`2.0.0b3` 是**预发布（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.0b2
+pip install nonebot-plugin-aigf-master==2.0.0b3
 ```
 
 在 `pyproject.toml` 中添加：
@@ -115,8 +115,8 @@ plugins = ["nonebot-plugin-aigf-master"]
 AIGFM_LLM_API_KEY="sk-xxxxxxxxxxxx"                               # LLM API Key
 AIGFM_LLM_BASE_URL="https://api.deepseek.com"                     # LLM API 地址
 AIGFM_LLM_MODEL="deepseek-v4-flash"                               # LLM 模型名称
-AIGFM_ENABLED_GROUPS=[123456, 789012]                             # 启用的群/频道会话（可写 `适配器:会话id`，只写数字按 OneBot V11 识别）
-AIGFM_ENABLED_PRIVATE=[]                                          # 启用的私聊会话（同上写法；留空则私聊不响应）
+AIGFM_ENABLED_GROUPS=["onebot11:123456789", "console:console-chat"]  # 启用的群/频道会话（`适配器:会话id`；也可只写数字，按 OneBot V11 识别）
+AIGFM_ENABLED_PRIVATE=["onebot11:20001"]                          # 启用的私聊会话（同上写法；留空则私聊不响应）
 
 # --- 图片理解（VLM） ---
 AIGFM_IMAGE_MODE="vlm"                  # 图片模式: vlm / llm（默认 vlm）
@@ -234,7 +234,7 @@ AIGFM_PEER_CAPTURE_PLUGINS=[]          # 要捕获输出的插件名列表，为
 - 纯 @ 消息或检测到同一用户连续发送时，以及调用的插件返回图片时，等待时间会用 `AIGFM_INCOMPLETE_TIMEOUT`（默认 40 秒）**替代**默认的 30 秒（非叠加）
 - **有图片正在解析时整批推迟触发**：等到 VLM 描述填好后随**同一批**发给 LLM，不会把没有描述的空消息发出去；"图片进入解析"这一特例最长等待 `AIGFM_BATCH_TIMEOUT + AIGFM_INCOMPLETE_TIMEOUT`（默认 70 秒）后仍会放行，此时该图片以 `[图片解析中]` 进入上下文
 - 消息合并窗口内的同一用户连续消息会被合并为一条
-- 每次处理时，LLM 收到最近 **20 条**（可配置）历史聊天记录 + 四层记忆 + 预设 + 表情包列表 + 其它插件响应；本批消息只出现在「新消息」段，同一条插件响应也只注入一次（不会在历史与新消息里重复）
+- 每次处理时，LLM 收到最近 **20 条**（可配置）历史聊天记录 + 四层记忆 + 预设 + 表情包列表 + 其它插件响应；本批消息只出现在「新消息」段，同一条插件响应也只注入一次（不会在历史与新消息里重复）。历史聊天记录会落盘（`memory/<群号>/recent.json`），**机器人重启后仍能读回**
 - LLM 一次调用同时完成：回复决策 + 记忆管理 + 表情包选择 + 命令学习
 
 ## 🧩 多适配器支持
@@ -243,9 +243,9 @@ AIGFM_PEER_CAPTURE_PLUGINS=[]          # 要捕获输出的插件名列表，为
 
 ### 会话与启用清单
 
-- 会话以 **`适配器:会话id`** 为键，例如 `onebot11:617770183`（群）、`console:console-chat`（频道）、`onebot11:20001`（私聊）
+- 会话以 **`适配器:会话id`** 为键，例如 `onebot11:123456789`（群）、`console:console-chat`（频道）、`onebot11:20001`（私聊）
 - `AIGFM_ENABLED_GROUPS` 管群/频道会话、`AIGFM_ENABLED_PRIVATE` 管私聊会话；条目可写带前缀的完整键，也可以只写 id（**按 OneBot V11 识别**，旧配置无需改动）
-- 落盘目录名不能含 `:`，因此磁盘上写作 `onebot11_617770183`；`memory/` 下旧版裸数字目录会在启动时**一次性自动迁移**（目标已存在则跳过，幂等）
+- 落盘目录名不能含 `:`，因此磁盘上写作 `onebot11_123456789`；`memory/` 下旧版裸数字目录会在启动时**一次性自动迁移**（目标已存在则跳过，幂等）
 - 非启用会话不发请求、不入缓冲：插件只会为启用的会话解析成员信息与图片
 
 ### 功能 × 适配器支持表（2026-09-25 实测）
@@ -590,6 +590,10 @@ LLM 可以：
 
 存储在 `<插件数据目录>/memory/<群号>/culture.json`，记录梗、网络用语、流行语。LLM 主动学习和存储，根据聊天内容自动匹配。
 
+### 最近聊天记录
+
+上面四层记忆之外的**滚动窗口**：最近 50 条消息（含机器人自己的回复与插件响应）会落盘在 `<插件数据目录>/memory/<群号>/recent.json`，**机器人重启后会读回**，因此刚重启的会话也能接上之前的上下文（注入 prompt 的条数由 `AIGFM_RECENT_MESSAGES` 控制，默认 20）。`/reset` 会连这份记录一起清空。
+
 ## 🖼️ 表情包功能
 
 ### 工作原理
@@ -766,6 +770,7 @@ LLM 支持以下回复类型：
       short_term.json       # 短期记忆
       long_term.json        # 长期记忆
       culture.json          # 文化记忆
+      recent.json           # 最近的聊天记录（重启后仍可读）
     friends/
       {user_id}.json        # 群友信息
   memes/

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

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