CodeBuddy提供Web界面、CLI、IDE插件和Craft模式四类重构方式：Web用于高风险模块人工确认；CLI支持跨目录批量自动化重构并自动备份；IDE插件实现上下文感知的渐进式改写；Craft模式支持多文件协同变更。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你面对一个运行多年、结构混乱、注释缺失、命名随意的老旧项目，又缺乏足够人力与时间逐行人工重构时，CodeBuddy能基于语义理解自动完成语法升级、模块解耦、重复逻辑合并与现代规范适配，避免引入逻辑偏差。
用Web界面逐文件确认高风险模块
该方式适合支付路由、权限校验等核心模块的首次重构验证，所有修改均需人工确认，防止关键路径误改。
1、访问CodeBuddy控制台，点击“新建重构任务”按钮。
2、在弹出窗口中选择“上传源文件”，支持.js、.java、.py、.go等主流语言文件；【注意：C++文件必须已配置编译器路径且compile_commands.json存在，否则AST解析失败】。
3、粘贴原始代码或拖入本地文件后，勾选“保留功能一致性校验”选项——这会触发运行时行为模拟，防止纯语法转换引入逻辑偏差。
4、点击“开始分析”，等待AI完成代码理解与问题诊断；典型响应时间在8～22秒之间，取决于函数嵌套深度与外部依赖数量。
5、查看生成的重构报告，其中所有函数重命名均遵循项目既定风格规范，重复逻辑被合并为单一可复用单元。
用CLI执行跨目录批量自动化重构
这是处理大型工程最高效的方式，天然支持Git集成与备份回滚，比如对/src/main/java/com/example/service/下全部37个类统一升级。
第一步：在终端中执行codebuddy login完成身份认证。
第二步：进入项目根目录，运行以下指令：
codebuddy code --refactor "将/src/main/java/com/example/service/下所有含@Transactional的方法拆分为独立Service类，每个类仅负责单一业务域，保持原有Spring AOP切面生效"
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 问题
第三步：CLI自动扫描匹配文件，生成diff预览，提示共影响19个Java文件、新增8个@Service类、移除32处冗余try-catch包裹。
第四步：输入y确认执行，重构后代码自动写入原文件并备份至.codebuddy/backup/目录；【备份文件带时间戳且不可覆盖，误操作可秒级恢复】。
用IDE插件做上下文感知改写
适合日常开发中边写边重构的渐进式优化，所有操作均通过语义理解而非简单字符串匹配实现。
方法一：右键重构符号
在任意一个.py文件中，将光标停在要重构的函数名上（例如calculate_total）→ 右键 → 选择“Refactor Symbol Across Files”。CodeBuddy会自动扫描工作区中所有已打开的Python文件及python.defaultInterpreter所指向解释器路径下的import可达文件。
方法二：选中代码块强制触发
用鼠标拖选从初始化语句到循环结束大括号内的全部内容（含累加器变量声明）→ 右键 → 选择Refactor → Transform Loop to Functional Chain。CodeBuddy会分析数据源、中间变换和最终聚合行为，生成语义等价的不可变链式表达式。
方法三：按规范重写局部逻辑
在编辑器中打开需重写的Java类，选中某段混乱逻辑（例如包含多层嵌套if、硬编码SQL、未关闭流的代码块）→ 右键选择“Rewrite Selected Code with Best Practices” → 在弹出面板中指定目标规范，如“使用try-with-resources”或“替换为参数化查询”。
用Craft模式声明多文件协同变更
适合页面级或模块级同步变更，比如新增一个微信小程序页面，需同时更新wxml、wxss、js和app.json四类文件，确保语义一致。
在CodeBuddy对话框输入自然语言需求，例如：“添加用户反馈表单页面，含提交按钮、输入校验和弹窗提示”
紧接着追加显式文件引用，格式为：
@pages/feedback.wxml @pages/feedback.wxss @pages/feedback.js @app.json
回车执行后，系统会解析这组文件的结构与项目配置，生成语义一致的代码，并自动在app.json中注册新页面路径。
