CodeBuddy代码补全延迟可通过五种方法优化：一、启用本地轻量模型推理，响应时间从850ms降至190ms内；二、优化上下文索引范围，排除无关目录使构建耗时减少63%；三、调整触发阈值至2-3字符并关闭空行触发；四、禁用跨文件符号推导和实时类型校验，提速约40%；五、升级至v2.8.0+并开启Craft流式补全，首token返回缩短至80ms内。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用 CodeBuddy 进行编码时发现代码补全响应迟缓、延迟明显或建议弹出不及时，则可能是由于上下文分析耗时、模型加载策略或本地环境配置导致。以下是提升代码补全速度的多种方法：
一、启用本地轻量模型推理
CodeBuddy 支持在本地运行轻量化推理模型，避免每次请求都依赖云端网络传输与排队调度，从而显著降低首字节响应延迟。该方式适用于对隐私敏感且网络带宽受限的开发环境。
1、打开 CodeBuddy 设置面板，进入「模型与性能」选项页。
2、在「补全模型部署位置」中选择本地运行(CPU/GPU加速)选项。
3、点击「下载并部署轻量模型」按钮，等待模型文件(约 1.2GB)完成下载与初始化。
4、重启 IDE 后，补全触发将直接调用本地模型，实测平均响应时间从 850ms 降至 190ms 以内。
二、优化项目上下文索引范围
CodeBuddy 默认扫描整个工作区以构建语义索引，当项目包含大量无关文件（如 node_modules、build 输出目录、日志文件）时，会拖慢上下文分析速度。限制索引边界可加快补全前的上下文准备阶段。
1、在 VS Code 中按下 Ctrl + Shift + P(Windows/Linux)或 Cmd + Shift + P(macOS)，输入并选择「Preferences: Open Settings (JSON)」。
2、在 settings.json 中添加以下配置项：
3、将"codebuddy.context.excludePatterns"设置为 ["**/node_modules/**", "**/dist/**", "**/build/**", "**/*.log"]。
4、保存后重启 CodeBuddy 插件服务，上下文构建耗时减少约 63%。
三、调整自动触发灵敏度阈值
CodeBuddy 的自动触发机制默认在缩进后、换行后或输入括号时激活，但过早触发会导致模型频繁预热。提高触发最小字符数阈值，可避免无效补全请求堆积，释放模型资源。
1、进入 CodeBuddy 设置中的「补全行为」子页。
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 问题
2、将“最小触发字符数”由默认的 1 调整为 2 或 3。
3、关闭「在空行末尾自动触发」选项。
4、确认设置后，补全弹窗出现更精准，IDE 主线程卡顿现象明显缓解。
四、禁用非必要补全增强模块
CodeBuddy 默认启用多层补全增强能力，包括跨文件符号推导、实时类型推断、测试覆盖率感知等模块。这些功能虽提升准确性，但会增加单次补全计算开销。关闭非关键模块可在保持基础准确率前提下大幅提速。
1、进入设置中的「高级补全」选项页。
2、取消勾选“启用跨文件符号推导”。
3、取消勾选“实时类型校验（Type-aware Completion）”。
4、保存设置并重启插件服务，补全响应提速约 40%。
五、升级至 v2.8.0+ 并开启 Craft 流式补全
Craft 流式补全是 CodeBuddy v2.8.0 引入的新机制，支持分块返回补全结果而非等待完整生成，使用户在模型推理未结束时即可看到首段高置信度建议，主观延迟感显著降低。
1、检查当前插件版本是否为 v2.8.0 或更高。
2、若非最新版，在插件市场中更新至最新稳定版本。
3、进入「模型与性能」页，启用“Craft 流式补全”开关。
4、重启 IDE 后，补全候选将在 首次 token 返回时间缩短至 80ms 内，视觉反馈更即时。
