Agent Skills
返回列表
📊

浏览器数据采集链路诊断

数据分析 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @douease/browser-collector-debugger。

技能介绍

问题从哪来

浏览器扩展、内容脚本或网络拦截器做平台数据采集时,故障往往被当成「某个接口挂了」。实际更常见的是:请求在 Network 里已经是 200/201,后台、账号画像或看板却长期没有数据。新增端点、GraphQL operation、分页或压缩响应后,分类规则和解析器也容易 silently 失效。

把「是否打通」拆成可独立验证的环节,才能避免把传输成功误判为业务完成。

六层模型怎么用

本技能用固定工作流,从下到上(或从捕获到呈现)逐层核对:

  1. 捕获层:扩展是否看到目标 URL、方法、状态与响应类型(DevTools Network 或扩展调试)。
  2. 分类层:端点规则是否映射到正确的 platform / resource / account(通配符、版本路径、GraphQL、分页)。
  3. 传输层:回调是否打到正确环境,认证与幂等键是否有效。
  4. 原始层:原始快照是否持久化,字段与组织归属是否完整——不能只看 HTTP 状态。
  5. 解析层:解析器版本与字段映射是否覆盖当前响应;「解析 0 条」应视为失败。
  6. 呈现层:业务页面用同一账号与时间范围查询,数量、字段与更新时间是否一致。

流程上先固定测试样本(平台、账号、扩展版本、后端环境、一条可唯一识别的数据),每层只修第一个失败层,修复后从该层向下回归。

边界与质量门槛

适用:扩展故障、平台有响应但无数据、验收扩展版本与线上后端组合、补端点/解析器覆盖。

输出结论需指向首个失败层和一条最短修复路径;使用真实页面与 Network 证据,明确版本与环境,同时核对原始快照与标准化结果,不输出 Cookie、Token 或完整响应中的个人敏感数据。

使用场景

  • 扩展已拦截到平台请求且 HTTP 成功,但账号画像或运营看板仍查不到对应记录,需要逐层定位断点
  • 内容脚本或网络拦截器升级后,新 GraphQL operation 或分页接口未被正确分类为已知 platform/resource
  • 验收某扩展版本与线上回调环境组合时,需核对捕获、原始快照入库与解析出标准记录是否一致
  • 新增平台端点或响应结构变更后,要确认解析器字段映射仍有效,避免「任务完成但解析 0 条」

适合人员

  • 维护浏览器采集扩展的工程师,需在真实平台页面上区分「请求成功」与「业务数据已入库」
  • 负责回调接收与原始快照存储的后端同学,接到「前端说有数据、库里没有」时需要可复现的排查清单
  • 发布前做端到端验收的 QA,要固定扩展版本、账号与时间窗口,对照 Network 与业务页面结果
  • 平台对接同学在新增端点或改解析规则时,需要按捕获→分类→解析顺序验证覆盖而非只测单接口