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

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

@@ -1,3 +1,36 @@
+## v3.3.0 表情包库与提示词调优
+
+引入持久化表情包库，支持向量检索与自动摄取；围绕群聊回复策略、表情包场景感知与认知记忆稳定性进行了多轮调优。整体上收紧了群聊中的主动参与条件，在轻聊场景下更倾向于使用表情包表达态度，并显著优化了表情包库在 WebUI 列表展示与高负载检索下的响应速度和可用性。
+
+- 新增持久化表情包库，基于 ChromaDB 向量存储，支持基于图像描述嵌入的语义检索与自动摄取入库。
+- 多轮调优系统提示词与群聊回复策略防跑偏，收紧主动参与开放对话的触发条件，并使使用表情包回复成为轻聊探讨场景的默认偏好行为。
+- 增强表情包库上下文感知，Bot 发出的具有实际语义的表情包在消息历史中会携带结构化上下文与 `uid`，便于后续对话继续理解先前意图。
+- 优化提示词缓存命中率以减少重复 Token 消耗，并在提示词上下文中暴露更多运行时能力标志增强 AI 对自身边界的感知。
+- 完善表情包库的基础稳定性与检索体验，修复入库去重、关键字转义注入及孤儿文件存储等问题，并改善了模型自动生成表情描述的质量。
+- 优化 WebUI 表情包列表操作体验，解决布局高度溢出问题，改用支持渐进式加载、搜索排序与分页的列表，大幅降低数据量增长带来的查询开销。
+- 提升认知记忆检索稳定性，为 Chroma 查询增加并发保护、短重试与失败降级机制，降低高负载场景下消息处理被记忆检索异常打断的概率。
+
+---
+
+## v3.2.8 多模态附件与参考图生图
+
+围绕多模态消息链路进行了较大增强，引入统一的附件 UID 注册与 `<pic uid="..."/>` 图文混排机制，打通群聊、私聊、WebUI 和合并转发中的图片/文件上下文。同步为生图工具补齐参考图生图、独立图片编辑模型配置与提示词审核能力，并完善 Runtime API、认知侧写和动态技能加载的稳定性。
+
+- 新增统一附件注册系统，群聊、私聊、WebUI 会话和合并转发中的图片/文件会登记为内部附件 UID，并写入历史记录与提示词上下文。
+- 系统提示词与发送链路支持 `<pic uid="..."/>` 图文混排，AI 可直接在回复中内嵌当前会话内的图片 UID。
+- 新增 `fetch_image_uid` 工具，支持将远程图片 URL 拉取并注册为当前会话可复用的图片 UID。
+- `get_picture`、`render_html`、`render_markdown`、`render_latex` 默认改为 `embed` 返回可嵌入图片 UID，同时保留 `send` 直接发送模式。
+- `file_analysis_agent` 及相关文件/图片链路已适配附件 UID，优先使用内部 `pic_*` / `file_*` 标识，也继续兼容 URL 与 legacy `file_id`。
+- `ai_draw_one` 支持基于 `reference_image_uids` 的参考图生图，新增 `[models.image_edit]` 配置节，并接入 OpenAI 兼容的 `/v1/images/edits` 接口。
+- 新增基于 Agent 模型的生图提示词审核能力，并补充独立审核提示模板。
+- 优化图片生成请求体验，支持 base64 返回、保留显式尺寸、锁定模型参数，并更清晰地暴露上游错误。
+- 修复附件渲染、图片编辑上传与阻塞式文件读取问题，增强多模态链路稳定性。
+- Runtime API 与 WebUI 现在会注册聊天附件、渲染图片 UID，并支持本地 `file://` 图片预览；同时取消 `_agent` 工具调用的固定超时上限。
+- 认知服务会在用户昵称或群名变化时自动刷新 profile 展示名与向量索引，减少侧写名称陈旧问题。
+- 修复动态技能模块加载与超时包装问题，并补充相关测试覆盖；同步整理 README，移除顶部头图。
+
+---
+
 ## v3.2.7 arXiv 工具集与运行时变更感知
 
 新增 arXiv 论文搜索与提取工具集，以及运行时 CHANGELOG 查询能力。重构了生图工具支持 OpenAI 兼容接口，引入 grok_search 联网搜索工具，并让 AI 在系统提示词中感知自身模型配置信息。同步修复了多项稳定性问题与 CI 效率优化。

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: Undefined-bot
-Version: 3.2.7
+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
@@ -60,7 +60,7 @@ Description-Content-Type: text/markdown
 
 <table border="0">
   <tr>
