用途：为 Python 编写浏览器自动化代码提供 2026 年推荐的 Playwright 异步模式，覆盖从安装到调试的常见环节，适合网页抓取、自动化操作、表单填写、会话保持与测试辅助等场景。
主要能力：给出 async_api 基础模式（async_playwright 上下文、launch、new_page、goto）；持久化上下文 launch_persistent_context 保存 cookies、localStorage、IndexedDB 到磁盘；推荐使用 Locator 选择器（get_by_role、get_by_text、get_by_placeholder、get_by_test_id、locator），并说明 Playwright 会在交互前自动等待元素可见可操作；导航可 wait_until 指定 domcontentloaded 或 networkidle；提供拟人化输入与滚动示例；内容提取支持 text_content、locator.all()、get_attribute；截图与调试支持 full_page 截图、元素截图与 page.pause()；错误处理捕获 PlaywrightTimeout；也可用 storage_state 保存与恢复会话。
必要用法：版本为 playwright==1.58.0，Python >= 3.9（新项目建议 3.12）。安装命令为 uv add playwright，随后执行 python -m playwright install firefox，或在使用 Camoufox 时执行 python -m camoufox fetch。使用 Camoufox 时直接传 persistent_context= 参数。
限制与注意事项：异步代码中不使用 time.sleep()、不用 query_selector 与 evaluate() 点击、不用硬编码等待，异步 FastAPI 路由中不使用同步 API。提取第三方页面内容时需先清理与校验，不可信 DOM 内容是间接提示注入途径。