novel-downloader 1.4.5__py3-none-any.whl → 2.0.0__py3-none-any.whl

novel_downloader/core/searchers/xiguashuwu.py

@@ -0,0 +1,95 @@
+#!/usr/bin/env python3
+"""
+novel_downloader.core.searchers.xiguashuwu
+------------------------------------------
+
+"""
+
+import logging
+
+from lxml import html
+
+from novel_downloader.core.searchers.base import BaseSearcher
+from novel_downloader.core.searchers.registry import register_searcher
+from novel_downloader.models import SearchResult
+
+logger = logging.getLogger(__name__)
+
+
+@register_searcher(
+    site_keys=["xiguashuwu"],
+)
+class XiguashuwuSearcher(BaseSearcher):
+    site_name = "xiguashuwu"
+    priority = 500
+    BASE_URL = "https://www.xiguashuwu.com"
+    SEARCH_URL = "https://www.xiguashuwu.com/search/{query}"
+
+    @classmethod
+    async def _fetch_html(cls, keyword: str) -> str:
+        url = cls.SEARCH_URL.format(query=cls._quote(keyword))
+        headers = {
+            "Referer": "https://www.xiguashuwu.com/search/",
+        }
+        try:
+            async with (await cls._http_get(url, headers=headers)) as resp:
+                return await cls._response_to_str(resp)
+        except Exception:
+            logger.error(
+                "Failed to fetch HTML for keyword '%s' from '%s'",
+                keyword,
+                cls.SEARCH_URL,
+            )
+            return ""
+
+    @classmethod
+    def _parse_html(cls, html_str: str, limit: int | None = None) -> list[SearchResult]:
+        doc = html.fromstring(html_str)
+        rows = doc.xpath('//div[@class="SHsectionThree-middle"]/p')
+        results: list[SearchResult] = []
+
+        for idx, row in enumerate(rows):
+            href = cls._first_str(
+                row.xpath(".//a[starts-with(@href,'/book/')][1]/@href")
+            ) or cls._first_str(row.xpath(".//a[1]/@href"))
+            if not href:
+                continue
+
+            if limit is not None and idx >= limit:
+                break
+
+            # '/book/184974/iszip/0/' -> "184974"
+            book_id = href.split("/book/")[-1].split("/")[0]
+            book_url = cls._abs_url(href)
+
+            title = (
+                cls._first_str(
+                    row.xpath(".//a[starts-with(@href,'/book/')][1]//text()")
+                )
+                or cls._first_str(row.xpath(".//a[1]//text()"))
+                or "-"
+            )
+
+            author = (
+                cls._first_str(
+                    row.xpath(".//a[starts-with(@href,'/writer/')][1]//text()")
+                )
+                or cls._first_str(row.xpath(".//a[2]//text()"))
+                or "-"
+            )
+
+            results.append(
+                SearchResult(
+                    site=cls.site_name,
+                    book_id=book_id,
+                    book_url=book_url,
+                    cover_url="-",
+                    title=title,
+                    author=author,
+                    latest_chapter="-",
+                    update_date="-",
+                    word_count="-",
+                    priority=cls.priority + idx,
+                )
+            )
+        return results

novel_downloader/core/searchers/xs63b.py

