Undefined-bot 3.6.0__tar.gz → 3.6.1__tar.gz

{undefined_bot-3.6.0 → undefined_bot-3.6.1}/ARCHITECTURE.md

@@ -94,8 +94,8 @@ graph TB
             T_Time["get_current_time<br/>获取当前时间"]
             T_GetPicture["get_picture<br/>获取图片"]
             T_GetUserInfo["get_user_info<br/>获取用户信息"]
-            T_ArxivPaper["arxiv_paper<br/>arXiv 论文发送"]
-            T_BilibiliVideo["bilibili_video<br/>B站视频下载发送"]
+            T_ArxivPaper["arxiv_paper<br/>arXiv 论文发送 / UID 获取"]
+            T_BilibiliVideo["bilibili_video<br/>B站视频下载发送 / UID 获取"]
         end
         
         subgraph Toolsets["工具集 (skills/toolsets/, 11大类)"]
@@ -115,7 +115,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_File["file_analysis_agent<br/>文件分析助手<br/>(14个工具)<br/>• extract_* (PDF/Word/Excel/PPT)<br/>• analyze_code<br/>• analyze_multimodal"]
+            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"]
             A_Entertainment["entertainment_agent<br/>娱乐助手<br/>(9个工具)<br/>• ai_draw_one<br/>• horoscope<br/>• video_random_recommend"]
@@ -877,7 +877,7 @@ description: 从 PDF 文件中提取文本和表格，填写表单。当用户
 |-------|---------|---------|---------|
 | **info_agent** | 信息查询助手 | 18个 | 天气查询、热搜榜单、网络检测、B站信息查询、arXiv 搜索等 |
 | **web_agent** | 网络搜索助手 | 3个 + MCP | 网页搜索、爬虫、Playwright MCP |
-| **file_analysis_agent** | 文件分析助手 | 14个 | PDF/Word/Excel/PPT解析、代码分析、多模态分析 |
+| **file_analysis_agent** | 文件分析助手 | 多个 | PDF/Word/Excel/PPT解析、指定 PDF 页视觉分析、代码分析、多模态分析、arXiv/Bilibili UID 获取分析 |
 | **naga_code_analysis_agent** | NagaAgent 代码分析 | 7个 | 代码库浏览、文件搜索、目录遍历 |
 | **undefined_self_code_agent** | Undefined 自身代码查阅 | 4个 | 受限读取源码、测试、文档、资源、脚本与 App |
 | **entertainment_agent** | 娱乐助手 | 9个 | AI 绘图、星座运势、小说搜索、随机视频推荐等 |

{undefined_bot-3.6.0 → undefined_bot-3.6.1}/CHANGELOG.md

@@ -1,3 +1,15 @@
+## v3.6.1 Agent 路由收敛、文件分析增强与发版脚本修复
+
+本版本围绕 Agent 职责边界和文件分析链路做小版本收敛：把 arXiv 论文分析从独立 Agent 合并到通用文件分析 Agent，让论文、PDF 页面视觉分析和视频附件获取都走统一的附件 UID 语义；同时修复版本迭代脚本重写 Tauri 配置格式导致 pre-commit 失败的问题，保证后续版本号同步、lock 文件刷新和自动提交流程更稳定。
+
+- 合并 arXiv 论文分析职责到文件分析链路。移除独立 `arxiv_analysis_agent`，`file_analysis_agent` 现在可通过 `arxiv_paper(output_mode=uid)` 获取论文 PDF 附件 UID，并结合 `extract_pdf` 与 `describe_pdf_page` 完成文本和指定页视觉分析。
+- 扩展媒体工具的附件输出能力。`arxiv_paper` 与 `bilibili_video` 新增 `output_mode=uid` 调用方式，可把下载或提取结果登记为当前会话附件，供后续 Agent 直接引用和复用。
+- 明确 Agent 职责边界。更新代码交付、文件分析、信息查询、娱乐、总结、Naga 代码分析、Undefined 自查与 Web Agent 的 intro / prompt，减少项目问题、通用搜索、文件理解和代码修改任务之间的误路由。
+- 补齐文件分析视觉工具与测试。新增 `describe_pdf_page` 工具及回归测试，覆盖 PDF 指定页截图/视觉描述链路；同步更新 arXiv、B 站发送器和工具注册测试。
+- 修复版本迭代脚本的 JSON 格式漂移。`scripts/bump_version.py` 更新 JSON manifest 时只替换顶层 `version` 字段，保留 Tauri 配置原有格式，避免 `--commit` 触发的 Biome 检查因 `targets` 数组被重排而失败；脚本文档与单元测试同步覆盖该行为。
+
+---
+
 ## v3.6.0 原生 Chat、WebChat 多会话与运行时管理增强
 
 本版本把 Undefined 的“管理控制台内聊天”扩展为一套更完整的跨端聊天与运行时管理体系：一边新增面向桌面端和 Android 的原生 Chat 客户端，一边把 WebUI WebChat 升级为可长期使用的多会话工作台；底层则补齐 Runtime / Management API、任务续接、附件、命令、定时任务和发布构建能力。围绕这些入口，v3.6.0 也整理了 Agent 路由、认知记忆、附件标签和工程验证，让 WebUI、原生客户端和 QQ 侧共享更一致的运行时语义。

