Undefined-bot 3.13.0__tar.gz → 3.13.2__tar.gz

{undefined_bot-3.13.0 → undefined_bot-3.13.2}/CHANGELOG.md

@@ -1,3 +1,24 @@
+## v3.13.2 前端依赖安全更新
+
+本版本修复 Undefined Console 与 Undefined Chat 共同继承的 Nano ID 高危拒绝服务漏洞，并保持现有 Vite / PostCSS 依赖结构不变。
+
+- 将两套应用锁文件中的传递依赖 `nanoid` 从 3.3.16 更新至官方修复版本 3.3.18，修复自定义生成器在长度为零时可能无限循环的问题（[GHSA-2v37-7h3g-55p8](https://github.com/advisories/GHSA-2v37-7h3g-55p8)）。
+- 通过 PostCSS 现有语义版本范围正常解析修复版本，不新增顶层依赖或 npm override；Console 与 Chat 的 `npm audit` 均恢复为 0 项漏洞。
+- Python 包、Undefined Console、Undefined Chat、Tauri 清单及各锁文件版本统一更新至 3.13.2，并同步 Release 版本校验与完整质量检查。
+
+---
+
+## v3.13.1 GitHub 仓库卡片头像修复
+
+本版本修复 GitHub 仓库卡片在离线浏览器中无法加载仓库所有者头像的问题，并统一 GitHub 元数据与头像请求的代理语义；卡片继续保持离线渲染，不重新开放浏览器网络访问。
+
+- 仓库所有者头像改为在渲染前通过现有 HTTP 重试链路下载并编码为 Data URL，卡片 HTML 不再引用远程图片地址；下载失败时显示占位图，不再生成浏览器破图。
+- GitHub API、贡献者统计和头像下载统一使用 `proxy_scope="github"`，严格由 `[github].use_proxy` 决定直连或使用 `[proxy]` 地址，且不读取系统代理。
+- 收紧头像资源边界：仅接受 GitHub 官方头像域名的 HTTPS 地址、常见栅格图片类型和不超过 2 MiB 的响应，同时复核重定向后的最终地址。
+- 同步 README、配置模板与配置文档，并补充代理作用域、头像内联、不可信地址、非法媒体类型、大小上限和失败回退测试；Python 包、Undefined Console、Undefined Chat、Tauri 清单及各锁文件版本统一更新至 3.13.1。
+
+---
+
 ## v3.13.0 条件驱动的自动化工作流
 
 本版本将「定时任务」整体升级为条件驱动的「自动化 / Automations」工作流：消息与时间事件命中后按 DAG 执行工具、模板与 LLM 节点，可选择接管本轮 AI；WebUI 配套 Dify 式画布编辑器，旧定时任务数据在启动时自动迁移。

{undefined_bot-3.13.0 → undefined_bot-3.13.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: Undefined-bot
-Version: 3.13.0
+Version: 3.13.2
 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
@@ -156,7 +156,7 @@ Console 和 Chat 都需要连接到已经运行的 Undefined 服务。首次部
 - **Bilibili 视频提取与分析**：自动检测消息中的 B 站视频链接/BV 号/小程序分享，下载视频并通过 QQ 合并转发；`bilibili_video` 也可只返回附件 UID，供 `file_analysis_agent` 做视频内容分析。
 - **可选音乐工具集**：配置独立部署的 [lxmusic2api](https://github.com/69gg/lxmusic2api) 后，主 AI 可搜索歌曲/歌单、浏览热搜与排行榜、读取歌词/封面/评论、跨平台匹配并交付普通音频附件；完整 Track 通过任务内短引用流转，只暴露面向用户的高层 `music.*` 能力，不暴露下载作业生命周期接口。详见 [使用指南](docs/usage.md#音乐-music) 与 [配置说明](docs/configuration.md#4201-lxmusic2api-音乐服务)。
 - **arXiv 论文提取、搜索与分析**：自动检测消息中的 arXiv 链接/标识并发送论文信息与 PDF；`arxiv_paper` 也可只返回 PDF 附件 UID，供 `file_analysis_agent` 做文本提取或指定页视觉分析；`arxiv_search` 负责论文检索。
-- **GitHub 仓库卡片**：自动检测 GitHub 仓库链接或 `owner/repo` 仓库 ID，获取 public 仓库信息并发送简洁图片卡片，展示头像、简介、stars、forks、issues、contributors 等概览。
+- **GitHub 仓库卡片**：自动检测 GitHub 仓库链接或 `owner/repo` 仓库 ID，获取 public 仓库信息并发送简洁图片卡片，展示头像、简介、stars、forks、issues、contributors 等概览；API 与头像下载统一遵循 `[github].use_proxy`，头像以内联资源进入离线渲染器。
 - **自动处理管线**：Bilibili、arXiv、GitHub 等自动提取统一运行在 `skills/pipelines` 中，斜杠命令优先级更高；命令输入/输出会写入历史，非命令消息会并行检测和处理命中管线，结果通过统一发送层写入历史并登记附件 UID 后再进入 AI 回复。远程大附件超过 `[attachments].remote_download_max_size_mb` 时只登记 URL 引用，避免无界下载和缓存膨胀。
 - **同 sender 短时消息合并**：默认开启。连续发的多条消息会合并到同一轮 AI 调用，AI 一次看到全部意图自行识别"独立请求/修正/打断"；告别"画猫→改成狗"的重复触发与回复打架。主提示词按 batcher 的"当前输入批次"语义适配，关闭该功能可能导致连续补充/修正消息与提示词不匹配，需要单独适配。可选投机预发送让用户停顿时 LLM 提前开跑、新消息可在未发出回复前取消，进一步压低响应延迟。详见 [docs/message-batching.md](docs/message-batching.md)。
 - **思维链支持**：支持开启思维链，提升复杂逻辑推理能力。

{undefined_bot-3.13.0 → undefined_bot-3.13.2}/README.md

@@ -92,7 +92,7 @@ Console 和 Chat 都需要连接到已经运行的 Undefined 服务。首次部
 - **Bilibili 视频提取与分析**：自动检测消息中的 B 站视频链接/BV 号/小程序分享，下载视频并通过 QQ 合并转发；`bilibili_video` 也可只返回附件 UID，供 `file_analysis_agent` 做视频内容分析。
 - **可选音乐工具集**：配置独立部署的 [lxmusic2api](https://github.com/69gg/lxmusic2api) 后，主 AI 可搜索歌曲/歌单、浏览热搜与排行榜、读取歌词/封面/评论、跨平台匹配并交付普通音频附件；完整 Track 通过任务内短引用流转，只暴露面向用户的高层 `music.*` 能力，不暴露下载作业生命周期接口。详见 [使用指南](docs/usage.md#音乐-music) 与 [配置说明](docs/configuration.md#4201-lxmusic2api-音乐服务)。
 - **arXiv 论文提取、搜索与分析**：自动检测消息中的 arXiv 链接/标识并发送论文信息与 PDF；`arxiv_paper` 也可只返回 PDF 附件 UID，供 `file_analysis_agent` 做文本提取或指定页视觉分析；`arxiv_search` 负责论文检索。
-- **GitHub 仓库卡片**：自动检测 GitHub 仓库链接或 `owner/repo` 仓库 ID，获取 public 仓库信息并发送简洁图片卡片，展示头像、简介、stars、forks、issues、contributors 等概览。
+- **GitHub 仓库卡片**：自动检测 GitHub 仓库链接或 `owner/repo` 仓库 ID，获取 public 仓库信息并发送简洁图片卡片，展示头像、简介、stars、forks、issues、contributors 等概览；API 与头像下载统一遵循 `[github].use_proxy`，头像以内联资源进入离线渲染器。
 - **自动处理管线**：Bilibili、arXiv、GitHub 等自动提取统一运行在 `skills/pipelines` 中，斜杠命令优先级更高；命令输入/输出会写入历史，非命令消息会并行检测和处理命中管线，结果通过统一发送层写入历史并登记附件 UID 后再进入 AI 回复。远程大附件超过 `[attachments].remote_download_max_size_mb` 时只登记 URL 引用，避免无界下载和缓存膨胀。
 - **同 sender 短时消息合并**：默认开启。连续发的多条消息会合并到同一轮 AI 调用，AI 一次看到全部意图自行识别"独立请求/修正/打断"；告别"画猫→改成狗"的重复触发与回复打架。主提示词按 batcher 的"当前输入批次"语义适配，关闭该功能可能导致连续补充/修正消息与提示词不匹配，需要单独适配。可选投机预发送让用户停顿时 LLM 提前开跑、新消息可在未发出回复前取消，进一步压低响应延迟。详见 [docs/message-batching.md](docs/message-batching.md)。
 - **思维链支持**：支持开启思维链，提升复杂逻辑推理能力。

{undefined_bot-3.13.0 → undefined_bot-3.13.2}/config.toml.example

@@ -1377,8 +1377,8 @@ 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.
+# zh: 是否让 GitHub API 和仓库所有者头像下载使用 [proxy] 代理地址。默认关闭；卡片浏览器保持离线。
+# en: Whether GitHub API and repository-owner avatar downloads use proxy addresses from [proxy]. Disabled by default; card rendering stays offline.
 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).

{undefined_bot-3.13.0 → undefined_bot-3.13.2}/pyproject.toml

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

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

{undefined_bot-3.13.0 → undefined_bot-3.13.2}/src/Undefined/github/client.py

@@ -2,12 +2,15 @@
 
 from __future__ import annotations
 
+import base64
 import re
 from typing import Any
+from urllib.parse import urlsplit
 
 from Undefined.github.models import GitHubReleaseInfo, GitHubRepoInfo
 from Undefined.github.parser import normalize_github_repo_id
 from Undefined.skills.http_client import request_with_retry
+from Undefined.utils.http_download import parse_content_length
 
 _API_BASE_URL = "https://api.github.com"
 _HEADERS = {
@@ -17,6 +20,21 @@ _HEADERS = {
 }
 DEFAULT_REQUEST_TIMEOUT_SECONDS: float = 10.0
 DEFAULT_REQUEST_RETRIES: int = 2
+MAX_GITHUB_AVATAR_SIZE_BYTES: int = 2 * 1024 * 1024
+_GITHUB_AVATAR_HOSTS = frozenset({"avatars.githubusercontent.com"})
+_GITHUB_AVATAR_MEDIA_TYPES = frozenset(
+    {
+        "image/avif",
+        "image/gif",
+        "image/jpeg",
+        "image/png",
+        "image/webp",
+    }
+)
+_GITHUB_AVATAR_HEADERS = {
+    "Accept": "image/avif,image/webp,image/png,image/jpeg,image/gif",
+    "User-Agent": _HEADERS["User-Agent"],
+}
 
 
 def _as_str(value: object) -> str:
@@ -67,6 +85,66 @@ def _license_name(value: object) -> str:
     return _as_str(value.get("spdx_id")) or _as_str(value.get("name"))
 
 
+def _validate_github_avatar_url(value: str) -> str:
+    url = value.strip()
+    parsed = urlsplit(url)
+    try:
+        port = parsed.port
+    except ValueError as exc:
+        raise ValueError("GitHub 头像 URL 端口无效") from exc
+
+    if (
+        parsed.scheme.lower() != "https"
+        or (parsed.hostname or "").lower() not in _GITHUB_AVATAR_HOSTS
+        or port not in (None, 443)
+    ):
+        raise ValueError("GitHub 头像 URL 不受信任")
+    return url
+
+
+def _normalize_avatar_media_type(value: str) -> str:
+    return value.partition(";")[0].strip().lower()
+
+
+async def get_github_avatar_data_url(
+    avatar_url: str,
+    *,
+    request_timeout: float = DEFAULT_REQUEST_TIMEOUT_SECONDS,
+    request_retries: int = DEFAULT_REQUEST_RETRIES,
+    context: dict[str, object] | None = None,
+) -> str:
+    """下载 GitHub 头像并编码为供离线渲染使用的 data URL。"""
+    trusted_url = _validate_github_avatar_url(avatar_url)
+    response = await request_with_retry(
+        "GET",
+        trusted_url,
+        headers=_GITHUB_AVATAR_HEADERS,
+        timeout=request_timeout,
+        follow_redirects=True,
+        context=context,
+        retries=request_retries,
+        proxy_scope="github",
+    )
+    _validate_github_avatar_url(str(response.url))
+
+    media_type = _normalize_avatar_media_type(response.headers.get("content-type", ""))
+    if media_type not in _GITHUB_AVATAR_MEDIA_TYPES:
+        raise ValueError(f"GitHub 头像媒体类型不受支持: {media_type or '-'}")
+
+    declared_size = parse_content_length(response.headers.get("content-length"))
+    if declared_size is not None and declared_size > MAX_GITHUB_AVATAR_SIZE_BYTES:
+        raise ValueError("GitHub 头像超过大小限制")
+
+    content = response.content
+    if not content:
+        raise ValueError("GitHub 头像内容为空")
+    if len(content) > MAX_GITHUB_AVATAR_SIZE_BYTES:
+        raise ValueError("GitHub 头像超过大小限制")
+
+    encoded = base64.b64encode(content).decode("ascii")
+    return f"data:{media_type};base64,{encoded}"
+
+
 def _parse_contributor_count(link_header: str, payload: object) -> int | None:
     for part in link_header.split(","):
         if 'rel="last"' not in part:

{undefined_bot-3.13.0 → undefined_bot-3.13.2}/src/Undefined/github/sender.py

@@ -11,6 +11,7 @@ import uuid
 from Undefined.github.client import (
     DEFAULT_REQUEST_RETRIES,
     DEFAULT_REQUEST_TIMEOUT_SECONDS,
+    get_github_avatar_data_url,
     get_public_repo_info,
 )
 from Undefined.github.models import GitHubRepoInfo
@@ -75,12 +76,15 @@ def _topic_html(info: GitHubRepoInfo) -> str:
     return f'<div class="topics">{topic_items}</div>'
 
 
-def _build_repo_card_html(info: GitHubRepoInfo) -> str:
+def _build_repo_card_html(
+    info: GitHubRepoInfo,
+    *,
+    avatar_data_url: str | None = None,
+) -> str:
     description = info.description or "No description provided."
-    avatar = info.owner_avatar_url
     avatar_html = (
-        f'<img class="avatar" src="{_html_text(avatar)}" alt="">'
-        if avatar
+        f'<img class="avatar" src="{_html_text(avatar_data_url)}" alt="">'
+        if avatar_data_url
         else '<div class="avatar placeholder"></div>'
     )
     stats = "".join(
@@ -280,8 +284,13 @@ def _build_fallback_message(info: GitHubRepoInfo) -> str:
     return "\n".join(lines)
 
 
-async def _render_repo_card(info: GitHubRepoInfo, output_path: Path) -> None:
-    html_content = _build_repo_card_html(info)
+async def _render_repo_card(
+    info: GitHubRepoInfo,
+    output_path: Path,
+    *,
+    avatar_data_url: str | None,
+) -> None:
+    html_content = _build_repo_card_html(info, avatar_data_url=avatar_data_url)
     await render_html_to_image(
         html_content,
         str(output_path),
@@ -291,6 +300,32 @@ async def _render_repo_card(info: GitHubRepoInfo, output_path: Path) -> None:
     )
 
 
+async def _load_owner_avatar_data_url(
+    info: GitHubRepoInfo,
+    *,
+    request_timeout: float,
+    request_retries: int,
+    context: dict[str, object] | None,
+) -> str | None:
+    if not info.owner_avatar_url:
+        return None
+    try:
+        return await get_github_avatar_data_url(
+            info.owner_avatar_url,
+            request_timeout=request_timeout,
+            request_retries=request_retries,
+            context=context,
+        )
+    except Exception:
+        logger.warning(
+            "[GitHub] 头像下载失败，使用占位图: repo=%s owner=%s",
+            info.repo_id,
+            info.owner_login,
+            exc_info=True,
+        )
+        return None
+
+
 async def _send_message(
     sender: "MessageSender",
     target_type: Literal["group", "private"],
@@ -338,10 +373,20 @@ async def send_github_repo_card(
         output_dir
         / f"github_{info.repo_id.replace('/', '_')}_{uuid.uuid4().hex[:8]}.png"
     )
+    avatar_data_url = await _load_owner_avatar_data_url(
+        info,
+        request_timeout=request_timeout,
+        request_retries=request_retries,
+        context=context,
+    )
 
     try:
         try:
-            await _render_repo_card(info, output_path)
+            await _render_repo_card(
+                info,
+                output_path,
+                avatar_data_url=avatar_data_url,
+            )
             message = f"[CQ:image,file={output_path.resolve().as_uri()}]"
         except Exception:
             logger.exception(