@@ -0,0 +1,104 @@
+#!/usr/bin/env python3
+"""
+novel_downloader.core.searchers.xs63b
+-------------------------------------
+
+"""
+
+import logging
+
+from lxml import html
+
+from novel_downloader.core.searchers.base import BaseSearcher
+from novel_downloader.core.searchers.registry import register_searcher
+from novel_downloader.models import SearchResult
+
+logger = logging.getLogger(__name__)
+
+
+@register_searcher(
+    site_keys=["xs63b"],
+)
+class Xs63bSearcher(BaseSearcher):
+    site_name = "xs63b"
+    priority = 30
+    BASE_URL = "https://www.xs63b.com"
+    SEARCH_URL = "https://www.xs63b.com/search/"
+
+    @classmethod
+    async def _fetch_html(cls, keyword: str) -> str:
+        headers = {
+            "Host": "www.xs63b.com",
+            "Origin": "https://www.xs63b.com",
+            "Referer": "https://www.xs63b.com/",
+        }
+        try:
+            async with (await cls._http_get(cls.BASE_URL, headers=headers)) as resp:
+                base_html = await cls._response_to_str(resp)
+            data = {
+                "_token": cls._parse_token(base_html),
+                "kw": keyword,
+            }
+            async with (
+                await cls._http_post(cls.SEARCH_URL, data=data, headers=headers)
+            ) as resp:
+                return await cls._response_to_str(resp)
+        except Exception:
+            logger.error(
+                "Failed to fetch HTML for keyword '%s' from '%s'",
+                keyword,
+                cls.SEARCH_URL,
+            )
+            return ""
+
+    @classmethod
+    def _parse_html(cls, html_str: str, limit: int | None = None) -> list[SearchResult]:
+        doc = html.fromstring(html_str)
+        rows = doc.xpath("//div[@class='toplist']/ul/li")
+        results: list[SearchResult] = []
+
+        for idx, row in enumerate(rows):
+            href = cls._first_str(row.xpath(".//p[@class='s1']/a[1]/@href"))
+            if not href:
+                continue
+
+            if limit is not None and idx >= limit:
+                break
+
+            # 'https://www.xs63b.com/{catalog}/{name}/' -> "{catalog}-{name}"
+            book_id = href.split("xs63b.com", 1)[-1].strip(" /").replace("/", "-")
+            book_url = cls._abs_url(href)
+
+            title = "".join(row.xpath(".//p[@class='s1']//a//text()"))
+
+            latest_chapter = (
+                cls._first_str(row.xpath(".//p[@class='s2']//a/text()")) or "-"
+            )
+            author = cls._first_str(row.xpath(".//p[@class='s3']/text()")) or "-"
+            word_count = cls._first_str(row.xpath(".//p[@class='s4']/text()")) or "-"
+            update_date = cls._first_str(row.xpath(".//p[@class='s6']/text()")) or "-"
+
+            # Compute priority
+            prio = cls.priority + idx
+
+            results.append(
+                SearchResult(
+                    site=cls.site_name,
+                    book_id=book_id,
+                    book_url=book_url,
+                    cover_url="",
+                    title=title,
+                    author=author,
+                    latest_chapter=latest_chapter,
+                    update_date=update_date,
+                    word_count=word_count,
+                    priority=prio,
+                )
+            )
+        return results
+
+    @staticmethod
+    def _parse_token(html_str: str) -> str:
+        doc = html.fromstring(html_str)
+        vals = doc.xpath("//div[@id='search']//input[@name='_token']/@value")
+        return vals[0].strip() if vals else ""

novel_downloader/locales/en.json

