nonebot-plugin-pixiv-dl

基于 NoneBot2 的 Pixiv 搜索与下载插件

📖 介绍

通过 Pixiv Web AJAX 搜索插画，漫画和小说，使用 OneBot V11 合并转发发送结果

图片和漫画搜索会下载低清预览，使用随插件安装的 Pillow 在内存中缩放并模糊 R18 预览

支持下载插画和漫画原图，以及将小说正文保存为 UTF-8 TXT 文件

💿 安装

推荐使用 NB-CLI 安装

nb plugin install nonebot-plugin-pixiv-dl

也可以使用 pip 安装

pip install nonebot-plugin-pixiv-dl

pip install .

uv pip install .

在 NoneBot2 项目的 pyproject.toml 中，将插件加载名加入 [tool.nonebot] 的 plugins 列表

[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

PIXIV_COOKIE="PHPSESSID=替换为自己的会话值"
PIXIV_PROXY="http://127.0.0.1:7890"

PIXIV_COOKIE 只填写浏览器请求中的 Cookie 值，不要包含 Cookie: 前缀

PIXIV_PROXY 为可选配置，可填写可用的 HTTP 或 SOCKS 代理地址

未配置 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下载图片123456

搜索结果每个作品占一个合并转发节点，图片和漫画节点包含标题，作者，ID，标签等元数据及一张第一页预览，小说保持纯元数据，聚合搜索分别发送三个分类的聊天记录

预览直接使用搜索响应中的 url，thumb，thumbnail 或 small 低清地址，不查询额外作品详情或其他页面，不使用原图和未裁剪的常规图片，无可用地址或单张处理失败时只展示该作品元数据

预览以质量为 80 的 JPEG 在内存中编码，透明部分使用白底，R18 始终使用高斯模糊，半径为缩放后短边的 10%，限制在 12 至 48 像素，不提供关闭模糊的配置

下载结果以元数据为首节点，插画和漫画每页一张图片，小说每章一个 TXT 文件，超过节点上限会继续分包

搜索或下载时会发送临时状态消息，发送结果时尝试撤回，没有搜索结果时会直接发送提示

使用限制

• PIXIV_R18=false 时，搜索会过滤 R18 作品，下载会拒绝 R18 作品
• PIXIV_R18=true 时允许搜索 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 消息段，且能访问本地临时文件