Undefined-bot 3.3.2__tar.gz → 3.3.3__tar.gz

{undefined_bot-3.3.2 → undefined_bot-3.3.3}/ARCHITECTURE.md

@@ -33,12 +33,18 @@ graph TB
             BilibiliSender["sender.py<br/>视频发送<br/>• 视频消息 • 降级信息卡片"]
         end
 
+        subgraph GitHubModule["GitHub 模块 (github/)"]
+            GitHubParser["parser.py<br/>仓库标识解析<br/>• URL • SSH • owner/repo • JSON"]
+            GitHubClient["client.py<br/>public API 获取<br/>• 仓库信息 • contributors"]
+            GitHubSender["sender.py<br/>图片卡片发送<br/>• 头像 • 简介 • 统计"]
+        end
+
         subgraph SecurityLayer["安全防线 (services/)"]
             SecurityService["SecurityService<br/>安全服务<br/>• 注入攻击检测<br/>• 速率限制<br/>[security.py]"]
             InjectionAgent["InjectionResponseAgent<br/>注入响应生成<br/>[injection_response_agent.py]"]
         end
         
-        CommandDispatcher["CommandDispatcher<br/>命令分发器<br/>• /help /stats /lsadmin<br/>• /addadmin /rmadmin<br/>• /bugfix /lsfaq<br/>[services/command.py]"]
+        CommandDispatcher["CommandDispatcher<br/>命令分发器<br/>• /help /stats /lsadmin<br/>• /addadmin /rmadmin<br/>• /bugfix /faq<br/>[services/command.py]"]
         
         subgraph QueueSystem["车站-列车 队列系统 (services/)"]
             AICoordinator["AICoordinator<br/>AI 协调器<br/>• Prompt 构建<br/>• 队列管理<br/>• 回复执行<br/>[ai_coordinator.py]"]
@@ -95,7 +101,7 @@ graph TB
             TS_Messages["messages.*<br/>• send_message<br/>• get_recent_messages<br/>• get_forward_msg"]
             TS_Memory["memory.*<br/>• add / delete<br/>• list / update"]
             TS_Contacts["contacts.*<br/>• query_friends<br/>• query_groups"]
-            TS_GroupAnalysis["group_analysis.*<br/>• analyze_member_messages<br/>• analyze_join_statistics<br/>• analyze_new_member_activity"]
+            TS_GroupAnalysis["group_analysis.*<br/>• member_structure<br/>• message_mix<br/>• member_activity<br/>• activity_trend<br/>• inactive_risk<br/>• member_messages<br/>• join_statistics<br/>• new_member_activity"]
             TS_Notices["notices.*<br/>• list / get / stats"]
             TS_Render["render.*<br/>• render_html<br/>• render_latex<br/>• render_markdown"]
             TS_Scheduler["scheduler.*<br/>• create_schedule_task<br/>• delete_schedule_task<br/>• list_schedule_tasks"]
@@ -116,7 +122,7 @@ graph TB
         subgraph CommandsLayer["平台指令 (skills/commands/)"]
             Cmd_Core["核心指令<br/>• help • stats"]
             Cmd_Admin["管理指令<br/>• addadmin<br/>• rmadmin • lsadmin"]
-            Cmd_FAQ["FAQ 指令<br/>• lsfaq • viewfaq<br/>• searchfaq • delfaq"]
+            Cmd_FAQ["FAQ 指令<br/>• faq (ls/view/search/del)"]
             Cmd_Fun["娱乐指令<br/>• bugfix"]
         end
         
@@ -208,13 +214,16 @@ graph TB
     SecurityService -.->|"API 调用"| LLM_API
     SecurityService -->|"注入攻击"| InjectionAgent
 
-    MessageHandler -->|"1.5 Bilibili检测"| BilibiliParser
+    MessageHandler -->|"2. 指令?"| CommandDispatcher
+    CommandDispatcher -->|"执行结果经统一发送层写历史"| OneBotClient
+    MessageHandler -->|"2.5 非命令自动管线"| BilibiliParser
     BilibiliParser -->|"BV号"| BilibiliDownloader
     BilibiliDownloader -->|"视频文件"| BilibiliSender
     BilibiliSender -->|"发送"| OneBotClient
-
-    MessageHandler -->|"2. 指令?"| CommandDispatcher
-    CommandDispatcher -->|"执行结果"| OneBotClient
+    MessageHandler -->|"2.6 非命令自动管线"| GitHubParser
+    GitHubParser -->|"仓库ID"| GitHubClient
+    GitHubClient -->|"public仓库信息"| GitHubSender
+    GitHubSender -->|"发送图片卡片"| OneBotClient
     
     MessageHandler -->|"3. 自动回复"| AICoordinator
     AICoordinator -->|"创建上下文"| RequestContext
@@ -353,21 +362,22 @@ sequenceDiagram
     alt 检测到注入
         SS->>MH: 拦截并响应
     else 安全
-        %% Bilibili 自动提取
-        alt 消息包含B站链接/BV号
-            MH->>MH: extract_bilibili_ids()
-            MH->>MH: download_video()
-            MH->>OH: 发送视频/信息卡片
-            OH->>OB: WebSocket API
-            OB->>U: 显示视频
-        else 非B站内容
-            %% 指令处理
-            MH->>CD: 解析斜杠命令
+        %% 指令处理
+        MH->>CD: 解析斜杠命令
         alt 是命令
             CD->>ST: FAQ/管理员操作
+            CD->>ST: 写入命令输出历史
             CD-->>OB: 返回结果
             OB->>U: 发送响应
-        else 是AI消息
+        else 非命令消息
+            MH->>MH: 并行检测 skills/auto_pipeline 管线
+            opt 命中自动提取管线
+                MH->>MH: 并行处理全部命中的自动提取
+                MH->>OH: 发送视频/卡片/PDF
+                OH->>OB: WebSocket API
+                OB->>U: 显示自动提取结果
+                MH->>ST: 写入自动提取结果历史和附件 UID
+            end
             %% AI处理流程
             MH->>AC: handle_auto_reply()
             
