界面与数据均为演示示例 · 基于 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 · 证据留存
截图 + 录屏 + 日志
每条断言都可回溯到一次具体的页面操作
inspection.runner
🔒https://example.com/ · 官网 / 表单 / 业务入口 · run#084
DEMO
数据分析工作场景配图
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 / 可演练
上线前就跑得起来
按指定页面与流程编写自动化操作和断言,在上线前、改版后、活动前主动执行一遍,而不是等用户报障后才发现表单提交失败。
产出:场景清单 + 演练记录DRILL
GATE 02 / 可确认
每条结论都有证据
断言结果绑定截图、录屏与执行日志,异常进入待确认队列并指定处置人。「看着没问题」不作为验收口径。
产出:执行记录 + 异常详情CONFIRM
GATE 03 / 可回切
改版后能退回基线
脚本、用例与配置纳入版本管理;页面结构变化导致选择器漂移时,可回到上一个已验证版本并完成回归,巡检能力本身不中断。
产出:版本基线 + 回切步骤ROLLBACK
GAP 01
发现靠人
表单提交失败,往往由客户先发现,内部却没有可量化的发现时点。
GAP 02
口径不一
开发、运维与业务对「正常」的定义不同,结论无法对齐。
GAP 03
异常难复现
只有一张截图,缺少操作步骤与环境上下文,隔天无法重跑。
GAP 04
告警成噪音
没有分级与静默窗口,通知被忽略,真正的问题反而淹没。
02 / ARCHITECTURE · 分层,让每一环都能被交接

五层链路:从业务入口到证据回流,每层职责明确

脚本、配置、调度、运行彼此解耦:页面改版只动用例,通知渠道变更只动调度,运行环境迁移不牵动业务逻辑。这是后续能被内部团队接手的前提。
ARCH / INSPECTION PIPELINE · 5 LAYERS ● TRACE ENABLED · RUN #084
L1 / TARGET 官网 · 表单 · 业务入口 首页 / 留资 / 登录 / 查询 下载 / 回执 / 跳转链路 L2 / ENGINE Playwright 执行引擎 二次开发脚本 · 操作与断言 Chromium / Trace / 录屏 L3 / CONFIG 巡检配置与呈现 任务参数 · 执行记录 异常呈现 · 复核结论 L4 / SCHEDULE 调度与通知 定时任务 · 执行频次 企微 / 邮件 / Webhook L5 / OPERATE 运行与维护 环境 · 权限 · 凭据 故障诊断 · 脚本维护 OBSERVATION TARGETS AUTOMATION CORE CONFIGURATION & EVIDENCE ORCHESTRATION OPERATIONS ↓ 用户真实路径 ↑ EVIDENCE LOOP / 截图 · 录屏 · 日志回流,驱动下一次演练与用例修订 BOUNDARY: 访问授权、证据数据处理与运行职责按项目确认
正常链路 / 检查流 编排与脚本回流 调度窗口 / 待确认 已验证基线 断言失败 / 阻断
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时间场景耗时断言结论复核人
#08411-14 08:42官网 / 留资 / 跳转42.3s38/38PASS自动
#08311-14 08:27官网 / 留资 / 跳转41.8s38/38PASS自动
#08211-14 08:12官网 / 留资 / 跳转43.1s37/38REVIEW张 · 运维
#08111-14 07:57官网 / 留资 / 跳转42.0s38/38PASS自动
#08011-14 07:42登录 / 业务查询38.6s36/38FAIL李 · 开发
#07911-14 07:27官网 / 留资 / 跳转42.7s38/38PASS自动
#07811-14 07:12下载 / 回执链路39.4s38/38PASS自动
#07711-14 06:57官网 / 留资 / 跳转41.5s38/38PASS自动
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 01Playwright 二次开发源码、用例说明、断言清单与定位约定指定流程全链路可重复执行
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 / 一次评估会看什么
关键业务入口官网 / 表单 / 登录 / 查询
现有发现方式人工 / 监控 / 客户反馈
异常处置路径通知对象 · 升级规则
运行环境约束内网 / 托管 / 权限边界
改版频率用例维护与回切需求
输出分阶段实施方案与验收口径
Playwright / GitHub官方文档Apache-2.0全部解决方案配图:Unsplash 场景素材,非客户案例。