SuperAPI AI 工具集

mirror-doctor

通用与其它

查看项目

更新于 10-15 21:53

技能介绍

Mirror Pipeline Doctor 专注于诊断并修复已存在的 Goldsky Mirror 流水线问题,通过运行 CLI 命令、识别根因并执行修复来恢复流水线运行。它不用于新建流水线(应使用 /mirror 或 /turbo-builder),不提供命令参考,不处理 Turbo 流水线(应使用 /turbo-doctor),也不创建密钥(应使用 /secrets),但会在诊断中检查密钥是否存在。

诊断按顺序进行:先运行 goldsky project list 确认登录;再运行 goldsky pipeline list --include-runtime-details 识别流水线及其期望状态与运行时状态;依据 ACTIVE/PAUSED/INACTIVE 与 RUNNING/STARTING/FAILING/TERMINATED 的组合确定诊断路径,其中 ACTIVE + TERMINATED 最常见。随后收集数据,依次运行 goldsky pipeline monitor、monitor --update-request、get --definition、info 和 snapshots list。

根据输出匹配已知错误模式:密钥错误或缺失、接收端不可达、资源耗尽、请求在途阻塞、快照卡住、转换 SQL 错误、重启循环以及接收端宕机级联。修复手段包括 goldsky secret update、goldsky pipeline resize(s、m、l、xl、xxl)、goldsky pipeline cancel-update,以及 git 命令 restart、apply、delete 等,重启时默认使用 --from-snapshot last 以保留进度,--from-snapshot none 会从头处理数据。执行破坏性命令前需与用户确认。若问题超出 CLI 诊断范围,建议联系 support@goldsky.com 并提供流水线名称、错误信息和项目 ID。无 Bash 工具时,应逐条给出命令并说明输出要点。