{undefined_bot-3.6.0 → undefined_bot-3.6.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: Undefined-bot
-Version: 3.6.0
+Version: 3.6.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
@@ -82,8 +82,6 @@ Description-Content-Type: text/markdown
 
 ### _与 [NagaAgent](https://github.com/Xxiii8322766509/NagaAgent) 进行联动！_
 
-> 学业繁忙，暂缓更新至六月下旬，在此期间仅作必要bugfix。
-
 ---
 
 ## ⚡ 立即体验
@@ -104,6 +102,7 @@ Description-Content-Type: text/markdown
 - **远程管理 + 多端客户端**：浏览器版 WebUI、跨平台 Console（管理客户端）和原生优先 Undefined Chat（聊天客户端）共享同一套 Management / Runtime 服务，支持远程管理，并覆盖 `Windows / macOS / Linux / Android` 发布链路。
   - **Undefined Console**：基于 Tauri v2 的管理客户端，完整管理功能
   - **Undefined Chat**：基于 Tauri v2 + React 19 的原生优先聊天客户端，采用莫兰迪橙色系设计，移植 WebUI webchat 的核心聊天能力并做原生增强：中英双语运行时切换（i18n）、平台抽象层（按真实平台区分桌面/移动布局）、桌面快捷键、系统凭据存储、HTML 正文 sanitize 内联渲染 + 独立预览窗口隔离运行、Android（非 iOS）横屏/平板适配。iOS 暂不作为发布平台
+- **Undefined Chat 跨平台原生对话 App**：`apps/undefined-chat/` 提供独立 Tauri v2 + React 19 原生聊天工作台，直连 Runtime API，并以 Runtime 作为会话、历史、任务、附件和事件真源；桌面端支持快捷键、独立 HTML 预览窗口和系统凭据存储，Android 端支持移动布局、生命周期恢复、流式附件上传和 Keystore 安全存储。详见 [Undefined Chat](docs/undefined-chat.md)。
 - **Management API + Runtime API 分层**：配置、日志、Bot 启停和管理探针由 Management API 提供；主进程 Runtime API 则专注探针、记忆只读查询、认知侧写检索和 WebUI AI Chat；内部探针的技能统计覆盖可调用工具、工具集、Agent、自动处理管线、斜杠命令与 Anthropic Skills。详见 [docs/management-api.md](docs/management-api.md) 与 [docs/openapi.md](docs/openapi.md)。
 - **多模型池**：支持配置多个 AI 模型，可轮询、随机选择或用户指定；支持多模型并发比较，选择最佳结果继续对话。详见 [多模型功能文档](docs/multi-model.md)。
 - **本地知识库**：将纯文本文件向量化存入 ChromaDB，AI 可通过关键词搜索或语义搜索查询领域知识；支持增量嵌入与自动扫描。详见 [知识库文档](docs/knowledge.md)。
@@ -112,6 +111,7 @@ Description-Content-Type: text/markdown
 - **版本变更可查询**：仓库根目录维护 `CHANGELOG.md`，并提供 `/changelog` 命令在运行时查看最近版本和单版本摘要。
 - **并行工具执行**：无论是主 AI 还是子 Agent，均支持 `asyncio` 并发工具调用，大幅提升多任务处理速度（如同时读取多个文件或搜索多个关键词）。
 - **智能 Agent 矩阵**：内置多个专业 Agent，分工协作处理复杂任务。
+- **Undefined 自身代码查阅 Agent**：内置 `undefined_self_code_agent`，可只读查询当前 Undefined 仓库的源码、测试、文档、资源、脚本、配置示例和 App 实现细节；访问范围受白名单约束，不写代码、不运行命令，并与 NagaAgent 代码分析职责分离。
 - **callable.json 共享机制**：通过简单的配置文件（`callable.json`）即可让 Agent 互相调用、将 `skills/tools/` 或 `skills/toolsets/` 下的工具按白名单暴露给 Agent，支持细粒度访问控制，实现复杂的多 Agent 协作场景。
 - **Agent 自我介绍自动生成**：启动时按 Agent 代码/配置 hash 生成 `intro.generated.md`（第一人称、结构化），与 `intro.md` 合并后作为描述；减少手动维护，保持能力说明与实现同步，有助于精准调度。
 - **请求上下文管理**：基于 Python `contextvars` 的统一请求上下文系统，自动 UUID 追踪，零竞态条件，完全的并发隔离。
@@ -119,8 +119,8 @@ Description-Content-Type: text/markdown
 - **MCP 协议支持**：支持通过 MCP (Model Context Protocol) 连接外部工具和数据源，扩展 AI 能力。
 - **Agent 私有 MCP**：可为单个 agent 提供独立 MCP 配置，按调用即时加载并释放，工具仅对该 agent 可见。
 - **Anthropic Skills**：支持 Anthropic Agent Skills（SKILL.md 格式），遵循 agentskills.io 开放标准，提供领域知识注入能力。
-- **Bilibili 视频提取**：自动检测消息中的 B 站视频链接/BV 号/小程序分享，下载 1080p 视频并通过 QQ 发送；同时提供 AI 工具调用入口。
-- **arXiv 论文提取与搜索**：自动检测消息中的 arXiv 链接/标识并发送论文信息与 PDF；同时提供 `arxiv_paper` 发送工具和 `arxiv_search` 检索工具。
+- **Bilibili 视频提取与分析**：自动检测消息中的 B 站视频链接/BV 号/小程序分享，下载视频并通过 QQ 合并转发；`bilibili_video` 也可只返回附件 UID，供 `file_analysis_agent` 做视频内容分析。
+- **arXiv 论文提取、搜索与分析**：自动检测消息中的 arXiv 链接/标识并发送论文信息与 PDF；`arxiv_paper` 也可只返回 PDF 附件 UID，供 `file_analysis_agent` 做文本提取或指定页视觉分析；`arxiv_search` 负责论文检索。
 - **GitHub 仓库卡片**：自动检测 GitHub 仓库链接或 `owner/repo` 仓库 ID，获取 public 仓库信息并发送简洁图片卡片，展示头像、简介、stars、forks、issues、contributors 等概览。
 - **自动处理管线**：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.6.0 → undefined_bot-3.6.1}/README.md

