Undefined-bot 3.16.0__tar.gz → 3.16.1__tar.gz

{undefined_bot-3.16.0 → undefined_bot-3.16.1}/CHANGELOG.md

@@ -1,3 +1,14 @@
+## v3.16.1 自托管服务部署依赖说明
+
+本版本补齐部署文档中长期缺失的一块：除 Python 运行环境外，Undefined 还需要连接若干由部署方自行搭建的服务，此前这些依赖只散落在配置字段注释里，没有一处说明哪些是必需的、不部署会失去什么。
+
+- 部署文档新增「需要一并部署的自托管服务（概览）」，明确四项服务的必要性与影响面：OneBot V11 协议端（NapCat / Lagrange.Core）为必需项，QQ 消息的收发完全由协议端决定；SearXNG 只影响内置 `web_search`；Firecrawl 默认关闭，可用官方 keyless、官方 + 自己的 API Key 或自部署实例；lxmusic2api 不部署时整组 `music.*` 工具隐藏。每项给出配置位置与官方部署说明链接，不重复上游安装步骤。
+- 同一节补充宿主环境依赖：Docker（Code Delivery Agent，可 `enabled = false` 关闭）、FFmpeg（Bilibili 音视频合并、原生语音与微信侧 SILK 编码），以及本地子进程 MCP 服务器所需的运行时（`npx` 需要 Node.js，`uvx` 随 `uv` 一同安装，无需 Node.js）。概览放在源码部署的安装步骤之后、配置环境之前，pip/uv tool 部署同样适用。
+- 配置文档在 `[onebot]`、`[search]`、`[lxmusic2api]` 对应小节补充部署前提与可选性说明，`config.toml.example` 同步补注 SearXNG 与 Firecrawl 的自部署提示。
+- 首页 Release 下载速查压缩为一张三列表格（目标 / 文件 / 平台），去掉与正文重复的表述。
+
+---
+
 ## v3.16.0 Bilibili 图文（opus）提取
 
 本版本为 B 站内容自动提取补齐图文（opus / 动态）类型，命中图文链接后发送一次合并转发：第一条是图文元数据、第二条起是正文，文字与图片按原顺序混排，正文超长自动分段；正文里的图文与视频卡片各自成为嵌套转发节点；新增的 `bilibili_opus` 工具还支持按字数区间或关键词读取正文。

