Automatic Operation Skill｜用 Playwright 录制与检查网页回归步骤

Python / Playwright 安装步骤

创建并激活 Python 3.10+ 虚拟环境，运行 `python -m pip install automatic-operation-skill==2.0.0`。仓库的 `pyproject.toml` 定义了 `auto-recorder` 和 `auto-playback` 命令。
用 `python -m playwright install chromium` 准备录制或页面回放所需的浏览器。先从本地测试页和虚构输入开始。
录制后将 `skill_config.json` 和 `steps.json` 放在同一目录，先用 `auto-playback --config 路径/skill_config.json --dry-run` 检查定位策略。

中文摘要

为自己的网页或测试环境录制界面交互，把按钮和输入框等操作保存成可审阅的步骤。页面小改后可以用备选的标签、角色或测试 ID 恢复定位，适合整理表单、弹窗和页面切换的回归测试。回放工具也能离线检查步骤配置。

SKILL.md 中文导读

可复现示例

在 Bash 终端创建本地测试配置。只演练步骤检查，因此不需要启动页面服务。

mkdir -p auto-demo
printf '%s\n' '{"start_url":"http://127.0.0.1:8000","variables":{}}' > auto-demo/skill_config.json
printf '%s\n' '[{"step_id":"step_001","action":"click","locators":[{"strategy":"test_id","selector":"show-tips"}]}]' > auto-demo/steps.json
auto-playback --config auto-demo/skill_config.json --dry-run

工作步骤

为自有测试页面的主要控件设置稳定的 `data-testid` 或可读标签。
录制简短的操作流程并检查两个 JSON 文件。使用虚构输入，因为录制会保留前后截图。
先检查步骤配置，再在测试页面上核对控件能否找到，以及交互后的界面结果。

验收方法

终端应报告一条步骤校验通过。这个结果只确认定位策略属于工具支持的类型。要核对按钮是否存在、点击后是否显示提示，可在含 `data-testid="show-tips"` 按钮的自有页面执行回归测试。

GitHub 原文 · 更新日期 2026-11-14

适用环境

Python 3.10+、Playwright 1.40+。录制和实际回放使用 Playwright Chromium。示例从终端读取两个本地 JSON 文件，只检查步骤定义，未启动浏览器。

常见问题

执行 dry-run 后能知道按钮是否找得到吗？

dry-run 会检查步骤是否有定位器、策略是否在支持列表内。要确认定位器是否匹配元素及点击的实际效果，需要在自己的测试页面运行回放并检查页面结果。