kmoe-manga-downloader 1.2.3b0__tar.gz → 1.2.4__tar.gz

{kmoe_manga_downloader-1.2.3b0 → kmoe_manga_downloader-1.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kmoe-manga-downloader
-Version: 1.2.3b0
+Version: 1.2.4
 Summary: A CLI-downloader for site @kox.moe.
 Author-email: Chris Zheng <chrisis58@outlook.com>
 License: MIT License
@@ -50,9 +50,26 @@ Dynamic: license-file
 
 `kmdr (Kmoe Manga Downloader)` 是一个 Python 终端应用，用于从 [Kmoe](https://kxx.moe/) 网站下载漫画。它支持在终端环境下的登录、下载指定漫画及其卷，并支持回调脚本执行。
 
-<p align="center">
-  <img src="assets/kmdr-demo.gif" alt="kmdr 使用演示" width="720">
-</p>
+<table style="min-width: 600px;">
+  <tbody>
+    <tr>
+      <td style="text-align: center;" width="100">
+        交互模式
+      </td>
+      <td style="text-align: center;">
+        <img src="assets/kmdr-demo.gif" alt="kmdr 使用演示" />
+      </td>
+    </tr>
+    <tr>
+      <td style="text-align: center;" width="100">
+        日志模式
+      </td>
+      <td style="text-align: center;">
+        <img src="assets/kmdr-log-demo.gif" alt="kmdr 日志使用演示" />
+      </td>
+    </tr>
+  </tbody>
+</table>
 
 ## ✨功能特性
 

{kmoe_manga_downloader-1.2.3b0 → kmoe_manga_downloader-1.2.4}/README.md

@@ -4,9 +4,26 @@
 
 `kmdr (Kmoe Manga Downloader)` 是一个 Python 终端应用，用于从 [Kmoe](https://kxx.moe/) 网站下载漫画。它支持在终端环境下的登录、下载指定漫画及其卷，并支持回调脚本执行。
 
-<p align="center">
-  <img src="assets/kmdr-demo.gif" alt="kmdr 使用演示" width="720">
-</p>
+<table style="min-width: 600px;">
+  <tbody>
+    <tr>
+      <td style="text-align: center;" width="100">
+        交互模式
+      </td>
+      <td style="text-align: center;">
+        <img src="assets/kmdr-demo.gif" alt="kmdr 使用演示" />
+      </td>
+    </tr>
+    <tr>
+      <td style="text-align: center;" width="100">
+        日志模式
+      </td>
+      <td style="text-align: center;">
+        <img src="assets/kmdr-log-demo.gif" alt="kmdr 日志使用演示" />
+      </td>
+    </tr>
+  </tbody>
+</table>
 
 ## ✨功能特性
 

{kmoe_manga_downloader-1.2.3b0 → kmoe_manga_downloader-1.2.4}/src/kmdr/_version.py

@@ -28,7 +28,7 @@ version_tuple: VERSION_TUPLE
 commit_id: COMMIT_ID
 __commit_id__: COMMIT_ID
 
-__version__ = version = '1.2.3b0'
-__version_tuple__ = version_tuple = (1, 2, 3, 'b0')
+__version__ = version = '1.2.4'
+__version_tuple__ = version_tuple = (1, 2, 4)
 
-__commit_id__ = commit_id = 'g28497cb81'
+__commit_id__ = commit_id = 'gb584a1f0c'

{kmoe_manga_downloader-1.2.3b0 → kmoe_manga_downloader-1.2.4}/src/kmdr/core/bases.py

@@ -9,6 +9,7 @@ from .error import LoginError
 from .registry import Registry
 from .structure import VolInfo, BookInfo
 from .utils import construct_callback, async_retry
+from .protocol import AsyncCtxManager
 
 from .context import TerminalContext, SessionContext, UserProfileContext, ConfigContext
 
@@ -26,7 +27,7 @@ class SessionManager(SessionContext, ConfigContext, TerminalContext):
         super().__init__(*args, **kwargs)
 
     @abstractmethod
-    async def session(self) -> ClientSession: ...
+    async def session(self) -> AsyncCtxManager[ClientSession]: ...
 
 class Authenticator(SessionContext, ConfigContext, UserProfileContext, TerminalContext):
 
@@ -44,7 +45,6 @@ class Authenticator(SessionContext, ConfigContext, UserProfileContext, TerminalC
             except LoginError as e:
                 info(f"[yellow]详细信息：{e}[/yellow]")
                 info("[red]认证失败。请检查您的登录凭据或会话 cookie。[/red]")
-                exit(1)
 
     @abstractmethod
     async def _authenticate(self) -> bool: ...
@@ -84,7 +84,7 @@ class Downloader(SessionContext, UserProfileContext, TerminalContext):
     async def download(self, book: BookInfo, volumes: list[VolInfo]):
         if not volumes:
             info("没有可下载的卷。", style="blue")
-            exit(0)
+            return
 
         try:
             with self._progress:
@@ -97,11 +97,10 @@ class Downloader(SessionContext, UserProfileContext, TerminalContext):
                 for exc in exceptions:
                     info(f"[red]- {exc}[/red]")
                     exception(exc)
-                exit(1)
 
-        except KeyboardInterrupt:
-            info("\n操作已取消（KeyboardInterrupt）")
-            exit(130)
+        except asyncio.CancelledError:
+            await asyncio.sleep(0.01)
+            raise
 
     @abstractmethod
     async def _download(self, book: BookInfo, volume: VolInfo): ...

{kmoe_manga_downloader-1.2.3b0 → kmoe_manga_downloader-1.2.4}/src/kmdr/core/console.py

@@ -10,8 +10,6 @@ import io
 from rich.console import Console
 from rich.traceback import Traceback
 
-from kmdr.core.defaults import is_verbose
-
 _console_config = dict[str, Any](
     log_time_format="[%Y-%m-%d %H:%M:%S]",
 )
@@ -24,6 +22,12 @@ except io.UnsupportedOperation:
 
 _console = Console(**_console_config)
 
+_is_verbose = False
+
+def _update_verbose_setting(value: bool):
+    global _is_verbose
+    _is_verbose = value
+
 def info(*args, **kwargs):
     """
     在终端中输出信息
@@ -41,7 +45,7 @@ def debug(*args, **kwargs):
     
     `info` 的条件版本，仅当启用详细模式时才会输出。
     """
-    if is_verbose():
+    if _is_verbose:
         if _console.is_interactive:
             _console.print("[dim]DEBUG:[/]", *args, **kwargs)
         else:
@@ -57,7 +61,7 @@ def log(*args, debug=False, **kwargs):
         # 如果是交互式终端，则不记录日志
         return
 
-    if debug and is_verbose():
+    if debug and _is_verbose:
         # 仅在调试模式和启用详细模式时记录调试日志
         _console.log("DEBUG:", *args, **kwargs, _stack_offset=2)
     else:

{kmoe_manga_downloader-1.2.3b0 → kmoe_manga_downloader-1.2.4}/src/kmdr/core/context.py

@@ -18,7 +18,7 @@ class TerminalContext:
     def _progress(self) -> Progress:
         global _lazy_progress
         if _lazy_progress is None:
-            _lazy_progress = Progress(*progress_definition, console=self._console)
+            _lazy_progress = Progress(*progress_definition, console=self._console, refresh_per_second=4)
         return _lazy_progress
 
 class UserProfileContext:

{kmoe_manga_downloader-1.2.3b0 → kmoe_manga_downloader-1.2.4}/src/kmdr/core/defaults.py

@@ -5,6 +5,7 @@ import json
 from typing import Optional, Any
 import argparse
 from contextvars import ContextVar
+
 from rich.console import Console
 from rich.progress import (
     Progress,
@@ -18,6 +19,7 @@ from rich.progress import (
 from .utils import singleton
 from .structure import Config
 from .constants import BASE_URL
+from .console import _update_verbose_setting
 
 HEADERS = {
     'User-Agent': 'kmdr/1.0 (https://github.com/chrisis58/kmoe-manga-downloader)'
@@ -95,7 +97,6 @@ def parse_args():
 
     if args.command is None:
         parser.print_help()
-        exit(1)
 
     return args
 
@@ -241,11 +242,6 @@ def combine_args(dest: argparse.Namespace) -> argparse.Namespace:
 
 base_url_var = ContextVar('base_url', default=Configurer().base_url)
 
-_verbose = False
-
-def is_verbose() -> bool:
-    return _verbose
-
 def post_init(args) -> None:
-    global _verbose
-    _verbose = getattr(args, 'verbose', False)
+    _verbose = getattr(args, 'verbose', False)
+    _update_verbose_setting(_verbose)

{kmoe_manga_downloader-1.2.3b0 → kmoe_manga_downloader-1.2.4}/src/kmdr/core/error.py

@@ -7,6 +7,9 @@ class KmdrError(RuntimeError):
 
         self._solution = "" if solution is None else "\n[bold cyan]推荐解决方法:[/bold cyan] \n" + "\n".join(f"[cyan]>>> {sol}[/cyan]" for sol in solution)
 
+    def __str__(self):
+        return f"{self.message}\n{self._solution}"
+
 class InitializationError(KmdrError):
     def __init__(self, message, solution: Optional[list[str]] = None):
         super().__init__(message, solution)
@@ -36,6 +39,18 @@ class RedirectError(KmdrError):
     def __str__(self):
         return f"{self.message} 新的地址: {self.new_base_url}"
 
+class ValidationError(KmdrError):
+    def __init__(self, message, field: str):
+        super().__init__(message)
+        self.field = field
+
+    def __str__(self):
+        return f"{self.message} (字段: {self.field})"
+
+class EmptyResultError(KmdrError):
+    def __init__(self, message):
+        super().__init__(message)
+
 class ResponseError(KmdrError):
     def __init__(self, message, status_code: int):
         super().__init__(message)

{kmoe_manga_downloader-1.2.3b0 → kmoe_manga_downloader-1.2.4}/src/kmdr/core/protocol.py

@@ -8,3 +8,7 @@ class Supplier(Protocol[S]):
 
 class Consumer(Protocol[T]):
     def __call__(self, value: T) -> None: ...
+
+class AsyncCtxManager(Protocol[S]):
+    async def __aenter__(self) -> S: ...
+    async def __aexit__(self, exc_type, exc_value, traceback) -> None: ...

{kmoe_manga_downloader-1.2.3b0 → kmoe_manga_downloader-1.2.4}/src/kmdr/core/registry.py

@@ -3,6 +3,7 @@ from dataclasses import dataclass, field
 from argparse import Namespace
 
 from .defaults import combine_args
+from .console import debug
 
 T = TypeVar('T')
 
@@ -76,6 +77,7 @@ class Registry(Generic[T]):
     def get(self, condition: Namespace) -> T:
         if self._combine_args:
             condition = combine_args(condition)
+            debug("合并默认参数后，条件为:", condition)
         return self._get(condition)
     
     def _get(self, condition: Namespace) -> T:

{kmoe_manga_downloader-1.2.3b0 → kmoe_manga_downloader-1.2.4}/src/kmdr/core/session.py

@@ -1,6 +1,9 @@
 from typing import Optional
 from urllib.parse import urlsplit, urljoin
+from typing import Type
+from types import TracebackType
 
+import asyncio
 from aiohttp import ClientSession
 
 from .constants import BASE_URL, API_ROUTE
@@ -10,6 +13,7 @@ from .defaults import HEADERS
 from .error import InitializationError, RedirectError
 from .protocol import Supplier
 from .console import *
+from .protocol import AsyncCtxManager
 
 
 
@@ -38,11 +42,11 @@ class KmdrSessionManager(SessionManager):
             self._sorter.incr(primary_base_url, 10)
         debug("镜像地址优先级排序:", self._sorter)
 
-    async def session(self) -> ClientSession:
+    async def session(self) -> AsyncCtxManager[ClientSession]:
         try:
             if self._session is not None and not self._session.closed:
                 # 幂等性检查：如果 session 已经存在且未关闭，直接返回
-                return self._session
+                return SessionCtxManager(self._session)
         except LookupError:
             # session_var 尚未设置
             pass
@@ -53,6 +57,7 @@ class KmdrSessionManager(SessionManager):
             # 持久化配置
             self._configurer.set_base_url(self._base_url)
             debug("使用的基础 URL:", self._base_url)
+            debug("使用的代理:", self._proxy)
 
             self._session = ClientSession(
                 base_url=self._base_url,
@@ -61,7 +66,7 @@ class KmdrSessionManager(SessionManager):
                 headers=HEADERS,
             )
 
-            return self._session
+            return SessionCtxManager(self._session)
     
     async def validate_url(self, session: ClientSession, url_supplier: Supplier[str]) -> bool:
         try:
@@ -117,3 +122,22 @@ class KmdrSessionManager(SessionManager):
 
             raise InitializationError(f"所有镜像均不可用，请检查您的网络连接或使用其他镜像。\n详情参考：https://github.com/chrisis58/kmoe-manga-downloader/blob/main/mirror/mirrors.json")
 
+class SessionCtxManager:
+    def __init__(self, session: ClientSession):
+        self._session = session
+
+    async def __aenter__(self) -> ClientSession:
+        await self._session.__aenter__()
+        return self._session
+
+    async def __aexit__(
+        self,
+        exc_type: Optional[Type[BaseException]],
+        exc_value: Optional[BaseException],
+        traceback: Optional[TracebackType]
+    ):
+        await self._session.__aexit__(exc_type, exc_value, traceback)
+
+        if exc_type in (KeyboardInterrupt, asyncio.CancelledError):
+            debug("任务被取消，正在清理资源")
+            await asyncio.sleep(0.01)

{kmoe_manga_downloader-1.2.3b0 → kmoe_manga_downloader-1.2.4}/src/kmdr/core/utils.py

@@ -1,6 +1,7 @@
 import functools
 from typing import Optional, Callable, TypeVar, Hashable, Generic
 import asyncio
+from asyncio.proactor_events import _ProactorBasePipeTransport
 
 import aiohttp
 
@@ -9,6 +10,7 @@ import subprocess
 from .structure import BookInfo, VolInfo
 from .error import RedirectError
 from .protocol import Consumer
+from .console import debug
 
 
 def singleton(cls):
@@ -68,7 +70,7 @@ def async_retry(
                 except RedirectError as e:
                     if base_url_setter:
                         base_url_setter(e.new_base_url)
-                        print(f"检测到重定向，已自动更新 base url 为: {e.new_base_url}。立即重试...")
+                        debug("检测到重定向，已自动更新 base url 为", e.new_base_url)
                         continue
                     else:
                         raise
@@ -124,4 +126,24 @@ class PrioritySorter(Generic[H]):
 
     def sort(self) -> list[H]:
         """返回根据优先级排序后的元素列表，优先级高的元素排在前面"""
-        return [k for k, v in sorted(self._items.items(), key=lambda item: item[1], reverse=True)]
+        return [k for k, v in sorted(self._items.items(), key=lambda item: item[1], reverse=True)]
+    
+def _silence_event_loop_closed(func):
+    """
+    用于静默处理 'Event loop is closed' 异常的装饰器。
+    该异常在某些情况下（如 Windows 平台使用 Proactor 事件循环）会在对象销毁时抛出，
+    导致程序输出不必要的错误信息。此装饰器捕获该异常并忽略它。
+    
+    @see https://github.com/aio-libs/aiohttp/issues/4324
+    """
+    @functools.wraps(func)
+    def wrapper(self, *args, **kwargs):
+        try:
+            return func(self, *args, **kwargs)
+        except RuntimeError as e:
+            if str(e) != 'Event loop is closed':
+                raise
+ 
+    return wrapper
+
+_ProactorBasePipeTransport.__del__ = _silence_event_loop_closed(_ProactorBasePipeTransport.__del__)

{kmoe_manga_downloader-1.2.3b0 → kmoe_manga_downloader-1.2.4}/src/kmdr/main.py

@@ -1,16 +1,15 @@
-from kmdr import __version__
-
 from typing import Callable
 from argparse import Namespace
 import asyncio
 
+from kmdr import __version__
 from kmdr.core import *
 from kmdr.module import *
 
 async def main(args: Namespace, fallback: Callable[[], None] = lambda: print('NOT IMPLEMENTED!')) -> None:
 
     post_init(args)
-    log('[Lifecycle:Start] 启动 kmdr 版本:', __version__)
+    log('[Lifecycle:Start] 启动 kmdr, 版本', __version__)
     debug('[bold green]以调试模式启动[/bold green]')
     debug('接收到的参数:', args)
 
@@ -51,17 +50,14 @@ def entry_point():
         parser = argument_parser()
         args = parser.parse_args()
 
-        main_coro = main(args, lambda: parser.print_help())
+        main_coro = main(args, parser.print_help)
         asyncio.run(main_coro)
     except KmdrError as e:
         info(f"[red]错误: {e}[/red]")
-        exit(1)
     except KeyboardInterrupt:
         info("\n操作已取消（KeyboardInterrupt）", style="yellow")
-        exit(130)
     except Exception as e:
         exception(e)
-        exit(1)
     finally:
         log('[Lifecycle:End] 运行结束，kmdr 已退出')
     

{kmoe_manga_downloader-1.2.3b0 → kmoe_manga_downloader-1.2.4}/src/kmdr/module/authenticator/utils.py

@@ -77,7 +77,10 @@ def extract_var_define(script_text) -> dict[str, str]:
         line = line.strip()
         if line.startswith("var ") and "=" in line:
             var_name, var_value = line[4:].split("=", 1)
-            var_define[var_name.strip()] = var_value.strip().strip(";").strip('"')
+            var_value = var_value.strip().strip(";").strip('"')
+            if var_name and var_value:
+                var_define[var_name.strip()] = var_value
+    debug("解析到变量定义: ", var_define)
     return var_define
 
 def __resolve_quota_id(is_vip: Optional[int] = None, user_level: Optional[int] = None):

{kmoe_manga_downloader-1.2.3b0 → kmoe_manga_downloader-1.2.4}/src/kmdr/module/configurer/BaseUrlUpdator.py

@@ -12,6 +12,6 @@ class BaseUrlUpdator(Configurer):
             self._configurer.set_base_url(self._base_url)
         except KeyError as e:
             info(f"[red]{e.args[0]}[/red]")
-            exit(1)
+            return
 
         info(f"已设置基础 URL: {self._base_url}")

{kmoe_manga_downloader-1.2.3b0 → kmoe_manga_downloader-1.2.4}/src/kmdr/module/configurer/ConfigClearer.py

@@ -12,6 +12,6 @@ class ConfigClearer(Configurer):
             self._configurer.clear(self._clear)
         except KeyError as e:
             info(f"[red]{e.args[0]}[/red]")
-            exit(1)
+            return
 
-        info(f"Cleared configuration: {self._clear}")
+        info(f"[green]已清除: {self._clear}[/green]")

{kmoe_manga_downloader-1.2.3b0 → kmoe_manga_downloader-1.2.4}/src/kmdr/module/configurer/OptionLister.py

@@ -26,7 +26,7 @@ class OptionLister(Configurer):
 
         if self._configurer.option is not None:
             for idx, (key, value) in enumerate(self._configurer.option.items()):
-                value_to_display = value
+                value_to_display = str(value)
                 if isinstance(value, (dict, list, set, tuple)):
                     value_to_display = Pretty(value)
 

{kmoe_manga_downloader-1.2.3b0 → kmoe_manga_downloader-1.2.4}/src/kmdr/module/configurer/option_validate.py

@@ -3,6 +3,7 @@ from functools import wraps
 import os
 
 from kmdr.core.console import info
+from kmdr.core.error import ValidationError
 
 __OPTIONS_VALIDATOR = {}
 
@@ -20,18 +21,19 @@ def validate(key: str, value: str) -> Optional[object]:
         info(f"[red]不支持的配置项: {key}。可用配置项：{', '.join(__OPTIONS_VALIDATOR.keys())}[/red]")
         return None
 
-def check_key(key: str, exit_if_invalid: bool = True) -> None:
+def check_key(key: str, raise_if_invalid: bool = True) -> None:
     """
     供外部调用的验证函数，用于检查配置项的键名是否有效。
     如果键名无效，函数会打印错误信息并退出程序。
 
     :param key: 配置项的键名
-    :param exit_if_invalid: 如果键名无效，是否退出程序
+    :param raise_if_invalid: 如果键名无效，是否抛出异常
     """
     if key not in __OPTIONS_VALIDATOR:
-        info(f"[red]未知配置项: {key}。可用配置项：{', '.join(__OPTIONS_VALIDATOR.keys())}[/red]")
-        if exit_if_invalid:
-            exit(1)
+        if raise_if_invalid:
+            raise ValidationError(f"未知配置项: {key}。可用配置项：{', '.join(__OPTIONS_VALIDATOR.keys())}", field=key)
+        else:
+            info(f"[red]未知配置项: {key}。可用配置项：{', '.join(__OPTIONS_VALIDATOR.keys())}[/red]")
 
 def register_validator(arg_name):
     """

{kmoe_manga_downloader-1.2.3b0 → kmoe_manga_downloader-1.2.4}/src/kmdr/module/downloader/download_utils.py

@@ -13,12 +13,26 @@ from rich.progress import Progress
 from aiohttp.client_exceptions import ClientPayloadError
 
 from kmdr.core.console import info, log, debug
+from kmdr.core.error import ResponseError
+from kmdr.core.utils import async_retry
 
 from .misc import STATUS, StateManager
 
 BLOCK_SIZE_REDUCTION_FACTOR = 0.75
 MIN_BLOCK_SIZE = 2048
 
+_HEAD_SEMAPHORE_VALUE = 3
+_HEAD_SEMAPHORE: Optional[asyncio.Semaphore] = None
+"""定义的用于 HEAD 请求的信号量，限制并发数量以避免触发服务器限流。"""
+
+def _get_head_request_semaphore() -> asyncio.Semaphore:
+    """惰性初始化 HEAD 请求信号量。"""
+    global _HEAD_SEMAPHORE
+    
+    if _HEAD_SEMAPHORE is None:
+        _HEAD_SEMAPHORE = asyncio.Semaphore(_HEAD_SEMAPHORE_VALUE)
+    return _HEAD_SEMAPHORE
+
 
 @deprecated("本函数可能不会积极维护，请改用 'download_file_multipart'")
 async def download_file(
@@ -161,8 +175,7 @@ async def download_file_multipart(
         info(f"[blue]{filename} 已经存在[/blue]")
         return
 
-    log(f"开始下载文件: {filename} 到路径: {dest_path}")
-
+    log("开始下载文件:", filename)
     part_paths = []
     part_expected_sizes = []
     task_id = None
@@ -171,12 +184,10 @@ async def download_file_multipart(
     try:
         current_url = await fetch_url(url)
 
-        async with session.head(current_url, headers=headers, allow_redirects=True) as response:
-            # 注意：这个请求完成后，服务器就会记录这次下载，并消耗对应的流量配额，详细的规则请参考网站说明：
-            #   注 1 : 訂閱連載中的漫畫，有更新時自動推送的卷(冊)，暫不計算在使用額度中，不扣減使用額度。
-            #   注 2 : 對同一卷(冊)書在 12 小時內重複*下載*，不會重複扣減額度。但重復推送是會扣減的。
-            response.raise_for_status()
-            total_size = int(response.headers['Content-Length'])
+        async with _get_head_request_semaphore():
+            # 获取文件信息，请求以获取文件大小
+            # 控制并发，避免过多并发请求触发服务器限流
+            total_size = await _fetch_content_length(session, current_url, headers=headers)
 
         chunk_size = chunk_size_mb * 1024 * 1024
         num_chunks = math.ceil(total_size / chunk_size)
@@ -236,6 +247,36 @@ async def download_file_multipart(
             if task_id is not None and state_manager is not None:
                 await state_manager.request_status_update(part_id=StateManager.PARENT_ID, status=STATUS.FAILED)
 
+@async_retry()
+async def _fetch_content_length(
+        session: aiohttp.ClientSession,
+        url: str,
+        headers: Optional[dict] = None,
+) -> int:
+    """
+    获取文件的内容长度（字节数）
+
+    :note: 这个请求完成后，服务器就会记录这次下载，并消耗对应的流量配额，详细的规则请参考网站说明：
+    - 注 1 : 訂閱連載中的漫畫，有更新時自動推送的卷(冊)，暫不計算在使用額度中，不扣減使用額度。
+    - 注 2 : 對同一卷(冊)書在 12 小時內重複*下載*，不會重複扣減額度。但重復推送是會扣減的。
+
+    :param session: aiohttp.ClientSession 对象
+    :param url: 文件 URL
+    :param headers: 请求头
+    :return: 文件大小（字节数）
+    """
+    if headers is None:
+        headers = {}
+    
+    async with session.head(url, headers=headers, allow_redirects=True) as response:
+        # 注意：这个请求完成后，服务器就会记录这次下载，并消耗对应的流量配额，详细的规则请参考网站说明：
+        #   注 1 : 訂閱連載中的漫畫，有更新時自動推送的卷(冊)，暫不計算在使用額度中，不扣減使用額度。
+        #   注 2 : 對同一卷(冊)書在 12 小時內重複*下載*，不會重複扣減額度。但重復推送是會扣減的。
+        response.raise_for_status()
+        if 'Content-Length' not in response.headers:
+            raise ResponseError("无法从服务器获取文件大小，请检查网络连接或稍后重试。", status_code=response.status)
+        return int(response.headers['Content-Length'])
+
 async def _download_part(
         session: aiohttp.ClientSession,
         semaphore: asyncio.Semaphore,
@@ -278,6 +319,7 @@ async def _download_part(
                             if chunk:
                                 await f.write(chunk)
                                 state_manager.advance(len(chunk))
+                await state_manager.pop_part(part_id=start)
                 log("分片", os.path.basename(part_path), "下载完成。")
             return
     
@@ -289,8 +331,8 @@ async def _download_part(
         except Exception as e:
             if attempts_left > 0:
                 debug("分片", os.path.basename(part_path), "下载出错:", e, "，正在重试... 剩余重试次数:", attempts_left)
-                await asyncio.sleep(3)
                 await state_manager.request_status_update(part_id=start, status=STATUS.WAITING)
+                await asyncio.sleep(3)
             else:
                 # console.print(f"[red]分片 {os.path.basename(part_path)} 下载失败: {e}[/red]")
                 debug("分片", os.path.basename(part_path), "下载失败:", e)

{kmoe_manga_downloader-1.2.3b0 → kmoe_manga_downloader-1.2.4}/src/kmdr/module/downloader/misc.py

@@ -3,6 +3,8 @@ import asyncio
 
 from rich.progress import Progress, TaskID
 
+from kmdr.core.console import debug
+
 
 class STATUS(Enum):
     WAITING='[blue]等待中[/blue]'
@@ -53,12 +55,24 @@ class StateManager:
         if not self._part_states:
             return
         
+        debug("当前状态:", self._part_states)
         highest_status = max(self._part_states.values())
         if highest_status != self._current_status:
             self._current_status = highest_status
-            self._progress.update(self._task_id, status=highest_status.value, refresh=True)
+            self._progress.update(self._task_id, status=highest_status.value)
+
+    async def pop_part(self, part_id: int):
+        """
+        下载完成后移除分片状态记录，不再参与状态计算
+        
+        :note: 为避免状态闪烁，调用后不会更新状态
+        """
+        async with self._lock:
+            if part_id in self._part_states:
+                self._part_states.pop(part_id)
 
     async def request_status_update(self, part_id: int, status: STATUS):
         async with self._lock:
+            debug("分片", part_id, "请求状态更新为", status)
             self._part_states[part_id] = status
             self._update_status()

{kmoe_manga_downloader-1.2.3b0 → kmoe_manga_downloader-1.2.4}/src/kmdr/module/lister/FollowedBookLister.py

@@ -8,6 +8,7 @@ from kmdr.core import Lister, LISTERS, BookInfo, VolInfo
 from kmdr.core.utils import async_retry
 from kmdr.core.constants import API_ROUTE
 from kmdr.core.console import info
+from kmdr.core.error import EmptyResultError
 
 from .utils import extract_book_info_and_volumes
 
@@ -24,8 +25,7 @@ class FollowedBookLister(Lister):
             books = await self._list_followed_books()
         
         if not books:
-            info("[yellow]关注列表为空。[/yellow]")
-            exit(0)
+            raise EmptyResultError("关注列表为空。")
 
         table = Table(title="关注的书籍列表", show_header=True, header_style="bold blue")
         table.add_column("序号", style="dim", width=4, justify="center")

{kmoe_manga_downloader-1.2.3b0 → kmoe_manga_downloader-1.2.4}/src/kmdr/module/lister/utils.py

@@ -8,6 +8,7 @@ from aiohttp import ClientSession as Session
 from kmdr.core import BookInfo, VolInfo, VolumeType
 from kmdr.core.utils import async_retry
 from kmdr.core.console import debug
+from kmdr.core.error import KmdrError
 
 @async_retry()
 async def extract_book_info_and_volumes(session: Session, url: str, book_info: Optional[BookInfo] = None) -> tuple[BookInfo, list[VolInfo]]:
@@ -41,6 +42,12 @@ async def extract_book_info_and_volumes(session: Session, url: str, book_info: O
 def __extract_book_info(url: str, book_page: BeautifulSoup, book_info: Optional[BookInfo]) -> BookInfo:
     book_name = book_page.find('font', class_='text_bglight_big').text
 
+    if '為符合要求，此書內容已屏蔽' in book_name:
+        raise KmdrError(
+            "[yellow]该书籍内容已被屏蔽，请检查代理配置。[/yellow]", 
+            solution=["kmdr config -s proxy=<your_proxy>  # 设置可用的代理地址"]
+        )
+
     id = book_page.find('input', attrs={'name': 'bookid'})['value']
 
     return BookInfo(

{kmoe_manga_downloader-1.2.3b0 → kmoe_manga_downloader-1.2.4}/src/kmoe_manga_downloader.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kmoe-manga-downloader
-Version: 1.2.3b0
+Version: 1.2.4
 Summary: A CLI-downloader for site @kox.moe.
 Author-email: Chris Zheng <chrisis58@outlook.com>
 License: MIT License
@@ -50,9 +50,26 @@ Dynamic: license-file
 
 `kmdr (Kmoe Manga Downloader)` 是一个 Python 终端应用，用于从 [Kmoe](https://kxx.moe/) 网站下载漫画。它支持在终端环境下的登录、下载指定漫画及其卷，并支持回调脚本执行。
 
-<p align="center">
-  <img src="assets/kmdr-demo.gif" alt="kmdr 使用演示" width="720">
-</p>
+<table style="min-width: 600px;">
+  <tbody>
+    <tr>
+      <td style="text-align: center;" width="100">
+        交互模式
+      </td>
+      <td style="text-align: center;">
+        <img src="assets/kmdr-demo.gif" alt="kmdr 使用演示" />
+      </td>
+    </tr>
+    <tr>
+      <td style="text-align: center;" width="100">
+        日志模式
+      </td>
+      <td style="text-align: center;">
+        <img src="assets/kmdr-log-demo.gif" alt="kmdr 日志使用演示" />
+      </td>
+    </tr>
+  </tbody>
+</table>
 
 ## ✨功能特性
 

{kmoe_manga_downloader-1.2.3b0 → kmoe_manga_downloader-1.2.4}/src/kmoe_manga_downloader.egg-info/SOURCES.txt

@@ -5,6 +5,7 @@ pyproject.toml
 .github/workflows/release-package.yml
 .github/workflows/unit-test.yml
 assets/kmdr-demo.gif
+assets/kmdr-log-demo.gif
 mirror/mirrors.json
 src/kmdr/__init__.py
 src/kmdr/_version.py

{kmoe_manga_downloader-1.2.3b0 → kmoe_manga_downloader-1.2.4}/tests/test_kmdr_download.py

@@ -175,7 +175,7 @@ class TestKmdrDownload(unittest.TestCase):
 
         assert len(files := os.listdir(dest)) == 2, "Expected one subdirectory and one callback log file in the destination"
         assert 'callback.log' in files, "Expected callback log file to be present"
-        with open(os.path.join(dest, 'callback.log'), 'r', encoding='utf-8') as f:
+        with open(os.path.join(dest, 'callback.log'), 'r') as f:
             log_content = f.read()
             assert "CALLBACK:" in log_content, "Expected callback log to contain the correct message"
         files.remove('callback.log')