CloakBrowser Humanize 行为层深度解析

# 来自 __init__.py 的修补流程简化示意
page._original = originals  # 保存原始方法
page._human_cfg = cfg       # 保存 humanize 配置
page.click = _human_click   # 替换为 humanize 版本
page.fill = _human_fill
# ... 更多方法替换

# careful 预设的关键区别（来自 _careful_config() 函数）
careful = HumanConfig(
    typing_delay=100,          # 更慢打字
    typing_delay_spread=50,
    typing_pause_chance=0.15,  # 更多思考暂停
    mouse_overshoot_chance=0.10,
    click_aim_delay_input=(80, 180),   # 更长瞄准时间
    click_aim_delay_button=(120, 280),
    scroll_pause_fast=(100, 200),      # 更慢滚动
    idle_between_actions=True,          # 动作间空闲微移动
    idle_between_duration=(0.4, 1.0),  # 空闲时长（秒）
)

def _bezier(p0: Point, p1: Point, p2: Point, p3: Point, t: float) -> Point:
    """计算三次贝塞尔曲线上的点。"""
    u = 1 - t
    uu = u * u
    uuu = uu * u
    tt = t * t
    ttt = tt * t
    return Point(
        uuu * p0.x + 3 * uu * t * p1.x + 3 * u * tt * p2.x + ttt * p3.x,
        uuu * p0.y + 3 * uu * t * p1.y + 3 * u * tt * p2.y + ttt * p3.y,
    )

def _random_control_points(start: Point, end: Point) -> Tuple[Point, Point]:
    dx = end.x - start.x
    dy = end.y - start.y
    dist = math.hypot(dx, dy) or 1
    px = -dy / dist      # 垂直方向单位向量
    py = dx / dist
    bias1 = rand(-0.3, 0.3) * dist  # 随机偏移量
    bias2 = rand(-0.3, 0.3) * dist
    return (
        Point(start.x + dx * 0.25 + px * bias1, start.y + dy * 0.25 + py * bias1),
        Point(start.x + dx * 0.75 + px * bias2, start.y + dy * 0.75 + py * bias2),
    )

def _ease_in_out(t: float) -> float:
    """三次缓入缓出函数。"""
    if t < 0.5:
        return 4 * t * t * t
    return 1 - pow(-2 * t + 2, 3) / 2

# 在路径点添加随机抖动
wobble_amp = math.sin(math.pi * progress) * cfg.mouse_wobble_max
wx = pt.x + (random.random() - 0.5) * 2 * wobble_amp
wy = pt.y + (random.random() - 0.5) * 2 * wobble_amp

# 过冲：有 15% 概率略微超过目标再拉回
if random.random() < cfg.mouse_overshoot_chance:
    overshoot_dist = rand_range(cfg.mouse_overshoot_px)
    angle = math.atan2(end_y - start_y, end_x - start_x)
    raw.move(round(end_x + math.cos(angle) * overshoot_dist),
             round(end_y + math.sin(angle) * overshoot_dist))
    sleep_ms(rand(30, 70))
    raw.move(round(end_x + (random.random() - 0.5) * 4),
             round(end_y + (random.random() - 0.5) * 4))

burst_counter += 1
if burst_counter >= burst_size and i < steps:
    sleep_ms(rand_range(cfg.mouse_burst_pause))
    burst_counter = 0

def human_type(page, raw, text, cfg, cdp_session=None):
    for i, ch in enumerate(text):
        # 非 ASCII 字符（Cyrillic, CJK, emoji）— 使用 insertText
        if not ch.isascii():
            sleep_ms(rand_range(cfg.key_hold))
            raw.insert_text(ch)
            if i < len(text) - 1:
                _inter_char_delay(cfg)
            continue
 
        # 错字模拟
        if random.random() < cfg.mistype_chance and ch.isalnum():
            wrong = _get_nearby_key(ch)
            _type_normal_char(raw, wrong, cfg)
            sleep_ms(rand_range(cfg.mistype_delay_notice))
            raw.down("Backspace")
            sleep_ms(rand_range(cfg.key_hold))
            raw.up("Backspace")
            sleep_ms(rand_range(cfg.mistype_delay_correct))
 
        # 处理大写字母
        if ch.isupper() and ch.isalpha():
            _type_shifted_char(page, raw, ch, cfg)
        # 处理 Shift 符号
        elif ch in SHIFT_SYMBOLS:
            _type_shift_symbol(page, raw, ch, cfg, cdp_session)
        else:
            _type_normal_char(raw, ch, cfg)
 
        if i < len(text) - 1:
            _inter_char_delay(cfg)

