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

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

@@ -1,3 +1,13 @@
+## 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.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: Undefined-bot
-Version: 3.18.0
+Version: 3.18.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
@@ -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` 解析。默认关闭，`[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.1}/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` 解析。默认关闭，`[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.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "Undefined-bot"
-version = "3.18.0"
+version = "3.18.1"
 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.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.18.0"
+__version__: str = "3.18.1"
 
 # symbol -> (module_path, attribute_name)；首次访问时才 importlib 加载
 _LAZY_IMPORTS: dict[str, tuple[str, str]] = {

{undefined_bot-3.18.0 → undefined_bot-3.18.1}/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.1}/src/Undefined/skills/shared.py

@@ -109,7 +109,7 @@ async def jm_send_book(
     target_id: int,
     config: Any,
 ) -> str:
-    """下载整本并发送「信息 / 密码 / PDF」三节点合并转发。"""
+    """下载整本，发送「信息 / 密码」合并转发并单独发送加密 PDF 文件。"""
     from Undefined.jm.sender import send_jm_book as _send_jm_book
 
     return await _send_jm_book(

{undefined_bot-3.18.0 → undefined_bot-3.18.1}/src/Undefined/skills/tools/jm_book/README.md

@@ -1,17 +1,17 @@
 # jm_book 工具
 
-处理禁漫（JM / 18comic）本子。默认下载整本并通过合并转发发送；也支持只注册为附件 UID 供文件分析使用，或只获取本子信息。支持 `JM350234`、`350234`、`https://18comic.vip/album/350234` 与 `?id=` 链接。
+处理禁漫（JM / 18comic）本子。默认下载整本并通过合并转发 + 独立文件消息发送；也支持只注册为附件 UID 供文件分析使用，或只获取本子信息。支持 `JM350234`、`350234`、`https://18comic.vip/album/350234` 与 `?id=` 链接。
 
 常用参数：
 - `book_id`：本子车号（`JM350234` / `350234` / 禁漫链接，车号 5-8 位）
 - `target_type`：可选，目标会话类型（`group`/`private`）
 - `target_id`：可选，目标会话 ID
-- `output_mode`：可选，`send`（默认，发送三节点合并转发）、`uid`（只返回 `<attachment uid="file_xxx"/>`，不发送消息）或 `info`（只返回本子信息，不下载不发送）
+- `output_mode`：可选，`send`（默认，发送「信息 / 密码」合并转发并单独发送 PDF 文件）、`uid`（只返回 `<attachment uid="file_xxx"/>`，不发送消息）或 `info`（只返回本子信息，不下载不发送）
 
 `send` 模式流程：
 1. 解析车号
 2. 逐章下载并按章节顺序合成为一个 AES-256 加密 PDF（`[jm].max_chapters` / `max_file_size` 限制）
-3. 发送「本子信息 / PDF 解密密码 / PDF 文件」三节点合并转发，PDF 同时进入群文件列表
+3. 发送「本子信息 / PDF 解密密码」两节点合并转发，再单独发一条 PDF 文件消息（转发里的文件在 QQ 客户端下载会失败，独立文件消息才下得动，PDF 同时进入群文件列表）
 4. 密码随机生成 8 位，只出现在转发节点里，不写入历史
 
 `uid` 模式流程：

{undefined_bot-3.18.0 → undefined_bot-3.18.1}/src/Undefined/skills/tools/jm_book/config.json

@@ -2,7 +2,7 @@
     "type": "function",
     "function": {
         "name": "jm_book",
-        "description": "处理禁漫（JM / 18comic）本子。默认下载整本并通过合并转发发送；可设置 output_mode=uid 只注册 PDF 附件 UID，或 output_mode=info 只获取本子信息。支持 JM350234、350234 或禁漫链接。",
+        "description": "处理禁漫（JM / 18comic）本子。默认下载整本，发送信息与密码的合并转发并单独发送加密 PDF 文件；可设置 output_mode=uid 只注册 PDF 附件 UID，或 output_mode=info 只获取本子信息。支持 JM350234、350234 或禁漫链接。",
         "parameters": {
             "type": "object",
             "properties": {
@@ -22,7 +22,7 @@
                 "output_mode": {
                     "type": "string",
                     "enum": ["send", "uid", "info"],
-                    "description": "输出模式：send（默认，下载整本并发送「信息 / 解密密码 / PDF」三节点合并转发）、uid（只下载并注册未加密 PDF 附件 UID，不发送消息）、info（只返回本子信息，不下载不发送）"
+                    "description": "输出模式：send（默认，下载整本、发送「信息 / 解密密码」合并转发并单独发送加密 PDF 文件）、uid（只下载并注册未加密 PDF 附件 UID，不发送消息）、info（只返回本子信息，不下载不发送）"
                 }
             },
             "required": ["book_id"]