nonebot-plugin-aigf 0.2.0__tar.gz → 0.3.0__tar.gz

{nonebot-plugin-aigf-0.2.0/nonebot_plugin_aigf.egg-info → nonebot-plugin-aigf-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: nonebot-plugin-aigf
-Version: 0.2.0
+Version: 0.3.0
 Summary: 基于nonebot-plugin-nyaturingtest重构的群聊特化 LLM 聊天机器人，具有 LLM 驱动的记忆系统和表情包功能。
 Home-page: https://github.com/Funny1Potato/nonebot-plugin-aigf
 Author: Funny1Potato
@@ -15,7 +15,7 @@ Description-Content-Type: text/markdown
     <a href="https://v2.nonebot.dev/store">
     <img src="https://raw.githubusercontent.com/fllesser/nonebot-plugin-template/refs/heads/resource/.docs/NoneBotPlugin.svg" width="310" alt="logo"></a>
 
-## ✨ nonebot-plugin-aigf ✨
+## ✨ AI-group-friend ✨
 
 群聊特化 LLM 聊天机器人，具有 LLM 驱动的记忆系统和表情包功能。
 
@@ -30,14 +30,16 @@ Description-Content-Type: text/markdown
 ## 📖 介绍
 
 > 基于 [shadow3aaa/nonebot-plugin-nyaturingtest](https://github.com/shadow3aaa/nonebot-plugin-nyaturingtest) 重构，移除了 HippoRAG 和情绪系统，改为 LLM 自主管理记忆，并添加表情包存储和发送功能。
+* 本项目对原项目代码的修改及重构均有AI高度参与，若有做得不够好的地方，请手下留情。
 
 ### 特点:
 
 - 🧠 **LLM 驱动的记忆系统**：短期记忆、长期记忆、群友信息，LLM 自主增删改
 - 🖼️ **表情包功能**：AI 自主决定发表情包；自动从群聊中收藏表情包（缓存机制）
-- 🔍 **图片理解**：通过 VLM 或多模态大模型理解群友发的图片和表情包
+- 🔍 **图片理解**：支持 VLM 模式和 LLM 直接看图模式
+- 💬 **对话理解**：通过 reply 标记和 @ 理解群聊中的对话关系，自主决定是否发言
 - 📝 **预设系统**：支持角色预设，含可编辑的默认预设
-- ⚡ **轻量高效**：单次 LLM 调用完成对话 + 记忆管理，减少token消耗
+- ⚡ **轻量高效**：单次 LLM 调用完成对话 + 记忆管理，节约token
 
 ## 💿 安装
 
@@ -77,22 +79,21 @@ plugins = ["nonebot-plugin-aigf"]
 ```env
 # === 必填 ===
 AIGF_CHAT_OPENAI_API_KEY="***"         # LLM API Key
-AIGF_CHAT_OPENAI_BASE_URL="***"  # LLM API 地址
-AIGF_CHAT_OPENAI_MODEL="***"  # LLM 模型名称
+AIGF_CHAT_OPENAI_BASE_URL="***"        # LLM API 地址
+AIGF_CHAT_OPENAI_MODEL="***"           # LLM 模型名称
+AIGF_ENABLED_GROUPS=[123456, 789012]   # 启用的群号列表
 
 # === 可选 ===
-AIGF_ENABLED_GROUPS=[123456, 789012]   # 启用的群号列表
 AIGF_MEME_ENABLED=true                 # 是否启用表情包功能（默认 true）
 AIGF_MEME_MAX_COUNT=200                # 自动收集的表情包最大数量（默认 200）
 AIGF_DEFAULT_PRESET=default            # 默认预设名称（默认 "default"）
 
 # === VLM 配置（图片理解） ===
-# === 图片理解 ===
 AIGF_IMAGE_MODE="vlm"                             # 图片模式: vlm=独立VLM分析, llm=LLM直接看图
-AIGF_VLM_ENABLED=true                           # 是否启用VLM（仅 vlm 模式有效，默认 true）
-AIGF_VLM_MODEL="Pro/Qwen/Qwen2.5-VL-7B-Instruct" # VLM 模型名称
+AIGF_VLM_ENABLED=true                             # 是否启用VLM（仅 vlm 模式有效，默认 true）
+AIGF_VLM_MODEL="Pro/Qwen/Qwen2.5-VL-7B-Instruct"  # VLM 模型名称
 AIGF_VLM_BASE_URL="https://api.siliconflow.cn/v1" # VLM API 地址
-AIGF_VLM_API_KEY="***"                           # VLM API Key（为空时使用 chat 的 key）
+AIGF_VLM_API_KEY="***"                            # VLM API Key（为空时使用 chat 的 key）
 ```
 
 ## 命令
@@ -110,24 +111,56 @@ AIGF_VLM_API_KEY="***"                           # VLM API Key（为空时使用
 ## 触发机制
 
 - 攒够 **5 条**新消息，或最后一条消息后 **5 秒**内无新消息，触发一次处理
-- 每次处理时，LLM 收到最近 **10 条**聊天记录 + 三层记忆 + 预设 + 表情包列表
+- 每次处理时，LLM 收到最近 **15 条**聊天记录 + 三层记忆 + 预设 + 表情包列表
 - LLM 一次调用同时完成：回复决策 + 记忆管理 + 表情包选择
 
+## 对话理解
+
+机器人通过以下方式理解群聊中的对话关系：
+
+- **reply 标记**：消息中包含 `[回复 xxx 的消息: "yyy"]`，表示在回复某人
+- **@ 提及**：`@某人` 表示消息是发给那个人的
+- **时间推断**：时间接近的消息通常在互相回复
+
+**回复决策规则**：
+- 有人 @ 了机器人 → 回复
+- 有人回复了机器人之前的消息 → 回复
+- 消息明显是对所有人说的，且有值得补充的内容 → 回复
+- 不确定是否在和自己说话 → **不回复**
+
 ## 记忆系统
 
 机器人拥有三层记忆，由 LLM 在每次回复时自主管理：
 
 ### 短期记忆
 
-存储在 `<插件数据目录>/memory/short_term.json`，内容为 LLM 维护的信息列表，包括对话摘要、临时上下文、有趣的梗等。LLM 可以添加、修改、删除条目，内容可以详细一些。
+存储在 `<插件数据目录>/memory/<群号>/short_term.json`，内容为 LLM 维护的信息列表，包括对话摘要、临时上下文、有趣的梗等。LLM 可以添加、修改、删除条目。
 
 ### 长期记忆
 
-存储在 `<插件数据目录>/memory/long_term.json`，内容为 LLM 认为值得长期记住的信息，如群内发生的事件、群规、群友分享的有用知识等。
+存储在 `<插件数据目录>/memory/<群号>/long_term.json`，内容为 LLM 认为值得长期记住的信息，如群内发生的事件、群规、群友分享的有用知识等。LLM 可添加、修改、删除。不应记录临时对话或常识信息。
 
 ### 群友信息
 
-存储在 `<插件数据目录>/memory/friends/<QQ号>.json`，每个群友一个文件，以 QQ 号命名。LLM 记录群友的昵称、职业、爱好、说过的话、与其他群友的关系等。当群友修改昵称时，LLM 可通过 `update_name` 更新。
+存储在 `<插件数据目录>/memory/friends/<QQ号>.json`，每个群友一个文件，以 QQ 号命名。LLM 记录群友的昵称、职业、爱好、说过的话、与其他群友的关系等。具体保存方式如下：
+```json
+{
+  "id": "123456",
+  "nickname": "小明",
+  "aliases": ["小明哥", "明酱"],
+  "past_nicknames": ["明明"],
+  "info": ["职业：程序员", "爱好：打游戏"],
+  "groups": ["114514","1919810"]
+}
+```
+
+| 字段 | 来源 | 说明 |
+|------|------|------|
+| `nickname` | 系统自动更新 | QQ 全局昵称 |
+| `aliases` | LLM 管理 | 群友对 ta 的称呼 |
+| `past_nicknames` | 系统自动记录 | 曾用 QQ 昵称，便于从记忆中识别人物 |
+| `info` | LLM 管理 | 一般信息（职业、爱好等） |
+| `groups` | 系统自动维护 | 所在的群列表 |
 
 ## 表情包功能
 
@@ -184,31 +217,19 @@ memes/
 
 机器人收到图片时，VLM 分析后保存到缓存。LLM 在回复时看到缓存的表情包，决定是否收藏：
 
-```json
-{
-  "memory": {
-    "save_meme": {"id": "a1b2c3d4e5f6", "description": "开心转圈的小人"}
-  }
-}
-```
-
-支持一次收藏多个：
 ```json
 {
   "memory": {
     "save_meme": [
-      {"id": "a1b2c3d4e5f6", "description": "开心转圈"},
-      {"id": "e7f8g9h0i1j2", "description": "气鼓鼓"}
+      {"id": "a1b2c3d4e5f6", "description": "开心转圈的小人", "keywords": ["开心"]}
     ]
   }
 }
 ```
 
-#### 缓存机制
-
-- 图片缓存在 `<缓存目录>/sticker_cache/`，用图片内容的 MD5 作文件名，自动去重
-- 超过 7 天的缓存文件会自动清理
-- 自动收集的表情包超过 `AIGF_MEME_MAX_COUNT` 上限时，优先清理最近未使用的
+- 图片按 MD5 hash 去重
+- 超过 `AIGF_MEME_MAX_COUNT` 上限时，优先清理最近未使用的
+- 缓存中的表情包只处理一次，处理后清空
 
 #### 发送表情包
 
@@ -218,6 +239,17 @@ LLM 在回复中指定表情包 id（来自 memes.json 或 collected.json）：
 {"type": "meme", "id": "happy_spin"}
 ```
 
+## 图片理解模式
+
+通过 `AIGF_IMAGE_MODE` 配置：
+
+| 模式 | 流程 | 适用场景 |
+|------|------|---------|
+| `vlm`（默认） | 图片 → VLM 分析 → 文字描述给 LLM | LLM 不支持图片输入 |
+| `llm` | 图片 → base64 直接附在 LLM prompt 中 | LLM 支持视觉（GPT-4o 等） |
+
+VLM 模式下，描述限制 50 字，情感只输出 3 个词，不识别具体角色名称（只描述外貌特征）。
+
 ## 预设系统
 
 首次运行后在 `<插件配置目录>/presets/` 下生成 `default.json`：
@@ -268,7 +300,7 @@ LLM 支持以下回复类型：
 | @ | `{"type": "at", "name": "群友昵称"}` | 艾特群友 |
 | 表情包 | `{"type": "meme", "id": "表情包id"}` | 发送表情包 |
 
-文本和 @ 会合并为一条消息发送，表情包单独发送。也可以直接用纯字符串代替 `{"type": "text", "content": "..."}`。
+文本和 @ 会合并为一条消息发送，表情包单独发送。
 
 ## 图片理解模式
 
@@ -302,3 +334,9 @@ LLM 支持以下回复类型：
 - VLM API（图片理解，可选）
 - Pillow（图片处理）
 - httpx、anyio
+- numpy
+
+## 一些碎碎念
+- 本项目移除了原插件的 HippoRAG 和情绪系统，拟人程度远不如原插件
+- 本项目的token消耗理论上相较原插件能减少约30-50%，但绝对值仍不低，每次请求约消耗 20K tokens，在记忆数据丰富之后会更高
+- 推荐使用价格较为低廉的模型作为llm模型（群友就是要笨笨的才可爱呀），再以识图能力较好的vlm模型作为辅助（要是看不懂表情包还是会比较尴尬的）