CodeBuddy跨文件重构依赖上下文感知与依赖图谱驱动，通过Craft模式声明多文件、拖入项目目录激活工程分析、CLI自然语言批量重构、@符号锚定参考源四类方式实现关联修改自动辐射。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
CodeBuddy跨文件重构不是简单地逐个改文件，而是靠上下文感知和依赖图谱驱动，让修改自动辐射到所有关联位置。关键在于告诉它“哪些文件要一起看”“改什么逻辑”“保持什么一致性”。下面分三类典型场景说明操作方式。
一、用Craft模式声明多文件上下文
适合页面级或模块级同步变更，比如新增一个微信小程序页面，需同时更新wxml、wxss、js和app.json。
- 在CodeBuddy对话框输入自然语言需求，例如：“添加用户反馈表单页面，含提交按钮、输入校验和弹窗提示”
- 紧接着追加显式文件引用，格式为：@pages/feedback.wxml @pages/feedback.wxss @pages/feedback.js @app.json
- 回车执行后，系统会解析这组文件的结构与项目配置，生成语义一致的代码，并自动在app.json中注册新页面路径
二、拖入整个项目目录激活工程级依赖分析
适合涉及深层调用链的重构，比如把一个Service方法改成异步，需要同步更新Controller、DTO、Test等多处。
CodeBuddy VS Code插件
CodeBuddy VS Code插件下载入口，整理CodeBuddy腾讯云代码助手的官方插件地址、安装入口和基础功能说明。
下载
- 打开CodeBuddy侧边栏的Context区域
- 将项目根目录（含src/main/java、src/main/resources等）直接拖入对话框
- 输入指令，例如：“重构用户管理模块，将UserServiceImpl中的createUser方法升级为支持异步写库，并同步更新对应Controller返回值与单元测试断言”
- CodeBuddy基于Maven依赖解析结果，自动定位所有被影响的类，批量生成兼容变更的补丁
三、用CLI执行自然语言驱动的批量重构
适合无GUI环境或自动化集成，比如统一把回调函数转成async/await风格。
- 终端中进入项目根目录，先运行codebuddy login完成认证
- 执行命令：codebuddy code --refactor "将/server/api/下的所有回调函数改为async/await风格，并确保错误统一由Express全局中间件捕获"
- CLI自动扫描匹配文件，生成diff预览，提示影响范围（如：共7个文件，新增3处try/catch，移除12处if(err) return callback(err)）
- 确认后一键应用，支持--dry-run预检、--model指定模型等参数
四、跨文件复用逻辑时用@符号锚定参考源
避免语义偏移，尤其当多个文件共享相似处理逻辑（如统一的请求拦截、错误格式）。
- 在编辑器中打开参考文件，例如utils/request.js
- 在CodeBuddy提问框中输入@，再选择该文件
- 接着写需求，例如：“为登录接口增加token自动刷新逻辑，参考@utils/request.js中interceptors的错误拦截写法”
- AI会继承原文件的命名习惯、参数结构、异常处理策略，保证新代码与现有风格一致