@@ -23,8 +23,6 @@
 
 ### _与 [NagaAgent](https://github.com/Xxiii8322766509/NagaAgent) 进行联动！_
 
-> 学业繁忙，暂缓更新至六月下旬，在此期间仅作必要bugfix。
-
 ---
 
 ## ⚡ 立即体验
@@ -45,6 +43,7 @@
 - **远程管理 + 多端客户端**：浏览器版 WebUI、跨平台 Console（管理客户端）和原生优先 Undefined Chat（聊天客户端）共享同一套 Management / Runtime 服务，支持远程管理，并覆盖 `Windows / macOS / Linux / Android` 发布链路。
   - **Undefined Console**：基于 Tauri v2 的管理客户端，完整管理功能
   - **Undefined Chat**：基于 Tauri v2 + React 19 的原生优先聊天客户端，采用莫兰迪橙色系设计，移植 WebUI webchat 的核心聊天能力并做原生增强：中英双语运行时切换（i18n）、平台抽象层（按真实平台区分桌面/移动布局）、桌面快捷键、系统凭据存储、HTML 正文 sanitize 内联渲染 + 独立预览窗口隔离运行、Android（非 iOS）横屏/平板适配。iOS 暂不作为发布平台
+- **Undefined Chat 跨平台原生对话 App**：`apps/undefined-chat/` 提供独立 Tauri v2 + React 19 原生聊天工作台，直连 Runtime API，并以 Runtime 作为会话、历史、任务、附件和事件真源；桌面端支持快捷键、独立 HTML 预览窗口和系统凭据存储，Android 端支持移动布局、生命周期恢复、流式附件上传和 Keystore 安全存储。详见 [Undefined Chat](docs/undefined-chat.md)。
 - **Management API + Runtime API 分层**：配置、日志、Bot 启停和管理探针由 Management API 提供；主进程 Runtime API 则专注探针、记忆只读查询、认知侧写检索和 WebUI AI Chat；内部探针的技能统计覆盖可调用工具、工具集、Agent、自动处理管线、斜杠命令与 Anthropic Skills。详见 [docs/management-api.md](docs/management-api.md) 与 [docs/openapi.md](docs/openapi.md)。
 - **多模型池**：支持配置多个 AI 模型，可轮询、随机选择或用户指定；支持多模型并发比较，选择最佳结果继续对话。详见 [多模型功能文档](docs/multi-model.md)。
 - **本地知识库**：将纯文本文件向量化存入 ChromaDB，AI 可通过关键词搜索或语义搜索查询领域知识；支持增量嵌入与自动扫描。详见 [知识库文档](docs/knowledge.md)。
@@ -53,6 +52,7 @@
 - **版本变更可查询**：仓库根目录维护 `CHANGELOG.md`，并提供 `/changelog` 命令在运行时查看最近版本和单版本摘要。
 - **并行工具执行**：无论是主 AI 还是子 Agent，均支持 `asyncio` 并发工具调用，大幅提升多任务处理速度（如同时读取多个文件或搜索多个关键词）。
 - **智能 Agent 矩阵**：内置多个专业 Agent，分工协作处理复杂任务。
+- **Undefined 自身代码查阅 Agent**：内置 `undefined_self_code_agent`，可只读查询当前 Undefined 仓库的源码、测试、文档、资源、脚本、配置示例和 App 实现细节；访问范围受白名单约束，不写代码、不运行命令，并与 NagaAgent 代码分析职责分离。
 - **callable.json 共享机制**：通过简单的配置文件（`callable.json`）即可让 Agent 互相调用、将 `skills/tools/` 或 `skills/toolsets/` 下的工具按白名单暴露给 Agent，支持细粒度访问控制，实现复杂的多 Agent 协作场景。
 - **Agent 自我介绍自动生成**：启动时按 Agent 代码/配置 hash 生成 `intro.generated.md`（第一人称、结构化），与 `intro.md` 合并后作为描述；减少手动维护，保持能力说明与实现同步，有助于精准调度。
 - **请求上下文管理**：基于 Python `contextvars` 的统一请求上下文系统，自动 UUID 追踪，零竞态条件，完全的并发隔离。
@@ -60,8 +60,8 @@
 - **MCP 协议支持**：支持通过 MCP (Model Context Protocol) 连接外部工具和数据源，扩展 AI 能力。
 - **Agent 私有 MCP**：可为单个 agent 提供独立 MCP 配置，按调用即时加载并释放，工具仅对该 agent 可见。
 - **Anthropic Skills**：支持 Anthropic Agent Skills（SKILL.md 格式），遵循 agentskills.io 开放标准，提供领域知识注入能力。
