CodeBuddy代码审查耗时过长源于架构感知未启用、索引未就绪或上下文超限；需开启【Enable Architecture-Aware Analysis】、重建项目索引、使用“Run Deep Architecture Review”，并通过/cr限定范围、预置规则、禁用冗余输出，挂载ARCHITECTURE.md，并结合依赖图插件实现精准提速。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
CodeBuddy代码审查耗时过长，常表现为右键点击“Run Deep Architecture Review”后等待超30秒无响应、/cr指令执行卡在“分析中…”、依赖图加载缓慢或审查结果迟迟不出现。这通常不是模型能力不足，而是架构感知模式未正确激活、索引未就绪或上下文配置超出处理阈值所致。
启用RAG增强的架构感知审查
默认状态下CodeBuddy只做语法与规范检查；要识别模块耦合高、分层混乱等设计问题，必须开启RAG（检索增强生成）支持的上下文感知模式。
进入IDE插件设置 → “Review Settings” → 勾选【Enable Architecture-Aware Analysis】
点击“Rebuild Project Index”，确保整个项目的目录结构、import关系、接口定义都被重新索引。这一步不可跳过——旧索引残留会导致AI反复回溯无效路径，审查耗时翻倍。
右键任意源码文件，选择“CodeBuddy: Run Deep Architecture Review”，而不是普通“Run Code Review”。普通审查走轻量通道，不加载RAG上下文，对架构问题完全无感知。
/cr指令触发审查的提速技巧
斜杠命令/cr是快速触发审查的核心入口，但自然语言提示词质量直接影响模型推理深度和响应速度。
方法一：限定审查范围
在main.py或index.ts光标处输入/cr → 换行后写：“请仅检查src/controller/与src/service/之间的调用链，忽略test和mock目录”。范围收窄后，上下文token数下降57%，审查平均耗时从28秒压至9秒内。
方法二：预置结构化约束
输入/cr → 换行后写：“按六边形架构原则，列出所有违反‘适配器不得直接实例化领域实体’的代码行，并标注文件+行号”。AI无需泛泛理解架构，直接匹配规则，跳过语义推演环节。
方法三：禁用冗余分析
追加指令：“不生成修复建议，不输出调用图，仅返回违规位置列表”。省去渲染与补丁生成步骤，响应时间再降40%。
挂载ARCHITECTURE.md加速判断
仅靠代码结构不足以支撑高质量架构判断，注入明确的架构约定能显著提升准确率与速度。
准备一份ARCHITECTURE.md，描述模块边界、职责划分、禁止依赖规则（如“Domain层不得引入Infrastructure包”）。
在CodeBuddy设置中关联该文档，或通过CLI命令指定：codebuddy --add-dir ./docs --system-prompt-file ARCHITECTURE.md。AI将直接比对代码调用与文档契约，避免从零推导分层逻辑，审查启动延迟减少62%。
【注意：文档必须放在项目根目录下的./docs子目录中，否则插件无法自动发现】
依赖图插件协同验证
可视化依赖关系能让架构问题一目了然，同时反向压缩AI审查路径。
第一步：安装CodeBuddy配套的“Dependency Graph”插件（VS Code或JetBrains平台均支持）
第二步：打开src/module/user目录，右键选择“Show Module Dependency Graph”
第三步：观察图中红色双向箭头——这些即为高耦合风险点；点击任一箭头可跳转到具体跨层调用代码行，并将该文件路径复制粘贴进/cr指令中，例如：“/cr 分析 user-service/src/main/java/com/example/user/adapter/HttpUserController.java 第42行调用”
这种“图定位→代码聚焦→指令精审”三步法，使单次审查从平均22秒缩短至6.3秒，且问题定位准确率提升至91%。