@@ -1,111 +1,59 @@
 {
-  "cli_help": "Novel Downloader CLI tool.",
+  "help_cli": "Novel Downloader CLI tool.",
   "help_config": "Path to config file",
-  "help_download": "Download novels",
+  "help_download": "Download full novels by book IDs.",
   "help_clean": "Clean cache and configuration files",
   "help_export": "Export downloaded novels",
+  "help_search": "search for a book on one or more sites",
 
-  "settings_help": "Configure downloader settings.",
-  "settings_set_lang_help": "Switch language between Chinese and English.",
-  "settings_set_config_help": "Set and save a custom YAML configuration file.",
-  "settings_update_rules_help": "Update site rules from a TOML/YAML/JSON file.",
-  "settings_init_help": "Initialize default config and rule files in the current directory.",
-  "settings_init_force_help": "Force overwrite if file already exists.",
-  "settings_init_exists": "File already exists: {filename}",
-  "settings_init_confirm_overwrite": "Do you want to overwrite {filename}?",
-  "settings_init_skip": "Skipped: {filename}",
-  "settings_init_copy": "Copied: {filename}",
-  "settings_init_overwrite": "Overwriting existing file: {filename}",
-  "settings_init_error": "Failed to copy {filename}: {err}",
-  "settings_set_lang": "Language switched to {lang}",
-  "settings_set_config": "Configuration file saved from {path}",
-  "settings_set_config_fail": "Failed to save config file: {err}",
-  "settings_update_rules": "Site rules updated from {path}",
-  "settings_update_rules_fail": "Failed to update site rules: {err}",
-  "settings_set_cookies_help": "Set cookies for a specific site.",
-  "settings_set_cookies_prompt_site": "Site identifier (e.g. 'qidian')",
-  "settings_set_cookies_prompt_payload": "Cookie payload (JSON or 'k=v; k2=v2')",
-  "settings_set_cookies_success": "Cookies for site '{site}' have been updated.",
-  "settings_set_cookies_fail": "Failed to set cookies: {err}",
-  "settings_add_hash_help": "Add image hashes manually or from file",
-  "settings_add_hash_path_help": "JSON path mapping image to label",
-  "settings_add_hash_prompt_img": "Image path",
-  "settings_add_hash_prompt_label": "Label for image",
-  "settings_add_hash_prompt_tip": "Enter image path and label. Leave blank or type 'exit' to finish.",
-  "settings_add_hash_path_invalid": "Path does not exist. Try again.",
-  "settings_add_hash_added": "Added image '{img}' under label '{label}'",
-  "settings_add_hash_failed": "Failed to add image: {err}",
-  "settings_add_hash_loaded": "Added images from mapping file: {path}",
-  "settings_add_hash_load_fail": "Failed to load image map: {err}",
-  "settings_add_hash_saved": "Image hash store saved",
+  "config_set_lang_help": "Switch language between Chinese and English.",
+  "config_set_config_help": "Set and save a custom YAML configuration file.",
+  "config_init_help": "Initialize default config and rule files in the current directory.",
+  "config_init_force_help": "Force overwrite if file already exists.",
+  "config_init_exists": "File already exists: {filename}",
+  "config_init_confirm_overwrite": "Do you want to overwrite {filename}?",
+  "config_init_skip": "Skipped: {filename}",
+  "config_init_copy": "Copied: {filename}",
+  "config_init_overwrite": "Overwriting existing file: {filename}",
+  "config_init_error": "Failed to copy {filename}: {err}",
+  "config_set_lang": "Language switched to {lang}",
+  "config_set_config": "Configuration file saved from {path}",
+  "config_set_config_fail": "Failed to save config file: {err}",
 
-  "interactive_help": "Interactive mode for novel selection and preview.",
-  "interactive_option_download": "Download novels",
-  "interactive_browse_help": "Browse available novels interactively.",
-  "interactive_prompt_book_ids": "Enter book IDs to download, separated by spaces",
-  "interactive_preview_help": "Preview chapters before downloading.",
-  "interactive_no_sub": "No subcommand provided. Please select an action:",
-  "interactive_option_browse": "Browse novels",
-  "interactive_option_preview": "Preview chapters",
-  "interactive_option_exit": "Exit",
-  "interactive_prompt_choice": "Enter your choice",
-  "interactive_browse_start": "Starting interactive browser...",
-  "interactive_preview_start": "Previewing chapters...",
-  "interactive_exit": "Exiting.",
-
-  "download_help": "Download full novels by book IDs.",
-  "download_short_help": "Download novels",
+  "download_progress_prefix": "Download progress",
   "download_option_site": "Website source, default is '{default}'.",
-  "download_using_config": "Using config: {path}",
   "download_site_info": "Site: {site}",
-  "download_site_mode": "Mode: {mode}",
   "download_no_ids": "No book IDs provided. Exiting.",
   "download_fail_get_ids": "Failed to get book IDs from config: {err}",
+  "download_config_load_fail": "Failed to load config: {err}",
   "download_only_example": "Only example book IDs found (e.g. '{example}').",
   "download_edit_config": "Please edit your config and replace them with real book IDs.",
   "download_downloading": "Downloading book {book_id} from {site}...",
-  "download_prompt_parse": "Parse...",
+  "download_login_failed": "Download login failed: please check your cookies or account credentials and try again.",
   "download_book_ids": "One or more book IDs to process",
   "download_option_start": "Start chapter ID (applies to the first book ID only)",
   "download_option_end": "End chapter ID (applies to the first book ID only)",
+  "download_option_no_export": "Do not export after download; download only.",
+  "download_export_skipped": "Download-only mode: export step will be skipped.",
+
   "login_description": "Description",
   "login_hint": "Hint",
-  "login_manual_prompt": ">> Please complete login in your browser and press Enter to continue...",
   "login_use_config": "Using value from config.",
   "login_enter_password": "Enter password: ",
   "login_enter_cookie": "Enter cookies: ",
   "login_enter_value": "Enter value: ",
   "login_required_field": "This field is required. Please enter a value.",
 
-  "login_prompt_intro": "Manual login is required. Please switch to the browser and log in.",
-  "login_prompt_press_enter": "Attempt {attempt}/{max_retries}: Press Enter after completing login in the browser...",
-
-  "session_login_prompt_intro": "Failed to restore login from saved cookies. Please log in via browser, then paste the cookie string below.",
-  "session_login_prompt_paste_cookie": "Attempt {attempt}/{max_retries}: Paste your browser cookie string and press Enter:",
-  "session_login_prompt_invalid_cookie": "Invalid cookie. Please copy and paste again.",
-  "session_login_failed": "Login to {site} failed. Please check your credentials or try again later.",
-
   "clean_logs": "Clean log directory",
   "clean_cache": "Clean scripts and browser cache",
-  "clean_state": "Clean state files (state.json)",
-  "clean_data": "Clean data files (e.g. image hashes, browser data)",
-  "clean_config": "Clean config files (e.g. settings.toml, site rules)",
-  "clean_models": "Clean downloaded model cache",
-  "clean_hf_cache": "Clear Hugging Face model cache",
-  "clean_hf_cache_done": "Hugging Face cache cleared",
-  "clean_hf_cache_fail": "Failed to clear Hugging Face cache: {err}",
-  "clean_hf_model": "Clear cached model from Hugging Face",
-  "clean_hf_model_done": "Cache for model '{repo}' has been cleared",
-  "clean_hf_model_not_found": "No local cache found for model '{repo}'",
-  "clean_hf_model_fail": "Failed to clear model cache: {err}",
-  "clean_hf_cache_all": "Clear all Hugging Face model and dataset cache",
-  "clean_hf_cache_all_done": "All Hugging Face cache cleared",
-  "clean_hf_cache_all_fail": "Failed to clear Hugging Face cache: {err}",
+  "clean_data": "Clean data files",
+  "clean_config": "Clean config files",
   "clean_all": "Clean all settings, cache, and state files",
   "clean_yes": "Skip confirmation prompt",
-  "clean_confirm": "Are you sure you want to delete all local data? (y/N)",
+  "clean_confirm": "Are you sure you want to delete all local data?",
   "clean_nothing": "No clean option specified",
   "clean_deleted": "Deleted",
+  "clean_failed": "Failed to delete: {path}",
   "clean_not_found": "Not found",
   "clean_cancelled": "Clean operation cancelled",
 
@@ -114,5 +62,14 @@
   "export_success_txt": "Successfully exported {book_id} as TXT.",
   "export_failed_txt": "Failed to export {book_id} as TXT: {err}",
   "export_success_epub": "Successfully exported {book_id} as EPUB.",
-  "export_failed_epub": "Failed to export {book_id} as EPUB: {err}"
+  "export_failed_epub": "Failed to export {book_id} as EPUB: {err}",
+
+  "search_sites_help": "which site keys to search (default: all)",
+  "search_keyword_help": "keyword to look for",
+  "search_limit_help": "Maximum number of search results",
+  "search_site_limit_help": "Maximum number of search results per site",
+  "search_timeout_help": "Per-request timeout in seconds (default: {secs})",
+
+  "no_results": "No results found.",
+  "prompt_select_index": "Select a book by number (or press Enter to cancel)"
 }

