Undefined-bot 3.7.0__tar.gz → 3.7.1__tar.gz

{undefined_bot-3.7.0 → undefined_bot-3.7.1}/CHANGELOG.md

@@ -1,3 +1,17 @@
+## v3.7.1 WebUI Release 更新提示
+
+本版本将更新流程从启动时自动拉取改为 WebUI 内的可控交互：页面登录后在后台静默检查最新正式 GitHub Release，仅在发现新版本时提示用户，并在明确确认后拉取对应 Release 标签并重启。
+
+- 新增 WebUI Release 更新检查。鉴权成功后异步查询 `69gg/Undefined` 的最新正式 GitHub Release，不阻塞页面或主事件循环；后端提供 15 分钟缓存，并让成功或失败的并发请求共享同一个在途任务，概览页也可随时手动检查。
+- 新增更新确认对话框。检测到新版本时展示当前版本、目标版本和 Release 链接，并提供“稍后”与“拉取并重启”操作；对话框作为全局 overlay 在 Landing 与 App 视图均可正常使用，同时补齐中英文文案、键盘焦点管理、移动端布局、错误与不可更新状态提示。
+- 收紧自动拉取边界。仅允许官方 `origin`、本地 `main` 和干净工作区，确认前重新校验目标版本；更新时验证 Release 标签属于官方 `main` 且可从当前提交快进，再精确更新到该标签，避免拉取尚未正式发布的后续提交。
+- 完善更新后的恢复流程。代码更新后同步子模块，并仅在 Python 依赖清单变化时执行 `uv sync`；依赖同步失败会取消自动重启，成功后恢复更新前的 Bot 运行状态并重启 WebUI。
+- 加固更新请求生命周期。Release 更新操作设置 30 分钟总等待上限，重启任务由模块持有到完成，Bot 自动恢复标记统一写入仓库根目录下的 `data/cache/`；Release 外链仅接受 HTTPS 地址。
+- 新增 `[webui].check_updates` 配置，默认开启并支持热更新；关闭后只停用页面打开时的自动检查，不影响手动检查。
+- 移除 Bot 与 WebUI 启动阶段原有的无确认自动拉取和重启逻辑，更新行为统一由 WebUI 用户显式触发；同步更新配置模板、使用文档、Management API 能力声明及后端、前端和 Git 更新回归测试。
+
+---
+
 ## v3.7.0 主 AI Tool Search 按需工具加载
 
 本版本为主 AI 新增请求级 Tool Search：工具较多时不再必须把全部 function schema 一次性发送给模型，而是先提供基础工具、虚拟搜索工具和经过权限过滤的名称目录，再按模型实际需要从下一轮开始补充完整 schema。该能力使用普通 function tool 实现，可同时适配 Chat Completions 与 Responses，并保持子 Agent 现有私有工具集不变。

{undefined_bot-3.7.0 → undefined_bot-3.7.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: Undefined-bot
-Version: 3.7.0
+Version: 3.7.1
 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.7.0 → undefined_bot-3.7.1}/config.toml.example

@@ -1390,6 +1390,9 @@ password = "changeme"
 # zh: WebUI 启动时是否自动启动机器人进程。
 # en: Auto-start bot when WebUI starts.
 autostart_bot = false
+# zh: 每次打开 WebUI 时是否在后台检查 GitHub Release 更新。
+# en: Check GitHub Releases for updates in the background whenever WebUI is opened.
+check_updates = true
 
 # zh: 主进程 Runtime API（供 WebUI/外部系统读取探针、记忆检索、AI Chat 使用）。
 # en: Runtime API in the main process (for WebUI/external integrations: probes, memory queries, AI chat).

{undefined_bot-3.7.0 → undefined_bot-3.7.1}/pyproject.toml

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

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

{undefined_bot-3.7.0 → undefined_bot-3.7.1}/src/Undefined/config/config_class.py

@@ -140,6 +140,7 @@ class Config:
     webui_port: int
     webui_password: str
     webui_autostart_bot: bool
+    webui_check_updates: bool
     api: APIConfig
     # Code Delivery Agent
     code_delivery_enabled: bool

