用途：帮助把 Apache Spark 应用从 2.x 升级到 3.x，或从 3.x 升级到 4.x，适用于 PySpark、Spark SQL 与 Structured Streaming 项目，也可用于在版本升级前清理废弃警告。
主要能力：按六个阶段组织迁移流程——清单与影响分析、构建文件更新、API 迁移、配置迁移、SQL 与 DataFrame 迁移、测试验证。每阶段给出检查清单，并提示参考官方迁移指南 https://spark.apache.org/docs/latest/migration-guide.html。
使用方式：先扫描代码库评估范围，识别当前与目标 Spark 版本，搜索废弃 API 与配置项，输出 spark_upgrade_impact.md；再更新 Maven、SBT、Gradle 或 PySpark 依赖版本，必要时调整 Scala 与 Java 级别；随后按编译错误替换已移除 API，如用 SparkSession 替代 SQLContext/HiveContext、用 longAccumulator 替代 sc.accumulator；接着重命名或替换配置键；再审查 SQL 行为变化，如 ANSI 模式、类型转换与时间解析；最后编译、跑测试并对比升级前后结果。
限制：资料未提供具体支持的 Spark 版本范围、自动化程度、收费方式或平台信息；实际迁移需以官方迁移指南为准，部分行为变化可能需临时设置 spark.sql.legacy.* 标志。