Struct Engine 

pub struct Engine { /* private fields */ }

书源运行时引擎。

Implementations

impl Engine

pub fn new(source: BookSource) -> Result<Self>

用默认 reqwest 取页后端构建。

pub fn with_fetcher(source: BookSource, fetcher: Arc<dyn Fetcher>) -> Self

注入自定义取页后端(测试替身 / 反爬适配器)构建。 这是唯一真实构造器:共享字段(登录态/cookie 库/作用域变量)的默认初始化只在此处, 其余构造器(Engine::new / with_browser_assist)一律委托,避免新增字段漏改。

pub fn with_login_header(self, login_header: BTreeMap<String, String>) -> Self

注入登录态请求头(登录后由调用方从 per-source 状态取出)。链式构造: Engine::new(src)?.with_login_header(state.login_header)。空 map 等同未登录。

pub fn with_cookies(self, persistent: &BTreeMap<String, String>) -> Self

用持久化 cookie(注册域 -> "k=v",来自 per-source 状态)初始化 cookie 库。链式构造。

pub fn persistent_cookies(&self) -> BTreeMap<String, String>

导出当前 cookie 库中的 persistent cookie(注册域 -> "k=v"),供调用方落盘。 session cookie 不导出(重启失效)。

pub fn with_book_vars(self, book_vars: BTreeMap<String, String>) -> Self

注入书籍级捕获变量(scope=book,来自 per-book 快照)。链式构造(贴 Engine::with_login_header)。

pub fn with_source_vars(self, source_vars: &BTreeMap<String, String>) -> Self

合并书源级捕获变量(scope=source,来自 per-source 状态)。链式构造。

pub fn book_vars(&self) -> BTreeMap<String, String>

导出书籍级捕获变量,供 app 随 per-book 快照落盘(scope=book 跨会话复用的承载)。

pub fn source_vars(&self) -> BTreeMap<String, String>

导出书源级捕获变量,供 app 落盘(可选;默认构建为进程内)。

pub fn source(&self) -> &BookSource

暴露只读配置。

pub fn source_url(&self) -> &str

书源 URL(per-source 登录态文件的 key,供 app 回写 persistent cookie 落盘时定位)。

pub async fn warmup(&self)

预热:按 http.warmup 先访问若干页以累积会话 cookie(失败忽略)。 走 Engine::run_request 统一管线——enabledCookieJar 时预热页的 Set-Cookie 才会回灌引擎 cookie 库(loginCheckJs 在预热页可能误判,但错误被吞,不影响预热语义)。

pub async fn book_info(&self, book_url: &str) -> Result<BookInfo>

书籍详情(可选前置请求链 → 取详情页 → 抽取)。

pub async fn toc(&self, toc_url: &str) -> Result<Toc>

目录(章节 + 分卷),支持前置请求链 + 有界分页。

pub async fn content(&self, chapter_url: &str) -> Result<String>

正文,支持前置请求链 + 有界分页。

pub async fn search( &self, key: &str, page: u32, page_size: u32, ) -> Result<Vec<BookListItem>>

搜索。

pub async fn explore( &self, category_url: &UrlOrRule, page: u32, page_size: u32, ) -> Result<Vec<BookListItem>>

浏览某分类的某一页。

pub fn explore_categories(&self) -> Vec<Category>

浏览分类列表,供上层选择后翻页。

Trait Implementations

impl Clone for Engine

fn clone(&self) -> Engine

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Engine

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.