-    <td width="70%" valign="top">
+    <td width="100%" valign="top">
       <div align="center">
         <h1>Undefined</h1>
         <em>QQ bot platform with cognitive memory architecture and multi-agent Skills, via OneBot V11.</em>
@@ -78,9 +78,6 @@ Description-Content-Type: text/markdown
         <strong>Undefined</strong> 是一个基于 Python 异步架构的高性能 QQ 机器人平台，搭载<strong>认知记忆架构</strong>，采用自研 <strong>Skills</strong> 系统，内置多个智能 Agent，支持代码分析、网络搜索、娱乐互动等多模态能力，并提供 <strong>Management-first WebUI</strong> 在线管理，以及可连接同一管理服务的 <strong>Desktop / Android App</strong>。
       </p>
     </td>
-    <td width="30%">
-      <img src="https://raw.githubusercontent.com/69gg/Undefined/main/img/head.png" width="100%" alt="Undefined" />
-    </td>
   </tr>
 </table>
 
@@ -106,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` 并发工具调用，大幅提升多任务处理速度（如同时读取多个文件或搜索多个关键词）。
@@ -136,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.7 → undefined_bot-3.3.0}/README.md

@@ -1,6 +1,6 @@
 <table border="0">
   <tr>
-    <td width="70%" valign="top">
+    <td width="100%" valign="top">
       <div align="center">
         <h1>Undefined</h1>
         <em>QQ bot platform with cognitive memory architecture and multi-agent Skills, via OneBot V11.</em>
@@ -18,9 +18,6 @@
         <strong>Undefined</strong> 是一个基于 Python 异步架构的高性能 QQ 机器人平台，搭载<strong>认知记忆架构</strong>，采用自研 <strong>Skills</strong> 系统，内置多个智能 Agent，支持代码分析、网络搜索、娱乐互动等多模态能力，并提供 <strong>Management-first WebUI</strong> 在线管理，以及可连接同一管理服务的 <strong>Desktop / Android App</strong>。
       </p>
     </td>
-    <td width="30%">
-      <img src="https://raw.githubusercontent.com/69gg/Undefined/main/img/head.png" width="100%" alt="Undefined" />
-    </td>
   </tr>
 </table>
 
@@ -46,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` 并发工具调用，大幅提升多任务处理速度（如同时读取多个文件或搜索多个关键词）。
@@ -76,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.7 → 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.
@@ -527,6 +537,23 @@ model_name = ""
 # en: Extra request-body params (optional).
 [models.image_gen.request_params]
 
+# zh: 参考图生图模型配置（用于 ai_draw_one 传入 reference_image_uids 时调用 OpenAI 兼容的图片编辑接口）。
+# en: Reference-image generation model config (used when ai_draw_one receives reference_image_uids and calls the OpenAI-compatible image editing API).
+[models.image_edit]
+# zh: OpenAI-compatible 基址 URL，例如 https://api.openai.com/v1（最终请求路径为 /v1/images/edits）。
+# en: OpenAI-compatible base URL, e.g. https://api.openai.com/v1 (final request path is /v1/images/edits).
+api_url = ""
+# zh: API Key。
+# en: API key.
+api_key = ""
+# zh: 模型名称，空则回退到 [models.image_gen] 的 model_name。
+# en: Model name, empty falls back to [models.image_gen].model_name.
+model_name = ""
+
+# zh: 额外请求体参数（可选）。
+# en: Extra request-body params (optional).
+[models.image_edit.request_params]
+
 # zh: 本地知识库配置。
 # en: Local knowledge base settings.
 [knowledge]
@@ -1034,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.7 → undefined_bot-3.3.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "Undefined-bot"
-version = "3.2.7"
+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/image_gen_moderation.txt

