用途：当 opencli <site> <command> 因网站 DOM、API 或响应结构变化而失败时，自动诊断、修复适配器并重试。适用于 SELECTOR、EMPTY_RESULT、API_ERROR/NETWORK、PAGE_CHANGED、COMMAND_EXEC、TIMEOUT 等可修复错误。
安全边界：AUTH_REQUIRED（退出码 77）与 BROWSER_CONNECT（退出码 69）必须停止，不改代码，分别提示用户登录 Chrome 或运行 opencli doctor；CAPTCHA/限流也停止。仅可修改 trace summary.md front matter 中 adapterSourcePath 指向的文件，不得改 src/、extension/、tests/、package.json、tsconfig.json。每轮失败最多 3 次修复。
使用方式：先运行 opencli doctor 验证扩展与守护进程连通性。用 opencli <site> <command> [args...] --trace retain-on-failure 2>trace-error.yaml 收集 trace，读取 summaryPath，分析失败并分类根因。用 opencli browser open/state/click/network 探索当前网站，定位新选择器或 API。在 adapterSourcePath 做最小修补，保持输出结构兼容，优先 API 而非 DOM 抓取，仅用 @jackwener/opencli/* 导入。修补后重跑命令验证；通过后可准备上游 issue，经用户确认后用 gh issue create --repo jackwener/OpenCLI 提交。
限制：空结果不一定是适配器 bug，需先排除反爬降级、软 404、认证状态或限流；不可放宽 verify/<cmd>.json 夹具来掩盖失败。3 轮未解决、功能被移除或需整体重写时应停止并报告。