nonebot-plugin-pixiv-dl 0.1.0__tar.gz

nonebot_plugin_pixiv_dl-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DuoDuoJuZi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

nonebot_plugin_pixiv_dl-0.1.0/PKG-INFO

@@ -0,0 +1,138 @@
+Metadata-Version: 2.4
+Name: nonebot-plugin-pixiv-dl
+Version: 0.1.0
+Summary: 基于 Pixiv Web AJAX 的 NoneBot2 OneBot V11 搜索与下载插件
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/DuoDuoJuZi/nonebot-plugin-pixiv-dl
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: nonebot2<3,>=2.3
+Requires-Dist: nonebot-adapter-onebot<3,>=2.4
+Requires-Dist: httpx[socks]<0.29,>=0.27
+Requires-Dist: httpcore<2,>=1
+Requires-Dist: pydantic<3,>=2
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == "dev"
+Requires-Dist: ruff>=0.6; extra == "dev"
+Dynamic: license-file
+
+<div align="center">
+  <img src="https://github.com/Misty02600/nonebot-plugin-template/releases/download/assets/NoneBotPlugin.png" width="310" alt="NoneBot 插件图标">
+
+  <h1>nonebot-plugin-pixiv-dl</h1>
+
+  <p>基于 NoneBot2 的 Pixiv 搜索与下载插件</p>
+</div>
+
+## 📖 介绍
+
+通过 Pixiv Web AJAX 搜索插画，漫画和小说，使用 OneBot V11 合并转发发送结果
+
+支持下载插画和漫画原图，以及将小说正文保存为 UTF-8 TXT 文件
+
+## 💿 安装
+
+```bash
+pip install nonebot-plugin-pixiv-dl
+```
+
+<details>
+<summary>从本地源码安装</summary>
+
+在插件目录执行
+
+```bash
+pip install .
+```
+
+使用 uv 时执行
+
+```bash
+uv pip install .
+```
+
+</details>
+
+在 NoneBot2 项目的 `pyproject.toml` 中，将插件加载名加入 `[tool.nonebot]` 的 `plugins` 列表
+
+```toml
+[tool.nonebot]
+plugins = ["nonebot_plugin_pixiv_dl"]
+```
+
+已有 `plugins` 配置时只需追加 `nonebot_plugin_pixiv_dl`，同时确保项目已注册 OneBot V11 适配器
+
+`nonebot-plugin-pixiv-dl` 是 PyPI 包名，插件加载名为 `nonebot_plugin_pixiv_dl`
+
+## ⚙️ 配置
+
+在机器人项目的 `.env` 文件或环境变量中设置 Pixiv Cookie
+
+```dotenv
+PIXIV_COOKIE="PHPSESSID=替换为自己的会话值"
+PIXIV_PROXY="http://127.0.0.1:7890"
+```
+
+`PIXIV_COOKIE` 只填写浏览器请求中的 Cookie 值，不要包含 `Cookie:` 前缀
+
+`PIXIV_PROXY` 为可选配置，可填写可用的 HTTP 或 SOCKS 代理地址
+
+| 配置项 | 必填 | 默认值 | 说明 |
+| :--- | :---: | :---: | :--- |
+| `PIXIV_COOKIE` | 是 | 空 | Pixiv Web 登录 Cookie |
+| `PIXIV_R18` | 否 | `true` | 是否允许搜索和下载 R18 作品 |
+| `PIXIV_SEARCH_LIMIT` | 否 | `20` | 每个分类最多返回的搜索结果数 |
+| `PIXIV_FORWARD_MAX_MESSAGES` | 否 | `20` | 每包合并转发的节点上限，最小为 `2` |
+| `PIXIV_DOWNLOAD_MAX_PAGES` | 否 | `30` | 漫画单次最多下载的页数 |
+| `PIXIV_NOVEL_MAX_CHAPTERS` | 否 | `50` | 小说系列单次最多下载的章节数 |
+| `PIXIV_TIMEOUT` | 否 | `20` | 单次网络请求的超时秒数 |
+| `PIXIV_PROXY` | 否 | 空 | Pixiv 网页和图片请求共用的代理地址 |
+| `PIXIV_FIXED_IP` | 否 | 空 | Pixiv 主站使用的固定 IP 地址 |
+
+未配置 `PIXIV_PROXY` 和 `PIXIV_FIXED_IP` 时，插件会读取 `HTTPS_PROXY`，`ALL_PROXY` 等环境代理变量
+
+仅配置 `PIXIV_FIXED_IP` 时，只有 `www.pixiv.net` 的 TCP 连接使用该地址，图片 CDN 仍按原域名连接
+
+同时配置 `PIXIV_PROXY` 和 `PIXIV_FIXED_IP` 时优先使用代理，固定 IP 变化后需要自行更新
+
+插件仅向 `www.pixiv.net` 发送 Cookie，图片请求不会携带 Cookie
+
+## 🎉 使用
+
+### 指令表
+
+| 指令 | 范围 | 说明 |
+| :--- | :---: | :--- |
+| `/px搜索图片 关键词` | 群聊和私聊 | 搜索插画并返回元数据 |
+| `/px搜索漫画 关键词` | 群聊和私聊 | 搜索漫画并返回元数据 |
+| `/px搜索小说 关键词` | 群聊和私聊 | 搜索小说并返回元数据 |
+| `/px搜索 关键词` | 群聊和私聊 | 分别返回插画，漫画和小说的搜索结果 |
+| `/px下载图片 PID` | 群聊和私聊 | 下载插画原图并逐页发送 |
+| `/px下载漫画 PID` | 群聊和私聊 | 下载漫画原图并逐页发送 |
+| `/px下载小说 ID` | 群聊和私聊 | 下载独立小说或所在系列的章节 TXT 文件 |
+| `/px下载 PID` | 群聊和私聊 | 查询作品详情后识别插画，漫画或小说 |
+
+指令以 `/px` 开头，分类与参数之间可以省略空格，例如 `/px搜索图片风景` 和 `/px下载图片123456`
+
+搜索结果每个作品占一个合并转发节点，只展示标题，作者，ID，标签等元数据
+
+下载结果以元数据为首节点，插画和漫画每页一张图片，小说每章一个 TXT 文件，超过节点上限会继续分包
+
+搜索或下载时会发送临时状态消息，发送结果时尝试撤回，没有搜索结果时会直接发送提示
+
+### 使用限制
+
+- `PIXIV_R18=false` 时，搜索会过滤 R18 作品，下载会拒绝 R18 作品
+- 暂不支持下载 Pixiv 动图
+- 小说文件通过 NapCat 支持的 `file` 扩展消息段发送，实现端需要支持合并转发中的文件消息段，并能访问插件生成的本地临时文件
+- 合并转发依赖实现端支持 `send_group_forward_msg` 或 `send_private_forward_msg` 扩展动作
+- 群聊文件发送还可能受到 QQ 文件容量限制
+
+## 🔧 常见问题
+
+- 搜索或下载失败时，查看控制台中的 Pixiv 请求路径，HTTP 状态和异常信息
+- Cookie 缺失或失效时，更新 `PIXIV_COOKIE`
+- 图片下载失败时，检查 `i.pximg.net` 的网络连接或代理设置
+- 固定 IP 无法连接时，清空 `PIXIV_FIXED_IP` 以恢复系统 DNS
+- 小说文件发送失败时，确认实现端支持合并转发中的 `file` 消息段，且能访问本地临时文件