{undefined_bot-3.16.0 → undefined_bot-3.16.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: Undefined-bot
-Version: 3.16.0
+Version: 3.16.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
@@ -83,29 +83,16 @@ Description-Content-Type: text/markdown
 
 ## Release 下载速查
 
-如果只是部署和运行 QQ Bot，通常**不需要**在 GitHub Release 的 Assets 里下载任何文件。推荐按下方[快速开始](#-快速开始-源码模式)使用源码部署；只想快速体验命令行入口时，可使用 `pip install -U Undefined-bot` 或 `uv tool install Undefined-bot`。
+**部署 QQ Bot 本身不需要下载 Release**：Release 里都是可选组件。源码部署见下方[快速开始](#-快速开始-源码模式)，安装包用途与平台对应如下：
 
-Release 里的安装包是可选组件，不是 Bot 服务本体：
-
-| 目标 | 是否需要下载 Release | 选择 |
+| 目标 | 文件 | 平台 |
 | --- | --- | --- |
-| 部署 / 运行 QQ Bot | 不需要 | 源码部署，启动 `uv run Undefined-webui`；或使用 `pip` / `uv tool` 安装 Python 包 |
-| 远程管理已有实例 | 可选 | `Undefined-Console-*`，用于连接 Management API 并打开远程 WebUI |
-| 使用原生聊天客户端 | 可选 | `Undefined-Chat-*`，用于连接 Runtime API 聊天 |
-| 离线安装 / 镜像缓存 Python 包 | 可选 | `undefined_bot-*.whl` 或 `undefined_bot-*.tar.gz` |
-
-平台文件选择：
-
-| 平台 | 推荐下载 |
-| --- | --- |
-| Windows x64 | `*-windows-x64-setup.exe`；批量部署或系统管理场景可选 `.msi` |
-| macOS Apple Silicon | `*-macos-arm64.dmg` |
-| macOS Intel | `*-macos-x64.dmg` |
-| Debian / Ubuntu | `*.deb` |
-| 其他 Linux x64 | `*.AppImage` |
-| Android 常见手机 / 平板 | `*-android-arm64-v8a-release.apk`；旧 32 位设备选 `armeabi-v7a`，模拟器按需选 `x86_64` / `x86` |
-
-Console 和 Chat 都需要连接到已经运行的 Undefined 服务。首次部署请先启动 `Undefined-webui`，完成配置和 Bot 启动后，再按需使用这些客户端连接。
+| 部署 / 运行 Bot | 不需要下载 Release；源码部署并启动 `uv run Undefined-webui` | 任意 |
+| 离线安装 / 镜像缓存 | `undefined_bot-*.whl` 或 `undefined_bot-*.tar.gz` | 任意 |
+| 远程管理已有实例 | `Undefined-Console-*`（连接 Management API 打开远程 WebUI） | Windows x64 `*-windows-x64-setup.exe`（批量部署可选 `.msi`）／macOS `*-macos-arm64.dmg`、`*-macos-x64.dmg`／Debian、Ubuntu `*.deb`／其他 Linux `*.AppImage` |
+| 原生聊天客户端 | `Undefined-Chat-*`（连接 Runtime API 聊天） | 同上；Android 为 `*-android-arm64-v8a-release.apk`（旧 32 位设备用 `armeabi-v7a`，模拟器按需 `x86_64` / `x86`） |
+
+Console 和 Chat 都需要连接已运行的 Undefined 服务：首次部署请先启动 `Undefined-webui`，完成配置和 Bot 启动后再连接。
 
 ## ⚡ 核心特性
 

{undefined_bot-3.16.0 → undefined_bot-3.16.1}/README.md

@@ -32,29 +32,16 @@
 
 ## Release 下载速查
 
-如果只是部署和运行 QQ Bot，通常**不需要**在 GitHub Release 的 Assets 里下载任何文件。推荐按下方[快速开始](#-快速开始-源码模式)使用源码部署；只想快速体验命令行入口时，可使用 `pip install -U Undefined-bot` 或 `uv tool install Undefined-bot`。
+**部署 QQ Bot 本身不需要下载 Release**：Release 里都是可选组件。源码部署见下方[快速开始](#-快速开始-源码模式)，安装包用途与平台对应如下：
 
-Release 里的安装包是可选组件，不是 Bot 服务本体：
-
-| 目标 | 是否需要下载 Release | 选择 |
+| 目标 | 文件 | 平台 |
 | --- | --- | --- |
-| 部署 / 运行 QQ Bot | 不需要 | 源码部署，启动 `uv run Undefined-webui`；或使用 `pip` / `uv tool` 安装 Python 包 |
-| 远程管理已有实例 | 可选 | `Undefined-Console-*`，用于连接 Management API 并打开远程 WebUI |
-| 使用原生聊天客户端 | 可选 | `Undefined-Chat-*`，用于连接 Runtime API 聊天 |
-| 离线安装 / 镜像缓存 Python 包 | 可选 | `undefined_bot-*.whl` 或 `undefined_bot-*.tar.gz` |
-
-平台文件选择：
-
-| 平台 | 推荐下载 |
-| --- | --- |
-| Windows x64 | `*-windows-x64-setup.exe`；批量部署或系统管理场景可选 `.msi` |
-| macOS Apple Silicon | `*-macos-arm64.dmg` |
-| macOS Intel | `*-macos-x64.dmg` |
-| Debian / Ubuntu | `*.deb` |
-| 其他 Linux x64 | `*.AppImage` |
-| Android 常见手机 / 平板 | `*-android-arm64-v8a-release.apk`；旧 32 位设备选 `armeabi-v7a`，模拟器按需选 `x86_64` / `x86` |
-
-Console 和 Chat 都需要连接到已经运行的 Undefined 服务。首次部署请先启动 `Undefined-webui`，完成配置和 Bot 启动后，再按需使用这些客户端连接。
+| 部署 / 运行 Bot | 不需要下载 Release；源码部署并启动 `uv run Undefined-webui` | 任意 |
+| 离线安装 / 镜像缓存 | `undefined_bot-*.whl` 或 `undefined_bot-*.tar.gz` | 任意 |
+| 远程管理已有实例 | `Undefined-Console-*`（连接 Management API 打开远程 WebUI） | Windows x64 `*-windows-x64-setup.exe`（批量部署可选 `.msi`）／macOS `*-macos-arm64.dmg`、`*-macos-x64.dmg`／Debian、Ubuntu `*.deb`／其他 Linux `*.AppImage` |
+| 原生聊天客户端 | `Undefined-Chat-*`（连接 Runtime API 聊天） | 同上；Android 为 `*-android-arm64-v8a-release.apk`（旧 32 位设备用 `armeabi-v7a`，模拟器按需 `x86_64` / `x86`） |
+
+Console 和 Chat 都需要连接已运行的 Undefined 服务：首次部署请先启动 `Undefined-webui`，完成配置和 Bot 启动后再连接。
 
 ## ⚡ 核心特性
 

{undefined_bot-3.16.0 → undefined_bot-3.16.1}/config.toml.example

@@ -1270,7 +1270,9 @@ use_proxy = false
 # 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。
+# zh: 该服务需自行部署（官方说明：https://docs.searxng.org/），本项目不提供；留空时内置 web_search 工具不可用，grok_search / firecrawl_search / crawl_webpage 不受影响。
 # en: SearxNG service URL, e.g. http://127.0.0.1:8849.
+# en: This service must be self-deployed (official guide: https://docs.searxng.org/); when empty the built-in web_search tool is unavailable while grok_search / firecrawl_search / crawl_webpage keep working.
 searxng_url = ""
 # 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.
@@ -1282,11 +1284,11 @@ 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.
+# zh: Firecrawl API Key。为空时使用 Firecrawl keyless 搜索；填写后会发送 Authorization: Bearer；自部署实例通常也可留空。
+# en: Firecrawl API key. Leave empty for Firecrawl keyless search; when set, Authorization: Bearer is sent; self-hosted instances can usually leave it empty too.
 api_key = ""
-# zh: Firecrawl API 基础地址。
-# en: Firecrawl API base URL.
+# zh: Firecrawl API 基础地址。可用官方地址配自己的 Key，也可改为自部署实例地址（自托管说明：https://docs.firecrawl.dev/contributing/self-host）。
+# en: Firecrawl API base URL. Use the official endpoint with your own key, or point it at a self-hosted instance (self-host guide: https://docs.firecrawl.dev/contributing/self-host).
 base_url = "https://api.firecrawl.dev"
 
 # zh: 代理设置（可选）。

{undefined_bot-3.16.0 → undefined_bot-3.16.1}/pyproject.toml

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

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