codebuddy代码不符因上下文缺失，需四步解决：一建全大写codebuddy.md定义技术栈；二用@引用关键文件注入上下文；三执行项目结构扫描确保隐式依赖被识别；四配置项目级规则强制风格与约束。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
CodeBuddy生成的代码与项目实际技术栈、命名规范或接口约定不符，说明它没拿到足够精准的上下文信息——不是模型能力弱，而是你投喂的内容没对上。
第一步：确认CODEBUDDY.md是否已存在且生效
这是项目级上下文的起点，缺失它，CodeBuddy只能按通用编程常识推理，完全不知道你们用React还是Vue、API走REST还是GraphQL。
在项目根目录检查是否存在名为【CODEBUDDY.md】的纯文本文件。注意大小写必须全大写，扩展名是.md，不能是codebuddy.md或CODEBUDDY.MD。
如果不存在，立即新建：右键项目根目录→新建文件→命名为CODEBUDDY.md→用记事本或VS Code打开，写入至少两行关键信息，例如：
Frontend: Vue 3 + Pinia + Vite
API: RESTful, all endpoints prefixed with /api/v2, JWT in Authorization header
第二步：手动注入关键文件上下文
当CodeBuddy回答偏离预期时，大概率是它没看到你认为“理所当然”的那几个核心文件。别等它自动发现，直接@引用。
方法一：在Craft对话框中输入@符号后，点击左侧资源管理器里你要的文件（如src/api/client.ts），CodeBuddy会实时读取全文并加入本次提问上下文。
方法二：选中一段关键代码（比如一个核心service类的全部内容）→右键→“Copy as @file context”→粘贴到Craft输入框开头。这比截图描述准确十倍。
【注意】@引用只对当前这条消息生效，下一条问题若不重引，AI立刻“失忆”。
第三步：强制刷新项目结构索引
有些隐式依赖它根本抓不到——比如通过环境变量拼接的模块路径、动态import()里的字符串、或者config目录下被require加载的JSON配置。这些不会出现在AST里，必须靠全量扫描。
第一步：按下Ctr+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）打开命令面板。
第二步：输入“CodeBuddy: Scan Project Structure”，回车执行。
第三步：等待右下角状态栏出现绿色提示“Project structure indexed: X files”。X值应接近你src/和config/目录下的真实文件总数，否则说明扫描被跳过或中断。
这一步做完，再问“用户登录态如何校验”，它就能从auth.guard.ts、main.ts、以及.env.production里提取真实逻辑，而不是瞎猜。
第四步：用规则锁定风格与约束
如果CodeBuddy总把函数名写成snake_case，而你们团队强制camelCase，光靠口头提醒没用——得用规则把它“焊死”。
进入CodeBuddy主界面左侧「规则管理」→点击「新增规则」→在「适用范围」中【务必选择“项目规则”】（选“个人规则”将全局生效，污染其他项目）。
在规则内容框里，用自然语言写清楚不可协商的约束，例如：
所有导出函数必须使用camelCase命名；
禁止使用console.log，统一用logger.debug()；
HTTP请求头必须包含X-Request-ID。
保存后，规则即刻生效。下次生成代码时，它会先校验输出是否符合这几条，不符合就重试，直到达标为止。
