用途：辅助用户把项目从 Wot UI v1（wot-design-uni）迁移到 v2（@wot-ui/ui），只做最小必要的兼容性替换，不新建业务页面、不重构业务逻辑，也不负责安装依赖（由用户在终端自行执行）。
主要能力：扫描 v1 用法；替换包名与导入路径；迁移组件 API；迁移表单校验体系与内置图标名称；修复不兼容变更。核心变更包括：npm 包名 wot-design-uni→@wot-ui/ui，uni_modules 目录 wot-design-uni→wot-ui，wd-message-box→wd-dialog，useMessage→useDialog，wd-status-tip→wd-empty，wd-col-picker→wd-cascader，wd-number-keyboard→wd-keyboard，rules/FormRules→schema/FormSchema，按钮 plain/type="text"/type="icon"→variant/图标按钮，type="error"→type="danger"，标签 plain→variant="plain"，搜索框 light→variant="light"，GridItem @itemclick→@click，工具函数路径 components/common/util→common/util，图标按 icons.json 人工审核结果迁移。
使用方式：开始前先确认安装方式（npm 或 uni_modules）、迁移目标（全量迁移或升级后修错）与目标平台（H5/微信小程序/支付宝小程序）。按关键词加载子文件：错误信息→errors.md，表单→form.md，包名/easycom/Volar/Vite 插件/国际化→infra.md，Sass/主题/Design Token→styles.md，组件与图标→components.md 及 icons.json。推荐流程：依赖升级→路径替换→Form 页面→高影响组件→中低影响组件→图标与低影响属性→样式与主题→回归测试，每阶段与用户确认后再继续。
适用场景：升级 wot-design-uni 到 @wot-ui/ui、替换旧组件与旧 API、迁移表单校验与图标名称、修复 v2 不兼容变更引起的编译或运行时报错。
限制：不负责新建业务页面与业务逻辑重构；不负责安装依赖；图标迁移必须读取 icons.json，只替换确认映射，“无对应”和动态绑定项保留人工决策，禁止对业务字符串做全局替换。具体命令与完整迁移指南内容暂未提供。