codebuddy提供四条可落地的重构路径：web界面逐文件确认（适合高风险核心模块人工验证）、cli批量语义重构（支持git集成与备份回滚）、ide插件上下文感知改写（含智能提取方法与跨文件重命名）、sub-agents并行协同处理（分任务调度多模型协同执行）。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你面对一个包含数百个源文件、多层模块依赖、跨语言混合的大型项目，需要安全高效地完成职责拆分、接口标准化或架构升级时，CodeBuddy 提供了四条可落地的重构路径：Web界面逐文件确认、CLI批量语义重构、IDE插件上下文感知改写、Sub-Agents并行协同处理。每种路径对应不同风险偏好与人力投入水平。
通过Web界面上传分析单文件关键模块
该方式适合高风险核心模块（如支付路由、权限校验）的首次重构验证，所有修改均需人工确认。
1、访问CodeBuddy控制台，点击“新建重构任务”按钮。
2、在弹出窗口中选择“上传源文件”，支持.js、.java、.py、.go等主流语言文件；【注意：C++文件必须已配置编译器路径且compile_commands.json存在，否则AST解析失败】。
3、粘贴原始代码或拖入本地文件后，勾选“保留功能一致性校验”选项——这会触发运行时行为模拟，防止纯语法转换引入逻辑偏差。
4、点击“开始分析”，等待AI完成代码理解与问题诊断；典型响应时间在8～22秒之间，取决于函数嵌套深度与外部依赖数量。
5、查看生成的重构报告，其中所有函数重命名均遵循项目既定风格规范，重复逻辑被合并为单一可复用单元。
使用CLI执行跨目录批量自动化重构
这是处理大型工程（如含/src/main/java/com/example/service/下全部37个类）最高效的方式，天然支持Git集成与备份回滚。
第一步：在终端中执行codebuddy login完成身份认证。
第二步：进入项目根目录，运行以下指令：
codebuddy code --refactor "将/src/main/java/com/example/service/下所有含@Transactional的方法拆分为独立Service类，每个类仅负责单一业务域，保持原有Spring AOP切面生效"
第三步：CLI自动扫描匹配文件，生成diff预览，提示共影响19个Java文件、新增8个@Service类、移除32处冗余try-catch包裹。
第四步：输入y确认执行，重构后代码自动写入原文件并备份至.codebuddy/backup/目录；【备份文件带时间戳且不可覆盖，误操作可秒级恢复】。
在IDE中启用上下文感知重构
适用于日常开发中边写边优化的渐进式重构，尤其擅长处理调用链深、依赖隐晦的模块。
统一LLM网关 - 一个API对接70+AI模型，使用单一API密钥即可调用GPT、Claude、Gemini、Qwen、Deepseek、Grok等主流模型。
方法一：智能提取方法
1、在VS Code中安装CodeBuddy插件后，打开待重构的Java服务类。
2、将光标置于一个超过80行、含多个if分支和数据库查询的public方法名上。
3、右键选择“CodeBuddy → 提取为独立Service”，插件自动识别该方法所依赖的Repository、Config、Utils等Bean，并生成带@Autowired注入的新类。
方法二：跨文件重命名
1、选中某个被多处import的工具类名（如DateUtils），按F2触发重命名。
2、输入新名称（如TimeConversions），插件立即扫描整个workspace，同步更新所有import语句与调用点。
3、预览窗口显示变更涉及5个模块共23处，点击“应用”即完成——【不依赖正则替换，避免误改字符串字面量】。
调用Sub-Agents并行处理复合重构任务
当任务同时包含代码改写、测试生成、规范检查三项需求时，必须启用Sub-Agents模式，否则无法保证结果一致性。
1、在CodeBuddy对话窗口输入自然语言指令：“请帮我完成以下任务：将user-service模块中所有基于RestTemplate的HTTP调用替换为WebClient；为每个改造后的Service类生成JUnit 5测试；检查所有改动是否符合Alibaba Java Coding Guidelines v2.2”。
2、系统自动识别为三子任务，弹出Sub-Agents分配面板：左侧显示代码重构Agent、测试生成Agent、代码审查Agent三个图标。
3、手动将重构Agent模型设为DeepSeek R1（强推理），测试Agent设为混元T1（轻量快响应），审查Agent保持默认配置。
4、点击“启动并行执行”，聊天窗口实时显示各Agent进度：“重构Agent：已重写7个类，正在注入WebClient Bean”、“测试Agent：已生成41个测试用例，覆盖率提升至86%”、“审查Agent：发现2处命名未使用驼峰规则”。
5、所有Agent完成后，系统自动合并结果，输出一份包含diff patch、测试文件列表、审查红黄蓝标记报告的汇总文档。
