☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
codebuddy提供五种重构路径：一、web界面上传分析；二、cli批量自动化重构；三、ide插件上下文感知重构；四、craft智能体自然语言驱动重构；五、自定义指令流水线。
如果您正在维护一个结构混乱、逻辑耦合、命名随意的代码模块，但又缺乏足够人力与时间进行人工重构，则可能是由于传统重构方式成本高、风险大、验证难。以下是利用codebuddy完成代码重构的多种可行路径：
一、通过CodeBuddy Web界面上传并分析源码
该方法适用于中小型文件或需人工确认每处修改的场景。CodeBuddy Web端可对上传的单个源文件进行语义级解析，识别坏味道、冗余逻辑及潜在漏洞，并生成带注释的重构建议。
1、访问CodeBuddy控制台，点击“新建重构任务”按钮。
2、在弹出窗口中选择“上传源文件”，支持.js、.java、.py、.go等主流语言文件。
3、粘贴原始代码或拖入本地文件后，勾选“保留功能一致性校验”选项。
4、点击“开始分析”，等待AI完成代码理解与问题诊断。
5、查看生成的重构报告，其中所有函数重命名均遵循项目既定风格规范，重复逻辑被合并为单一可复用单元。
二、使用CodeBuddy CLI执行批量自动化重构
该方法适用于多文件、跨目录、需保持依赖一致性的工程级重构。CLI支持自然语言指令驱动，无需编写配置脚本，即可完成回调转async/await、Class组件转Hooks、模块职责拆分等复杂操作。
1、在终端中执行codebuddy login完成身份认证。
2、进入项目根目录，运行codebuddy code --refactor "将/server/api/下的所有回调函数改为async/await风格，并确保错误统一由Express全局中间件捕获"。
3、CLI自动扫描匹配文件，生成diff预览，提示共影响7个文件，新增3处try/catch包裹，移除12处if(err) return callback(err)模式。
4、输入y确认执行，重构后代码自动写入原文件并备份至.codebuddy/backup/目录。
三、在IDE中集成CodeBuddy插件进行上下文感知重构
该方法适用于日常开发中边写边重构的渐进式优化。插件可实时感知光标所在函数、类或模块的上下文，提供“提取方法”“内联变量”“提升为模块”等智能重构动作，且所有操作均通过语义理解而非简单字符串匹配实现。
1、在VS Code或JetBrains系列IDE中安装官方CodeBuddy插件。
2、打开待重构的JavaScript工具类文件，在任意函数名上右键选择“CodeBuddy → 提取为独立模块”。
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 问题
3、插件自动分析该函数所有依赖项，生成ES6模块导出代码，并同步更新所有调用处的import语句，确保无引用断裂。
4、确认预览窗口中的变更内容，点击“应用”完成重构。
四、向CodeBuddy Craft智能体提交自然语言重构需求
该方法适用于业务逻辑复杂、需结合领域知识判断重构边界的场景。Craft具备记忆能力，能理解“像上次那样处理事务边界”“按风控模块的拆分粒度处理当前服务”等模糊指令，并复用历史决策模式。
1、在Craft对话框中输入：“请将VesselRouteService.java按航道规划、潮汐计算、锚地分配、船舶调度、通航评估五个维度拆分为独立Spring Bean，每个类不超过400行，保留原有@Transactional传播行为。”
2、Craft调用历史会话中已学习的航道管理系统架构图，定位各方法间的数据流与事务边界。
3、输出5个新Java类代码，其中RoutePlanningService包含原planRoute方法全部潮汐校验逻辑，且@PreAuthorize注解迁移完整。
4、附带一份迁移清单，列出原类中每行代码的去向及替换后的调用链路。
五、基于自定义指令触发预设重构流水线
该方法适用于团队标准化重构流程的固化。通过在项目根目录下配置.codebuddy/commands/refactor-utils.yml，可将高频重构动作封装为可复用、可审计、可版本管理的指令集。
1、在项目中创建.codebuddy/commands/目录，在其中新建refactor-utils.yml文件。
2、写入如下配置：
description: "标准化JavaScript工具类重构：ES6化+驼峰命名+JSDoc+去重"
trigger: "/refactor-utils"
steps:
- action: convert-to-esm
- action: normalize-casing
- action: deduplicate-functions
- action: generate-jsdoc
3、在IDE终端中执行codebuddy run /refactor-utils utils.js。
4、执行完成后，工具类函数数量从102个精简为63个，JSDoc覆盖率提升至100%，所有调用方无需修改即可运行。
