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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nonebot-plugin-aigf-master
-Version: 2.0.0b2
+Version: 2.0.0b4
 Summary: 群聊特化LLM聊天机器人（增强版），具有记忆、表情包、跨插件调用、跨bot通信与跨适配器支持
 License-Expression: MIT
 Requires-Python: <4.0,>=3.10
@@ -55,7 +55,7 @@ Dynamic: license-file
 - 🧠 **LLM 命令学习**：通过观察群聊自动学习命令用法，支持学习、编辑、删除
 - 🌐 **跨 bot 通信**：通过 HTTP 获取其它 bot（同一 QQ 号下）的插件输出，并可远程调用其命令
 - 🖼️ **表情包功能**：AI 自主决定发表情包；自动从群聊中收藏
-- 🔍 **联网搜索**：支持 Tavily / Bocha / Bing，自动搜索不懂的梗和网络用语
+- 🔍 **联网搜索**：支持 Tavily / Bocha / Bing / DeepSeek / 本地 open-websearch，自动搜索不懂的梗和网络用语
 - 🧠 **四层记忆系统**：短期记忆、长期记忆、群友信息、文化记忆，LLM 自主管理
 - 🎨 **AI 生图**：LLM可调用生图模型生成图片发到群里，尺寸由 LLM 决定（程序限最大尺寸），支持参考图改绘（回复图片消息或从聊天记录选图）
 
@@ -80,9 +80,9 @@ Dynamic: license-file
 >
 > 从 2.0 起插件还依赖 `nonebot-plugin-alconna` 与 `nonebot-plugin-uninfo`（跨适配器收发与会话/成员信息），用下面的方式安装时会自动装上。
 
-### 安装 beta 版本（2.0.0b2）
+### 安装 beta 版本（2.0.0b4）
 
-`2.0.0b2` 是**预发布（pre-release）版本**，因此：
+`2.0.0b4` 是**预发布（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.0b4
 ```
 
 在 `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）
@@ -158,10 +158,11 @@ AIGFM_ENERGY_BASELINE=0.7               # 社交能量基线（默认 0.7，范
 
 # --- 联网搜索 ---
 AIGFM_SEARCH_ENABLED=false              # 是否启用联网搜索（默认 false）
-AIGFM_SEARCH_API=tavily                 # 搜索API: tavily / bocha / bing / openwebsearch（默认 tavily）
-AIGFM_SEARCH_API_KEY="xxx"              # 搜索 API Key（api=tavily/bocha/bing 时必填）
+AIGFM_SEARCH_API=tavily                 # 搜索API: tavily / bocha / bing / openwebsearch / deepseek（默认 tavily）
+AIGFM_SEARCH_API_KEY="xxx"              # 搜索 API Key（api=tavily/bocha/bing 时必填；deepseek 留空则沿用 LLM Key）
 AIGFM_SEARCH_MAX_RESULTS=3              # 最大搜索结果数（默认 3）
 AIGFM_OPENWEBSEARCH_URL=""              # open-websearch 本地服务地址（api=openwebsearch 时必填，如 http://127.0.0.1:3210）
+AIGFM_SEARCH_BASE_URL=""                # 搜索 API 根地址（api=deepseek 时用，留空则用官方 https://api.deepseek.com）
 
 # --- 代理 ---
 AIGFM_PROXY_ENABLED=false                  # 是否启用代理（默认 false）
@@ -234,7 +235,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 +244,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 实测）
@@ -274,7 +275,11 @@ AIGFM_PEER_CAPTURE_PLUGINS=[]          # 要捕获输出的插件名列表，为
 | YunHu | ✅ | ✅ | ✅ | 未测 | ⚠️ | ✅ | ✅ | ✅ | ✅ |
 | bilibili Live | ✅ | ✅ | ✅ | ❌ 无好友私聊类型 | ⚠️ | ✅ | ✅ | ⚠️ | ✅ |
 
