Undefined-bot 3.2.8__tar.gz → 3.3.0__tar.gz

{undefined_bot-3.2.8 → undefined_bot-3.3.0}/CHANGELOG.md

@@ -1,3 +1,17 @@
+## v3.3.0 表情包库与提示词调优
+
+引入持久化表情包库，支持向量检索与自动摄取；围绕群聊回复策略、表情包场景感知与认知记忆稳定性进行了多轮调优。整体上收紧了群聊中的主动参与条件，在轻聊场景下更倾向于使用表情包表达态度，并显著优化了表情包库在 WebUI 列表展示与高负载检索下的响应速度和可用性。
+
+- 新增持久化表情包库，基于 ChromaDB 向量存储，支持基于图像描述嵌入的语义检索与自动摄取入库。
+- 多轮调优系统提示词与群聊回复策略防跑偏，收紧主动参与开放对话的触发条件，并使使用表情包回复成为轻聊探讨场景的默认偏好行为。
+- 增强表情包库上下文感知，Bot 发出的具有实际语义的表情包在消息历史中会携带结构化上下文与 `uid`，便于后续对话继续理解先前意图。
+- 优化提示词缓存命中率以减少重复 Token 消耗，并在提示词上下文中暴露更多运行时能力标志增强 AI 对自身边界的感知。
+- 完善表情包库的基础稳定性与检索体验，修复入库去重、关键字转义注入及孤儿文件存储等问题，并改善了模型自动生成表情描述的质量。
+- 优化 WebUI 表情包列表操作体验，解决布局高度溢出问题，改用支持渐进式加载、搜索排序与分页的列表，大幅降低数据量增长带来的查询开销。
+- 提升认知记忆检索稳定性，为 Chroma 查询增加并发保护、短重试与失败降级机制，降低高负载场景下消息处理被记忆检索异常打断的概率。
+
+---
+
 ## v3.2.8 多模态附件与参考图生图
 
 围绕多模态消息链路进行了较大增强，引入统一的附件 UID 注册与 `<pic uid="..."/>` 图文混排机制，打通群聊、私聊、WebUI 和合并转发中的图片/文件上下文。同步为生图工具补齐参考图生图、独立图片编辑模型配置与提示词审核能力，并完善 Runtime API、认知侧写和动态技能加载的稳定性。

