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 CLI for OpenClaw

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侧边栏的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会继承原文件的命名习惯、参数结构、异常处理策略，保证新代码与现有风格一致