📡 Bugsnag Build API · Lighthouse 阈值 · PR 摘要 · 远程 Mac · 2026
2026 OpenClaw 前端实战:
远程 Mac 对接 Bugsnag Build API、Lighthouse 阈值判定与 PR 可读摘要回传
2026.05.07
可观测 · Web 发布门禁
约 9 分钟阅读
前端团队要把预览 URL上的性能回归与错误平台里的构建行绑在同一颗提交上,又不想让评审在控制台里翻页。用 OpenClaw 调度远程 Mac:先写 Bugsnag Build API,再跑 Lighthouse 对照阈值,最后把结论压进一条 PR 评论。本文给 HowTo 与排障表;延伸阅读 GitHub Deployments 与 Lighthouse、预览 Webhook 跑 Lighthouse、构建指标 PR 摘要;首页、帮助、资费、购买 均免登录可浏览。
Web 发布门禁 · 低延迟节点
痛点拆解
一构建行与预览不同步,线上聚类无法回答「哪次 PR 引入」。二无头 Linux 离 CDN 远,LCP 抖动大,阈值要么形同虚设要么误杀。三原始 lhr.json 贴进线程,评审读完前已合并。把跑测放在靠近预览区域的远程 Mac并把输出压成模板,才能把Web 发布门禁做实。
01 决策矩阵
| 维度 | 远程 Mac 节点 | 远端无头容器 |
|---|---|---|
| 预览时延 | 同城或同区域边沿,冷启动后重复测更稳。 | 跨洋 RTT 放大首包与 TLS,易假回归。 |
| 构建关联 | 与 openclaw 脚本同机写 Build 再跑 Lighthouse,日志同根目录。 |
需额外同步产物与密钥出站策略。 |
| 门禁形态 | 阈值失败直接非零退出挡合并;PR 评论给人读。 | 仅机器日志时常被跳过。 |
与 Lighthouse 告警步骤、部署前检查 串联时,把阶段枚举对齐同一 OPENCLAW_RUN_ID。
02 可复现步骤
- API 令牌。在网关注入 Bugsnag 个人授权令牌调 Build API;浏览器 SDK 仍用项目 notifier Key,二者分仓,禁止把密钥写进 Markdown 正文。
- 写入 Build。对目标提交 POST:携带
appVersion、releaseStage(如staging)、sourceControl.revision等于 PRhead_sha,保证错误事件能挂载到同一构建行。 - 触发条件。仅当
releaseStage属于白名单且 revision 与当前 PR 头一致、预览 HTTP 状态为 200 时再跑 Lighthouse;可用「部署成功 Webhook」或轮询预览就绪标志,避免半开页。 - Lighthouse 与阈值。固定 Chromium 通道,输出
.openclaw/reports/lhr-*.json;用脚本解析 performance 分数与 LCP、CLS、TBT,与仓库budgets.json比较(示例:performance 最低九十、LCP 毫秒二千五百上限、CLS 零点一、TBT 毫秒三百),越界则exit 1。 - 摘要模板。用下面骨架生成评论正文,顶部保留隐藏锚点
<!-- openclaw:lh-bugsnag:REPO:SHA -->做幂等 upsert。 - 与 doctor 合并(可选)。在同一 runner 上追加
openclaw doctor --json,把 WARN 行截断到八百字节拼到「环境自检」小节,便于区分阈值失败与环境漂移;编排顺序参考 部署前检查文。 - 回传 PR。调用托管方评论接口创建或更新同锚点评论,描述字段写 verdict 与报告路径,不放令牌。
<!-- openclaw:lh-bugsnag:OWNER/REPO:SHA --> ## Lighthouse × Bugsnag Build(staging) - **预览**:<URL> - **构建行**:appVersion … / revision `…` - **分数**:performance **Δ**;LCP **Δms**;CLS **Δ**;TBT **Δms** → **PASS|FAIL** - **报告**:`.openclaw/reports/…` ### 环境自检(可选) - openclaw doctor:…
03 排障速查
| 现象 | 优先检查 |
|---|---|
| Build API 401 | Authorization 头方案是否与令牌类型匹配、组织 slug 是否指向含该项目的工作区。 |
| Lighthouse 分数剧烈波动 | 是否预热预览两遍、Chromium 是否钉版、是否与近五次绿构建中位数对比而非单点魔数。 |
| PR 评论重复多条 | 锚点键是否含仓库与完整 SHA;合并前是否去重 Idempotency-Key。 |
可引用口径
阈值文件
performance 与 LCP、CLS、TBT 四项与 budgets 同步版本控制。
关联三元组
releaseStage、revision、预览 URL 必须写入同一段 JSON 供网关检索。
远程节点
与区域预览同机房的 Mac 跑门禁可降低网络方差,利于稳定挡合并。
更多:博客列表。