Undefined-bot 3.18.0__tar.gz → 3.18.2__tar.gz

{undefined_bot-3.18.0 → undefined_bot-3.18.2}/ARCHITECTURE.md

@@ -121,7 +121,7 @@ graph TB
         end
         
         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_Info["info_agent<br/>信息查询助手<br/>(17个工具)<br/>• weather_query<br/>• *hot 热搜<br/>• bilibili_*<br/>• arxiv_search<br/>• jm_search<br/>• whois"]
             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"]

{undefined_bot-3.18.0 → undefined_bot-3.18.2}/CHANGELOG.md

@@ -1,3 +1,25 @@
+## v3.18.2 禁漫列表查询工具
+
+本版本给 `info_agent` 新增 `jm_search` 工具：AI 可以直接查询禁漫本子列表（关键词检索 / 分类浏览 / 日周月排行），拿到车号后再由主 AI 的 `jm_book` 取详情或 PDF；工具本身只查列表，不下载也不发送。
+
+- 新增 `jm_search` 工具（`src/Undefined/skills/agents/info_agent/tools/jm_search/`）与领域层 `src/Undefined/jm/searcher.py`：`mode=search` 关键词检索、`mode=browse` 分类浏览（不需要关键词）、`mode=ranking` 日/周/月排行，三种模式共用 `genre` 大分类与 `page` 翻页；返回车号（`JM<数字>`）、标题、作者、分类与更新时间，`n` 默认 5、上限 20。
+- 筛选参数：`target`（站内/作品/作者/标签/角色）、`sort`（最新/观看/图片/点赞/评分/评论）、`time_range`（`all`/`day`/`week`/`month`，`mode=ranking` 时表示日榜/周榜/月榜，`all` 等同 jmcpy 默认的周榜）、`genre`（同人/单行本/短篇/汉漫/美漫/3D/英译站等）与 `sub_genre`（中文/日文/CG 等）；副分类必须与 `genre` 同时给出，且只有网页端接口支持，网页端被反爬拦截时直接返回失败原因。
+- 参数校验与提示：`mode=search` 必须提供 `msg`（至少 2 个字，纯数字车号会直接定位到该本子），`mode=browse` / `ranking` 带关键词会被拦下并提示改用 `mode=search`；`ranking` 固定按观看数排序，显式传其它 `sort` 时提示改用 `browse`；非法枚举值回显可选值。
+- 结果表头写明模式与生效筛选（如 `🏆 禁漫日榜（同人 / CG）`）；分类页与排行榜不返回总数，这类结果只提示「需要更多结果时可用 page=N+1 继续」，只有确实知道总页数时才说「还有更多」。
+- 工具仅 `info_agent` 可见（不带 `callable.json`），域层通过 `skills/shared.py` 桥接；查询复用 `[jm]` 的代理、`request_timeout` 与 `session_dir`，且**不受** `[jm].auto_extract_enabled` 影响——该开关只约束自动提取管线。
+
+---
+
+## v3.18.1 JM 本子文件改到转发外发送
+
+本版本修复禁漫自动提取的加密 PDF 在合并转发节点里下载失败的问题：转发退回「本子信息 / 解密密码」两个节点，PDF 改为转发之后单独发一条文件消息。
+
+- 加密 PDF 不再放进合并转发：转发节点里的文件在 QQ 客户端下载会失败，改为紧随转发之后单独发送（群聊走群文件上传、私聊走私聊文件），独立文件消息可以正常下载；群聊下同一个 PDF 仍会出现在群文件列表里。`build_forward_nodes()` 因此不再接收 PDF 路径，没有 PDF 时依然是「本子信息 / 状态」两个节点。
+- 转发与文件分离后的投递语义：转发被协议端**明确拒绝**时退化为「信息 + 密码两条普通消息」，文件照旧单独发送；转发遇到「投递结果未确认」（`delivery_uncertain`）或「文件传输错误」（`file_transfer_error`）时不重发转发与信息/密码（转发可能已经送达），但文件此前从未发出、不算重复投递，仍会继续单独发送，否则整本下载白跑。文件自身投递结果未确认时直接上抛不重发，普通失败时补一条「PDF 上传失败」提示（这条提示写入历史，转发投递未确认时提示里也不会声称信息与密码已经送达）。
+- 发送状态与历史摘要同步：状态前缀改为「已发送合并转发 / 合并转发被拒，已改为普通消息发送信息与密码 / 合并转发投递结果未确认」+「PDF 文件已单独发送」或「PDF 文件发送失败」；写历史时摘要只说「PDF: 加密文件随后单独发送（…，密码见转发节点）」——这条摘要随转发落地、此时文件尚未上传，不能提前声称已发送，文件真正发出后由 `send_group_file` 自己补一条 `[文件] …` 历史记录。密码仍然只出现在转发节点里、不进历史。
+
+---
+
 ## v3.18.0 JM 漫画自动提取
 
 本版本新增禁漫自动提取管线：消息里出现 `JM` 车号或禁漫链接时，自动获取本子详情、把全部章节合成为一个带密码的 PDF，以「本子信息 / 解密密码 / PDF 文件」三节点合并转发发送（文件只放在转发里，群聊下同时进入群文件列表），并新增与 `arxiv_paper` 同构的 `jm_book` 工具供 AI 按需取详情或附件。功能默认关闭，密码随机生成且不写进历史。

