SuperAPI AI 工具集

subgraph-doctor

通用与其它

查看项目

更新于 10-15 21:53

技能介绍

用途:诊断并修复已存在的 Goldsky Subgraph 问题,包括失败、停滞、卡同步、不索引、自动暂停、部署失败等。不负责新建或脚手架 Subgraph(用 /subgraph-builder),不处理 The Graph 迁移(用 /subgraph-migrate),不处理 Turbo/Mirror 管道(用 /turbo-doctor、/mirror-doctor),也不作为命令参考。

主要能力:按症状分诊,区分部署期错误、索引停滞、处理器/映射错误、端点或未同步、运营/配额问题;通过日志与 _meta 查询收集证据;匹配常见错误模式(网络错误、apiVersion 混用、接口未定义、timeseries 规范错误、重复版本、映射空指针、WASM trap、上游 RPC 异常等);给出修复建议并执行修复命令。

使用方式:先确认登录 goldsky project list 2>&1;用 goldsky subgraph list 2>&1 识别目标;按症状取日志 goldsky subgraph log <name/version> --since 1h --filter error 2>&1,避免拉取未过滤日志;对 GraphQL 端点执行 _meta 查询查看 deployment、hasIndexingErrors、block。修复命令包括 goldsky subgraph start/pause/deploy/delete,重新部署可加 --start-block 回滚到首个受影响区块。有 Bash 时直接运行,无 Bash 时逐条给出命令并依据用户回贴推进。

适用场景:Subgraph 部署失败、卡块、自动暂停、查询 404 或无数据、映射报错等客户侧排障。

限制:仅使用 goldsky CLI、仪表盘和 GraphQL 查询,不得建议 graphman、kubectl、Datadog 或直连数据库;运营/配额、上游 RPC 缺陷、正确重部署后仍报错等情况应升级至 support@goldsky.com。破坏性操作前需确认;重新部署会生成新的不可变版本,建议用标签保持前端 URL 不变。具体收费、价格与平台细节暂未提供。