{undefined_bot-3.7.0 → undefined_bot-3.7.1}/src/Undefined/config/hot_reload.py

@@ -31,6 +31,7 @@ _RESTART_REQUIRED_KEYS: set[str] = {
     "webui_url",
     "webui_port",
     "webui_password",
+    "webui_autostart_bot",
     "api",
     "api.enabled",
     "api.host",

{undefined_bot-3.7.0 → undefined_bot-3.7.1}/src/Undefined/config/load_sections/domains.py

@@ -49,6 +49,7 @@ def load_domains(
         "webui_port": webui_settings.port,
         "webui_password": webui_settings.password,
         "webui_autostart_bot": webui_settings.autostart_bot,
+        "webui_check_updates": webui_settings.check_updates,
         "api": api_config,
         "cognitive": cognitive,
         "memes": memes,

{undefined_bot-3.7.0 → undefined_bot-3.7.1}/src/Undefined/config/webui_settings.py

@@ -12,6 +12,7 @@ DEFAULT_WEBUI_URL = "127.0.0.1"
 DEFAULT_WEBUI_PORT = 8787
 DEFAULT_WEBUI_PASSWORD = "changeme"
 DEFAULT_WEBUI_AUTOSTART_BOT = False
+DEFAULT_WEBUI_CHECK_UPDATES = True
 
 
 @dataclass
@@ -20,6 +21,7 @@ class WebUISettings:
     port: int
     password: str
     autostart_bot: bool
+    check_updates: bool
     using_default_password: bool
     config_exists: bool
 
@@ -40,12 +42,14 @@ def load_webui_settings(config_path: Optional[Path] = None) -> WebUISettings:
     port_value = _get_value(data, ("webui", "port"), None)
     password_value = _get_value(data, ("webui", "password"), None)
     autostart_bot_value = _get_value(data, ("webui", "autostart_bot"), None)
+    check_updates_value = _get_value(data, ("webui", "check_updates"), None)
 
     url = _coerce_str(url_value, DEFAULT_WEBUI_URL)
     port = _coerce_int(port_value, DEFAULT_WEBUI_PORT)
     if port <= 0 or port > 65535:
         port = DEFAULT_WEBUI_PORT
     autostart_bot = _coerce_bool(autostart_bot_value, DEFAULT_WEBUI_AUTOSTART_BOT)
+    check_updates = _coerce_bool(check_updates_value, DEFAULT_WEBUI_CHECK_UPDATES)
 
     password_normalized = _normalize_str(password_value)
     if not password_normalized:
@@ -54,6 +58,7 @@ def load_webui_settings(config_path: Optional[Path] = None) -> WebUISettings:
             port=port,
             password=DEFAULT_WEBUI_PASSWORD,
             autostart_bot=autostart_bot,
+            check_updates=check_updates,
             using_default_password=True,
             config_exists=config_exists,
         )
@@ -62,6 +67,7 @@ def load_webui_settings(config_path: Optional[Path] = None) -> WebUISettings:
         port=port,
         password=password_normalized,
         autostart_bot=autostart_bot,
+        check_updates=check_updates,
         using_default_password=False,
         config_exists=config_exists,
     )

{undefined_bot-3.7.0 → undefined_bot-3.7.1}/src/Undefined/github/__init__.py

@@ -1,7 +1,7 @@
 """GitHub 仓库自动提取与信息卡片。"""
 