@@ -810,6 +820,7 @@ description: 从 PDF 文件中提取文本和表格，填写表单。当用户
 | **认知记忆** | `cognitive.enabled`, `cognitive.query.*`, `models.embedding.*` | 事件检索、时间衰减加权、侧写与后台史官 |
 | **Bilibili** | `bilibili.auto_extract_enabled`, `bilibili.cookie`, `bilibili.prefer_quality` | B站视频自动提取与下载 |
 | **arXiv** | `arxiv.auto_extract_enabled`, `arxiv.max_file_size`, `arxiv.auto_extract_max_items` | arXiv 论文自动提取、搜索与 PDF 发送 |
+| **GitHub** | `github.auto_extract_enabled`, `github.request_timeout_seconds`, `github.auto_extract_max_items` | GitHub public 仓库自动提取与图片卡片发送 |
 | **思考链** | `*.thinking_enabled` | 思维链支持 |
 | **思维链兼容** | `*.thinking_tool_call_compat` | 思维链 + 工具调用兼容 |
 | **WebUI** | `webui.url`, `webui.port`, `webui.password` | 配置控制台 |
@@ -820,7 +831,8 @@ description: 从 PDF 文件中提取文本和表格，填写表单。当用户
 
 1. **外部实体层**：用户、管理员、OneBot 协议端 (NapCat/Lagrange.Core)、大模型 API 服务商
 2. **核心入口层**：main.py 启动入口、配置管理器 (config/loader.py)、热更新应用器 (config/hot_reload.py)、OneBotClient (onebot.py)、RequestContext (context.py)、Runtime API Server (api/app.py → api/routes/ 路由子模块)
-3. **消息处理层**：MessageHandler (handlers.py)、SecurityService (security.py)、CommandDispatcher (services/command.py)、AICoordinator (ai_coordinator.py)、QueueManager (queue_manager.py)、Bilibili 自动提取 (bilibili/)
+3. **消息处理层**：MessageHandler (handlers.py)、SecurityService (security.py)、CommandDispatcher (services/command.py)、AICoordinator (ai_coordinator.py)、QueueManager (queue_manager.py)、自动处理管线 (skills/auto_pipeline/)、Bilibili/arXiv/GitHub 解析与发送模块
+    自动提取由 `AutoPipelineRegistry` 并行检测、并行处理全部命中的管线；发送结果写入历史后继续进入 AI 自动回复。
 4. **AI 核心能力层**：AIClient (client.py)、PromptBuilder (prompts.py)、ModelRequester (llm.py)、ToolManager (tooling.py)、MultimodalAnalyzer (multimodal.py)、SummaryService (summaries.py)、TokenCounter (tokens.py)
 5. **存储与上下文层**：MessageHistoryManager (utils/history.py, 10000条限制)、MemoryStorage (memory.py, 置顶备忘录, 500条上限)、EndSummaryStorage、CognitiveService + JobQueue + HistorianWorker + VectorStore + ProfileStorage、MemeService + MemeWorker + MemeStore + MemeVectorStore (表情包库)、FAQStorage、ScheduledTaskStorage、TokenUsageStorage (自动归档)
 6. **技能系统层**：ToolRegistry (registry.py)、AgentRegistry、6个 Agents、11类 Toolsets

{undefined_bot-3.3.2 → undefined_bot-3.3.3}/CHANGELOG.md