-图例：**✅ 已实测通过** ｜ **⚠️ 已实现但未验证通过**（离线构造不出该适配器的事件，或需要真实 API / 真机）｜ **❌ 该适配器没有这类事件，或库层无法把该通知定位到群/频道会话（通知会被跳过）** ｜ **未测** 本次未构造该场景。
+**图例：**
+- **✅ 已实测通过** 
+- **⚠️ 已实现但未验证通过**（离线构造不出该适配器的事件，或需要真实 API / 真机）
+- **❌ 该适配器没有这类事件，或库层无法把该通知定位到群/频道会话（通知会被跳过）** 
+- **未测** 本次未构造该场景。
 
 **已知特例**
 
@@ -559,6 +564,7 @@ LLM 可以：
 | `bocha` | 国产 AI 搜索 API，中文搜索效果好 | 无 | https://open.bochaai.com |
 | `bing` | 微软必应搜索（Azure Bing Search API v7） | 无 | https://portal.azure.com |
 | `openwebsearch` | 本地 Node.js 搜索服务，聚合多引擎（bing/baidu/duckduckgo 等） | 需先启动 daemon：`cd open-webSearch && npm install && npm run serve`，配置 `AIGFM_OPENWEBSEARCH_URL` | 无需 Key，项目：https://github.com/Aas-ee/open-webSearch |
+| `deepseek` | DeepSeek 自带联网搜索，摘要写得很适合喂给模型 | 无（`AIGFM_SEARCH_API_KEY` 留空则沿用 LLM Key） | https://platform.deepseek.com |
 
 > **Tavily** 需额外安装依赖：`pip install tavily-python`（或安装本插件时带上 extra：`pip install "nonebot-plugin-aigf-master[tavily]"`）
 
@@ -590,6 +596,10 @@ LLM 可以：
 
 存储在 `<插件数据目录>/memory/<群号>/culture.json`，记录梗、网络用语、流行语。LLM 主动学习和存储，根据聊天内容自动匹配。
 
+### 最近聊天记录
+
+上面四层记忆之外的**滚动窗口**：最近 50 条消息（含机器人自己的回复与插件响应）会落盘在 `<插件数据目录>/memory/<群号>/recent.json`，**机器人重启后会读回**，因此刚重启的会话也能接上之前的上下文（注入 prompt 的条数由 `AIGFM_RECENT_MESSAGES` 控制，默认 20）。`/reset` 会连这份记录一起清空。
+
 ## 🖼️ 表情包功能
 
 ### 工作原理
@@ -766,6 +776,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.0b4}/README.md

@@ -33,7 +33,7 @@
 - 🧠 **LLM 命令学习**：通过观察群聊自动学习命令用法，支持学习、编辑、删除
 - 🌐 **跨 bot 通信**：通过 HTTP 获取其它 bot（同一 QQ 号下）的插件输出，并可远程调用其命令
 - 🖼️ **表情包功能**：AI 自主决定发表情包；自动从群聊中收藏
-- 🔍 **联网搜索**：支持 Tavily / Bocha / Bing，自动搜索不懂的梗和网络用语
+- 🔍 **联网搜索**：支持 Tavily / Bocha / Bing / DeepSeek / 本地 open-websearch，自动搜索不懂的梗和网络用语
 - 🧠 **四层记忆系统**：短期记忆、长期记忆、群友信息、文化记忆，LLM 自主管理
 - 🎨 **AI 生图**：LLM可调用生图模型生成图片发到群里，尺寸由 LLM 决定（程序限最大尺寸），支持参考图改绘（回复图片消息或从聊天记录选图）
 
@@ -58,9 +58,9 @@
 >
 > 从 2.0 起插件还依赖 `nonebot-plugin-alconna` 与 `nonebot-plugin-uninfo`（跨适配器收发与会话/成员信息），用下面的方式安装时会自动装上。
 
-### 安装 beta 版本（2.0.0b2）
+### 安装 beta 版本（2.0.0b4）
 
-`2.0.0b2` 是**预发布（pre-release）版本**，因此：
+`2.0.0b4` 是**预发布（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.0b4
 ```
 
 在 `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）
@@ -136,10 +136,11 @@ AIGFM_ENERGY_BASELINE=0.7               # 社交能量基线（默认 0.7，范
 
 # --- 联网搜索 ---
 AIGFM_SEARCH_ENABLED=false              # 是否启用联网搜索（默认 false）