-from Undefined.github.client import get_public_repo_info
-from Undefined.github.models import GitHubRepoInfo
+from Undefined.github.client import get_latest_public_release, get_public_repo_info
+from Undefined.github.models import GitHubReleaseInfo, GitHubRepoInfo
 from Undefined.github.parser import (
     extract_from_json_message,
     extract_github_repo_ids,
@@ -11,9 +11,11 @@ from Undefined.github.sender import send_github_repo_card
 
 __all__ = [
     "GitHubRepoInfo",
+    "GitHubReleaseInfo",
     "extract_from_json_message",
     "extract_github_repo_ids",
     "get_public_repo_info",
+    "get_latest_public_release",
     "normalize_github_repo_id",
     "send_github_repo_card",
 ]

{undefined_bot-3.7.0 → undefined_bot-3.7.1}/src/Undefined/github/client.py

@@ -5,7 +5,7 @@ from __future__ import annotations
 import re
 from typing import Any
 
-from Undefined.github.models import GitHubRepoInfo
+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
 
@@ -174,3 +174,45 @@ async def get_public_repo_info(
     if not info.repo_id:
         raise ValueError("GitHub API 返回缺少仓库 ID")
     return info
+
+
+async def get_latest_public_release(
+    repo_id: str,
+    *,
+    request_timeout: float = DEFAULT_REQUEST_TIMEOUT_SECONDS,
+    request_retries: int = DEFAULT_REQUEST_RETRIES,
+    context: dict[str, object] | None = None,
+) -> GitHubReleaseInfo:
+    """获取 public GitHub 仓库的最新正式 Release。"""
+    normalized = normalize_github_repo_id(repo_id)
+    if normalized is None:
+        raise ValueError(f"无法解析 GitHub 仓库标识: {repo_id}")
+
+    response = await request_with_retry(
+        "GET",
+        f"{_API_BASE_URL}/repos/{normalized}/releases/latest",
+        headers=_HEADERS,
+        timeout=request_timeout,
+        follow_redirects=True,
+        context=context,
+        retries=request_retries,
+        proxy_scope="github",
+    )
+    payload = response.json()
+    if not isinstance(payload, dict):
+        raise ValueError("GitHub Release API 返回格式异常")
+
+    release = GitHubReleaseInfo(
+        tag_name=_as_str(payload.get("tag_name")),
+        name=_as_str(payload.get("name")),
+        html_url=_as_str(payload.get("html_url")),
+        published_at=_as_str(payload.get("published_at")),
+        target_commitish=_as_str(payload.get("target_commitish")),
+        draft=bool(payload.get("draft")),
+        prerelease=bool(payload.get("prerelease")),
+    )
+    if not release.tag_name:
+        raise ValueError("GitHub Release API 返回缺少 tag_name")
+    if release.draft or release.prerelease:
+        raise ValueError("GitHub Release API 未返回正式版本")
+    return release

{undefined_bot-3.7.0 → undefined_bot-3.7.1}/src/Undefined/github/models.py

@@ -31,3 +31,16 @@ class GitHubRepoInfo:
     pushed_at: str
     archived: bool
     fork: bool
+
+
+@dataclass(frozen=True)
+class GitHubReleaseInfo:
+    """GitHub Release metadata used by the WebUI update flow."""
+
+    tag_name: str
+    name: str
+    html_url: str
+    published_at: str
+    target_commitish: str
+    draft: bool
+    prerelease: bool

{undefined_bot-3.7.0 → undefined_bot-3.7.1}/src/Undefined/main.py

@@ -36,12 +36,6 @@ from Undefined.utils.paths import (
     ensure_dir,
 )
 
-from Undefined.utils.self_update import (
-    GitUpdatePolicy,
-    apply_git_update,
-    format_update_result,
-    restart_process,
-)
 from Undefined.render import close_browser as close_render_browser
 from Undefined.utils.render_cache import close_render_cache
 
@@ -148,21 +142,6 @@ async def main() -> None:
     logger = logging.getLogger(__name__)
     logger.info("[启动] 正在初始化 Undefined 机器人...")
 
-    # Git-based auto update (only for official origin/main).
-    try:
-        update_result = await asyncio.to_thread(apply_git_update, GitUpdatePolicy())
-        logger.info("[自更新] %s", format_update_result(update_result))
-        if update_result.updated and update_result.repo_root is not None:
-            if update_result.uv_sync_attempted and not update_result.uv_synced:
-                logger.warning(
-                    "[自更新] 代码已更新但 uv sync 失败，跳过自动重启（避免启动失败）"
-                )
-            else:
-                logger.warning("[自更新] 检测到更新，正在重启进程以加载新代码...")
-                restart_process(module="Undefined", chdir=update_result.repo_root)
-    except Exception as exc:
-        logger.warning("[自更新] 检查更新失败，将继续启动: %s", exc)
-
     start_time = time.perf_counter()
     try:
         did_compact = await TokenUsageStorage().compact_if_needed()