kmoe-manga-downloader 1.2.0__py3-none-any.whl → 1.2.2__py3-none-any.whl

kmdr/module/authenticator/utils.py

@@ -3,11 +3,11 @@ from typing import Optional, Callable
 from aiohttp import ClientSession
 from rich.console import Console
 
+from yarl import URL
+
 from kmdr.core.error import LoginError
 from kmdr.core.utils import async_retry
-
-PROFILE_URL = 'https://kox.moe/my.php'
-LOGIN_URL = 'https://kox.moe/login.php'
+from kmdr.core.constants import API_ROUTE
 
 NICKNAME_ID = 'div_nickname_display'
 
@@ -23,7 +23,7 @@ async def check_status(
         is_vip_setter: Optional[Callable[[int], None]] = None,
         level_setter: Optional[Callable[[int], None]] = None,
 ) -> bool:
-    async with session.get(url = PROFILE_URL) as response:
+    async with session.get(url = API_ROUTE.PROFILE) as response:
         try:
             response.raise_for_status()
         except Exception as e:
@@ -31,7 +31,7 @@ async def check_status(
             return False
         
         if response.history and any(resp.status in (301, 302, 307) for resp in response.history) \
-                and str(response.url) == LOGIN_URL:
+                and URL(response.url).path == API_ROUTE.LOGIN:
             raise LoginError("凭证已失效，请重新登录。", ['kmdr config -c cookie', 'kmdr login -u <username>'])
 
         if not is_vip_setter and not level_setter and not show_quota:

kmdr/module/configurer/BaseUrlUpdator.py

@@ -0,0 +1,16 @@
+from kmdr.core import Configurer, CONFIGURER
+
+@CONFIGURER.register()
+class BaseUrlUpdator(Configurer):
+    def __init__(self, base_url: str, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+        self._base_url = base_url
+
+    def operate(self) -> None:
+        try:
+            self._configurer.set_base_url(self._base_url)
+        except KeyError as e:
+            self._console.print(e.args[0])
+            exit(1)
+
+        self._console.print(f"已设置基础 URL: {self._base_url}")

kmdr/module/configurer/OptionLister.py

@@ -13,21 +13,26 @@ class OptionLister(Configurer):
         super().__init__(*args, **kwargs)
 
     def operate(self) -> None:
-        if self._configurer.option is None:
+        if self._configurer.option is None and self._configurer.base_url is None:
             self._console.print("[blue]当前没有任何配置项。[/blue]")
             return
 
         table = Table(title="[green]当前 Kmdr 配置项[/green]", show_header=False, header_style="blue")
 
+        table.add_column("配置类型 (Type)", style="magenta", no_wrap=True, min_width=10)
         table.add_column("配置项 (Key)", style="cyan", no_wrap=True, min_width=10)
-        table.add_column("值 (Value)", style="white", no_wrap=False, min_width=20)
-
-        for key, value in self._configurer.option.items():
-            value_to_display = value
-            if isinstance(value, (dict, list, set, tuple)):
-                value_to_display = Pretty(value)
-            
-            table.add_row(key, value_to_display)
-            table.add_section()
-        
+        table.add_column("值 (Value)", no_wrap=False, min_width=20)
+
+        if self._configurer.option is not None:
+            for idx, (key, value) in enumerate(self._configurer.option.items()):
+                value_to_display = value
+                if isinstance(value, (dict, list, set, tuple)):
+                    value_to_display = Pretty(value)
+
+                table.add_row('下载配置' if idx == 0 else '', key, value_to_display)
+                table.add_section()
+
+        if self._configurer.base_url is not None:
+            table.add_row('应用配置', '镜像地址', self._configurer.base_url or '未设置')
+
         self._console.print(table)

kmdr/module/configurer/__init__.py

@@ -0,0 +1,5 @@
+from .BaseUrlUpdator import BaseUrlUpdator
+from .ConfigClearer import ConfigClearer
+from .OptionLister import OptionLister
+from .OptionSetter import OptionSetter
+from .ConfigUnsetter import ConfigUnsetter

kmdr/module/downloader/DirectDownloader.py

@@ -1,6 +1,9 @@
+from functools import partial
+
 from kmdr.core import Downloader, BookInfo, VolInfo, DOWNLOADER
+from kmdr.core.constants import API_ROUTE
 
-from .utils import download_file, safe_filename, download_file_multipart
+from .download_utils import download_file_multipart, readable_safe_filename
 
 @DOWNLOADER.register(
     hasvalues={
@@ -12,19 +15,23 @@ class DirectDownloader(Downloader):
         super().__init__(dest, callback, retry, num_workers, proxy, *args, **kwargs)
 
     async def _download(self, book: BookInfo, volume: VolInfo):
-        sub_dir = safe_filename(book.name)
+        sub_dir = readable_safe_filename(book.name)
         download_path = f'{self._dest}/{sub_dir}'
 
         await download_file_multipart(
             self._session,
             self._semaphore,
             self._progress,
-            lambda: self.construct_download_url(book, volume),
+            partial(self.construct_download_url, book, volume),
             download_path,
-            safe_filename(f'[Kmoe][{book.name}][{volume.name}].epub'),
+            readable_safe_filename(f'[Kmoe][{book.name}][{volume.name}].epub'),
             self._retry,
             callback=lambda: self._callback(book, volume) if self._callback else None
         )
 
     def construct_download_url(self, book: BookInfo, volume: VolInfo) -> str:
-        return f'https://kox.moe/dl/{book.id}/{volume.id}/1/2/{self._profile.is_vip}/'
+        return API_ROUTE.DOWNLOAD.format(
+            book_id=book.id,
+            volume_id=volume.id,
+            is_vip=self._profile.is_vip
+        )

kmdr/module/downloader/ReferViaDownloader.py

@@ -4,8 +4,10 @@ import json
 from async_lru import alru_cache
 
 from kmdr.core import Downloader, VolInfo, DOWNLOADER, BookInfo
+from kmdr.core.constants import API_ROUTE
+from kmdr.core.error import ResponseError
 
-from .utils import download_file, safe_filename, download_file_multipart
+from .download_utils import download_file_multipart, readable_safe_filename
 
 
 @DOWNLOADER.register(order=10)
@@ -15,7 +17,7 @@ class ReferViaDownloader(Downloader):
 
 
     async def _download(self, book: BookInfo, volume: VolInfo):
-        sub_dir = safe_filename(book.name)
+        sub_dir = readable_safe_filename(book.name)
         download_path = f'{self._dest}/{sub_dir}'
 
         await download_file_multipart(
@@ -24,7 +26,7 @@ class ReferViaDownloader(Downloader):
             self._progress,
             partial(self.fetch_download_url, book.id, volume.id),
             download_path,
-            safe_filename(f'[Kmoe][{book.name}][{volume.name}].epub'),
+            readable_safe_filename(f'[Kmoe][{book.name}][{volume.name}].epub'),
             self._retry,
             headers={
                 "X-Km-From": "kb_http_down"
@@ -35,13 +37,17 @@ class ReferViaDownloader(Downloader):
     @alru_cache(maxsize=128)
     async def fetch_download_url(self, book_id: str, volume_id: str) -> str:
 
-        url = f"https://kox.moe/getdownurl.php?b={book_id}&v={volume_id}&mobi=2&vip={self._profile.is_vip}&json=1"
-
-        async with self._session.get(url) as response:
+        async with self._session.get(
+            API_ROUTE.GETDOWNURL.format(
+                book_id=book_id,
+                volume_id=volume_id,
+                is_vip=self._profile.is_vip
+            )
+        ) as response:
             response.raise_for_status()
             data = await response.text()
             data = json.loads(data)
-            if data.get('code') != 200:
-                raise Exception(f"Failed to fetch download URL: {data.get('msg', 'Unknown error')}")
-            
+            if (code := data.get('code')) != 200:
+                raise ResponseError(f"Failed to fetch download URL: {data.get('msg', 'Unknown error')}", code)
+
             return data['url']

kmdr/module/downloader/__init__.py

@@ -0,0 +1,2 @@
+from .DirectDownloader import DirectDownloader
+from .ReferViaDownloader import ReferViaDownloader

kmdr/module/downloader/{utils.py → download_utils.py}

@@ -3,27 +3,22 @@ import os
 import re
 import math
 from typing import Callable, Optional, Union, Awaitable
-from enum import Enum
 
-from deprecation import deprecated
+from typing_extensions import deprecated
+
 import aiohttp
 import aiofiles
 import aiofiles.os as aio_os
 from rich.progress import Progress
 from aiohttp.client_exceptions import ClientPayloadError
 
+from .misc import STATUS, StateManager
+
 BLOCK_SIZE_REDUCTION_FACTOR = 0.75
 MIN_BLOCK_SIZE = 2048
 
-class STATUS(Enum):
-    WAITING='[blue]等待中[/blue]'
-    DOWNLOADING='[cyan]下载中[/cyan]'
-    RETRYING='[yellow]重试中[/yellow]'
-    MERGING='[magenta]合并中[/magenta]'
-    COMPLETED='[green]完成[/green]'
-    FAILED='[red]失败[/red]'
 
-@deprecated(details="请使用 'download_file_multipart'")
+@deprecated("请使用 'download_file_multipart'")
 async def download_file(
         session: aiohttp.ClientSession,
         semaphore: asyncio.Semaphore,
@@ -163,6 +158,7 @@ async def download_file_multipart(
         return
 
     part_paths = []
+    part_expected_sizes = []
     task_id = None
     try:
         current_url = await fetch_url(url)
@@ -184,9 +180,11 @@ async def download_file_multipart(
                 resumed_size += (await aio_os.stat(part_path)).st_size
 
         task_id = progress.add_task("download", filename=filename, status=STATUS.WAITING.value, total=total_size, completed=resumed_size)
+        state_manager = StateManager(progress=progress, task_id=task_id)
 
         for i, start in enumerate(range(0, total_size, chunk_size)):
             end = min(start + chunk_size - 1, total_size - 1)
+            part_expected_sizes.append(end - start + 1)
 
             task = _download_part(
                 session=session,
@@ -195,8 +193,7 @@ async def download_file_multipart(
                 start=start,
                 end=end,
                 part_path=part_paths[i],
-                progress=progress,
-                task_id=task_id,
+                state_manager=state_manager,
                 headers=headers,
                 retry_times=retry_times
             )
@@ -204,24 +201,29 @@ async def download_file_multipart(
             
         await asyncio.gather(*tasks)
 
-        progress.update(task_id, status=STATUS.MERGING.value, refresh=True)
-        await _merge_parts(part_paths, filename_downloading)
-        
-        os.rename(filename_downloading, file_path)
-    except Exception as e:
-        if task_id is not None:
-            progress.update(task_id, status=STATUS.FAILED.value, visible=False)
+        assert len(part_paths) == len(part_expected_sizes)
+        results = await asyncio.gather(*[_validate_part(part_paths[i], part_expected_sizes[i]) for i in range(num_chunks)])
+        if all(results):
+            await state_manager.request_status_update(part_id=StateManager.PARENT_ID, status=STATUS.MERGING)
+            await _merge_parts(part_paths, filename_downloading)
+            os.rename(filename_downloading, file_path)
+        else:
+            # 如果有任何一个分片校验失败，则视为下载失败
+            await state_manager.request_status_update(part_id=StateManager.PARENT_ID, status=STATUS.FAILED)
 
     finally:
         if await aio_os.path.exists(file_path):
             if task_id is not None:
-                progress.update(task_id, status=STATUS.COMPLETED.value, completed=total_size, refresh=True)
+                await state_manager.request_status_update(part_id=StateManager.PARENT_ID, status=STATUS.COMPLETED)
 
             cleanup_tasks = [aio_os.remove(p) for p in part_paths if await aio_os.path.exists(p)]
             if cleanup_tasks:
                 await asyncio.gather(*cleanup_tasks)
             if callback:
                 callback()
+        else:
+            if task_id is not None:
+                await state_manager.request_status_update(part_id=StateManager.PARENT_ID, status=STATUS.FAILED)
 
 async def _download_part(
         session: aiohttp.ClientSession,
@@ -230,8 +232,7 @@ async def _download_part(
         start: int,
         end: int,
         part_path: str,
-        progress: Progress,
-        task_id,
+        state_manager: StateManager,
         headers: Optional[dict] = None,
         retry_times: int = 3
 ):
@@ -258,21 +259,33 @@ async def _download_part(
                 async with session.get(url, headers=local_headers) as response:
                     response.raise_for_status()
 
-                    if progress.tasks[task_id].fields.get("status") != STATUS.DOWNLOADING.value:
-                        progress.update(task_id, status=STATUS.DOWNLOADING.value, refresh=True)
+                    await state_manager.request_status_update(part_id=start, status=STATUS.DOWNLOADING)
 
                     async with aiofiles.open(part_path, 'ab') as f:
                         async for chunk in response.content.iter_chunked(block_size):
                             if chunk:
                                 await f.write(chunk)
-                                progress.update(task_id, advance=len(chunk))
+                                state_manager.advance(len(chunk))
             return
+    
+        except asyncio.CancelledError:
+            # 如果任务被取消，更新状态为已取消
+            await state_manager.request_status_update(part_id=start, status=STATUS.CANCELLED)
+            raise
+
         except Exception as e:
             if attempts_left > 0:
                 await asyncio.sleep(3)
+                await state_manager.request_status_update(part_id=start, status=STATUS.WAITING)
             else:
                 # console.print(f"[red]分片 {os.path.basename(part_path)} 下载失败: {e}[/red]")
-                raise
+                await state_manager.request_status_update(part_id=start, status=STATUS.PARTIALLY_FAILED)
+
+async def _validate_part(part_path: str, expected_size: int) -> bool:
+    if not await aio_os.path.exists(part_path):
+        return False
+    actual_size = await aio_os.path.getsize(part_path)
+    return actual_size == expected_size
 
 async def _merge_parts(part_paths: list[str], final_path: str):
     async with aiofiles.open(final_path, 'wb') as final_file:
@@ -290,7 +303,31 @@ async def _merge_parts(part_paths: list[str], final_path: str):
             raise e
 
 
+CHAR_MAPPING = {
+    '\\': '＼',
+    '/': '／',
+    ':': '：',
+    '*': '＊',
+    '?': '？',
+    '"': '＂',
+    '<': '＜',
+    '>': '＞',
+    '|': '｜',
+}
+DEFAULT_ILLEGAL_CHARS_REPLACEMENT = '_'
+ILLEGAL_CHARS_RE = re.compile(r'[\\/:*?"<>|]')
+
+def readable_safe_filename(name: str) -> str:
+    """
+    将字符串转换为安全的文件名，替换掉非法字符。
+    """
+    def replace_char(match):
+        char = match.group(0)
+        return CHAR_MAPPING.get(char, DEFAULT_ILLEGAL_CHARS_REPLACEMENT)
+
+    return ILLEGAL_CHARS_RE.sub(replace_char, name).strip()
 
+@deprecated("请使用 'readable_safe_filename'")
 def safe_filename(name: str) -> str:
     """
     替换非法文件名字符为下划线

kmdr/module/downloader/misc.py

@@ -0,0 +1,64 @@
+from enum import Enum
+import asyncio
+
+from rich.progress import Progress, TaskID
+
+
+class STATUS(Enum):
+    WAITING='[blue]等待中[/blue]'
+    RETRYING='[yellow]重试中[/yellow]'
+    DOWNLOADING='[cyan]下载中[/cyan]'
+    MERGING='[magenta]合并中[/magenta]'
+    COMPLETED='[green]完成[/green]'
+    PARTIALLY_FAILED='[red]分片失败[/red]'
+    FAILED='[red]失败[/red]'
+    CANCELLED='[yellow]已取消[/yellow]'
+
+    @property
+    def order(self) -> int:
+        order_mapping = {
+            STATUS.WAITING: 1,
+            STATUS.RETRYING: 2,
+            STATUS.DOWNLOADING: 3,
+            STATUS.MERGING: 4,
+            STATUS.COMPLETED: 5,
+            STATUS.PARTIALLY_FAILED: 6,
+            STATUS.FAILED: 7,
+            STATUS.CANCELLED: 8,
+        }
+        return order_mapping[self]
+    
+    def __lt__(self, other):
+        if not isinstance(other, STATUS):
+            return NotImplemented
+        return self.order < other.order
+
+
+class StateManager:
+
+    def __init__(self, progress: Progress, task_id: TaskID):
+        self._part_states: dict[int, STATUS] = {}
+        self._progress = progress
+        self._task_id = task_id
+        self._current_status = STATUS.WAITING
+
+        self._lock = asyncio.Lock()
+
+    PARENT_ID: int = -1
+
+    def advance(self, advance: int):
+        self._progress.update(self._task_id, advance=advance)
+
+    def _update_status(self):
+        if not self._part_states:
+            return
+        
+        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)
+
+    async def request_status_update(self, part_id: int, status: STATUS):
+        async with self._lock:
+            self._part_states[part_id] = status
+            self._update_status()

kmdr/module/lister/FollowedBookLister.py

@@ -1,15 +1,15 @@
 import asyncio
+
 from bs4 import BeautifulSoup
 from rich.table import Table
 from rich.prompt import IntPrompt
 
 from kmdr.core import Lister, LISTERS, BookInfo, VolInfo
 from kmdr.core.utils import async_retry
+from kmdr.core.constants import API_ROUTE
 
 from .utils import extract_book_info_and_volumes
 
-MY_FOLLOW_URL = 'https://kox.moe/myfollow.php'
-
 @LISTERS.register()
 class FollowedBookLister(Lister):
 
@@ -62,7 +62,7 @@ class FollowedBookLister(Lister):
     
     @async_retry()
     async def _list_followed_books(self) -> 'list[BookInfo]':
-        async with self._session.get(MY_FOLLOW_URL) as response:
+        async with self._session.get(API_ROUTE.MY_FOLLOW) as response:
             response.raise_for_status()
             html_text = await response.text()
 

kmdr/module/lister/__init__.py

@@ -0,0 +1,2 @@
+from .BookUrlLister import BookUrlLister
+from .FollowedBookLister import FollowedBookLister

kmdr/module/lister/utils.py

@@ -2,6 +2,7 @@ from bs4 import BeautifulSoup
 import re
 from typing import Optional
 
+from yarl import URL
 from aiohttp import ClientSession as Session
 
 from kmdr.core import BookInfo, VolInfo, VolumeType
@@ -16,7 +17,13 @@ async def extract_book_info_and_volumes(session: Session, url: str, book_info: O
     :param url: 书籍页面的 URL。
     :return: 包含书籍信息和卷信息的元组。
     """
-    async with session.get(url) as response:
+    structured_url = URL(url)
+
+    # 移除移动端路径部分，统一为桌面端路径
+    # 因为移动端页面的结构与桌面端不同，可能会影响解析
+    route = structured_url.path[2:] if structured_url.path.startswith('/m/') else structured_url.path
+
+    async with session.get(route) as response:
         response.raise_for_status()
 
         # 如果后续有性能问题，可以先考虑使用 lxml 进行解析
@@ -48,7 +55,7 @@ async def __extract_volumes(session: Session, book_page: BeautifulSoup) -> list[
     pattern = re.compile(r'/book_data.php\?h=\w+')
     book_data_url = pattern.search(script).group(0)
     
-    async with session.get(url = f"https://kox.moe{book_data_url}") as response:
+    async with session.get(url = book_data_url) as response:
         response.raise_for_status()
 
         book_data = (await response.text()).split('\n')

kmdr/module/picker/__init__.py

@@ -0,0 +1,2 @@
+from .ArgsFilterPicker import ArgsFilterPicker
+from .DefaultVolPicker import DefaultVolPicker

{kmoe_manga_downloader-1.2.0.dist-info → kmoe_manga_downloader-1.2.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kmoe-manga-downloader
-Version: 1.2.0
+Version: 1.2.2
 Summary: A CLI-downloader for site @kox.moe.
 Author-email: Chris Zheng <chrisis58@outlook.com>
 License: MIT License
@@ -35,19 +35,20 @@ Classifier: Operating System :: OS Independent
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: deprecation~=2.1.0
 Requires-Dist: beautifulsoup4~=4.13.4
 Requires-Dist: aiohttp~=3.12.15
 Requires-Dist: aiofiles~=24.1.0
 Requires-Dist: async-lru~=2.0.5
 Requires-Dist: rich~=13.9.4
+Requires-Dist: yarl~=1.20.1
+Requires-Dist: typing-extensions~=4.15.0
 Dynamic: license-file
 
 # Kmoe Manga Downloader
 
 [![PyPI Downloads](https://static.pepy.tech/badge/kmoe-manga-downloader)](https://pepy.tech/projects/kmoe-manga-downloader) [![PyPI version](https://img.shields.io/pypi/v/kmoe-manga-downloader.svg)](https://pypi.org/project/kmoe-manga-downloader/) [![Unit Tests](https://github.com/chrisis58/kmdr/actions/workflows/unit-test.yml/badge.svg)](https://github.com/chrisis58/kmdr/actions/workflows/unit-test.yml) [![Interpretor](https://img.shields.io/badge/python-3.9+-blue)](https://www.python.org/) [![License](https://img.shields.io/badge/License-MIT-green)](https://github.com/chrisis58/kmdr/blob/main/LICENSE)
 
-`kmdr (Kmoe Manga Downloader)` 是一个 Python 应用，用于从 [Kmoe](https://kox.moe/) 网站下载漫画。它支持在终端环境下的登录、下载指定漫画及其卷，并支持回调脚本执行。
+`kmdr (Kmoe Manga Downloader)` 是一个 Python 终端应用，用于从 [Kmoe](https://kxx.moe/) 网站下载漫画。它支持在终端环境下的登录、下载指定漫画及其卷，并支持回调脚本执行。
 
 <p align="center">
   <img src="assets/kmdr-demo.gif" alt="kmdr 使用演示" width="720">
@@ -55,11 +56,17 @@ Dynamic: license-file
 
 ## ✨功能特性
 
-- **现代化终端界面**: 使用 [rich](https://github.com/Textualize/rich) 构建的终端用户界面（TUI），提供进度条和菜单等现代化、美观的交互式终端界面。
+- **现代化终端界面**: 基于 [rich](https://github.com/Textualize/rich) 构建的终端用户界面（TUI），提供进度条和菜单等现代化、美观的交互式终端界面。
 - **凭证和配置管理**: 应用自动维护登录凭证和下载设置，实现一次配置、持久有效，提升使用效率。
-- **高效下载的性能**:  采用 `asyncio` 并发分片下载技术，充分利用网络带宽，极大加速单个大文件的下载速度。
-- **强大的高可用性**: 内置强大的自动重试与断点续传机制，无惧网络中断，确保下载任务最终成功。
-- **灵活的自动化接口**: 支持下载完成后自动执行自定义回调脚本，轻松集成到您的自动化流程。
+- **高效下载的性能**:  采用 `asyncio` 并发分片下载方式，充分利用网络带宽，显著加速单个大文件的下载速度。
+- **强大的高可用性**: 内置自动重试与断点续传机制，无惧网络中断，确保下载任务在不稳定环境下依然能够成功。
+- **灵活的自动化接口**: 支持在每个文件下载成功后自动执行自定义回调脚本，轻松集成到您的自动化工作流。
+
+## 🖼️ 使用场景
+
+- **通用的加速体验**: 采用并发分片下载方式，充分地利用不同类型用户的网络带宽，提升数据传输效率，从而有效缩短下载的等待时间。
+- **灵活部署与远程控制**: 支持在远端服务器或 NAS 上运行，可以在其他设备（PC、平板）上浏览，而通过简单的命令触发远程下载任务，实现浏览与存储的分离。
+- **智能化自动追新**: 应用支持识别重复内容，可配合定时任务实等现无人值守下载最新的内容，轻松打造时刻保持同步的个人资料库。
 
 ## 🛠️安装应用
 
@@ -73,7 +80,7 @@ pip install kmoe-manga-downloader
 
 ### 1. 登录 `kmoe`
 
-首先需要登录 `kox.moe` 并保存登录状态（Cookie）。
+首先需要登录 `kmoe` 并保存登录状态（Cookie）。
 
 ```bash
 kmdr login -u <your_username> -p <your_password>
@@ -91,26 +98,28 @@ kmdr login -u <your_username>
 
 ```bash
 # 在当前目录下载第一、二、三卷
-kmdr download --dest . --book-url https://kox.moe/c/50076.htm --volume 1,2,3
-kmdr download -l https://kox.moe/c/50076.htm -v 1-3
+kmdr download --dest . --book-url https://kxx.moe/c/50076.htm --volume 1,2,3
+# 下面命令的功能与上面相同
+kmdr download -l https://kxx.moe/c/50076.htm -v 1-3
 ```
 
 ```bash
 # 在目标目录下载全部番外篇
-kmdr download --dest path/to/destination --book-url https://kox.moe/c/50076.htm --vol-type extra -v all
-kmdr download -d path/to/destination -l https://kox.moe/c/50076.htm -t extra -v all
+kmdr download --dest path/to/destination --book-url https://kxx.moe/c/50076.htm --vol-type extra -v all
+# 下面命令的功能与上面相同
+kmdr download -d path/to/destination -l https://kxx.moe/c/50076.htm -t extra -v all
 ```
 
 #### 常用参数说明：
 
-- `-d`, `--dest`: 下载的目标目录（默认为当前目录），在此基础上会额外添加一个为书籍名称的子目录
-- `-l`, `--book-url`: 指定书籍的主页地址
-- `-v`, `--volume`: 指定卷的名称，多个名称使用逗号分隔，`all` 表示下载所有卷
+- `-d`, `--dest`: 下载的目标目录（默认为当前目录），在此基础上会额外添加一个为漫画名称的子目录
+- `-l`, `--book-url`: 指定漫画的主页地址
+- `-v`, `--volume`: 指定下载的卷，多个用逗号分隔，例如 `1,2,3` 或 `1-5,8`，`all` 表示全部
 - `-t`, `--vol-type`: 卷类型，`vol`: 单行本（默认）；`extra`: 番外；`seri`: 连载话；`all`: 全部
 - `-p`, `--proxy`: 代理服务器地址
-- `-r`, `--retry`: 下载失败时的重试次数
+- `-r`, `--retry`: 下载失败时的重试次数，默认为 3
 - `-c`, `--callback`: 下载完成后的回调脚本（使用方式详见 [4. 回调函数](https://github.com/chrisis58/kmoe-manga-downlaoder?tab=readme-ov-file#4-%E5%9B%9E%E8%B0%83%E5%87%BD%E6%95%B0)）
-- `--num-workers`: 最大同时下载数量，默认为 1
+- `--num-workers`: 最大下载并发数量，默认为 8
 
 > 完整的参数说明可以从 `help` 指令中获取。
 
@@ -127,7 +136,7 @@ kmdr status
 你可以设置一个回调函数，下载完成后执行。回调可以是任何你想要的命令：
 
 ```bash
-kmdr download -d path/to/destination --book-url https://kox.moe/c/50076.htm -v 1-3 \
+kmdr download -d path/to/destination --book-url https://kxx.moe/c/50076.htm -v 1-3 \
 	--callback "echo '{b.name} {v.name} downloaded!' >> ~/kmdr.log"
 ```
 
@@ -143,7 +152,7 @@ kmdr download -d path/to/destination --book-url https://kox.moe/c/50076.htm -v 1
 | b.name   | 对应漫画的名字 |
 | b.author | 对应漫画的作者 |
 
-> 完整的可用参数请参考 [structure.py](https://github.com/chrisis58/kmdr/blob/main/core/structure.py#L11) 中关于 `VolInfo` 的定义。
+> 完整的可用参数请参考 [structure.py](https://github.com/chrisis58/kmoe-manga-downloader/blob/main/src/kmdr/core/structure.py#L11) 中关于 `VolInfo` 的定义。
 
 ### 5. 持久化配置
 
@@ -167,6 +176,20 @@ kmdr config -s num_workers=5 "callback=echo '{b.name} {v.name} downloaded!' >> ~
 
 > 当前仅支持部分下载参数的持久化：`num_workers`, `dest`, `retry`, `callback`, `proxy`
 
+### 6. 镜像源切换
+
+为了保证服务的长期可用性，并让用户能根据自己的网络环境选择最快的服务器，应用支持灵活地切换镜像源。
+
+当您发现默认源（当前为 `kxx.moe`）访问缓慢或失效时，可以通过 `config` 命令轻松切换到其他备用镜像源：
+
+```
+kmdr config --base-url https://mox.moe
+# 或者
+kmdr config -b https://mox.moe
+```
+
+你可以参考 [镜像目录](./mirror/mirrors.json) 来选择合适的镜像源，如果你发现部分镜像源过时或者有缺失，欢迎贡献你的内容！
+
 ## ⚠️ 声明
 
 - 本工具仅作学习、研究、交流使用，使用本工具的用户应自行承担风险