用途：把 2018–2021 时代的遗留 UI5 freestyle JavaScript 应用（同步启动、jQuery.sap.*、ES5、sap_belize 主题、无类型）转换为基于较新 1.x 版本的 UI5 TypeScript 应用。转换后具备异步加载、manifest 驱动配置、BaseController、sap_horizon 主题、ES 模块、类型化事件处理器，并通过 ui5-linter 与 tsc --noEmit 检查。
主要能力：转换沿用源应用目录，新应用输出到独立目录，两者并行运行，源应用不被改动。路径与命名空间由用户提供，默认源为 legacy-*-app/，现代应用命名空间为源命名空间加 .modern。
使用方式：转换本身没有专用工具，需先调用 mcp__SAPUI5_MCP_Server__get_typescript_conversion_guidelines 获取权威指南并严格执行；过程中使用 UI5 MCP 做脚手架、API 查询、lint 与 manifest 校验，使用 sap-docs MCP 查 V4 绑定、草稿处理与控件文档；arc-1 MCP 为可选。
关键限制与陷阱：FCL 路由必须显式声明 layout，否则只显示一列；组件 div 需内联 style="height: 100%"，避免高度为 0 的白屏；应使用具体事件类型（如 ListBase$SelectionChangeEvent），不要导入通用 Event；press 处理器在不用事件参数时不声明参数；manifest v2 路由需在 config 与各 target 显式加 type: "View"，并使用 name/path/level 替代 viewName/viewPath/viewLevel。注意 linter 与 manifest 校验无法捕获路由键废弃问题，必须通过浏览器渲染验证。当遇到未覆盖的中间件配置、控件事件类型或 V4 绑定时，应查阅对应 README 或调用 API 查询，不要猜测。