v2.4.7: 实现收藏本子功能，优化获取收藏夹功能传参，优化Headers和域名的处理; 更新文档、dispatch工作流文案+脚本. (#176)

Author: hect0x7

.github/workflows/close_specific_pr.yml

@@ -2,10 +2,12 @@ name: Close specific PR
 
 on:
   pull_request:
+    types: [opened, ]
+    # Note: If you use both the branches filter and the paths filter, the workflow will only run when both filters are satisfied.
+    branches:
+      - master
     paths:
       - 'usage/workflow_download.py'
-    types: [opened, ]
-      
 jobs:
   close_pr:
     env:

.github/workflows/download_dispatch.yml

@@ -15,19 +15,19 @@ on:
 
       CLIENT_IMPL:
         type: string
-        description: 客户端类型（client.impl），[api]=移动端，[html]=网页端。下载失败时，你可以尝试填入此项重试。
+        description: 客户端类型（client.impl），下载失败时，你可以尝试填入此项重试。'api' 表示移动端，'html' 表示网页端。
         default: ''
         required: false
 
       IMAGE_SUFFIX:
         type: string
-        description: 图片后缀（download.cache.suffix），默认为空，表示不做图片格式转换。可填入例如 "png" "jpg"。
+        description: 图片后缀（download.cache.suffix），默认为空，表示不做图片格式转换。可填入例如 'png' 'jpg'
         default: ''
         required: false
 
       DIR_RULE:
         type: string
-        description: 下载文件夹规则（dir_rule.rule）。此处可以不填，默认使用配置文件的'Bd_Aauthor_Atitle_Pindex'。
+        description: 下载文件夹规则（dir_rule.rule）。默认使用配置文件的 'Bd_Aauthor_Atitle_Pindex'。
         default: ''
         required: false
 

assets/docs/sources/tutorial/5_filter.md

@@ -6,10 +6,10 @@ filter(过滤器)是v2.1.12新引入的机制，
 使用filter的步骤如下：
 
 ```
-1. 自定义class，继承JmDownloader，重写filter_iter_objs方法，即:
+1. 自定义class，继承JmDownloader，重写do_filter方法，即:
    class MyDownloader(JmDownloader):
-       def filter_iter_objs(self, iter_objs: DownloadIterObjs):
-           # 如何重写？参考JmDownloader.filter_iter_objs和下面的示例
+       def do_filter(self, detail):
+           # 如何重写？参考JmDownloader.do_filter和下面的示例
            ...
 
 2. 让你的class生效，使用如下代码：
@@ -30,8 +30,8 @@ from jmcomic import *
 
 class First3ImageDownloader(JmDownloader):
 
-    def filter_iter_objs(self, iter_objs: DownloadIterObjs):
-        if isinstance(iter_objs, JmPhotoDetail):
+    def do_filter(self, detail):
+        if detail.is_photo():
             photo: JmPhotoDetail = iter_objs
             # 支持[start,end,step]
             return photo[:3]
@@ -52,8 +52,8 @@ class FindUpdateDownloader(JmDownloader):
         'xxx': 'yyy'
     }
 
-    def filter_iter_objs(self, iter_objs: DownloadIterObjs):
-        if not isinstance(iter_objs, JmAlbumDetail):
+    def do_filter(self, detail):
+        if not detail.is_album():
             return iter_objs
 
         return self.find_update(iter_objs)

src/jmcomic/__init__.py

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