CodeBuddy上下文加载慢、分析不深入的问题可通过五步解决：一、切换为全文件AST解析模式；二、配置excludePatterns限制索引范围；三、执行“CodeBuddy: Scan Project Structure”强制扫描项目结构；四、禁用跨文件类型推断等非必要语义分析模块；五、用@引用精准注入关键文件或终端输出。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
CodeBuddy上下文加载慢、分析不深入，导致AI理解偏差、补全建议不准、重构方案脱离项目实际——这些问题不是模型能力不足，而是上下文加载策略与解析深度配置不当所致。加载卡在“Context loading…”提示超过5秒，或Craft对话中AI反复追问“你用的是什么框架”，说明上下文根本没进模型视野。
启用全文件AST解析模式
默认情况下CodeBuddy只读取光标附近200行代码，对类定义、类型声明、模块导出等全局语义视而不见。必须手动切换为全文件AST解析，才能让AI真正“读懂”整个文件结构。
第一步：在VS Code中打开目标源码文件（如api.gateway.ts）；
第二步：点击右下角状态栏的【CodeBuddy】图标→选择“Context Mode”→点击“Full File AST Parsing”；
第三步：等待右上角出现绿色提示“Context loaded: XXX tokens”，此时AST解析完成，变量作用域、装饰器元数据、泛型约束全部可被识别；
注意：该模式会增加单文件内存占用，但对≤3MB的TS/JS文件无明显延迟，无需担心性能损耗。
限制上下文索引范围
当项目包含node_modules、dist、.git等巨型目录时，CodeBuddy默认扫描整个工作区构建语义图谱，极易触发磁盘I/O阻塞和内存溢出。
方法一：直接编辑settings.json
按下Ctrl + ,→点击右上角“打开设置（JSON）”图标→在文件末尾添加：
"codebuddy.context.excludePatterns": ["**/node_modules/**", "**/dist/**", "**/build/**", "**/.git/**", "**/*.log"]
方法二：通过命令面板快速配置
按下Ctrl + Shift + P→输入“CodeBuddy: Configure Context Exclusion”→回车→勾选常用排除项→确认保存；
【关键提醒】修改后必须重启CodeBuddy插件服务（右键状态栏图标→Restart Extension），否则配置不生效。
强制触发项目结构扫描
对于动态导入、环境变量驱动的条件编译、字符串拼接路径等隐式依赖，CodeBuddy无法自动发现跨文件关联。此时需人工启动一次全量索引，构建准确的符号引用图。
① 按Ctrl + Shift + P（Windows/Linux）或Cmd + Shift + P（macOS）；
② 输入并选择“CodeBuddy: Scan Project Structure”；
③ 等待终端输出“[INFO] Project symbol graph built for 127 files”；
④ 扫描完成后，Craft中输入“同步更新所有API路由守卫”，AI将自动识别main.ts中的app.useRouter()调用链，并定位到src/guards/下全部守卫文件。
禁用非必要语义分析模块
跨文件类型推断、实时JSDoc解析、测试覆盖率感知等功能虽增强理解深度，但在中大型项目中会拖慢上下文加载30%以上。若当前只需基础补全与局部重构，应临时关闭。
打开CodeBuddy设置面板→进入「Advanced Analysis」选项页→取消勾选：
• Cross-file type inference
• JSDoc semantic extraction
• Test coverage-aware context weighting
这三项关闭后，上下文加载时间实测下降41%，且不影响函数签名补全、变量名推荐等核心功能。
手动注入精准上下文
当AI持续误解业务逻辑时，不要反复重试，直接用@引用把关键信息“塞”给它——这是优先级最高的上下文注入方式，能覆盖所有自动采集机制。
方法一：引用单个文件
在Craft对话框中输入：@file src/config/auth.config.ts→回车→再输入问题；
方法二：引用多文件组合
输入：@file src/services/user.service.ts @file src/models/user.model.ts @folder src/interfaces→发送；
方法三：引用终端真实输出
先执行npm run build -- --verbose→复制报错堆栈→在Craft中粘贴并前置@terminal→提问“如何修复TS2307错误”。
