codebuddy代码不符因上下文未识别，需四步精准注入：一、执行/init生成.codebuddy/codebuddy.md并补充规则；二、用@codebase扫描项目构建知识图谱；三、alt+enter注入实时编辑片段；四、通过mcp协议接入swagger等外部上下文源。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用CodeBuddy时发现AI生成的代码与项目实际结构、技术栈或编码规范不符，则很可能是项目上下文未被有效识别和注入。以下是实现上下文精准理解的关键操作路径：
一、启用并配置长期记忆机制
CodeBuddy通过长期记忆（Long-term Memory）自动继承项目元信息，避免每次重复说明技术背景。该机制将项目特征固化为可复用的上下文模板，使后续所有AI交互均基于统一语境。
1、在IDE中打开命令面板（快捷键Ctrl+Shift+P / Cmd+Shift+P），输入并执行/init指令。
2、系统自动生成.codebuddy/CodeBuddy.md文件，该文件默认包含语言类型、框架名称、目录结构摘要等基础字段。
3、手动编辑该文件，在## Project Rules章节下补充关键约束，例如：“所有API响应必须遵循RESTful规范，状态码统一返回200，data字段包裹业务数据”。
4、保存文件后，重启CodeBuddy会话，新生成的代码将自动应用上述规则。
二、使用@Codebase指令触发工程级解析
@Codebase是CodeBuddy内置的深度工程理解能力入口，它能扫描整个工作区，构建代码知识图谱，识别模块依赖、接口契约与数据流向，从而支撑跨文件逻辑生成。
1、在任意编辑器中右键点击项目根目录，选择CodeBuddy → Analyze Project with @Codebase。
2、等待扫描完成（大型项目约需30–90秒），界面右下角出现提示Project context indexed: X files, Y dependencies。
3、在对话框中输入需求时显式引用该上下文，例如：“请为当前@Codebase中已定义的UserService接口，生成一个基于Spring Security的JWT登录实现”。
4、AI将严格依据已解析的服务签名、注解配置及包路径生成代码，而非泛化实现。
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 问题
三、注入实时编辑上下文片段
当处理局部逻辑重构或调试时，CodeBuddy支持将光标所在区域的代码块、相邻函数及导入语句作为轻量级上下文直接注入提示流，确保生成结果与当前编辑点语义强耦合。
1、选中待增强的代码段（如一个空的Controller方法体）。
2、按下快捷键Alt+Enter（Windows/Linux）或Option+Enter（macOS），调出智能操作菜单。
3、选择Ask CodeBuddy about selection，此时系统自动拼接：所选代码 + 其所在类的完整声明 + 相邻import语句 + 当前文件路径。
4、在弹出的提问框中输入指令，例如：“补全此方法：根据前端传入的orderNo查询订单详情，并做DTO转换”。
5、生成代码将准确调用已存在的OrderService、OrderDTO类及字段映射逻辑，不引入未声明依赖。
四、通过MCP协议接入外部上下文源
MCP（Model Context Protocol）允许CodeBuddy从Git提交历史、CI/CD流水线日志、Swagger文档等外部系统动态拉取上下文，形成多源融合的语义环境，特别适用于微服务或遗留系统协作场景。
1、在.codebuddy/config.yaml中添加MCP连接配置，指定Swagger JSON URL或Git仓库分支名。
2、执行/mcp sync命令，触发一次上下文同步，控制台显示Fetched 12 endpoints from Swagger或Loaded last 5 commits from main branch。
3、在后续提示词中引用该来源，例如：“参照MCP同步的Swagger定义，为/v1/orders/{id}端点生成Feign客户端接口”。
4、生成结果将严格匹配路径参数命名、HTTP方法、请求头要求及响应结构，无需人工校验对齐。
