SuperAPI AI 工具集

opencli-autofix

通用与其它

查看项目

更新于 10-15 22:39

技能介绍

用途:当 opencli <site> <command> 因网站改版导致适配器失效时,自动诊断、修复并重试。适用于 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 探索当前网站,network 支持 --filter 与 --detail。修补时做最小改动,保持输出结构兼容,优先改用 JSON API,仅用 @jackwener/opencli/* 导入。修复后正常运行命令验证,通过后可向 jackwener/OpenCLI 提交 issue(需用户确认,gh 未安装或未认证则跳过)。

限制:EMPTY_RESULT 常非适配器缺陷,需先用替代查询、正常 Chrome 标签页、软 404 与重试排除平台降级或限流;搜索返回 0 条也是有效结果。不得放宽 verify/<cmd>.json 断言来掩盖失败,仅当网站结构本身变化时才可更新 fixture 并记录到 notes.md。3 轮未解决或功能被移除、需整体重写时应停止并说明。