novel_downloader/locales/zh.json

@@ -1,109 +1,57 @@
 {
-  "cli_help": "小说下载器 CLI 工具",
+  "help_cli": "小说下载器 CLI 工具",
   "help_config": "配置文件路径",
-  "help_download": "下载小说",
+  "help_download": "按书籍 ID 下载小说",
   "help_clean": "清理缓存和配置文件",
   "help_export": "导出已下载的小说",
+  "help_search": "在一个或多个站点搜索书籍",
 
-  "settings_help": "配置下载器设置",
-  "settings_set_lang_help": "在中文和英文之间切换语言",
-  "settings_set_config_help": "设置并保存自定义 YAML 配置文件",
-  "settings_update_rules_help": "从 TOML/YAML/JSON 文件更新站点规则",
-  "settings_init_help": "在当前目录初始化默认配置和规则文件",
-  "settings_init_force_help": "如果文件已存在则强制覆盖",
-  "settings_init_exists": "文件已存在: {filename}",
-  "settings_init_confirm_overwrite": "你确定要覆盖 {filename} 吗?",
-  "settings_init_skip": "文件已存在: {filename}, 已跳过",
-  "settings_init_copy": "已复制默认文件: {filename}",
-  "settings_init_overwrite": "已覆盖现有文件: {filename}",
-  "settings_init_error": "复制 {filename} 失败: {err}",
-  "settings_set_lang": "语言已切换为 {lang}",
-  "settings_set_config": "已从 {path} 保存配置文件",
-  "settings_set_config_fail": "保存配置文件失败: {err}",
-  "settings_update_rules": "已从 {path} 更新站点规则",
-  "settings_update_rules_fail": "更新站点规则失败: {err}",
-  "settings_set_cookies_help": "为特定站点设置 Cookie",
-  "settings_set_cookies_prompt_site": "站点标识 (例如 'qidian')",
-  "settings_set_cookies_prompt_payload": "Cookie 内容 (JSON 或 'k=v; k2=v2')",
-  "settings_set_cookies_success": "已更新站点 '{site}' 的 Cookie",
-  "settings_set_cookies_fail": "设置 Cookie 失败: {err}",
-  "settings_add_hash_help": "手动或通过文件添加图像哈希",
-  "settings_add_hash_path_help": "映射图片路径到标签的 JSON 文件路径",
-  "settings_add_hash_prompt_img": "图片路径",
-  "settings_add_hash_prompt_label": "该图片对应的标签",
-  "settings_add_hash_prompt_tip": "请输入图片路径和标签, 输入空行或 'exit' 退出",
-  "settings_add_hash_path_invalid": "路径不存在, 请重试",
-  "settings_add_hash_added": "已添加图片 '{img}', 标签为 '{label}'",
-  "settings_add_hash_failed": "添加图片失败: {err}",
-  "settings_add_hash_loaded": "已从映射文件导入图片: {path}",
-  "settings_add_hash_load_fail": "加载映射文件失败: {err}",
-  "settings_add_hash_saved": "图像哈希库已保存",
+  "config_set_lang_help": "在中文和英文之间切换语言",
+  "config_set_config_help": "设置并保存自定义 YAML 配置文件",
+  "config_init_help": "在当前目录初始化默认配置和规则文件",
+  "config_init_force_help": "如果文件已存在则强制覆盖",
+  "config_init_exists": "文件已存在: {filename}",
+  "config_init_confirm_overwrite": "你确定要覆盖 {filename} 吗?",
+  "config_init_skip": "文件已存在: {filename}, 已跳过",
+  "config_init_copy": "已复制默认文件: {filename}",
+  "config_init_overwrite": "已覆盖现有文件: {filename}",
+  "config_init_error": "复制 {filename} 失败: {err}",
+  "config_set_lang": "语言已切换为 {lang}",
+  "config_set_config": "已从 {path} 保存配置文件",
+  "config_set_config_fail": "保存配置文件失败: {err}",
 
-  "interactive_help": "小说选择和预览的交互式模式",
-  "interactive_option_download": "下载小说",
-  "interactive_browse_help": "以交互方式浏览可用小说",
-  "interactive_prompt_book_ids": "请输入要下载的书籍 ID, 用空格分隔",
-  "interactive_preview_help": "下载前预览章节",
-  "interactive_no_sub": "未提供子命令请选择一项操作:",
-  "interactive_option_browse": "浏览小说",
-  "interactive_option_preview": "预览章节",
-  "interactive_option_exit": "退出",
-  "interactive_prompt_choice": "请输入你的选择",
-  "interactive_browse_start": "启动交互式浏览器...",
-  "interactive_preview_start": "正在预览章节...",
-  "interactive_exit": "正在退出",
-
-  "download_help": "按书籍 ID 下载完整小说",
-  "download_short_help": "下载小说",
+  "download_progress_prefix": "下载进度",
   "download_option_site": "网站来源, 默认为 '{default}'",
-  "download_using_config": "使用配置: {path}",
   "download_site_info": "站点: {site}",
-  "download_site_mode": "使用模式: {mode}",
   "download_no_ids": "未提供书籍 ID, 正在退出",
   "download_fail_get_ids": "从配置获取书籍 ID 失败: {err}",
+  "download_config_load_fail": "加载配置失败: {err}",
   "download_only_example": "只发现示例书籍 ID (例如 '{example}')",
   "download_edit_config": "请编辑配置并将示例 ID 替换为真实书籍 ID",
   "download_downloading": "正在从 {site} 下载书籍 {book_id}...",
-  "download_prompt_parse": "结束...",
+  "download_login_failed": "登录失败: 请检查您的 Cookie 或账户信息后重试",
   "download_book_ids": "要处理的一个或多个小说 ID",
   "download_option_start": "起始章节 ID (仅用于第一个书籍 ID)",
   "download_option_end": "结束章节 ID (仅用于第一个书籍 ID)",
+  "download_option_no_export": "仅下载 (不进行导出)",
+  "download_export_skipped": "仅下载模式: 将跳过导出步骤",
+
   "login_description": "说明",
   "login_hint": "提示",
-  "login_manual_prompt": ">> 请在浏览器中完成登录后按回车继续...",
   "login_use_config": "使用配置中的默认值",
   "login_enter_password": "请输入密码: ",
   "login_enter_cookie": "请输入 Cookie: ",
   "login_enter_value": "请输入值: ",
   "login_required_field": "该字段是必填项, 请重新输入",
 
-  "login_prompt_intro": "需要手动登录, 请切换到浏览器窗口完成登录",
-  "login_prompt_press_enter": "第 {attempt}/{max_retries} 次尝试: 请在浏览器中完成登录后按回车键...",
-
-  "session_login_prompt_intro": "尝试使用历史 Cookie 恢复登录失败, 请在浏览器登录后从开发者工具复制 Cookie 粘贴至下方",
-  "session_login_prompt_paste_cookie": "第 {attempt}/{max_retries} 次尝试, 请粘贴 Cookie 字符串并回车:",
-  "session_login_prompt_invalid_cookie": "Cookie 格式不正确, 请重新复制粘贴",
-  "session_login_failed": "登录 {site} 失败, 请检查账号或稍后再试",
-
+  "clean_failed": "删除失败: {path}",
   "clean_logs": "清理日志目录",
   "clean_cache": "清理脚本和浏览器缓存",
-  "clean_state": "清理状态文件 (state.json)",
-  "clean_data": "清理数据文件 (如 image hashes, 浏览器数据)",
-  "clean_config": "清理配置文件 (如 settings.toml 和规则)",
-  "clean_models": "清理模型缓存目录",
-  "clean_hf_cache": "清理 Hugging Face 下载缓存",
-  "clean_hf_cache_done": "已清除 Hugging Face 本地缓存",
-  "clean_hf_cache_fail": "清除 Hugging Face 缓存失败: {err}",
-  "clean_hf_model": "清理 Hugging Face 中模型缓存",
-  "clean_hf_model_done": "已清除模型 '{repo}' 的缓存",
-  "clean_hf_model_not_found": "未发现模型 '{repo}' 的本地缓存",
-  "clean_hf_model_fail": "清理模型缓存失败: {err}",
-  "clean_hf_cache_all": "清理所有 Hugging Face 模型与数据集缓存",
-  "clean_hf_cache_all_done": "已清除所有 Hugging Face 缓存",
-  "clean_hf_cache_all_fail": "清除 Hugging Face 缓存失败: {err}",
+  "clean_data": "清理数据文件",
+  "clean_config": "清理配置文件",
   "clean_all": "清理所有配置, 缓存与状态",
   "clean_yes": "跳过确认提示",
-  "clean_confirm": "确认要删除所有本地数据? (y/N)",
+  "clean_confirm": "确认要删除所有本地数据?",
   "clean_nothing": "未指定任何要清理的内容",
   "clean_deleted": "已删除",
   "clean_not_found": "未找到",
@@ -111,8 +59,17 @@
 
   "export_format_help": "导出格式: txt、epub 或 all",
   "export_processing": "正在导出小说 {book_id}, 格式: {format}",
-  "export_success_txt": "成功将 {book_id} 导出为 TXT。",
+  "export_success_txt": "成功将 {book_id} 导出为 TXT",
   "export_failed_txt": "导出 {book_id} 为 TXT 失败: {err}",
   "export_success_epub": "成功将 {book_id} 导出为 EPUB",
-  "export_failed_epub": "导出 {book_id} 为 EPUB 失败: {err}"
+  "export_failed_epub": "导出 {book_id} 为 EPUB 失败: {err}",
+
+  "search_sites_help": "要搜索的站点键 (默认为全部)",
+  "search_keyword_help": "要搜索的关键字",
+  "search_limit_help": "总体搜索结果数量上限",
+  "search_site_limit_help": "单站点搜索结果数量上限",
+  "search_timeout_help": "每次请求的超时时间 (秒) (默认：{secs})",
+
+  "no_results": "未找到结果",
+  "prompt_select_index": "通过编号选择书籍 (或按回车取消)"
 }

