用途：为 Red Hat Developer Hub（RHDH）客户做升级评估，回答“目标版本的所有变更中，哪些真正影响我的环境”。
主要能力：解析 Helm values、app-config、dynamic-plugins、Backstage CR、.env 等配置（按内容自动识别类型）；从随附的 plugin-catalog-index 镜像（备选 rhdh-plugin-export-overlays 仓库）与发布说明获取版本差异、破坏性变更、插件版本跳变与支持级别变化；针对配置中每个插件查询 RHDHBUGS Jira 与 redhat-developer/rhdh GitHub Issues 中的已知缺陷；对 1.y→2.y 大版本升级提供图表值迁移映射与脚本 scripts/migrate-chart-values.py；按 references/config-scoring.md 计算就绪评分；输出含迁移步骤、升级清单和“不影响你”章节的客户报告；建议用 RHDH Local 做升级前测试。处理前会扫描配置中的明文密钥（模板变量 ${VAR} 安全）。
使用方式：以 /rhdh-upgrade-helper 调用。常用形式包括：无参数时读取当前目录 .rhdh-upgrade-helper.yaml；--to 1.10 --config ./values.yaml（可重复指定文件）；--to 1.10 --config-path ./my-configs/；--to 1.10 进入交互问答；跨版本 --from 1.8 --to 1.10；大版本 --from 1.10 --to 2.1 走图表迁移流程。--to 必填；无配置来源时检查配置文件，否则先问 7 个环境问题；未取得环境前不会输出通用报告。
适用场景：RHDH 客户升级前评估、跨版本跳级、1.y→2.y 图表迁移、插件缺陷排查。
限制：依赖 Jira、GitHub 与发布资料的可访问性，Jira 不可用时降级为 GitHub Issues 与发布说明；严重依赖配置或环境信息，缺失则只能走交互问答；迁移脚本仅覆盖机械翻译，歧义处需人工确认。价格、平台支持范围等资料暂未提供。