Undefined-bot 3.6.4__tar.gz → 3.6.6__tar.gz

{undefined_bot-3.6.4 → undefined_bot-3.6.6}/ARCHITECTURE.md

@@ -114,7 +114,7 @@ graph TB
         
         subgraph IntelligentAgents["智能体 Agents (skills/agents/, 7个)"]
             A_Info["info_agent<br/>信息查询助手<br/>(18个工具)<br/>• weather_query<br/>• *hot 热搜<br/>• bilibili_*<br/>• arxiv_search<br/>• whois"]
-            A_Web["web_agent<br/>网络搜索助手<br/>(3个工具 + MCP)<br/>• web_search<br/>• crawl_webpage<br/>• Playwright MCP"]
+            A_Web["web_agent<br/>网络搜索助手<br/>(4个工具 + MCP)<br/>• grok_search<br/>• firecrawl_search<br/>• web_search<br/>• crawl_webpage<br/>• Playwright MCP"]
             A_File["file_analysis_agent<br/>文件分析助手<br/>• extract_* (PDF/Word/Excel/PPT)<br/>• describe_pdf_page<br/>• analyze_code<br/>• analyze_multimodal"]
             A_Naga["naga_code_analysis_agent<br/>NagaAgent 代码分析<br/>(7个工具)<br/>• read_file / glob<br/>• search_file_content"]
             A_Self["undefined_self_code_agent<br/>Undefined 自身代码查阅<br/>(4个工具)<br/>• read_file / list_directory<br/>• glob / search_file_content"]

{undefined_bot-3.6.4 → undefined_bot-3.6.6}/CHANGELOG.md

@@ -1,3 +1,25 @@
+## v3.6.6 抖音视频提取与媒体信息模式
+
+本版本把抖音视频纳入自动提取、工具调用和文件分析链路：可识别短链、长链与 aweme_id，下载并发送视频合并转发，也可只返回附件 UID 或元信息。同时补齐 B 站与 arXiv 工具的信息模式，并加固抖音真实视频地址探测。
+
+- 新增 Douyin 视频链路。新增 `douyin` 模块与 `douyin_video` 工具，支持抖音短链、`douyin.com/video/<id>` 和裸 aweme_id 解析，可按 `send` / `uid` / `info` 输出发送合并转发、注册附件 UID 或返回视频标题、作者、时长、简介等信息。
+- 接入抖音自动处理管线。普通消息命中抖音链接或 aweme_id 后，可按 `[douyin]` 配置自动下载并发送两节点合并转发；支持独立代理开关、时长与文件大小限制、清晰度探测顺序、群聊/私聊白名单和单条消息处理上限。
+- 加固抖音下载与真实视频探测。下载链路从 SSR share 页提取 `video.play_addr` token，再按清晰度探测 `aweme/v1/play/`；探测优先读取 `Content-Range` 总长度并按文件大小去重，ttid 获取失败时可回退直接请求 share 页，受限视频会返回更明确的过滤原因。
+- 扩展媒体工具信息输出。`bilibili_video` 与 `arxiv_paper` 新增 `output_mode=info`，可只获取视频或论文元信息而不发送/下载附件；`file_analysis_agent` 提示同步覆盖抖音、B 站和 arXiv 的 `uid` / `info` 使用方式。
+
+---
+
+## v3.6.5 Firecrawl 搜索、代理作用域与热更新连接修复
+
+本版本聚焦联网能力与出站配置治理：`web_agent` 新增 Firecrawl 搜索提供商和搜索优先级控制，代理配置从全局开关收敛为模型与功能段独立启用，并修复配置热更新时旧模型连接可能被提前关闭的问题。
+
+- 新增 Firecrawl 搜索。`web_agent` 可按 `[search].priority` 在 Grok、Firecrawl 与 SearXNG 间排序；未启用的搜索工具会从工具 schema 隐藏，Firecrawl 支持 API Key、base URL 与 keyless 模式。
+- 收敛代理配置。`[proxy]` 仅保存 `http_proxy` / `https_proxy`，是否走代理改由模型、搜索、附件、渲染、消息、Bilibili、arXiv、GitHub、Naga 和 API callback 等作用域的 `use_proxy` 独立控制。
+- 修复模型热更新连接生命周期。清理模型客户端缓存时会延迟关闭仍在使用的 HTTP client，避免流式、检索或并发请求在热更新期间被提前断开。
+- 同步配置解析、文档与测试覆盖。拆分模型配置 parser，补充 Firecrawl 开关兼容、代理环境变量映射、作用域代理与 LLM 代理回归测试。
+
+---
+
 ## v3.6.4 可选系统信息注入
 
 本版本新增了默认关闭的系统信息 Prompt 注入能力。

