Undefined-bot 3.6.3__tar.gz → 3.6.5__tar.gz

{undefined_bot-3.6.3 → undefined_bot-3.6.5}/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.3 → undefined_bot-3.6.5}/CHANGELOG.md

@@ -1,3 +1,22 @@
+## 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 注入能力。
+
+- 新增 `[prompt.system_info]`：可按 OS、Runtime、主机名、CPU、内存、Swap、磁盘、网络、进程和 uptime 控制展示，采集失败时跳过单项，不影响 Prompt 构建。
+
+---
+
 ## v3.6.3 合并转发快照、附件 UID 分析与 Release 下载说明
 
 本版本聚焦合并转发在协议端不可二次读取时的可用性：收到消息时先把可访问的转发树按会话保存为本地快照，后续工具读取优先复用快照，避免内层转发过期或回源失败导致 AI 看不到内容。同时补齐文件分析 Agent 对内部附件 UID 的直接解析能力，并澄清 Release 产物的下载选择。

{undefined_bot-3.6.3 → undefined_bot-3.6.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: Undefined-bot
-Version: 3.6.3
+Version: 3.6.5
 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.3 → undefined_bot-3.6.5}/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
@@ -959,24 +998,80 @@ prefetch_tools = ["get_current_time"]
 # zh: 隐藏已预取的工具声明。
 # en: Hide prefetched tools from the model's tool list.
 prefetch_tools_hide = true
+
+# zh: Prompt 系统信息注入。总开关默认关闭；开启后各子项默认展示，可逐项关闭。
+# en: Prompt system information injection. The master switch is disabled by default; enabled sub-items are shown by default and can be disabled individually.
+[prompt.system_info]
+# zh: 是否把当前运行主机的系统信息注入提示词。默认关闭，避免升级后自动暴露本机信息给模型。
+# en: Inject current host system information into prompts. Disabled by default to avoid exposing host data automatically after upgrades.
+enabled = false
+# zh: 展示操作系统、版本、release 和架构。
+# en: Show operating system, version, release, and architecture.
+show_os = true
+# zh: 展示 Python 与 Undefined 版本。
+# en: Show Python and Undefined versions.
+show_runtime = true
+# zh: 展示主机名。
+# en: Show hostname.
+show_host = true
+# zh: 展示 CPU 型号与物理/逻辑核心数。
+# en: Show CPU model and physical/logical core counts.
+show_cpu = true
+# zh: 展示当前 CPU 总使用率。
+# en: Show current total CPU usage.
+show_cpu_usage = true
+# zh: 展示内存总量、已用量与占用率。
+# en: Show memory total, used amount, and usage percentage.
+show_memory = true
+# zh: 展示 Swap 总量、已用量与占用率。
+# en: Show swap total, used amount, and usage percentage.
+show_swap = true
+# zh: 展示可见磁盘分区、文件系统、容量与占用率。
+# en: Show visible disk partitions, filesystem, capacity, and usage percentage.
+show_disks = true
+# zh: 展示非回环网卡地址与网络收发累计。涉及 IP 信息，公网或共享部署可关闭。
+# en: Show non-loopback network addresses and cumulative network I/O. Disable this on public or shared deployments if IP exposure is undesirable.
+show_network = true
+# zh: 展示 Bot 进程 PID、启动时间、运行时长、RSS 与进程 CPU 占用。
+# en: Show bot process PID, start time, uptime, RSS, and process CPU usage.
+show_process = true
+# zh: 展示系统启动时间与系统运行时长。
+# en: Show system boot time and uptime.
+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 = ""
@@ -997,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
@@ -1030,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"
@@ -1082,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
@@ -1092,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
@@ -1129,6 +1236,9 @@ auto_extract_private_ids = []
 # 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
@@ -1154,6 +1264,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
@@ -1277,6 +1390,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.
@@ -1456,6 +1572,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.3 → undefined_bot-3.6.5}/pyproject.toml

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

{undefined_bot-3.6.3 → undefined_bot-3.6.5}/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__ = "3.6.3"
+__version__: str = "3.6.5"
 
 # symbol -> (module_path, attribute_name)；首次访问时才 importlib 加载
 _LAZY_IMPORTS: dict[str, tuple[str, str]] = {

{undefined_bot-3.6.3 → undefined_bot-3.6.5}/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.3 → undefined_bot-3.6.5}/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: