jmcomic 2.5.12__tar.gz → 2.5.15__tar.gz

{jmcomic-2.5.12/src/jmcomic.egg-info → jmcomic-2.5.15}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: jmcomic
-Version: 2.5.12
+Version: 2.5.15
 Summary: Python API For JMComic (禁漫天堂)
 Home-page: https://github.com/hect0x7/JMComic-Crawler-Python
 Author: hect0x7
@@ -40,24 +40,26 @@ Requires-Dist: pycryptodome
 
 ## 项目介绍
 
-本项目的核心功能是下载本子，基于此，设计了一套方便使用、便于扩展，能满足一些特殊下载需求的框架。
+本项目的核心功能是下载本子。
 
-目前核心功能实现较为稳定，项目也处于维护阶段。
+基于此，设计了一套方便使用、便于扩展，能满足一些特殊下载需求的框架。
 
-除了下载功能以外，也实现了其他的一些禁漫接口，按需实现，具体如下。
+目前核心功能实现较为稳定，项目也处于维护阶段。
 
-### 已实现的禁漫API：
+除了下载功能以外，也实现了其他的一些禁漫接口，按需实现。目前已有功能：
 
 - 登录
-- 搜本
-- 分类 (排行榜)
-- 本子章节详情
+- 搜索本子（支持所有搜索项）
 - 图片下载解码
-- 收藏夹
-- 移动端接口加解密
+- 分类/排行榜
+- 本子/章节详情
+- 个人收藏夹
+- 接口加解密（APP的接口）
 
 ## 安装教程
 