@@ -1,3 +1,43 @@
+## v3.3.3 命令推断、自动处理管线与统一附件上下文
+
+本版本重点优化了命令系统的交互体验、AI 工具边界和消息前置处理链路。新增 GitHub 链接自动卡片生成，并将 Bilibili、arXiv、GitHub 等自动提取迁入 `skills/auto_pipeline` 热重载管线，使预处理结果能写入历史并进入后续 AI 回复上下文。同时，帮助说明与用户侧写默认改为图片输出，系统剥离独立群聊分析工具集，全面推行统一附件标签，并为远程附件加入可配置下载上限和 URL 引用降级，完善底层用户识别机制与模型高级透传配置。
+
+- 优化命令系统：支持声明式子命令与用户意图推断。如 `/faq` 合并了列表、阅读、搜索与删除入口，可自然理解省略部分参数后的交互意图；旧 `/lsfaq`、`/viewfaq`、`/searchfaq`、`/delfaq` 入口已移除。
+- 改善长文本呈现：`/help` 与 `/profile` 默认渲染为图片分发，避免长内容刷屏；保留 `-t` 参数用于强制返回纯文本，`/profile` 仍支持 `-f` 合并转发模式。
+- 新增自动处理管线：在 `skills/auto_pipeline` 下提供 `config.json + handler.py` 结构，支持热重载、并行检测和并行处理多个命中结果；首批内置 Bilibili、arXiv、GitHub 三条管线，且斜杠命令优先级高于自动管线，命中命令后不会触发后续自动提取或 AI 自动回复。
+- 优化自动管线启动加载：首次目录扫描、配置读取和 handler 导入改为异步线程加载，避免启动初始化阶段阻塞事件循环。
+- 修复自动管线兜底初始化：未显式执行异步初始化的兼容路径会按未初始化处理并主动加载管线，避免静默跳过自动提取。
+- 新增 GitHub 自动卡片：支持在对话中检测 GitHub 链接及 `owner/repo` 标识，自动生成包含项目简介、Stars、Forks、贡献者等信息的卡片；支持独立开关与白名单控制，并裁剪渲染截图底部空白。
+- 打通命令与自动提取历史上下文：斜杠命令输入、命令输出、自动管线发送的信息、图片、文件和视频摘要都会写入消息历史；统一发送层会自动把本地 CQ 图片、视频、语音和上传文件登记为当前会话可见的 `pic_*` / `file_*` UID，并记录群合并转发摘要，后续 AI 回复可直接看到这些结果并用 `<attachment uid="..."/>` 引用附件。
+- 新增远程附件下载上限：`[attachments].remote_download_max_size_mb` 控制外部远程附件缓存大小，超过上限或配置为 `0` 时只登记 URL 引用，避免大文件导致磁盘占用和消息处理延迟激增。
+- 修复远程附件 URL 引用：下载禁用或超限时始终保留可访问 URL，原始 OneBot 文件标识或 QQ 来源作为追溯信息保存，避免后续 `<attachment>` 渲染成不可发送的图片地址。
+- 优化历史落盘延迟：消息先同步写入内存历史供后续流程读取，磁盘 JSON 持久化改为按会话后台串行合并写入，减少大群历史文件全量保存拖慢复读和自动处理前置链路的情况。
+- 修复历史异步保存失败保留：磁盘写入失败会向调度层传播并保留待保存快照，等待后续保存触发，避免队列合并过程中丢失已弹出的历史数据。
+- 独立群聊分析工具：将群成员构成与水群分析从基础群工具中完全剥离，划归专属 `group_analysis.*` 集合，避免日常查询与复杂分析导致的 AI 工具边界混淆。
+- 统一多模态附件标签：全系统推行 `<attachment uid="..."/>` 作为标准分发标签（继续兼容旧 `<pic>`），配套统一了表情包提示词，新增 `group.get_avatar` 头像专用工具。
+- 优化表情包回复体验：提示词要求“文字 + 表情包”场景先发送必要文字，再在后续轮次检索和发送表情包，避免表情包检索拖慢首条回复。
+- 稳定用户识别体系：底层认知逻辑固定以 QQ 号为唯一绑定标识，辅以 `group.get_member_info(brief=true)` 快速拉取当前昵称，有效解决群友频繁更换名片引发的识别错乱。
+- 增强模型连接配置：新增 `stream_enabled` 独立控制推流行为，增加 `request_params` 以支持向不同厂商端点透传特殊参数。
+- 完善流式 usage 统计：Chat Completions 启用上游流式请求时会自动附带 `stream_options.include_usage=true`，避免流式路径丢失 token 用量。
+- 收窄流式回退范围：仅在明确的流式参数不兼容错误或 SDK 未实现时降级到非流式请求，鉴权、限流、网络和超时错误不再重复重发。
+- 细化子命令限流：声明式子命令按父命令与子命令分别记录冷却时间，避免同一复合命令下不同操作互相挤占。
+- 修复私聊模型池命令回归：`/compare`、`/pk` 和完整的 `选<number>` 模型选择消息会先交给模型池处理，普通私聊内容不会因模型池开启而被提前拦截。
+- 改进命令参数解析：`[@QQ(含空格昵称)]` 会作为一个整体参数归一化，且超管可通过 dispatcher 层的管理员权限检查。
+- 修正 `/naga` 子命令分发：handler 直接使用分发层解析出的子命令，并兼容改写后的 `[subcmd, *args]` 参数格式，避免把子命令名和 `naga_id` 相互误判。
+- 收窄模型热更新范围：`summary`、`historian`、`grok` 专用模型变化只刷新 AI 运行时配置，不再重建聊天、视觉和 Agent 模型对象。
+- 修复配置热更新细节：`skills.hot_reload` 变化会同步刷新 Anthropic Skills 注册表；模型池条目会保留 `reasoning_effort_style`；配置模板补齐 `models.summary.stream_enabled`。
+- 修复总结模型选择：配置了 `models.summary` 时，聊天总结、摘要合并和标题生成会使用专用 summary 模型配置；仅热更新 summary 模型时也会重建摘要服务，避免继续沿用旧模型。
+- 提升基础工程质量：对命令推断、群分析、附件处理、配置参数等进行了全面的单元与集成测试补强，总测试用例数提升至 1500+ 项。
+- 修复图片渲染超时：重构 `render.py` 为浏览器实例单例复用模式，并引入可配置的并发信号量；共享渲染上下文会在页面创建失败时正确释放，防止低资源设备多任务抢占导致截图超时或资源残留。
+- 改进渲染热更新：`render.browser_max_concurrency` 运行时变化会在当前渲染任务空闲后重建信号量，且不依赖 `asyncio.Semaphore` 私有属性；本地 LaTeX mathtext 渲染改用 Matplotlib 公共 `math_to_image` 接口。
+- 改进 GitHub 卡片稳定性：裸仓库识别改为结合上下文与仓库名形态判断，降低普通路径误触发；渲染头像等外部资源会复用代理配置，发送后清理临时 PNG 缓存。
+- 收紧子命令推断：声明式 inference 正则需要完整匹配参数，避免只匹配前缀时误选子命令。
+- 修复 Playwright 启动失败清理：浏览器 launch 失败时会停止已启动的 driver，避免反复失败时残留资源。
+- 改进 LaTeX 渲染稳定性：常见公式优先使用本地 `matplotlib` mathtext 渲染，复杂内容再回退共享浏览器实例中的 MathJax + Playwright，避免简单公式依赖外部网络或系统 TeX 环境。
+- 修复流式输出一致性：Chat Completions 与 Responses 流式聚合结果不再裁剪模型输出前后空白，与非流式路径保持一致，避免代码块缩进或刻意留白被改写。
+
+---
+
 ## v3.3.2 架构重构、假@检测与认知侧写增强
 
 围绕核心架构进行了大规模重构与功能增强：Runtime API 拆分为路由子模块、配置系统模块化拆分、新增假@检测机制与 /profile 多输出模式。同步引入复读机制全面升级（可配置阈值与冷却）、消息预处理并行化、WebUI 多项交互功能，以及 arXiv 论文分析 Agent 和安全计算器工具。测试覆盖从约 800 提升至 1438+。