-AIGFM_SEARCH_API=tavily                 # 搜索API: tavily / bocha / bing / openwebsearch（默认 tavily）
-AIGFM_SEARCH_API_KEY="xxx"              # 搜索 API Key（api=tavily/bocha/bing 时必填）
+AIGFM_SEARCH_API=tavily                 # 搜索API: tavily / bocha / bing / openwebsearch / deepseek（默认 tavily）
+AIGFM_SEARCH_API_KEY="xxx"              # 搜索 API Key（api=tavily/bocha/bing 时必填；deepseek 留空则沿用 LLM Key）
 AIGFM_SEARCH_MAX_RESULTS=3              # 最大搜索结果数（默认 3）
 AIGFM_OPENWEBSEARCH_URL=""              # open-websearch 本地服务地址（api=openwebsearch 时必填，如 http://127.0.0.1:3210）
+AIGFM_SEARCH_BASE_URL=""                # 搜索 API 根地址（api=deepseek 时用，留空则用官方 https://api.deepseek.com）
 
 # --- 代理 ---
 AIGFM_PROXY_ENABLED=false                  # 是否启用代理（默认 false）
@@ -212,7 +213,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 +222,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 实测）
@@ -252,7 +253,11 @@ AIGFM_PEER_CAPTURE_PLUGINS=[]          # 要捕获输出的插件名列表，为
 | YunHu | ✅ | ✅ | ✅ | 未测 | ⚠️ | ✅ | ✅ | ✅ | ✅ |
 | bilibili Live | ✅ | ✅ | ✅ | ❌ 无好友私聊类型 | ⚠️ | ✅ | ✅ | ⚠️ | ✅ |
 
-图例：**✅ 已实测通过** ｜ **⚠️ 已实现但未验证通过**（离线构造不出该适配器的事件，或需要真实 API / 真机）｜ **❌ 该适配器没有这类事件，或库层无法把该通知定位到群/频道会话（通知会被跳过）** ｜ **未测** 本次未构造该场景。
+**图例：**
+- **✅ 已实测通过** 
+- **⚠️ 已实现但未验证通过**（离线构造不出该适配器的事件，或需要真实 API / 真机）
+- **❌ 该适配器没有这类事件，或库层无法把该通知定位到群/频道会话（通知会被跳过）** 
+- **未测** 本次未构造该场景。
 
 **已知特例**
 
@@ -537,6 +542,7 @@ LLM 可以：
 | `bocha` | 国产 AI 搜索 API，中文搜索效果好 | 无 | https://open.bochaai.com |
 | `bing` | 微软必应搜索（Azure Bing Search API v7） | 无 | https://portal.azure.com |
 | `openwebsearch` | 本地 Node.js 搜索服务，聚合多引擎（bing/baidu/duckduckgo 等） | 需先启动 daemon：`cd open-webSearch && npm install && npm run serve`，配置 `AIGFM_OPENWEBSEARCH_URL` | 无需 Key，项目：https://github.com/Aas-ee/open-webSearch |
+| `deepseek` | DeepSeek 自带联网搜索，摘要写得很适合喂给模型 | 无（`AIGFM_SEARCH_API_KEY` 留空则沿用 LLM Key） | https://platform.deepseek.com |
 
 > **Tavily** 需额外安装依赖：`pip install tavily-python`（或安装本插件时带上 extra：`pip install "nonebot-plugin-aigf-master[tavily]"`）
 
@@ -568,6 +574,10 @@ LLM 可以：
 
 存储在 `<插件数据目录>/memory/<群号>/culture.json`，记录梗、网络用语、流行语。LLM 主动学习和存储，根据聊天内容自动匹配。
 
+### 最近聊天记录
+
+上面四层记忆之外的**滚动窗口**：最近 50 条消息（含机器人自己的回复与插件响应）会落盘在 `<插件数据目录>/memory/<群号>/recent.json`，**机器人重启后会读回**，因此刚重启的会话也能接上之前的上下文（注入 prompt 的条数由 `AIGFM_RECENT_MESSAGES` 控制，默认 20）。`/reset` 会连这份记录一起清空。
+
 ## 🖼️ 表情包功能
 
 ### 工作原理