+> ⚠如果你没有安装过Python，需要先安装Python再执行下面的步骤，且版本需要>=3.7（[点我去python官网下载](https://www.python.org/downloads/)）
+
 * 通过pip官方源安装（推荐，并且更新也是这个命令）
 
   ```shell
@@ -72,7 +74,9 @@ Requires-Dist: pycryptodome
 ## 快速上手
 
 ### 1. 下载本子方法
+
 只需要使用如下代码，就可以下载本子`JM422866`的所有章节的图片：
+
 ```python
 import jmcomic  # 导入此模块，需要先安装.
 jmcomic.download_album('422866')  # 传入要下载的album的id，即可下载整个album到本地.
@@ -85,10 +89,10 @@ jmcomic.download_album('422866')  # 传入要下载的album的id，即可下载
 ### 2. 使用option配置来下载本子
 
 1. 首先，创建一个配置文件，假设文件名为 `option.yml`
-   
-    该文件有特定的写法，你需要参考这个文档 → [option配置](./assets/docs/sources/option_file_syntax.md)
-    
-    下面做一个演示，假设你需要把下载的图片转为png格式，你应该把以下内容写进`option.yml`
+
+   该文件有特定的写法，你需要参考这个文档 → [配置文件指南](./assets/docs/sources/option_file_syntax.md)
+
+   下面做一个演示，假设你需要把下载的图片转为png格式，你应该把以下内容写进`option.yml`
 
 ```yml
 download:
@@ -97,6 +101,7 @@ download:
 ```
 
 2. 第二步，运行下面的python代码
+
 ```python
 import jmcomic
 
@@ -104,24 +109,14 @@ import jmcomic
 option = jmcomic.create_option_by_file('你的配置文件路径，例如 D:/option.yml')
 # 使用option对象来下载本子
 jmcomic.download_album(422866, option)
+# 等价写法: option.download_album(422866)
 ```
 
-
-
 ## 进阶使用
 
-文档网站：[jmcomic.readthedocs.io](https://jmcomic.readthedocs.io/en/latest)
-
-首先，就下载功能，jmcomic提供了很多配置项，大部分的下载需求你都可以通过上文介绍的配置文件来配置。
+请查阅文档首页→[jmcomic.readthedocs.io](https://jmcomic.readthedocs.io/zh-cn/latest)
 
-如果你不满足于下载，还有其他的使用需求，推荐你先看看以下文档：
-
-* [jmcomic常用类和方法演示](assets/docs/sources/tutorial/0_demo.md)
-* [option配置文件语法（包含插件配置）](./assets/docs/sources/option_file_syntax.md)
-* [GitHub Actions使用教程](./assets/docs/sources/tutorial/1_github_actions.md)
-* [命令行使用教程](assets/docs/sources/tutorial/2_command_line.md)
-* [插件机制](assets/docs/sources/tutorial/6_plugin.md)
-* [下载过滤器机制](assets/docs/sources/tutorial/5_filter.md)
+（提示：jmcomic提供了很多下载配置项，大部分的下载需求你都可以尝试寻找相关配置项或插件来实现。）
 
 ## 项目特点
 
@@ -129,35 +124,35 @@ jmcomic.download_album(422866, option)
 - **实现禁漫APP接口最新的加解密算法 (1.6.3)**
 - 用法多样：
 
-    - GitHub
-      Actions：网页上直接输入本子id就能下载（[教程：使用GitHub Actions下载禁漫本子](./assets/docs/sources/tutorial/1_github_actions.md)）
-    - 命令行：无需写Python代码，简单易用（[教程：使用命令行下载禁漫本子](./assets/docs/sources/tutorial/2_command_line.md)）
-    - Python代码：最本质、最强大的使用方式，需要你有一定的python编程基础
+  - GitHub
+    Actions：网页上直接输入本子id就能下载（[教程：使用GitHub Actions下载禁漫本子](./assets/docs/sources/tutorial/1_github_actions.md)）
+  - 命令行：无需写Python代码，简单易用（[教程：使用命令行下载禁漫本子](./assets/docs/sources/tutorial/2_command_line.md)）
+  - Python代码：最本质、最强大的使用方式，需要你有一定的python编程基础
 - 支持**网页端**和**移动端**两种客户端实现，可通过配置切换（**移动端不限ip兼容性好，网页端限制ip地区但效率高**）
 - 支持**自动重试和域名切换**机制
 - **多线程下载**（可细化到一图一线程，效率极高）
 - **可配置性强**
 
-    - 不配置也能使用，十分方便
-    - 配置可以从配置文件生成，支持多种文件格式
-    - 配置点有：`请求域名` `客户端实现` `是否使用磁盘缓存` `同时下载的章节/图片数量` `图片格式转换` `下载路径规则` `请求元信息（headers,cookies,proxies）`
-  等
+  - 不配置也能使用，十分方便
+  - 配置可以从配置文件生成，支持多种文件格式
+  - 配置点有：`请求域名` `客户端实现` `是否使用磁盘缓存` `同时下载的章节/图片数量` `图片格式转换` `下载路径规则` `请求元信息（headers,cookies,proxies）`
+    等
 - **可扩展性强**
 
-    - 支持自定义本子/章节/图片下载前后的回调函数
-    - 支持自定义类：`Downloader（负责调度）` `Option（负责配置）` `Client（负责请求）` `实体类`等
-    - 支持自定义日志、异常监听器
-    - **支持Plugin插件，可以方便地扩展功能，以及使用别人的插件，目前内置插件有**：
-        - `登录插件`
-        - `硬件占用监控插件`
-        - `只下载新章插件`
-        - `压缩文件插件`
-        - `下载特定后缀图片插件`
-        - `发送QQ邮件插件`
-        - `日志主题过滤插件`
-        - `自动使用浏览器cookies插件`
-        - `jpg图片合成为一个pdf插件`
-        - `导出收藏夹为csv文件插件`
+  - 支持自定义本子/章节/图片下载前后的回调函数
+  - 支持自定义类：`Downloader（负责调度）` `Option（负责配置）` `Client（负责请求）` `实体类`等
+  - 支持自定义日志、异常监听器
+  - **支持Plugin插件，可以方便地扩展功能，以及使用别人的插件，目前内置插件有**：
+    - `登录插件`
+    - `硬件占用监控插件`
+    - `只下载新章插件`
+    - `压缩文件插件`
+    - `下载特定后缀图片插件`
+    - `发送QQ邮件插件`
+    - `日志主题过滤插件`
+    - `自动使用浏览器cookies插件`
+    - `jpg图片合成为一个pdf插件`
+    - `导出收藏夹为csv文件插件`
 
 ## 使用小说明
 
@@ -169,13 +164,11 @@ jmcomic.download_album(422866, option)
 * .github：GitHub Actions配置文件
 * assets：存放一些非代码的资源文件
 
-    * docs：项目文档
-    * option：存放配置文件
-
+  * docs：项目文档
+  * option：存放配置文件
 * src：存放源代码
 
-    * jmcomic：`jmcomic`模块
-
+  * jmcomic：`jmcomic`模块
 * tests：测试目录，存放测试代码，使用unittest
 * usage：用法目录，存放示例/使用代码
 
@@ -183,4 +176,10 @@ jmcomic.download_album(422866, option)
 
 ### 图片分割算法代码+禁漫移动端API
 
-[![Readme Card](https://github-readme-stats.vercel.app/api/pin/?username=tonquer&repo=JMComic-qt)](https://github.com/tonquer/JMComic-qt)
+<a href="https://github.com/tonquer/JMComic-qt">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="https://github-readme-stats.vercel.app/api/pin/?username=tonquer&repo=JMComic-qt&theme=radical" />
+    <source media="(prefers-color-scheme: light)" srcset="https://github-readme-stats.vercel.app/api/pin/?username=tonquer&repo=JMComic-qt" />
+    <img alt="Repo Card" src="https://github-readme-stats.vercel.app/api/pin/?username=tonquer&repo=JMComic-qt" />
+  </picture>
+</a>

jmcomic-2.5.15/README.md

@@ -0,0 +1,157 @@
+# Python API For JMComic (禁漫天堂)
+
+本项目封装了一套可用于爬取JM的Python API.
+
+你可以通过简单的几行Python代码，实现下载JM上的本子到本地，并且是处理好的图片。
+
+[【指路】教程：使用GitHub Actions下载禁漫本子](./assets/docs/sources/tutorial/1_github_actions.md)
+
+[【指路】教程：导出并下载你的禁漫收藏夹数据](./assets/docs/sources/tutorial/10_export_favorites.md)
+
+**友情提示：珍爱JM，为了减轻JM的服务器压力，请不要一次性爬取太多本子，西门🙏🙏🙏**.
+
+## 项目介绍
+
+本项目的核心功能是下载本子。
+
+基于此，设计了一套方便使用、便于扩展，能满足一些特殊下载需求的框架。
+
+目前核心功能实现较为稳定，项目也处于维护阶段。
+
+除了下载功能以外，也实现了其他的一些禁漫接口，按需实现。目前已有功能：
+
+- 登录
+- 搜索本子（支持所有搜索项）
+- 图片下载解码
+- 分类/排行榜
+- 本子/章节详情
+- 个人收藏夹
+- 接口加解密（APP的接口）
+
+## 安装教程
+
+> ⚠如果你没有安装过Python，需要先安装Python再执行下面的步骤，且版本需要>=3.7（[点我去python官网下载](https://www.python.org/downloads/)）
+
+* 通过pip官方源安装（推荐，并且更新也是这个命令）
+
+  ```shell
+  pip install jmcomic -i https://pypi.org/project -U
+  ```
+* 通过源代码安装
+
+  ```shell
+  pip install git+https://github.com/hect0x7/JMComic-Crawler-Python
+  ```
+
+## 快速上手
+
+### 1. 下载本子方法
+
+只需要使用如下代码，就可以下载本子`JM422866`的所有章节的图片：
+
+```python
+import jmcomic  # 导入此模块，需要先安装.
+jmcomic.download_album('422866')  # 传入要下载的album的id，即可下载整个album到本地.
+```
+
+上面的 `download_album`方法还有一个参数`option`，可用于控制下载配置，配置包括禁漫域名、网络代理、图片格式转换、插件等等。
+
+你可能需要这些配置项。推荐使用配置文件创建option，用option下载本子，见下章：
+
+### 2. 使用option配置来下载本子
+
+1. 首先，创建一个配置文件，假设文件名为 `option.yml`
+
+   该文件有特定的写法，你需要参考这个文档 → [配置文件指南](./assets/docs/sources/option_file_syntax.md)
+
+   下面做一个演示，假设你需要把下载的图片转为png格式，你应该把以下内容写进`option.yml`
+
+```yml
+download:
+  image:
+    suffix: .png # 该配置用于把下载的图片转为png格式
+```
+
+2. 第二步，运行下面的python代码
+
+```python
+import jmcomic
+
+# 创建配置对象
+option = jmcomic.create_option_by_file('你的配置文件路径，例如 D:/option.yml')
+# 使用option对象来下载本子
+jmcomic.download_album(422866, option)
+# 等价写法: option.download_album(422866)
+```
+
+## 进阶使用
+
+请查阅文档首页→[jmcomic.readthedocs.io](https://jmcomic.readthedocs.io/zh-cn/latest)
+
+（提示：jmcomic提供了很多下载配置项，大部分的下载需求你都可以尝试寻找相关配置项或插件来实现。）
+
+## 项目特点
+
+- **绕过Cloudflare的反爬虫**
+- **实现禁漫APP接口最新的加解密算法 (1.6.3)**
+- 用法多样：
+
+  - GitHub
+    Actions：网页上直接输入本子id就能下载（[教程：使用GitHub Actions下载禁漫本子](./assets/docs/sources/tutorial/1_github_actions.md)）
+  - 命令行：无需写Python代码，简单易用（[教程：使用命令行下载禁漫本子](./assets/docs/sources/tutorial/2_command_line.md)）
+  - Python代码：最本质、最强大的使用方式，需要你有一定的python编程基础
+- 支持**网页端**和**移动端**两种客户端实现，可通过配置切换（**移动端不限ip兼容性好，网页端限制ip地区但效率高**）
+- 支持**自动重试和域名切换**机制
+- **多线程下载**（可细化到一图一线程，效率极高）
+- **可配置性强**
+
+  - 不配置也能使用，十分方便
+  - 配置可以从配置文件生成，支持多种文件格式
+  - 配置点有：`请求域名` `客户端实现` `是否使用磁盘缓存` `同时下载的章节/图片数量` `图片格式转换` `下载路径规则` `请求元信息（headers,cookies,proxies）`
+    等
+- **可扩展性强**
+
+  - 支持自定义本子/章节/图片下载前后的回调函数
+  - 支持自定义类：`Downloader（负责调度）` `Option（负责配置）` `Client（负责请求）` `实体类`等
+  - 支持自定义日志、异常监听器
+  - **支持Plugin插件，可以方便地扩展功能，以及使用别人的插件，目前内置插件有**：
+    - `登录插件`
+    - `硬件占用监控插件`
+    - `只下载新章插件`
+    - `压缩文件插件`
+    - `下载特定后缀图片插件`
+    - `发送QQ邮件插件`
+    - `日志主题过滤插件`
+    - `自动使用浏览器cookies插件`
+    - `jpg图片合成为一个pdf插件`
+    - `导出收藏夹为csv文件插件`
+
+## 使用小说明
+
+* Python >= 3.7
+* 个人项目，文档和示例会有不及时之处，可以Issue提问
+
+## 项目文件夹介绍
+
+* .github：GitHub Actions配置文件
+* assets：存放一些非代码的资源文件
+
+  * docs：项目文档
+  * option：存放配置文件
+* src：存放源代码
+
+  * jmcomic：`jmcomic`模块
+* tests：测试目录，存放测试代码，使用unittest
+* usage：用法目录，存放示例/使用代码
+
+## 感谢以下项目
+
+### 图片分割算法代码+禁漫移动端API
+
+<a href="https://github.com/tonquer/JMComic-qt">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="https://github-readme-stats.vercel.app/api/pin/?username=tonquer&repo=JMComic-qt&theme=radical" />
+    <source media="(prefers-color-scheme: light)" srcset="https://github-readme-stats.vercel.app/api/pin/?username=tonquer&repo=JMComic-qt" />
+    <img alt="Repo Card" src="https://github-readme-stats.vercel.app/api/pin/?username=tonquer&repo=JMComic-qt" />
+  </picture>
+</a>

{jmcomic-2.5.12 → jmcomic-2.5.15}/src/jmcomic/__init__.py

@@ -2,7 +2,7 @@
 # 被依赖方 <--- 使用方
 # config <--- entity <--- toolkit <--- client <--- option <--- downloader
 
-__version__ = '2.5.12'
+__version__ = '2.5.15'
 
 from .api import *
 from .jm_plugin import *

{jmcomic-2.5.12 → jmcomic-2.5.15}/src/jmcomic/jm_client_impl.py

@@ -237,6 +237,9 @@ class JmHtmlClient(AbstractJmClient):
 
     func_to_cache = ['search', 'fetch_detail_entity']
 
+    API_SEARCH = '/search/photos'
+    API_CATEGORY = '/albums'
+
     def add_favorite_album(self,
                            album_id,
                            folder_id='0',
@@ -304,7 +307,12 @@ class JmHtmlClient(AbstractJmClient):
                main_tag: int,
                order_by: str,
                time: str,
+               category: str,
+               sub_category: Optional[str],
                ) -> JmSearchPage:
+        """
+        网页搜索API
+        """
         params = {
             'main_tag': main_tag,
             'search_query': search_query,
@@ -313,8 +321,10 @@ class JmHtmlClient(AbstractJmClient):
             't': time,
         }
 
+        url = self.build_search_url(self.API_SEARCH, category, sub_category)
+
         resp = self.get_jm_html(
-            self.append_params_to_url('/search/photos', params),
+            self.append_params_to_url(url, params),
             allow_redirects=True,
         )
 
@@ -326,11 +336,31 @@ class JmHtmlClient(AbstractJmClient):
         else:
             return JmPageTool.parse_html_to_search_page(resp.text)
 
+    @classmethod
+    def build_search_url(cls, base: str, category: str, sub_category: Optional[str]):
+        """
+        构建网页搜索/分类的URL
+
+        示例：
+        :param base: "/search/photos"
+        :param category CATEGORY_DOUJIN
+        :param sub_category SUB_DOUJIN_CG
+        :return "/search/photos/doujin/sub/CG"
+        """
+        if category == JmMagicConstants.CATEGORY_ALL:
+            return base
+
+        if sub_category is None:
+            return f'{base}/{category}'
+        else:
+            return f'{base}/{category}/sub/{sub_category}'
+
     def categories_filter(self,
                           page: int,
                           time: str,
                           category: str,
                           order_by: str,
+                          sub_category: Optional[str] = None,
                           ) -> JmCategoryPage:
         params = {
             'page': page,
@@ -338,7 +368,7 @@ class JmHtmlClient(AbstractJmClient):
             't': time,
         }
 
-        url = f'/albums/' + (category if category != JmMagicConstants.CATEGORY_ALL else '')
+        url = self.build_search_url(self.API_CATEGORY, category, sub_category)
 
         resp = self.get_jm_html(
             self.append_params_to_url(url, params),
@@ -372,7 +402,7 @@ class JmHtmlClient(AbstractJmClient):
                          allow_redirects=False,
                          )
 
-        if resp.status_code != 301:
+        if resp.status_code != 200:
             ExceptionTool.raises_resp(f'登录失败，状态码为{resp.status_code}', resp)
 
         orig_cookies = self.get_meta_data('cookies') or {}
@@ -573,7 +603,12 @@ class JmApiClient(AbstractJmClient):
                main_tag: int,
                order_by: str,
                time: str,
+               category: str,
+               sub_category: Optional[str],
                ) -> JmSearchPage:
+        """
+        移动端暂不支持 category和sub_category
+        """
         params = {
             'main_tag': main_tag,
             'search_query': search_query,
@@ -603,7 +638,11 @@ class JmApiClient(AbstractJmClient):
                           time: str,
                           category: str,
                           order_by: str,
+                          sub_category: Optional[str] = None,
                           ):
+        """
+        移动端不支持 sub_category
+        """
         # o: mv, mv_m, mv_w, mv_t
         o = f'{order_by}_{time}' if time != JmMagicConstants.TIME_ALL else order_by
 

{jmcomic-2.5.12 → jmcomic-2.5.15}/src/jmcomic/jm_client_interface.py

@@ -308,9 +308,14 @@ class JmSearchAlbumClient:
                main_tag: int,
                order_by: str,
                time: str,
+               category: str,
+               sub_category: Optional[str],
                ) -> JmSearchPage:
         """
         搜索【成人A漫】
+        网页端与移动端的搜索有差别：
+
+        - 移动端不支持 category, sub_category参数，网页端支持全部参数
         """
         raise NotImplementedError
 
@@ -319,55 +324,65 @@ class JmSearchAlbumClient:
                     page: int = 1,
                     order_by: str = JmMagicConstants.ORDER_BY_LATEST,
                     time: str = JmMagicConstants.TIME_ALL,
+                    category: str = JmMagicConstants.CATEGORY_ALL,
+                    sub_category: Optional[str] = None,
                     ):
         """
         对应禁漫的站内搜索
         """
-        return self.search(search_query, page, 0, order_by, time)
+        return self.search(search_query, page, 0, order_by, time, category, sub_category)
 
     def search_work(self,
                     search_query: str,
                     page: int = 1,
                     order_by: str = JmMagicConstants.ORDER_BY_LATEST,
                     time: str = JmMagicConstants.TIME_ALL,
+                    category: str = JmMagicConstants.CATEGORY_ALL,
+                    sub_category: Optional[str] = None,
                     ):
         """
         搜索album的作品 work
         """
-        return self.search(search_query, page, 1, order_by, time)
+        return self.search(search_query, page, 1, order_by, time, category, sub_category)
 
     def search_author(self,
                       search_query: str,
                       page: int = 1,
                       order_by: str = JmMagicConstants.ORDER_BY_LATEST,
                       time: str = JmMagicConstants.TIME_ALL,
+                      category: str = JmMagicConstants.CATEGORY_ALL,
+                      sub_category: Optional[str] = None,
                       ):
         """
         搜索album的作者 author
         """
-        return self.search(search_query, page, 2, order_by, time)
+        return self.search(search_query, page, 2, order_by, time, category, sub_category)
 
     def search_tag(self,
                    search_query: str,
                    page: int = 1,
                    order_by: str = JmMagicConstants.ORDER_BY_LATEST,
                    time: str = JmMagicConstants.TIME_ALL,
+                   category: str = JmMagicConstants.CATEGORY_ALL,
+                   sub_category: Optional[str] = None,
                    ):
         """
         搜索album的标签 tag
         """
-        return self.search(search_query, page, 3, order_by, time)
+        return self.search(search_query, page, 3, order_by, time, category, sub_category)
 
     def search_actor(self,
                      search_query: str,
                      page: int = 1,
                      order_by: str = JmMagicConstants.ORDER_BY_LATEST,
                      time: str = JmMagicConstants.TIME_ALL,
+                     category: str = JmMagicConstants.CATEGORY_ALL,
+                     sub_category: Optional[str] = None,
                      ):
         """
         搜索album的登场角色 actor
         """
-        return self.search(search_query, page, 4, order_by, time)
+        return self.search(search_query, page, 4, order_by, time, category, sub_category)
 
 
 class JmCategoryClient:
@@ -384,6 +399,7 @@ class JmCategoryClient:
                           time: str,
                           category: str,
                           order_by: str,
+                          sub_category: Optional[str] = None,
                           ) -> JmCategoryPage:
         """
         分类
@@ -391,6 +407,7 @@ class JmCategoryClient:
         :param page: 页码
         :param time: 时间范围，默认是全部时间
         :param category: 类别，默认是最新，即显示最新的禁漫本子
+        :param sub_category: 副分类，仅网页端有这功能
         :param order_by: 排序方式，默认是观看数
         """
         raise NotImplementedError
@@ -522,6 +539,8 @@ class JmcomicClient(
                    page: int = 1,
                    order_by: str = JmMagicConstants.ORDER_BY_LATEST,
                    time: str = JmMagicConstants.TIME_ALL,
+                   category: str = JmMagicConstants.CATEGORY_ALL,
+                   sub_category: Optional[str] = None,
                    ) -> Generator[JmSearchPage, Dict, None]:
         """
         搜索结果的生成器，支持下面这种调用方式：
@@ -552,6 +571,8 @@ class JmcomicClient(
             'main_tag': main_tag,
             'order_by': order_by,
             'time': time,
+            'category': category,
+            'sub_category': sub_category,
         }
 
         yield from self.do_page_iter(params, page, self.search)
@@ -561,6 +582,7 @@ class JmcomicClient(
                               time: str = JmMagicConstants.TIME_ALL,
                               category: str = JmMagicConstants.CATEGORY_ALL,
                               order_by: str = JmMagicConstants.ORDER_BY_LATEST,
+                              sub_category: Optional[str] = None,
                               ) -> Generator[JmCategoryPage, Dict, None]:
         """
         见 search_gen
@@ -569,6 +591,7 @@ class JmcomicClient(
             'time': time,
             'category': category,
             'order_by': order_by,
+            'sub_category': sub_category,
         }
 
         yield from self.do_page_iter(params, page, self.categories_filter)

{jmcomic-2.5.12 → jmcomic-2.5.15}/src/jmcomic/jm_config.py

@@ -35,7 +35,29 @@ class JmMagicConstants:
     CATEGORY_DOUJIN_COSPLAY = 'doujin_cosplay'  # cosplay
     CATEGORY_3D = '3D'  # 3D
     CATEGORY_ENGLISH_SITE = 'english_site'  # 英文站
-    CATEGORY_JM_TEAM = '禁漫漢化組'
+
+    # 副分类
+    SUB_CHINESE = 'chinese'  # 汉化，通用副分类
+    SUB_JAPANESE = 'japanese'  # 日语，通用副分类
+
+    # 其他类（CATEGORY_ANOTHER）的副分类
+    SUB_ANOTHER_OTHER = 'other'  # 其他漫画
+    SUB_ANOTHER_3D = '3d'  # 3D
+    SUB_ANOTHER_COSPLAY = 'cosplay'  # cosplay
+
+    # 同人（SUB_CHINESE）的副分类
+    SUB_DOUJIN_CG = 'CG'  # CG
+    SUB_DOUJIN_CHINESE = SUB_CHINESE
+    SUB_DOUJIN_JAPANESE = SUB_JAPANESE
+
+    # 短篇（CATEGORY_SHORT）的副分类
+    SUB_SHORT_CHINESE = SUB_CHINESE
+    SUB_SHORT_JAPANESE = SUB_JAPANESE
+
+    # 单本（CATEGORY_SINGLE）的副分类
+    SUB_SINGLE_CHINESE = SUB_CHINESE
+    SUB_SINGLE_JAPANESE = SUB_JAPANESE
+    SUB_SINGLE_YOUTH = 'youth'
 
     # 分页大小
     PAGE_SIZE_SEARCH = 80
@@ -53,7 +75,7 @@ class JmMagicConstants:
     APP_TOKEN_SECRET = '18comicAPP'
     APP_TOKEN_SECRET_2 = '18comicAPPContent'
     APP_DATA_SECRET = '185Hcomic3PAPP7R'
-    APP_VERSION = '1.6.7'
+    APP_VERSION = '1.7.0'
     APP_HEADERS_TEMPLATE = {
         'Accept-Encoding': 'gzip',
         'user-agent': 'Mozilla/5.0 (Linux; Android 9; V1938CT Build/PQ3A.190705.11211812; wv) AppleWebKit/537.36 (KHTML, '
@@ -65,14 +87,20 @@ class JmMagicConstants:
         'accept': 'text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,'
                   'application/signed-exchange;v=b3;q=0.7',
         'accept-language': 'zh-CN,zh;q=0.9',
-        'sec-ch-ua': '"Not.A/Brand";v="8", "Chromium";v="114", "Google Chrome";v="114"',
+        'cache-control': 'no-cache',
+        'dnt': '1',
+        'pragma': 'no-cache',
+        'priority': 'u=0, i',
+        'referer': 'https://18comic.vip/',
+        'sec-ch-ua': '"Chromium";v="124", "Google Chrome";v="124", "Not-A.Brand";v="99"',
         'sec-ch-ua-mobile': '?0',
         'sec-ch-ua-platform': '"Windows"',
         'sec-fetch-dest': 'document',
         'sec-fetch-mode': 'navigate',
         'sec-fetch-site': 'none',
         'sec-fetch-user': '?1',
-        'user-agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/114.0.0.0 '
+        'upgrade-insecure-requests': '1',
+        'user-agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 '
                       'Safari/537.36',
     }
 

{jmcomic-2.5.12 → jmcomic-2.5.15}/src/jmcomic/jm_plugin.py

@@ -1,6 +1,7 @@
 """
 该文件存放的是option插件
 """
+import os.path
 
 from .jm_option import *
 
@@ -296,91 +297,63 @@ class ZipPlugin(JmOptionPlugin):
         zip_dir = JmcomicText.parse_to_abspath(zip_dir)
         mkdir_if_not_exists(zip_dir)
 
-        # 原文件夹 -> zip文件
-        dir_zip_dict: Dict[str, Optional[str]] = {}
+        path_to_delete = []
         photo_dict = downloader.download_success_dict[album]
 
         if level == 'album':
             zip_path = self.get_zip_path(album, None, filename_rule, suffix, zip_dir)
-            self.zip_album(album, photo_dict, zip_path, dir_zip_dict)
+            self.zip_album(album, photo_dict, zip_path, path_to_delete)
 
         elif level == 'photo':
             for photo, image_list in photo_dict.items():
                 zip_path = self.get_zip_path(None, photo, filename_rule, suffix, zip_dir)
-                self.zip_photo(photo, image_list, zip_path, dir_zip_dict)
+                self.zip_photo(photo, image_list, zip_path, path_to_delete)
 
         else:
             ExceptionTool.raises(f'Not Implemented Zip Level: {level}')
 
-        self.after_zip(dir_zip_dict)
+        self.after_zip(path_to_delete)
 
-    def zip_photo(self, photo, image_list: list, zip_path: str, dir_zip_dict) -> Optional[str]:
+    def zip_photo(self, photo, image_list: list, zip_path: str, path_to_delete):
         """
         压缩photo文件夹
-        :returns: photo文件夹路径
         """
         photo_dir = self.option.decide_image_save_dir(photo) \
             if len(image_list) == 0 \
             else os.path.dirname(image_list[0][0])
 
-        all_filepath = set(map(lambda t: self.unified_path(t[0]), image_list))
-
-        if len(all_filepath) == 0:
-            self.log('无下载文件，无需压缩', 'skip')
-            return None
-
         from common import backup_dir_to_zip
-        backup_dir_to_zip(
-            photo_dir,
-            zip_path,
-            acceptor=lambda f: os.path.isdir(f) or self.unified_path(f) in all_filepath
-        ).close()
+        backup_dir_to_zip(photo_dir, zip_path)
 
         self.log(f'压缩章节[{photo.photo_id}]成功 → {zip_path}', 'finish')
-        dir_zip_dict[self.unified_path(photo_dir)] = zip_path
+        path_to_delete.append(self.unified_path(photo_dir))
 
     @staticmethod
     def unified_path(f):
         return fix_filepath(f, os.path.isdir(f))
 
-    def zip_album(self, album, photo_dict: dict, zip_path, dir_zip_dict) -> Optional[str]:
+    def zip_album(self, album, photo_dict: dict, zip_path, path_to_delete):
         """
         压缩album文件夹
-        :returns: album文件夹路径
         """
 
-        # 所有下载了的图片文件的路径
-        all_filepath: Set[str] = set(path for ls in photo_dict.values() for path, _ in ls)
-
-        if len(all_filepath) == 0:
-            self.log('无下载文件，无需压缩', 'skip')
-            return
-
-        # 该本子的所有章节的图片所在文件夹
-        photo_dir_list = [self.option.decide_image_save_dir(photo) for photo in photo_dict.keys()]
-
-        # 压缩文件对象
-        from common import backup_dir_to_zip
+        album_dir = self.option.dir_rule.decide_album_root_dir(album)
         import zipfile
-        zfile = zipfile.ZipFile(zip_path, 'w')
-
-        for photo_dir in photo_dir_list:
-            photo_dir = self.unified_path(photo_dir)
-            backup_dir_to_zip(
-                photo_dir,
-                zip_path,
-                zfile=zfile,
-                prefix=os.path.basename(photo_dir.rstrip('/')),
-                acceptor=lambda f: os.path.isdir(f) or self.unified_path(f) in all_filepath
-            )
-            dir_zip_dict[photo_dir] = zip_path
-
-        zfile.close()
+        with zipfile.ZipFile(zip_path, 'w', zipfile.ZIP_DEFLATED) as f:
+            for photo in photo_dict.keys():
+                # 定位到章节所在文件夹
+                photo_dir = self.unified_path(self.option.decide_image_save_dir(photo))
+                # 章节文件夹标记为删除
+                path_to_delete.append(photo_dir)
+                for file in files_of_dir(photo_dir):
+                    abspath = os.path.join(photo_dir, file)
+                    relpath = os.path.relpath(abspath, album_dir)
+                    f.write(abspath, relpath)
         self.log(f'压缩本子[{album.album_id}]成功 → {zip_path}', 'finish')
 
-    def after_zip(self, dir_zip_dict: Dict[str, Optional[str]]):
+    def after_zip(self, path_to_delete: List[str]):
         # 删除所有原文件
-        dirs = sorted(dir_zip_dict.keys(), reverse=True)
+        dirs = sorted(path_to_delete, reverse=True)
         image_paths = [
             path
             for photo_dict in self.downloader.download_success_dict.values()
@@ -650,7 +623,7 @@ class FavoriteFolderExportPlugin(JmOptionPlugin):
         """
         import zipfile
 
-        with zipfile.ZipFile(zip_path, 'w') as zipf:
+        with zipfile.ZipFile(zip_path, 'w', zipfile.ZIP_DEFLATED) as zipf:
             # 获取文件夹中的文件列表并将其添加到 ZIP 文件中
             for file in files:
                 zipf.write(file, arcname=of_file_name(file))

{jmcomic-2.5.12 → jmcomic-2.5.15}/src/jmcomic/jm_toolkit.py

@@ -135,7 +135,7 @@ class JmcomicText:
                 last_pattern = pattern[len(pattern) - 1]
                 # 缩小文本
                 for i in range(0, len(pattern) - 1):
-                    match = pattern[i].search(text)
+                    match: Match = pattern[i].search(text)
                     if match is None:
                         return None
                     text = match[0]

{jmcomic-2.5.12 → jmcomic-2.5.15/src/jmcomic.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: jmcomic
-Version: 2.5.12
+Version: 2.5.15
 Summary: Python API For JMComic (禁漫天堂)
 Home-page: https://github.com/hect0x7/JMComic-Crawler-Python
 Author: hect0x7
@@ -40,24 +40,26 @@ Requires-Dist: pycryptodome
 
 ## 项目介绍
 
-本项目的核心功能是下载本子，基于此，设计了一套方便使用、便于扩展，能满足一些特殊下载需求的框架。
+本项目的核心功能是下载本子。
 
-目前核心功能实现较为稳定，项目也处于维护阶段。
+基于此，设计了一套方便使用、便于扩展，能满足一些特殊下载需求的框架。
 
-除了下载功能以外，也实现了其他的一些禁漫接口，按需实现，具体如下。
+目前核心功能实现较为稳定，项目也处于维护阶段。
 
-### 已实现的禁漫API：
+除了下载功能以外，也实现了其他的一些禁漫接口，按需实现。目前已有功能：
 
 - 登录
-- 搜本
-- 分类 (排行榜)
-- 本子章节详情
+- 搜索本子（支持所有搜索项）
 - 图片下载解码
-- 收藏夹
-- 移动端接口加解密
+- 分类/排行榜
+- 本子/章节详情
+- 个人收藏夹
+- 接口加解密（APP的接口）
 
 ## 安装教程
 
+> ⚠如果你没有安装过Python，需要先安装Python再执行下面的步骤，且版本需要>=3.7（[点我去python官网下载](https://www.python.org/downloads/)）
+
 * 通过pip官方源安装（推荐，并且更新也是这个命令）
 
   ```shell
@@ -72,7 +74,9 @@ Requires-Dist: pycryptodome
 ## 快速上手
 
 ### 1. 下载本子方法
+
 只需要使用如下代码，就可以下载本子`JM422866`的所有章节的图片：
+
 ```python
 import jmcomic  # 导入此模块，需要先安装.
 jmcomic.download_album('422866')  # 传入要下载的album的id，即可下载整个album到本地.
@@ -85,10 +89,10 @@ jmcomic.download_album('422866')  # 传入要下载的album的id，即可下载
 ### 2. 使用option配置来下载本子
 
 1. 首先，创建一个配置文件，假设文件名为 `option.yml`
-   
-    该文件有特定的写法，你需要参考这个文档 → [option配置](./assets/docs/sources/option_file_syntax.md)
-    
-    下面做一个演示，假设你需要把下载的图片转为png格式，你应该把以下内容写进`option.yml`
+
+   该文件有特定的写法，你需要参考这个文档 → [配置文件指南](./assets/docs/sources/option_file_syntax.md)
+
+   下面做一个演示，假设你需要把下载的图片转为png格式，你应该把以下内容写进`option.yml`
 
 ```yml
 download:
@@ -97,6 +101,7 @@ download:
 ```
 
 2. 第二步，运行下面的python代码
+
 ```python
 import jmcomic
 
@@ -104,24 +109,14 @@ import jmcomic
 option = jmcomic.create_option_by_file('你的配置文件路径，例如 D:/option.yml')
 # 使用option对象来下载本子
 jmcomic.download_album(422866, option)
+# 等价写法: option.download_album(422866)
 ```
 
-
-
 ## 进阶使用
 
-文档网站：[jmcomic.readthedocs.io](https://jmcomic.readthedocs.io/en/latest)
-
-首先，就下载功能，jmcomic提供了很多配置项，大部分的下载需求你都可以通过上文介绍的配置文件来配置。
+请查阅文档首页→[jmcomic.readthedocs.io](https://jmcomic.readthedocs.io/zh-cn/latest)
 
-如果你不满足于下载，还有其他的使用需求，推荐你先看看以下文档：
-
-* [jmcomic常用类和方法演示](assets/docs/sources/tutorial/0_demo.md)
-* [option配置文件语法（包含插件配置）](./assets/docs/sources/option_file_syntax.md)
-* [GitHub Actions使用教程](./assets/docs/sources/tutorial/1_github_actions.md)
-* [命令行使用教程](assets/docs/sources/tutorial/2_command_line.md)
-* [插件机制](assets/docs/sources/tutorial/6_plugin.md)
-* [下载过滤器机制](assets/docs/sources/tutorial/5_filter.md)
+（提示：jmcomic提供了很多下载配置项，大部分的下载需求你都可以尝试寻找相关配置项或插件来实现。）
 
 ## 项目特点
 
@@ -129,35 +124,35 @@ jmcomic.download_album(422866, option)
 - **实现禁漫APP接口最新的加解密算法 (1.6.3)**
 - 用法多样：
 
-    - GitHub
-      Actions：网页上直接输入本子id就能下载（[教程：使用GitHub Actions下载禁漫本子](./assets/docs/sources/tutorial/1_github_actions.md)）
-    - 命令行：无需写Python代码，简单易用（[教程：使用命令行下载禁漫本子](./assets/docs/sources/tutorial/2_command_line.md)）
-    - Python代码：最本质、最强大的使用方式，需要你有一定的python编程基础
+  - GitHub
+    Actions：网页上直接输入本子id就能下载（[教程：使用GitHub Actions下载禁漫本子](./assets/docs/sources/tutorial/1_github_actions.md)）
+  - 命令行：无需写Python代码，简单易用（[教程：使用命令行下载禁漫本子](./assets/docs/sources/tutorial/2_command_line.md)）
+  - Python代码：最本质、最强大的使用方式，需要你有一定的python编程基础
 - 支持**网页端**和**移动端**两种客户端实现，可通过配置切换（**移动端不限ip兼容性好，网页端限制ip地区但效率高**）
 - 支持**自动重试和域名切换**机制
 - **多线程下载**（可细化到一图一线程，效率极高）
 - **可配置性强**
 
-    - 不配置也能使用，十分方便
-    - 配置可以从配置文件生成，支持多种文件格式
-    - 配置点有：`请求域名` `客户端实现` `是否使用磁盘缓存` `同时下载的章节/图片数量` `图片格式转换` `下载路径规则` `请求元信息（headers,cookies,proxies）`
-  等
+  - 不配置也能使用，十分方便
+  - 配置可以从配置文件生成，支持多种文件格式
+  - 配置点有：`请求域名` `客户端实现` `是否使用磁盘缓存` `同时下载的章节/图片数量` `图片格式转换` `下载路径规则` `请求元信息（headers,cookies,proxies）`
+    等
 - **可扩展性强**
 
-    - 支持自定义本子/章节/图片下载前后的回调函数
-    - 支持自定义类：`Downloader（负责调度）` `Option（负责配置）` `Client（负责请求）` `实体类`等
-    - 支持自定义日志、异常监听器
-    - **支持Plugin插件，可以方便地扩展功能，以及使用别人的插件，目前内置插件有**：
-        - `登录插件`
-        - `硬件占用监控插件`
-        - `只下载新章插件`
-        - `压缩文件插件`
-        - `下载特定后缀图片插件`
-        - `发送QQ邮件插件`
-        - `日志主题过滤插件`
-        - `自动使用浏览器cookies插件`
-        - `jpg图片合成为一个pdf插件`
-        - `导出收藏夹为csv文件插件`
+  - 支持自定义本子/章节/图片下载前后的回调函数
+  - 支持自定义类：`Downloader（负责调度）` `Option（负责配置）` `Client（负责请求）` `实体类`等
+  - 支持自定义日志、异常监听器
+  - **支持Plugin插件，可以方便地扩展功能，以及使用别人的插件，目前内置插件有**：
+    - `登录插件`
+    - `硬件占用监控插件`
+    - `只下载新章插件`
+    - `压缩文件插件`
+    - `下载特定后缀图片插件`
+    - `发送QQ邮件插件`
+    - `日志主题过滤插件`
+    - `自动使用浏览器cookies插件`
+    - `jpg图片合成为一个pdf插件`
+    - `导出收藏夹为csv文件插件`
 
 ## 使用小说明
 
@@ -169,13 +164,11 @@ jmcomic.download_album(422866, option)
 * .github：GitHub Actions配置文件
 * assets：存放一些非代码的资源文件
 
-    * docs：项目文档
-    * option：存放配置文件
-
+  * docs：项目文档
+  * option：存放配置文件
 * src：存放源代码
 
-    * jmcomic：`jmcomic`模块
-
+  * jmcomic：`jmcomic`模块
 * tests：测试目录，存放测试代码，使用unittest
 * usage：用法目录，存放示例/使用代码
 
@@ -183,4 +176,10 @@ jmcomic.download_album(422866, option)
 
 ### 图片分割算法代码+禁漫移动端API
 
-[![Readme Card](https://github-readme-stats.vercel.app/api/pin/?username=tonquer&repo=JMComic-qt)](https://github.com/tonquer/JMComic-qt)
+<a href="https://github.com/tonquer/JMComic-qt">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="https://github-readme-stats.vercel.app/api/pin/?username=tonquer&repo=JMComic-qt&theme=radical" />
+    <source media="(prefers-color-scheme: light)" srcset="https://github-readme-stats.vercel.app/api/pin/?username=tonquer&repo=JMComic-qt" />
+    <img alt="Repo Card" src="https://github-readme-stats.vercel.app/api/pin/?username=tonquer&repo=JMComic-qt" />
+  </picture>
+</a>

jmcomic-2.5.12/README.md

@@ -1,158 +0,0 @@
-# Python API For JMComic (禁漫天堂)
-
-本项目封装了一套可用于爬取JM的Python API.
-
-你可以通过简单的几行Python代码，实现下载JM上的本子到本地，并且是处理好的图片。
-
-[【指路】教程：使用GitHub Actions下载禁漫本子](./assets/docs/sources/tutorial/1_github_actions.md)
-
-[【指路】教程：导出并下载你的禁漫收藏夹数据](./assets/docs/sources/tutorial/10_export_favorites.md)
-
-**友情提示：珍爱JM，为了减轻JM的服务器压力，请不要一次性爬取太多本子，西门🙏🙏🙏**.
-
-## 项目介绍
-
-本项目的核心功能是下载本子，基于此，设计了一套方便使用、便于扩展，能满足一些特殊下载需求的框架。
-
-目前核心功能实现较为稳定，项目也处于维护阶段。
-
-除了下载功能以外，也实现了其他的一些禁漫接口，按需实现，具体如下。
-
-### 已实现的禁漫API：
-
-- 登录
-- 搜本
-- 分类 (排行榜)
-- 本子章节详情
-- 图片下载解码
-- 收藏夹
-- 移动端接口加解密
-
-## 安装教程
-
-* 通过pip官方源安装（推荐，并且更新也是这个命令）
-
-  ```shell
-  pip install jmcomic -i https://pypi.org/project -U
-  ```
-* 通过源代码安装
-
-  ```shell
-  pip install git+https://github.com/hect0x7/JMComic-Crawler-Python
-  ```
-
-## 快速上手
-
-### 1. 下载本子方法
-只需要使用如下代码，就可以下载本子`JM422866`的所有章节的图片：
-```python
-import jmcomic  # 导入此模块，需要先安装.
-jmcomic.download_album('422866')  # 传入要下载的album的id，即可下载整个album到本地.
-```
-
-上面的 `download_album`方法还有一个参数`option`，可用于控制下载配置，配置包括禁漫域名、网络代理、图片格式转换、插件等等。
-
-你可能需要这些配置项。推荐使用配置文件创建option，用option下载本子，见下章：
-
-### 2. 使用option配置来下载本子
-
-1. 首先，创建一个配置文件，假设文件名为 `option.yml`
-   
-    该文件有特定的写法，你需要参考这个文档 → [option配置](./assets/docs/sources/option_file_syntax.md)
-    
-    下面做一个演示，假设你需要把下载的图片转为png格式，你应该把以下内容写进`option.yml`
-
-```yml
-download:
-  image:
-    suffix: .png # 该配置用于把下载的图片转为png格式
-```
-
-2. 第二步，运行下面的python代码
-```python
-import jmcomic
-
-# 创建配置对象
-option = jmcomic.create_option_by_file('你的配置文件路径，例如 D:/option.yml')
-# 使用option对象来下载本子
-jmcomic.download_album(422866, option)
-```
-
-
-
-## 进阶使用
-
-文档网站：[jmcomic.readthedocs.io](https://jmcomic.readthedocs.io/en/latest)
-
-首先，就下载功能，jmcomic提供了很多配置项，大部分的下载需求你都可以通过上文介绍的配置文件来配置。
-
-如果你不满足于下载，还有其他的使用需求，推荐你先看看以下文档：
-
-* [jmcomic常用类和方法演示](assets/docs/sources/tutorial/0_demo.md)
-* [option配置文件语法（包含插件配置）](./assets/docs/sources/option_file_syntax.md)
-* [GitHub Actions使用教程](./assets/docs/sources/tutorial/1_github_actions.md)
-* [命令行使用教程](assets/docs/sources/tutorial/2_command_line.md)
-* [插件机制](assets/docs/sources/tutorial/6_plugin.md)
-* [下载过滤器机制](assets/docs/sources/tutorial/5_filter.md)
-
-## 项目特点
-
-- **绕过Cloudflare的反爬虫**
-- **实现禁漫APP接口最新的加解密算法 (1.6.3)**
-- 用法多样：
-
-    - GitHub
-      Actions：网页上直接输入本子id就能下载（[教程：使用GitHub Actions下载禁漫本子](./assets/docs/sources/tutorial/1_github_actions.md)）
-    - 命令行：无需写Python代码，简单易用（[教程：使用命令行下载禁漫本子](./assets/docs/sources/tutorial/2_command_line.md)）
-    - Python代码：最本质、最强大的使用方式，需要你有一定的python编程基础
-- 支持**网页端**和**移动端**两种客户端实现，可通过配置切换（**移动端不限ip兼容性好，网页端限制ip地区但效率高**）
-- 支持**自动重试和域名切换**机制
-- **多线程下载**（可细化到一图一线程，效率极高）
-- **可配置性强**
-
-    - 不配置也能使用，十分方便
-    - 配置可以从配置文件生成，支持多种文件格式
-    - 配置点有：`请求域名` `客户端实现` `是否使用磁盘缓存` `同时下载的章节/图片数量` `图片格式转换` `下载路径规则` `请求元信息（headers,cookies,proxies）`
-  等
-- **可扩展性强**
-
-    - 支持自定义本子/章节/图片下载前后的回调函数
-    - 支持自定义类：`Downloader（负责调度）` `Option（负责配置）` `Client（负责请求）` `实体类`等
-    - 支持自定义日志、异常监听器
-    - **支持Plugin插件，可以方便地扩展功能，以及使用别人的插件，目前内置插件有**：
-        - `登录插件`
-        - `硬件占用监控插件`
-        - `只下载新章插件`
-        - `压缩文件插件`
-        - `下载特定后缀图片插件`
-        - `发送QQ邮件插件`
-        - `日志主题过滤插件`
-        - `自动使用浏览器cookies插件`
-        - `jpg图片合成为一个pdf插件`
-        - `导出收藏夹为csv文件插件`
-
-## 使用小说明
-
-* Python >= 3.7
-* 个人项目，文档和示例会有不及时之处，可以Issue提问
-
-## 项目文件夹介绍
-
-* .github：GitHub Actions配置文件
-* assets：存放一些非代码的资源文件
-
-    * docs：项目文档
-    * option：存放配置文件
-
-* src：存放源代码
-
-    * jmcomic：`jmcomic`模块
-
-* tests：测试目录，存放测试代码，使用unittest
-* usage：用法目录，存放示例/使用代码
-
-## 感谢以下项目
-
-### 图片分割算法代码+禁漫移动端API
-
-[![Readme Card](https://github-readme-stats.vercel.app/api/pin/?username=tonquer&repo=JMComic-qt)](https://github.com/tonquer/JMComic-qt)