nonebot_plugin_pixiv_dl-0.1.0/README.md

@@ -0,0 +1,119 @@
+<div align="center">
+  <img src="https://github.com/Misty02600/nonebot-plugin-template/releases/download/assets/NoneBotPlugin.png" width="310" alt="NoneBot 插件图标">
+
+  <h1>nonebot-plugin-pixiv-dl</h1>
+
+  <p>基于 NoneBot2 的 Pixiv 搜索与下载插件</p>
+</div>
+
+## 📖 介绍
+
+通过 Pixiv Web AJAX 搜索插画，漫画和小说，使用 OneBot V11 合并转发发送结果
+
+支持下载插画和漫画原图，以及将小说正文保存为 UTF-8 TXT 文件
+
+## 💿 安装
+
+```bash
+pip install nonebot-plugin-pixiv-dl
+```
+
+<details>
+<summary>从本地源码安装</summary>
+
+在插件目录执行
+
+```bash
+pip install .
+```
+
+使用 uv 时执行
+
+```bash
+uv pip install .
+```
+
+</details>
+
+在 NoneBot2 项目的 `pyproject.toml` 中，将插件加载名加入 `[tool.nonebot]` 的 `plugins` 列表
+
+```toml
+[tool.nonebot]
+plugins = ["nonebot_plugin_pixiv_dl"]
+```
+
+已有 `plugins` 配置时只需追加 `nonebot_plugin_pixiv_dl`，同时确保项目已注册 OneBot V11 适配器
+
+`nonebot-plugin-pixiv-dl` 是 PyPI 包名，插件加载名为 `nonebot_plugin_pixiv_dl`
+
+## ⚙️ 配置
+
+在机器人项目的 `.env` 文件或环境变量中设置 Pixiv Cookie
+
+```dotenv
+PIXIV_COOKIE="PHPSESSID=替换为自己的会话值"
+PIXIV_PROXY="http://127.0.0.1:7890"
+```
+
+`PIXIV_COOKIE` 只填写浏览器请求中的 Cookie 值，不要包含 `Cookie:` 前缀
+
+`PIXIV_PROXY` 为可选配置，可填写可用的 HTTP 或 SOCKS 代理地址
+
+| 配置项 | 必填 | 默认值 | 说明 |
+| :--- | :---: | :---: | :--- |
+| `PIXIV_COOKIE` | 是 | 空 | Pixiv Web 登录 Cookie |
+| `PIXIV_R18` | 否 | `true` | 是否允许搜索和下载 R18 作品 |
+| `PIXIV_SEARCH_LIMIT` | 否 | `20` | 每个分类最多返回的搜索结果数 |
+| `PIXIV_FORWARD_MAX_MESSAGES` | 否 | `20` | 每包合并转发的节点上限，最小为 `2` |
+| `PIXIV_DOWNLOAD_MAX_PAGES` | 否 | `30` | 漫画单次最多下载的页数 |
+| `PIXIV_NOVEL_MAX_CHAPTERS` | 否 | `50` | 小说系列单次最多下载的章节数 |
+| `PIXIV_TIMEOUT` | 否 | `20` | 单次网络请求的超时秒数 |
+| `PIXIV_PROXY` | 否 | 空 | Pixiv 网页和图片请求共用的代理地址 |
+| `PIXIV_FIXED_IP` | 否 | 空 | Pixiv 主站使用的固定 IP 地址 |
+
+未配置 `PIXIV_PROXY` 和 `PIXIV_FIXED_IP` 时，插件会读取 `HTTPS_PROXY`，`ALL_PROXY` 等环境代理变量
+
+仅配置 `PIXIV_FIXED_IP` 时，只有 `www.pixiv.net` 的 TCP 连接使用该地址，图片 CDN 仍按原域名连接
+
+同时配置 `PIXIV_PROXY` 和 `PIXIV_FIXED_IP` 时优先使用代理，固定 IP 变化后需要自行更新
+
+插件仅向 `www.pixiv.net` 发送 Cookie，图片请求不会携带 Cookie
+
+## 🎉 使用
+
+### 指令表
+
+| 指令 | 范围 | 说明 |
+| :--- | :---: | :--- |
+| `/px搜索图片 关键词` | 群聊和私聊 | 搜索插画并返回元数据 |
+| `/px搜索漫画 关键词` | 群聊和私聊 | 搜索漫画并返回元数据 |
+| `/px搜索小说 关键词` | 群聊和私聊 | 搜索小说并返回元数据 |
+| `/px搜索 关键词` | 群聊和私聊 | 分别返回插画，漫画和小说的搜索结果 |
+| `/px下载图片 PID` | 群聊和私聊 | 下载插画原图并逐页发送 |
+| `/px下载漫画 PID` | 群聊和私聊 | 下载漫画原图并逐页发送 |
+| `/px下载小说 ID` | 群聊和私聊 | 下载独立小说或所在系列的章节 TXT 文件 |
+| `/px下载 PID` | 群聊和私聊 | 查询作品详情后识别插画，漫画或小说 |
+
+指令以 `/px` 开头，分类与参数之间可以省略空格，例如 `/px搜索图片风景` 和 `/px下载图片123456`
+
+搜索结果每个作品占一个合并转发节点，只展示标题，作者，ID，标签等元数据
+
+下载结果以元数据为首节点，插画和漫画每页一张图片，小说每章一个 TXT 文件，超过节点上限会继续分包
+
+搜索或下载时会发送临时状态消息，发送结果时尝试撤回，没有搜索结果时会直接发送提示
+
+### 使用限制
+
+- `PIXIV_R18=false` 时，搜索会过滤 R18 作品，下载会拒绝 R18 作品
+- 暂不支持下载 Pixiv 动图
+- 小说文件通过 NapCat 支持的 `file` 扩展消息段发送，实现端需要支持合并转发中的文件消息段，并能访问插件生成的本地临时文件
+- 合并转发依赖实现端支持 `send_group_forward_msg` 或 `send_private_forward_msg` 扩展动作
+- 群聊文件发送还可能受到 QQ 文件容量限制
+
+## 🔧 常见问题
+
+- 搜索或下载失败时，查看控制台中的 Pixiv 请求路径，HTTP 状态和异常信息
+- Cookie 缺失或失效时，更新 `PIXIV_COOKIE`
+- 图片下载失败时，检查 `i.pximg.net` 的网络连接或代理设置
+- 固定 IP 无法连接时，清空 `PIXIV_FIXED_IP` 以恢复系统 DNS
+- 小说文件发送失败时，确认实现端支持合并转发中的 `file` 消息段，且能访问本地临时文件

