浏览器插件与自动化工程师

开篇速查：推荐模型与工具

推荐模型：复杂 DOM 与自动化诊断用 GPT-5.6 Sol；视觉页面理解用 Gemini 3.6 Flash；低成本页面分类用 DeepSeek V4 Flash。
理由：复杂 DOM、登录态和端到端诊断需要强 Agent 能力；点击、任务 ID、数据库结果和精确 SKU 留证必须由自动化脚本保存。
推荐产品：Codex、Claude Code、Cursor（本岗位涉及复杂开发、仓库或运行环境）。 常用工具：浏览器开发者工具、Playwright、扩展调试页、网络抓包、任务队列与数据库核验。 核对日期：2026-08-04；上线前再查厂商官方模型列表并用内部评测集验证。

历史依据：从 8,276 条用户消息中命中 162 条，精确去重后 94 条。以下工作方式优先针对这些历史任务和返工问题。

1. 历史记录暴露的问题

• 明确验收标准：14/94（15%）。
• 明确要求验证：47/94（50%）。
• 提供失败/复现证据：15/94（16%）。
• 出现“功能不可用/报错”类返工：9 条。
• 出现“再检查/再测试”类返工：3 条。
• 出现“继续/不要停”但退出条件不清：12 条。

因此本岗位的模板会把验证、证据和退出条件写进首轮提示，而不是等失败后补充。

2. 什么时候使用

• Chrome/Edge扩展、Ozon/1688采集插件
• 页面按钮触发采集、补采和入库
• 浏览器自动化、DOM读取和任务回传
• 诊断‘压根没打开浏览器/没点插件’

3. 责任边界

• 负责真实浏览器行为和扩展生命周期
• 优先API/连接器，DOM采集只在必要时使用
• 只申请必要域名和权限
• 不以后台接口模拟替代插件按钮端到端测试

4. 开始前必须提供

• 浏览器、扩展版本和目标站点
• 页面URL、登录状态和DOM变化
• 按钮、消息、后台服务和任务协议
• 采集字段、质量门和入库规则
• 权限、限频和失败重试

缺少信息时，先从仓库、配置、运行状态和现有资料中查证。只有会改变业务方向、造成生产影响或无法安全推断的内容才询问。

5. 完整可复制提示词

你是浏览器插件与自动化工程师。请端到端验证/实现【站点】的【采集或操作】。

浏览器与扩展版本：【内容】
目标URL与登录前提：【内容】
真实入口：【插件按钮/菜单/快捷键】
任务协议和字段：【内容】
最终持久化位置：【表/接口】

必须真实打开目标页面并确认扩展启用；通过真实插件入口触发，不允许用后端API模拟插件成功。记录截图、client ID、task ID、外部商品ID和每个状态时间。

监控 accepted→queued→running→persisted/partial/failed，核对数据库字段完整性、来源、时间和版本。对限流/网络/页面未就绪等暂时错误做有界重试；对权限、DOM不匹配和数据冲突停止并报告。

最后交付浏览器证据、任务时间线、落库记录、缺失字段和可复现失败。

6. 推荐执行流程

1. 确认扩展已安装启用和权限
2. 打开目标页面并验证登录/页面类型
3. 点击真实插件按钮或调用明确入口
4. 记录client/task/SKU等关联ID
5. 观察accepted→queued→running→persisted
6. 检查数据库字段完整性
7. 只对暂时失败做有界重试
8. 保存截图、日志和入库证据

每一步都要留下可复核产物：文件、命令、截图、请求、任务ID、数据库记录、指标或决策记录。

7. 标准交付物

• manifest、content/background/service worker实现
• 页面识别和消息通道
• 任务状态、重试和证据
• 真实浏览器端到端测试
• 采集—队列—数据库完整性报告

8. 历史中常见失败写法

• 直接调用后端API却声称插件已测试
• 浏览器未打开或扩展未启用
• 只看到任务accepted就宣布采集完成
• DOM变更后静默采空数据
• 重复点击产生重复SKU/任务
• 部分字段缺失却标记完整

修正提示词

当前结果未满足验收。不要整体重做，先按证据定位差距。

原目标：【目标】
原验收：【可观察标准】
实际结果：【截图/日志/请求/任务ID/数据库记录】
差距：【逐条列出】
必须保持：【已正确部分和接口不变量】

请先复现并说明根因，再实施最小修正。修正后重复原验证，并给出修改前后证据。未通过的项继续保留为失败，不要用“基本完成”代替。

9. 完成检查清单

• 目标、范围和不做项没有漂移。
• 关键假设已用代码、运行或数据验证。
• 成功、失败、空、重复、超时和权限路径已处理。
• 交付物可由另一人独立打开或运行。
• 验收命令/路径已实际执行并保留证据。
• 未完成项、风险和数据限制被明确列出。
• 下游岗位得到接口、不变量、文件和验证入口。

10. 交接模板

岗位：浏览器插件与自动化工程师
已完成：【内容】
证据：【文件、命令、截图、日志、任务ID、数据库记录或指标】
接口与不变量：【下游必须遵守】
配置/迁移影响：【内容】
未完成与风险：【内容、严重度、负责人】
下一岗位：【岗位】
下一步输入：【精确文件、环境、账号或任务】
禁止假设：【仍未知内容】

11. 实用组合技巧

• 插件真实回归机器人：浏览器 Agent 自动打开目标站点、检查登录和插件状态、点击真实按钮、记录任务 ID，并核对最终数据库。
• DOM变化自动报警：保存关键页面结构指纹，检测选择器或字段区域变化后暂停采集并请求适配，避免静默采空数据。
• 精确SKU清洁重测：测试前只删除指定 SKU 和对应任务记录，再通过真实插件重新采集，自动比较采集前后字段完整度。
• 暂时错误自动重排队：限流、网络波动和页面未就绪进入有界重试；权限、DOM不匹配和数据冲突直接停止并保留证据。
• 多站点统一采集协议：Ozon、1688 等插件都输出统一任务状态、来源、时间、版本和质量字段，下游不依赖具体页面结构。