codebuddy大型项目卡顿可优化：一、调低上下文分析深度并关闭高开销静态分析；二、增加内存与线程配额；三、启用增量索引；四、禁用design/plan辅助通道；五、高频重构时改用cli形态。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在大型项目中使用CodeBuddy，发现编辑器响应迟缓、代码补全延迟或操作卡顿，则可能是由于模型上下文加载压力、本地资源调度冲突或工程依赖图谱解析深度过高所致。以下是缓解该现象的多种具体方法：
一、调整模型推理负载策略
CodeBuddy默认启用高精度双模型协同推理（混元+DeepSeek），在万行级项目中会自动构建跨文件依赖图谱，此过程对CPU与内存带宽要求显著提升。降低实时分析粒度可有效释放资源压力。
1、打开设置面板，进入「AI引擎」→「性能模式」。
2、将「上下文分析深度」从“全项目”切换为“当前文件+直接依赖”。
3、关闭「实时N+1 SQL扫描」与「深拷贝对象检测」两项高开销静态分析功能。
4、保存配置后重启IDE，观察终端输出中的ContextLoadTime指标是否回落至。
二、优化本地运行时资源配置
CodeBuddy IDE在Linux/macOS下默认限制为2核CPU与3GB内存，面对含50+服务模块的电商推荐系统等复杂工程时易触发资源争抢。手动分配可避免调度瓶颈。
1、在启动脚本中添加环境变量：CODEBUDDY_MAX_MEMORY=6144 与 CODEBUDDY_MAX_THREADS=4。
2、若使用CLI形态，执行codebuddy --no-sandbox --disable-gpu --max-old-space-size=6144启动。
3、检查进程管理器，确认codebuddy-engine子进程实际占用内存稳定在5.2–5.8GB区间内。
三、启用增量式工程索引
全量索引会在首次加载大型Monorepo时持续占用I/O资源并阻塞UI线程。启用增量索引后，仅对修改文件及其调用链重算依赖，大幅缩短后台任务周期。
1、在项目根目录创建.codebuddy/config.json文件。
统一LLM网关 - 一个API对接70+AI模型，使用单一API密钥即可调用GPT、Claude、Gemini、Qwen、Deepseek、Grok等主流模型。
2、写入配置：{"indexing": {"mode": "incremental", "watchDepth": 3}}。
3、执行codebuddy index --force-rebuild=false触发轻量初始化。
4、验证索引状态：终端输出应显示Incremental indexing active: true。
四、禁用非必要AI辅助通道
Design Mode与Plan Mode在后台持续监听Figma链接变更及PRD语义流，即使未主动使用也会维持WebSocket长连接与向量缓存。关闭后可减少约37%的常驻内存占用。
1、点击右上角AI面板齿轮图标，进入「辅助通道管理」。
2、将「Design Sync」与「Plan Graph Sync」开关设为关闭状态。
3、在设置搜索栏输入chat.history.retention，将其值设为0以清空本地对话向量缓存。
4、重启后通过top -pid $(pgrep -f "codebuddy-chat")确认对应进程已终止。
五、切换至CLI轻量形态处理高频重构
当需对大型React+TS前端模块执行批量Hooks重构时，IDE图形界面会因AST渲染与Diff视图更新产生明显卡顿。CLI形态绕过UI层，直连引擎核心，响应延迟稳定在120ms内。
1、在项目根目录执行：codebuddy refactor --target "src/components/**/*.{ts,tsx}" --transform "class-to-hooks"。
2、添加--dry-run参数预览变更点，确认无误后再移除该参数执行真实重构。
3、观察终端输出末尾的Refactor completed in 118ms (±3ms)统计值。
