webapp-testing

webapp-testing 技能是一个专业级工具组，专为开发人员与质量保证 (QA) 工程师设计，用于自动化、调试与验证本地开发环境中的 Web 界面。通过利用 Playwright 框架，此技能允许代理程序与动态 Web 应用程序互动、撷取浏览器截图、分析控制台日志，并以程式化方式执行复杂的 UI 操作。它通过提供强大的辅助脚本来管理本地服务器的生命周期，简化了设置过程，确保在自动化任务开始前，后端与前端皆已准备就绪。

主要功能与能力包括：

• 原生 Playwright 整合，用于高保真浏览器自动化与 DOM 操作。
• 通过专用辅助脚本进行多服务器生命周期管理，支持复杂技术堆叠的并行测试。
• 自动化侦察工作流程，使代理程序能检测渲染状态、通过截图分析识别选择器，并等待 networkidle 事件。
• 支持调试 UI 行为、日志撷取，以及处理静态 HTML 与动态 JavaScript 密集型应用程序。
• 基于模式的决策能力，可根据应用程序复杂度选择直接 HTML 解析或完整的浏览器互动。

使用说明与实践细节：

• 优先将随附的辅助脚本作为黑盒工具使用，以管理服务器依赖性；使用 --help 参数来了解个别脚本功能。
• 对于动态 Web 应用程序，务必调用 wait_for_load_state('networkidle')，以防止在检测或互动前发生 DOM 竞争条件。
• 在侦察过程中，利用全页截图与 DOM 检查内容来识别稳定选择器（如 roles、labels 或 IDs），而非脆弱的定位坐标。
• 遵循建议的决策树：对于静态资产，直接解析；对于动态应用，确保在执行自动化脚本前已使用提供的工具初始化服务器。
• 注意上下文窗口限制；将大型自动化脚本视为模块化组件，仅导入当前任务绝对需要的内容。