泡泡网页巡检

接入你的站点

准备一个可以修改 HTML 和 DNS 的预览站点。建议先从单个预览页面验证完整流程。

创建项目

进入项目控制台,使用 GitHub 登录。创建项目后添加要接入的源,例如 https://preview.example.com。源包括协议、主机名和端口。预览和生产分别登记。

验证站点

在 DNS 服务中新增控制台给出的 TXT 记录,等待解析生效后点「检查 DNS」。验证完成后,由项目所有者显式启用该环境。开发期间可添加 http://127.0.0.1:端口 或 http://localhost:端口 类型的本机环境,再从需要巡检的浏览器启动。

安装接入脚本

复制控制台为项目生成的代码,放到目标页面的 HTML 中。可用 data-release 传入该页面构建时的版本号,便于复现。

<script defer src="https://toolbar.paomall.com/sdk/v1/loader.js"
  data-project="你的项目 ID"
  data-release="当前页面的构建版本"></script>

目标站若有 CSP,在现有 script-src、style-src 和 connect-src 中加入 https://toolbar.paomall.com。保留现有规则,SDK 加载器仅在巡检启动时申请授权和加载面板。

授权并巡检

在控制台选择环境,输入安装脚本的页面路径,点击「打开并巡检」。页面跳转到 Toolbar 显示授权对象,确认后回到目标页。成功打开浮层后,控制台会记下该环境已完成接入。

要让其他人巡检,在控制台填写对方的 GitHub 登录名,复制邀请链接交给对方。受邀者用对应账号登录并接受邀请。项目所有者可随时撤销成员权限。

在页面上评论

打开浮层中的「评论」,写一条页面评论,或先选择一个元素再提交。项目成员可以打开同一路径并回复。复制讨论链接后,受邀成员可以沿链接完成巡检授权,再查看对应讨论。

评论跟随项目、站点源和页面路径,分享链接不携带页面查询参数。后续构建仍可查看同一路径的讨论,原元素无法定位时可继续阅读与回复。讨论发起者和项目所有者可以标记解决或重新打开。

需要稳定定位的元素可提供页面内唯一的 data-paomall-anchor,例如 data-paomall-anchor="checkout-button"。部署新版时保留该值。

检查范围

无障碍扫描覆盖当前页面内可以读取的常见规则。布局偏移和慢交互取决于浏览器提供的性能条目,面板会标记记录范围及不支持的功能。跨域框架需要在各自页面中接入。诊断记录保留在当前页面,可按需复制。主动发布的评论与回复保存在项目中。

停用与卸载

从控制台停用环境可立即阻止新的巡检启动。移除目标页的加载器并发布,即可卸载页面端脚本。关闭面板会结束本次记录。