codebuddy需启用rag增强模式、使用/cr加架构提示词、注入architecture.md文档、结合依赖图插件，才能识别模块耦合高、分层混乱等架构问题。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用CodeBuddy进行代码审查时，期望它能识别出模块耦合过高、分层混乱、接口职责不清等架构设计层面的问题，而非仅停留在变量命名、缩进或未处理异常等语法与规范层面，则需明确其能力边界与当前实现机制。以下是针对该能力的多角度验证与应对路径：
一、确认CodeBuddy是否启用RAG增强的上下文感知审查模式
CodeBuddy的架构级分析能力高度依赖于其RAG（检索增强生成）模块是否被激活并正确索引了项目全局结构。若仅启用基础静态分析，它将无法理解跨文件调用链、模块依赖图或领域边界定义；而启用RAG后，系统会解析目录结构、import关系、接口契约及配置元数据，从而支撑更高层次的推理。
1、打开CodeBuddy IDE插件设置界面，进入“Review Settings”选项卡。
2、检查“Enable Architecture-Aware Analysis”复选框是否已勾选。
3、点击“Rebuild Project Index”按钮，强制重新扫描整个代码库的文件依赖与模块拓扑。
4、在任意源码文件中右键选择“CodeBuddy: Run Deep Architecture Review”，触发全量上下文加载的审查流程。
二、使用斜杠命令 /cr 并附加架构约束提示词
CodeBuddy的/cr（Code Review）命令默认执行通用质量检测，但可通过人工注入架构意图来引导模型聚焦高层问题。该方式利用LLM对自然语言指令的响应能力，在不修改底层索引的前提下，临时提升审查粒度。
1、在编辑器中打开主入口文件（如src/index.ts或main.py）。
2、在光标处输入/cr，随后换行追加提示语：请基于Clean Architecture原则，检查Controller、UseCase、Entity、Repository四层之间是否存在越界依赖或职责混淆。
3、按下回车执行审查，等待CodeBuddy返回含调用图、依赖箭头标注及违反层级规则的具体位置。
4、若结果未达预期，可追加第二轮指令：列出所有违反“依赖倒置原则”的具体类与接口实现关系。
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的RAG引擎会将项目根目录下的ARCHITECTURE.md或design/子目录中的UML序列图、组件图文本描述纳入索引。若缺乏此类文档，模型将因缺少“设计契约”而无法判断某次跨层调用是否属于架构违规，仅能识别技术性错误。
1、在项目根目录新建文件ARCHITECTURE.md。
2、写入明确的架构约束，例如：“所有Repository接口必须定义在domain/layer目录下，且仅允许UseCase层调用；Infrastructure层不得直接引用domain/entity中的具体类”。
3、保存后，在CodeBuddy设置中点击“Reload Context from Docs”。
4、再次运行/cr命令，观察审查报告中是否新增“Architecture Violation”分类及其定位精度。
四、结合IDE图形化依赖图进行交叉验证
CodeBuddy本身不原生渲染可视化架构图，但其审查结果可导出为JSON格式，并与VS Code的“Dependency Analytics”插件联动。该方式通过外部工具补足CodeBuddy在空间关系表达上的短板，使抽象的“层间泄漏”转化为可点击跳转的图形节点。
1、执行/cr --output=json命令，将审查结果保存为review-report.json。
2、安装VS Code扩展“Dependency Analytics for CodeBuddy”。
3、右键点击该JSON文件，选择“Visualize as Dependency Graph”。
4、在生成的交互图中，红色高亮的跨层实线箭头即代表被CodeBuddy判定为违反架构约束的硬依赖。