-- **Bilibili 视频提取**：自动检测消息中的 B 站视频链接/BV 号/小程序分享，下载 1080p 视频并通过 QQ 发送；同时提供 AI 工具调用入口。
-- **arXiv 论文提取与搜索**：自动检测消息中的 arXiv 链接/标识并发送论文信息与 PDF；同时提供 `arxiv_paper` 发送工具和 `arxiv_search` 检索工具。
+- **Bilibili 视频提取与分析**：自动检测消息中的 B 站视频链接/BV 号/小程序分享，下载视频并通过 QQ 合并转发；`bilibili_video` 也可只返回附件 UID，供 `file_analysis_agent` 做视频内容分析。
+- **arXiv 论文提取、搜索与分析**：自动检测消息中的 arXiv 链接/标识并发送论文信息与 PDF；`arxiv_paper` 也可只返回 PDF 附件 UID，供 `file_analysis_agent` 做文本提取或指定页视觉分析；`arxiv_search` 负责论文检索。
 - **GitHub 仓库卡片**：自动检测 GitHub 仓库链接或 `owner/repo` 仓库 ID，获取 public 仓库信息并发送简洁图片卡片，展示头像、简介、stars、forks、issues、contributors 等概览。
 - **自动处理管线**：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.6.0 → undefined_bot-3.6.1}/pyproject.toml

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

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

{undefined_bot-3.6.0 → undefined_bot-3.6.1}/src/Undefined/arxiv/sender.py

@@ -4,8 +4,9 @@ from __future__ import annotations
 
 import asyncio
 import logging
+from pathlib import Path
 import time
-from typing import TYPE_CHECKING, Literal
+from typing import TYPE_CHECKING, Any, Literal
 
 from Undefined.arxiv.client import get_paper_info
 from Undefined.arxiv.downloader import cleanup_download_path, download_paper_pdf
