codebuddy已启用仓库级理解能力：需加载项目上下文、开启mcp协议、使用craft模式、选用大上下文模型（如混元pro-128k）、并确保git历史可读，方可实现跨文件修改、接口同步与命名风格修正等智能推理。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用CodeBuddy时发现其响应与项目上下文高度贴合，例如跨文件修改函数调用、自动同步接口定义与实现、或基于历史提交修正命名风格，则说明它正在利用代码仓库级理解能力进行推理。以下是验证与启用该能力的具体路径：
一、确认项目上下文加载状态
CodeBuddy的仓库理解依赖于显式加载工程结构，而非仅扫描当前打开文件。未加载完整上下文时，其行为将退化为单文件补全模式。
1、在VS Code中打开项目根目录（含package.json、pyproject.toml、pom.xml等标识文件的文件夹）。
2、点击左侧活动栏中的CodeBuddy图标，观察右下角状态栏是否显示“✅ 已加载 [项目名] 上下文”。
3、若显示“⚠️ 仅当前文件”，则需手动触发全量索引：右键项目根目录 → 选择“CodeBuddy: Load Project Context”。
二、启用MCP协议增强上下文感知
MCP（Model Context Protocol）是CodeBuddy支持的开放协议，允许模型动态获取文件依赖关系、Git变更历史及构建产物信息，构成结构化仓库知识图谱。
1、进入CodeBuddy设置页：点击插件界面右上角齿轮图标 → 选择“Advanced Settings”。
2、开启Enable MCP Context Injection开关。
3、在终端执行命令：codebuddy mcp init --auto-discover，使工具自动识别tsconfig.json、webpack.config.js等配置文件并注入关联路径。
三、通过Craft模式触发跨文件推理
Craft模式专为多文件协同开发设计，其底层会主动解析import/require语句、类型定义引用及测试文件调用链，构建双向依赖图谱。
1、在Craft输入框中输入需求，例如：“为用户管理模块添加手机号校验，需同步更新API接口定义、数据库迁移脚本及前端表单验证逻辑”。
统一LLM网关 - 一个API对接70+AI模型，使用单一API密钥即可调用GPT、Claude、Gemini、Qwen、Deepseek、Grok等主流模型。
2、提交后观察生成结果：若输出包含src/api/user.ts、migrations/202405_add_phone_to_users.py、src/components/UserForm.vue等多个路径文件，则证明仓库级理解已生效。
3、如仅生成单个文件，可追加指令：“请先分析现有用户模块的全部相关文件路径”，强制触发依赖扫描。
四、检查模型选型对上下文窗口的支持
不同后端模型具备差异化的上下文长度与结构化解析能力。混元Pro与DeepSeek-V2-Rag版本明确支持128K token仓库摘要，而基础版混元仅支持32K token单文件切片。
1、在Chat模式中输入：“当前使用的模型名称与上下文长度限制是多少？”
2、核对返回信息中context_window_size字段值是否≥100000。
3、若低于该阈值，在设置中切换模型至混元Pro-128K或DeepSeek-V2-Rag选项。
五、验证Git历史集成能力
CodeBuddy可读取.git目录中的commit log、blame信息及分支差异，将开发意图与历史演进对齐，从而理解“为什么这个函数被废弃”或“上次修改此配置的原因”。
1、确保项目已初始化Git仓库且存在至少3次有效提交。
2、在Chat模式中提问：“分析src/utils/date.js最近三次修改的动机与影响范围”。
3、若响应中引用了commit hash、author、message关键词及diff片段，则Git上下文通道已连通。
