连接顺序

  1. 先阅读 线上接入参考,核对身份与当前价格。
  2. 创建一次限时运行,使用稳定的幂等键,等待状态为 ready。
  3. 对这次运行申请控制地址。该地址短期有效、供单连接使用,属于敏感凭据。
  4. 连接默认 browser context,并复用已有页面;需要额外页面时在同一 context 中创建。
  5. 完成后先取回下载,再显式结束 Agent 自己创建的运行。
连接片段 · cdp_url 来自当前运行的控制响应
import { chromium } from 'playwright';

const browser = await chromium.connectOverCDP(cdp_url);
const context = browser.contexts()[0];
const page = context.pages()[0] ?? await context.newPage();
await page.goto('https://docs.python.org/3/whatsnew/3.13.html');
const title = await page.title();
console.log(title);
await browser.close(); // 只断开客户端;仍须结束运行

断线与恢复

如果连接过期或断开,而原运行仍 ready,对同一次运行重新申请控制地址,找回原页面并观察状态。不要复用旧地址、无故新建第二次运行,或重放结果未知的写操作。

字段、错误和结束流程见 OpenAPI 合同;若使用 Patchright,参照 明确版本指南。