技能介绍

自动化调试中的常见痛点

在浏览器自动化场景中，我们经常遇到三类问题：页面结构复杂难以精准操作、网络请求无法有效调试、环境差异导致测试结果不一致。传统脚本需要手动处理元素定位、请求拦截和视口切换，调试成本高且易出错。

Mearl 的工作原理与核心能力

Mearl 通过统一的API契约解决上述问题，核心分为三层：

页面操作层：page_click、page_type、page_scroll等动作内置观察机制，自动处理元素定位和异步稳定判断。关键约束是参数必须严格符合契约，如page_snapshot.query必须是对象，page_click只能使用selector、text或point之一。
网络调试层：get_requests、set_mock、set_rule等接口覆盖请求监控、Mock数据和请求规则。例如，send_request会自动携带浏览器Cookie，send_mtop_request在页面上下文中处理签名和token。
环境模拟层：set_device_emulation和set_timezone按tab粒度控制移动端模拟和时区，避免全局状态污染。

工作流程遵循五步法：确认环境→建立基线→执行动作→按需观察→验证终态。例如，首次进入页面时调用page_snapshot建立基线；执行page_click后通过action.success、observation.changed判断效果；长列表场景优先用mode: "viewport"减少数据量。

适用边界与注意点

参数规范：所有动作的参数必须严格符合API契约，不确定时先运行mearl --help或查阅API说明，不要猜测字段名。
避免过度观察：不要在每次动作后固定执行page_snapshot或page_screenshot，无需观察结果时可传observe: false执行裸动作。
移动端模拟：仅在用户明确要求或目标页面确为触屏专用时启用emulation，不要仅凭响应式布局判断。
终态验证：动作成功或发生导航不能单独证明任务完成，必须对照用户要求检查URL、标题和必要范围的快照。