novel_downloader/models/__init__.py

@@ -3,64 +3,37 @@
 novel_downloader.models
 -----------------------
 
+Data models and configuration classes.
 """
 
-from .browser import NewContextOptions
-from .chapter import ChapterDict
-from .config import (
-    BookConfig,
-    DownloaderConfig,
-    ExporterConfig,
-    FetcherConfig,
-    ParserConfig,
-)
-from .login import LoginField
-from .site_rules import (
-    BookInfoRules,
-    FieldRules,
-    RuleStep,
-    SiteProfile,
-    SiteRules,
-    SiteRulesDict,
-    VolumesRules,
-)
-from .tasks import (
-    CidTask,
-    HtmlTask,
-    RestoreTask,
-)
-from .types import (
-    BrowserType,
-    LogLevel,
-    ModeType,
-    SaveMode,
-    SplitMode,
-    StorageBackend,
-)
-
 __all__ = [
-    "NewContextOptions",
     "BookConfig",
     "DownloaderConfig",
     "ParserConfig",
     "FetcherConfig",
     "ExporterConfig",
+    "TextCleanerConfig",
+    "BookInfoDict",
     "ChapterDict",
+    "ChapterInfoDict",
+    "VolumeInfoDict",
     "LoginField",
-    "BrowserType",
-    "ModeType",
-    "SaveMode",
-    "StorageBackend",
-    "SplitMode",
-    "LogLevel",
-    "BookInfoRules",
-    "FieldRules",
-    "RuleStep",
-    "SiteProfile",
-    "SiteRules",
-    "SiteRulesDict",
-    "VolumesRules",
-    "CidTask",
-    "HtmlTask",
-    "RestoreTask",
+    "SearchResult",
 ]
+
+from .book import (
+    BookInfoDict,
+    ChapterDict,
+    ChapterInfoDict,
+    VolumeInfoDict,
+)
+from .config import (
+    BookConfig,
+    DownloaderConfig,
+    ExporterConfig,
+    FetcherConfig,
+    ParserConfig,
+    TextCleanerConfig,
+)
+from .login import LoginField
+from .search import SearchResult

novel_downloader/models/book.py

@@ -0,0 +1,44 @@
+#!/usr/bin/env python3
+"""
+novel_downloader.models.book
+----------------------------
+
+"""
+
+from typing import Any, NotRequired, TypedDict
+
+
+class ChapterDict(TypedDict):
+    id: str
+    title: str
+    content: str
+    extra: dict[str, Any]
+
+
+class ChapterInfoDict(TypedDict):
+    title: str
+    url: str
+    chapterId: str
+
+
+class VolumeInfoDict(TypedDict):
+    volume_name: str
+    volume_cover: NotRequired[str]
+    update_time: NotRequired[str]
+    word_count: NotRequired[str]
+    volume_intro: NotRequired[str]
+    chapters: list[ChapterInfoDict]
+
+
+class BookInfoDict(TypedDict):
+    book_name: str
+    author: str
+    cover_url: str
+    update_time: str
+    summary: str
+    extra: dict[str, Any]
+    volumes: list[VolumeInfoDict]
+    tags: NotRequired[list[str]]
+    word_count: NotRequired[str]
+    serial_status: NotRequired[str]
+    summary_brief: NotRequired[str]