界面与数据均为演示示例 · 基于 Playwright 按项目二次开发。
网站巡检与浏览器自动化 / PLAYWRIGHT
网站不会自己说哪里坏了 让每次巡检都可回放
煜企围绕 官网、表单与业务入口,基于 Playwright 二次开发检查脚本,把「页面好像能打开」变成一条可执行、可确认、可回切的检查路径。交付的是一套能被复核的系统,不是一份截图。
按范围
关键入口覆盖范围
COVERAGE / ENTRYPOINTS
按配置
执行窗口按需求设置
RUN WINDOW / CYCLE
按需
按需配置调度
SCHEDULE / ON DEMAND
4 项
标准化交付模块
PROJECT MODULES
RUN #20261114-084 · 演示巡检记录
38 / 38 PASS
官网首页 · 表单提交 · 登录跳转 · 业务入口
DRIFT WATCH · 选择器变更监测
2 PENDING
页面结构变更已进入待确认队列,不自动放行
EVIDENCE · 证据留存
截图 + 录屏 + 日志
每条断言都可回溯到一次具体的页面操作
OBSERVATION TARGET / 官网首页
正在对 38 条断言
逐条取证
逐条取证
- 01首页首屏加载PASS
- 02导航与关键链接PASS
- 03表单字段可达PASS
- 04提交与回执文案PASS
- 05选择器漂移复核REVIEW
- 06业务入口跳转PASS
ENGINE Playwright / Chromium
TRACE ON
SCREENSHOT ON FAILURE
38 PASSED · 0 FAILED · 2 REVIEW
01 / WHY · 从"看着正常"到"有据可查"
巡检的终点不是一份报告,而是一条可演练、可确认、可回切的恢复路径
关键业务需要的,不只是一份页面截图或一次「访问成功」。当官网、表单与业务入口承载线索与交易时,可用性必须能被主动验证、被第三人复核,并在页面改版后安全退回既有基线。
THE PREMISE / 核心主张
页面「能打开」只是起点。
真正决定业务连续性的,是故障发生时,你知道它从哪一环开始坏、由谁确认、怎样退回到已验证的状态。
煜企把巡检设计成一条闭环:脚本定义检查 → 配置决定口径 → 调度保障频次 → 通知驱动处置 → 证据回流到下一次演练。每一环都有交付物,每一环都可被咨询、复核与交接。
官网
表单与留资
登录与权限
业务查询入口
下载与回执
SCENE / 信息化负责人与运维团队的日常复核OBSERVE 01
GATE 01 / 可演练
上线前就跑得起来
按指定页面与流程编写自动化操作和断言,在上线前、改版后、活动前主动执行一遍,而不是等用户报障后才发现表单提交失败。
GATE 02 / 可确认
每条结论都有证据
断言结果绑定截图、录屏与执行日志,异常进入待确认队列并指定处置人。「看着没问题」不作为验收口径。
GATE 03 / 可回切
改版后能退回基线
脚本、用例与配置纳入版本管理;页面结构变化导致选择器漂移时,可回到上一个已验证版本并完成回归,巡检能力本身不中断。
GAP 01
发现靠人
表单提交失败,往往由客户先发现,内部却没有可量化的发现时点。
GAP 02
口径不一
开发、运维与业务对「正常」的定义不同,结论无法对齐。
GAP 03
异常难复现
只有一张截图,缺少操作步骤与环境上下文,隔天无法重跑。
GAP 04
告警成噪音
没有分级与静默窗口,通知被忽略,真正的问题反而淹没。
02 / ARCHITECTURE · 分层,让每一环都能被交接
五层链路:从业务入口到证据回流,每层职责明确
脚本、配置、调度、运行彼此解耦:页面改版只动用例,通知渠道变更只动调度,运行环境迁移不牵动业务逻辑。这是后续能被内部团队接手的前提。
ARCH / INSPECTION PIPELINE · 5 LAYERS
● TRACE ENABLED · RUN #084
正常链路 / 检查流
编排与脚本回流
调度窗口 / 待确认
已验证基线
断言失败 / 阻断
L1 · TARGET
业务入口清单
与客户共同确认哪些页面、表单与跳转属于关键业务路径,形成可编号的检查对象。
L2 · ENGINE
Playwright 脚本
按流程编写操作与断言,统一封装等待、重试、截图与 Trace,避免用例各自为政。
L3 · CONFIG
配置与呈现界面
任务参数、执行记录、异常详情可视化,让非开发角色也能读懂巡检结论。
L4 · SCHEDULE
调度与通知服务
按需接入定时任务与消息服务,分级推送并保留静默窗口与升级路径。
L5 · OPERATE
运行环境与维护
明确运行主机、账号权限、凭据保管、故障诊断与脚本维护责任边界。
ENV / 运行环境可本地化部署或托管ARCH 02
设计原则 01
解耦:改版不改调度
页面结构变化只影响用例层;通知渠道、执行频次与运行环境可独立调整,降低维护时的连带风险。
设计原则 02
可观测:失败必有上下文
失败断言自动附带步骤、截图、控制台输出与 Trace,缩短「发现问题」到「定位问题」之间的距离。
设计原则 03
可交接:文档与代码同版
交付包含脚本源码、参数说明、部署手册与运维手册,客户内部团队可独立接手与二次开发。
03 / PROJECT 01 · CHECK SCRIPT
按指定页面与流程编写自动化操作和断言
基于 Playwright 二次开发,不改动客户网站代码。脚本描述的是业务动作与预期结果,而不是脆弱的元素坐标,因此页面局部改版后仍可维护。
specs / lead-form.spec.ts
● 38 ASSERTIONS / PASS
01020304050607080910111213141516
import { test, expect } from '@playwright/test';
// 断言:可见性 → 提交 → 回执 → 证据归档
// 官网 / 留资表单 · 关键业务路径 01
test('lead-form happy path', async ({ page }) => {
await page.goto(env.BASE_URL + '/contact');
await expect(page).toHaveTitle(/联系我们/);
await expect(page.locator('[data-qa=lead-form]'))
.toBeVisible({ timeout: 8000 });
await page.getByLabel('姓名').fill('巡检样例');
await page.getByLabel('手机').fill('13800000000');
await page.getByRole('button', { name: '提交' }).click();
await expect(page.locator('[data-qa=success]'))
.toContainText('已收到');
await page.screenshot({ path: trace('lead-form.ok') });
});
Last run 00:42.318 · trace.zip + video.webm + console.log retained
01
官网首页与首屏
标题、关键区块、静态资源与控制台错误
8 PASS
02
导航与关键链接
可达性、状态码、外链与锚点跳转
6 PASS
03
留资表单
字段可达、校验提示、提交与成功回执
7 PASS
04
登录与权限入口
跳转、错误提示与会话态(脱敏账号)
5 PASS
05
业务查询与下载
结果返回、下载文件、空结果文案
7 PASS
06
回执与后续跳转
确认页、邮件/短信触发点、返回路径
5 PASS · 2 REVIEW
WHAT WE BUILD / 二开内容
脚本写的是业务动作
以页面语义与稳定定位约定编写操作序列,统一封装等待策略、失败重试、截图与 Trace 采集;用例与配置分离,便于批量维护。
断言分层
- 存在性:关键元素、文案与区块是否出现
- 可达性:状态、跳转、资源响应是否正常
- 流程性:填写 → 提交 → 回执整链路是否闭环
- 一致性:多环境与多视口下结论是否一致
SPEC / 用例与业务路径逐条对齐01 / SCRIPT
边界说明
脚本只读地访问客户页面,不注入业务数据、不改动生产内容;涉及写操作的流程使用专用测试账号与隔离环境,并事先约定清理方式。
只读优先
测试账号隔离
凭据不入库
04 / PROJECT 02 · INSPECTION CONFIG
巡检配置:任务参数、执行记录与异常呈现在同一界面闭环
开发任务参数、执行记录及异常呈现界面。让业务、运维与开发三种角色读取同一份事实,减少「到底算不算故障」的沟通成本。
yq-inspector / 控制台 · 任务 T-014 · 官网与留资链路
RUN #084ENV / PROD-READONLY● ONLINE
BASE_URL
https://www.example-corp.com
BROWSER
Chromium / headless
VIEWPORT
1440×900 · 390×844
CONCURRENCY
3 workers
TIMEOUT
8 000 ms
RETRY
1 / on failure
SCREENSHOT
on failure + on review
TRACE
retain-on-failure
SUITE
38 assertions / 6 flows
CADENCE
every 15 min · 07–23
NOTIFY LEVEL
P1 immediate / P2 digest
EVIDENCE TTL
90 days
执行记录 / EXECUTION LOG
最近 8 次
| RUN ID | 时间 | 场景 | 耗时 | 断言 | 结论 | 复核人 |
|---|---|---|---|---|---|---|
| #084 | 11-14 08:42 | 官网 / 留资 / 跳转 | 42.3s | 38/38 | PASS | 自动 |
| #083 | 11-14 08:27 | 官网 / 留资 / 跳转 | 41.8s | 38/38 | PASS | 自动 |
| #082 | 11-14 08:12 | 官网 / 留资 / 跳转 | 43.1s | 37/38 | REVIEW | 张 · 运维 |
| #081 | 11-14 07:57 | 官网 / 留资 / 跳转 | 42.0s | 38/38 | PASS | 自动 |
| #080 | 11-14 07:42 | 登录 / 业务查询 | 38.6s | 36/38 | FAIL | 李 · 开发 |
| #079 | 11-14 07:27 | 官网 / 留资 / 跳转 | 42.7s | 38/38 | PASS | 自动 |
| #078 | 11-14 07:12 | 下载 / 回执链路 | 39.4s | 38/38 | PASS | 自动 |
| #077 | 11-14 06:57 | 官网 / 留资 / 跳转 | 41.5s | 38/38 | PASS | 自动 |
EXCEPTION · RUN #080 · 业务查询入口 · 已定位并回切
断言
toContainText('查询结果') 超时。Trace 显示上游页面改版后 [data-qa=result-panel] 被替换;用例已回退至上一已验证基线 v1.8,回归 38/38 通过,选择器修订进入变更单。
REVIEW / 异常不自动放行,由责任人确认02 / CONFIG
业务角色看结论
只看关键入口是否正常、影响范围与处置状态,不需要理解脚本实现。
运维角色看频次与记录
执行窗口、失败重试、通知送达与证据留存周期一目了然,便于值守交接。
开发角色看上下文
失败步骤、选择器、控制台输出、Trace 与截图打包,可直接用于定位与回归。
05 / PROJECT 03 · SCHEDULE & NOTIFY
调度通知:按需接入定时任务与消息通知服务,让异常找得到人
巡检的价值取决于「多久被发现」与「谁来确认」。执行频次按业务时段设定,通知按严重度分级,并与既有任务管理、消息服务对接。
CRON / 业务时段
*/15 7-23 * * 1-6
发布窗口额外触发
on: deploy / config-change
● NEXT RUN 09:12
企业微信 / 群机器人
P0 · P1 即时推送
@ 当值责任人
@ 当值责任人
邮件摘要
P2 每日汇总
含趋势与证据链接
含趋势与证据链接
Webhook / 任务系统
自动创建缺陷单
回写处置状态
回写处置状态
短信 / 电话升级
超时未确认
按值班表升级
按值班表升级
NOTIFICATION PREVIEW / 企业微信P1 · 08:12 · RUN #082
【巡检待确认】官网留资表单 2 条断言进入 REVIEW
页面结构疑似变更:
→ 查看执行记录 / 认领 / 标记误报
页面结构疑似变更:
[data-qa=success] 未匹配。脚本未自动放行,已附截图与 Trace。请责任人在 30 分钟内确认或回切基线。→ 查看执行记录 / 认领 / 标记误报
P0核心入口不可用
留资、登录或交易入口断言失败 → 按约定通知与升级,响应时间按项目确认。
P1单次失败 / 待确认
重试通过或选择器漂移 → 群消息 + 复核队列,不自动关闭。
P2性能与趋势
响应变慢、偶发抖动 → 汇总进日报,避免告警疲劳。
静默窗口发布与计划维护
约定维护时段抑制重复通知,执行记录与证据仍完整保留。
ESCALATION / 通知必须落到人和动作03 / NOTIFY
06 / PROJECT 04 · RUN & MAINTAIN
运行与维护:把环境、权限、诊断与脚本维护写成可执行的责任边界
巡检系统本身也是一套需要被运维的系统。规划运行环境、权限、故障诊断和脚本维护,才能避免「上线跑得好,三个月后没人敢动」。
运行环境
- 部署形态:客户内网主机 / 托管虚机 / 容器,按等保与网络策略选定
- 浏览器依赖:Chromium 版本锁定,避免自动升级导致结果漂移
- 网络路径:白名单、代理与 DNS 解析纳入检查前置条件
- 资源基线:CPU / 内存 / 磁盘与证据存储容量预留
权限与凭据
- 最小权限:巡检账号仅具备必要的页面访问与测试写权限
- 凭据保管:密钥由客户侧凭据管理,不明文写入脚本或仓库
- 角色分离:配置修改、结果确认、脚本发布分属不同角色
- 操作留痕:参数变更与回切操作记录操作人、时间与原因
故障诊断
- 区分故障源:目标页面、网络链路、浏览器运行时、脚本本身四类
- 证据包:Trace、录屏、控制台日志、网络请求与截图按 Run ID 归档
- 重试与抑制:避免依赖方抖动造成连续误报
- 回归验证:修复后重跑同一用例集,结论才算闭环
脚本维护
- 版本管理:用例、配置与文档同版本号,可回切到已验证基线
- 选择器漂移:页面改版触发复核,修订经回归后才合入
- 变更联动:客户发布流程中增加「巡检用例同步」检查项
- 知识转移:提供源码、部署手册与运维手册,支持内部接手
OPERATE / 环境、权限与诊断责任到人04 / OPS
MAINTENANCE CADENCE / 维护节奏
日
执行记录抽检
确认通知送达、异常已认领、证据可下载
DAILY
周
用例与阈值复核
清理误报、调整超时与重试、更新静默窗口
WEEKLY
月
运行环境与依赖巡检
浏览器版本、磁盘容量、证书与凭据有效期
MONTHLY
变
发布前演练与回切验证
页面改版后跑一遍全链路,确认基线可退回
ON CHANGE
安全与合规
只读优先
测试账号隔离
凭据客户侧保管
证据留存期可配
操作留痕
不改动生产代码
07 / DELIVERABLES · 交付到什么程度算完成
交付的不是建议书,是可运行、可复核、可交接的系统与资料
每个阶段都有明确产出物与验收口径。客户拿到的既有源代码与配置,也有能让非开发角色读懂的记录、手册与演练结论。
| 阶段 | 交付模块 | 产出物 | 验收口径 |
|---|---|---|---|
| D00 | 咨询与入口盘点 | 关键页面清单、业务路径图、异常分级与验收口径表 | 双方确认签字 |
| D01 | 检查脚本 · PROJECT 01 | Playwright 二次开发源码、用例说明、断言清单与定位约定 | 指定流程全链路可重复执行 |
| D02 | 巡检配置 · PROJECT 02 | 任务参数配置、执行记录、异常呈现界面与参数说明 | 三种角色均可读可查 |
| D03 | 调度通知 · PROJECT 03 | 定时任务配置、通知渠道接入、分级策略与静默窗口规则 | 通知送达与升级路径演练通过 |
| D04 | 运行维护 · PROJECT 04 | 部署手册、权限矩阵、凭据管理约定、故障诊断手册 | 环境迁移后结论一致 |
| D05 | 试运行与演练 | 演练记录、异常处置记录、回切验证报告与回归结果 | 可演练 / 可确认 / 可回切 |
| D06 | 知识与交接 | 运维手册、培训记录、源码与文档移交清单、后续扩展指引 | 内部团队可独立接手 |
咨询成果的落地方式
一份报告 → 一条运行中的链路
信息化建设咨询常见的问题是「结论正确、落不了地」。煜企把咨询结论直接翻译成检查对象、断言口径、调度策略与责任分工,拟通过项目实施与验收,使链路可运行、记录可查看。
盘点:哪些入口属于关键业务
定义:什么算正常、什么算异常
分工:谁执行、谁确认、谁回切
沉淀:证据如何留存与复用
HANDOVER / 源码、文档与培训一并移交DELIVER 07
08 / VALUE · 信息化建设与咨询的实际收益
客户得到的,是一套能被复核的可用性机制
以下收益均以交付物为承载,而非承诺性表述:每一项都能在配置界面、执行记录或移交文档中被指认出来。
VALUE 01
从「有人看」到「有证据」
可用性结论不再依赖口头确认或一张截图;每条断言绑定步骤、截图、录屏与日志,可被第三人复核。
EVIDENCE / 执行记录与证据包
VALUE 02
三种角色共用一套口径
业务、运维与开发对「正常 / 异常 / 待确认」有同一份定义与验收表,减少跨部门来回解释。
DEFINITION / 验收口径表
VALUE 03
缩短发现与定位距离
异常自带失败步骤、选择器与控制台上下文,把「发现问题」直接推进到「定位问题」,不必隔天重跑复现。
TRACE / 失败上下文
VALUE 04
变更敢做、出错能退
发布前演练、发布后回归、用例与配置可回切到已验证基线;页面改版不再让巡检能力随之失效。
ROLLBACK / 版本基线
VALUE 05
咨询结论变成了系统
盘点、口径、分工与频次被写进脚本、配置与调度,通过约定的开发和验收,将咨询结论落成可运行的链路。
SYSTEM / 可运行链路
VALUE 06
能力留在客户内部
源码、参数说明、部署与运维手册、培训记录一并移交,后续可自行扩展巡检对象,不受制于单点依赖。
HANDOVER / 源码与文档
BEFORE / 常见的现状
- 官网或表单异常由客户、销售先发现
- 截图没有上下文,隔天无法复现
- 「正常」的定义随角色不同而变化
- 告警没有分级,逐渐被静音
AFTER / 交付后的状态
- 按业务时段自动巡检,异常主动触达责任人
- 每次运行留 Trace、截图、录屏与控制台日志
- 验收口径书面化,结论可被三种角色复核
- 分级通知 + 静默窗口 + 回切基线形成闭环
4 / PROJECT
标准化项目模块
SCRIPT · CONFIG · SCHEDULE · OPS
7 阶段
可验收交付阶段
D00 → D06 / WITH SIGN-OFF
3 类角色
共用同一份事实
BUSINESS · OPS · DEV
6 类入口
默认覆盖检查对象
EXTENSIBLE / ON DEMAND
09 / ROADMAP · 从评估到常态化运营
六个阶段走完,每一步都有可签收的产出
实施顺序遵循「先定义口径,再写脚本,最后接调度」:口径不清就直接自动化,往往只会把误报变成日常噪音。
01
评估与入口盘点
梳理官网、表单与业务入口,标出关键路径与影响面。
02
口径与验收定义
定义正常、异常、待确认,以及分级通知与静默规则。
03
脚本开发与评审
编写 Playwright 用例与断言,约定稳定定位与证据采集。
04
配置与调度接入
完成任务参数、执行记录、异常呈现与通知渠道对接。
05
试运行与演练
跑通全链路,验证通知升级、异常确认与基线回切。
06
交付培训与运营
移交源码与手册,建立日 / 周 / 月 / 变更维护节奏。
APPLICABLE SCOPE / 可纳入巡检的对象
官网门户与栏目页
首屏、导航、内容可达性
营销落地页
活动入口、埋点跳转、回执
留资与联系表单
字段校验、提交、成功文案
登录与单点入口
跳转、错误提示、会话态
业务查询与下载
结果返回、文件、空态文案
预约与报名流程
步骤完整性、确认页、返回路径
多语言与多站点
按区域与时间窗分组执行
发布后回归
改版前后结论比对与回切

政企 / 服务门户SCENE 01

制造 / 业务入口SCENE 02

服务 / 预约表单SCENE 03

零售 / 线索留资SCENE 04
10 / NEXT STEP · 从一次评估开始
先看清巡检链路
缺在哪一环
煜企从关键业务入口盘点入手,与客户共同确认检查对象、验收口径与责任分工,再给出脚本、配置、调度与运维的分阶段实施方案。评估结论可以直接落成系统,而不是停留在建议书。
不改动客户生产代码
可本地化部署
源码与文档一并移交
ASSESSMENT SCOPE / 一次评估会看什么
关键业务入口官网 / 表单 / 登录 / 查询
现有发现方式人工 / 监控 / 客户反馈
异常处置路径通知对象 · 升级规则
运行环境约束内网 / 托管 / 权限边界
改版频率用例维护与回切需求
输出分阶段实施方案与验收口径