📖 介绍

nonebot-plugin-jmcomic-pdf 是一款专为 NoneBot2 (OneBot V11 适配器) 打造的禁漫天堂助手插件。

底层接入并适配了社区优秀的爬虫框架 JMComic-Crawler-Python，具备智能图片切片反混淆还原、动态 API 域名更新与高并发无损合成 PDF 等强大特性。

🌟 核心特色

• 📄 车号直出全本 PDF：输入车号直接在后台并发下载、自动解密反混淆，并利用 img2pdf 无损合并为单份高质量 PDF 电子书直接发送给用户。
• 🤫 零冗余清爽交互：无任何前置等待提示与生成成功长文本刷屏，纯净直传文件。
• 🔍 站内精准搜索：支持关键词站内搜索与分页浏览。
• 🛡️ 安全合并转发预览：章节预览通过 OneBot V11 自定义转发节点（Forward Node）发出，卡片收拢不刷屏、大幅降低 QQ 风控概率。
• 📦 整本 ZIP 打包：支持将本子打包为标准 ZIP 文件推送。
• 🏆 全站排行榜：随时掌握禁漫日榜、周榜、月榜热门动态。
• ⏱️ 频率冷却防护：内置普通群友 CD 防刷屏保护，管理员免 CD。

💿 快速安装

方式一：使用 nb-cli 安装（推荐）

在 NoneBot2 项目根目录下执行：

nb plugin install nonebot-plugin-jmcomic-pdf

方式二：使用包管理器安装

# 使用 pip
pip install nonebot-plugin-jmcomic-pdf

# 若网络较慢可使用清华镜像
pip install nonebot-plugin-jmcomic-pdf -i https://pypi.tuna.tsinghua.edu.cn/simple

随后在 NoneBot2 项目的 pyproject.toml 的 plugins 列表中加入：

plugins = ["nonebot_plugin_jmcomic_pdf"]

方式三：源码直接引入

克隆或下载本项目至机器人工程的自定义插件目录（例如 plugins/nonebot_plugin_jmcomic_pdf），并在对应配置中加载即可。

⚙️ 配置说明

在机器人根目录下的 .env（或 .env.dev / .env.prod）中添加以下可选配置：

配置范例 (.env)

# JMComic 插件配置
JM_PROXY=http://127.0.0.1:7890
JM_CLIENT_IMPL=api
JM_MAX_PREVIEW_PAGES=5
JM_CD=5

🎮 指令说明

💡 提示：指令前缀取决于你机器人的 COMMAND_START 配置（例如 / 或空前缀）。

🛡️ QQ 运营与防风控建议

1. 坚持使用合并转发：连续在群内直接发图是腾讯风控的最常见拦截点。本插件的 jmpreview 采用合并转发节点聚合，极大降低了违规风险。
2. 控制预览张数：建议保持默认的 3~5 张预览，不要随意在群里大批量请求图片。
3. 大文件下载限制：整本 ZIP 下载（jmdownload）默认限制为管理员可用，避免群友无节制并发调用耗尽服务器带宽。
4. 网络代理配置：若服务器位于国内，推荐搭配本地 Clash 或 v2ray 代理端口（JM_PROXY）使用，确保请求禁漫稳定不掉线。

🙏 致谢与声明

• 核心爬虫能力来自于开源项目 hect0x7/JMComic-Crawler-Python，感谢原作者的持续维护！
• 机器人框架依赖于 NoneBot2 与 OneBot V11。

📄 开源许可证

本项目基于 MIT License 协议开源。