nonebot_plugin_pixiv_dl-0.1.0/nonebot_plugin_pixiv_dl/__init__.py

@@ -0,0 +1,13 @@
+from nonebot.plugin import PluginMetadata
+
+# @Author: DuoDuoJuZi
+# @Date: 2026-09-29
+__plugin_meta__ = PluginMetadata(
+    name="nonebot-plugin-pixiv-dl",
+    description="通过 Pixiv Web AJAX 搜索和下载作品",
+    usage="/px搜索 关键词 或 /px下载 作品 ID",
+    type="application",
+    supported_adapters={"~onebot.v11"},
+)
+
+from . import commands as commands

nonebot_plugin_pixiv_dl-0.1.0/nonebot_plugin_pixiv_dl/commands.py

@@ -0,0 +1,265 @@
+import asyncio
+import re
+from pathlib import Path
+from tempfile import TemporaryDirectory
+
+from nonebot import get_driver, get_plugin_config, logger, on_regex
+from nonebot.adapters.onebot.v11 import Bot, MessageEvent
+
+from .config import Config
+from .message import (
+    KIND_NAMES,
+    build_artwork_forward,
+    build_novel_forward,
+    build_search_forward,
+    format_novel,
+    format_series,
+    send_forward,
+    write_novel_file,
+)
+from .models import Artwork, Novel
+from .pixiv import PixivAPIError, PixivClient, PixivNotFoundError, PixivR18Error
+
+SEARCH_RE = re.compile(r"^/px搜索(?!(?:图片|漫画|小说)\s*$)(图片|漫画|小说)?\s*(\S.*?)\s*$")
+DOWNLOAD_RE = re.compile(r"^/px下载(图片|漫画|小说)?\s*(\d+)\s*$")
+KINDS = {"图片": "image", "漫画": "manga", "小说": "novel"}
+
+config = get_plugin_config(Config)
+client = PixivClient(config)
+get_driver().on_shutdown(client.close)
+
+search_matcher = on_regex(SEARCH_RE.pattern, priority=10, block=True)
+download_matcher = on_regex(DOWNLOAD_RE.pattern, priority=10, block=True)
+
+
+# @Author: DuoDuoJuZi
+# @Date: 2026-09-29
+def parse_search(text: str) -> tuple[str, str] | None:
+    """解析搜索命令，兼容分类与关键词之间省略空格的写法
+
+    Args:
+        text: 用户发送的完整搜索命令文本
+
+    Returns:
+        搜索分类与非空关键词，命令格式不匹配时返回 None
+    """
+    match = SEARCH_RE.fullmatch(text)
+    if not match:
+        return None
+    return KINDS.get(match.group(1), "all"), match.group(2).strip()
+
+
+def parse_download(text: str) -> tuple[str, int] | None:
+    """解析下载命令，保留用户指定的分类或自动识别标记
+
+    Args:
+        text: 用户发送的完整下载命令文本
+
+    Returns:
+        下载分类与作品 ID，命令格式不匹配时返回 None
+    """
+    match = DOWNLOAD_RE.fullmatch(text)
+    if not match:
+        return None
+    return KINDS.get(match.group(1), "auto"), int(match.group(2))
+
+
+async def _recall(bot: Bot, status: dict) -> None:
+    """撤回处理中提示，撤回失败时记录日志并继续发送结果
+
+    Args:
+        bot: 用于调用 OneBot 消息接口的机器人实例
+        status: 发送处理中提示时返回的消息信息，包含待撤回的消息标识
+    """
+    try:
+        await bot.delete_msg(message_id=status["message_id"])
+    except Exception:
+        logger.warning("Pixiv 状态消息撤回失败", exc_info=True)
+
+
+async def _search_kind(kind: str, word: str) -> list[Artwork] | list[Novel]:
+    """调用指定分类的 Pixiv 搜索接口
+
+    Args:
+        kind: 请求的作品分类
+        word: 用于匹配作品标签的搜索关键词
+
+    Returns:
+        符合配置数量上限的该分类作品预览
+
+    Raises:
+        PixivAuthError: 未配置 Cookie 或 Pixiv 要求重新登录
+        PixivNotFoundError: 请求的资源不存在或响应没有业务数据
+        PixivNetworkError: 请求超时或网络连接失败
+        PixivAPIError: HTTP 请求失败或 Pixiv 返回无效业务数据
+    """
+    method = {
+        "image": client.search_artworks,
+        "manga": client.search_manga,
+        "novel": client.search_novels,
+    }[kind]
+    return await method(word, config.pixiv_search_limit)
+
+
+async def _run_search(bot: Bot, event: MessageEvent, kind: str, word: str) -> None:
+    """查询作品预览并撤回状态提示，按分类发送合并转发
+
+    Args:
+        bot: 用于调用 OneBot 消息接口的机器人实例
+        event: 触发命令的消息事件，决定回复会话
+        kind: 搜索分类，all 表示分别查询插画，漫画和小说
+        word: 用于匹配作品标签的搜索关键词
+    """
+    status = await bot.send(event, "正在搜索")
+    recalled = False
+    try:
+        kinds = ["image", "manga", "novel"] if kind == "all" else [kind]
+        results = await asyncio.gather(*(_search_kind(item, word) for item in kinds))
+        await _recall(bot, status)
+        recalled = True
+        if all(not items for items in results):
+            await bot.send(event, "没有搜索到相关内容")
+            return
+        for current, items in zip(kinds, results, strict=True):
+            if not items:
+                await bot.send(event, f"没有搜索到相关{KIND_NAMES[current]}")
+                continue
+            packets = build_search_forward(
+                items, current, config.pixiv_forward_max_messages, int(bot.self_id)
+            )
+            for packet in packets:
+                await send_forward(bot, event, packet)
+    except Exception:
+        logger.exception("Pixiv 搜索失败，分类={}，关键词={}", kind, word)
+        if not recalled:
+            await _recall(bot, status)
+        await bot.send(event, "搜索失败")
+
+
+async def _get_download_target(kind: str, work_id: int) -> Artwork | Novel:
+    """查询 Pixiv 确定下载资源类型，自动模式下插画不存在时尝试小说
+
+    Args:
+        kind: 下载分类，auto 表示根据接口响应自动识别
+        work_id: 待查询作品的 Pixiv ID
+
+    Returns:
+        可下载的插画或小说详情
+
+    Raises:
+        PixivAuthError: 未配置 Cookie 或 Pixiv 要求重新登录
+        PixivNotFoundError: 请求的资源不存在或响应没有业务数据
+        PixivNetworkError: 请求超时或网络连接失败
+        PixivAPIError: 实际作品分类与指定分类不符或接口数据无效
+        PixivR18Error: 作品属于限制级内容且配置禁止下载
+    """
+    if kind == "novel":
+        return await client.get_novel(work_id)
+    try:
+        artwork = await client.get_illust(work_id)
+    except PixivNotFoundError:
+        if kind == "auto":
+            return await client.get_novel(work_id)
+        raise
+    if kind != "auto" and artwork.type != kind:
+        raise PixivAPIError(f"{work_id}: expected {kind}, got {artwork.type}")
+    return artwork
+
+
+async def _run_download(bot: Bot, event: MessageEvent, kind: str, work_id: int) -> None:
+    """下载作品并以元数据首节点打包发送，发送结束后清理临时章节文件
+
+    Args:
+        bot: 用于调用 OneBot 消息接口的机器人实例
+        event: 触发命令的消息事件，决定回复会话
+        kind: 下载分类，auto 表示先查询作品的实际类型
+        work_id: 待查询作品的 Pixiv ID
+    """
+    status = await bot.send(event, "正在下载")
+    recalled = False
+    try:
+        target = await _get_download_target(kind, work_id)
+        if isinstance(target, Novel):
+            with TemporaryDirectory(prefix="nonebot-pixiv-") as directory:
+                folder = Path(directory)
+                if target.series_id:
+                    series = await client.get_novel_series(
+                        target.series_id, config.pixiv_novel_max_chapters
+                    )
+                    chapters = []
+                    for item in series.chapters:
+                        try:
+                            chapters.append(await client.get_novel(item.id))
+                        except Exception as exc:
+                            raise PixivAPIError(
+                                f"series {series.id}, chapter {item.id}: {exc}"
+                            ) from exc
+                    paths = [
+                        write_novel_file(chapter, folder, index)
+                        for index, chapter in enumerate(chapters, 1)
+                    ]
+                    metadata = format_series(series, len(paths))
+                else:
+                    paths = [write_novel_file(target, folder)]
+                    metadata = format_novel(target)
+                if not paths:
+                    raise PixivAPIError(f"{work_id}: no novel chapters")
+                packets = build_novel_forward(
+                    metadata, paths, config.pixiv_forward_max_messages, int(bot.self_id)
+                )
+                for packet in packets:
+                    await send_forward(bot, event, packet)
+                await _recall(bot, status)
+                recalled = True
+        else:
+            urls = await client.get_illust_pages(target.id)
+            if target.type == "manga":
+                urls = urls[: config.pixiv_download_max_pages]
+            images = []
+            for page, url in enumerate(urls, 1):
+                try:
+                    images.append(await client.download_image(url))
+                except Exception as exc:
+                    raise PixivAPIError(f"artwork {target.id}, page {page}: {exc}") from exc
+            await _recall(bot, status)
+            recalled = True
+            packets = build_artwork_forward(
+                target, images, config.pixiv_forward_max_messages, int(bot.self_id)
+            )
+            for packet in packets:
+                await send_forward(bot, event, packet)
+    except PixivR18Error:
+        if not recalled:
+            await _recall(bot, status)
+        await bot.send(event, "已关闭 R18，无法下载该作品")
+    except Exception:
+        logger.exception("Pixiv 下载失败，分类={}，作品 ID={}", kind, work_id)
+        if not recalled:
+            await _recall(bot, status)
+        await bot.send(event, "下载失败")
+
+
+@search_matcher.handle()
+async def handle_search(bot: Bot, event: MessageEvent) -> None:
+    """解析 OneBot 消息并执行匹配的搜索命令
+
+    Args:
+        bot: 用于调用 OneBot 消息接口的机器人实例
+        event: 触发命令的消息事件，决定回复会话
+    """
+    parsed = parse_search(event.get_plaintext())
+    if parsed:
+        await _run_search(bot, event, *parsed)
+
+
+@download_matcher.handle()
+async def handle_download(bot: Bot, event: MessageEvent) -> None:
+    """解析 OneBot 消息并执行匹配的下载命令
+
+    Args:
+        bot: 用于调用 OneBot 消息接口的机器人实例
+        event: 触发命令的消息事件，决定回复会话
+    """
+    parsed = parse_download(event.get_plaintext())
+    if parsed:
+        await _run_download(bot, event, *parsed)