@@ -144,6 +145,43 @@ async def _send_file_message(
         await sender.send_private_file(target_id, file_path, file_name)
 
 
+def _build_uid_message(info: PaperInfo, uid: str, file_name: str) -> str:
+    title = info.title or f"arXiv:{info.paper_id}"
+    lines = [
+        f"已获取 arXiv 论文 PDF：{title}",
+        f"ID: {info.paper_id}",
+        f'PDF: <attachment uid="{uid}"/>',
+    ]
+    if file_name:
+        lines.append(f"文件名: {file_name}")
+    if info.abs_url:
+        lines.append(info.abs_url)
+    return "\n".join(lines)
+
+
+async def _register_pdf_attachment(
+    *,
+    attachment_registry: Any,
+    scope_key: str,
+    pdf_path: Path,
+    info: PaperInfo,
+) -> str:
+    record = await attachment_registry.register_local_file(
+        scope_key,
+        pdf_path,
+        kind="file",
+        display_name=pdf_path.name,
+        source_kind="arxiv_paper",
+        source_ref=info.pdf_url or _build_pdf_url(info.paper_id),
+        segment_data={
+            "paper_id": info.paper_id,
+            "abs_url": info.abs_url,
+            "pdf_url": info.pdf_url or _build_pdf_url(info.paper_id),
+        },
+    )
+    return _build_uid_message(info, str(record.uid), pdf_path.name)
+
+
 async def _send_arxiv_paper_once(
     *,
     paper_id: str,
@@ -205,6 +243,60 @@ async def _send_arxiv_paper_once(
         await cleanup_download_path(task_dir)
 
 
+async def fetch_arxiv_paper_attachment(
+    *,
+    paper_id: str,
+    attachment_registry: Any,
+    scope_key: str,
+    max_file_size: int,
+    author_preview_limit: int,
+    summary_preview_chars: int,
+    context: dict[str, object] | None = None,
+) -> str:
+    """下载 arXiv PDF 并注册为附件 UID，不发送消息。"""
+    normalized = normalize_arxiv_id(paper_id)
+    if normalized is None:
+        return f"无法解析 arXiv 标识: {paper_id}"
+
+    if attachment_registry is None:
+        return "缺少必要的运行时组件（attachment_registry）"
+    if not str(scope_key or "").strip():
+        return "无法确定附件作用域，不能注册 arXiv PDF"
+
+    info: PaperInfo
+    metadata_ready = True
+    try:
+        info = await get_paper_info(normalized, context=context)
+    except Exception:
+        metadata_ready = False
+        info = _minimal_paper_info(normalized)
+        logger.exception("[arXiv] 获取论文元信息失败: paper=%s", normalized)
+
+    download_result, task_dir = await download_paper_pdf(
+        info,
+        max_file_size_mb=max_file_size,
+        context=context,
+    )
+    try:
+        if download_result.path is None:
+            info_message = _build_info_message(
+                info,
+                author_preview_limit=author_preview_limit,
+                summary_preview_chars=summary_preview_chars,
+            )
+            if metadata_ready:
+                return f"未能下载 PDF，已获取论文信息：\n{info_message}"
+            return f"未能下载 PDF，已获取论文最小信息：\n{info_message}"
+        return await _register_pdf_attachment(
+            attachment_registry=attachment_registry,
+            scope_key=scope_key,
+            pdf_path=download_result.path,
+            info=info,
+        )
+    finally:
+        await cleanup_download_path(task_dir)
+
+
 async def send_arxiv_paper(
     *,
     paper_id: str,

{undefined_bot-3.6.0 → undefined_bot-3.6.1}/src/Undefined/bilibili/sender.py

@@ -16,6 +16,7 @@ from Undefined.bilibili.downloader import (
 )
 from Undefined.bilibili.models import DanmakuItem
 from Undefined.bilibili.parser import normalize_to_bvid
+from Undefined.utils.io import get_file_size
 
 if TYPE_CHECKING:
     from Undefined.bilibili.downloader import VideoInfo
@@ -142,6 +143,27 @@ def _build_video_history_message(
     return "\n".join(lines)
 
 
+def _build_uid_message(
+    info: "VideoInfo",
+    *,
+    uid: str,
+    quality_name: str | None,
+    file_size_mb: float | None,
+    file_name: str,
+) -> str:
+    lines = [
+        f"已获取 Bilibili 视频：{info.title}",
+        f"BV: {info.bvid}",
+        f'视频: <attachment uid="{uid}"/>',
+    ]
+    if quality_name and file_size_mb is not None:
+        lines.append(f"清晰度: {quality_name} | 大小: {file_size_mb:.1f}MB")
+    if file_name:
+        lines.append(f"文件名: {file_name}")
+    lines.append(info.url)
+    return "\n".join(lines)
+
+
 def _build_danmaku_text(item: DanmakuItem) -> str:
     return f"[{_format_progress(item.progress_ms)}] {item.content}"
 
@@ -289,7 +311,7 @@ async def send_bilibili_video(
             )
             info_prefix = f"({video_status})"
         else:
-            file_size_mb = video_path.stat().st_size / 1024 / 1024
+            file_size_mb = await get_file_size(video_path) / 1024 / 1024
             max_size = max_file_size if max_file_size > 0 else float("inf")
 
             if file_size_mb > max_size:
@@ -310,7 +332,7 @@ async def send_bilibili_video(
                         max_duration=max_duration,
                     )
                     if video_path is not None:
-                        file_size_mb = video_path.stat().st_size / 1024 / 1024
+                        file_size_mb = await get_file_size(video_path) / 1024 / 1024
 
                 if video_path is not None and file_size_mb is not None:
                     if file_size_mb > max_size:
@@ -403,6 +425,107 @@ async def send_bilibili_video(
             cleanup_file(video_path)
 
 
+async def fetch_bilibili_video_attachment(
+    video_id: str,
+    *,
+    attachment_registry: Any,
+    scope_key: str,
+    cookie: str = "",
+    prefer_quality: int = 80,
+    max_duration: int = 0,
+    max_file_size: int = 0,
+    oversize_strategy: str = "downgrade",
+    sessdata: str = "",
+) -> str:
+    """下载 Bilibili 视频并注册为附件 UID，不发送消息。"""
+    bvid = await normalize_to_bvid(video_id)
+    if not bvid:
+        return f"无法解析视频标识: {video_id}"
+    if attachment_registry is None:
+        return "缺少必要的运行时组件（attachment_registry）"
+    if not str(scope_key or "").strip():
+        return "无法确定附件作用域，不能注册 Bilibili 视频"
+
+    if not cookie and sessdata:
+        cookie = sessdata
+
+    video_path: Path | None = None
+    video_info: VideoInfo | None = None
+    actual_qn = 0
+    file_size_mb: float | None = None
+
+    try:
+        video_path, video_info, actual_qn = await download_video(
+            bvid=bvid,
+            cookie=cookie,
+            prefer_quality=prefer_quality,
+            max_duration=max_duration,
+        )
+        if video_path is None:
+            return f"视频时长 {_format_duration(video_info.duration)} 超过限制，未下载视频文件"
+
+        file_size_mb = await get_file_size(video_path) / 1024 / 1024
+        max_size = max_file_size if max_file_size > 0 else float("inf")
+
+        if file_size_mb > max_size:
+            if oversize_strategy == "downgrade" and actual_qn > 32:
+                cleanup_file(video_path)
+                video_path = None
+                lower_qn = _get_lower_quality(actual_qn)
+                logger.info(
+                    "[Bilibili] 文件 %.1fMB 超限 %dMB，UID 模式降级到 qn=%d 重试",
+                    file_size_mb,
+                    max_file_size,
+                    lower_qn,
+                )
+                video_path, video_info, actual_qn = await download_video(
+                    bvid=bvid,
+                    cookie=cookie,
+                    prefer_quality=lower_qn,
+                    max_duration=max_duration,
+                )
+                if video_path is None:
+                    return "降级后仍未下载到视频文件"
+                file_size_mb = await get_file_size(video_path) / 1024 / 1024
+
+            if file_size_mb > max_size:
+                return f"视频文件 {file_size_mb:.1f}MB 超过限制，未注册附件"
+
+        quality_name = QUALITY_MAP.get(actual_qn, str(actual_qn)) if actual_qn else None
+        record = await attachment_registry.register_local_file(
+            scope_key,
+            video_path,
+            kind="file",
+            display_name=video_path.name,
+            source_kind="bilibili_video",
+            source_ref=video_info.url,
+            segment_data={
+                "bvid": video_info.bvid,
+                "url": video_info.url,
+                "title": video_info.title,
+                "quality": quality_name or "",
+            },
+        )
+        return _build_uid_message(
+            video_info,
+            uid=str(record.uid),
+            quality_name=quality_name,
+            file_size_mb=file_size_mb,
+            file_name=video_path.name,
+        )
+    except Exception as exc:
+        logger.exception("[Bilibili] UID 模式处理视频失败: %s", bvid)
+        if video_info is None:
+            try:
+                video_info = await get_video_info(bvid, cookie=cookie)
+            except Exception:
+                return f"视频处理失败：无法获取视频信息: {exc}"
+        return f"视频处理失败：{exc}"
+    finally:
+        if video_path is not None:
+            cleanup_file(video_path)
+
+
 def _get_lower_quality(current_qn: int) -> int:
     """获取比当前清晰度低一级的 qn。"""
     ordered = sorted(QUALITY_MAP.keys(), reverse=True)

{undefined_bot-3.6.0 → undefined_bot-3.6.1}/src/Undefined/skills/agents/README.md

@@ -260,33 +260,51 @@ mv skills/tools/my_tool skills/agents/my_agent/tools/
 ## 现有 Agents
 
 ### web_agent（网络搜索助手）
-- **功能**：网页搜索和网页内容获取
-- **适用场景**：获取互联网最新信息、搜索新闻、爬取网页内容
-- **子工具**：`grok_search`, `web_search`, `crawl_webpage`
+- **功能**：联网搜索、网页阅读、来源核验和最新信息获取。
+- **适用场景**：新闻/公告/资料搜索、指定 URL 摘要、多来源对比、时效性问题核验。
+- **不适用**：天气、金价、热搜、Whois、B 站、arXiv 检索等结构化查询；用户附件或文件解析。
+- **子工具**：`grok_search`, `web_search`, `crawl_webpage`。
 - **grok_search 参数**：优先使用 `search_request`，用自然语言完整叙述搜索要求，不要只传关键词。
 
 ### file_analysis_agent（文件分析助手）
-- **功能**：分析代码、PDF、Docx、Xlsx 等多种格式文件
-- **适用场景**：代码分析、文档解析、文件内容提取
-- **子工具**：`read_file`, `analyze_code`, `analyze_pdf`, `analyze_docx`, `analyze_xlsx`
+- **功能**：分析用户提供的附件、内部 UID、URL、legacy file_id、arXiv 论文标识或 Bilibili 视频标识，提取文件内容。
+- **适用场景**：PDF/Word/Excel/PPT/文本/代码/压缩包解析，图片、音频、视频等多模态内容识别，arXiv 论文 PDF 分析，Bilibili 视频内容分析。
+- **不适用**：没有文件来源的开放式搜索、需要联网查资料的问题、执行文件或安全鉴定。
+- **子工具**：`download_file`, `detect_file_type`, `read_text_file`, `extract_pdf`, `describe_pdf_page`, `extract_docx`, `extract_xlsx`, `extract_pptx`, `extract_archive`, `analyze_code`, `analyze_multimodal`, `cleanup_temp`；还可调用共享主工具 `arxiv_paper(output_mode=uid)` 与 `bilibili_video(output_mode=uid)` 获取待分析附件 UID。
 
 ### naga_code_analysis_agent（NagaAgent 代码分析助手）
-- **功能**：专门用于分析 NagaAgent 框架源码
-- **适用场景**：深入分析 NagaAgent 架构、模块实现、代码线索
-- **子工具**：`read_file`, `list_directory`, `glob`, `search_file_content`, `read_naga_intro`
+- **功能**：只读分析 NagaAgent 项目的结构、源码、配置、构建、部署和实现细节。
+- **适用场景**：追踪 NagaAgent 模块实现、目录结构、配置项、报错线索和项目内文档。
+- **不适用**：Undefined 自身源码、用户上传文件、代码编写修改、执行验证或外部联网搜索。
+- **子工具**：`read_file`, `list_directory`, `glob`, `search_file_content`, `read_naga_intro`。
 
 ### undefined_self_code_agent（Undefined 自身代码查阅助手）
-- **功能**：只读查阅 Undefined 当前仓库的源码、测试、文档、资源、脚本、配置示例和 App 实现
-- **适用场景**：解释 Undefined 自身实现、定位模块、核对配置示例、查看测试覆盖
-- **访问范围**：`src/`, `scripts/`, `tests/`, `res/`, `docs/`, `apps/`, `README.md`, `CHANGELOG.md`, `ARCHITECTURE.md`, `config.toml.example`
-- **子工具**：`read_file`, `list_directory`, `glob`, `search_file_content`
+- **功能**：只读查阅 Undefined 当前仓库的源码、测试、文档、资源、脚本、配置示例和 App 实现。
+- **适用场景**：解释 Undefined 自身实现、定位模块、核对配置示例、查看测试覆盖。
+- **访问范围**：`src/`, `scripts/`, `tests/`, `res/`, `docs/`, `apps/`, `README.md`, `CHANGELOG.md`, `ARCHITECTURE.md`, `config.toml.example`。
+- **不适用**：写代码、改文件、运行命令、验证打包、NagaAgent 子模块、用户上传文件解析。
+- **子工具**：`read_file`, `list_directory`, `glob`, `search_file_content`。
 
 ### info_agent（信息查询助手）
-- **功能**：查询天气、热搜、历史、WHOIS、B 站信息、arXiv 检索等
-- **适用场景**：天气查询、热点榜单、域名查询、B 站视频和 UP 主信息查询、论文搜索
-- **子工具**：`weather_query`, `*hot`, `whois`, `bilibili_search`, `bilibili_user_info`, `arxiv_search`
+- **功能**：调用结构化工具完成参数明确的信息查询。
+- **适用场景**：天气、金价、热搜、历史、Whois、网络诊断、测速、编码/哈希、B 站、QQ 等级、arXiv 检索。
+- **不适用**：开放式网页搜索、网页阅读、来源核验、文件解析或长篇研究。
+- **子工具**：`weather_query`, `gold_price`, `baiduhot`, `weibohot`, `douyinhot`, `history`, `whois`, `net_check`, `speed`, `tcping`, `base64`, `hash`, `bilibili_search`, `bilibili_user_info`, `qq_level_query`, `arxiv_search`。
 
 ### entertainment_agent（娱乐助手）
-- **功能**：运势、小说、创意内容与随机视频推荐等娱乐功能
-- **适用场景**：查看运势、获取休闲内容、随机刷视频
-- **子工具**：`horoscope`, `novel_search`, `ai_draw_one`, `video_random_recommend`
+- **功能**：轻松互动、趣味内容和休闲创作。
+- **适用场景**：AI 绘画、参考图生图、星座运势、趣味占卜、随机内容、Minecraft 皮肤/头像渲染、小说搜索、表情包或反应图需求。
+- **不适用**：严肃专业建议、事实核验、新闻资料搜索、文件内容解析。
+- **子工具**：`ai_draw_one`, `horoscope`, `minecraft_skin`, `renjian`, `wenchang_dijun`。
+
+### summary_agent（消息总结助手）
+- **功能**：按条数或时间范围拉取聊天记录并生成客观总结。
+- **适用场景**：总结最近 N 条消息、过去一段时间的讨论、指定主题的结论、待办、参与者贡献和链接资源。
+- **不适用**：实时监控、情绪评判、未来预测、脱离聊天记录的推测；`/summary` 与 `/sum` 斜杠命令由命令层直连 summary 模型。
+- **子工具**：`fetch_messages`。
+
+### code_delivery_agent（代码交付助手）
+- **功能**：把代码需求实现为可交付的文件或工程。
+- **适用场景**：单文件脚本/配置/文档交付，多文件工程创建、修改、调试、测试和打包，从空目录或 Git 仓库开始。
+- **不适用**：只读源码讲解、用户上传文件解析、单纯资料调研。
+- **子工具**：`init_docker`, `read`, `write`, `copy`, `delete`, `tree`, `glob`, `grep`, `diff`, `run_bash_command`, `todo`, `end`。

undefined_bot-3.6.1/src/Undefined/skills/agents/code_delivery_agent/intro.md

@@ -0,0 +1,16 @@
+# 代码交付助手
+
+用于把用户的代码需求实际做成可交付文件或工程。
+
+可处理：
+- 单个脚本、配置、文档等轻量文本文件交付
+- 多文件工程创建、修改、调试、测试和打包
+- 从空目录开始，或从 Git 仓库指定分支/tag/commit 开始
+- 在隔离 Docker 容器中安装依赖、执行命令和运行验证
+
+不适合：
+- 只读解释 Undefined 源码，交给 `undefined_self_code_agent`
+- 只读解释 NagaAgent 源码，交给 `naga_code_analysis_agent`
+- 用户上传文件内容解析，交给 `file_analysis_agent`
+
+调用时需要明确任务目标、初始化来源、交付目标类型和目标 ID。

undefined_bot-3.6.1/src/Undefined/skills/agents/code_delivery_agent/prompt.md

@@ -0,0 +1,20 @@
+你是代码交付助手，负责把用户需求实现为可交付的代码、配置、文档或工程包。
+
+能力边界：
+- 可以编写、修改、调试和验证代码。
+- 多文件或需要命令验证的任务在隔离 Docker 容器中完成。
+- 所有容器内文件操作限制在 `/workspace`，默认工作目录也是 `/workspace`。
+- 不负责只读源码讲解、外部文件解析或联网资料调研；这些应交给对应 agent。
+
+工具使用原则：
+- 单个脚本、配置或文档，且不需要依赖安装、编译或测试时，优先使用轻量文本文件交付工具，避免初始化 Docker。
+- 多文件工程、Git 仓库任务、需要安装依赖、运行命令、测试或打包时，先初始化 Docker，再使用读写、搜索、命令和打包工具完成。
+- 复杂任务用 `todo` 维护进度；简单任务可以直接完成。
+- 安装依赖前先确认容器环境，命令失败要读取输出、分析原因并修复。
+- 不假设验证成功；能运行测试、构建或最小可执行检查时就实际运行。
+
+交付要求：
+- 从空目录开始的工程应包含 README.md，并说明项目用途、运行方式和验证方式。
+- 文档要和最终代码一致。
+- 调用 `end` 打包时排除不该交付的缓存和依赖目录，例如 `.git/**`、`.venv/**`、`__pycache__/**`、`.pytest_cache/**`、`node_modules/**`、`.mypy_cache/**`、`.ruff_cache/**`。
+- 最终说明完成了什么、如何运行、验证结果和任何未完成或受限事项。

undefined_bot-3.6.1/src/Undefined/skills/agents/entertainment_agent/intro.md

@@ -0,0 +1,16 @@
+# 娱乐与轻内容助手
+
+用于轻松互动、趣味内容和休闲创作。
+
+可处理：
+- AI 绘画、参考图生图、创意画面生成
+- 星座运势、趣味占卜、随机句子和轻松内容
+- 随机短视频推荐、Minecraft 皮肤/头像渲染
+- 小说搜索与阅读、轻量学习提示
+- 表情包或反应图相关需求
+
+不适合：
+- 严肃专业建议、事实核验、新闻和资料搜索
+- 文件内容解析或图像客观识别，交给 `file_analysis_agent`
+
+AI 绘画如需参考当前会话图片，应直接使用可访问的图片 UID，不要把参考图改写成纯文本描述替代。

undefined_bot-3.6.1/src/Undefined/skills/agents/entertainment_agent/prompt.md

@@ -0,0 +1,19 @@
+你是娱乐与轻内容助手，负责轻松互动、趣味内容和休闲创作。
+
+能力边界：
+- 适合 AI 绘画、趣味占卜、随机内容、视频推荐、Minecraft 皮肤/头像渲染、小说搜索和轻量学习提示。
+- 不负责严肃资讯核验、网页搜索或结构化查询；这些交给 `web_agent` 或 `info_agent`。
+- 不负责文件内容识别或附件分析；这些交给 `file_analysis_agent`。
+- 学习类回复保持启发式和简洁，不代写作业，不给误导性结论。
+
+工具使用原则：
+- 用户明确要“随机视频”“刷个视频”时，优先使用视频推荐工具。
+- 用户明确要求参考当前会话图片生图时，调用 `ai_draw_one` 并传入 `reference_image_uids`；不要把参考图改写成长段纯文本提示替代。
+- 只有用户明确要表情包，或本轮适合纯表情包/反应图回复时，才使用表情包工具；表情包应单独发送，不和正文混在一起。
+- 如果需要图文混排，只引用真实存在的 `<attachment uid="..."/>`，不要臆造 UID，也不要改成 Markdown 图片。
+- 相对时间相关问题如“今日运势”，如有当前时间工具，先校准日期。
+
+回答要求：
+- 语气轻松，内容简洁，有互动感。
+- 不过度承诺，不编造工具结果。
+- 用户偏好不明确且会明显影响结果时，先问一个关键偏好；否则直接给出可用结果。

{undefined_bot-3.6.0 → undefined_bot-3.6.1}/src/Undefined/skills/agents/file_analysis_agent/README.md

@@ -1,16 +1,18 @@
 # file_analysis_agent 智能体
 
-用于文件解析与分析（PDF/Word/Excel/PPT 等），并支持代码分析与多模态解析。
+用于文件解析与分析（PDF/Word/Excel/PPT 等），并支持代码分析、多模态解析、arXiv 论文 PDF 获取分析和 Bilibili 视频获取分析。
 
 目录结构：
 - `config.json`：智能体定义
 - `intro.md`：能力说明
 - `prompt.md`：系统提示词
 - `tools/`：文件解析与分析工具
+- 共享主工具：通过 callable 仅可调用 `arxiv_paper(output_mode=uid)` 与 `bilibili_video(output_mode=uid)`，用于把 arXiv / Bilibili 标识转换为当前会话附件 UID 后再分析
 
 运行机制：
 - 由 `AgentRegistry` 自动发现并注册
 - 通过 `prompt` 输入任务描述并调用内部工具
+- PDF 文字提取走 `extract_pdf`；扫描版、图表、版式或指定页码范围视觉分析走 `describe_pdf_page`
 
 开发提示：
 - 解析类工具尽量使用异步 I/O 或 `asyncio.to_thread`

{undefined_bot-3.6.0 → undefined_bot-3.6.1}/src/Undefined/skills/agents/file_analysis_agent/config.json

@@ -2,17 +2,17 @@
     "type": "function",
     "function": {
         "name": "file_analysis_agent",
-        "description": "文件分析助手，支持解析各种文件格式：文档（PDF、Word、PPT、Excel）、代码、压缩包、图片、音频、视频等。参数优先使用内部附件 UID，也兼容 URL 或 legacy file_id。",
+        "description": "文件分析助手，支持解析各种文件格式：文档（PDF、Word、PPT、Excel）、代码、压缩包、图片、音频、视频等。参数优先使用内部附件 UID，也兼容 URL、legacy file_id、arXiv ID/URL 和 Bilibili BV/AV/URL。",
         "parameters": {
             "type": "object",
             "properties": {
                 "file_source": {
                     "type": "string",
-                    "description": "文件源。优先传内部附件 UID（例如 pic_xxx / file_xxx）；也兼容 URL 或 QQ 的 legacy file_id"
+                    "description": "文件源。优先传内部附件 UID（例如 pic_xxx / file_xxx）；也兼容 URL、QQ 的 legacy file_id、arXiv ID/URL、Bilibili BV/AV/URL"
                 },
                 "prompt": {
                     "type": "string",
-                    "description": "告诉分析助手需要从文件中「识别或提取」什么。只描述内容层面的任务，不要把需要外部知识才能回答的问题交给它。正确示例：'识别图中的游戏名称和角色信息'、'提取截图中的错误信息和堆栈'、'提取所有邮件地址'、'统计代码行数'。错误示例：'分析这个角色怎么养成'（需要搜索，应拆分给 web_agent）"
+                    "description": "告诉分析助手需要从文件中「识别或提取」什么。只描述内容层面的任务，不要把需要外部知识才能回答的问题交给它。正确示例：'识别图中的游戏名称和角色信息'、'描述 PDF 第 3-5 页的图表'、'提取截图中的错误信息和堆栈'、'提取所有邮件地址'、'统计代码行数'。错误示例：'分析这个角色怎么养成'（需要搜索，应拆分给 web_agent）"
                 }
             },
             "required": ["file_source"]