OpenCLI 适配器自动修复
opencli 命令因站点改版报错时,读诊断信息定位根因、改 adapter 源码并重试,验证通过后再提 issue 到上游。
功能与用途
平时能用的 opencli 命令突然抓不到数据或找不到元素,多半是网站改了 DOM、接口或响应结构。它会先排除「空数据不等于坏了」的情况(换个关键词、看 Chrome 里是否正常、识别软 404),确认是代码问题后再用 OPENCLI_DIAGNOSTIC=1 拿到诊断 JSON,按错误码分类原因,用 opencli browser 现场探查新版页面,只改 RepairContext 指定的那一个 adapter 文件并重试,最多三轮。前提是装好 opencli、gh CLI 并登录。
适用场景
- DOM 变更元素缺失修复:网站改版导致选择器失效报 SELECTOR 错误时,现场探查新 DOM 并更新适配器中的元素定位。
- 接口字段变动调试:网络请求路径或返回数据格式变更导致空结果时,拦截分析接口网络包并重写解析提取逻辑。
- 加载等待与超时修复:目标页面增加懒加载或加载逻辑变更导致超时时,动态调整适配器的等待条件与状态判断。
适用人群
- 维护 opencli 适配器的开发者
- 依赖 opencli 抓数但站点一改版就断的自动化工程师
- 开源 CLI 项目的维护者
使用步骤
- 先确认失败不是假故障:换关键词或换入口重试、在正常 Chrome 标签页里看数据是否可见、识别软 404,只有多次复现才进入修复。
- 跑 OPENCLI_DIAGNOSTIC=1 opencli <site> <command> 2>diagnostic.json,从标记之间解析出 RepairContext JSON。
- 读诊断里的 error 码、adapter 源码和页面快照,按 SELECTOR / EMPTY_RESULT / API_ERROR / TIMEOUT / PAGE_CHANGED 分类根因。
- 用 opencli browser open、state、click、network 现场探查新版页面,只修改 RepairContext.adapter.sourcePath 指向的那一个文件,保持 columns 和返回结构不变。
- 正常模式重跑命令验证,通过后再提交上游 GitHub issue;三轮修不好就停下汇报已尝试的内容。
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 编程
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 专业
- 版本
- main
- 最近更新
- 2026-09-14
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
Automatically fix broken OpenCLI adapters when commands fail. Load this skill when an opencli command fails — it guides you through diagnosing the failure via OPENCLI_DIAGNOSTIC, patching the adapter, retrying, and filing an upstream GitHub issue after a verified fix. Works with any AI agent.
使用前准备
- 已安装 opencli 且 opencli doctor 通过,Chrome 已登录目标站点
- 如需提 issue 还需安装并登录 gh CLI。
依赖与权限
- 读取用户主动提供的内容