@@ -744,6 +754,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.0b4}/nonebot_plugin_aigf_master/__init__.py

@@ -89,8 +89,12 @@ _image_gen = ImageGenClient(
     _proxy,
 ) if plugin_config.aigfm_image_gen_enabled else None
 _search = create_search_client(
-    plugin_config.aigfm_search_api, plugin_config.aigfm_search_api_key,
+    plugin_config.aigfm_search_api,
+    # deepseek 的 Key 一般和 LLM 是同一个，没单独配就沿用 LLM Key
+    plugin_config.aigfm_search_api_key
+    or (plugin_config.aigfm_llm_api_key if plugin_config.aigfm_search_api == "deepseek" else ""),
     plugin_config.aigfm_openwebsearch_url,
+    plugin_config.aigfm_search_base_url,
 ) if plugin_config.aigfm_search_enabled else None
 _peer_client = PeerClient(plugin_config.aigfm_peer_bots) if plugin_config.aigfm_peer_bots else None
 
@@ -507,6 +511,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.0b4}/nonebot_plugin_aigf_master/config.py

@@ -71,10 +71,11 @@ class PluginConfig(BaseModel):
 
     # 搜索
     aigfm_search_enabled: bool = Field(False, description="是否启用联网搜索")
-    aigfm_search_api: Literal["tavily", "bocha", "bing", "openwebsearch"] = Field("tavily", description="搜索 API")
-    aigfm_search_api_key: str = Field("", description="搜索 API Key（tavily/bocha/bing 必填）")
+    aigfm_search_api: Literal["tavily", "bocha", "bing", "openwebsearch", "deepseek"] = Field("tavily", description="搜索 API")
+    aigfm_search_api_key: str = Field("", description="搜索 API Key（tavily/bocha/bing 必填；deepseek 留空则用 LLM Key）")
     aigfm_search_max_results: int = Field(3, description="最大搜索结果数")
     aigfm_openwebsearch_url: str = Field("", description="open-websearch 本地服务地址（如 http://127.0.0.1:3210）")
+    aigfm_search_base_url: str = Field("", description="搜索 API 根地址（deepseek 用，留空则用官方 https://api.deepseek.com）")
 
     # 代理
     aigfm_proxy_enabled: bool = Field(False, description="是否启用代理")

{nonebot_plugin_aigf_master-2.0.0b2 → nonebot_plugin_aigf_master-2.0.0b4}/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.0b4}/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.0b4}/nonebot_plugin_aigf_master/search_client.py

@@ -112,7 +112,62 @@ class OpenWebSearchClient(SearchClient):
             return []
 
 
-def create_search_client(api: str, api_key: str, base_url: str = "") -> SearchClient | None:
+class DeepSeekSearchClient(SearchClient):
+    """DeepSeek 联网搜索（POST {base}/v1/tools/search）
+
+    文档：https://api-docs.deepseek.com/zh-cn/api/search
+    - 按**成功请求次数**计费（不按 token、不按条数），`results` 为空数组不算成功、不计费
+    - `summary` 是给模型看的长摘要，`snippet` 是短摘要；`content` 只有传 `need_content`
+      才会带网页正文（默认不带，省掉额外抓取）
+    - QPS 100；401 = Key 无效，402 = 余额不足
+    """
+
+    def __init__(self, api_key: str, base_url: str = ""):
+        self._api_key = api_key
+        self._base_url = (base_url or "https://api.deepseek.com").rstrip("/")
+
+    async def search(self, query: str, max_results: int = 3) -> list[dict]:
+        try:
+            headers = {"Authorization": f"Bearer {self._api_key}", "Content-Type": "application/json"}
+            # count 取值范围 1-50，越界会被判 400
+            payload = {"query": query, "count": max(1, min(int(max_results or 1), 50))}
+            async with httpx.AsyncClient(timeout=15.0) as client:
+                resp = await client.post(f"{self._base_url}/v1/tools/search", headers=headers, json=payload)
+                if resp.status_code != 200:
+                    self._log_failure(resp)
+                    return []
+                data = resp.json()
+            results = []
+            for r in data.get("results", []):
+                content = (r.get("summary") or r.get("snippet") or "").strip()
+                results.append({"title": r.get("title", ""), "content": content, "url": r.get("url", "")})
+            return results
+        except Exception as e:
+            logger.error(f"[搜索] DeepSeek 失败: {e}")
+            return []
+
+    def _log_failure(self, resp):
+        """DeepSeek 的错误体是 OpenAI 兼容格式，挑出人能看懂的说明"""
+        try:
+            err = (resp.json() or {}).get("error", {}) or {}
+            msg = err.get("message") or ""
+        except Exception:
+            msg = ""
+        hint = {
+            400: "请求参数不合法",
+            401: "API Key 无效",
+            402: "余额不足",
+            429: "触发 QPS 限制",
+            500: "服务端错误",
+            504: "下游超时",
+        }.get(resp.status_code, "")
+        logger.error(f"[搜索] DeepSeek 失败: HTTP {resp.status_code}"
+                     + (f"（{hint}）" if hint else "")
+                     + (f" {msg}" if msg else ""))
+
+
+def create_search_client(api: str, api_key: str, base_url: str = "",
+                         api_base_url: str = "") -> SearchClient | None:
     api = api.lower()
     if api == "tavily":
         return TavilySearchClient(api_key) if api_key else None
