All use English uniformly

Author: 3-Tokisaki-Kurumi

README.md

@@ -13,12 +13,7 @@
     <a href="https://deepwiki.com/autoscrape-labs/pydoll"><img src="https://deepwiki.com/badge.svg" alt="Ask DeepWiki"></a>
 </p>
 
-<p align="center">
-  <!-- Language Switch | 语言切换 -->
-  <strong>🌍 Language:</strong> 
-  <a href="#english">English</a> • 
-  <a href="#中文">中文</a>
-</p>
+
 
 <p align="center">
   <a href="https://autoscrape-labs.github.io/pydoll/">Documentation</a> •
@@ -32,8 +27,6 @@
 
 ---
 
-<div id="english">
-
 ## Key Features
 
 🎭 **Advanced Browser Fingerprint Spoofing** - Revolutionary one-click fingerprint protection system  
@@ -518,346 +511,7 @@ Every bit of support makes a difference — thank you!
 
 Pydoll is licensed under the [MIT License](LICENSE).
 
-</div>
-
----
-
-<div id="中文">
-
-## 主要特性
-
-🎭 **先进的浏览器指纹伪装** - 革命性的一键指纹保护系统  
-🔹 **零WebDriver依赖！** 告别WebDriver兼容性噩梦  
-🔹 **原生验证码绕过！** 平滑处理Cloudflare Turnstile和reCAPTCHA v3*  
-🔹 **异步性能** 实现闪电般快速的自动化  
-🔹 **类人交互** 模拟真实用户行为  
-🔹 **强大的事件系统** 用于响应式自动化  
-🔹 **多浏览器支持** 包括Chrome和Edge
-
-## 为什么存在Pydoll
-
-想象一下：您需要自动化浏览器任务。也许是测试您的Web应用程序、从网站抓取数据或自动化重复流程。传统上，这意味着要处理外部驱动程序、复杂配置以及看似无处不在的兼容性问题。
-
-但还有一个更大的挑战：**现代Web保护系统**。浏览器指纹识别技术、Cloudflare Turnstile验证码、reCAPTCHA v3以及能够立即识别和阻止传统自动化工具的复杂机器人检测算法。您精心编写的自动化脚本失败不是因为错误，而是因为网站可以跟踪您独特的浏览器指纹并识别出这不是人类。
-
-**Pydoll就是为改变这种情况而生的。**
-
-Pydoll采用不同的理念从头构建，直接连接到Chrome DevTools协议（CDP），完全消除了对外部驱动程序的需求。更重要的是，它融合了先进的浏览器指纹伪装和智能验证码绕过功能，使您的自动化几乎无法与真实的人类交互区分开来。
-
-## Pydoll的特别之处
-
-- **🎭 革命性指纹伪装**：一键激活生成真实的随机化浏览器指纹，欺骗甚至复杂的跟踪系统。涵盖所有主要指纹技术，包括WebGL、Canvas、音频、Navigator属性等。
-
-- **智能验证码绕过**：内置自动解决Cloudflare Turnstile和reCAPTCHA v3验证码，无需外部服务、API密钥或复杂配置。
-
-- **真正的人类交互**：先进算法模拟真实的人类行为模式。
-
-- **真正的简单性**：我们不希望您浪费时间配置驱动程序或处理兼容性问题。
-
-- **原生异步性能**：从头开始使用`asyncio`构建。
-
-- **强大的网络监控**：轻松拦截、修改和分析所有网络流量。
-
-- **事件驱动架构**：实时响应页面事件、网络请求和用户交互。
-
-- **直观的元素查找**：现代化的`find()`和`query()`方法。
-
-- **强大的类型安全**：全面的类型系统，提供更好的IDE支持。
-
-## 安装
-
-### 从 PyPI 安装（标准版本）
-
-```bash
-pip install pydoll-python
-```
-
-### 从 GitHub 安装（增强版本，带指纹伪装功能）
-
-对于带有先进浏览器指纹伪装功能的增强版本：
-
-```bash
-# 安装最新的增强版本，带有指纹伪装功能
-pip install git+https://github.com/3-Tokisaki-Kurumi/pydoll-enhance.git
-
-# 或安装特定版本/分支
-pip install git+https://github.com/3-Tokisaki-Kurumi/pydoll-enhance.git@main
-```
-
-就这样。无需下载驱动程序，无需复杂配置。只需安装即可开始使用先进的保护绕过功能的自动化。
-
-## 浏览器指纹伪装
-
-### 概述
-
-Pydoll的增强版本包含革命性的浏览器指纹伪装功能。此功能为网站用于跟踪和识别自动化脚本的浏览器指纹技术提供全面保护。
-
-### 主要特性
-
-- 🎭 **一键启用** - 用单个参数启用完整的指纹保护
-- 🔄 **智能生成** - 自动生成随机但真实的浏览器指纹
-- 🛡️ **全面防护** - 覆盖所有主要指纹向量
-- 💾 **指纹持久化** - 保存和重用指纹配置
-- ⚙️ **高度可定制** - 微调指纹特征
-- 🚀 **无缝集成** - 与现有代码透明地工作
-
-### 指纹伪装快速开始
-
-```python
-import asyncio
-from pydoll.fingerprint import Chrome
-
-async def fingerprint_protected_automation():
-    # 用一个参数启用指纹伪装
-    async with Chrome(enable_fingerprint_spoofing=True) as browser:
-        tab = await browser.start()
-        
-        # 您的自动化以完全伪装的指纹运行
-        await tab.go_to('https://fingerprintjs.github.io/fingerprintjs/')
-        
-        # 检查生成的指纹
-        summary = browser.get_fingerprint_summary()
-        print("当前指纹:", summary)
-
-asyncio.run(fingerprint_protected_automation())
-```
-
-### 高级指纹配置
-
-```python
-from pydoll.fingerprint import Chrome, FingerprintConfig
-
-async def custom_fingerprint_automation():
-    # 创建自定义指纹配置
-    config = FingerprintConfig(
-        browser_type="chrome",
-        preferred_os="windows",
-        min_screen_width=1920,
-        max_screen_width=1920,
-        min_screen_height=1080,
-        max_screen_height=1080,
-        enable_webgl_spoofing=True,
-        enable_canvas_spoofing=True,
-        enable_audio_spoofing=True,
-    )
-    
-    async with Chrome(
-        enable_fingerprint_spoofing=True,
-        fingerprint_config=config
-    ) as browser:
-        tab = await browser.start()
-        await tab.go_to('https://amiunique.org/fp')
-
-asyncio.run(custom_fingerprint_automation())
-```
-
-### 指纹保护技术
-
-此增强版本伪装以下指纹技术：
-
-#### 🔧 Navigator 属性
-- 具有真实浏览器版本的User-Agent字符串
-- 平台信息（Windows、macOS、Linux）
-- 语言设置和偏好
-- 硬件并发和设备内存
-- 浏览器插件及其详细信息
-
-#### 🖥️ 屏幕和显示属性
-- 屏幕分辨率和可用尺寸
-- 颜色深度和像素密度
-- 窗口内部/外部尺寸
-- 设备像素比
-
-#### 🎨 WebGL 指纹
-- WebGL供应商和渲染器信息
-- 支持的WebGL扩展
-- WebGL参数值
-- 显卡信息伪装
-
-#### 🖼️ Canvas 指纹
-- Canvas渲染结果操作
-- 图像数据噪声注入
-- 文本渲染变化
-
-#### 🔊 音频指纹
-- AudioContext采样率伪装
-- 音频处理特征
-- 声音合成变化
-
-#### 🛡️ 反检测功能
-- 移除`navigator.webdriver`属性
-- 隐藏自动化相关对象
-- 伪装`toString`方法结果
-- 绕过常见检测脚本
-
-### 测试您的指纹保护
-
-访问这些网站验证您的指纹伪装是否工作：
-
-1. **FingerprintJS演示**: https://fingerprintjs.github.io/fingerprintjs/
-2. **AmIUnique**: https://amiunique.org/fp
-3. **BrowserLeaks**: https://browserleaks.com/javascript
-
-每个浏览器会话都应生成唯一、真实的指纹。
-
-## 快速开始
-
-### 您的第一个自动化
-
-让我们从简单的开始。下面的代码打开浏览器，导航到网站并与元素交互：
-
-```python
-import asyncio
-from pydoll.browser import Chrome
-
-async def my_first_automation():
-    # 创建浏览器实例
-    async with Chrome() as browser:
-        # 启动浏览器并获取标签页
-        tab = await browser.start()
-        
-        # 导航到网站
-        await tab.go_to('https://example.com')
-        
-        # 直观地查找元素
-        button = await tab.find(tag_name='button', class_name='submit')
-        await button.click()
-        
-        # 或直接使用CSS选择器/XPath
-        link = await tab.query('a[href*="contact"]')
-        await link.click()
-
-# 运行自动化
-asyncio.run(my_first_automation())
-```
-
-### 自定义配置
-
-有时您需要更多控制。Pydoll提供灵活的配置选项：
-
-```python
-from pydoll.browser import Chrome
-from pydoll.browser.options import ChromiumOptions
-
-async def custom_automation():
-    # 配置浏览器选项
-    options = ChromiumOptions()
-    options.add_argument('--proxy-server=username:password@ip:port')
-    options.add_argument('--window-size=1920,1080')
-    options.add_argument('--disable-web-security')
-    options.binary_location = '/path/to/your/browser'
-
-    async with Chrome(options=options) as browser:
-        tab = await browser.start()
-        
-        # 您的自动化代码在这里
-        await tab.go_to('https://example.com')
-        
-        # 浏览器现在使用您的自定义设置
-
-asyncio.run(custom_automation())
-```
-
-## 高级功能
-
-### 智能验证码绕过
-
-Pydoll最具革命性的功能之一是能够自动处理通常阻止自动化工具的现代验证码系统。这不仅仅是解决验证码 - 而是让您的自动化对保护系统完全透明。
-
-**支持的验证码类型：**
-- **Cloudflare Turnstile** - reCAPTCHA的现代替代品
-- **reCAPTCHA v3** - Google的隐形验证码系统
-- **自定义实现** - 新验证码类型的可扩展框架
-
-```python
-import asyncio
-from pydoll.browser import Chrome
-
-async def advanced_captcha_bypass():
-    async with Chrome() as browser:
-        tab = await browser.start()
-        
-        # 方法1：上下文管理器（等待验证码完成）
-        async with tab.expect_and_bypass_cloudflare_captcha():
-            await tab.go_to('https://site-with-cloudflare.com')
-            print("Cloudflare Turnstile 自动解决！")
-            
-            # 继续您的自动化 - 验证码已处理
-            await tab.find(id='username').type_text('user@example.com')
-            await tab.find(id='password').type_text('password123')
-            await tab.find(tag_name='button', text='Login').click()
-        
-        # 方法2：后台处理（非阻塞）
-        await tab.enable_auto_solve_cloudflare_captcha()
-        await tab.go_to('https://another-protected-site.com')
-        # 验证码在后台自动解决，代码继续执行
-        
-        # 方法3：特定实现的自定义验证码选择器
-        await tab.enable_auto_solve_cloudflare_captcha(
-            custom_selector=(By.CLASS_NAME, 'custom-captcha-widget'),
-            time_before_click=3,  # 解决前等待3秒
-            time_to_wait_captcha=10  # 10秒后超时
-        )
-        
-        await tab.disable_auto_solve_cloudflare_captcha()
-
-asyncio.run(advanced_captcha_bypass())
-```
-
-**为什么这很重要：**
-- **无外部依赖**：无需验证码解决服务或API密钥
-- **成本效益**：消除月度验证码解决服务费用
-- **可靠**：无需依赖第三方可用性即可一致工作
-- **快速**：即时解决，无需到外部服务的网络延迟
-- **无缝集成**：验证码绕过在您的自动化流程中透明进行
-
-### 高级元素查找
-
-Pydoll提供多种直观的方式来查找元素。无论您喜欢如何工作，我们都有适合您的方法：
-
-```python
-import asyncio
-from pydoll.browser import Chrome
-
-async def element_finding_examples():
-    async with Chrome() as browser:
-        tab = await browser.start()
-        await tab.go_to('https://example.com')
-        
-        # 按属性查找（最直观）
-        submit_btn = await tab.find(
-            tag_name='button',
-            class_name='btn-primary',
-            text='Submit'
-        )
-        
-        # 按ID查找
-        username_field = await tab.find(id='username')
-        
-        # 查找多个元素
-        all_links = await tab.find(tag_name='a', find_all=True)
-        
-        # CSS选择器和XPath
-        nav_menu = await tab.query('nav.main-menu')
-        specific_item = await tab.query('//div[@data-testid="item-123"]')
-        
-        # 带超时和错误处理
-        delayed_element = await tab.find(
-            class_name='dynamic-content',
-            timeout=10,
-            raise_exc=False  # 如果未找到则返回None
-        )
-        
-        # 高级：自定义属性
-        custom_element = await tab.find(
-            data_testid='submit-button',
-            aria_label='Submit form'
-        )
-
-asyncio.run(element_finding_examples())
-```
 
-</div>
 
 <p align="center">
   <b>Pydoll</b> — Making browser automation magical!

pyproject.toml

@@ -54,6 +54,8 @@ exclude = ['tests', 'tests/*']
 [tool.pytest.ini_options]
 pythonpath = "."
 addopts = '-p no:warnings'
+asyncio_mode = "auto"
+asyncio_default_fixture_loop_scope = "function"
 
 [tool.taskipy.tasks]
 lint = 'ruff check .; ruff check . --diff'