def _inter_char_delay(cfg):
    """模拟打字节奏的变化。"""
    base = cfg.typing_delay
    spread = cfg.typing_delay_spread
    delay = base + random.gauss(0, spread)  # 正态分布延迟
    sleep_ms(max(10, delay))
 
    # 思考暂停：有 10% 概率在打字中途"思考"
    if random.random() < cfg.typing_pause_chance:
        sleep_ms(rand_range(cfg.typing_pause_range))

_neighbors = {
    'a': 'sqwz', 'b': 'vghn', 'c': 'xdfv', 'd': 'sfecx',
    # ... 更多键盘邻近映射
}
 
def _get_nearby_key(ch: str) -> str:
    """返回相邻按键上的随机字符（模拟打字错误）。"""
    lower = ch.lower()
    if lower in NEARBY_KEYS:
        neighbors = NEARBY_KEYS[lower]
        wrong = random.choice(neighbors)
        return wrong.upper() if ch.isupper() else wrong
    return ch

加速 → 巡航 → 减速 → 过冲 → 修正 → 稳定

# 加速阶段
if i < accel_steps:
    delta = rand(80, 100)
    pause = rand_range(cfg.scroll_pause_slow)
# 减速阶段
elif i >= total_clicks - decel_steps:
    delta = rand(60, 90)
    pause = rand_range(cfg.scroll_pause_slow)
# 巡航阶段
else:
    delta = rand_range(cfg.scroll_delta_base)
    pause = rand_range(cfg.scroll_pause_fast)

def _smooth_wheel(raw: RawMouse, delta: int, cfg: HumanConfig) -> None:
    """将一个逻辑滚动分解为一系列小滚轮事件（模拟真实惯性）。"""
    abs_d = abs(delta)
    sign = 1 if delta > 0 else -1
    sent = 0
    while sent < abs_d:
        step_size = rand(20, 40)
        chunk = min(step_size, abs_d - sent)
        raw.wheel(0, round(chunk) * sign)
        sent += chunk
        sleep_ms(rand(8, 20))

# 过冲：有 10% 概率滚过目标然后拉回
if random.random() < cfg.scroll_overshoot_chance:
    overshoot_px = round(rand_range(cfg.scroll_overshoot_px)) * direction
    _smooth_wheel(raw, overshoot_px, cfg)
    sleep_ms(rand_range(cfg.scroll_settle_delay))
    corrections = rand_int_range((1, 2))
    for _ in range(corrections):
        corr_delta = round(rand(40, 80)) * -direction
        _smooth_wheel(raw, corr_delta, cfg)
        sleep_ms(rand(100, 250))

# 使用 CDP 隔离世界执行 DOM 查询
class _SyncIsolatedWorld:
    def evaluate(self, expression: str) -> Any:
        # 通过 CDP 的 Page.createIsolatedWorld 创建隔离上下文
        # 评估结果不会在 Error.stack 中留下 "eval at evaluate :302:" 痕迹
        ...

from cloakbrowser import launch_async
 
browser = await launch_async(
    headless=False,
    humanize=True,
    human_config={
        "mistype_chance": 0.05,          # 5% 错字率
        "typing_delay": 120,             # 更慢打字（120ms/字符）
        "typing_pause_chance": 0.15,     # 更多思考暂停
        "idle_between_actions": True,    # 动作间空闲微移动
        "idle_between_duration": [0.5, 1.5],  # 空闲时长（秒）
        "mouse_overshoot_chance": 0.20,  # 更多过冲
        "scroll_overshoot_chance": 0.15, # 更多滚动过冲
    }
)

page.fill("input#email", "user@example.com",
          human_config={"typing_delay": 200, "mistype_chance": 0.1})

# 原始方法（无 humanize）用于快速操作
page._original.fill("input#quantity", "100")
page._original.click("button#submit")