@@ -0,0 +1,16 @@
+你是图片生成审核助手，只根据“待生成图片的提示词”判断是否允许生成。
+
+拦截范围包括但不限于：
+- 露骨色情、性剥削、未成年人性化
+- 血腥暴力、肢解、虐杀等重口内容
+- 明显违法、极端、恐怖主义相关内容
+- 明显侵犯隐私、仇恨或其他高风险内容
+
+审核原则：
+- 只审核风险，不提供改写建议，不解释政策，不输出多余内容
+- 安全、普通、模糊但不明显违规的内容默认放行
+- 如果只是普通人物、风景、二次元、服饰、轻微动作描写，不要误杀
+
+输出格式必须严格遵守：
+- 允许：`ALLOW`
+- 拒绝：`BLOCK: <不超过20字的简短中文原因>`

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.7 → undefined_bot-3.3.0}/res/prompts/undefined.xml

@@ -131,6 +131,23 @@
 
         **关键点：每次消息处理都必须以 end 结束，这是维持对话流的核心机制。**
       </workflow>
+
+      <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 也可以直接用于 `<pic uid="..."/>`；当前会话临时图片和表情包库图片共用同一套 `uid` 语义
+        - 只能引用工具结果或上下文里明确给出的图片 UID，禁止臆造 UID
+        - 只有 `pic_*` 这类图片 UID 能放进 `<pic>`；普通文件 UID 不能放进去
+      </mixed_media_output>
     </message_sending_mechanism>
     
     <!-- 规则4: 对话结束机制 -->
@@ -300,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>
       
@@ -325,7 +336,7 @@
         </trigger>
         
         <trigger id="2">
-          <condition>别人之间的对话（两人或多人明确在交流）</condition>
+          <condition>别人之间的定向对话（两人明显在来回说，或多人里明显是在接别人而不是接你）</condition>
           <action>不要插话，即使话题你感兴趣</action>
         </trigger>
         
@@ -357,6 +368,11 @@
           <action>保持沉默</action>
         </trigger>
         
+        <trigger id="11">
+          <condition>你不能确定这条消息是不是在对你说，或不能确定当前对话是否对你开放</condition>
+          <action>默认不回复</action>
+        </trigger>
+        
         <trigger id="7">
           <condition>Null在与其他人对话（即使话题你感兴趣）</condition>
           <action>保持沉默，不要插话</action>
@@ -589,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>
@@ -667,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.7 → undefined_bot-3.3.0}/res/prompts/undefined_nagaagent.xml

@@ -131,6 +131,23 @@
 
         **关键点：每次消息处理都必须以 end 结束，这是维持对话流的核心机制。**
       </workflow>
+
+      <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 也可以直接用于 `<pic uid="..."/>`；当前会话临时图片和表情包库图片共用同一套 `uid` 语义
+        - 只能引用工具结果或上下文里明确给出的图片 UID，禁止臆造 UID
+        - 只有 `pic_*` 这类图片 UID 能放进 `<pic>`；普通文件 UID 不能放进去
+      </mixed_media_output>
     </message_sending_mechanism>
     
     <!-- 规则4: 对话结束机制 -->
@@ -306,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>
       
@@ -331,7 +342,7 @@
         </trigger>
         
         <trigger id="2">
-          <condition>别人之间的对话（两人或多人明确在交流）</condition>
+          <condition>别人之间的定向对话（两人明显在来回说，或多人里明显是在接别人而不是接你）</condition>
           <action>不要插话，即使话题你感兴趣</action>
         </trigger>
         
@@ -363,6 +374,11 @@
           <action>保持沉默</action>
         </trigger>
         
+        <trigger id="11">
+          <condition>你不能确定这条消息是不是在对你说，或不能确定当前对话是否对你开放</condition>
+          <action>默认不回复</action>
+        </trigger>
+        
         <trigger id="7">
           <condition>Null在与其他人对话（即使话题你感兴趣）</condition>
           <action>保持沉默，不要插话</action>
@@ -624,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>
@@ -704,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.7 → 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.7"
+__version__ = "3.3.0"