codebuddy跨文件关联修改需启用craft模式并声明多文件上下文，或拖入项目目录构建工程级依赖图谱，辅以@符号引用代码片段及mcp协议接入git与文档上下文，确保语义一致、逻辑同步。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用CodeBuddy进行功能开发时，需同步更新多个关联文件（如wxml、wxss、js、json），但发现修改分散、易遗漏或逻辑不一致，则可能是由于未正确启用或理解其跨文件上下文感知机制。以下是实现跨文件关联修改的具体方法：
一、启用Craft模式并明确声明多文件上下文
Craft模式是CodeBuddy实现多文件协同编辑的核心交互方式，它依赖显式上下文注入来构建代码知识图谱，从而识别变量引用、函数调用链与页面路由等跨文件依赖关系。
1、在CodeBuddy对话框中输入自然语言需求，例如：“添加用户反馈表单页面，包含提交按钮、输入校验和弹窗提示”。
2、在需求后追加上下文声明指令，格式为：@pages/feedback.wxml @pages/feedback.wxss @pages/feedback.js @app.json。
3、按下回车触发生成，系统将自动解析所列文件的结构与当前项目配置，生成语义一致的四端代码，并在app.json中追加页面路径注册项。
二、拖入整个项目目录建立工程级上下文
当修改涉及深层依赖（如新增服务层接口影响Controller、DTO、Service、Test等多个Java类），仅指定单个文件不足以覆盖全部影响范围；此时需导入完整目录以激活依赖图谱分析能力。
1、在IDE中打开CodeBuddy侧边栏，定位至“Context”区域。
2、将本地项目根目录（含src/main/java、src/main/resources等子目录）直接拖入对话框内。
3、输入指令：“重构用户管理模块，将UserServiceImpl中的createUser方法升级为支持异步写库，并同步更新对应Controller返回值与单元测试断言”。
4、确认执行后，CodeBuddy将基于Maven依赖解析结果，定位所有被调用及调用该方法的类，并批量生成兼容变更的代码补丁。
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 问题
三、使用@符号动态引用已有代码片段
该方法适用于复用现有逻辑结构的场景，通过锚定具体函数或组件定义位置，使AI准确继承命名规范、参数风格与异常处理策略，避免跨文件语义偏移。
1、在编辑器中打开待参考的源文件，例如utils/request.js。
2、在CodeBuddy提问框中键入“@”，随后选择utils/request.js文件。
3、输入新需求：“为登录接口增加token自动刷新逻辑，参考@utils/request.js中interceptors的错误拦截写法”。
4、系统将提取该文件中interceptors对象的结构、Promise链处理方式及refreshToken调用模式，并将其迁移至pages/login/login.js的请求封装中，同时同步更新store/modules/auth.js中的状态更新逻辑。
四、通过MCP协议连接Git历史与文档上下文
MCP（Model Context Protocol）允许CodeBuddy接入版本控制系统与外部文档，从而在跨文件修改时识别历史变更意图与设计约束，防止破坏既有契约。
1、在Context面板中点击“Git”，绑定当前仓库分支（如main或develop）。
2、勾选“Include recent commit messages”，使AI可读取最近三次提交日志中的关键描述（如“统一校验规则至validateForm工具函数”）。
3、再输入：“修改注册页表单提交逻辑，使其复用validateForm函数”，CodeBuddy将自动定位该函数所在文件（如utils/form.js），并在pages/register/register.js中插入调用，同时在pages/register/register.wxml中补全required属性与bindsubmit事件绑定。
4、若项目已接入Confluence或Swagger文档，还可点击“Docs”添加URL链接，AI将据此校验字段名、枚举值与API响应结构是否匹配。