{undefined_bot-3.2.8 → undefined_bot-3.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: Undefined-bot
-Version: 3.2.8
+Version: 3.3.0
 Summary: QQ bot platform with cognitive memory architecture and multi-agent Skills, via OneBot V11.
 Project-URL: Repository, https://github.com/69gg/Undefined
 Project-URL: Issues, https://github.com/69gg/Undefined/issues
@@ -103,6 +103,7 @@ Description-Content-Type: text/markdown
 - **Management API + Runtime API 分层**：配置、日志、Bot 启停和管理探针由 Management API 提供；主进程 Runtime API 则专注探针、记忆只读查询、认知侧写检索和 WebUI AI Chat。详见 [docs/management-api.md](docs/management-api.md) 与 [docs/openapi.md](docs/openapi.md)。
 - **多模型池**：支持配置多个 AI 模型，可轮询、随机选择或用户指定；支持多模型并发比较，选择最佳结果继续对话。详见 [多模型功能文档](docs/multi-model.md)。
 - **本地知识库**：将纯文本文件向量化存入 ChromaDB，AI 可通过关键词搜索或语义搜索查询领域知识；支持增量嵌入与自动扫描。详见 [知识库文档](docs/knowledge.md)。
+- **全局表情包库**：收到图片后可异步判定是否为表情包，通过两阶段 LLM 管线生成纯文本描述与标签，支持关键词检索、语义检索和混合检索，并可直接按统一图片 `uid` 发送或插入 `<pic uid="..."/>`。
 - **访问控制（群/私聊）**：支持 `access.mode` 三种模式（`off` / `blacklist` / `allowlist`）和群/私聊黑白名单；可按策略限制收发范围，避免误触发与误投递。详见 [docs/access-control.md](docs/access-control.md)。
 - **版本变更可查询**：仓库根目录维护 `CHANGELOG.md`，并提供 `/changelog` 命令在运行时查看最近版本和单版本摘要。
 - **并行工具执行**：无论是主 AI 还是子 Agent，均支持 `asyncio` 并发工具调用，大幅提升多任务处理速度（如同时读取多个文件或搜索多个关键词）。
@@ -133,6 +134,7 @@ Undefined 的功能极为丰富，为了让本页面不过于臃肿，我们将
 - ⚙️ **[安装与部署指南](docs/deployment.md)**：不管你是需要 `pip` 无脑一键安装，还是源码二次开发，这里的排坑指南应有尽有。
 - 🧭 **[Management API 与远程管理](docs/management-api.md)**：WebUI / App 共用的管理接口、认证、配置/日志/Bot 控制与引导探针说明。
 - 🛠️ **[配置与热更新说明](docs/configuration.md)**：从模型切换到 MCP 库挂载，全方位掌握 `config.toml` 的高阶配置。
+- 😶 **[表情包库与图片 UID](docs/configuration.md#425-memes-表情包库)**：查看 `memes.*` 配置、统一图片 `uid` 语义、检索模式与库存管理说明。
 - 💡 **[交互与使用手册](docs/usage.md)**：包含实用的对话示例、多模态解析用法，以及群管家必备的管理员`/指令`。
 - 📝 **[版本变更记录](CHANGELOG.md)**：查看按版本整理的更新摘要，也可在运行时使用 `/changelog` 查询。
 - 🛡️ **[访问控制说明](docs/access-control.md)**：教你如何精准配置黑白名单，让机器人的使用范围分毫不差。

{undefined_bot-3.2.8 → undefined_bot-3.3.0}/README.md

@@ -43,6 +43,7 @@
 - **Management API + Runtime API 分层**：配置、日志、Bot 启停和管理探针由 Management API 提供；主进程 Runtime API 则专注探针、记忆只读查询、认知侧写检索和 WebUI AI Chat。详见 [docs/management-api.md](docs/management-api.md) 与 [docs/openapi.md](docs/openapi.md)。
 - **多模型池**：支持配置多个 AI 模型，可轮询、随机选择或用户指定；支持多模型并发比较，选择最佳结果继续对话。详见 [多模型功能文档](docs/multi-model.md)。
 - **本地知识库**：将纯文本文件向量化存入 ChromaDB，AI 可通过关键词搜索或语义搜索查询领域知识；支持增量嵌入与自动扫描。详见 [知识库文档](docs/knowledge.md)。
+- **全局表情包库**：收到图片后可异步判定是否为表情包，通过两阶段 LLM 管线生成纯文本描述与标签，支持关键词检索、语义检索和混合检索，并可直接按统一图片 `uid` 发送或插入 `<pic uid="..."/>`。
 - **访问控制（群/私聊）**：支持 `access.mode` 三种模式（`off` / `blacklist` / `allowlist`）和群/私聊黑白名单；可按策略限制收发范围，避免误触发与误投递。详见 [docs/access-control.md](docs/access-control.md)。
 - **版本变更可查询**：仓库根目录维护 `CHANGELOG.md`，并提供 `/changelog` 命令在运行时查看最近版本和单版本摘要。
 - **并行工具执行**：无论是主 AI 还是子 Agent，均支持 `asyncio` 并发工具调用，大幅提升多任务处理速度（如同时读取多个文件或搜索多个关键词）。
@@ -73,6 +74,7 @@ Undefined 的功能极为丰富，为了让本页面不过于臃肿，我们将
 - ⚙️ **[安装与部署指南](docs/deployment.md)**：不管你是需要 `pip` 无脑一键安装，还是源码二次开发，这里的排坑指南应有尽有。
 - 🧭 **[Management API 与远程管理](docs/management-api.md)**：WebUI / App 共用的管理接口、认证、配置/日志/Bot 控制与引导探针说明。
 - 🛠️ **[配置与热更新说明](docs/configuration.md)**：从模型切换到 MCP 库挂载，全方位掌握 `config.toml` 的高阶配置。
+- 😶 **[表情包库与图片 UID](docs/configuration.md#425-memes-表情包库)**：查看 `memes.*` 配置、统一图片 `uid` 语义、检索模式与库存管理说明。
 - 💡 **[交互与使用手册](docs/usage.md)**：包含实用的对话示例、多模态解析用法，以及群管家必备的管理员`/指令`。
 - 📝 **[版本变更记录](CHANGELOG.md)**：查看按版本整理的更新摘要，也可在运行时使用 `/changelog` 查询。
 - 🛡️ **[访问控制说明](docs/access-control.md)**：教你如何精准配置黑白名单，让机器人的使用范围分毫不差。

{undefined_bot-3.2.8 → undefined_bot-3.3.0}/config.toml.example

@@ -119,6 +119,9 @@ responses_tool_choice_compat = false
 # zh: Responses API 续轮强制降级：启用后，多轮工具调用将始终跳过 previous_response_id，直接使用完整消息重放（stateless replay）。仅在上游不兼容 responses 状态续轮时使用。默认关闭。
 # en: Responses API force stateless replay: when enabled, multi-turn tool follow-ups always skip previous_response_id and replay the full message history instead. Use only when the upstream does not handle stateful responses follow-ups correctly. Disabled by default.
 responses_force_stateless_replay = false
+# zh: 是否启用自动 prompt_cache_key（建议开启，以提高相似请求的缓存命中率）。
+# en: Enable automatic prompt_cache_key generation (recommended).
+prompt_cache_enabled = true
 
 # zh: 额外请求体参数（可选），可用于 temperature 或供应商私有参数。
 # en: Extra request-body params (optional), e.g. temperature or vendor-specific fields.
@@ -182,6 +185,7 @@ responses_tool_choice_compat = false
 # zh: Responses API 续轮强制降级：启用后，多轮工具调用将始终跳过 previous_response_id，直接使用完整消息重放（stateless replay）。仅在上游不兼容 responses 状态续轮时使用。默认关闭。
 # en: Responses API force stateless replay: when enabled, multi-turn tool follow-ups always skip previous_response_id and replay the full message history instead. Use only when the upstream does not handle stateful responses follow-ups correctly. Disabled by default.
 responses_force_stateless_replay = false
+prompt_cache_enabled = true
 
 # zh: 额外请求体参数（可选），可用于 temperature 或供应商私有参数。
 # en: Extra request-body params (optional), e.g. temperature or vendor-specific fields.
@@ -238,6 +242,7 @@ responses_tool_choice_compat = false
 # zh: Responses API 续轮强制降级：启用后，多轮工具调用将始终跳过 previous_response_id，直接使用完整消息重放（stateless replay）。仅在上游不兼容 responses 状态续轮时使用。默认关闭。
 # en: Responses API force stateless replay: when enabled, multi-turn tool follow-ups always skip previous_response_id and replay the full message history instead. Use only when the upstream does not handle stateful responses follow-ups correctly. Disabled by default.
 responses_force_stateless_replay = false
+prompt_cache_enabled = true
 
 # zh: 额外请求体参数（可选），可用于 temperature 或供应商私有参数。
 # en: Extra request-body params (optional), e.g. temperature or vendor-specific fields.
@@ -346,6 +351,7 @@ responses_tool_choice_compat = false
 # zh: Responses API 续轮强制降级：启用后，多轮工具调用将始终跳过 previous_response_id，直接使用完整消息重放（stateless replay）。仅在上游不兼容 responses 状态续轮时使用。默认关闭。
 # en: Responses API force stateless replay: when enabled, multi-turn tool follow-ups always skip previous_response_id and replay the full message history instead. Use only when the upstream does not handle stateful responses follow-ups correctly. Disabled by default.
 responses_force_stateless_replay = false
+prompt_cache_enabled = true
 
 # zh: 额外请求体参数（可选），可用于 temperature 或供应商私有参数。
 # en: Extra request-body params (optional), e.g. temperature or vendor-specific fields.
@@ -412,6 +418,7 @@ responses_tool_choice_compat = false
 # zh: Responses API 续轮强制降级：启用后，多轮工具调用将始终跳过 previous_response_id，直接使用完整消息重放（stateless replay）。仅在上游不兼容 responses 状态续轮时使用。默认关闭。
 # en: Responses API force stateless replay: when enabled, multi-turn tool follow-ups always skip previous_response_id and replay the full message history instead. Use only when the upstream does not handle stateful responses follow-ups correctly. Disabled by default.
 responses_force_stateless_replay = false
+prompt_cache_enabled = true
 
 # zh: 额外请求体参数（可选），可用于 temperature 或供应商私有参数。
 # en: Extra request-body params (optional), e.g. temperature or vendor-specific fields.
@@ -453,6 +460,9 @@ thinking_include_budget = true
 # zh: reasoning effort 传参风格：openai（reasoning_effort）/ anthropic（output_config.effort）。
 # en: Reasoning effort wire format: openai (reasoning_effort) / anthropic (output_config.effort).
 reasoning_effort_style = "openai"
+# zh: 是否启用自动 prompt_cache_key（建议开启，以提高相似请求的缓存命中率）。
+# en: Enable automatic prompt_cache_key generation (recommended).
+prompt_cache_enabled = true
 
 # zh: 额外请求体参数（可选），可用于 temperature 或供应商私有参数。
 # en: Extra request-body params (optional), e.g. temperature or vendor-specific fields.
@@ -1051,6 +1061,56 @@ failed_cleanup_interval = 100
 # en: Max auto-retries per job before moving to failed (0=no retry).
 job_max_retries = 3
 
+[memes]
+# zh: 是否启用全局表情包库。
+# en: Enable the global meme library.
+enabled = true
+# zh: 默认查询模式：keyword / semantic / hybrid。
+# en: Default query mode: keyword / semantic / hybrid.
+query_default_mode = "hybrid"
+# zh: 入库前允许处理的原始图片大小上限（字节）。
+# en: Max source image size in bytes before ingestion.
+max_source_image_bytes = 512000
+# zh: 原图持久化目录。
+# en: Directory for persisted meme blobs.
+blob_dir = "data/memes/blobs"
+# zh: 预览图目录（动图会抽首帧预览）。
+# en: Directory for preview images (animated images use the first frame).
+preview_dir = "data/memes/previews"
+# zh: SQLite 元数据文件路径。
+# en: SQLite metadata database path.
+db_path = "data/memes/memes.sqlite3"
+# zh: 向量索引目录。
+# en: Vector index directory.
+vector_store_path = "data/memes/chromadb"
+# zh: 后台任务队列目录。
+# en: Background queue directory.
+queue_path = "data/memes/queues"
+# zh: 表情包条目上限。
+# en: Max number of meme items.
+max_items = 10000
+# zh: 表情包总磁盘占用上限（字节）。
+# en: Max total on-disk bytes for meme blobs.
+max_total_bytes = 5368709120
+# zh: 是否允许 GIF 入库。
+# en: Whether GIF files are allowed.
+allow_gif = true
+# zh: 是否自动处理群聊图片。
+# en: Auto-ingest group chat images.
+auto_ingest_group = true
+# zh: 是否自动处理私聊图片。
+# en: Auto-ingest private chat images.
+auto_ingest_private = true
+# zh: 关键词召回候选数。
+# en: Keyword recall candidate count.
+keyword_top_k = 30
+# zh: 语义召回候选数。
+# en: Semantic recall candidate count.
+semantic_top_k = 30
+# zh: 重排候选数。
+# en: Rerank candidate count.
+rerank_top_k = 20
+
 # zh: Naga 外部网关集成配置。
 # zh: 开关分层：
 # zh:   - [features].nagaagent_mode_enabled — 总开关，控制 AI 侧行为（提示词切换、工具暴露）

{undefined_bot-3.2.8 → undefined_bot-3.3.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "Undefined-bot"
-version = "3.2.8"
+version = "3.3.0"
 description = "QQ bot platform with cognitive memory architecture and multi-agent Skills, via OneBot V11."
 readme = "README.md"
 authors = [

undefined_bot-3.3.0/res/prompts/describe_meme_image.txt

@@ -0,0 +1,78 @@
+你在做“表情包入库描述”。
+
+任务：
+- 对一张已经确认是表情包的图片，产出可检索的简短描述和少量标签。
+- 你必须调用 `submit_meme_description` 提交结果。
+
+核心目标：
+- 让后续搜索尽可能容易命中这张表情包。
+- `description` 应同时覆盖“画面内容”和“聊天语义”，不能只写其中一边。
+
+`description` 编写规则：
+- 用 1 句自然中文描述，允许比普通 tag 更长，长度尽量控制在 50 到 200 个字之间。
+- 可以写得更完整，只要仍然便于检索和阅读，不要为了“短”而丢失关键信息；宁可完整，也不要过短到失去画面和语义细节。
+- 可以接受偏长的完整描述，但不要写成多句说明、段落解释或复盘。
+- 尽量同时包含以下信息中的 3 到 5 个：
+  - 主体：人、猫、狗、熊猫、动漫角色、明星、网友截图等
+  - 画面/构图：特写、侧脸、瞪眼、翻白眼、捂脸、鼓掌、流汗、黑白、聊天截图、字幕图、动图定格
+  - 情绪/语气：无语、震惊、委屈、嘲讽、得意、阴阳怪气、崩溃、开心、嫌弃
+  - 动作/状态：翻白眼、鼓掌、捂脸、叹气、偷笑、流汗、发呆、摊手
+  - 使用场景：敷衍回应、上班吐槽、群聊附和、阴阳怪气、看乐子、尴尬收场
+- 如果图中文字本身就是表情包语义的一部分，可以概括它表达的意思，但不要逐字转录。
+- `description` 不能只写情绪和用途，也必须写出图片内容本身：谁/什么在画面里、表情如何、动作如何、画面是什么类型。
+- 如果画面里有明显视觉特征，也要写出来，例如：
+  - 主体是谁或是什么
+  - 表情是什么样
+  - 动作是什么
+  - 是真人截图、聊天截图、动漫画面、动物特写还是字幕反应图
+- 不要写空泛句式，例如：
+  - “一张表情包”
+  - “一张很搞笑的图片”
+  - “一个人物表情包”
+- 不要只描述视觉内容而不描述语气，例如“一个猫的图片”不够。
+- 也不要只描述语气而没有画面，例如“表达无语的表情包”也不够。
+- 更好的写法应该像：
+  - `猫猫无语翻白眼反应图`
+  - `真人尴尬陪笑聊天截图表情包`
+  - `二次元角色震惊瞪眼特写反应图`
+- 如果信息足够明确，也可以写得更完整，例如：
+  - `猫猫翻白眼一脸无语的聊天反应图`
+  - `真人尴尬陪笑带点敷衍意味的聊天截图表情包`
+  - `二次元角色瞪大眼睛震惊到说不出话的反应图`
+
+`tags` 编写规则：
+- `tags` 控制在 0 到 6 个。
+- 每个 tag 尽量短，优先 2 到 6 个字。
+- tag 应尽量覆盖不同维度，不要全是同义词。
+- 优先从这些维度中选：
+  - 主体：`猫猫`、`狗狗`、`熊猫`、`真人`、`二次元`
+  - 情绪：`无语`、`震惊`、`委屈`、`嘲讽`、`嫌弃`、`崩溃`
+  - 场景：`上班`、`群聊`、`吐槽`、`附和`、`看乐子`
+  - 风格：`截图`、`动图`、`反应图`
+- 不要堆重复词，例如 `无语`、`很无语`、`超级无语` 这种不要同时出现。
+
+额外限制：
+- 不要输出 OCR。
+- 不要逐字抄录图中文字。
+- 不要输出 Markdown，不要输出额外解释。
+- 你必须且只能调用 `submit_meme_description`。
+
+好的例子：
+- `description`: `猫猫无语翻白眼反应图`
+  `tags`: [`猫猫`, `无语`, `翻白眼`, `反应图`]
+- `description`: `真人尴尬陪笑敷衍表情包`
+  `tags`: [`真人`, `尴尬`, `陪笑`, `敷衍`]
+- `description`: `二次元角色震惊瞪眼反应图`
+  `tags`: [`二次元`, `震惊`, `瞪眼`, `反应图`]
+- `description`: `熊猫头摊手无奈聊天截图表情包`
+  `tags`: [`熊猫头`, `无奈`, `摊手`, `聊天截图`]
+- `description`: `猫猫翻白眼露出嫌弃表情的无语反应图`
+  `tags`: [`猫猫`, `嫌弃`, `无语`, `翻白眼`]
+- `description`: `真人聊天截图里尴尬陪笑又有点敷衍的表情包`
+  `tags`: [`真人`, `聊天截图`, `尴尬`, `敷衍`]
+
+差的例子：
+- `description`: `一张表情包`
+- `description`: `一个猫的图片`
+- `description`: `图片上写了几句话`
+- `description`: `表达无语`

undefined_bot-3.3.0/res/prompts/judge_meme_image.txt

@@ -0,0 +1,24 @@
+你在做“表情包入库判定”。
+
+任务：
+- 判断这张图片是否适合进入聊天表情包库。
+- 你必须调用 `submit_meme_judgement` 提交结果。
+
+判为表情包的常见情况：
+- 明显用于聊天回应的反应图、梗图、吐槽图、情绪图
+- 表情夸张、语气明确、配字短促，适合在对话里直接发送
+- QQ / 群聊语境中常见的“无语”“震惊”“乐”“行吧”“笑死”“急了”等情绪回应图片
+- 整张图的主要用途就是做表情包；画面主体、构图和文字都在服务于这个表情包语义
+
+不应判为表情包的常见情况：
+- 普通照片、风景、壁纸、头像、宣传图、商品图
+- 资料截图、文档截图、界面截图、课程内容、长图信息
+- 只是“有字的图片”但主要用途不是对话反应
+- 图片里虽然有一部分像表情包，但整张图还包含大量无关内容、额外主体、背景信息、拼图内容、长段截图、聊天记录、界面信息或其他多余要素
+- 需要裁剪、截取局部、去掉边框/旁白/大段上下文后才能像表情包的图，默认不要判进库
+
+输出要求：
+- 必须且只能调用 `submit_meme_judgement`
+- `is_meme` 仅表示“适不适合放进聊天表情包库”，不是“图里有没有梗”
+- `reason` 用一句简短中文说明依据
+- 只有当“整张图整体上就是一张可直接发送的表情包”时，才能给 `is_meme=true`

{undefined_bot-3.2.8 → undefined_bot-3.3.0}/res/prompts/undefined.xml

@@ -134,10 +134,18 @@
 
       <mixed_media_output priority="P0">
         **图文混排规则：**
+        - 如果你已经决定要回复，并且表情包能让表达更像真人，默认先尝试表情包，而不是先写文字
+        - 如果要发送独立表情包，先用 `memes.search_memes` 找到合适的图片 `uid`，再用 `memes.send_meme_by_uid` 单独发送一条图片消息
+        - 对于吐槽、附和、接梗、表达态度、表达情绪这类回复，只要表情包能完成表达，就应该直接发表情包，不要用文字去“描述你本来想发的表情包”
+        - 对于私聊对话、被拍一拍、被@、轻量答疑这类本来就会回复的场景，只要表情包能自然增强语气、缓和语气或让回复更像真人，也可以配合使用
+        - 除非 `memes.search_memes` 没找到合适结果，或表情包会干扰信息传递，否则不要把本来适合发图的反应先写成一句话来代替发图
+        - 表情包相关规则只决定“怎么回复”，不单独构成“该不该回复”的参与许可；是否回复仍以前面的回复触发逻辑为准
+        - 默认不要把表情包和正文写进同一条消息；需要补一句解释时，优先分成两条消息发送
         - 如果上下文或工具结果给了图片 UID（例如 `pic_ab12cd34`），你可以在 `send_message.message` 里直接插入 `<pic uid="pic_ab12cd34"/>`
         - `<pic uid="..."/>` 是唯一允许的内嵌图片语法；不要改成 Markdown 图片、HTML `<img>`、代码块或自然语言描述
         - 可以图文混排，例如：`我给你介绍一下`\n`<pic uid="pic_xxx"/>`\n`如图所示`
-        - 只能引用当前会话里明确给出的图片 UID，禁止臆造 UID
+        - 表情包库返回的图片 UID 也可以直接用于 `<pic uid="..."/>`；当前会话临时图片和表情包库图片共用同一套 `uid` 语义
+        - 只能引用工具结果或上下文里明确给出的图片 UID，禁止臆造 UID
         - 只有 `pic_*` 这类图片 UID 能放进 `<pic>`；普通文件 UID 不能放进去
       </mixed_media_output>
     </message_sending_mechanism>
@@ -309,21 +317,15 @@
         </trigger>
 
         <trigger id="7">
-          <condition>群里在讨论你擅长或感兴趣的技术话题（代码、AI、开发工具等），且对话处于开放状态（不是两人私聊），你有自然的想法可以贡献</condition>
-          <action>可以主动参与，但要自然，像一个群成员偶尔插一句</action>
-          <warning>不要长篇大论，一两句点到为止；如果别人已经在深入讨论且不需要你，保持沉默</warning>
-        </trigger>
-
-        <trigger id="8">
-          <condition>有人说了明显有趣/好笑的话，你有自然的回应冲动</condition>
-          <action>可以简短回应（吐槽、接梗、表达共鸣），但要克制频率</action>
-          <warning>不要每个好笑的消息都回，偶尔参与即可；不确定就不参与</warning>
+          <condition>群里在讨论你擅长或感兴趣的技术或项目话题（代码、AI、开发工具、项目进展、技术 bug 等），且对话处于开放状态（不是两人定向交流、不是明显在和别人说），你有自然的想法可以贡献</condition>
+          <action>可以极低频参与，但要自然，像一个群成员偶尔插一句</action>
+          <warning>默认更倾向不参与；不要长篇大论，一两句点到为止；如果别人已经在深入讨论且不需要你，保持沉默；如果你不能确定这是不是开放讨论，默认不参与</warning>
         </trigger>
 
         <trigger id="9">
           <condition>有人分享了技术成果、遇到了有趣的 bug、或展示了项目进展</condition>
           <action>可以简短回应表示关注或给出评价</action>
-          <warning>保持简短自然，不要变成技术评审</warning>
+          <warning>保持简短自然，不要变成技术评审；没有明确必要时宁可不回</warning>
         </trigger>
       </optional_triggers>
       
@@ -334,7 +336,7 @@
         </trigger>
         
         <trigger id="2">
-          <condition>别人之间的对话（两人或多人明确在交流）</condition>
+          <condition>别人之间的定向对话（两人明显在来回说，或多人里明显是在接别人而不是接你）</condition>
           <action>不要插话，即使话题你感兴趣</action>
         </trigger>
         
@@ -366,6 +368,11 @@
           <action>保持沉默</action>
         </trigger>
         
+        <trigger id="11">
+          <condition>你不能确定这条消息是不是在对你说，或不能确定当前对话是否对你开放</condition>
+          <action>默认不回复</action>
+        </trigger>
+        
         <trigger id="7">
           <condition>Null在与其他人对话（即使话题你感兴趣）</condition>
           <action>保持沉默，不要插话</action>
@@ -598,11 +605,11 @@
         <guideline id="8">
           <name>图片处理</name>
           <rule>先判断是否需要参与：只有当图片与当前对话强相关、且回答必须依赖图片内容时才分析</rule>
-          <rule>表情包只需理解意思，默认不回复；若触发 mandatory_triggers 必须回复，则只做最短情绪回应</rule>
+          <rule>表情包先理解意思；它不只适用于轻松闲聊。只要你已经决定要回复，并且表情包能让表达更像真人，就可以考虑使用，包括私聊对话、被拍一拍、被@、轻量答疑与轻松互动场景</rule>
           <rule>只有在需要分析图片内容时才调用 file_analysis_agent（如报错截图/界面/文档/图片问题）</rule>
           <rule>当消息中出现“[图片: xxx]”占位符时，xxx 即为 file_id 或 URL，可直接作为 file_source 调用 file_analysis_agent</rule>
           <rule>未调用 file_analysis_agent 时，不要猜测图片内容；可以说明“我看不到图片内容，需要先分析”</rule>
-          <rule>即使已分析图片，也要再次判断是否需要发言；若与对话无关或只是表情包，选择不回复或最短回应</rule>
+          <rule>即使已分析图片，也要再次判断是否需要发言；如果明显在和别人说或你拿不准是不是在对你说，默认不回复；若你已经决定回复，并且表情包不会干扰信息传递，先尝试 memes.search_memes 并使用独立表情包回应，默认由表情包承担主要表达，文字只作极短补充</rule>
           <rule>回复时不要描述图片内容，像正常人一样直接回应重点</rule>
           <rule>不要分析每条图片。图片分析有很大延迟，只有需要时才分析</rule>
         </guideline>
@@ -676,7 +683,7 @@
         <rule>不是每条消息都要回</rule>
         <rule>大部分时候你应该保持沉默</rule>
         <rule>不符合触发条件时，直接调用 end</rule>
-        <rule>但沉默不等于冷漠——适度的主动参与能让你更像一个真实的群成员，而不是一个被动的工具。在 optional_triggers 范围内偶尔主动说话是健康的。</rule>
+        <rule>optional_triggers 只是“少量例外”，不是常规参与许可。默认仍然应明显偏向沉默；若真要参与，优先用表情包而不是文字。</rule>
       </strategy>
       
       <strategy id="2">

{undefined_bot-3.2.8 → undefined_bot-3.3.0}/res/prompts/undefined_nagaagent.xml

@@ -134,10 +134,18 @@
 
       <mixed_media_output priority="P0">
         **图文混排规则：**
+        - 如果你已经决定要回复，并且表情包能让表达更像真人，默认先尝试表情包，而不是先写文字
+        - 如果要发送独立表情包，先用 `memes.search_memes` 找到合适的图片 `uid`，再用 `memes.send_meme_by_uid` 单独发送一条图片消息
+        - 对于吐槽、附和、接梗、表达态度、表达情绪这类回复，只要表情包能完成表达，就应该直接发表情包，不要用文字去“描述你本来想发的表情包”
+        - 对于私聊对话、被拍一拍、被@、轻量答疑这类本来就会回复的场景，只要表情包能自然增强语气、缓和语气或让回复更像真人，也可以配合使用
+        - 除非 `memes.search_memes` 没找到合适结果，或表情包会干扰信息传递，否则不要把本来适合发图的反应先写成一句话来代替发图
+        - 表情包相关规则只决定“怎么回复”，不单独构成“该不该回复”的参与许可；是否回复仍以前面的回复触发逻辑为准
+        - 默认不要把表情包和正文写进同一条消息；需要补一句解释时，优先分成两条消息发送
         - 如果上下文或工具结果给了图片 UID（例如 `pic_ab12cd34`），你可以在 `send_message.message` 里直接插入 `<pic uid="pic_ab12cd34"/>`
         - `<pic uid="..."/>` 是唯一允许的内嵌图片语法；不要改成 Markdown 图片、HTML `<img>`、代码块或自然语言描述
         - 可以图文混排，例如：`我给你介绍一下`\n`<pic uid="pic_xxx"/>`\n`如图所示`
-        - 只能引用当前会话里明确给出的图片 UID，禁止臆造 UID
+        - 表情包库返回的图片 UID 也可以直接用于 `<pic uid="..."/>`；当前会话临时图片和表情包库图片共用同一套 `uid` 语义
+        - 只能引用工具结果或上下文里明确给出的图片 UID，禁止臆造 UID
         - 只有 `pic_*` 这类图片 UID 能放进 `<pic>`；普通文件 UID 不能放进去
       </mixed_media_output>
     </message_sending_mechanism>
@@ -315,21 +323,15 @@
         </trigger>
 
         <trigger id="8">
-          <condition>群里在讨论你擅长或感兴趣的技术话题（代码、AI、开发工具等），且对话处于开放状态（不是两人私聊），你有自然的想法可以贡献</condition>
-          <action>可以主动参与，但要自然，像一个群成员偶尔插一句</action>
-          <warning>不要长篇大论，一两句点到为止；如果别人已经在深入讨论且不需要你，保持沉默</warning>
-        </trigger>
-
-        <trigger id="9">
-          <condition>有人说了明显有趣/好笑的话，你有自然的回应冲动</condition>
-          <action>可以简短回应（吐槽、接梗、表达共鸣），但要克制频率</action>
-          <warning>不要每个好笑的消息都回，偶尔参与即可；不确定就不参与</warning>
+          <condition>群里在讨论你擅长或感兴趣的技术或项目话题（代码、AI、开发工具、项目进展、技术 bug 等），且对话处于开放状态（不是两人定向交流、不是明显在和别人说），你有自然的想法可以贡献</condition>
+          <action>可以极低频参与，但要自然，像一个群成员偶尔插一句</action>
+          <warning>默认更倾向不参与；不要长篇大论，一两句点到为止；如果别人已经在深入讨论且不需要你，保持沉默；如果你不能确定这是不是开放讨论，默认不参与</warning>
         </trigger>
 
         <trigger id="10">
           <condition>有人分享了技术成果、遇到了有趣的 bug、或展示了项目进展</condition>
           <action>可以简短回应表示关注或给出评价</action>
-          <warning>保持简短自然，不要变成技术评审</warning>
+          <warning>保持简短自然，不要变成技术评审；没有明确必要时宁可不回</warning>
         </trigger>
       </optional_triggers>
       
@@ -340,7 +342,7 @@
         </trigger>
         
         <trigger id="2">
-          <condition>别人之间的对话（两人或多人明确在交流）</condition>
+          <condition>别人之间的定向对话（两人明显在来回说，或多人里明显是在接别人而不是接你）</condition>
           <action>不要插话，即使话题你感兴趣</action>
         </trigger>
         
@@ -372,6 +374,11 @@
           <action>保持沉默</action>
         </trigger>
         
+        <trigger id="11">
+          <condition>你不能确定这条消息是不是在对你说，或不能确定当前对话是否对你开放</condition>
+          <action>默认不回复</action>
+        </trigger>
+        
         <trigger id="7">
           <condition>Null在与其他人对话（即使话题你感兴趣）</condition>
           <action>保持沉默，不要插话</action>
@@ -633,11 +640,11 @@
         <guideline id="8">
           <name>图片处理</name>
           <rule>先判断是否需要参与：只有当图片与当前对话强相关、且回答必须依赖图片内容时才分析</rule>
-          <rule>表情包只需理解意思，默认不回复；若触发 mandatory_triggers 必须回复，则只做最短情绪回应</rule>
+          <rule>表情包先理解意思；它不只适用于轻松闲聊。只要你已经决定要回复，并且表情包能让表达更像真人，就可以考虑使用，包括私聊对话、被拍一拍、被@、轻量答疑与轻松互动场景</rule>
           <rule>只有在需要分析图片内容时才调用 file_analysis_agent（如报错截图/界面/文档/图片问题）</rule>
           <rule>当消息中出现“[图片: xxx]”占位符时，xxx 即为 file_id 或 URL，可直接作为 file_source 调用 file_analysis_agent</rule>
           <rule>未调用 file_analysis_agent 时，不要猜测图片内容；可以说明“我看不到图片内容，需要先分析”</rule>
-          <rule>即使已分析图片，也要再次判断是否需要发言；若与对话无关或只是表情包，选择不回复或最短回应</rule>
+          <rule>即使已分析图片，也要再次判断是否需要发言；如果明显在和别人说或你拿不准是不是在对你说，默认不回复；若你已经决定回复，并且表情包不会干扰信息传递，先尝试 memes.search_memes 并使用独立表情包回应，默认由表情包承担主要表达，文字只作极短补充</rule>
           <rule>回复时不要描述图片内容，像正常人一样直接回应重点</rule>
           <rule>不要分析每条图片。图片分析有很大延迟，只有需要时才分析</rule>
         </guideline>
@@ -713,7 +720,7 @@
         <rule>不是每条消息都要回</rule>
         <rule>大部分时候你应该保持沉默</rule>
         <rule>不符合触发条件时，直接调用 end</rule>
-        <rule>但沉默不等于冷漠——适度的主动参与能让你更像一个真实的群成员，而不是一个被动的工具。在 optional_triggers 范围内偶尔主动说话是健康的。</rule>
+        <rule>optional_triggers 只是“少量例外”，不是常规参与许可。默认仍然应明显偏向沉默；若真要参与，优先用表情包而不是文字。</rule>
       </strategy>
       
       <strategy id="2">

{undefined_bot-3.2.8 → undefined_bot-3.3.0}/src/Undefined/__init__.py

@@ -1,3 +1,3 @@
 """Undefined - A high-performance, highly scalable QQ group and private chat robot based on a self-developed architecture."""
 
-__version__ = "3.2.8"
+__version__ = "3.3.0"

{undefined_bot-3.2.8 → undefined_bot-3.3.0}/src/Undefined/ai/client.py

@@ -137,6 +137,7 @@ class AIClient:
         self._token_counter = TokenCounter()
         self._knowledge_manager: Any = None
         self._cognitive_service: Any = cognitive_service
+        self._meme_service: Any = None
         self.attachment_registry = AttachmentRegistry(http_client=self._http_client)
 
         # 私聊发送回调
@@ -594,6 +595,21 @@ class AIClient:
             bool(getattr(service, "enabled", False)) if service is not None else False,
         )
 
+    def set_meme_service(self, service: Any) -> None:
+        self._meme_service = service
+        resolver = None
+        async_resolver = None
+        if service is not None and hasattr(service, "resolve_global_image_sync"):
+            resolver = service.resolve_global_image_sync
+        if service is not None and hasattr(service, "resolve_global_image"):
+            async_resolver = service.resolve_global_image
+        self.attachment_registry.set_global_image_resolver(resolver)
+        self.attachment_registry.set_global_image_resolver_async(async_resolver)
+        logger.info(
+            "[AI客户端] 表情包服务已挂载: enabled=%s",
+            bool(getattr(service, "enabled", False)) if service is not None else False,
+        )
+
     def apply_search_config(self, searxng_url: str) -> None:
         """应用搜索服务配置（支持热更新）。"""
         if not _SEARX_AVAILABLE or _SearxSearchWrapper is None:
@@ -817,6 +833,12 @@ class AIClient:
     ) -> dict[str, str]:
         return await self._multimodal.describe_image(image_url, prompt_extra)
 
+    async def judge_meme_image(self, image_url: str) -> dict[str, Any]:
+        return await self._multimodal.judge_meme_image(image_url)
+
+    async def describe_meme_image(self, image_url: str) -> dict[str, Any]:
+        return await self._multimodal.describe_meme_image(image_url)
+
     def get_media_history(self, media_key: str) -> list[dict[str, str]]:
         """获取指定媒体键的多模态分析历史 Q&A 记录。"""
         return self._multimodal.get_history(media_key)
@@ -989,6 +1011,7 @@ class AIClient:
         tool_context.setdefault("memory_storage", self.memory_storage)
         tool_context.setdefault("knowledge_manager", self._knowledge_manager)
         tool_context.setdefault("cognitive_service", self._cognitive_service)
+        tool_context.setdefault("meme_service", self._meme_service)
         tool_context.setdefault("current_question", question)
         message_ids = tool_context.get("message_ids")
         if not isinstance(message_ids, list):

{undefined_bot-3.2.8 → undefined_bot-3.3.0}/src/Undefined/ai/llm.py

@@ -33,6 +33,7 @@ from Undefined.ai.transports import (
 )
 from Undefined.ai.retrieval import RetrievalRequester
 from Undefined.ai.tokens import TokenCounter
+from Undefined.context import RequestContext
 from Undefined.config import (
     ChatModelConfig,
     VisionModelConfig,
@@ -200,6 +201,7 @@ _DEFAULT_TOOLS_DESCRIPTION_PREVIEW_LEN = 160
 _DEFAULT_TOOL_NAME_DOT_DELIMITER = "-_-"
 _TOOL_NAME_MAX_LEN = 64
 _TOOL_NAME_ALLOWED_RE = re.compile(r"^[a-zA-Z0-9_-]+$")
+_PROMPT_CACHE_KEY_MAX_LEN = 128
 
 
 def _tool_name_dot_delimiter() -> str:
@@ -224,6 +226,46 @@ def _hash8(text: str) -> str:
     return hashlib.sha1(text.encode("utf-8"), usedforsecurity=False).hexdigest()[:8]
 
 
+def _normalize_prompt_cache_part(value: Any) -> str:
+    text = str(value or "").strip().lower()
+    if not text:
+        return "none"
+    normalized_chars: list[str] = []
+    for char in text:
+        if char.isalnum() or char in {"-", "_", ":"}:
+            normalized_chars.append(char)
+        else:
+            normalized_chars.append("_")
+    normalized = "".join(normalized_chars).strip("_")
+    return normalized or "none"
+
+
+def _build_scope_prompt_cache_part() -> str:
+    ctx = RequestContext.current()
+    if ctx is None:
+        return "scope:global"
+    if ctx.group_id is not None:
+        return f"group:{int(ctx.group_id)}"
+    if ctx.user_id is not None:
+        return f"private:{int(ctx.user_id)}"
+    if ctx.sender_id is not None:
+        return f"sender:{int(ctx.sender_id)}"
+    request_type = _normalize_prompt_cache_part(ctx.request_type)
+    return f"type:{request_type}"
+
+
+def _build_default_prompt_cache_key(model_config: ModelConfig, call_type: str) -> str:
+    model_name = _normalize_prompt_cache_part(getattr(model_config, "model_name", ""))
+    scope_part = _build_scope_prompt_cache_part()
+    call_part = _normalize_prompt_cache_part(call_type)
+    key = f"pc:{model_name}:{call_part}:{scope_part}"
+    if len(key) <= _PROMPT_CACHE_KEY_MAX_LEN:
+        return key
+    suffix = "_" + _hash8(key)
+    prefix_len = max(1, _PROMPT_CACHE_KEY_MAX_LEN - len(suffix))
+    return key[:prefix_len] + suffix
+
+
 def _encode_tool_name_for_api(tool_name: str) -> str:
     """将内部工具名编码为服务端可接受的 function.name。
 
@@ -1085,6 +1127,13 @@ class ModelRequester:
             call_type=call_type,
             overrides=dict(kwargs),
         )
+        if bool(
+            getattr(model_config, "prompt_cache_enabled", True)
+        ) and not effective_kwargs.get("prompt_cache_key"):
+            effective_kwargs["prompt_cache_key"] = _build_default_prompt_cache_key(
+                model_config,
+                call_type,
+            )
         responses_stateless_replay = bool(
             getattr(model_config, "responses_force_stateless_replay", False)
         ) or bool(

{undefined_bot-3.2.8 → undefined_bot-3.3.0}/src/Undefined/ai/model_selector.py

@@ -248,6 +248,7 @@ class ModelSelector:
             thinking_tool_call_compat=entry.thinking_tool_call_compat,
             responses_tool_choice_compat=entry.responses_tool_choice_compat,
             responses_force_stateless_replay=entry.responses_force_stateless_replay,
+            prompt_cache_enabled=entry.prompt_cache_enabled,
             reasoning_enabled=entry.reasoning_enabled,
             reasoning_effort=entry.reasoning_effort,
             request_params=entry.request_params,
@@ -272,6 +273,7 @@ class ModelSelector:
             thinking_tool_call_compat=entry.thinking_tool_call_compat,
             responses_tool_choice_compat=entry.responses_tool_choice_compat,
             responses_force_stateless_replay=entry.responses_force_stateless_replay,
+            prompt_cache_enabled=entry.prompt_cache_enabled,
             reasoning_enabled=entry.reasoning_enabled,
             reasoning_effort=entry.reasoning_effort,
             request_params=entry.request_params,