SuperAPI AI 工具集

heal

通用与其它

查看项目

更新于 10-16 07:18

技能介绍

用途:诊断并修复损坏的足球数据管道。当抓取器或 API 调用失败时,判断原因并选择本地修复或上报上游。

前置步骤:先读取 .nutmeg.user.md;若不存在,提示用户先运行 /nutmeg:init。

诊断流程:

  1. 识别故障。向用户询问错误信息或行为,常见类别包括:HTTP 403/429(限流或被封,等待并退避重试)、HTTP 404(URL/端点变化,检查站点是否重构)、HTML 解析错误(网站改版,需更新选择器)、JSON 解析错误(API 响应结构变化,检查版本)、空响应(该赛事/赛季无数据)、导入错误(库版本变化,查更新日志)、认证错误(密钥过期、轮换或格式错误)。
  2. 调查。判断问题是本地(用户代码)还是上游(提供方/库变更)。网页抓取器:抓取页面并对比 HTML 结构与预期;API:发最小测试请求验证端点;库:查看 GitHub issues 与近期提交。
  3. 修复策略。本地问题:直接改代码,更新选择器、URL 或解析逻辑,加入错误处理与重试。上游库缺陷:检查是否已有 issue,没有则协助写清晰的缺陷报告(库名与版本、最小复现步骤、预期与实际行为、错误回溯);若修复简单,可协助写 PR(fork、分支修复、清晰 PR 描述)。提供方变更(API/网站):记录变更内容,更新本地代码适配新格式;若使用抓取库,向该库提交 issue。

自愈模式:通过 /nutmeg:acquire 编写数据获取代码时内置韧性,例如带指数退避的重试逻辑。

常见来源修复:FBref 429 限流,请求间加 6 秒延迟;WhoScored 被 Cloudflare 拦截,使用有头浏览器(Playwright);Understat JSON 解析错误,响应为 JSONP,需剥离回调包装;SportMonks 401,令牌过期或套餐限额;StatsBomb 开放数据 404,比赛/赛事不在开放数据集中。

限制:资料未提供该技能的安装方式、收费、平台支持范围及具体效果数据。