novel-downloader 1.3.3__tar.gz → 1.4.1__tar.gz

{novel_downloader-1.3.3 → novel_downloader-1.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: novel-downloader
-Version: 1.3.3
+Version: 1.4.1
 Summary: A command-line tool for downloading Chinese web novels from Qidian and similar platforms.
 Author-email: Saudade Z <saudadez217@gmail.com>
 License: MIT License
@@ -34,19 +34,18 @@ Classifier: License :: OSI Approved :: MIT License
 Classifier: Natural Language :: Chinese (Simplified)
 Classifier: Topic :: Utilities
 Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
-Requires-Python: >=3.12
+Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
+Requires-Dist: textual
 Requires-Dist: requests
 Requires-Dist: aiohttp
-Requires-Dist: beautifulsoup4
-Requires-Dist: DrissionPage
-Requires-Dist: opencv-python
+Requires-Dist: playwright
 Requires-Dist: lxml
 Requires-Dist: platformdirs
-Requires-Dist: click
 Requires-Dist: ebooklib
 Provides-Extra: dev
 Requires-Dist: black; extra == "dev"
@@ -55,6 +54,8 @@ Requires-Dist: ruff; extra == "dev"
 Requires-Dist: pytest; extra == "dev"
 Requires-Dist: pytest-cov; extra == "dev"
 Requires-Dist: pytest-mock; extra == "dev"
+Requires-Dist: types-requests; extra == "dev"
+Requires-Dist: types-PyYAML; extra == "dev"
 Requires-Dist: pre-commit; extra == "dev"
 Requires-Dist: commitizen; extra == "dev"
 Provides-Extra: font-recovery
@@ -63,32 +64,19 @@ Requires-Dist: numpy; extra == "font-recovery"
 Requires-Dist: tinycss2; extra == "font-recovery"
 Requires-Dist: fonttools; extra == "font-recovery"
 Requires-Dist: brotli; extra == "font-recovery"
+Requires-Dist: opencv-python; extra == "font-recovery"
 Requires-Dist: pillow; extra == "font-recovery"
 Requires-Dist: huggingface_hub; extra == "font-recovery"
 Dynamic: license-file
 
 # novel-downloader
 
-一个基于 [DrissionPage](https://www.drissionpage.cn) 和 [requests](https://github.com/psf/requests) 的小说下载工具/库。
+一个基于 [playwright](https://playwright.dev/) 和 [aiohttp](https://github.com/aio-libs/aiohttp) 的小说下载工具/库。
 
----
-
-## 项目简介
-
-**novel-downloader** 支持多种小说网站的章节抓取与合并导出,
-- **轻量化抓取**: 绝大多数站点仅依赖 `requests` 实现 HTTP 请求, 无需额外浏览器驱动
-- 对于起点中文网 (Qidian), 可在配置中选择:
-  - `mode: session` : 纯 Requests 模式
-  - `mode: browser`  : 基于 `DrissionPage` 驱动 Chrome 的浏览器模式 (可处理更复杂的 JS/加密)。
-- **自动登录** (可选)
-  - 配置 `login_required: true` 后自动检测并重用历史 Cookie
-  - 首次登录或 Cookie 失效时:
-    - **browser** 模式: 在程序打开的浏览器窗口登录, 登录后回车继续
-    - **session** 模式: 根据提示粘贴浏览器中已登录的 Cookie (参考 [复制 Cookies](https://github.com/BowenZ217/novel-downloader/blob/main/docs/copy-cookies.md))
+> 本项目开发环境为 Python 3.12, 需确保运行环境为 Python 3.11 及以上版本
 
 ## 功能特性
 
-- 抓取起点中文网免费及已订阅章节内容
 - 支持断点续爬, 自动续传未完成任务
 - 自动整合所有章节并导出为:
   - TXT
@@ -101,25 +89,71 @@ Dynamic: license-file
 
 ## 快速开始
 
+### 安装
+
+使用 `pip` 安装:
+
 ```bash
-# 克隆 + 安装
 pip install novel-downloader
+```
+
+如需使用浏览器模式 (即 `mode: browser`), 请确保已安装 Playwright 依赖:
 
-# 如需支持字体解密功能 (decode_font), 请使用:
-# pip install novel-downloader[font-recovery]
+```bash
+playwright install
+```
 
+如需启用字体解密功能 (`decode_font`, 用于处理起点中文网对近一个月更新章节所采用的字体混淆技术), 请使用扩展安装方式:
+
+```bash
+pip install novel-downloader[font-recovery]
+```
+
+---
+
+### CLI 模式
+
+```bash
 # 初始化默认配置 (生成 settings.toml)
-novel-cli settings init
+novel-cli config init
 
 # 编辑 ./settings.toml 完成 site/book_ids 等
-# 可查看 docs/4-settings-schema.md
+# 可查看 docs/3-settings-schema.md
 
-# 运行下载
+# 执行下载任务
 novel-cli download 123456
 ```
 
-- 详细可见: [支持站点列表](https://github.com/BowenZ217/novel-downloader/blob/main/docs/6-supported-sites.md)
-- 更多使用方法, 查看 [使用示例](https://github.com/BowenZ217/novel-downloader/blob/main/docs/5-usage-examples.md)
+- 详细可见: [支持站点列表](https://github.com/BowenZ217/novel-downloader/blob/main/docs/4-supported-sites.md)
+- 更多使用方法, 查看 [使用示例](https://github.com/BowenZ217/novel-downloader/blob/main/docs/6-cli-usage-examples.md)
+
+---
+
+### TUI 模式 (终端用户界面)
+
+**注意**: TUI 模式仍在开发中, 目前尚未实现登录和修改设置等功能。建议优先使用稳定的 CLI 模式。
+
+```bash
+# 初始化默认配置 (生成 settings.toml)
+novel-cli config init
+
+# 编辑 ./settings.toml 修改网络配置
+# 可查看 docs/3-settings-schema.md
+
+# 启动 TUI 界面
+novel-tui
+```
+
+- 详细可见: [支持站点列表](https://github.com/BowenZ217/novel-downloader/blob/main/docs/4-supported-sites.md)
+- 更多使用方法, 查看 [使用示例](https://github.com/BowenZ217/novel-downloader/blob/main/docs/5-tui-usage-examples.md)
+
+---
+
+### GUI 模式 (图形界面)
+
+尚未实现
+
+---
 
 ## 从 GitHub 安装 (开发版)
 
@@ -139,11 +173,11 @@ pip install .
 
 - [项目简介](#项目简介)
 - [安装](https://github.com/BowenZ217/novel-downloader/blob/main/docs/1-installation.md)
-- [环境准备](https://github.com/BowenZ217/novel-downloader/blob/main/docs/2-environment-setup.md)
-- [配置](https://github.com/BowenZ217/novel-downloader/blob/main/docs/3-configuration.md)
-- [settings.toml 配置说明](https://github.com/BowenZ217/novel-downloader/blob/main/docs/4-settings-schema.md)
-- [使用示例](https://github.com/BowenZ217/novel-downloader/blob/main/docs/5-usage-examples.md)
-- [支持站点列表](https://github.com/BowenZ217/novel-downloader/blob/main/docs/6-supported-sites.md)
+- [配置](https://github.com/BowenZ217/novel-downloader/blob/main/docs/2-configuration.md)
+- [settings.toml 配置说明](https://github.com/BowenZ217/novel-downloader/blob/main/docs/3-settings-schema.md)
+- [支持站点列表](https://github.com/BowenZ217/novel-downloader/blob/main/docs/4-supported-sites.md)
+- [TUI 使用示例](https://github.com/BowenZ217/novel-downloader/blob/main/docs/5-tui-usage-examples.md)
+- [CLI 使用示例](https://github.com/BowenZ217/novel-downloader/blob/main/docs/6-cli-usage-examples.md)
 - [复制 Cookies](https://github.com/BowenZ217/novel-downloader/blob/main/docs/copy-cookies.md)
 - [文件保存](https://github.com/BowenZ217/novel-downloader/blob/main/docs/file-saving.md)
 - [TODO](https://github.com/BowenZ217/novel-downloader/blob/main/docs/todo.md)

{novel_downloader-1.3.3 → novel_downloader-1.4.1}/README.md

@@ -1,25 +1,11 @@
 # novel-downloader
 
-一个基于 [DrissionPage](https://www.drissionpage.cn) 和 [requests](https://github.com/psf/requests) 的小说下载工具/库。
+一个基于 [playwright](https://playwright.dev/) 和 [aiohttp](https://github.com/aio-libs/aiohttp) 的小说下载工具/库。
 
----
-
-## 项目简介
-
-**novel-downloader** 支持多种小说网站的章节抓取与合并导出,
-- **轻量化抓取**: 绝大多数站点仅依赖 `requests` 实现 HTTP 请求, 无需额外浏览器驱动
-- 对于起点中文网 (Qidian), 可在配置中选择:
-  - `mode: session` : 纯 Requests 模式
-  - `mode: browser`  : 基于 `DrissionPage` 驱动 Chrome 的浏览器模式 (可处理更复杂的 JS/加密)。
-- **自动登录** (可选)
-  - 配置 `login_required: true` 后自动检测并重用历史 Cookie
-  - 首次登录或 Cookie 失效时:
-    - **browser** 模式: 在程序打开的浏览器窗口登录, 登录后回车继续
-    - **session** 模式: 根据提示粘贴浏览器中已登录的 Cookie (参考 [复制 Cookies](https://github.com/BowenZ217/novel-downloader/blob/main/docs/copy-cookies.md))
+> 本项目开发环境为 Python 3.12, 需确保运行环境为 Python 3.11 及以上版本
 
 ## 功能特性
 
-- 抓取起点中文网免费及已订阅章节内容
 - 支持断点续爬, 自动续传未完成任务
 - 自动整合所有章节并导出为:
   - TXT
@@ -32,25 +18,71 @@
 
 ## 快速开始
 
+### 安装
+
+使用 `pip` 安装:
+
 ```bash
-# 克隆 + 安装
 pip install novel-downloader
+```
+
+如需使用浏览器模式 (即 `mode: browser`), 请确保已安装 Playwright 依赖:
 
-# 如需支持字体解密功能 (decode_font), 请使用:
-# pip install novel-downloader[font-recovery]
+```bash
+playwright install
+```
 
+如需启用字体解密功能 (`decode_font`, 用于处理起点中文网对近一个月更新章节所采用的字体混淆技术), 请使用扩展安装方式:
+
+```bash
+pip install novel-downloader[font-recovery]
+```
+
+---
+
+### CLI 模式
+
+```bash
 # 初始化默认配置 (生成 settings.toml)
-novel-cli settings init
+novel-cli config init
 
 # 编辑 ./settings.toml 完成 site/book_ids 等
-# 可查看 docs/4-settings-schema.md
+# 可查看 docs/3-settings-schema.md
 
-# 运行下载
+# 执行下载任务
 novel-cli download 123456
 ```
 
-- 详细可见: [支持站点列表](https://github.com/BowenZ217/novel-downloader/blob/main/docs/6-supported-sites.md)
-- 更多使用方法, 查看 [使用示例](https://github.com/BowenZ217/novel-downloader/blob/main/docs/5-usage-examples.md)
+- 详细可见: [支持站点列表](https://github.com/BowenZ217/novel-downloader/blob/main/docs/4-supported-sites.md)
+- 更多使用方法, 查看 [使用示例](https://github.com/BowenZ217/novel-downloader/blob/main/docs/6-cli-usage-examples.md)
+
+---
+
+### TUI 模式 (终端用户界面)
+
+**注意**: TUI 模式仍在开发中, 目前尚未实现登录和修改设置等功能。建议优先使用稳定的 CLI 模式。
+
+```bash
+# 初始化默认配置 (生成 settings.toml)
+novel-cli config init
+
+# 编辑 ./settings.toml 修改网络配置
+# 可查看 docs/3-settings-schema.md
+
+# 启动 TUI 界面
+novel-tui
+```
+
+- 详细可见: [支持站点列表](https://github.com/BowenZ217/novel-downloader/blob/main/docs/4-supported-sites.md)
+- 更多使用方法, 查看 [使用示例](https://github.com/BowenZ217/novel-downloader/blob/main/docs/5-tui-usage-examples.md)
+
+---
+
+### GUI 模式 (图形界面)
+
+尚未实现
+
+---
 
 ## 从 GitHub 安装 (开发版)
 
@@ -70,11 +102,11 @@ pip install .
 
 - [项目简介](#项目简介)
 - [安装](https://github.com/BowenZ217/novel-downloader/blob/main/docs/1-installation.md)
-- [环境准备](https://github.com/BowenZ217/novel-downloader/blob/main/docs/2-environment-setup.md)
-- [配置](https://github.com/BowenZ217/novel-downloader/blob/main/docs/3-configuration.md)
-- [settings.toml 配置说明](https://github.com/BowenZ217/novel-downloader/blob/main/docs/4-settings-schema.md)
-- [使用示例](https://github.com/BowenZ217/novel-downloader/blob/main/docs/5-usage-examples.md)
-- [支持站点列表](https://github.com/BowenZ217/novel-downloader/blob/main/docs/6-supported-sites.md)
+- [配置](https://github.com/BowenZ217/novel-downloader/blob/main/docs/2-configuration.md)
+- [settings.toml 配置说明](https://github.com/BowenZ217/novel-downloader/blob/main/docs/3-settings-schema.md)
+- [支持站点列表](https://github.com/BowenZ217/novel-downloader/blob/main/docs/4-supported-sites.md)
+- [TUI 使用示例](https://github.com/BowenZ217/novel-downloader/blob/main/docs/5-tui-usage-examples.md)
+- [CLI 使用示例](https://github.com/BowenZ217/novel-downloader/blob/main/docs/6-cli-usage-examples.md)
 - [复制 Cookies](https://github.com/BowenZ217/novel-downloader/blob/main/docs/copy-cookies.md)
 - [文件保存](https://github.com/BowenZ217/novel-downloader/blob/main/docs/file-saving.md)
 - [TODO](https://github.com/BowenZ217/novel-downloader/blob/main/docs/todo.md)

{novel_downloader-1.3.3 → novel_downloader-1.4.1}/novel_downloader/__init__.py

@@ -6,7 +6,7 @@ novel_downloader
 Core package for the Novel Downloader project.
 """
 
-__version__ = "1.3.3"
+__version__ = "1.4.1"
 
 __author__ = "Saudade Z"
 __email__ = "saudadez217@gmail.com"

novel_downloader-1.4.1/novel_downloader/cli/clean.py

@@ -0,0 +1,145 @@
+#!/usr/bin/env python3
+"""
+novel_downloader.cli.clean
+--------------------------
+
+CLI subcommands for clean resources.
+"""
+
+import shutil
+from argparse import Namespace, _SubParsersAction
+from pathlib import Path
+
+from novel_downloader.utils.constants import (
+    CONFIG_DIR,
+    DATA_DIR,
+    JS_SCRIPT_DIR,
+    LOGGER_DIR,
+    MODEL_CACHE_DIR,
+    REC_CHAR_MODEL_REPO,
+)
+from novel_downloader.utils.i18n import t
+
+
+def register_clean_subcommand(subparsers: _SubParsersAction) -> None:  # type: ignore
+    parser = subparsers.add_parser("clean", help=t("help_clean"))
+
+    parser.add_argument("--logs", action="store_true", help=t("clean_logs"))
+    parser.add_argument("--cache", action="store_true", help=t("clean_cache"))
+    parser.add_argument("--data", action="store_true", help=t("clean_data"))
+    parser.add_argument("--config", action="store_true", help=t("clean_config"))
+    parser.add_argument("--models", action="store_true", help=t("clean_models"))
+    parser.add_argument("--all", action="store_true", help=t("clean_all"))
+    parser.add_argument("-y", "--yes", action="store_true", help=t("clean_yes"))
+
+    parser.add_argument("--hf-cache", action="store_true", help=t("clean_hf_cache"))
+    parser.add_argument(
+        "--hf-cache-all", action="store_true", help=t("clean_hf_cache_all")
+    )
+
+    parser.set_defaults(func=handle_clean)
+
+
+def handle_clean(args: Namespace) -> None:
+    targets: list[Path] = []
+
+    if args.hf_cache_all:
+        try:
+            if _clean_model_repo_cache(all=True):
+                print(t("clean_hf_cache_all_done"))
+        except Exception as e:
+            print(t("clean_hf_cache_all_fail", err=str(e)))
+    elif args.hf_cache:
+        try:
+            if _clean_model_repo_cache(repo_id=REC_CHAR_MODEL_REPO):
+                print(t("clean_hf_model_done", repo=REC_CHAR_MODEL_REPO))
+            else:
+                print(t("clean_hf_model_not_found", repo=REC_CHAR_MODEL_REPO))
+        except Exception as e:
+            print(t("clean_hf_model_fail", err=str(e)))
+
+    if args.all:
+        if not args.yes:
+            confirm = prompt(t("clean_confirm"), default="n")
+            if confirm.lower() != "y":
+                print(t("clean_cancelled"))
+                return
+        targets = [
+            LOGGER_DIR,
+            JS_SCRIPT_DIR,
+            DATA_DIR,
+            CONFIG_DIR,
+            MODEL_CACHE_DIR,
+        ]
+    else:
+        if args.logs:
+            targets.append(LOGGER_DIR)
+        if args.cache:
+            targets.append(JS_SCRIPT_DIR)
+        if args.data:
+            targets.append(DATA_DIR)
+        if args.config:
+            targets.append(CONFIG_DIR)
+        if args.models:
+            targets.append(MODEL_CACHE_DIR)
+
+    if not targets and not args.hf_cache and not args.hf_cache_all:
+        print(t("clean_nothing"))
+        return
+
+    for path in targets:
+        _delete_path(path)
+
+
+def prompt(message: str, default: str = "n") -> str:
+    """
+    Prompt the user for input with a default option.
+
+    :param message: The prompt message to display to the user.
+    :param default: The default value to use if the user provides no input ("y" or "n").
+    :return: The user's input (lowercased), or the default value if no input is given.
+    """
+    try:
+        full_prompt = f"{message} [{'Y/n' if default.lower() == 'y' else 'y/N'}]: "
+        response = input(full_prompt).strip().lower()
+        return response if response else default.lower()
+    except (KeyboardInterrupt, EOFError):
+        print("\n" + "Cancelled.")
+    return default.lower()
+
+
+def _delete_path(p: Path) -> None:
+    if p.exists():
+        if p.is_file():
+            p.unlink()
+        else:
+            shutil.rmtree(p, ignore_errors=True)
+        print(f"[clean] {t('clean_deleted')}: {p}")
+    else:
+        print(f"[clean] {t('clean_not_found')}: {p}")
+
+
+def _clean_model_repo_cache(
+    repo_id: str | None = None,
+    all: bool = False,
+) -> bool:
+    """
+    Delete Hugging Face cache for a specific repo.
+    """
+    from huggingface_hub import scan_cache_dir
+
+    cache_info = scan_cache_dir()
+
+    if all:
+        targets = cache_info.repos
+    elif repo_id:
+        targets = [r for r in cache_info.repos if r.repo_id == repo_id]
+    else:
+        return False
+
+    strategy = cache_info.delete_revisions(
+        *[rev.commit_hash for r in targets for rev in r.revisions]
+    )
+    print(f"[clean] Will free {strategy.expected_freed_size_str}")
+    strategy.execute()
+    return True

novel_downloader-1.4.1/novel_downloader/cli/config.py

@@ -0,0 +1,177 @@
+#!/usr/bin/env python3
+"""
+novel_downloader.cli.config
+---------------------------
+
+CLI subcommands for configuration management.
+"""
+
+import shutil
+from argparse import Namespace, _SubParsersAction
+from importlib.resources import as_file
+from pathlib import Path
+
+from novel_downloader.config import save_config_file, save_rules_as_json
+from novel_downloader.utils.constants import DEFAULT_SETTINGS_PATHS
+from novel_downloader.utils.i18n import t
+from novel_downloader.utils.logger import setup_logging
+from novel_downloader.utils.state import state_mgr
+
+# from novel_downloader.utils.hash_store import img_hash_store
+
+
+def register_config_subcommand(subparsers: _SubParsersAction) -> None:  # type: ignore
+    parser = subparsers.add_parser("config", help=t("help_config"))
+    config_subparsers = parser.add_subparsers(dest="subcommand", required=True)
+
+    _register_init(config_subparsers)
+    _register_set_lang(config_subparsers)
+    _register_set_config(config_subparsers)
+    _register_update_rules(config_subparsers)
+    _register_set_cookies(config_subparsers)
+    # _register_add_hash(config_subparsers)
+
+
+def _register_init(subparsers: _SubParsersAction) -> None:  # type: ignore
+    parser = subparsers.add_parser("init", help=t("settings_init_help"))
+    parser.add_argument(
+        "--force", action="store_true", help=t("settings_init_force_help")
+    )
+    parser.set_defaults(func=_handle_init)
+
+
+def _register_set_lang(subparsers: _SubParsersAction) -> None:  # type: ignore
+    parser = subparsers.add_parser("set-lang", help=t("settings_set_lang_help"))
+    parser.add_argument("lang", choices=["zh", "en"], help="Language code")
+    parser.set_defaults(func=_handle_set_lang)
+
+
+def _register_set_config(subparsers: _SubParsersAction) -> None:  # type: ignore
+    parser = subparsers.add_parser("set-config", help=t("settings_set_config_help"))
+    parser.add_argument("path", type=str, help="Path to YAML config file")
+    parser.set_defaults(func=_handle_set_config)
+
+
+def _register_update_rules(subparsers: _SubParsersAction) -> None:  # type: ignore
+    parser = subparsers.add_parser("update-rules", help=t("settings_update_rules_help"))
+    parser.add_argument("path", type=str, help="Path to TOML/YAML/JSON rule file")
+    parser.set_defaults(func=_handle_update_rules)
+
+
+def _register_set_cookies(subparsers: _SubParsersAction) -> None:  # type: ignore
+    parser = subparsers.add_parser("set-cookies", help=t("settings_set_cookies_help"))
+    parser.add_argument("site", nargs="?", help="Site identifier")
+    parser.add_argument("cookies", nargs="?", help="Cookies string")
+    parser.set_defaults(func=_handle_set_cookies)
+
+
+# def _register_add_hash(subparsers: _SubParsersAction) -> None:  # type: ignore
+#     parser = subparsers.add_parser("add-hash", help=t("settings_add_hash_help"))
+#     parser.add_argument("--path", type=str, help=t("settings_add_hash_path_help"))
+#     parser.set_defaults(func=_handle_add_hash)
+
+
+def _handle_init(args: Namespace) -> None:
+    setup_logging()
+    cwd = Path.cwd()
+
+    for resource in DEFAULT_SETTINGS_PATHS:
+        target_path = cwd / resource.name
+        should_copy = True
+
+        if target_path.exists():
+            if args.force:
+                print(t("settings_init_overwrite", filename=resource.name))
+            else:
+                print(t("settings_init_exists", filename=resource.name))
+                resp = (
+                    input(
+                        t("settings_init_confirm_overwrite", filename=resource.name)
+                        + " [y/N]: "
+                    )
+                    .strip()
+                    .lower()
+                )
+                should_copy = resp == "y"
+
+        if not should_copy:
+            print(t("settings_init_skip", filename=resource.name))
+            continue
+
+        try:
+            with as_file(resource) as actual_path:
+                shutil.copy(actual_path, target_path)
+                print(t("settings_init_copy", filename=resource.name))
+        except Exception as e:
+            print(t("settings_init_error", filename=resource.name, err=str(e)))
+            raise
+
+
+def _handle_set_lang(args: Namespace) -> None:
+    state_mgr.set_language(args.lang)
+    print(t("settings_set_lang", lang=args.lang))
+
+
+def _handle_set_config(args: Namespace) -> None:
+    try:
+        save_config_file(args.path)
+        print(t("settings_set_config", path=args.path))
+    except Exception as e:
+        print(t("settings_set_config_fail", err=str(e)))
+        raise
+
+
+def _handle_update_rules(args: Namespace) -> None:
+    try:
+        save_rules_as_json(args.path)
+        print(t("settings_update_rules", path=args.path))
+    except Exception as e:
+        print(t("settings_update_rules_fail", err=str(e)))
+        raise
+
+
+def _handle_set_cookies(args: Namespace) -> None:
+    site = args.site or input(t("settings_set_cookies_prompt_site") + ": ").strip()
+    cookies = (
+        args.cookies or input(t("settings_set_cookies_prompt_payload") + ": ").strip()
+    )
+
+    try:
+        state_mgr.set_cookies(site, cookies)
+        print(t("settings_set_cookies_success", site=site))
+    except Exception as e:
+        print(t("settings_set_cookies_fail", err=str(e)))
+        raise
+
+
+# def _handle_add_hash(args: Namespace) -> None:
+#     if args.path:
+#         try:
+#             img_hash_store.add_from_map(args.path)
+#             img_hash_store.save()
+#             print(t("settings_add_hash_loaded", path=args.path))
+#         except Exception as e:
+#             print(t("settings_add_hash_load_fail", err=str(e)))
+#             raise
+#     else:
+#         print(t("settings_add_hash_prompt_tip"))
+#         while True:
+#             img_path = input(t("settings_add_hash_prompt_img") + ": ").strip()
+#             if not img_path or img_path.lower() in {"exit", "quit"}:
+#                 break
+#             if not Path(img_path).exists():
+#                 print(t("settings_add_hash_path_invalid"))
+#                 continue
+
+#             label = input(t("settings_add_hash_prompt_label") + ": ").strip()
+#             if not label or label.lower() in {"exit", "quit"}:
+#                 break
+
+#             try:
+#                 img_hash_store.add_image(img_path, label)
+#                 print(t("settings_add_hash_added", img=img_path, label=label))
+#             except Exception as e:
+#                 print(t("settings_add_hash_failed", err=str(e)))
+
+#         img_hash_store.save()
+#         print(t("settings_add_hash_saved"))