{undefined_bot-3.3.2 → undefined_bot-3.3.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: Undefined-bot
-Version: 3.3.2
+Version: 3.3.3
 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,7 +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="..."/>`。详见 [表情包库说明](docs/memes.md)。
+- **全局表情包库**：收到图片后可异步判定是否为表情包，通过两阶段 LLM 管线生成纯文本描述与标签，支持关键词检索、语义检索和混合检索，并可直接按统一图片 `uid` 发送或插入 `<attachment uid="..."/>`。详见 [表情包库说明](docs/memes.md)。
 - **访问控制（群/私聊）**：支持 `access.mode` 三种模式（`off` / `blacklist` / `allowlist`）和群/私聊黑白名单；可按策略限制收发范围，避免误触发与误投递。详见 [docs/access-control.md](docs/access-control.md)。
 - **版本变更可查询**：仓库根目录维护 `CHANGELOG.md`，并提供 `/changelog` 命令在运行时查看最近版本和单版本摘要。
 - **并行工具执行**：无论是主 AI 还是子 Agent，均支持 `asyncio` 并发工具调用，大幅提升多任务处理速度（如同时读取多个文件或搜索多个关键词）。
@@ -117,6 +117,8 @@ Description-Content-Type: text/markdown
 - **Anthropic Skills**：支持 Anthropic Agent Skills（SKILL.md 格式），遵循 agentskills.io 开放标准，提供领域知识注入能力。
 - **Bilibili 视频提取**：自动检测消息中的 B 站视频链接/BV 号/小程序分享，下载 1080p 视频并通过 QQ 发送；同时提供 AI 工具调用入口。
 - **arXiv 论文提取与搜索**：自动检测消息中的 arXiv 链接/标识并发送论文信息与 PDF；同时提供 `arxiv_paper` 发送工具和 `arxiv_search` 检索工具。
+- **GitHub 仓库卡片**：自动检测 GitHub 仓库链接或 `owner/repo` 仓库 ID，获取 public 仓库信息并发送简洁图片卡片，展示头像、简介、stars、forks、issues、contributors 等概览。
+- **自动处理管线**：Bilibili、arXiv、GitHub 等自动提取统一运行在 `skills/auto_pipeline` 中，斜杠命令优先级更高；命令输入/输出会写入历史，非命令消息会并行检测和处理命中管线，结果通过统一发送层写入历史并登记附件 UID 后再进入 AI 回复。远程大附件超过 `[attachments].remote_download_max_size_mb` 时只登记 URL 引用，避免无界下载和缓存膨胀。
 - **思维链支持**：支持开启思维链，提升复杂逻辑推理能力。
 - **高并发架构**：基于 `asyncio` 全异步设计，支持多队列消息处理与工具并发执行，轻松应对高并发场景。
 - **异步安全 I/O**：统一 IO 层通过线程池 + 跨平台文件锁（Linux/macOS `flock`，Windows `msvcrt`）+ 原子写入（`os.replace`）保证并发写入不损坏、且不阻塞主事件循环。

{undefined_bot-3.3.2 → undefined_bot-3.3.3}/README.md

@@ -43,7 +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="..."/>`。详见 [表情包库说明](docs/memes.md)。
+- **全局表情包库**：收到图片后可异步判定是否为表情包，通过两阶段 LLM 管线生成纯文本描述与标签，支持关键词检索、语义检索和混合检索，并可直接按统一图片 `uid` 发送或插入 `<attachment uid="..."/>`。详见 [表情包库说明](docs/memes.md)。
 - **访问控制（群/私聊）**：支持 `access.mode` 三种模式（`off` / `blacklist` / `allowlist`）和群/私聊黑白名单；可按策略限制收发范围，避免误触发与误投递。详见 [docs/access-control.md](docs/access-control.md)。
 - **版本变更可查询**：仓库根目录维护 `CHANGELOG.md`，并提供 `/changelog` 命令在运行时查看最近版本和单版本摘要。
 - **并行工具执行**：无论是主 AI 还是子 Agent，均支持 `asyncio` 并发工具调用，大幅提升多任务处理速度（如同时读取多个文件或搜索多个关键词）。
@@ -57,6 +57,8 @@
 - **Anthropic Skills**：支持 Anthropic Agent Skills（SKILL.md 格式），遵循 agentskills.io 开放标准，提供领域知识注入能力。
 - **Bilibili 视频提取**：自动检测消息中的 B 站视频链接/BV 号/小程序分享，下载 1080p 视频并通过 QQ 发送；同时提供 AI 工具调用入口。
 - **arXiv 论文提取与搜索**：自动检测消息中的 arXiv 链接/标识并发送论文信息与 PDF；同时提供 `arxiv_paper` 发送工具和 `arxiv_search` 检索工具。
+- **GitHub 仓库卡片**：自动检测 GitHub 仓库链接或 `owner/repo` 仓库 ID，获取 public 仓库信息并发送简洁图片卡片，展示头像、简介、stars、forks、issues、contributors 等概览。
+- **自动处理管线**：Bilibili、arXiv、GitHub 等自动提取统一运行在 `skills/auto_pipeline` 中，斜杠命令优先级更高；命令输入/输出会写入历史，非命令消息会并行检测和处理命中管线，结果通过统一发送层写入历史并登记附件 UID 后再进入 AI 回复。远程大附件超过 `[attachments].remote_download_max_size_mb` 时只登记 URL 引用，避免无界下载和缓存膨胀。
 - **思维链支持**：支持开启思维链，提升复杂逻辑推理能力。
 - **高并发架构**：基于 `asyncio` 全异步设计，支持多队列消息处理与工具并发执行，轻松应对高并发场景。
 - **异步安全 I/O**：统一 IO 层通过线程池 + 跨平台文件锁（Linux/macOS `flock`，Windows `msvcrt`）+ 原子写入（`os.replace`）保证并发写入不损坏、且不阻塞主事件循环。

{undefined_bot-3.3.2 → undefined_bot-3.3.3}/config.toml.example

@@ -122,6 +122,9 @@ responses_force_stateless_replay = false
 # zh: 是否启用自动 prompt_cache_key（建议开启，以提高相似请求的缓存命中率）。
 # en: Enable automatic prompt_cache_key generation (recommended).
 prompt_cache_enabled = true
+# zh: 是否对上游模型 API 启用流式请求。
+# en: Enable streaming requests to the upstream model API.
+stream_enabled = false
 
 # zh: 额外请求体参数（可选），可用于 temperature 或供应商私有参数。
 # en: Extra request-body params (optional), e.g. temperature or vendor-specific fields.
@@ -189,6 +192,9 @@ responses_tool_choice_compat = false
 # 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: 是否对上游模型 API 启用流式请求。
+# en: Enable streaming requests to the upstream model API.
+stream_enabled = false
 
 # zh: 额外请求体参数（可选），可用于 temperature 或供应商私有参数。
 # en: Extra request-body params (optional), e.g. temperature or vendor-specific fields.
@@ -246,6 +252,9 @@ responses_tool_choice_compat = false
 # 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: 是否对上游模型 API 启用流式请求。
+# en: Enable streaming requests to the upstream model API.
+stream_enabled = false
 
 # zh: 额外请求体参数（可选），可用于 temperature 或供应商私有参数。
 # en: Extra request-body params (optional), e.g. temperature or vendor-specific fields.
@@ -301,6 +310,9 @@ responses_tool_choice_compat = false
 # zh: Responses API 续轮强制降级。
 # en: Responses API force stateless replay.
 responses_force_stateless_replay = false
+# zh: 是否对上游模型 API 启用流式请求。
+# en: Enable streaming requests to the upstream model API.
+stream_enabled = false
 
 # zh: 额外请求体参数（可选），可用于 temperature 或供应商私有参数。
 # en: Extra request-body params (optional), e.g. temperature or vendor-specific fields.
@@ -355,6 +367,9 @@ responses_tool_choice_compat = false
 # 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: 是否对上游模型 API 启用流式请求。
+# en: Enable streaming requests to the upstream model API.
+stream_enabled = false
 
 # zh: 额外请求体参数（可选），可用于 temperature 或供应商私有参数。
 # en: Extra request-body params (optional), e.g. temperature or vendor-specific fields.
@@ -422,6 +437,9 @@ responses_tool_choice_compat = false
 # 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: 是否对上游模型 API 启用流式请求。
+# en: Enable streaming requests to the upstream model API.
+stream_enabled = false
 
 # zh: 额外请求体参数（可选），可用于 temperature 或供应商私有参数。
 # en: Extra request-body params (optional), e.g. temperature or vendor-specific fields.
@@ -476,6 +494,9 @@ responses_tool_choice_compat = false
 # 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: 是否对上游模型 API 启用流式请求。
+# en: Enable streaming requests to the upstream model API.
+stream_enabled = false
 
 # zh: 额外请求体参数（可选），可用于 temperature 或供应商私有参数。
 # en: Extra request-body params (optional), e.g. temperature or vendor-specific fields.
@@ -520,6 +541,9 @@ reasoning_effort_style = "openai"
 # zh: 是否启用自动 prompt_cache_key（建议开启，以提高相似请求的缓存命中率）。
 # en: Enable automatic prompt_cache_key generation (recommended).
 prompt_cache_enabled = true
+# zh: 是否对上游模型 API 启用流式请求。
+# en: Enable streaming requests to the upstream model API.
+stream_enabled = false
 
 # zh: 额外请求体参数（可选），可用于 temperature 或供应商私有参数。
 # en: Extra request-body params (optional), e.g. temperature or vendor-specific fields.
@@ -754,6 +778,13 @@ onebot_fetch_limit = 10000
 # en: Max messages/members returned by group analysis tools.
 group_analysis_limit = 500
 
+# zh: 附件缓存配置。
+# en: Attachment cache settings.
+[attachments]
+# zh: 远程附件自动下载并缓存的最大大小（MB）。超过上限或设为 0 时只保留 URL 引用，不下载文件内容。
+# en: Max remote attachment size (MB) to download into cache. Above the limit, or 0, keeps only a URL reference.
+remote_download_max_size_mb = 25
+
 # zh: Skills 热重载配置（可选）。
 # en: Skills hot reload settings (optional).
 [skills]
@@ -799,6 +830,8 @@ grok_search_enabled = false
 [proxy]
 # zh: 是否使用代理。
 # en: Whether to use proxy.
+# zh: 作用于 GitHub/arXiv 自动提取等走统一 HTTP 客户端的联网请求；关闭后也不会再读取代理环境变量。
+# en: Applies to GitHub/arXiv auto extraction and other shared HTTP-client requests; when disabled, proxy env vars are ignored.
 use_proxy = true
 # zh: 例如 http://127.0.0.1:7890（也可使用环境变量 "HTTP_PROXY"）。
 # en: e.g. http://127.0.0.1:7890 (or use the "HTTP_PROXY" environment variable).
@@ -817,6 +850,13 @@ request_timeout_seconds = 30.0
 # en: Default retry count (0-5).
 request_retries = 0
 
+# zh: HTML/Markdown 图片渲染配置。
+# en: HTML/Markdown image rendering settings.
+[render]
+# zh: 渲染浏览器最大同时开启数量。0 表示自动：Linux 默认 1，其它平台默认 2。
+# en: Max concurrent render browser pages. 0 = auto: Linux defaults to 1, other platforms default to 2.
+browser_max_concurrency = 0
+
 # zh: 第三方 API 基础地址（便于自定义镜像或私有网关）。
 # en: Third-party API base URLs (for mirrors or private gateways).
 [api_endpoints]
@@ -942,6 +982,25 @@ author_preview_limit = 20
 # en: Max summary preview characters in paper info. <=0 falls back to 1000.
 summary_preview_chars = 1000
 
+# zh: GitHub 仓库自动提取配置（仅获取 public 仓库信息）。
+# en: GitHub repository auto-extraction settings (public repositories only).
+[github]
+# zh: 是否启用自动提取（检测到 GitHub 仓库链接或 owner/repo 仓库 ID 时自动发送图片卡片）。
+# en: Enable auto-extraction (auto-send an image card when GitHub repository links or owner/repo IDs are detected).
+auto_extract_enabled = false
+# zh: GitHub API 请求超时（秒）。<=0 回退 10，>60 截断到 60。
+# en: GitHub API request timeout (seconds). <=0 falls back to 10, >60 is clamped to 60.
+request_timeout_seconds = 10.0
+# zh: 自动提取功能的群聊白名单（空=跟随全局 access.allowed_group_ids）。
+# en: Group allowlist for auto-extraction (empty = follow global access.allowed_group_ids).
+auto_extract_group_ids = []
+# zh: 自动提取功能的私聊白名单（空=跟随全局 access.allowed_private_ids）。
+# en: Private chat allowlist for auto-extraction (empty = follow global access.allowed_private_ids).
+auto_extract_private_ids = []
+# zh: 单条消息最多自动处理几个 GitHub 仓库。<=0 回退 3，>10 截断到 10。
+# en: Max number of GitHub repositories to auto-process from one message. <=0 falls back to 3, >10 is clamped to 10.
+auto_extract_max_items = 3
+
 # zh: Code Delivery Agent 配置（代码交付 Agent，在 Docker 容器中编写代码并打包上传）。
 # en: Code Delivery Agent settings (writes code in Docker containers and delivers packaged results).
 [code_delivery]

{undefined_bot-3.3.2 → undefined_bot-3.3.3}/pyproject.toml

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

{undefined_bot-3.3.2 → undefined_bot-3.3.3}/res/prompts/describe_meme_image.txt

@@ -18,7 +18,8 @@
   - 情绪/语气：无语、震惊、委屈、嘲讽、得意、阴阳怪气、崩溃、开心、嫌弃
   - 动作/状态：翻白眼、鼓掌、捂脸、叹气、偷笑、流汗、发呆、摊手
   - 使用场景：敷衍回应、上班吐槽、群聊附和、阴阳怪气、看乐子、尴尬收场
-- 如果图中文字本身就是表情包语义的一部分，可以概括它表达的意思，但不要逐字转录。
+  - 图中文字/OCR：图片内写的关键字句、台词、配文、对话气泡内容等
+- 图中如果有文字（配字、台词、对话气泡、水印等），必须把文字内容融入描述，这是搜索命中的重要依据。短文字尽量原文写入描述，长文字可以概括核心关键词句，但不要完全忽略图中文字。
 - `description` 不能只写情绪和用途，也必须写出图片内容本身：谁/什么在画面里、表情如何、动作如何、画面是什么类型。
 - 如果画面里有明显视觉特征，也要写出来，例如：
   - 主体是谁或是什么
@@ -52,8 +53,8 @@
 - 不要堆重复词，例如 `无语`、`很无语`、`超级无语` 这种不要同时出现。
 
 额外限制：
-- 不要输出 OCR。
-- 不要逐字抄录图中文字。
+- 不要逐字抄录大段长文，但短句、关键词、配字应尽量原文写入描述。
+- 不要输出独立的 OCR 字段或逐行转录，文字内容应自然融入 description。
 - 不要输出 Markdown，不要输出额外解释。
 - 你必须且只能调用 `submit_meme_description`。
 - 如果收到的是一张网格图（多帧拼接）或多张图片，说明原图是动图/GIF：描述应涵盖动图的动态变化过程和整体语义，不要只描述单帧；可以在 tags 里加上 `动图` 标签。
@@ -71,9 +72,13 @@
   `tags`: [`猫猫`, `嫌弃`, `无语`, `翻白眼`]
 - `description`: `真人聊天截图里尴尬陪笑又有点敷衍的表情包`
   `tags`: [`真人`, `聊天截图`, `尴尬`, `敷衍`]
+- `description`: `熊猫头配字“行吧”无奈妥协表情包`
+  `tags`: [`熊猫头`, `无奈`, `行吧`, `配字`]
+- `description`: `猫猫捂脸配字“我裂开了”崩溃反应图`
+  `tags`: [`猫猫`, `崩溃`, `我裂开了`, `捂脸`]
 
 差的例子：
 - `description`: `一张表情包`
 - `description`: `一个猫的图片`
-- `description`: `图片上写了几句话`
+- `description`: `图片上写了字`（只提有字但不写具体内容）
 - `description`: `表达无语`

{undefined_bot-3.3.2 → undefined_bot-3.3.3}/res/prompts/undefined.xml

@@ -132,15 +132,30 @@
         **关键点：每次消息处理都必须以 end 结束，这是维持对话流的核心机制。**
       </workflow>
 
+      <auto_pipeline_context priority="P0">
+        **自动处理管线结果：**
+        在你收到当前消息前，系统可能已经并行处理了当前消息中的 Bilibili、arXiv、GitHub 等自动提取内容。
+        这些预处理输出会紧邻当前消息写入历史，可能包含 Bot 发送的信息卡片、图片、文件、视频摘要或附件 UID。
+        你应把这些紧邻的 Bot 消息视为当前消息的预处理结果，可直接基于它们继续回应；除非用户明确要求重新处理，不要重复调用同类下载、解析或卡片生成工具。
+      </auto_pipeline_context>
+
+      <command_history_context priority="P0">
+        **斜杠命令历史：**
+        斜杠命令优先于自动处理管线；命中命令后，本轮不会继续进入自动提取或 AI 自动回复。
+        用户发出的命令消息和 Bot 发送的命令结果会写入消息历史；后续对话中看到这些相邻的 Bot 消息时，应把它们当作已经执行过的命令结果，不要无故重复执行同一命令。
+      </command_history_context>
+
       <mixed_media_output priority="P0">
+        <!-- 表情包检索可能较慢；文字 + 表情包场景先发必要文字，再后置检索和发送表情包。 -->
         **图文混排规则：**
-        - 如果你已经决定要回复，并且表情包能让表达更像真人，默认先尝试表情包，而不是先写文字
+        - 如果你已经决定要回复，并且只靠表情包就能完成表达，默认先尝试表情包，而不是先写文字
+        - 如果本轮既需要文字发言又想配表情包，先调用 `send_message` 发出必要文字；`memes.search_memes` 和 `memes.send_meme_by_uid` 放到后续响应轮次再做，因为表情包检索可能拖慢首条回复体验
         - 如果要发送独立表情包，先用 `memes.search_memes` 找到合适的图片 `uid`，再用 `memes.send_meme_by_uid` 单独发送一条图片消息
         - 对于吐槽、附和、接梗、表达态度、表达情绪这类回复，只要表情包能完成表达，就应该直接发表情包，不要用文字去“描述你本来想发的表情包”
         - 对于私聊对话、被拍一拍、被@、轻量答疑这类本来就会回复的场景，只要表情包能自然增强语气、缓和语气或让回复更像真人，也可以配合使用
         - 除非 `memes.search_memes` 没找到合适结果，或表情包会干扰信息传递，否则不要把本来适合发图的反应先写成一句话来代替发图
         - 表情包相关规则只决定“怎么回复”，不单独构成“该不该回复”的参与许可；是否回复仍以前面的回复触发逻辑为准
-        - 默认不要把表情包和正文写进同一条消息；需要补一句解释时，优先分成两条消息发送
+        - 默认不要把表情包和正文写进同一条消息；需要补一句解释时，优先分成两条消息发送；如果文字本身是必要回复，先发文字，再延后检索和发送表情包
         - 推荐使用统一标签 `<attachment uid="xxx"/>` 引用任何附件（图片或文件），系统根据 UID 前缀自动处理：
           - `pic_*` UID → 内嵌为图片（等效于旧 `<pic>` 语法）
           - `file_*` UID → 作为独立文件消息在文字之后发出
@@ -148,6 +163,7 @@
         - `<attachment uid="..."/>` 是推荐的统一语法，适用于所有类型的附件
         - 可以图文混排，例如：`我给你介绍一下`\n`<attachment uid="pic_xxx"/>`\n`如图所示`
         - 文件附件在文字消息发出后作为独立文件消息依次发送，不会混排在文字中
+        - 有些远程大附件会只登记为 URL 引用，附件上下文会给出 `source_ref`/说明；这类 `file_*` 不一定有本地缓存，回复时应基于 URL 引用说明，不要假设一定能作为本地文件重新发送
         - 表情包库返回的图片 UID 也可以直接用于 `<attachment uid="..."/>`
         - 只能引用工具结果或上下文里明确给出的图片 UID，禁止臆造 UID
         - 不要把 `file_*` UID 放进 `<pic>` 标签（会报类型错误）
@@ -191,7 +207,7 @@
         每条一个要点，可以多条。宁可多提取，不要遗漏。**严格一条一个要点**，不要把多个信息塞进同一条——拆成多条分别写入。
         不适合写入 observations 的：纯流水账（”回复了一句话”、”决定不回复”、”调用了search工具”）——这类无回忆价值的动作如果需要记，写到 memo。
         **群聊场景下的积极观察**：即使你决定不回复，也应积极观察群聊动态，提取有价值的信息写入 observations。注意观察：话题趋势变化、成员关系互动、群聊氛围/事件、新成员发言特征等。宁可多记几条，也不要遗漏有潜在价值的信息。
-        格式要求：每条具体、绝对化（写明谁、什么时候、在哪里），避免代词和相对时间，不要复述已知记忆。
+        格式要求：每条具体、绝对化（写明谁、什么时候、在哪里），避免代词和相对时间，不要复述已知记忆。记录 observations 时必须包含 QQ 号，格式如："QQ号12345678（昵称张三）做了某事"——昵称会变但 QQ 号不变。
         若当前消息在转述第三方人物/群成员的信息，必须按原文实体记录（昵称/QQ号）；禁止默认改写成当前 sender。
         如果同一条内容已写入 observations，不要重复写入 memory.add。
       </end_tool_usage>
@@ -414,6 +430,7 @@
       <rule>只对最近的消息进行回复，已经回复过的不再重复回复</rule>
       <rule>充分利用上下文（历史消息、时间戳）进行推理</rule>
       <rule>在回复前，理解对话的连贯性和流向</rule>
+      <rule>识别和称呼用户时以 QQ 号（sender_id）为准，昵称可能随时变动。需要称呼用户时使用当前最新昵称（群名片优先，其次 QQ 昵称）。不确定最新昵称时，可调用 group.get_member_info 并设置 brief=true 快速查询。</rule>
       <rule>看清发言者名字/QQ号与对话对象，确认对方在明确和你讲话才回复</rule>
       <rule>如果之前你在讨论某个话题，回复时要自然延续</rule>
       <rule>如果别人在回应你的话，要做出相应反应</rule>
@@ -613,7 +630,7 @@
           <rule>只有在需要分析图片内容时才调用 file_analysis_agent（如报错截图/界面/文档/图片问题）</rule>
           <rule>当消息中出现“[图片: xxx]”占位符时，xxx 即为 file_id 或 URL，可直接作为 file_source 调用 file_analysis_agent</rule>
           <rule>未调用 file_analysis_agent 时，不要猜测图片内容；可以说明“我看不到图片内容，需要先分析”</rule>
-          <rule>即使已分析图片，也要再次判断是否需要发言；如果明显在和别人说或你拿不准是不是在对你说，默认不回复；若你已经决定回复，并且表情包不会干扰信息传递，先尝试 memes.search_memes 并使用独立表情包回应，默认由表情包承担主要表达，文字只作极短补充</rule>
+          <rule>即使已分析图片，也要再次判断是否需要发言；如果明显在和别人说或你拿不准是不是在对你说，默认不回复；若你已经决定回复，并且只靠表情包就能完成表达，可尝试 memes.search_memes 并使用独立表情包回应；若还需要文字发言，先 send_message 发送必要文字，再把表情包检索和发送放到后续轮次</rule>
           <rule>回复时不要描述图片内容，像正常人一样直接回应重点</rule>
           <rule>不要分析每条图片。图片分析有很大延迟，只有需要时才分析</rule>
         </guideline>

{undefined_bot-3.3.2 → undefined_bot-3.3.3}/res/prompts/undefined_nagaagent.xml

@@ -132,15 +132,30 @@
         **关键点：每次消息处理都必须以 end 结束，这是维持对话流的核心机制。**
       </workflow>
 
+      <auto_pipeline_context priority="P0">
+        **自动处理管线结果：**
+        在你收到当前消息前，系统可能已经并行处理了当前消息中的 Bilibili、arXiv、GitHub 等自动提取内容。
+        这些预处理输出会紧邻当前消息写入历史，可能包含 Bot 发送的信息卡片、图片、文件、视频摘要或附件 UID。
+        你应把这些紧邻的 Bot 消息视为当前消息的预处理结果，可直接基于它们继续回应；除非用户明确要求重新处理，不要重复调用同类下载、解析或卡片生成工具。
+      </auto_pipeline_context>
+
+      <command_history_context priority="P0">
+        **斜杠命令历史：**
+        斜杠命令优先于自动处理管线；命中命令后，本轮不会继续进入自动提取或 AI 自动回复。
+        用户发出的命令消息和 Bot 发送的命令结果会写入消息历史；后续对话中看到这些相邻的 Bot 消息时，应把它们当作已经执行过的命令结果，不要无故重复执行同一命令。
+      </command_history_context>
+
       <mixed_media_output priority="P0">
+        <!-- 表情包检索可能较慢；文字 + 表情包场景先发必要文字，再后置检索和发送表情包。 -->
         **图文混排规则：**
-        - 如果你已经决定要回复，并且表情包能让表达更像真人，默认先尝试表情包，而不是先写文字
+        - 如果你已经决定要回复，并且只靠表情包就能完成表达，默认先尝试表情包，而不是先写文字
+        - 如果本轮既需要文字发言又想配表情包，先调用 `send_message` 发出必要文字；`memes.search_memes` 和 `memes.send_meme_by_uid` 放到后续响应轮次再做，因为表情包检索可能拖慢首条回复体验
         - 如果要发送独立表情包，先用 `memes.search_memes` 找到合适的图片 `uid`，再用 `memes.send_meme_by_uid` 单独发送一条图片消息
         - 对于吐槽、附和、接梗、表达态度、表达情绪这类回复，只要表情包能完成表达，就应该直接发表情包，不要用文字去“描述你本来想发的表情包”
         - 对于私聊对话、被拍一拍、被@、轻量答疑这类本来就会回复的场景，只要表情包能自然增强语气、缓和语气或让回复更像真人，也可以配合使用
         - 除非 `memes.search_memes` 没找到合适结果，或表情包会干扰信息传递，否则不要把本来适合发图的反应先写成一句话来代替发图
         - 表情包相关规则只决定“怎么回复”，不单独构成“该不该回复”的参与许可；是否回复仍以前面的回复触发逻辑为准
-        - 默认不要把表情包和正文写进同一条消息；需要补一句解释时，优先分成两条消息发送
+        - 默认不要把表情包和正文写进同一条消息；需要补一句解释时，优先分成两条消息发送；如果文字本身是必要回复，先发文字，再延后检索和发送表情包
         - 推荐使用统一标签 `<attachment uid="xxx"/>` 引用任何附件（图片或文件），系统根据 UID 前缀自动处理：
           - `pic_*` UID → 内嵌为图片（等效于旧 `<pic>` 语法）
           - `file_*` UID → 作为独立文件消息在文字之后发出
@@ -148,6 +163,7 @@
         - `<attachment uid="..."/>` 是推荐的统一语法，适用于所有类型的附件
         - 可以图文混排，例如：`我给你介绍一下`\n`<attachment uid="pic_xxx"/>`\n`如图所示`
         - 文件附件在文字消息发出后作为独立文件消息依次发送，不会混排在文字中
+        - 有些远程大附件会只登记为 URL 引用，附件上下文会给出 `source_ref`/说明；这类 `file_*` 不一定有本地缓存，回复时应基于 URL 引用说明，不要假设一定能作为本地文件重新发送
         - 表情包库返回的图片 UID 也可以直接用于 `<attachment uid="..."/>`
         - 只能引用工具结果或上下文里明确给出的图片 UID，禁止臆造 UID
         - 不要把 `file_*` UID 放进 `<pic>` 标签（会报类型错误）
@@ -467,7 +483,7 @@
       <rule priority="P0">
         **启动前信息充足度闸门：**
         在决定启动任何业务工具或 Agent 前，只围绕最后一条消息判断四件事：
-        1. 当前任务对象是否明确
+        1. 当前任务对象是否明确（优先从上下文推断，推断不了或不确定时再追问）
         2. 目标产物 / 目标动作是否明确
         3. 会显著影响结果的关键参数是否已给出
         4. 是否仍存在会导致明显误做或重做的关键歧义
@@ -659,7 +675,7 @@
           <rule>只有在需要分析图片内容时才调用 file_analysis_agent（如报错截图/界面/文档/图片问题）</rule>
           <rule>当消息中出现“[图片: xxx]”占位符时，xxx 即为 file_id 或 URL，可直接作为 file_source 调用 file_analysis_agent</rule>
           <rule>未调用 file_analysis_agent 时，不要猜测图片内容；可以说明“我看不到图片内容，需要先分析”</rule>
-          <rule>即使已分析图片，也要再次判断是否需要发言；如果明显在和别人说或你拿不准是不是在对你说，默认不回复；若你已经决定回复，并且表情包不会干扰信息传递，先尝试 memes.search_memes 并使用独立表情包回应，默认由表情包承担主要表达，文字只作极短补充</rule>
+          <rule>即使已分析图片，也要再次判断是否需要发言；如果明显在和别人说或你拿不准是不是在对你说，默认不回复；若你已经决定回复，并且只靠表情包就能完成表达，可尝试 memes.search_memes 并使用独立表情包回应；若还需要文字发言，先 send_message 发送必要文字，再把表情包检索和发送放到后续轮次</rule>
           <rule>回复时不要描述图片内容，像正常人一样直接回应重点</rule>
           <rule>不要分析每条图片。图片分析有很大延迟，只有需要时才分析</rule>
         </guideline>

{undefined_bot-3.3.2 → undefined_bot-3.3.3}/src/Undefined/README.md

@@ -6,6 +6,7 @@
 - `ai/`：模型请求、提示词构建、工具调度、多模态与总结能力
 - `arxiv/`：arXiv 论文解析、元信息获取、PDF 下载与发送（自动触发 + AI 工具）
 - `bilibili/`：B 站视频解析、下载与发送（自动触发 + AI 工具）
+- `github/`：GitHub public 仓库链接/ID 解析、API 获取与图片卡片发送（自动触发）
 - `memes/`：全局表情包库、多模态解析管线与异步存储
 - `services/`：安全、命令、队列与协调服务
 - `skills/`：工具与智能体插件系统

{undefined_bot-3.3.2 → undefined_bot-3.3.3}/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.3.2"
+__version__ = "3.3.3"