nonebot_plugin_pixiv_dl-0.1.0/nonebot_plugin_pixiv_dl/config.py

@@ -0,0 +1,35 @@
+from ipaddress import ip_address
+
+from pydantic import BaseModel, Field, field_validator
+
+
+# @Author: DuoDuoJuZi
+# @Date: 2026-09-29
+class Config(BaseModel):
+    """保存 Pixiv 请求和 OneBot 消息发送所需的配置"""
+
+    pixiv_cookie: str = ""
+    pixiv_r18: bool = True
+    pixiv_search_limit: int = Field(default=20, ge=1, le=200)
+    pixiv_forward_max_messages: int = Field(default=20, ge=2, le=100)
+    pixiv_download_max_pages: int = Field(default=30, ge=1, le=200)
+    pixiv_novel_max_chapters: int = Field(default=50, ge=1, le=500)
+    pixiv_timeout: float = Field(default=20.0, gt=0)
+    pixiv_proxy: str | None = None
+    pixiv_fixed_ip: str | None = None
+
+    @field_validator("pixiv_fixed_ip")
+    @classmethod
+    def validate_fixed_ip(cls, value: str | None) -> str | None:
+        """校验 pixiv_fixed_ip 字段，仅接受有效的 IPv4 或 IPv6 地址
+
+        Args:
+            value: 配置的固定 IP 地址，空值或空字符串表示关闭固定地址路由
+
+        Returns:
+            规范化后的 IP 地址，关闭固定地址路由时返回 None
+
+        Raises:
+            ValueError: 非空配置无法解析为有效的 IP 地址
+        """
+        return str(ip_address(value)) if value else None