feat: 完善 Feature 机制及插件健壮性优化

1. [核心] 在 JmDownloader 中实现 Feature 异常隔离与详细日志记录，确保单个 Feature 失败不影响下载流程。
2. [优化] 优化 PluginFeature：使用 type(self) 确保子类化安全，使用 dict(kwargs) 避免可变参数污染。
3. [测试] 补全 download_batch 对 extra 参数的传播测试，并新增 Album 模式下使用 Photo 规则的负面测试。
4. [文档] 修正教程文档中的 filename_rule 示例及相关错误，精简代码注释。
5. [其他] 开启 workflow 下载配置的美观打印日志。

Author: hect0x7

assets/docs/sources/tutorial/13_export_and_feature.md

@@ -75,10 +75,15 @@ download_album('123', option, extra=Feature.export_pdf | Feature.export_zip)
 download_album('123', option, extra=Feature.export_pdf(
     # 下面是自定义参数
     pdf_dir='D:/my_pdfs',          # PDF 保存到 D:/my_pdfs 文件夹
-    filename_rule='Ptitle',        # 用章节标题作为文件名
+    filename_rule='Atitle',        # 用本子标题作为文件名
     delete_original_file=True,     # 合并完 PDF 后删除原图
 ))
 
+> 💡 **小白必读：命名规则（filename_rule）的小知识**
+> - `A` 开头的占位符（如 `Atitle`, `Aid`）代表 **Album (本子)**，适用于 `download_album`。
+> - `P` 开头的占位符（如 `Ptitle`, `Pid`）代表 **Photo (章节)**，适用于 `download_photo`。
+> - 如果在下载整本（Album）时强行使用章节级（Photo）的规则，程序会因为不知道该用哪一章的标题而报错。
+
 # 示例 2：全都要——ZIP 存盘 + 长图阅读
 combo = (
     Feature.export_zip(zip_dir='D:/zips')

assets/option/option_workflow_download.yml

@@ -1,4 +1,6 @@
 # GitHub Actions 下载脚本配置
+log: pretty
+
 dir_rule:
   base_dir: ${JM_DOWNLOAD_DIR}
   rule: Bd_Aauthor_Atitle_Pindex

src/jmcomic/jm_downloader.py

@@ -308,7 +308,10 @@ def _invoke_features_for(self, when: str, **kwargs):
         """
         for feature, feature_from in self._feature_list:
             if feature.should_invoke(feature_from, when):
-                feature.invoke(self.option, feature_from=feature_from, when=when, **kwargs)
+                try:
+                    feature.invoke(self.option, feature_from=feature_from, when=when, **kwargs)
+                except BaseException as e:
+                    jm_log('downloader.feature.exception', f'Feature执行失败: [{feature}], 来源: [{feature_from}], 异常: [{e}]')
 
     def raise_if_has_exception(self):
         if not self.has_download_failures:

src/jmcomic/jm_feature.py

@@ -78,7 +78,7 @@ class PluginFeature(Feature):
 
     def __init__(self, plugin_key, **kwargs):
         self.plugin_key = plugin_key
-        self.kwargs = kwargs
+        self.kwargs = dict(kwargs)
 
     def should_invoke(self, feature_from: str, when: str) -> bool:
         """
@@ -95,7 +95,7 @@ def __call__(self, **kwargs):
         """带自定义参数，返回新实例（继承默认参数）"""
         new_kwargs = self.kwargs.copy()
         new_kwargs.update(kwargs)
-        new_instance = PluginFeature(self.plugin_key, **new_kwargs)
+        new_instance = type(self)(self.plugin_key, **new_kwargs)
         return new_instance
 
     def invoke(self, option: JmOption, feature_from: str, when: str, **extra):
@@ -158,9 +158,7 @@ def __repr__(self):
         return f'FeatureChain({self._features})'
 
 
-# 预定义特性（用插件类的 plugin_key 引用，附带默认参数）
-# filename_rule 会根据 feature_from 在 invoke 时动态适配 A/P 前缀
-# zip 的打包粒度由插件根据上下文（album/photo）自动推导，无需 level 参数
+# 内置的 PluginFeature
 Feature.export_pdf = PluginFeature(Img2pdfPlugin.plugin_key, pdf_dir='./')
 Feature.export_zip = PluginFeature(ZipPlugin.plugin_key, zip_dir='./')
 Feature.export_long_img = PluginFeature(LongImgPlugin.plugin_key, img_dir='./')

tests/test_jmcomic/test_jm_feature.py

@@ -110,6 +110,11 @@ def invoke(self, option, **kwargs):
         jmcomic.download_photo(photo_id, self.option, extra=counter_feature)
         self.assertEqual(custom_feature_call_count, 3)
 
+        # 测试 download_batch (Iterable 批量输入): 确保 extra 参数不被丢弃
+        jmcomic.download_batch(jmcomic.download_album, [album_id], self.option, extra=counter_feature)
+        # 上面增加了 1 个 album (包含 1 个 photo)，因此 invoke 追加 2 次，总计 5 次
+        self.assertEqual(custom_feature_call_count, 5)
+
     def test_export_features(self):
         album_id = '438516'
 
@@ -156,3 +161,18 @@ def test_export_features_photo(self):
         import os
         pdf_path = os.path.join(export_dir, pdf_name)
         self.assertTrue(os.path.exists(pdf_path), f"未生成精确匹配的 PDF 文件 (章节级): {pdf_path}")
+
+    def test_export_album_use_photo_rule(self):
+        """
+        负面测试：在 Album 模式下强行使用 Photo 级规则（Ptitle），预期报错。
+        本子=album，本子的章节=photo。下载本子时，photo对象为None。
+        """
+        album_id = '438516'
+        # 强行使用 Ptitle
+        f = Feature.export_pdf(filename_rule='Ptitle')
+
+        # 验证底层 invoke 会抛出 AttributeError
+        # 因为在 download_album 的 after_album 阶段，photo 为 None
+        with self.assertRaises(AttributeError):
+            album = self.client.get_album_detail(album_id)
+            f.invoke(self.option, feature_from='download_album', when='after_album', album=album, photo=None)