用途：为 Saleor Configurator 提供系统化的 CLI 失败诊断与修复框架，适用于任意 CLI 命令以非零退出码失败、用户上报 configurator 错误信息、部署部分失败、调试 GraphQL 或引用问题时。查找部署工作流应改用 configurator-workflow，查找 JSON 信封结构应改用 agent-output-parsing。
主要能力：按退出码分类错误（0 成功、1 未预期、2 认证、3 网络、4 校验、5 部分失败、6 删除被阻止、7 破坏性变更被阻止）；通过 JSON 信封收集上下文；对部分失败按实体下钻；识别常见错误模式（认证、校验、重复实体、无效引用、限流）并给出对策；输出固定结构的问题报告（问题、根因、解决方案、验证、预防）。
使用方式：先解析 JSON 信封输出，例如执行 pnpm dlx @saleor/configurator validate --json 2>/dev/null | jq '.' 做本地无网络校验，用 pnpm dlx @saleor/configurator diff --entity "Type/name" --json 2>/dev/null | jq '.' 查看单实体差异，并用 ls -t deployment-report-*.json 2>/dev/null | head -1 | xargs cat | jq '.' 读取最近部署报告。部分失败时可用 pnpm dlx @saleor/configurator deploy --json 2>/dev/null 提取 .errors 中的失败实体，再以 diff --entity 或 diff --entity-type 下钻字段级差异。认证问题可用 curl -X POST $SALEOR_URL -H "Authorization: Bearer $SALEOR_TOKEN" -H "Content-Type: application/json" -d '{"query": "{ shop { name } }"}' 验证。
限制与注意：认证失败需确认 SALEOR_URL 以 /graphql/ 结尾并使用 HTTPS、重新生成令牌并检查 MANAGE_* 权限；校验失败需修正 config.yml 架构错误；引用错误需保证被引用实体先部署；限流时可降低 GRAPHQL_MAX_CONCURRENCY（默认 4）或用 --include 分批部署。具体价格、平台支持范围等资料未提供。