@@ -122,4 +177,6 @@ def create_search_client(api: str, api_key: str, base_url: str = "") -> SearchCl
         return BingSearchClient(api_key) if api_key else None
     elif api == "openwebsearch":
         return OpenWebSearchClient(base_url) if base_url else None
+    elif api == "deepseek":
+        return DeepSeekSearchClient(api_key, api_base_url) if api_key else None
     return None

{nonebot_plugin_aigf_master-2.0.0b2 → nonebot_plugin_aigf_master-2.0.0b4}/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.0b4
 Summary: 群聊特化LLM聊天机器人（增强版），具有记忆、表情包、跨插件调用、跨bot通信与跨适配器支持
 License-Expression: MIT
 Requires-Python: <4.0,>=3.10
@@ -55,7 +55,7 @@ Dynamic: license-file
 - 🧠 **LLM 命令学习**：通过观察群聊自动学习命令用法，支持学习、编辑、删除
 - 🌐 **跨 bot 通信**：通过 HTTP 获取其它 bot（同一 QQ 号下）的插件输出，并可远程调用其命令
 - 🖼️ **表情包功能**：AI 自主决定发表情包；自动从群聊中收藏
-- 🔍 **联网搜索**：支持 Tavily / Bocha / Bing，自动搜索不懂的梗和网络用语
+- 🔍 **联网搜索**：支持 Tavily / Bocha / Bing / DeepSeek / 本地 open-websearch，自动搜索不懂的梗和网络用语
 - 🧠 **四层记忆系统**：短期记忆、长期记忆、群友信息、文化记忆，LLM 自主管理
 - 🎨 **AI 生图**：LLM可调用生图模型生成图片发到群里，尺寸由 LLM 决定（程序限最大尺寸），支持参考图改绘（回复图片消息或从聊天记录选图）
 
@@ -80,9 +80,9 @@ Dynamic: license-file
 >
 > 从 2.0 起插件还依赖 `nonebot-plugin-alconna` 与 `nonebot-plugin-uninfo`（跨适配器收发与会话/成员信息），用下面的方式安装时会自动装上。
 
-### 安装 beta 版本（2.0.0b2）
+### 安装 beta 版本（2.0.0b4）
 
-`2.0.0b2` 是**预发布（pre-release）版本**，因此：
+`2.0.0b4` 是**预发布（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.0b4
 ```
 
 在 `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）
@@ -158,10 +158,11 @@ AIGFM_ENERGY_BASELINE=0.7               # 社交能量基线（默认 0.7，范
 
 # --- 联网搜索 ---
 AIGFM_SEARCH_ENABLED=false              # 是否启用联网搜索（默认 false）
