Skip to main content

基于NoneBot2的JM漫画下载插件

Project description

nonebot-plugin-JMDownload

✨ NoneBot 插件简单描述 ✨

license pypi python python

✨ 基于 NoneBot2 的 JM 漫画下载插件,支持下载漫画并转换为 PDF 格式。本项目使用 DeepSeek 辅助完成编写,代码可能需要进一步优化。

📦 功能特点

  • ✅ 支持通过序号下载 JM 漫画
  • ✅ 自动将下载的图片转换为 PDF 格式
  • ✅ 支持QQ群文件直接上传
  • ✅ 完善的错误提示系统
  • ✅ 自动清理临时文件

🛠️ 安装方法

前置要求

  • 已安装 NoneBot 2.0 框架
  • Python 3.8+ 环境

安装步骤

  1. 安装必要依赖
pip install jmcomic -i https://pypi.org/project -U
  1. 使用 pip 安装插件(推荐)
pip install nonebot-plugin-jmdownload
  1. 手动安装(备选)
    • 下载本插件代码
    • 解压至 plugins 目录
    • 安装依赖 pip install -r requirements.txt

安装完成后,在 nonebot2 项目的 pyproject.toml 或者 .env 文件中添加插件名称:

plugins = ["nonebot_plugin_jmdownload"]

⚙️ 使用方法

基础配置

  1. 在 NoneBot2 项目的 .env 文件中添加配置(未来移除此项的必须性):
jm_config_path="data/nonebot_plugin_jmdownload/config.yml"
  1. 首次运行时会自动生成配置文件,包含以下内容:
# Github Actions 下载脚本配置
version: '1.0'

dir_rule:
  base_dir: data/nonebot_plugin_jmdownload/downloads  # 基础存储目录
  rule: Bd_Atitle_Pindex           # 目录命名规则

client:
  domain:
    - www.jmapiproxyxxx.vip
    - www.18comic-mygo.vip
    - 18comic-MHWs.CC
    - 18comic.vip
    - 18comic.org

download:
  cache: true    # 文件存在时跳过下载
  image:
    decode: true  # 还原被混淆的图片
    suffix: .jpg  # 统一图片后缀格式
  threading:
    batch_count: 45  # 批量下载数量

🚀 命令使用

/jm download <序号>
/jm 下载 <序号>

⚠️ 注意事项

  1. 请确保机器人具有足够的存储空间
  2. 下载完成后会自动清理临时文件
  3. PDF 文件生成后会自动发送给用户

❓ 常见问题

Q: 下载失败怎么办? A: 请检查网络连接和配置文件中的域名是否可用。

Q: 为什么下载速度很慢? A: 目前需要获取所有图片后再进行转换,会造成阻塞并且导致下载速度较慢。

Q: 为什么转换 PDF 很慢? A: 转换速度取决于图片数量和大小,请耐心等待。

📝 更新日志

v1.0.0 (2025-03-25)

  • 初始版本发布
  • 支持基本的下载和 PDF 转换功能
  • 添加自动清理功能
  • 支持 QQ 群文件上传

🎯 开发计划

  • 优化 PDF 转换速度
  • 优化下载速度及阻塞问题
  • 体验必须优化!
  • 添加下载进度显示
  • 支持批量下载功能

🤝 贡献指南

欢迎提交 Issue 和 Pull Request 来帮助改进这个项目。

📄 许可证

本项目采用 BSD 3-Clause License 开源许可证。

🙏 致谢

⚖️ 免责声明

本项目仅供学习交流使用,请勿用于非法用途。使用本项目所造成的任何后果由使用者自行承担。

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

nonebot_plugin_jmdownload-1.1.2.tar.gz (4.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

nonebot_plugin_jmdownload-1.1.2-py3-none-any.whl (4.6 kB view details)

Uploaded Python 3

File details

Details for the file nonebot_plugin_jmdownload-1.1.2.tar.gz.

File metadata

File hashes

Hashes for nonebot_plugin_jmdownload-1.1.2.tar.gz
Algorithm Hash digest
SHA256 f4a7288300f247c7c97e8a41a642a8cadcf1a8ac45c6a077b222f55b8c1dea41
MD5 05b6031d269759a720c6895ab1d1a81a
BLAKE2b-256 e34ec66ff493bd449a397a9ed95992faf30788ed451bbcf52a7830199edcb0b6

See more details on using hashes here.

File details

Details for the file nonebot_plugin_jmdownload-1.1.2-py3-none-any.whl.

File metadata

File hashes

Hashes for nonebot_plugin_jmdownload-1.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 757b3f86b3acaf851c31920e301161bd3f570448393641522a3d2846ae9295e6
MD5 71f5c2b8ade81563c9ab1d577b94a87a
BLAKE2b-256 b954dafa71b6cf34de7ccb38545ea9404b599ba82a95f775f44818a9c447b796

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page