应启用全文件ast解析、多文件关联、项目结构扫描及清除缓存四项操作：一、切换context mode为full file ast parsing；二、ctrl/command多选文件后右键“send to codebuddy context”；三、执行“codebuddy: scan project structure”命令；四、在设置中清除context cache并重启。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在VS Code中使用CodeBuddy进行代码生成或修改，但发现AI输出与项目实际结构不符，则可能是由于上下文采集范围受限或未激活深度解析能力。以下是验证与增强其上下文理解能力的具体操作路径：
一、启用全文件上下文分析模式
CodeBuddy默认仅读取当前光标所在区域的局部代码片段，需手动切换至全文件模式才能加载并解析整个打开文件的AST结构。该模式依赖Tree-sitter语法树解析器，可识别变量作用域、函数调用链、类继承关系等深层语义信息。
1、在VS Code编辑器中打开目标源码文件（如user.service.ts）。
2、点击右下角状态栏中的“CodeBuddy”图标，选择“Context Mode”选项。
3、在弹出菜单中点击“Full File AST Parsing”，等待右上角提示“Context loaded: 1287 tokens”。
4、此时在Craft对话框中输入“重构此服务，将HTTP请求封装为独立API Client类”，CodeBuddy将基于完整文件结构生成带类型守卫与错误重试逻辑的新模块。
二、多文件上下文关联配置
当任务涉及跨文件逻辑（如修改组件后同步更新对应Service和Guard），需显式声明相关文件以构建项目级上下文图谱。Craft智能体将自动提取各文件间的import/export依赖、接口定义与运行时调用路径。
1、在VS Code资源管理器中按住Ctrl键（Windows/Linux）或Command键（macOS），多选user.component.ts、auth.guard.ts、user.service.ts三个文件。
2、右键点击选中项，在快捷菜单中选择“Send to CodeBuddy Context”。
3、切换至Craft面板，输入指令：“为用户管理页添加角色权限拦截，并确保所有HTTP调用携带X-Role-Header”。
4、CodeBuddy将同步修改Guard的canActivate逻辑、Service中HttpClient实例配置、以及Component内角色判断UI分支。
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 问题
三、强制触发项目结构扫描
对于未被自动识别的隐式依赖（如通过字符串拼接导入的模块、动态require路径、环境变量驱动的条件编译块），需启动一次全量项目索引。该过程会遍历src目录下所有文件，构建符号表与跨语言引用映射。
1、按下Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）打开命令面板。
2、输入并选择“CodeBuddy: Scan Project Structure”。
3、等待终端输出“Indexed 42 files, resolved 187 symbols, cache saved to .codebuddy/index.db”。
4、此后在任意文件中提问“config.yaml里定义的shardKey字段在哪些DAO层被引用？”，CodeBuddy将准确列出database/user-dao.ts与cache/redis-dao.ts两处位置。
四、禁用缓存强制重载上下文
当修改了tsconfig.json、babel.config.js等配置文件后，CodeBuddy可能仍沿用旧缓存中的编译选项与路径别名，导致类型推导错误或路径解析失败。此时需清除上下文缓存并强制重新加载。
1、打开VS Code设置（Ctrl+, 或 Cmd+,）。
2、搜索“codebuddy context cache”，找到对应配置项。
3、点击右侧“Clear Cache and Reload”按钮。
4、重启VS Code窗口，再次打开任意TypeScript文件，确认状态栏显示“Context: Fresh (v2.4.1)”。
