OpenCLI 自修复协议解析网站改版时AI如何自动修复适配器并重试【免费下载链接】OpenCLIMake Any Website into CLI Use your logged-in browser by AI agent.项目地址: https://gitcode.com/gh_mirrors/ope/OpenCLIOpenCLI是一个把任意网站变成命令行接口的开源工具让 AI Agent 直接操作你已登录的浏览器。当网站改版导致命令失效时它的**自修复协议Self-Repair Protocol**能驱动 AI 自动收集现场证据、定位根因、修复适配器并重试——全程无需人工干预。本文用一次真实的选择器失效事故带你完整拆解这套自动修复重试机制。为什么网站改版会击穿 CLI 适配器OpenCLI 为知乎、微博、Bilibili、小红书等上百个站点编写了适配器Adapter把网页数据转成结构化 CLI 输出但网站不承诺接口稳定——今天还在的.HotList-item元素明天可能改名为.HotItem返回 JSON 的 API 字段也可能悄悄换位置。此时命令报错传统做法是等维护者发新版本而 OpenCLI 的思路是让 AI 当场修好它。自动修复 6 步流程从报错到重试自修复协议定义在设计文档 designs/self-repair-protocol.md 中完整执行规则封装在技能文件 skills/opencli-autofix/SKILL.md。AI Agent 加载opencli-autofix技能后失败时按以下流程行动第 1 步用 Trace 收集现场证据AI 不会只盯着错误信息而是重跑一次命令并开启失败保留追踪opencli site command --trace retain-on-failure运行时会把浏览器动作时间线、失败的网络请求、Console 日志、页面快照和截图整理成一套证据包存放在~/.opencli/profiles/default/traces/下。Trace 产物由 src/observation/ 模块生成并做了隐私脱敏处理。第 2 步读 summary.md锁定根因证据包的入口是summary.md它的 front matter 直接告诉 AI 三件关键事errorCode如SELECTOR元素没找到、EMPTY_RESULT接口返回变了errorMessage人类可读的失败描述adapterSourcePath待修复的适配器源码的准确路径adapterSourcePath的解析逻辑在 src/adapter-source.ts 中实现并在 src/execution.ts 注入观测会话。这一设计保证了无论用户是克隆源码还是npm安装AI 都能找到真正可编辑的那个文件而不是凭感觉猜路径。第 3 步探索网站的现状AI 用opencli browser打开真实页面观察当前 DOM 结构或拦截新的 API 请求对比适配器期望的和页面实际提供的之间的差距。例如知乎热榜案例中旧选择器.HotList-item已消失新结构是.HotItem。第 4 步最小化修改适配器修复遵循严格的最小改动原则只换选择器、只改接口路径、只调整等待条件保持输出结构不变。协议明确禁止修改 src/ 核心运行时、extension/ 扩展等受保护目录——只能动 trace 指定的那一个适配器文件。第 5 步重试验证预算 3 轮AI 重跑原命令验证修复。如果同样的错误再次出现换一种思路再试最多 3 轮修复诊断 → 修改 → 重试用尽后停止并向用户汇报尝试过什么避免死循环。第 6 步把修复反馈给上游重试通过后本地适配器已与上游漂移。AI 会起草一个结构化 issue标题形如[autofix] zhihu/hot: SELECTOR经用户确认后提交让修复回流到项目本身——社区每一次自修复都变成全用户的资产。安全边界哪些情况 AI 明确不修协议最重要的部分不是怎么修而是什么时候停手信号含义AI 的动作AUTH_REQUIRED退出码 77Chrome 未登录该站提示用户登录不动代码BROWSER_CONNECT退出码 69扩展/守护进程未连接提示运行opencli doctor验证码 / 限流 / IP 封锁与适配器无关报告并稍后再试站点功能已下线数据真的没了报告建议废弃该适配器还有一个反直觉的细节EMPTY_RESULT空结果未必是 bug——平台反爬策略可能塑形了结果。协议要求 AI 先换关键词或换入口重试确认可复现后才进入修复流程避免修好噪声、弄坏正常路径。快速上手让 AI 开始自动修复先确认环境连通opencli doctor给你的 AI Agent如 Claude Code、Cursor安装opencli-autofix技能正常使用opencli site command失败时 AI 会按上述 6 步自动处理无需新命令、无需诊断环境变量-v控制人类可读日志--trace控制机器可读证据两条控制轴互不干扰。小结OpenCLI 的自修复协议 Trace 证据包 明确的根因分类 最小化补丁 3 轮重试预算 硬停止边界。它把网站改版导致爬虫失效这个运维难题变成了 AI 可自主闭环的日常工作流。想深入阅读推荐两份一手资料设计文档designs/self-repair-protocol.md执行协议skills/opencli-autofix/SKILL.md观测与脱敏实现src/observation/【免费下载链接】OpenCLIMake Any Website into CLI Use your logged-in browser by AI agent.项目地址: https://gitcode.com/gh_mirrors/ope/OpenCLI创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考