codebuddy迁移需规范源码结构、编码及配置：提取待迁模块至/legacy/，确保utf-8编码；配置migration-spec.json明确目标框架、api风格等；web ui或cli执行迁移时须声明全局变量；校验响应式声明、异步逻辑封装及jquery残留。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
让CodeBuddy完成从旧技术栈（如jQuery+AJAX）到现代框架（如Vue 3+Composition API）的代码迁移，需明确指定源码结构、目标规范及转换约束条件，否则生成结果会遗漏关键逻辑或破坏数据流。
准备待迁移的源代码
将原始项目中需要重构的模块单独提取为独立文件，例如把 user-list.js 和配套的 user-list.html 放入新建的 /legacy/ 文件夹。不要直接提交整个旧项目仓库——CodeBuddy对超大目录响应缓慢，且易混淆入口文件。
确认源文件编码为UTF-8，若含GBK编码的中文注释，迁移后会出现乱码，导致组件props解析失败。
在根目录下新建 migration-spec.json，写入目标框架版本、API风格偏好（Options API / Composition API）、是否保留原命名习惯等约束项。
配置CodeBuddy迁移规则
方法一：通过Web UI交互式配置
打开CodeBuddy官网 → 登录账号 → 点击「New Migration」→ 上传 /legacy/ 文件夹 → 在「Target Framework」下拉菜单中选择「Vue 3 (Composition API)」→ 勾选「Auto-generate TypeScript types」→ 点击「Confirm & Start」。
方法二：使用CLI命令行批量迁移
CodeBuddy Code CLI 的安装、配置与使用指南。CodeBuddy Code 是腾讯推出的 AI 驱动 CLI 编程助手，支持自然语言驱动开发。 - 必备触发词：CodeBuddy, codebuddy, AI CLI, Tencent AI coding, @tencent-ai/codebuddy-code, terminal AI assistant - 适用场景：安装 CodeBuddy CLI、配置 CodeBuddy、使用 CodeBuddy 命令、排查 CodeBuddy 问题
执行：npx codebuddy migrate --src ./legacy --target vue3 --ts --rules ./migration-spec.json。该命令会跳过 node_modules 和 .git 目录，但若 ./legacy 路径下存在未声明的全局变量引用（如 window.API_BASE），需提前在 migration-spec.json 中用 "globals": ["API_BASE"] 显式声明，否则转换后的 setup() 函数内无法正确注入。
校验与修正迁移结果
第一步：检查响应式数据声明是否完整
对比原jQuery代码中 var userData = []; → CodeBuddy应将其转为 const userData = ref([]);；若生成的是 let userData = [];，说明未识别出该变量参与DOM更新，需在 migration-spec.json 中补充 "reactiveVars": ["userData"]。
第二步：验证异步请求逻辑是否封装为组合式函数
原 $.get('/api/users', callback) 应被提取为独立的 useUserList() 组合函数，并在组件中通过 const { data, loading } = useUserList(); 调用。若仍保留在 setup() 内联调用，说明源码中回调函数未被识别为独立业务单元，需将该段AJAX逻辑拆出为独立函数再重试迁移。
第三步：运行迁移后代码
执行 npm run dev 启动本地服务，打开浏览器控制台，观察是否存在 【Uncaught ReferenceError: $ is not defined】 报错——这表示某处残留了未转换的jQuery选择器（如 $('#search-input').val()），必须手动替换为 ref 绑定或 querySelector 原生调用。
