fix: 解决 PR#533 的 review 问题

修复内容：
1. [文档修正] 修正 13_export_and_feature.md 中的失效锚点链接
2. [文档完善] 补全 README.md 中的教程支持范围描述（增加长图）
3. [核心修复] 修复批量下载时没有透传 extra 参数导致 Feature 无法执行的严重 Bug
4. [性能优化] 改用 ctypes 启用 Windows ANSI 控制台支持，移除低效且不安全的 os.system 进程调用
5. [错误捕获] 提前在 jm_downloader.py 的 add_features 方法中对 extra 进行类型校验
6. [认知升级] 更新代码中的 docstring，强化 Feature 作为“基于生命周期和调用来源的动态自适应机制”的定位

未修改内容及原因：
1. jm_feature.py 链式调用丢失 _user_keys 问题
   - 经与开发者确认，暂时先不修改此逻辑。

Author: hect0x7

README.md

@@ -30,7 +30,7 @@
 > **🧭 快速指路**
 > - [教程：使用 GitHub Actions 下载禁漫本子](./assets/docs/sources/tutorial/1_github_actions.md)
 > - [教程：导出并下载你的禁漫收藏夹数据](./assets/docs/sources/tutorial/10_export_favorites.md)
-> - [教程：下载后转为 PDF / ZIP](./assets/docs/sources/tutorial/13_export_and_feature.md)
+> - [教程：下载后转为 PDF / ZIP / 长图](./assets/docs/sources/tutorial/13_export_and_feature.md)
 > - [塔台广播：欢迎各位机长加入并贡献代码](./.github/CONTRIBUTING.md)
 > 
 > **友情提示：珍爱JM，为了减轻JM的服务器压力，请不要一次性爬取太多本子，西门🙏🙏🙏**.

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

@@ -85,7 +85,7 @@ download_photo('456', option, extra=Feature.export_pdf)
 ├── [章节标题].pdf       ← 该章节导出为 1 个 PDF
 ```
 
-> 💡 **提示**：同一个 Feature，通过 `download_album` 和 `download_photo` 调用时会自动适配不同的导出行为，详见下方 [智能适配规则](#智能适配规则)。
+> 💡 **提示**：同一个 Feature，通过 `download_album` 和 `download_photo` 调用时会自动适配不同的导出行为，详见下方 [智能适配规则](#25-智能适配规则)。
 
 ### 2.5 智能适配规则
 

src/jmcomic/api.py

@@ -7,6 +7,7 @@ def download_batch(download_api,
                    jm_id_iter: Union[Iterable, Generator],
                    option=None,
                    downloader=None,
+                   **kwargs,
                    ) -> Set[__DOWNLOAD_API_RET]:
     """
     批量下载 album / photo
@@ -37,6 +38,7 @@ def callback(*ret):
                                                      option,
                                                      downloader,
                                                      callback=callback,
+                                                     **kwargs,
                                                      ),
         wait_finish=True
     )
@@ -61,12 +63,12 @@ def download_album(jm_album_id,
     :param downloader: 下载器类
     :param callback: 返回值回调函数，可以拿到 album 和 downloader
     :param check_exception: 是否检查异常, 如果为True，会检查downloader是否有下载异常，并上抛PartialDownloadFailedException
-    :param extra: 下载特性（Feature），下载完成后自动执行对应插件。支持单个 Feature、FeatureChain、或列表
+    :param extra: 下载特性（Feature），下载时动态挂载的附加行为上下文。会自动根据上下文（如 album/photo 来源）自适应参数行为。支持单个 Feature、FeatureChain、或列表
     :return: 对于的本子实体类，下载器（如果是上述的批量情况，返回值为download_batch的返回值）
     """
 
     if not isinstance(jm_album_id, (str, int)):
-        return download_batch(download_album, jm_album_id, option, downloader)
+        return download_batch(download_album, jm_album_id, option, downloader, extra=extra)
 
     with new_downloader(option, downloader) as dler:
         # 注册 Feature 及来源，由 downloader 在 after_album 钩子中自动执行
@@ -91,7 +93,7 @@ def download_photo(jm_photo_id,
     下载一个章节（photo），参数同 download_album
     """
     if not isinstance(jm_photo_id, (str, int)):
-        return download_batch(download_photo, jm_photo_id, option, downloader)
+        return download_batch(download_photo, jm_photo_id, option, downloader, extra=extra)
 
     with new_downloader(option, downloader) as dler:
         # 注册 Feature 及来源，由 downloader 在 after_photo 钩子中自动执行

src/jmcomic/jm_config.py

@@ -595,7 +595,12 @@ def enable_pretty_log():
 
     # Windows 需要启用 VT100 ANSI 支持
     if sys.platform == 'win32':
-        _os.system('')
+        import ctypes
+        kernel32 = ctypes.windll.kernel32
+        handle = kernel32.GetStdHandle(-11)  # STD_OUTPUT_HANDLE
+        mode = ctypes.c_uint32()
+        if kernel32.GetConsoleMode(handle, ctypes.byref(mode)):
+            kernel32.SetConsoleMode(handle, mode.value | 0x0004)  # ENABLE_VIRTUAL_TERMINAL_PROCESSING
 
     jm_logger.handlers.clear()
     handler = logging.StreamHandler(sys.stdout)

src/jmcomic/jm_downloader.py

@@ -285,16 +285,19 @@ def add_features(self, features, feature_from: str):
         if features is None:
             return
 
-        from .jm_feature import FeatureChain
+        from .jm_feature import FeatureChain, Feature
+        from .jm_toolkit import ExceptionTool
 
         if isinstance(features, list):
             for f in features:
                 self.add_features(f, feature_from)
         elif isinstance(features, FeatureChain):
             for f in features._features:
                 self._feature_list.append((f, feature_from))
-        else:
+        elif isinstance(features, Feature):
             self._feature_list.append((features, feature_from))
+        else:
+            ExceptionTool.raises(f'不支持的 extra 类型: {type(features)}，请传入 Feature / FeatureChain / list / None')
 
     def _invoke_features_for(self, when: str, **context):
         """

src/jmcomic/jm_feature.py

@@ -1,8 +1,9 @@
 """
 该文件存放的是 Feature（下载特性）机制
 
-Feature 用于在 download_album / download_photo 时附加额外行为，
-例如下载完成后自动导出为 PDF、ZIP 等格式。
+Feature 用于在下载生命周期中挂载上下文相关的动态附加行为，
+例如下载完成后自适应导出为 PDF、ZIP 或长图等。
+它不仅是插件的封装，更能根据调用来源（整本/单章）智能调整执行策略。
 
 用法:
     from jmcomic import download_album, Feature