用途:在持续集成中验证 Bright Data 适配器时,保持拉取请求验证无需凭证且结果确定。默认用夹具(fixture)测试适配器,把必要的真实探测放到独立、受保护的任务中,并配专用凭证、获批目标与单次操作预算。
主要能力:
- 离线契约测试通道(必需):运行 npm ci 与 npm run test:brightdata:contract,并以 BRIGHTDATA_MODE=fixture 执行;在无网络访问下覆盖成功、认证拒绝、策略拒绝、429、提供商 5xx、畸形输出与脱敏。
- 受保护的真实探测通道(可选):独立于 fork 与 PR 执行,要求受保护环境、维护者授权、获批的公开目标、专用最小权限密钥、单次操作上限、超时与脱敏日志。
- 负向行为验证:用缺失与哨兵凭证运行契约测试,确认离线任务无密钥仍为绿,失败产物不含凭证与采集数据。
使用方式:先用 Read 与 Grep 审计工作流、适配器与密钥引用,识别机密、直接提供商调用、产物上传及来自不受信任 fork 的执行;将每个测试归入离线或真实通道。用 Write 与 Edit 编写工作流、夹具、测试与操作手册;仅用 Bash(npm:*) 安装依赖与运行仓库测试,不得用于发起真实 Bright Data 请求。
适用场景:需要为 Bright Data 适配器引入提供商检查的仓库;fork 的 PR 仅运行合成代理与快照夹具;由维护者触发的发布流程经受保护环境执行一次获批操作,仅记录状态、延迟与脱敏错误类别。
限制与前置条件:需要仓库测试命令、具代表性的脱敏成功与失败夹具、CI 工作流与适配器路径,以及创建可选的真实通道前取得维护者批准。若 fork 能访问提供商密钥、离线测试依赖网络、或真实产物含原始输出,须分别停用真实任务并移除密钥暴露、用脱敏夹具替换提供商流量、删除产物并仅保留脱敏指标。
其他资源涉及:代理错误目录、可接受使用政策、代理 API 认证、异步抓取请求。具体配置细节暂未提供。