kmoe-manga-downloader 1.2.0__tar.gz → 1.2.1__tar.gz

{kmoe_manga_downloader-1.2.0/src/kmoe_manga_downloader.egg-info → kmoe_manga_downloader-1.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kmoe-manga-downloader
-Version: 1.2.0
+Version: 1.2.1
 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) 来选择合适的镜像源，如果你发现部分镜像源过时或者有缺失，欢迎贡献你的内容！
+
 ## ⚠️ 声明
 
 - 本工具仅作学习、研究、交流使用，使用本工具的用户应自行承担风险

{kmoe_manga_downloader-1.2.0 → kmoe_manga_downloader-1.2.1}/README.md

@@ -2,7 +2,7 @@
 
 [![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">
@@ -10,11 +10,17 @@
 
 ## ✨功能特性
 
-- **现代化终端界面**: 使用 [rich](https://github.com/Textualize/rich) 构建的终端用户界面（TUI），提供进度条和菜单等现代化、美观的交互式终端界面。
+- **现代化终端界面**: 基于 [rich](https://github.com/Textualize/rich) 构建的终端用户界面（TUI），提供进度条和菜单等现代化、美观的交互式终端界面。
 - **凭证和配置管理**: 应用自动维护登录凭证和下载设置，实现一次配置、持久有效，提升使用效率。
-- **高效下载的性能**:  采用 `asyncio` 并发分片下载技术，充分利用网络带宽，极大加速单个大文件的下载速度。
-- **强大的高可用性**: 内置强大的自动重试与断点续传机制，无惧网络中断，确保下载任务最终成功。
-- **灵活的自动化接口**: 支持下载完成后自动执行自定义回调脚本，轻松集成到您的自动化流程。
+- **高效下载的性能**:  采用 `asyncio` 并发分片下载方式，充分利用网络带宽，显著加速单个大文件的下载速度。
+- **强大的高可用性**: 内置自动重试与断点续传机制，无惧网络中断，确保下载任务在不稳定环境下依然能够成功。
+- **灵活的自动化接口**: 支持在每个文件下载成功后自动执行自定义回调脚本，轻松集成到您的自动化工作流。
+
+## 🖼️ 使用场景
+
+- **通用的加速体验**: 采用并发分片下载方式，充分地利用不同类型用户的网络带宽，提升数据传输效率，从而有效缩短下载的等待时间。
+- **灵活部署与远程控制**: 支持在远端服务器或 NAS 上运行，可以在其他设备（PC、平板）上浏览，而通过简单的命令触发远程下载任务，实现浏览与存储的分离。
+- **智能化自动追新**: 应用支持识别重复内容，可配合定时任务实等现无人值守下载最新的内容，轻松打造时刻保持同步的个人资料库。
 
 ## 🛠️安装应用
 
@@ -28,7 +34,7 @@ pip install kmoe-manga-downloader
 
 ### 1. 登录 `kmoe`
 
-首先需要登录 `kox.moe` 并保存登录状态（Cookie）。
+首先需要登录 `kmoe` 并保存登录状态（Cookie）。
 
 ```bash
 kmdr login -u <your_username> -p <your_password>
@@ -46,26 +52,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` 指令中获取。
 
@@ -82,7 +90,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"
 ```
 
@@ -98,7 +106,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. 持久化配置
 
@@ -122,6 +130,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) 来选择合适的镜像源，如果你发现部分镜像源过时或者有缺失，欢迎贡献你的内容！
+
 ## ⚠️ 声明
 
 - 本工具仅作学习、研究、交流使用，使用本工具的用户应自行承担风险

{kmoe_manga_downloader-1.2.0 → kmoe_manga_downloader-1.2.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "kmoe-manga-downloader"
-version = "1.2.0"
+version = "1.2.1"
 authors = [
     { name="Chris Zheng", email="chrisis58@outlook.com" },
 ]
@@ -17,12 +17,13 @@ classifiers = [
 ]
 
 dependencies = [
-    "deprecation~=2.1.0",
     "beautifulsoup4~=4.13.4",
     "aiohttp~=3.12.15",
     "aiofiles~=24.1.0",
     "async-lru~=2.0.5",
-    "rich~=13.9.4"
+    "rich~=13.9.4",
+    "yarl~=1.20.1",
+    "typing-extensions~=4.15.0",
 ]
 
 [project.urls]

{kmoe_manga_downloader-1.2.0 → kmoe_manga_downloader-1.2.1}/src/kmdr/core/bases.py

@@ -7,7 +7,7 @@ from aiohttp import ClientSession
 from .error import LoginError
 from .registry import Registry
 from .structure import VolInfo, BookInfo
-from .utils import construct_callback
+from .utils import construct_callback, async_retry
 
 from .context import TerminalContext, SessionContext, UserProfileContext, ConfigContext
 
@@ -23,6 +23,8 @@ class Authenticator(SessionContext, ConfigContext, UserProfileContext, TerminalC
 
     def __init__(self, *args, **kwargs):
         super().__init__(*args, **kwargs)
+        # 这里的 base url 可能会在认证过程中被更新
+        self._inner_base_url: Optional[str] = None
 
     # 在使用代理登录时，可能会出现问题，但是现在还不清楚是不是代理的问题。
     # 主站正常情况下不使用代理也能登录成功。但是不排除特殊的网络环境下需要代理。
@@ -31,11 +33,21 @@ class Authenticator(SessionContext, ConfigContext, UserProfileContext, TerminalC
     async def authenticate(self) -> None:
         with self._console.status("认证中..."):
             try:
-                assert await self._authenticate()
+                # 这里添加了 base_url_setter，以便在重定向时更新 base_url
+                assert await async_retry(
+                    base_url_setter=self._configurer.set_base_url
+                )(self._authenticate)()
+
+                # 登录成功后，更新 base_url
+                self._base_url = self.base_url
             except LoginError as e:
                 self._console.print("[red]认证失败。请检查您的登录凭据或会话 cookie。[/red]")
                 self._console.print(f"[yellow]详细信息：{e}[/yellow]")
                 exit(1)
+    
+    @property
+    def base_url(self) -> str:
+        return self._inner_base_url or self._configurer.base_url
 
     @abstractmethod
     async def _authenticate(self) -> bool: ...

kmoe_manga_downloader-1.2.1/src/kmdr/core/constants.py

@@ -0,0 +1,79 @@
+from dataclasses import dataclass
+from enum import Enum
+from typing_extensions import deprecated
+
+
+@dataclass(frozen=True)
+class _BaseUrl:
+
+    @property
+    @deprecated("KOX 已过时，请使用 KXO 或 KOZ。")
+    def KOX(self) -> str:
+        return 'https://kox.moe'
+    
+    @property
+    def KXX(self) -> str:
+        return 'https://kxx.moe'
+
+    @property
+    def KXO(self) -> str:
+        return 'https://kxo.moe'
+
+    @property
+    def KOZ(self) -> str:
+        return 'https://koz.moe'
+
+    @property
+    def MOX(self) -> str:
+        return 'https://mox.moe'
+
+    @property
+    def DEFAULT(self) -> str:
+        """默认基础 URL"""
+        return self.KXX
+
+
+@dataclass(frozen=True)
+class _ApiRoute():
+    PROFILE: str = '/my.php'
+    """用户信息页面"""
+
+    LOGIN: str = '/login.php'
+    """登录页面"""
+
+    LOGIN_DO: str = '/login_do.php'
+    """登录接口"""
+
+    MY_FOLLOW: str = '/myfollow.php'
+    """关注列表页面"""
+
+    BOOK_DATA: str = '/book_data.php'
+    """书籍数据接口"""
+
+    DOWNLOAD: str = '/dl/{book_id}/{volume_id}/1/2/{is_vip}/'
+    """下载接口"""
+
+    GETDOWNURL: str = '/getdownurl.php?b={book_id}&v={volume_id}&mobi=2&vip={is_vip}&json=1'
+    """获取下载链接接口"""
+
+
+class LoginResponse(Enum):
+    m100 = "登录成功。"
+
+    e400 = "帳號或密碼錯誤。"
+    e401 = "非法訪問，請使用瀏覽器正常打開本站。"
+    e402 = "帳號已經註銷。不會解釋原因，無需提問。"
+    e403 = "驗證失效，請刷新頁面重新操作。"
+
+    unknown = "未知响应代码。"
+
+    @classmethod
+    def from_code(cls, code: str) -> 'LoginResponse':
+        return cls.__members__.get(code, cls.unknown)
+
+
+API_ROUTE = _ApiRoute()
+"""API 路由常量实例"""
+
+BASE_URL = _BaseUrl()
+"""基础 URL 实例"""

{kmoe_manga_downloader-1.2.0 → kmoe_manga_downloader-1.2.1}/src/kmdr/core/context.py

@@ -1,6 +1,7 @@
 from aiohttp import ClientSession
 
-from .defaults import Configurer as InnerConfigurer, UserProfile, session_var, progress, console
+
+from .defaults import Configurer as InnerConfigurer, UserProfile, session_var, progress, console, base_url_var
 
 class TerminalContext:
 
@@ -9,12 +10,6 @@ class TerminalContext:
         self._progress = progress
         self._console = console
 
-class SessionContext:
-
-    def __init__(self, *args, **kwargs):
-        super().__init__()
-        self._session: ClientSession = session_var.get()
-
 class UserProfileContext:
 
     def __init__(self, *args, **kwargs):
@@ -26,3 +21,20 @@ class ConfigContext:
     def __init__(self, *args, **kwargs):
         super().__init__()
         self._configurer = InnerConfigurer()
+
+class SessionContext:
+
+    def __init__(self, *args, **kwargs):
+        super().__init__()
+
+    @property
+    def _session(self) -> ClientSession:
+        return session_var.get()
+
+    @property
+    def _base_url(self) -> str:
+        return base_url_var.get()
+
+    @_base_url.setter
+    def _base_url(self, value: str):
+        base_url_var.set(value)

{kmoe_manga_downloader-1.2.0 → kmoe_manga_downloader-1.2.1}/src/kmdr/core/defaults.py

@@ -1,6 +1,6 @@
 import os
 import json
-from typing import Optional
+from typing import Optional, Any
 import argparse
 from contextvars import ContextVar
 from rich.console import Console
@@ -15,6 +15,7 @@ from rich.progress import (
 
 from .utils import singleton
 from .structure import Config
+from .constants import BASE_URL
 
 HEADERS = {
     'User-Agent': 'kmdr/1.0 (https://github.com/chrisis58/kmoe-manga-downloader)'
@@ -75,6 +76,7 @@ def argument_parser():
     config_parser = subparsers.add_parser('config', help='配置下载器')
     config_parser.add_argument('-l', '--list-option', action='store_true', help='列出所有配置')
     config_parser.add_argument('-s', '--set', nargs='+', type=str, help='设置一个或多个配置项，格式为 `key=value`，例如: `num_workers=8`')
+    config_parser.add_argument('-b', '--base-url', type=str, help='设置镜像站点的基础 URL, 例如: `https://kxx.moe`')
     config_parser.add_argument('-c', '--clear', type=str, help='清除指定配置，可选值为 `all`, `cookie`, `option`')
     config_parser.add_argument('-d', '--delete', '--unset', dest='unset', type=str, help='删除特定的配置选项')
 
@@ -137,6 +139,9 @@ class Configurer:
             cookie = config.get('cookie', None)
             if cookie is not None and isinstance(cookie, dict):
                 self._config.cookie = cookie
+            base_url = config.get('base_url', None)
+            if base_url is not None and isinstance(base_url, str):
+                self._config.base_url = base_url
 
     @property
     def config(self) -> 'Config':
@@ -162,12 +167,24 @@ class Configurer:
         return self._config.option
     
     @option.setter
-    def option(self, value: Optional[dict[str, any]]):
+    def option(self, value: Optional[dict[str, Any]]):
         if self._config is None:
             self._config = Config()
         self._config.option = value
         self.update()
     
+    @property
+    def base_url(self) -> str:
+        if self._config is None or self._config.base_url is None:
+            return BASE_URL.DEFAULT 
+        return self._config.base_url
+    
+    def set_base_url(self, value: str):
+        if self._config is None:
+            self._config = Config()
+        self._config.base_url = value
+        self.update()
+    
     def update(self):
         with open(os.path.join(os.path.expanduser("~"), self.__filename), 'w') as f:
             json.dump(self._config.__dict__, f, indent=4, ensure_ascii=False)
@@ -184,7 +201,7 @@ class Configurer:
 
         self.update()
     
-    def set_option(self, key: str, value: any):
+    def set_option(self, key: str, value: Any):
         if self._config.option is None:
             self._config.option = {}
 
@@ -209,5 +226,11 @@ def __combine_args(dest: argparse.Namespace, option: dict) -> argparse.Namespace
 
 def combine_args(dest: argparse.Namespace) -> argparse.Namespace:
     assert isinstance(dest, argparse.Namespace), "dest must be an argparse.Namespace instance"
-    option = Configurer().config.option
-    return __combine_args(dest, option)
+    option = Configurer().option
+    
+    if option is None:
+        return dest
+
+    return __combine_args(dest, option)
+
+base_url_var = ContextVar('base_url', default=Configurer().base_url)

{kmoe_manga_downloader-1.2.0 → kmoe_manga_downloader-1.2.1}/src/kmdr/core/error.py

@@ -12,4 +12,12 @@ class LoginError(KmdrError):
         super().__init__(message, solution)
 
     def __str__(self):
-        return f"{self.message}\n{self._solution}"
+        return f"{self.message}\n{self._solution}"
+
+class RedirectError(KmdrError):
+    def __init__(self, message, new_base_url: str):
+        super().__init__(message)
+        self.new_base_url = new_base_url
+
+    def __str__(self):
+        return f"{self.message} 新的地址: {self.new_base_url}"

{kmoe_manga_downloader-1.2.0 → kmoe_manga_downloader-1.2.1}/src/kmdr/core/structure.py

@@ -66,3 +66,5 @@ class Config:
     """
 
     cookie: Optional[dict[str, str]] = None
+
+    base_url: Optional[str] = None

{kmoe_manga_downloader-1.2.0 → kmoe_manga_downloader-1.2.1}/src/kmdr/core/utils.py

@@ -4,10 +4,10 @@ import asyncio
 
 import aiohttp
 
-from deprecation import deprecated
 import subprocess
 
 from .structure import BookInfo, VolInfo
+from .error import RedirectError
 
 
 def singleton(cls):
@@ -43,7 +43,8 @@ def async_retry(
     attempts: int = 3,
     delay: float = 1.0,
     backoff: float = 2.0,
-    retry_on_status: set[int] = {500, 502, 503, 504, 429, 408}
+    retry_on_status: set[int] = {500, 502, 503, 504, 429, 408},
+    base_url_setter: Optional[Callable[[str], None]] = None,
 ):
     def decorator(func):
         @functools.wraps(func)
@@ -62,9 +63,16 @@ def async_retry(
                     # 对于所有其他 aiohttp 客户端异常和超时，进行重试
                     if attempt == attempts - 1:
                         raise
+                except RedirectError as e:
+                    if base_url_setter:
+                        base_url_setter(e.new_base_url)
+                        print(f"检测到重定向，已自动更新 base url 为: {e.new_base_url}。立即重试...")
+                        continue
+                    else:
+                        raise
                 
                 await asyncio.sleep(current_delay)
 
                 current_delay *= backoff
         return wrapper
-    return decorator
+    return decorator

kmoe_manga_downloader-1.2.1/src/kmdr/module/__init__.py

@@ -0,0 +1,5 @@
+from .authenticator import *
+from .lister import *
+from .picker import *
+from .downloader import *
+from .configurer import *

{kmoe_manga_downloader-1.2.0 → kmoe_manga_downloader-1.2.1}/src/kmdr/module/authenticator/CookieAuthenticator.py

@@ -4,12 +4,11 @@ from yarl import URL
 
 from kmdr.core import Authenticator, AUTHENTICATOR, LoginError
 
-from .utils import check_status
-from .utils import PROFILE_URL
+from .utils import check_status, extract_base_url
 
 @AUTHENTICATOR.register()
 class CookieAuthenticator(Authenticator):
-    def __init__(self, proxy: Optional[str] = None, *args, **kwargs):
+    def __init__(self, proxy: Optional[str] = None, book_url: Optional[str] = None, *args, **kwargs):
         super().__init__(proxy, *args, **kwargs)
 
         if 'command' in kwargs and kwargs['command'] == 'status':
@@ -17,17 +16,21 @@ class CookieAuthenticator(Authenticator):
         else:
             self._show_quota = False
 
+        # 根据用户提供的 book_url 来决定访问的镜像站
+        self._inner_base_url = extract_base_url(book_url, default=self._base_url)
+
     async def _authenticate(self) -> bool:
         cookie = self._configurer.cookie
         
         if not cookie:
             raise LoginError("无法找到 Cookie，请先完成登录。", ['kmdr login -u <username>'])
         
-        self._session.cookie_jar.update_cookies(cookie, response_url=URL(PROFILE_URL))
+        self._session.cookie_jar.update_cookies(cookie, response_url=URL(self.base_url))
         return await check_status(
             self._session,
             self._console,
+            base_url=self.base_url,
             show_quota=self._show_quota,
             is_vip_setter=lambda value: setattr(self._profile, 'is_vip', value),
             level_setter=lambda value: setattr(self._profile, 'user_level', value),
-        )
+        )