-AIGFM_SEARCH_API=tavily                 # 搜索API: tavily / bocha / bing / openwebsearch（默认 tavily）
-AIGFM_SEARCH_API_KEY="xxx"              # 搜索 API Key（api=tavily/bocha/bing 时必填）
+AIGFM_SEARCH_API=tavily                 # 搜索API: tavily / bocha / bing / openwebsearch / deepseek（默认 tavily）
+AIGFM_SEARCH_API_KEY="xxx"              # 搜索 API Key（api=tavily/bocha/bing 时必填；deepseek 留空则沿用 LLM Key）
 AIGFM_SEARCH_MAX_RESULTS=3              # 最大搜索结果数（默认 3）
 AIGFM_OPENWEBSEARCH_URL=""              # open-websearch 本地服务地址（api=openwebsearch 时必填，如 http://127.0.0.1:3210）
+AIGFM_SEARCH_BASE_URL=""                # 搜索 API 根地址（api=deepseek 时用，留空则用官方 https://api.deepseek.com）
 
 # --- 代理 ---
 AIGFM_PROXY_ENABLED=false                  # 是否启用代理（默认 false）
@@ -234,7 +235,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 +244,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 实测）
@@ -274,7 +275,11 @@ AIGFM_PEER_CAPTURE_PLUGINS=[]          # 要捕获输出的插件名列表，为
 | YunHu | ✅ | ✅ | ✅ | 未测 | ⚠️ | ✅ | ✅ | ✅ | ✅ |
 | bilibili Live | ✅ | ✅ | ✅ | ❌ 无好友私聊类型 | ⚠️ | ✅ | ✅ | ⚠️ | ✅ |
 
-图例：**✅ 已实测通过** ｜ **⚠️ 已实现但未验证通过**（离线构造不出该适配器的事件，或需要真实 API / 真机）｜ **❌ 该适配器没有这类事件，或库层无法把该通知定位到群/频道会话（通知会被跳过）** ｜ **未测** 本次未构造该场景。
+**图例：**
+- **✅ 已实测通过** 
+- **⚠️ 已实现但未验证通过**（离线构造不出该适配器的事件，或需要真实 API / 真机）
+- **❌ 该适配器没有这类事件，或库层无法把该通知定位到群/频道会话（通知会被跳过）** 
+- **未测** 本次未构造该场景。
 
 **已知特例**
 
@@ -559,6 +564,7 @@ LLM 可以：
 | `bocha` | 国产 AI 搜索 API，中文搜索效果好 | 无 | https://open.bochaai.com |
 | `bing` | 微软必应搜索（Azure Bing Search API v7） | 无 | https://portal.azure.com |
 | `openwebsearch` | 本地 Node.js 搜索服务，聚合多引擎（bing/baidu/duckduckgo 等） | 需先启动 daemon：`cd open-webSearch && npm install && npm run serve`，配置 `AIGFM_OPENWEBSEARCH_URL` | 无需 Key，项目：https://github.com/Aas-ee/open-webSearch |
+| `deepseek` | DeepSeek 自带联网搜索，摘要写得很适合喂给模型 | 无（`AIGFM_SEARCH_API_KEY` 留空则沿用 LLM Key） | https://platform.deepseek.com |
 
 > **Tavily** 需额外安装依赖：`pip install tavily-python`（或安装本插件时带上 extra：`pip install "nonebot-plugin-aigf-master[tavily]"`）
 
@@ -590,6 +596,10 @@ LLM 可以：
 
 存储在 `<插件数据目录>/memory/<群号>/culture.json`，记录梗、网络用语、流行语。LLM 主动学习和存储，根据聊天内容自动匹配。
 
+### 最近聊天记录
+
+上面四层记忆之外的**滚动窗口**：最近 50 条消息（含机器人自己的回复与插件响应）会落盘在 `<插件数据目录>/memory/<群号>/recent.json`，**机器人重启后会读回**，因此刚重启的会话也能接上之前的上下文（注入 prompt 的条数由 `AIGFM_RECENT_MESSAGES` 控制，默认 20）。`/reset` 会连这份记录一起清空。
+
 ## 🖼️ 表情包功能
 
 ### 工作原理
@@ -766,6 +776,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.0b4}/pyproject.toml

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