CodeBuddy多文件项目问题可通过五种方法解决：一、执行/init初始化知识图谱；二、用@符号引用单文件；三、拖拽文件夹批量关联；四、自然语言指定跨文件参考；五、Craft模式下基于README驱动生成。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用CodeBuddy开发多文件项目时遇到上下文理解不全、代码引用失效或跨文件修改失败等问题，则可能是由于项目结构未被正确加载或文件关联方式不当。以下是处理多文件项目的多种方法：
一、执行/init命令初始化项目知识图谱
该操作会强制CodeBuddy扫描当前工作区全部文件，构建语义关联图谱，使AI能准确识别模块依赖、函数调用链与类继承关系，显著提升多文件场景下的理解准确率。
1、在CodeBuddy对话框中输入斜杠命令 /init 并回车。
2、等待状态栏显示“项目扫描完成”提示，此时知识图谱已预加载至内存。
3、后续所有提问将自动基于完整项目上下文进行推理，无需重复指定文件路径。
二、使用@符号精准引用单个文件
当仅需针对某一具体文件进行修改或分析时，可通过@快捷符直接锚定目标文件，避免AI误读其他无关代码，确保操作范围严格受控。
1、在提问前输入英文符号 @，编辑器将自动弹出当前打开文件列表。
2、从下拉菜单中选择目标文件，例如 @src/utils/dateHelper.js。
3、输入需求描述，如“请为该文件中的formatDate函数添加ISO 8601兼容性支持”。
三、拖拽整个文件夹实现批量关联
适用于需跨多个子目录协同分析的场景，例如重构微服务接口层或统一修改日志格式，拖入文件夹后AI将递归解析所有层级内的源码并建立全局索引。
1、在文件资源管理器中选中目标文件夹（如 /backend/src）。
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 问题
2、将其直接拖入CodeBuddy聊天窗口空白区域。
3、确认弹窗中显示的文件数量与预期一致，点击“加载”按钮完成关联。
四、通过自然语言指定跨文件参考关系
当某项功能需结合多个已有模块实现时，可明确告知AI参考路径，使其主动提取对应逻辑片段进行比对与复用，避免重复造轮子。
1、在提问中写明参考位置，例如“请参考 @controllers/userController.ts 中的authGuard实现”。
2、同时指出待修改位置，如“并在 @services/paymentService.ts 的createOrder方法中注入相同鉴权逻辑”。
3、AI将自动比对两处代码结构，生成符合项目风格的嵌入式修改方案。
五、在Craft模式下基于README驱动多文件生成
当从零构建多文件项目时，可先让AI生成结构化文档，再以该文档为蓝图驱动代码骨架创建，确保各模块命名、接口定义与目录约定高度统一。
1、在Chat模式中要求：“请为一个用户权限管理系统生成完整的README.md，包含API路由表、数据库ER图说明、前后端目录结构。”
2、生成后切换至Craft模式，输入 @README.md 激活文档感知。
3、发送指令：“根据README中定义的路由和模型，生成Express后端框架，包括routes/、models/、controllers/三个目录及对应文件。”
