1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
// Copyright (c) 2025-2026 Kirky.X🌠
// SPDX-License-Identifier: Apache-2.0
//! 代理提供者抽象(DIP 违反)
//!
//! `ReqwestEngine` 不再直接依赖具体 `ProxyPool`,改为依赖 `ProxyProvider` trait。
//! 这样:
//! - 未来可扩展 `NoopProvider`(不使用代理)、`ChainedProvider`(多池链路)等
//! - 测试时可注入 mock provider,无需构造完整 ProxyPool
//!
//! `ProxyCategory` 与 `ProxyProvider` 同文件定义:trait 方法签名引用 `ProxyCategory`,
//! 逻辑上属于 trait 的命名空间。具体 `impl ProxyProvider for ProxyPool` 位于
//! [`crate::engines::proxy_pool`] 模块(impl block 与 struct 定义同文件)。
/// 代理类别(§12.3:媒体 vs HTML 走不同子池)
/// 代理提供者抽象
///
/// 所有方法签名与 `ProxyPool` 现有方法一一对应,便于直接 impl。
///
/// # ISP
///
/// `mark_failure` / `mark_success` 提供默认空实现,让不需要状态回填的实现
/// (如 `NoopProvider`)只需实现 `next` / `sticky`,不被逼着实现不需要的方法。