codebuddy 提供五种重构路径：web 界面用于单文件精细诊断并校验功能一致性；cli 支持自然语言或模板驱动批量自动化重构；ide 插件实现上下文感知的实时提取与依赖同步；craft 智能体执行自然语言驱动的架构级分层改造；自定义指令流水线将团队规范固化为保存即触发的自动重构动作。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想在不重写整块逻辑的前提下，把一个耦合严重、命名混乱、圈复杂度爆表的订单处理模块变得可读、可测、可维护，CodeBuddy 提供了五种路径——从 Web 界面点选分析，到 CLI 一行指令批量改写，再到 IDE 内右键即重构，每种都绕开了人工逐行梳理的风险和耗时。
Web界面上传分析：适合单文件精细诊断
当你手头只有一个关键函数文件（比如 order_status_handler.js），且需要确认每一处修改是否符合业务语义时，Web 界面是最稳妥的选择。
1、打开 CodeBuddy 控制台 → 左侧导航栏点击「重构中心」→ 右上角点「新建重构任务」。
2、在弹窗中选择「上传源文件」，支持 .js、.py、.java、.go、.ts 等 200+ 语言格式，【注意：上传前请确保文件不含敏感密钥或生产数据库连接串】。
3、拖入文件后，务必勾选「启用功能一致性校验」——这会让 AI 在重命名变量、提取函数时，自动比对前后执行结果的 JSON 输出结构，避免因语义偏移导致线上异常。
4、点击「开始分析」，等待 8～25 秒（取决于文件长度与逻辑密度），AI 将输出带行号标注的问题清单：如“第47行重复校验逻辑，建议合并为 validateOrderInput()”“第112行硬编码状态码 'processing'，应替换为枚举常量”。
5、所有重构建议均附带「预览 diff」按钮，点击即可看到修改前后代码对比；确认无误后，手动复制新代码覆盖原文件即可。
CLI 批量自动化重构：一次指令改遍整个 service 目录
当你要把 /src/services/ 下全部 17 个 Python 文件里的 requests.get() 调用统一升级为 httpx.AsyncClient，靠点选根本来不及——这时 CLI 是唯一能落地的方案。
方法一：自然语言驱动重构
1、终端执行 codebuddy login，完成腾讯云账号认证（需提前开通 CodeBuddy 企业版或个人 Pro 权限）。
2、cd 进入项目根目录，运行：
codebuddy code --refactor "将 /src/services/ 下所有同步 HTTP 请求替换为异步 httpx 调用，保留原有超时与错误重试逻辑，并确保所有 await 表达式位于 async 函数体内"
3、CLI 自动扫描匹配文件，生成影响报告：共 17 处变更，新增 9 个 async def，移除 23 个 time.sleep()，重写 5 处 try/except 块以适配 asyncio.CancelledError。
4、输入 y 确认执行——【所有原始文件将被自动备份至 .codebuddy/backup/20260715_1307/ 目录，不可跳过】，重构后代码直接写入原路径。
方法二：指定规则模板重构
若团队已有内部规范文档，可调用预置 Skills：
codebuddy code --skill "http-sync-to-async" --target "/src/services/**/*.py"
该命令会加载已注册的「HTTP 同步转异步」技能模板，跳过语义理解阶段，执行速度提升 40%，但要求目标代码结构高度一致。
IDE 插件上下文感知重构：边写边拆，零中断优化
你在 VS Code 里正编辑一个 300 行的 paymentProcessor.ts，光标停在 calculateFee() 函数名上，想把它独立成可复用的 fee-calculator 包——插件能实时感知依赖并同步更新所有引用。
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 问题
第一步：确保已安装最新版 CodeBuddy 插件（v2.8.3+），且右下角状态栏显示「Connected · Project: order-system」。
第二步：将光标置于 calculateFee 函数声明行 → 右键 → 选择「CodeBuddy → 提取为独立模块」。
第三步：插件立刻分析出该函数依赖 4 个外部常量（TAX_RATE、CURRENCY_MAP）、调用 2 个工具函数（roundToCent、isPromoValid），并检测到 6 处跨文件调用点（含 2 个未 import 的地方）。
第四步：预览窗口展示三块内容：① 新建 fee-calculator/index.ts 导出函数及类型定义；② 自动在原文件顶部插入 import { calculateFee } from './fee-calculator'；③ 在另外 5 个调用文件中补全对应 import 语句——【若某处 import 路径超出当前 workspace 根目录，插件会暂停并提示手动确认】。
第五步：点击「应用」，所有文件即时保存，TypeScript 语言服务自动刷新类型引用，无编译错误。
Craft 智能体自然语言驱动重构：一句话定义架构级改造
你刚接手一个遗留 Java 项目，它的 Controller 层混着参数校验、业务逻辑、响应组装三类职责，你想把它按 Clean Architecture 分层，但没时间画 UML 或写设计文档——Craft 模式直接带你从需求跳到可运行代码。
1、在 CodeBuddy IDE 中打开任意 .java 文件 → 按 Ctrl+Shift+P（Windows）或 Cmd+Shift+P（Mac）呼出命令面板 → 输入 /craft 启动 Craft 模式。
2、输入自然语言指令：“把 com.example.order.web 包下所有 @RestController 类，按 Clean Architecture 拆分为 controller + usecase + entity 三层，保留原有 Spring Boot 注解，DTO 用 Lombok，新增单元测试骨架。”
3、Craft 智能体先生成分层结构图（含包路径与类关系），询问你是否接受该设计；确认后，自动创建 src/main/java/com/example/order/usecase/、src/main/java/com/example/order/entity/ 等目录。
4、逐个处理原 Controller 类：提取业务逻辑到 usecase 实现类，剥离 DTO 到 entity 包，Controller 仅保留 @RequestMapping 和简单参数转发——所有新类均带完整 Javadoc 和 @NonNull 注解。
5、最后生成 src/test/java/ 对应的空测试类，每个 usecase 方法都预留了 @Test 方法桩，含 Given-When-Then 注释模板。
自定义指令流水线：把团队经验固化为可复用的重构动作
你们团队约定所有 API 返回必须统一封装为 Result
1、在项目根目录创建 .codebuddy/pipeline.yaml，定义流水线名称、触发条件与执行步骤：
name: enforce-result-wrapper
trigger: on-save
steps:
- action: extract-response-body
target: "**/controller/*.java"
- action: wrap-with-result
config: { successCode: "OK", errorCodeEnum: "ApiErrorCode" }
2、执行 codebuddy pipeline register --file .codebuddy/pipeline.yaml 注册该流水线。
3、下次保存任意 Controller 文件时，只要检测到 ResponseEntity
4、所有变更走标准 diff 预览流程，拒绝后流水线自动禁用本次触发，不污染代码库。
