JM 插件（Yunzai）

适用于 Miao-Yunzai / TRSS-Yunzai（云崽 v3 系），底层基于 JMComic-Crawler-Python 的 jmcomic 库，支持 Guoba-Plugin（锅巴）WebUI 配置。

功能

功能	命令	说明
帮助	#jm帮助	查看全部命令
登录	#jm登录 <用户名> <密码>	Cookie 按用户持久化（redis，30 天）
收藏	#jm收藏 [页码] / #jm添加 <漫画ID>	查看 / 添加收藏
搜索	#jm搜索 <关键词> [页码]	站内搜索
详情	#jm详情 <漫画ID>	作者 / 页数 / 标签 / 简介等
排行	#jm排行 [日|周|月] [页码]	默认周榜
分类	#jm分类 [页码]	分类浏览（默认观看数排序）
下载	#jm下载 <漫画ID>	后台下载转 PDF 并发送，完成后通知
退出	#jm退出	清除本用户 Cookie

命令可不带空格（如 #jm登录），# 可省略，亦可用「禁漫」触发；ID 兼容 JM 前缀（如 #jm详情 JM350234）。快捷详情：发送 #jm<数字ID> 直接查详情，如 #jm114514。

安装

1. 服务端需 Python 3.9+（推荐 3.12+）并安装：pip install jmcomic -U（PDF 转换可选 img2pdf）。

   TRSS-Yunzai 官方 docker 镜像不含 Python，需先 apt-get install -y python3 python3-pip；也可用 JM_PYTHON 指向宿主机 Python。

2. 将 jm-plugin 目录复制到 Yunzai 的 plugins/ 下，重启（或 #重启）生效。

配置

方式一：锅巴 WebUI（推荐）

安装 Guoba-Plugin 后，锅巴面板 → 插件配置 → JM 插件 可视化修改，保存即写 config.json：

配置项	说明
python	Python 命令，多个逗号分隔（默认 python3, python）
proxy	HTTP 代理，如 http://127.0.0.1:7890
baseUrl	自定义 API 域名，每行一个（留空使用内置）
masterOnly	开启后所有命令仅主人可用
notify	下载完成通知：auto 群/私聊 / text 仅日志
help	自定义帮助文档（留空用内置默认）
pdfCacheMax	PDF 缓存上限：保留最近 N 个（0 = 不限制，默认 20）

方式二：手工编辑

• config.json：锅巴写入的最终配置，优先级最高。
• config.def.js：默认配置模板，复制为 config.js 可手动覆盖。
• 环境变量：JM_PYTHON / JM_PROXY / JM_BASE_URL（默认值来源）。

PDF 下载与发送

#jm下载 <ID>：下载漫画 → 图片转 PDF（优先 img2pdf，回退 Pillow）→ 保存到 downloads/ → 经 file:// 发送（群→群文件，私聊→私聊文件）；发送失败退化为服务器路径提示。

生成规则：单章 → <ID>.pdf；多章 → <ID>_ch01.pdf…（每章一个）；单章过大（>200 页或 >1GB）→ 分片 <ID>_p01.pdf…；同名 PDF 已存在则直接返回缓存；生成后自动清理原始图片。

数据存储

• 用户登录状态：redis，key jm:user:<QQ号>（用户名 + Cookie，30 天过期），每用户独立。
• 下载目录：优先 JM_DOWNLOAD_DIR 环境变量，未设置回退插件目录 downloads/。

目录结构

jm-plugin/
├── index.js              # 插件入口（命令分发 / 用户记忆 / 后台下载）
├── jmcomic-bridge.py     # Python 桥接脚本（登录/收藏/搜索/详情/排行/下载）
├── guoba.support.js      # 锅巴 WebUI 配置支持
├── components/config.js  # 共享配置模块（默认值 + config.json 读写）
├── config.def.js         # 默认配置模板（复制为 config.js 生效）
└── downloads/            # 运行时生成：漫画下载目录

常见问题

• 未找到 Python：未安装或 python3 不在 PATH；用 JM_PYTHON 指定绝对路径，或在锅巴配置中填写。
• ip地区禁止访问：JM 对部分 IP 地区受限，配置 proxy 后重试；或配置 baseUrl 换 API 域名。
• 下载很久没通知：大本子耗时长属正常，可查看日志中的 [jm-plugin] 输出。
• 文件发送失败：yunzai 与协议端分离部署时需共享同一非 root 路径，并给容器设置 JM_DOWNLOAD_DIR=同路径。
• 锅巴看不到 JM 插件：确认 Guoba-Plugin 已安装且支持 v3，重启 Yunzai 后再看。

免责声明

本插件仅用于学习与插件开发；请勿用于商业用途，下载内容请遵守所在地法律法规并注意版权。