{undefined_bot-3.18.0 → undefined_bot-3.18.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: Undefined-bot
-Version: 3.18.0
+Version: 3.18.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
@@ -122,7 +122,7 @@ Description-Content-Type: text/markdown
 - **可选音乐工具集**：配置独立部署的 [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 等概览；API 与头像下载统一遵循 `[github].use_proxy`，头像以内联资源进入离线渲染器。
-- **禁漫（JM）本子提取**：自动检测 `JM`+车号或禁漫链接，下载全部章节并合成为一个 AES-256 加密 PDF，以「本子信息 / 解密密码 / PDF 文件」三节点合并转发发送（文件只在转发里，群聊下同时进入群文件列表），密码每次随机生成且不写入历史；`jm_book` 工具也可只返回本子信息或未加密 PDF 附件 UID，供 `file_analysis_agent` 解析。默认关闭，`[jm].auto_extract_enabled` 打开。详见 [配置说明](docs/configuration.md#4203-jm-禁漫自动提取)。
+- **禁漫（JM）本子提取**：自动检测 `JM`+车号或禁漫链接，下载全部章节并合成为一个 AES-256 加密 PDF，以「本子信息 / 解密密码」两节点合并转发发送，加密 PDF 不进转发、随后单独作为一条文件消息发送（转发里的文件在 QQ 客户端下载会失败，独立文件消息才下得动，群聊下同时进入群文件列表），密码每次随机生成且不写入历史；`jm_book` 工具也可只返回本子信息或未加密 PDF 附件 UID，供 `file_analysis_agent` 解析；`info_agent` 另有 `jm_search` 工具：关键词检索（可限定作者/标签/角色与分类）、分类浏览、日/周/月排行三种模式，返回车号清单。默认关闭，`[jm].auto_extract_enabled` 打开。详见 [配置说明](docs/configuration.md#4203-jm-禁漫自动提取)。
 - **自动处理管线**：Bilibili、arXiv、GitHub、JM 等自动提取统一运行在 `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.18.0 → undefined_bot-3.18.2}/README.md

@@ -70,7 +70,7 @@
 - **可选音乐工具集**：配置独立部署的 [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 等概览；API 与头像下载统一遵循 `[github].use_proxy`，头像以内联资源进入离线渲染器。
-- **禁漫（JM）本子提取**：自动检测 `JM`+车号或禁漫链接，下载全部章节并合成为一个 AES-256 加密 PDF，以「本子信息 / 解密密码 / PDF 文件」三节点合并转发发送（文件只在转发里，群聊下同时进入群文件列表），密码每次随机生成且不写入历史；`jm_book` 工具也可只返回本子信息或未加密 PDF 附件 UID，供 `file_analysis_agent` 解析。默认关闭，`[jm].auto_extract_enabled` 打开。详见 [配置说明](docs/configuration.md#4203-jm-禁漫自动提取)。
+- **禁漫（JM）本子提取**：自动检测 `JM`+车号或禁漫链接，下载全部章节并合成为一个 AES-256 加密 PDF，以「本子信息 / 解密密码」两节点合并转发发送，加密 PDF 不进转发、随后单独作为一条文件消息发送（转发里的文件在 QQ 客户端下载会失败，独立文件消息才下得动，群聊下同时进入群文件列表），密码每次随机生成且不写入历史；`jm_book` 工具也可只返回本子信息或未加密 PDF 附件 UID，供 `file_analysis_agent` 解析；`info_agent` 另有 `jm_search` 工具：关键词检索（可限定作者/标签/角色与分类）、分类浏览、日/周/月排行三种模式，返回车号清单。默认关闭，`[jm].auto_extract_enabled` 打开。详见 [配置说明](docs/configuration.md#4203-jm-禁漫自动提取)。
 - **自动处理管线**：Bilibili、arXiv、GitHub、JM 等自动提取统一运行在 `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.18.0 → undefined_bot-3.18.2}/pyproject.toml

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

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

undefined_bot-3.18.2/src/Undefined/jm/searcher.py

@@ -0,0 +1,278 @@
+"""禁漫列表查询：关键词搜索、分类浏览与排行榜（只读列表，不下载任何图片）。
+
+统一入口 :func:`fetch_listing` 按 ``mode`` 分派到 jmcpy 的 ``Client.search`` /
+``browse`` / ``ranking``，返回一页 ``BookBrief``：只有车号、标题、作者、分类与
+更新时间，不请求正文或图片。查询在 jmcpy 自己的线程里跑，与
+:mod:`Undefined.jm.downloader` 的 ``fetch_book`` 同一形态，不阻塞事件循环。
+
+副分类（``sub_genre``）只有网页端接口支持，门面会自动路由；网页端不可用时
+jmcpy 抛 ``ChallengeBlocked`` 一类异常，由调用方转成可读提示。
+"""
+
+from __future__ import annotations
+
+import asyncio
+from datetime import datetime, timedelta, timezone
+from typing import Any, Literal
+
+from jmcpy import (
+    BookBrief,
+    Client,
+    Genre,
+    Listing,
+    RankingSpan,
+    SearchTarget,
+    SortBy,
+    Settings,
+    SubGenre,
+    TimeRange,
+)
+
+from Undefined.jm.client import build_settings
+
+#: 列表来源：关键词搜索 / 分类浏览 / 排行榜
+JmListingMode = Literal["search", "browse", "ranking"]
+
+#: 展示用时间统一按北京时间（站点面向中文用户，jmcpy 返回的是秒级时间戳）
+_BEIJING_TIMEZONE = timezone(timedelta(hours=8))
+#: 列表项标题缺失时的占位（与 ``sender.format_jm_book_info`` 同一文案）
+_UNKNOWN_TITLE = "未知标题"
+
+_TARGET_LABELS: dict[SearchTarget, str] = {
+    SearchTarget.SITE: "站内",
+    SearchTarget.WORK: "作品",
+    SearchTarget.AUTHOR: "作者",
+    SearchTarget.TAG: "标签",
+    SearchTarget.ACTOR: "角色",
+}
+
+_SORT_LABELS: dict[SortBy, str] = {
+    SortBy.LATEST: "最新",
+    SortBy.VIEWS: "观看数",
+    SortBy.PICTURES: "图片数",
+    SortBy.LIKES: "点赞数",
+    SortBy.SCORE: "评分",
+    SortBy.COMMENTS: "评论数",
+}
+
+_TIME_LABELS: dict[TimeRange, str] = {
+    TimeRange.DAY: "今日",
+    TimeRange.WEEK: "近一周",
+    TimeRange.MONTH: "近一月",
+}
+
+_GENRE_LABELS: dict[Genre, str] = {
+    Genre.DOUJIN: "同人",
+    Genre.SINGLE: "单行本",
+    Genre.SHORT: "短篇",
+    Genre.ANOTHER: "其他",
+    Genre.HANMAN: "汉漫",
+    Genre.MEIMAN: "美漫",
+    Genre.DOUJIN_COSPLAY: "同人Cosplay",
+    Genre.THREE_D: "3D",
+    Genre.ENGLISH_SITE: "英译站",
+}
+
+_SUB_GENRE_LABELS: dict[SubGenre, str] = {
+    SubGenre.CHINESE: "中文",
+    SubGenre.JAPANESE: "日文",
+    SubGenre.CG: "CG",
+    SubGenre.YOUTH: "青年",
+    SubGenre.OTHER: "其他",
+    SubGenre.THREE_D: "3D",
+    SubGenre.COSPLAY: "Cosplay",
+}
+
+#: 排行榜跨度：jmcpy 的 ``RankingSpan`` 与 ``TimeRange`` 的 day/week/month 取值一致
+_RANKING_SPANS: dict[TimeRange, RankingSpan] = {
+    TimeRange.DAY: RankingSpan.DAY,
+    TimeRange.WEEK: RankingSpan.WEEK,
+    TimeRange.MONTH: RankingSpan.MONTH,
+}
+_RANKING_LABELS: dict[TimeRange, str] = {
+    TimeRange.DAY: "日榜",
+    TimeRange.WEEK: "周榜",
+    TimeRange.MONTH: "月榜",
+}
+
+
+def _fetch_sync(
+    settings: Settings,
+    *,
+    mode: JmListingMode,
+    query: str,
+    page: int,
+    target: SearchTarget,
+    sort: SortBy,
+    time_range: TimeRange,
+    genre: Genre,
+    sub_genre: SubGenre | None,
+) -> Listing[BookBrief]:
+    with Client(settings) as client:
+        if mode == "ranking":
+            span = _RANKING_SPANS.get(time_range, RankingSpan.WEEK)
+            return client.ranking(span, page=page, genre=genre, sub_genre=sub_genre)
+        if mode == "browse":
+            return client.browse(
+                page=page,
+                genre=genre,
+                sub_genre=sub_genre,
+                sort=sort,
+                time_range=time_range,
+            )
+        return client.search(
+            query,
+            page=page,
+            target=target,
+            sort=sort,
+            time_range=time_range,
+            genre=genre,
+            sub_genre=sub_genre,
+        )
+
+
+async def fetch_listing(
+    *,
+    config: Any,
+    mode: JmListingMode,
+    query: str = "",
+    page: int = 1,
+    target: SearchTarget = SearchTarget.SITE,
+    sort: SortBy = SortBy.LATEST,
+    time_range: TimeRange = TimeRange.ALL,
+    genre: Genre = Genre.ALL,
+    sub_genre: SubGenre | None = None,
+) -> Listing[BookBrief]:
+    """按模式取一页本子列表（只查列表，线程里跑，不阻塞事件循环）。"""
+    return await asyncio.to_thread(
+        _fetch_sync,
+        build_settings(config),
+        mode=mode,
+        query=query,
+        page=page,
+        target=target,
+        sort=sort,
+        time_range=time_range,
+        genre=genre,
+        sub_genre=sub_genre,
+    )
+
+
+def _format_updated_at(value: int | None) -> str:
+    """把 ``update_at`` 秒级时间戳格式化为北京时间 ``YYYY-MM-DD``。
+
+    缺失或越界的时间戳返回空串：列表里少一个日期，比展示错误时间安全。
+    """
+    if value is None or value <= 0:
+        return ""
+    try:
+        moment = datetime.fromtimestamp(int(value), tz=_BEIJING_TIMEZONE)
+    except (OverflowError, OSError, ValueError):
+        return ""
+    return moment.strftime("%Y-%m-%d")
+
+
+def _taxonomy_titles(book: BookBrief) -> list[str]:
+    """按「大分类 / 副分类」顺序收集非空分类名。"""
+    titles: list[str] = []
+    for taxonomy in (book.category, book.sub_category):
+        if taxonomy is None:
+            continue
+        title = str(taxonomy).strip()
+        if title:
+            titles.append(title)
+    return titles
+
+
+def _format_item(index: int, book: BookBrief) -> str:
+    """把一条结果渲染成「标题行 + 可选明细行」。
+
+    车号写成 ``JM<数字>``：它是后续取详情/附件的标识，比站点链接更适合复制。
+    """
+    lines = [f"{index}. 「JM{book.book_id} {book.title.strip() or _UNKNOWN_TITLE}」"]
+    details: list[str] = []
+    author = book.author.strip()
+    if author:
+        details.append(f"作者: {author}")
+    categories = " / ".join(_taxonomy_titles(book))
+    if categories:
+        details.append(f"分类: {categories}")
+    updated = _format_updated_at(book.updated_at)
+    if updated:
+        details.append(f"更新: {updated}")
+    if details:
+        lines.append("   " + " | ".join(details))
+    return "\n".join(lines)
+
+
+def _category_label(genre: Genre, sub_genre: SubGenre | None) -> str:
+    """把大分类与副分类拼成「同人 / 中文」形式的说明。"""
+    labels = [_GENRE_LABELS.get(genre, "")]
+    if sub_genre is not None:
+        labels.append(_SUB_GENRE_LABELS.get(sub_genre, ""))
+    return " / ".join(label for label in labels if label)
+
+
+def _sort_label(sort: SortBy) -> str:
+    """排序说明；默认的「最新」不写进表头，避免每个表头都挂一句废话。"""
+    if sort is SortBy.LATEST:
+        return ""
+    label = _SORT_LABELS.get(sort, "")
+    return f"按{label}" if label else ""
+
+
+def describe_query(
+    *,
+    mode: JmListingMode,
+    query: str = "",
+    target: SearchTarget = SearchTarget.SITE,
+    sort: SortBy = SortBy.LATEST,
+    time_range: TimeRange = TimeRange.ALL,
+    genre: Genre = Genre.ALL,
+    sub_genre: SubGenre | None = None,
+) -> str:
+    """生成结果表头，说明这批车号是怎么来的（模式 + 生效的筛选条件）。"""
+    if mode == "ranking":
+        heading = f"🏆 禁漫{_RANKING_LABELS.get(time_range, '周榜')}"
+        details = [_category_label(genre, sub_genre)]
+    elif mode == "browse":
+        heading = "📚 禁漫分类浏览"
+        details = [
+            _category_label(genre, sub_genre),
+            _sort_label(sort),
+            _TIME_LABELS.get(time_range, ""),
+        ]
+    else:
+        heading = f"🔍 禁漫搜索「{query}」"
+        details = [
+            "" if target is SearchTarget.SITE else _TARGET_LABELS.get(target, ""),
+            _category_label(genre, sub_genre),
+            _sort_label(sort),
+            _TIME_LABELS.get(time_range, ""),
+        ]
+    qualifiers = "，".join(item for item in details if item)
+    return f"{heading}（{qualifiers}）" if qualifiers else heading
+
+
+def format_listing(listing: Listing[BookBrief], *, heading: str, limit: int) -> str:
+    """把一页结果渲染成可直接返回给模型/用户的文本。"""
+    items = list(listing.items)[: max(0, int(limit))]
+    if not items:
+        return f"{heading}：没有找到结果。"
+
+    header = heading
+    page_count = listing.page_count
+    if listing.total is None:
+        header += f"：第 {listing.page} 页"
+    else:
+        header += f"：共 {listing.total} 条，第 {listing.page}"
+        header += f"/{page_count} 页" if page_count else " 页"
+
+    lines = [header]
+    lines.extend(_format_item(index, book) for index, book in enumerate(items, start=1))
+    if page_count is None:
+        # 分类页与排行榜不返回总数：只能提示「需要更多时」翻页，不谎称一定还有
+        lines.append(f"—— 需要更多结果时可用 page={listing.page + 1} 继续")
+    elif listing.page < page_count:
+        lines.append(f"—— 还有更多结果，可用 page={listing.page + 1} 继续")
+    return "\n".join(lines)

{undefined_bot-3.18.0 → undefined_bot-3.18.2}/src/Undefined/jm/sender.py

@@ -1,6 +1,7 @@
 """禁漫的合并转发发送与附件交付。
 
-自动提取一次发送三个节点：本子信息、PDF 解密密码、PDF 文件（本地合成后随转发上传）。
+自动提取先发「本子信息 + PDF 解密密码」两节点合并转发，随后把本地合成的加密 PDF
+作为独立文件消息单独发出：转发节点里的文件在 QQ 客户端下载会失败，所以文件不进转发。
 工具侧另有两条路：``format_jm_book_info`` 只输出详情（不下载），
 ``fetch_jm_book_attachment`` 下载整本并把**未加密** PDF 注册为附件 UID（不发送），
 供 ``file_analysis_agent`` 继续解析。密码始终不会写进历史。
@@ -117,19 +118,16 @@ def build_password_text(password: str) -> str:
 def build_forward_nodes(
     info_text: str,
     *,
-    pdf_path: Path | None = None,
     password: str = "",
     status_text: str = "",
 ) -> list[dict[str, Any]]:
-    """构建合并转发节点：信息 / 密码或状态 / PDF 文件。
+    """构建合并转发节点：信息 +（密码或状态）。
 
-    PDF 是本地合成好的真实文件，随转发一起上传：群聊下 NapCat 会把它作为群文件上传
-    （``isGroupFile``、``busid=102``，元素里带 ``fileId`` / ``fileMd5`` / ``fileSha1``），
-    因此同一个 PDF 也会出现在群文件列表里，转发节点里的文件可以直接下载
-    （2026-10-01 用 14MB PDF 实测通过）。文件只发一次，不另外发独立文件消息。
+    PDF 不放进转发：转发节点里的文件在 QQ 客户端下载会失败，改由 :func:`_send_result`
+    在转发之后单独发一条文件消息（2026-10-01 实测，同一份文件独立发送可正常下载）。
     """
-    if pdf_path is None:
-        # 没有可发送的 PDF 时用状态说明替代密码与文件节点
+    if not password:
+        # 没有可发送的 PDF 时用状态说明替代密码节点
         return [
             _node(info_text, name="本子信息"),
             _node(status_text or "PDF 未发送", name="状态"),
@@ -137,18 +135,6 @@ def build_forward_nodes(
     return [
         _node(info_text, name="本子信息"),
         _node(build_password_text(password), name="解密密码"),
-        _node(
-            [
-                {
-                    "type": "file",
-                    "data": {
-                        "file": f"file://{pdf_path.resolve()}",
-                        "name": pdf_path.name,
-                    },
-                }
-            ],
-            name="PDF",
-        ),
     ]
 
 
@@ -161,8 +147,10 @@ def build_history_message(result: JmDownload) -> str:
         f"章节: {result.chapter_count} 章 | 页数: {result.page_count}",
     ]
     if result.ok:
+        # 这条摘要随转发写入，此时文件还没上传：不能提前声称已发送。
+        # 上传成功时 send_group_file 会自己补一条「[文件] … 」历史，失败时补提示。
         lines.append(
-            f"PDF: 已发送加密文件（{_format_size(result.size_bytes)}，密码见转发节点）"
+            f"PDF: 加密文件随后单独发送（{_format_size(result.size_bytes)}，密码见转发节点）"
         )
     else:
         lines.append("PDF: 未发送")
@@ -332,6 +320,12 @@ def _is_fatal_delivery_error(exc: BaseException) -> bool:
     )
 
 
+#: 转发投递结果的三态，既进日志也拼进返回值
+_FORWARD_SENT = "已发送合并转发"
+_FORWARD_REJECTED = "合并转发被拒，已改为普通消息发送信息与密码"
+_FORWARD_UNCERTAIN = "合并转发投递结果未确认"
+
+
 async def _send_result(
     sender: "MessageSender",
     target_type: Literal["group", "private"],
@@ -343,57 +337,68 @@ async def _send_result(
     pdf_path: Path,
     history_message: str,
 ) -> str:
-    """发送「信息 + 密码 + PDF」三节点合并转发，返回可记录的真实投递状态。
-
-    文件只在转发里，不再额外发独立文件消息。群聊下这次上传会让 PDF 同时出现在群的
-    文件列表里（``busid=102``），那是 QQ 自己的行为，不是我们单独发出去的。
-    投递未确认 / 文件传输错误一律上抛，只有协议端**明确拒绝**才降级重发；降级时
-    文件没有别的入口，必须补发一条独立文件消息，否则用户拿不到 PDF。
+    """发送「信息 + 密码」合并转发，再单独发送 PDF 文件，返回可记录的真实投递状态。
+
+    文件不进转发：转发节点里的文件在 QQ 客户端下载会失败，独立文件消息才下得动。
+    转发被协议端**明确拒绝**时降级为两条普通消息（信息 / 密码）。投递结果未确认
+    （``delivery_uncertain`` / ``file_transfer_error``）时不能降级重发信息与密码——
+    转发可能已经送达；但文件是另一条消息、此前从未发出，必须继续单独发送，否则用户
+    整本下载白跑。文件自身投递结果未确认时同样不重发，直接上抛调用方；普通失败时补
+    一条写入历史的「PDF 上传失败」提示，转发投递未确认时提示不声称信息与密码已送达。
     """
-    nodes = build_forward_nodes(info_text, pdf_path=pdf_path, password=password)
+    nodes = build_forward_nodes(info_text, password=password)
+    forward_status = _FORWARD_SENT
     try:
         await _send_forward(
             sender, target_type, target_id, nodes, history_message=history_message
         )
     except Exception as exc:
         if _is_fatal_delivery_error(exc):
-            logger.error("[JM] 合并转发投递结果未确认，不重发: book=%s", book_id)
-            raise
-        logger.exception("[JM] 合并转发失败，回退为普通消息 + 文件: book=%s", book_id)
-        # 历史里不留密码：历史摘要与用户可见正文分开；密码消息只记「已单独发送」
-        await _send_text(
-            sender,
-            target_type,
-            target_id,
-            info_text,
-            history_message=history_message,
-        )
-        await _send_text(
-            sender,
-            target_type,
-            target_id,
-            build_password_text(password),
-            history_message="[JM] PDF 解密密码已单独发送",
-        )
-        try:
-            await _send_file(
-                sender, target_type, target_id, str(pdf_path), str(pdf_path.name)
+            logger.error(
+                "[JM] 合并转发投递结果未确认，不重发信息与密码，继续单独发送 PDF: book=%s",
+                book_id,
+            )
+            forward_status = _FORWARD_UNCERTAIN
+        else:
+            logger.exception(
+                "[JM] 合并转发失败，回退为普通消息发送信息与密码: book=%s", book_id
+            )
+            forward_status = _FORWARD_REJECTED
+            # 历史里不留密码：历史摘要与用户可见正文分开；密码消息只记「已单独发送」
+            await _send_text(
+                sender,
+                target_type,
+                target_id,
+                info_text,
+                history_message=history_message,
             )
-        except Exception as file_exc:
-            if _is_fatal_delivery_error(file_exc):
-                logger.error("[JM] 文件投递结果未确认，不重发: book=%s", book_id)
-                raise
-            logger.exception("[JM] 降级后的 PDF 文件发送失败: book=%s", book_id)
             await _send_text(
                 sender,
                 target_type,
                 target_id,
-                "PDF 上传失败，本次没有发送文件（信息与密码如上）。",
-                auto_history=False,
+                build_password_text(password),
+                history_message="[JM] PDF 解密密码已单独发送",
             )
-            return "合并转发与 PDF 文件均发送失败，已改为普通消息发送信息与密码"
-        return "合并转发被拒，已改为普通消息发送信息与密码，并补发独立 PDF 文件"
-    return "已发送合并转发与 PDF 文件"
+
+    try:
+        await _send_file(
+            sender, target_type, target_id, str(pdf_path), str(pdf_path.name)
+        )
+    except Exception as file_exc:
+        if _is_fatal_delivery_error(file_exc):
+            logger.error("[JM] 文件投递结果未确认，不重发: book=%s", book_id)
+            raise
+        logger.exception("[JM] PDF 文件发送失败: book=%s", book_id)
+        # 转发投递未确认时不能声称「信息与密码如上」——转发可能压根没送达
+        notice = (
+            "PDF 上传失败，本次没有发送文件（合并转发投递结果未确认，信息与密码可能没有送达）。"
+            if forward_status == _FORWARD_UNCERTAIN
+            else "PDF 上传失败，本次没有发送文件（信息与密码如上）。"
+        )
+        # 写进历史：转发摘要只说「随后发送」，真正发没发出去靠这条记录收口
+        await _send_text(sender, target_type, target_id, notice)
+        return f"{forward_status}，PDF 文件发送失败"
+    return f"{forward_status}，PDF 文件已单独发送"
 
 
 async def send_jm_book(
@@ -404,7 +409,7 @@ async def send_jm_book(
     target_id: int,
     config: Any,
 ) -> str:
-    """下载整本并发送合并转发，返回可记录的状态说明。"""
+    """下载整本，发送「信息 + 密码」合并转发，再单独发送加密 PDF 文件。"""
     password = generate_pdf_password()
     result, task_dir = await download_book_pdf(
         book_id, config=config, password=password

{undefined_bot-3.18.0 → undefined_bot-3.18.2}/src/Undefined/skills/agents/README.md

@@ -295,9 +295,9 @@ mv skills/tools/my_tool skills/agents/my_agent/tools/
 
 ### info_agent（信息查询助手）
 - **功能**：调用结构化工具完成参数明确的信息查询。
-- **适用场景**：天气、金价、热搜、历史、Whois、网络诊断、测速、编码/哈希、B 站、QQ 等级、arXiv 检索。
+- **适用场景**：天气、金价、热搜、历史、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`。
+- **子工具**：`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`, `jm_search`。
 
 ### entertainment_agent（娱乐助手）
 - **功能**：轻松互动、趣味内容和休闲创作。

{undefined_bot-3.18.0 → undefined_bot-3.18.2}/src/Undefined/skills/agents/info_agent/config.json

@@ -2,7 +2,7 @@
     "type": "function",
     "function": {
         "name": "info_agent",
-        "description": "信息查询助手，提供天气、热搜、新闻、历史、网络诊断、B站查询、arXiv 搜索、编码工具等各类实用信息查询功能。",
+        "description": "信息查询助手，提供天气、热搜、新闻、历史、网络诊断、B站查询、arXiv 搜索、禁漫（JM）本子搜索、编码工具等各类实用信息查询功能。",
         "parameters": {
             "type": "object",
             "properties": {

{undefined_bot-3.18.0 → undefined_bot-3.18.2}/src/Undefined/skills/agents/info_agent/intro.md

@@ -7,10 +7,11 @@
 - Whois、连通性检测、测速、TCPing、编码、哈希
 - B 站视频搜索、UP 主信息、QQ 等级
 - arXiv 论文检索
+- 禁漫（JM）本子检索：关键词/作者/标签搜索、分类浏览与日周月排行，返回车号列表
 
 不适合：
 - 开放式联网搜索、网页阅读、来源核验，交给 `web_agent`
 - 文件/附件解析，交给 `file_analysis_agent`
 - 长篇研究、创作或没有明确工具参数的泛泛问题
 
-输入最好包含城市、域名/IP、QQ 号、B 站关键词/UID、arXiv 关键词、待编码文本等明确参数。
+输入最好包含城市、域名/IP、QQ 号、B 站关键词/UID、arXiv 关键词、禁漫关键词、待编码文本等明确参数。

{undefined_bot-3.18.0 → undefined_bot-3.18.2}/src/Undefined/skills/agents/info_agent/prompt.md

@@ -1,7 +1,7 @@
 你是信息查询助手，负责把明确的查询需求交给合适工具，并返回简明可靠的结果。
 
 能力边界：
-- 适合天气、金价、热搜、历史、网络诊断、Whois、编码/哈希、B 站查询、QQ 等级和 arXiv 检索。
+- 适合天气、金价、热搜、历史、网络诊断、Whois、编码/哈希、B 站查询、QQ 等级、arXiv 检索和禁漫（JM）本子搜索。
 - 不做开放式网页搜索或网页阅读；这类需求应交给 `web_agent`。
 - 不做文件、附件、图片、PDF 等内容解析；这类需求应交给 `file_analysis_agent`。
 
@@ -9,6 +9,7 @@
 - 能用工具查询的内容不要凭记忆猜测。
 - 参数不足时询问关键参数；如果能从用户话里可靠推断，也可以直接查询。
 - B 站相关需求使用对应 B 站工具；arXiv 论文检索使用 `arxiv_search`。
+- 禁漫本子用 `jm_search`：关键词检索用 `mode=search`（可限定作者/标签/角色、分类、时间与排序），分类浏览用 `mode=browse`，日/周/月榜用 `mode=ranking`；它只返回车号与列表，下载、发文件或正文详情不在你的能力范围内，交给主 AI 处理。
 - 相对时间相关问题如“今天”“当前”，如有当前时间工具，先校准日期。
 
 回答要求：