kmoe-manga-downloader 1.0.0__tar.gz

kmoe_manga_downloader-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 chris zheng
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

kmoe_manga_downloader-1.0.0/PKG-INFO

@@ -0,0 +1,182 @@
+Metadata-Version: 2.4
+Name: kmoe-manga-downloader
+Version: 1.0.0
+Summary: A CLI-downloader for site @kox.moe.
+Author-email: Chris Zheng <chrisis58@outlook.com>
+License: MIT License
+        
+        Copyright (c) 2025 chris zheng
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://github.com/chrisis58/kmoe-manga-downloader
+Project-URL: Issues, https://github.com/chrisis58/kmoe-manga-downloader/issues
+Keywords: manga,downloader,kmoe
+Classifier: Development Status :: 4 - Beta
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: beautifulsoup4<5.0.0,>=4.11.1
+Requires-Dist: requests<3.0.0,>=2.32.3
+Requires-Dist: tqdm<5.0.0,>=4.67.1
+Requires-Dist: cloudscraper<2.0.0,>=1.2.71
+Dynamic: license-file
+
+# 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/) 网站下载漫画。它支持在终端环境下的登录、下载指定书籍及其卷，并支持回调脚本执行。
+
+## ✨功能特性
+
+- 以命令行参数登录网站并持久化凭证
+- 支持多种方式筛选需要的内容
+- 支持网站上提供的不同的下载方式
+- 支持多线程下载，失败重试、断点续传
+- 提供自定义的下载完成回调命令
+- 提供通用配置持久化的实现
+
+## 🛠️安装依赖
+
+在使用本脚本之前，请确保你已经安装了项目所需要的依赖：
+
+```bash
+git clone https://github.com/chrisis58/kmoe-manga-downloader.git
+cd kmoe-manga-downloader
+
+pip install -r requirements.txt
+```
+
+## 📋使用方法
+
+### 1. 登录 `kmoe`
+
+首先需要登录 `kox.moe` 并保存登录状态（Cookie）。
+
+```bash
+python kmdr.py login -u <your_username> -p <your_password>
+```
+
+或者：
+
+```bash
+python kmdr.py login -u <your_username>
+```
+
+第二种方式会在程序运行时获取登录密码。如果登录成功，会同时显示当前登录用户及配额。
+
+### 2. 下载漫画书籍
+
+你可以通过以下命令下载指定书籍或卷：
+
+```bash
+# 在 path/to/destination 目录下载第一、二、三卷
+python kmdr.py download -d path/to/destination --book-url https://kox.moe/c/50076.htm --volume 1,2,3
+python kmdr.py download -d path/to/destination --book-url https://kox.moe/c/50076.htm -v 1-3
+```
+
+```bash
+# 在 path/to/download/destination 目录下载全部番外篇
+python kmdr.py download -d path/to/destination --book-url https://kox.moe/c/50076.htm --vol-type extra -v all
+```
+
+#### 常用参数说明：
+
+- `-d`, `--dest`: 下载的目标目录，在此基础上会额外添加一个为书籍名称的子目录
+- `-l`, `--book-url`: 指定书籍的主页地址
+- `-v`, `--volume`: 指定卷的名称，多个名称使用逗号分隔，`all` 表示下载所有卷
+- `-t`, `--vol-type`: 卷类型，`vol`: 单行本（默认）；`extra`: 番外；`seri`: 连载话；`all`: 全部
+- `-p`, `--proxy`: 代理服务器地址
+- `-r`, `--retry`: 下载失败时的重试次数
+- `-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
+
+> 完整的参数说明可以从 `help` 指令中获取。
+
+### 3. 查看账户状态
+
+查看当前账户信息（例如：账户名和配额等）：
+
+```bash
+python kmdr.py status
+```
+
+### 4. 回调函数
+
+你可以设置一个回调函数，下载完成后执行。回调可以是任何你想要的命令：
+
+```bash
+python kmdr.py download -d path/to/destination --book-url https://kox.moe/c/50076.htm -v 1-3 \
+	--callback "echo '{b.name} {v.name} downloaded!' >> ~/kmdr.log"
+```
+
+> 字符串模板会直接朴素地替换，卷名或者书名可能会包含空格，推荐使用引号包含避免出现错误。
+
+`{b.name}, {v.name}` 会被分别替换为书籍和卷的名称。常用参数：
+
+| 变量名   | 描述           |
+| -------- | -------------- |
+| v.name   | 卷的名称       |
+| v.page   | 卷的页数       |
+| v.size   | 卷的文件大小   |
+| b.name   | 对应漫画的名字 |
+| b.author | 对应漫画的作者 |
+
+> 完整的可用参数请参考 [structure.py](https://github.com/chrisis58/kmdr/blob/main/core/structure.py#L11) 中关于 `VolInfo` 的定义。
+
+### 5. 持久化配置
+
+重复设置下载的代理服务器、目标路径等参数，可能会降低脚本的使用效率。所以脚本也提供了通用配置的持久化命令：
+
+```bash
+python kmdr.py config --set proxy=http://localhost:7890 dest=/path/to/destination
+python kmdr.py config -s num_workers=5 "callback=echo '{b.name} {v.name} downloaded!' >> ~/kmdr.log"
+```
+
+只需要配置一次即可对之后的所有的下载指令生效。
+
+> 注意：这里的参数名称不可以使用简写，例如 `dest` 不可用使用 `d` 来替换。
+
+同时，你也可以使用以下命令进行持久化配置的管理：
+
+- `-l`, `--list-option`: 显示当前存在的各个配置
+- `-s`, `--set`: 设置持久化的配置，键和值通过 `=` 分隔，设置多个配置可以通过空格间隔
+- `-c`, `--clear`: 清除配置，`all`: 清除所有；`cookie`: 退出登录；`option`: 清除持久化的配置
+- `-d`, `--delete`, `--unset`: 清除单项配置
+
+> 当前仅支持部分下载参数的持久化：`num_workers`, `dest`, `retry`, `callback`, `proxy`
+
+## ⚠️ 声明
+
+- 本工具仅作学习、研究、交流使用，使用本工具的用户应自行承担风险
+- 作者不对使用本工具导致的任何损失、法律纠纷或其他后果负责
+- 作者不对用户使用本工具的行为负责，包括但不限于用户违反法律或任何第三方权益的行为
+
+---
+
+<div align=center> 
+💬任何使用中遇到的问题、希望添加的功能，都欢迎提交 issue 或开 discussion 交流！<br />
+⭐ 如果这个项目对你有帮助，请给它一个星标！<br /> <br /> 
+<img src="https://counter.seku.su/cmoe?name=kmdr&theme=mbs" />
+</div>
+

kmoe_manga_downloader-1.0.0/README.md

@@ -0,0 +1,139 @@
+# 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/) 网站下载漫画。它支持在终端环境下的登录、下载指定书籍及其卷，并支持回调脚本执行。
+
+## ✨功能特性
+
+- 以命令行参数登录网站并持久化凭证
+- 支持多种方式筛选需要的内容
+- 支持网站上提供的不同的下载方式
+- 支持多线程下载，失败重试、断点续传
+- 提供自定义的下载完成回调命令
+- 提供通用配置持久化的实现
+
+## 🛠️安装依赖
+
+在使用本脚本之前，请确保你已经安装了项目所需要的依赖：
+
+```bash
+git clone https://github.com/chrisis58/kmoe-manga-downloader.git
+cd kmoe-manga-downloader
+
+pip install -r requirements.txt
+```
+
+## 📋使用方法
+
+### 1. 登录 `kmoe`
+
+首先需要登录 `kox.moe` 并保存登录状态（Cookie）。
+
+```bash
+python kmdr.py login -u <your_username> -p <your_password>
+```
+
+或者：
+
+```bash
+python kmdr.py login -u <your_username>
+```
+
+第二种方式会在程序运行时获取登录密码。如果登录成功，会同时显示当前登录用户及配额。
+
+### 2. 下载漫画书籍
+
+你可以通过以下命令下载指定书籍或卷：
+
+```bash
+# 在 path/to/destination 目录下载第一、二、三卷
+python kmdr.py download -d path/to/destination --book-url https://kox.moe/c/50076.htm --volume 1,2,3
+python kmdr.py download -d path/to/destination --book-url https://kox.moe/c/50076.htm -v 1-3
+```
+
+```bash
+# 在 path/to/download/destination 目录下载全部番外篇
+python kmdr.py download -d path/to/destination --book-url https://kox.moe/c/50076.htm --vol-type extra -v all
+```
+
+#### 常用参数说明：
+
+- `-d`, `--dest`: 下载的目标目录，在此基础上会额外添加一个为书籍名称的子目录
+- `-l`, `--book-url`: 指定书籍的主页地址
+- `-v`, `--volume`: 指定卷的名称，多个名称使用逗号分隔，`all` 表示下载所有卷
+- `-t`, `--vol-type`: 卷类型，`vol`: 单行本（默认）；`extra`: 番外；`seri`: 连载话；`all`: 全部
+- `-p`, `--proxy`: 代理服务器地址
+- `-r`, `--retry`: 下载失败时的重试次数
+- `-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
+
+> 完整的参数说明可以从 `help` 指令中获取。
+
+### 3. 查看账户状态
+
+查看当前账户信息（例如：账户名和配额等）：
+
+```bash
+python kmdr.py status
+```
+
+### 4. 回调函数
+
+你可以设置一个回调函数，下载完成后执行。回调可以是任何你想要的命令：
+
+```bash
+python kmdr.py download -d path/to/destination --book-url https://kox.moe/c/50076.htm -v 1-3 \
+	--callback "echo '{b.name} {v.name} downloaded!' >> ~/kmdr.log"
+```
+
+> 字符串模板会直接朴素地替换，卷名或者书名可能会包含空格，推荐使用引号包含避免出现错误。
+
+`{b.name}, {v.name}` 会被分别替换为书籍和卷的名称。常用参数：
+
+| 变量名   | 描述           |
+| -------- | -------------- |
+| v.name   | 卷的名称       |
+| v.page   | 卷的页数       |
+| v.size   | 卷的文件大小   |
+| b.name   | 对应漫画的名字 |
+| b.author | 对应漫画的作者 |
+
+> 完整的可用参数请参考 [structure.py](https://github.com/chrisis58/kmdr/blob/main/core/structure.py#L11) 中关于 `VolInfo` 的定义。
+
+### 5. 持久化配置
+
+重复设置下载的代理服务器、目标路径等参数，可能会降低脚本的使用效率。所以脚本也提供了通用配置的持久化命令：
+
+```bash
+python kmdr.py config --set proxy=http://localhost:7890 dest=/path/to/destination
+python kmdr.py config -s num_workers=5 "callback=echo '{b.name} {v.name} downloaded!' >> ~/kmdr.log"
+```
+
+只需要配置一次即可对之后的所有的下载指令生效。
+
+> 注意：这里的参数名称不可以使用简写，例如 `dest` 不可用使用 `d` 来替换。
+
+同时，你也可以使用以下命令进行持久化配置的管理：
+
+- `-l`, `--list-option`: 显示当前存在的各个配置
+- `-s`, `--set`: 设置持久化的配置，键和值通过 `=` 分隔，设置多个配置可以通过空格间隔
+- `-c`, `--clear`: 清除配置，`all`: 清除所有；`cookie`: 退出登录；`option`: 清除持久化的配置
+- `-d`, `--delete`, `--unset`: 清除单项配置
+
+> 当前仅支持部分下载参数的持久化：`num_workers`, `dest`, `retry`, `callback`, `proxy`
+
+## ⚠️ 声明
+
+- 本工具仅作学习、研究、交流使用，使用本工具的用户应自行承担风险
+- 作者不对使用本工具导致的任何损失、法律纠纷或其他后果负责
+- 作者不对用户使用本工具的行为负责，包括但不限于用户违反法律或任何第三方权益的行为
+
+---
+
+<div align=center> 
+💬任何使用中遇到的问题、希望添加的功能，都欢迎提交 issue 或开 discussion 交流！<br />
+⭐ 如果这个项目对你有帮助，请给它一个星标！<br /> <br /> 
+<img src="https://counter.seku.su/cmoe?name=kmdr&theme=mbs" />
+</div>
+

kmoe_manga_downloader-1.0.0/pyproject.toml

@@ -0,0 +1,37 @@
+[project]
+name = "kmoe-manga-downloader"
+version = "1.0.0"
+authors = [
+    { name="Chris Zheng", email="chrisis58@outlook.com" },
+]
+description = "A CLI-downloader for site @kox.moe."
+readme = "README.md"
+requires-python = ">=3.9"
+license = { file="LICENSE" }
+keywords = ["manga", "downloader", "kmoe"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+
+dependencies = [
+    "beautifulsoup4>=4.11.1,<5.0.0",
+    "requests>=2.32.3,<3.0.0",
+    "tqdm>=4.67.1,<5.0.0",
+    "cloudscraper>=1.2.71,<2.0.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/chrisis58/kmoe-manga-downloader"
+Issues = "https://github.com/chrisis58/kmoe-manga-downloader/issues"
+
+[project.scripts]
+kmdr = "kmdr.main:entry_point"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.pytest.ini_options]
+pythonpath = "src"

kmoe_manga_downloader-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

kmoe_manga_downloader-1.0.0/src/kmdr/core/__init__.py

@@ -0,0 +1,5 @@
+from .bases import Authenticator, Lister, Picker, Downloader, Configurer
+from .structure import VolInfo, BookInfo, VolumeType
+from .bases import AUTHENTICATOR, LISTERS, PICKERS, DOWNLOADER, CONFIGURER
+
+from .defaults import argument_parser

kmoe_manga_downloader-1.0.0/src/kmdr/core/bases.py

@@ -0,0 +1,113 @@
+import os
+
+from typing import Callable, Optional
+
+from .registry import Registry
+from .structure import VolInfo, BookInfo
+from .utils import get_singleton_session, construct_callback
+from .defaults import Configurer as InnerConfigurer
+
+class SessionContext:
+
+    def __init__(self, *args, **kwargs):
+        super().__init__()
+        self._session = get_singleton_session()
+
+class ConfigContext:
+
+    def __init__(self, *args, **kwargs):
+        super().__init__()
+        self._configurer = InnerConfigurer()
+
+class Configurer(ConfigContext):
+
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+    
+    def operate(self) -> None: ...
+
+class Authenticator(SessionContext, ConfigContext):
+
+    def __init__(self, proxy: Optional[str] = None, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+
+        if proxy:
+            self._session.proxies.update({
+                'https': proxy,
+                'http': proxy,
+            })
+
+    # 在使用代理登录时，可能会出现问题，但是现在还不清楚是不是代理的问题。
+    # 主站正常情况下不使用代理也能登录成功。但是不排除特殊的网络环境下需要代理。
+    # 所以暂时保留代理登录的功能，如果后续确认是代理的问题，可以考虑启用 @no_proxy 装饰器。
+    # @no_proxy
+    def authenticate(self) -> bool:
+        return self._authenticate()
+
+    def _authenticate(self) -> bool: ...
+
+class Lister(SessionContext):
+
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+
+    def list(self) -> tuple[BookInfo, list[VolInfo]]: ...
+
+class Picker(SessionContext):
+
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+
+    def pick(self, volumes: list[VolInfo]) -> list[VolInfo]: ...
+
+class Downloader(SessionContext):
+
+    def __init__(self, 
+            dest: str = '.',
+            callback: Optional[str] = None,
+            retry: int = 3,
+            num_workers: int = 1,
+            proxy: Optional[str] = None,
+            *args, **kwargs
+    ):
+        super().__init__(*args, **kwargs)
+        self._dest: str = dest
+        self._callback: Optional[Callable[[BookInfo, VolInfo], int]] = construct_callback(callback)
+        self._retry: int = retry
+        self._num_workers: int = num_workers
+
+        if proxy:
+            self._session.proxies.update({
+                'https': proxy,
+                'http': proxy,
+            })
+
+    def download(self, book: BookInfo, volumes: list[VolInfo]):
+        if volumes is None or not volumes:
+            raise ValueError("No volumes to download")
+
+        if self._num_workers <= 1:
+            for volume in volumes:
+                self._download(book, volume, self._retry)
+        else:
+            self._download_with_multiple_workers(book, volumes, self._retry)
+
+    def _download(self, book: BookInfo, volume: VolInfo, retry: int): ...
+
+    def _download_with_multiple_workers(self, book: BookInfo, volumes: list[VolInfo], retry: int):
+        from concurrent.futures import ThreadPoolExecutor
+
+        max_workers = min(self._num_workers, len(volumes))
+        with ThreadPoolExecutor(max_workers=max_workers) as executor:
+            futures = [
+                executor.submit(self._download, book, volume, retry)
+                for volume in volumes
+            ]
+            for future in futures:
+                future.result()
+
+AUTHENTICATOR = Registry[Authenticator]('Authenticator')
+LISTERS = Registry[Lister]('Lister')
+PICKERS = Registry[Picker]('Picker')
+DOWNLOADER = Registry[Downloader]('Downloader', True)
+CONFIGURER = Registry[Configurer]('Configurer')

kmoe_manga_downloader-1.0.0/src/kmdr/core/defaults.py

@@ -0,0 +1,154 @@
+import os
+import json
+from typing import Optional
+import argparse
+
+from .utils import singleton
+from .structure import Config
+
+parser: Optional[argparse.ArgumentParser] = None
+args: Optional[argparse.Namespace] = None
+
+def argument_parser():
+    global parser
+    if parser is not None:
+        return parser
+
+    parser = argparse.ArgumentParser(description='Kox Downloader')
+    subparsers = parser.add_subparsers(title='subcommands', dest='command')
+
+    download_parser = subparsers.add_parser('download', help='Download books')
+    download_parser.add_argument('-d', '--dest', type=str, help='Download destination, default to current directory', required=False)
+    download_parser.add_argument('-l', '--book-url', type=str, help='Book page\'s url', required=False)
+    download_parser.add_argument('-v', '--volume', type=str, help='Volume(s), split using commas, `all` for all', required=False)
+    download_parser.add_argument('-t', '--vol-type', type=str, help='Volume type, `vol` for volume, `extra` for extras, `seri` for serialized', required=False, choices=['vol', 'extra', 'seri', 'all'], default='vol')
+    download_parser.add_argument('--max-size', type=float, help='Max size of volume in MB', required=False)
+    download_parser.add_argument('--limit', type=int, help='Limit number of volumes to download', required=False)
+    download_parser.add_argument('--num-workers', type=int, help='Number of workers to use for downloading', required=False)
+    download_parser.add_argument('-p', '--proxy', type=str, help='Proxy server', required=False)
+    download_parser.add_argument('-r', '--retry', type=int, help='Retry times', required=False)
+    download_parser.add_argument('-c', '--callback', type=str, help='Callback script, use as `echo {v.name} downloaded!`', required=False)
+
+    login_parser = subparsers.add_parser('login', help='Login to kox.moe')
+    login_parser.add_argument('-u', '--username', type=str, help='Your username', required=True)
+    login_parser.add_argument('-p', '--password', type=str, help='Your password', required=False)
+
+    status_parser = subparsers.add_parser('status', help='Show status of account and script')
+    status_parser.add_argument('-p', '--proxy', type=str, help='Proxy server', required=False)
+
+    config_parser = subparsers.add_parser('config', help='Configure the downloader')
+    config_parser.add_argument('-l', '--list-option', action='store_true', help='List all configurations')
+    config_parser.add_argument('-s', '--set', nargs='+', type=str, help='Configuration options to set, e.g. num_workers=3 dest=.')
+    config_parser.add_argument('-c', '--clear', type=str, help='Clear configurations, `all`, `cookie`, `option` are available')
+    config_parser.add_argument('-d', '--delete', '--unset', dest='unset', type=str, help='Delete a specific configuration option')
+
+    return parser
+
+def parse_args():
+    global args
+    if args is not None:
+        return args
+
+    parser = argument_parser()
+    args = parser.parse_args()
+
+    if args.command is None:
+        parser.print_help()
+        exit(1)
+
+    return args
+
+@singleton
+class Configurer:
+
+    def __init__(self):
+        self.__filename = '.kmdr'
+
+        if not os.path.exists(os.path.join(os.path.expanduser("~"), self.__filename)):
+            self._config = Config()
+            self.update()
+        else:
+            with open(os.path.join(os.path.expanduser("~"), self.__filename), 'r') as f:
+                config = json.load(f)
+
+            self._config = Config()
+            option = config.get('option', None)
+            if option is not None and isinstance(option, dict):
+                self._config.option = option
+            cookie = config.get('cookie', None)
+            if cookie is not None and isinstance(cookie, dict):
+                self._config.cookie = cookie
+
+    @property
+    def config(self) -> 'Config':
+        return self._config
+    
+    @property
+    def cookie(self) -> Optional[dict]:
+        if self._config is None:
+            return None
+        return self._config.cookie
+    
+    @cookie.setter
+    def cookie(self, value: Optional[dict[str, str]]):
+        if self._config is None:
+            self._config = Config()
+        self._config.cookie = value
+        self.update()
+    
+    @property
+    def option(self) -> Optional[dict]:
+        if self._config is None:
+            return None
+        return self._config.option
+    
+    @option.setter
+    def option(self, value: Optional[dict[str, any]]):
+        if self._config is None:
+            self._config = Config()
+        self._config.option = 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)
+    
+    def clear(self, key: str):
+        if key == 'all':
+            self._config = Config()
+        elif key == 'cookie':
+            self._config.cookie = None
+        elif key == 'option':
+            self._config.option = None
+        else:
+            raise ValueError(f"Unsupported clear option: {key}")
+
+        self.update()
+    
+    def set_option(self, key: str, value: any):
+        if self._config.option is None:
+            self._config.option = {}
+
+        self._config.option[key] = value
+        self.update()
+    
+    def unset_option(self, key: str):
+        if self._config.option is None or key not in self._config.option:
+            return
+        
+        del self._config.option[key]
+        self.update()
+
+def __combine_args(dest: argparse.Namespace, option: dict) -> argparse.Namespace:
+    if option is None:
+        return dest
+
+    for key, value in option.items():
+        if hasattr(dest, key) and getattr(dest, key) is None:
+            setattr(dest, key, value)
+    return dest
+
+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)