用途：将现有 FineUI 项目从旧大版本升级到更高大版本，仅覆盖 v10 及以上，v9 及以下不在范围内。内置高影响破坏性变更清单覆盖到 v16.0；目标版本高于 v16.0 时建议先更新技能（npx skills update）。
主要能力：确定版本区间、判定项目写法（F.js / Pro / Core-MVC / Core-RazorForms / Core-RazorPages / Java）、对照破坏性变更清单、生成迁移清单（如 FINEUI_UPGRADE_PLAN.md，含受影响文件、变更点、改前改后）、逐项确认并应用、给出验证建议。
使用方式：按顺序执行，不跳步。先询问或依据 FineUI.js 版本注释、NuGet 包版本、web.config/csproj 确定当前与目标版本；再确定写法，只处理该写法相关变更（清单中 [JS]/[Pro]/[Core] 按需取用）；读 references/breaking-changes.md 逐条比对，跨多版本时逐版本过一遍；先出清单不改代码；对行为变更类逐项确认，对改名类默认直接改；应用后报告改动文件。验证建议：JS 端 npm run build-f 或跑页面；Core 端 dotnet build；Pro 端 VS2022 msbuild 编译；并人工核对受 HTML 编码影响的页面。
适用场景：FineUI 跨大版本迁移，重点处理 HTML 编码安全主线与 v16 事件/回发迁移。FineUI.Java 首发即 v16.0，无旧版本升级场景，仅其复用的 F.js 客户端破坏性变更相关。
限制：ESM/class 化官方声明不影响对外 API，不应据此改用户代码；用户输入不要声明为可信 HTML（可信内容用 RawHtml）；不确定的变更须查官方在线发布历史 https://fineui.com/versions/ 或官网，不得编造。