playwright-stealth 使用教程

项目目录结构及介绍

playwright-stealth 是一个用于绕过网站自动化检测的库，专为 Playwright 设计。以下是项目的基本目录结构及重要文件说明：

playwright-stealth/
├── LICENSE                # 许可证文件，采用MIT License。
├── README.md              # 主要的项目文档，包含了快速入门指南、安装步骤等关键信息。
├── bin                    # 存放脚本或命令行工具的目录。
│   ├── test_chrome.py     # 示例脚本，展示了如何在Chrome中使用stealth功能。
│   └── ...                # 其他可能的测试或示例脚本。
├── playwright_stealth     # 实现核心功能的Python模块。
│   ├── __init__.py       # 包初始化文件。
│   └── stealth_async.py   # 异步模式下的stealth功能实现。
├── tests                  # 测试目录，包含单元测试等相关代码。
├── pyproject.toml        # 项目元数据和依赖管理文件，用于pipenv或Poetry等现代包管理器。
├── setup.py               # 用于传统Python打包和发布的脚本。
├── requirements.txt       # 项目运行所需的第三方库列表。
└── ...

项目的启动文件介绍

此项目主要是作为一个库被导入到其他项目中，没有传统的“启动文件”。然而，用户可以通过导入playwright_stealth模块并调用其功能来开始使用。在实际应用中，用户的主程序或脚本充当“启动点”，例如：

# 用户自己的脚本可以作为启动点
from playwright.async_api import async_playwright
from playwright_stealth import stealth_async

async def main():
    async with async_playwright() as p:
        browser = await p.chromium.launch()
        page = await browser.new_page()
        await stealth_async(page)
        await page.goto('http://whatsmyuseragent.org/')
        await page.screenshot(path='example.png')
        await browser.close()

asyncio.run(main())

项目的配置文件介绍

本项目并没有直接提供一个单独的配置文件，它的配置主要通过代码中的参数传递来实现。比如，在使用stealth_async(page)时，可以通过修改页面行为间接配置隐身策略。若需特定配置（如自定义用户代理或其他规避策略），这通常需要直接在使用库时按需定制代码。

此外，虽然项目自身未强依赖外部配置文件，对于环境设置或依赖管理，可以利用pyproject.toml进行现代化的依赖声明，以及通过setup.py进行老版Python环境的兼容性配置。开发者可在这些文件中添加额外的配置指令来控制项目开发和部署环境。