{undefined_bot-3.6.4 → undefined_bot-3.6.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: Undefined-bot
-Version: 3.6.4
+Version: 3.6.6
 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

{undefined_bot-3.6.4 → undefined_bot-3.6.6}/config.toml.example

@@ -77,6 +77,9 @@ token = ""
 # zh: 对话模型配置（主模型，处理每一条消息）。
 # en: Chat model config (the main model, processing each message).
 [models.chat]
+# zh: 是否让该模型请求使用 [proxy] 代理地址。默认关闭；模型池条目需在 entry 内单独配置。
+# en: Whether this model uses proxy addresses from [proxy]. Disabled by default; pool entries configure this per entry.
+use_proxy = false
 # zh: OpenAI-compatible 基址 URL，例如 https://api.openai.com/v1（legacy "/chat/completions" 已弃用但仍兼容）。
 # en: OpenAI-compatible base URL, e.g. https://api.openai.com/v1. Note: legacy "/chat/completions" is deprecated but still supported.
 api_url = ""
@@ -152,13 +155,16 @@ enabled = false
 # zh: 分配策略：default（用户指定）/ round_robin（轮询）/ random（随机）。
 # en: Strategy: default (user-specified) / round_robin / random.
 strategy = "default"
-# zh: 模型池列表（每项需填 model_name、api_url、api_key，其余字段可选，缺省继承主模型）。
-# en: Model pool entries (model_name, api_url, api_key required; others optional, inherit from primary).
+# zh: 模型池列表（每项需填 model_name、api_url、api_key；可选 use_proxy，默认 false；其余字段可选，缺省继承主模型）。
+# en: Model pool entries (model_name, api_url, api_key required; optional use_proxy defaults to false; other fields inherit from primary).
 models = []
 
 # zh: 视觉模型配置（用于图片描述和 OCR）。
 # en: Vision model config (image description and OCR).
 [models.vision]
+# zh: 是否让该模型请求使用 [proxy] 代理地址。默认关闭。
+# en: Whether this model uses proxy addresses from [proxy]. Disabled by default.
+use_proxy = false
 # zh: OpenAI-compatible 基址 URL，例如 https://api.openai.com/v1（legacy "/chat/completions" 已弃用但仍兼容）。
 # en: OpenAI-compatible base URL, e.g. https://api.openai.com/v1. Note: legacy "/chat/completions" is deprecated but still supported.
 api_url = ""
@@ -231,6 +237,9 @@ stream_enabled = false
 # zh: 是否启用安全模型检测与注入响应（推荐开启）。
 # en: Enable security-model detection and injection response (recommended).
 enabled = true
+# zh: 是否让该模型请求使用 [proxy] 代理地址。默认关闭。
+# en: Whether this model uses proxy addresses from [proxy]. Disabled by default.
+use_proxy = false
 # zh: OpenAI-compatible 基址 URL，例如 https://api.openai.com/v1（legacy "/chat/completions" 已弃用但仍兼容）。
 # en: OpenAI-compatible base URL, e.g. https://api.openai.com/v1. Note: legacy "/chat/completions" is deprecated but still supported.
 api_url = ""
@@ -302,6 +311,9 @@ stream_enabled = false
 # en: Naga outbound moderation model config (used only before Naga sends messages through the Runtime API).
 # en: Optional; falls back to [models.security] when omitted.
 [models.naga]
+# zh: 是否让该模型请求使用 [proxy] 代理地址。默认关闭；即使回退 [models.security] endpoint，也使用本开关。
+# en: Whether this model uses proxy addresses from [proxy]. Disabled by default; this switch is used even when falling back to [models.security].
+use_proxy = false
 # zh: OpenAI-compatible 基址 URL，例如 https://api.openai.com/v1（legacy "/chat/completions" 已弃用但仍兼容）。
 # en: OpenAI-compatible base URL, e.g. https://api.openai.com/v1. Note: legacy "/chat/completions" is deprecated but still supported.
 api_url = ""
@@ -368,6 +380,9 @@ stream_enabled = false
 # zh: Agent 模型配置（用于执行 agents）。
 # en: Agent model config (used to run agents).
 [models.agent]
+# zh: 是否让该模型请求使用 [proxy] 代理地址。默认关闭；模型池条目需在 entry 内单独配置。
+# en: Whether this model uses proxy addresses from [proxy]. Disabled by default; pool entries configure this per entry.
+use_proxy = false
 # zh: OpenAI-compatible 基址 URL，例如 https://api.openai.com/v1（legacy "/chat/completions" 已弃用但仍兼容）。
 # en: OpenAI-compatible base URL, e.g. https://api.openai.com/v1. Note: legacy "/chat/completions" is deprecated but still supported.
 api_url = ""
@@ -443,13 +458,16 @@ enabled = false
 # zh: 分配策略：default（用户指定）/ round_robin（轮询）/ random（随机）。
 # en: Strategy: default (user-specified) / round_robin / random.
 strategy = "default"
-# zh: Agent 模型池列表（每项需填 model_name、api_url、api_key，其余字段可选，缺省继承主模型）。
-# en: Agent model pool entries (model_name, api_url, api_key required; others optional, inherit from primary).
+# zh: Agent 模型池列表（每项需填 model_name、api_url、api_key；可选 use_proxy，默认 false；其余字段可选，缺省继承主模型）。
+# en: Agent model pool entries (model_name, api_url, api_key required; optional use_proxy defaults to false; other fields inherit from primary).
 models = []
 
 # zh: 史官模型配置（认知记忆后台改写用，未配置时回退到 agent 模型）。
 # en: Historian model config (for cognitive memory rewriting, falls back to agent model if unset).
 [models.historian]
+# zh: 是否让该模型请求使用 [proxy] 代理地址。默认关闭；即使回退 [models.agent] endpoint，也使用本开关。
+# en: Whether this model uses proxy addresses from [proxy]. Disabled by default; this switch is used even when falling back to [models.agent].
+use_proxy = false
 # zh: OpenAI-compatible 基址 URL，例如 https://api.openai.com/v1（legacy "/chat/completions" 已弃用但仍兼容）。
 # en: OpenAI-compatible base URL, e.g. https://api.openai.com/v1. Note: legacy "/chat/completions" is deprecated but still supported.
 api_url = ""
@@ -519,6 +537,9 @@ stream_enabled = false
 # zh: 消息总结模型配置（/summary /sum 与 SummaryService 专用；未配置时回退到 agent 模型；主 AI 调用 summary_agent 不使用此段配置）。
 # en: Message-summary model config (used by /summary, /sum, and SummaryService; falls back to the agent model when unset; summary_agent invoked by the main AI does not use this section).
 [models.summary]
+# zh: 是否让该模型请求使用 [proxy] 代理地址。默认关闭；即使回退 [models.agent] endpoint，也使用本开关。
+# en: Whether this model uses proxy addresses from [proxy]. Disabled by default; this switch is used even when falling back to [models.agent].
+use_proxy = false
 # zh: OpenAI-compatible 基址 URL，例如 https://api.openai.com/v1（legacy "/chat/completions" 已弃用但仍兼容）。
 # en: OpenAI-compatible base URL, e.g. https://api.openai.com/v1. Note: legacy "/chat/completions" is deprecated but still supported.
 api_url = ""
@@ -588,6 +609,9 @@ stream_enabled = false
 # zh: Grok 搜索模型配置（仅供 web_agent 内的 grok_search 使用；固定走 chat.completions，不支持 tool call 兼容字段）。
 # en: Grok search model config (used only by grok_search inside web_agent; always uses chat completions and does not expose tool-call compatibility fields).
 [models.grok]
+# zh: 是否让该模型请求使用 [proxy] 代理地址。默认关闭。
+# en: Whether this model uses proxy addresses from [proxy]. Disabled by default.
+use_proxy = false
 # zh: OpenAI-compatible 基址 URL，例如 https://api.example.com/v1。
 # en: OpenAI-compatible base URL, e.g. https://api.example.com/v1.
 api_url = ""
@@ -639,6 +663,9 @@ stream_enabled = false
 # zh: 嵌入模型配置（知识库语义检索使用）。
 # en: Embedding model config (used by knowledge semantic retrieval).
 [models.embedding]
+# zh: 是否让该模型请求使用 [proxy] 代理地址。默认关闭。
+# en: Whether this model uses proxy addresses from [proxy]. Disabled by default.
+use_proxy = false
 # zh: OpenAI-compatible 基址 URL，例如 https://api.openai.com/v1。
 # en: OpenAI-compatible base URL, e.g. https://api.openai.com/v1.
 api_url = ""
@@ -672,6 +699,9 @@ document_instruction = ""
 # zh: 重排模型配置（知识库二阶段检索使用）。
 # en: Rerank model config (used in second-stage knowledge retrieval).
 [models.rerank]
+# zh: 是否让该模型请求使用 [proxy] 代理地址。默认关闭。
+# en: Whether this model uses proxy addresses from [proxy]. Disabled by default.
+use_proxy = false
 # zh: OpenAI-compatible 基址 URL，例如 https://api.openai.com/v1。
 # en: OpenAI-compatible base URL, e.g. https://api.openai.com/v1.
 api_url = ""
@@ -699,6 +729,9 @@ query_instruction = ""
 # zh: 生图模型配置（用于 image_gen.provider="models" 时调用 OpenAI 兼容的图片生成接口）。
 # en: Image generation model config (used when image_gen.provider="models" to call OpenAI-compatible image generation API).
 [models.image_gen]
+# zh: 是否让该图片生成模型请求使用 [proxy] 代理地址。默认关闭。
+# en: Whether this image-generation model uses proxy addresses from [proxy]. Disabled by default.
+use_proxy = false
 # zh: OpenAI-compatible 基址 URL，例如 https://api.openai.com/v1（最终请求路径为 /v1/images/generations）。
 # en: OpenAI-compatible base URL, e.g. https://api.openai.com/v1 (final request path is /v1/images/generations).
 api_url = ""
@@ -716,6 +749,9 @@ model_name = ""
 # 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: 是否让该图片编辑模型请求使用 [proxy] 代理地址。默认关闭。
+# en: Whether this image-edit model uses proxy addresses from [proxy]. Disabled by default.
+use_proxy = false
 # 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 = ""
@@ -910,6 +946,9 @@ group_analysis_limit = 500
 # zh: 附件缓存配置。
 # en: Attachment cache settings.
 [attachments]
+# zh: 是否让远程附件下载/回源使用 [proxy] 代理地址。默认关闭。
+# en: Whether remote attachment downloads/backfills use proxy addresses from [proxy]. Disabled by default.
+use_proxy = false
 # 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
@@ -1002,21 +1041,37 @@ show_uptime = true
 # zh: 搜索服务配置。
 # en: Search service config.
 [search]
+# zh: 是否让联网搜索和通用信息类 HTTP 工具使用 [proxy] 代理地址。默认关闭。
+# en: Whether search and generic information HTTP tools use proxy addresses from [proxy]. Disabled by default.
+use_proxy = false
+# zh: web_agent 搜索工具优先级。关闭的工具会从可用工具中隐藏；开启后模型按该顺序优先考虑，但不会被代码硬性路由。
+# en: Search tool priority for web_agent. Disabled tools are hidden; enabled tools are preferred in this order by prompt guidance, not hard routing.
+priority = ["grok_search", "firecrawl_search", "web_search"]
 # zh: SearxNG 搜索服务地址，例如 http://127.0.0.1:8849。
 # en: SearxNG service URL, e.g. http://127.0.0.1:8849.
 searxng_url = ""
-# zh: 是否在 web_agent 中启用 grok_search。启用后该工具会优先于 web_search 暴露给模型。
-# en: Enable grok_search in web_agent. When enabled, this tool is exposed with higher priority than web_search.
+# zh: 是否在 web_agent 中启用 grok_search。关闭时该工具会从 web_agent 工具列表中隐藏。
+# en: Enable grok_search in web_agent. When disabled, this tool is hidden from the web_agent tool list.
 grok_search_enabled = false
+# zh: 是否在 web_agent 中启用 firecrawl_search。默认关闭；关闭时该工具会隐藏。
+# en: Enable firecrawl_search in web_agent. Disabled by default; when disabled, this tool is hidden.
+firecrawl_search_enabled = false
+
+# zh: Firecrawl 搜索服务配置。
+# en: Firecrawl search service config.
+[search.firecrawl]
+# zh: Firecrawl API Key。为空时使用 Firecrawl keyless 搜索；填写后会发送 Authorization: Bearer。
+# en: Firecrawl API key. Leave empty for Firecrawl keyless search; when set, Authorization: Bearer is sent.
+api_key = ""
+# zh: Firecrawl API 基础地址。
+# en: Firecrawl API base URL.
+base_url = "https://api.firecrawl.dev"
 
 # zh: 代理设置（可选）。
 # en: Proxy settings (optional).
 [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: 这里只配置代理地址；是否使用代理由各功能段的 use_proxy 单独控制，默认均关闭。
+# en: This section only defines proxy addresses; each feature's use_proxy controls usage independently, disabled by default.
 # 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).
 http_proxy = ""
@@ -1037,6 +1092,9 @@ request_retries = 0
 # zh: HTML/Markdown 图片渲染配置。
 # en: HTML/Markdown image rendering settings.
 [render]
+# zh: 是否让 crawl4ai、HTML/Markdown/LaTeX 渲染中的远程资源使用 [proxy] 代理地址。默认关闭。
+# en: Whether crawl4ai and remote resources in HTML/Markdown/LaTeX rendering use proxy addresses from [proxy]. Disabled by default.
+use_proxy = false
 # 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
@@ -1070,6 +1128,9 @@ xingzhige_base_url = "https://api.xingzhige.com"
 # zh: 生图工具配置。
 # en: Image generation tool config.
 [image_gen]
+# zh: 是否让生图工具自身的第三方 HTTP 请求和图片下载使用 [proxy] 代理地址。默认关闭；模型接口另看 [models.image_gen]/[models.image_edit]。
+# en: Whether the image tool's third-party HTTP calls and image downloads use proxy addresses from [proxy]. Disabled by default; model APIs use [models.image_gen]/[models.image_edit].
+use_proxy = false
 # zh: 生图 provider："xingzhige"（免费星之阁 API）或 "models"（使用 [models.image_gen] 配置的 OpenAI 兼容接口）。
 # en: Image generation provider: "xingzhige" (free Xingzhige API) or "models" (OpenAI-compatible via [models.image_gen]).
 provider = "xingzhige"
@@ -1122,6 +1183,9 @@ config_path = "config/mcp.json"
 # zh: 消息工具配置。
 # en: Message tool settings.
 [messages]
+# zh: 是否让消息工具的 URL 文件下载使用 [proxy] 代理地址。默认关闭。
+# en: Whether message-tool URL file downloads use proxy addresses from [proxy]. Disabled by default.
+use_proxy = false
 # zh: messages.send_text_file 单文件文本发送大小上限（KB）。默认 512KB（0.5MB）。
 # en: Size limit for messages.send_text_file single-text-file uploads (KB). Default 512KB (0.5MB).
 send_text_file_max_size_kb = 512
@@ -1132,6 +1196,9 @@ send_url_file_max_size_mb = 100
 # zh: Bilibili 视频自动提取配置。
 # en: Bilibili video auto-extraction settings.
 [bilibili]
+# zh: 是否让 Bilibili API、短链解析、弹幕和视频流请求使用 [proxy] 代理地址。默认关闭。
+# en: Whether Bilibili API, short-link, danmaku, and video stream requests use proxy addresses from [proxy]. Disabled by default.
+use_proxy = false
 # zh: 是否启用自动提取（检测到B站视频链接/BV号时自动下载并发送）。
 # en: Enable auto-extraction (auto-download and send when Bilibili video links/BV IDs are detected).
 auto_extract_enabled = false
@@ -1166,9 +1233,40 @@ auto_extract_group_ids = []
 # en: Private chat allowlist for auto-extraction (empty = follow global access.allowed_private_ids).
 auto_extract_private_ids = []
 
+# zh: 抖音视频自动提取配置。
+# en: Douyin video auto-extraction settings.
+[douyin]
+# zh: 是否让抖音短链解析、share 页、ttid 注册和视频流请求使用 [proxy] 代理地址。默认关闭。
+# en: Whether Douyin short-link, share page, ttid registration, and video stream requests use proxy addresses from [proxy]. Disabled by default.
+use_proxy = false
+# zh: 是否启用自动提取（检测到抖音短链、长链或 aweme_id 时自动下载并发送）。
+# en: Enable auto-extraction (auto-download and send when Douyin short links, long links, or aweme IDs are detected).
+auto_extract_enabled = false
+# zh: 最大视频时长（秒），超过则不下载，仅发送信息卡片。0=不限。
+# en: Max video duration (seconds); exceeding this sends info card only. 0=unlimited.
+max_duration = 600
+# zh: 最大文件大小（MB），超过则仅发送信息卡片。0=不限。
+# en: Max file size (MB); exceeding this sends info card only. 0=unlimited.
+max_file_size = 100
+# zh: 清晰度探测顺序。游客 share 页无 bit_rate 时会按该列表探测 play 端点，并按文件大小去重。
+# en: Quality probing order. Visitor share pages lack bit_rate, so play endpoints are probed in this order and deduplicated by file size.
+prefer_ratios = ["1080p", "720p", "540p", "360p"]
+# 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: 单条消息最多自动处理几个抖音视频。<=0 回退 3，>10 截断到 10。
+# en: Max number of Douyin videos to auto-process from one message. <=0 falls back to 3, >10 is capped to 10.
+auto_extract_max_items = 3
+
 # zh: arXiv 论文自动提取配置。
 # en: arXiv paper auto-extraction settings.
 [arxiv]
+# zh: 是否让 arXiv API 和 PDF 下载使用 [proxy] 代理地址。默认关闭。
+# en: Whether arXiv API and PDF downloads use proxy addresses from [proxy]. Disabled by default.
+use_proxy = false
 # zh: 是否启用自动提取（检测到 arXiv 链接 / arXiv:ID / 带 arxiv 关键词的新式编号时自动发送论文信息并尽力附带 PDF）。
 # en: Enable auto-extraction (auto-send paper info and best-effort PDF when arXiv links / arXiv:ID / keyword-scoped new-style IDs are detected).
 auto_extract_enabled = false
@@ -1194,6 +1292,9 @@ summary_preview_chars = 1000
 # zh: GitHub 仓库自动提取配置（仅获取 public 仓库信息）。
 # en: GitHub repository auto-extraction settings (public repositories only).
 [github]
+# zh: 是否让 GitHub API 和仓库卡片渲染中的远程资源使用 [proxy] 代理地址。默认关闭。
+# en: Whether GitHub API and remote resources in repo-card rendering use proxy addresses from [proxy]. Disabled by default.
+use_proxy = false
 # 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
@@ -1317,6 +1418,9 @@ tool_invoke_timeout = 120
 # zh: 回调请求超时（秒）。
 # en: Callback request timeout in seconds.
 tool_invoke_callback_timeout = 10
+# zh: 是否让工具调用 API 的外部 callback URL 使用 [proxy] 代理地址。默认关闭；不影响 WebUI/Runtime 本机桥接。
+# en: Whether external callback URLs for the tool invoke API use proxy addresses from [proxy]. Disabled by default; does not affect WebUI/Runtime loopback calls.
+tool_invoke_callback_use_proxy = false
 
 # zh: 认知记忆系统配置。启用后需配置 [models.embedding]，其余参数均有合理默认值。
 # en: Cognitive memory system. Requires [models.embedding] when enabled. All other params have sensible defaults.
@@ -1496,6 +1600,9 @@ rerank_top_k = 20
 # en: To get NagaAgent answering without external callbacks, only enable nagaagent_mode_enabled.
 # en: ⚠️ Advanced feature for NagaAgent integration. Not recommended for regular users.
 [naga]
+# zh: 是否让 Naga 外部网关 HTTP 请求使用 [proxy] 代理地址。默认关闭。
+# en: Whether Naga external-gateway HTTP requests use proxy addresses from [proxy]. Disabled by default.
+use_proxy = false
 # zh: 是否启用外部网关集成（/naga bind/unbind、远端绑定回调、消息发送、解绑 API）。
 # zh: 需同时开启 [features].nagaagent_mode_enabled 才生效。
 # en: Enable external gateway integration (/naga bind/unbind, bind callback, message send, unbind API).

{undefined_bot-3.6.4 → undefined_bot-3.6.6}/pyproject.toml

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

{undefined_bot-3.6.4 → undefined_bot-3.6.6}/src/Undefined/__init__.py

@@ -24,7 +24,7 @@ if TYPE_CHECKING:
     from .skills.registry import BaseRegistry as BaseRegistry
     from .skills.tools import ToolRegistry as ToolRegistry
 
-__version__: str = "3.6.4"
+__version__: str = "3.6.6"
 
 # symbol -> (module_path, attribute_name)；首次访问时才 importlib 加载
 _LAZY_IMPORTS: dict[str, tuple[str, str]] = {

{undefined_bot-3.6.4 → undefined_bot-3.6.6}/src/Undefined/ai/client/ask_loop.py

@@ -16,6 +16,7 @@ from Undefined.ai.transports.openai_transport import RESPONSES_OUTPUT_ITEMS_KEY
 from Undefined.ai.tooling import END_CO_CALL_REJECT_CONTENT
 from Undefined.context import RequestContext
 from Undefined.render import render_html_to_image, render_markdown_to_html
+from Undefined.skills.http_config import get_request_proxy
 from Undefined.services.message_summary_fetch import fetch_session_messages
 from Undefined.attachments import scope_from_context
 from Undefined.utils.io import write_bytes
@@ -216,7 +217,14 @@ class ClientAskLoopMixin(ClientQueueMixin):
         tool_context.setdefault("history_manager", history_manager)
         tool_context.setdefault("onebot_client", onebot_client)
         tool_context.setdefault("scheduler", scheduler)
-        tool_context.setdefault("render_html_to_image", render_html_to_image)
+
+        async def render_html_to_image_with_proxy(*args: Any, **kwargs: Any) -> Any:
+            kwargs.setdefault(
+                "proxy", get_request_proxy("https://example.com", "render")
+            )
+            return await render_html_to_image(*args, **kwargs)
+
+        tool_context.setdefault("render_html_to_image", render_html_to_image_with_proxy)
         tool_context.setdefault("render_markdown_to_html", render_markdown_to_html)
         tool_context.setdefault("send_image_callback", self._send_image_callback)
         tool_context.setdefault(

{undefined_bot-3.6.4 → undefined_bot-3.6.6}/src/Undefined/ai/client/setup.py

@@ -180,16 +180,19 @@ class ClientSetupMixin:
         self._end_summary_storage = end_summary_storage or EndSummaryStorage()
         self._crawl4ai_capabilities = get_crawl4ai_capabilities()
 
-        self._http_client = httpx.AsyncClient(timeout=480.0)
+        self._http_client = httpx.AsyncClient(timeout=480.0, trust_env=False)
         self._token_usage_storage = TokenUsageStorage()
-        self._requester = ModelRequester(self._http_client, self._token_usage_storage)
+        self._requester = ModelRequester(
+            None,
+            self._token_usage_storage,
+            config_getter=self._get_runtime_config,
+        )
         self._token_counter = TokenCounter()
         self._knowledge_manager: Any = None
         self._cognitive_service: Any = cognitive_service
         self._meme_service: Any = None
         if self.runtime_config is not None:
             self.attachment_registry = AttachmentRegistry(
-                http_client=self._http_client,
                 remote_download_max_bytes=_attachment_remote_download_max_bytes(
                     self.runtime_config
                 ),
@@ -200,9 +203,10 @@ class ClientSetupMixin:
                     self.runtime_config.attachment_url_reference_max_records
                 ),
                 url_max_length=self.runtime_config.attachment_url_max_length,
+                proxy_config=self.runtime_config,
             )
         else:
-            self.attachment_registry = AttachmentRegistry(http_client=self._http_client)
+            self.attachment_registry = AttachmentRegistry()
 
         self._send_private_message_callback: Optional[SendPrivateMessageCallback] = None
         self._send_image_callback: Optional[
@@ -324,7 +328,11 @@ class ClientSetupMixin:
             anthropic_skill_registry=self.anthropic_skill_registry,
             cognitive_service=self._cognitive_service,
         )
-        self._multimodal = MultimodalAnalyzer(self._requester, self.vision_config)
+        self._multimodal = MultimodalAnalyzer(
+            self._requester,
+            self.vision_config,
+            config_getter=self._get_runtime_config,
+        )
         self._rebuild_summary_service()
 
         async def init_mcp_async() -> None:
@@ -398,9 +406,14 @@ class ClientSetupMixin:
             except Exception as exc:
                 logger.warning("[清理] 刷新附件注册表失败: %s", exc)
 
-        if hasattr(self, "_http_client"):
-            logger.info("[清理] 正在关闭 AIClient HTTP 客户端...")
-            await self._http_client.aclose()
+        requester = getattr(self, "_requester", None)
+        if requester is not None and hasattr(requester, "aclose"):
+            logger.info("[清理] 正在关闭 AIClient 模型 HTTP 客户端...")
+            await requester.aclose()
+
+        http_client = getattr(self, "_http_client", None)
+        if http_client is not None:
+            await http_client.aclose()
 
         logger.info("[清理] AIClient 已关闭")
 
@@ -574,7 +587,13 @@ class ClientSetupMixin:
         self.vision_config = vision_config
         self.agent_config = agent_config
         self.runtime_config = runtime_config
-        self._multimodal = MultimodalAnalyzer(self._requester, self.vision_config)
+        if hasattr(self._requester, "clear_client_cache"):
+            self._requester.clear_client_cache()
+        self._multimodal = MultimodalAnalyzer(
+            self._requester,
+            self.vision_config,
+            config_getter=self._get_runtime_config,
+        )
         self._rebuild_summary_service()
         self.apply_attachment_config(runtime_config)
         logger.info(
@@ -587,6 +606,8 @@ class ClientSetupMixin:
     def apply_runtime_config(self, runtime_config: Config) -> None:
         """应用不需要重建模型客户端的运行时配置。"""
         self.runtime_config = runtime_config
+        if hasattr(self._requester, "clear_client_cache"):
+            self._requester.clear_client_cache()
         self._rebuild_summary_service()
         logger.info("[配置] AI 运行时配置已热更新")
 
@@ -612,6 +633,7 @@ class ClientSetupMixin:
                 runtime_config.attachment_url_reference_max_records
             ),
             url_max_length=runtime_config.attachment_url_max_length,
+            proxy_config=runtime_config,
         )
 
     def count_tokens(self, text: str) -> int: