用途：系统化规划并执行 Frappe/ERPNext 版本迁移，在升级前检测破坏性变更，避免迁移失败；也用于升级后报错诊断、自定义应用兼容性检查。
主要能力：识别迁移路径（禁止跳过大版本，如 v14→v16 需经 v15）；按版本列出破坏性变更（如 v14→v15 的调度间隔、后台任务去重、Workspace 替代 Module Def、打印格式引擎、MariaDB/Python 版本要求等；v15→v16 的 extend_doctype_class、Chrome PDF、UUID 命名、Node/Redis 版本要求等）；用 grep 扫描自定义应用中的废弃模式；生成迁移计划、补丁清单与风险评估。
使用方式：按五步流程执行——识别迁移路径、检查破坏性变更、扫描自定义代码、生成迁移计划、生成补丁列表。常用命令包括 bench version、bench --site {site} backup --with-files、bench switch-to-branch version-{target} frappe erpnext、bench --site {site} migrate、bench build --production、bench restart 等。
适用场景：计划版本升级、bench update 后出错、评估自定义应用能否在新版本运行、迁移中途遇到问题（可配合 frappe-agent-debugger）。
限制：资料未提供具体收费、平台支持范围与实测效果；迁移前需自行确认环境版本与备份，具体变更以官方文档为准。