codebuddy补全卡顿可通过五步优化：1.切换至本地模型（cpu/gpu）使响应压至190ms；2.排除node_modules等无关路径减少63%索引耗时；3.调高最小触发字符数、关闭空行触发、降低延迟至300ms；4.禁用跨文件分析与类型推断提升40%速度；5.升级v2.8.0+启用craft流式补全，感知延迟降57%。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
CodeBuddy自动补全响应慢、卡顿、弹出延迟或频繁干扰输入，直接影响编码节奏和专注力，尤其在高频编辑如React组件编写或Python数据处理脚本中尤为明显。这不是模型能力不足，而是本地配置与上下文策略未对齐当前开发习惯。
启用本地轻量模型推理
远程调用云端模型每次都要经历DNS解析→TLS握手→网络传输→排队等待，实测首字节延迟高达850ms；切换为本地CPU/GPU推理后，模型加载一次即可复用，响应压至190ms内，且完全规避公网抖动与限流。
1、打开 CodeBuddy 设置面板 → 进入「模型与性能」选项页。
2、在「补全模型部署位置」中选择「本地运行（CPU加速）」或「本地运行（GPU加速）」。
3、点击「下载并部署轻量模型」按钮，等待约1.2GB模型文件完成下载与初始化——【此过程不可跳过，未完成则仍走云端路径】。
4、重启 IDE，补全触发将直接调用本地模型，无需联网，隐私敏感项目可放心使用。
限制上下文索引范围
默认情况下，CodeBuddy会扫描整个工作区构建语义索引，遇到含node_modules、dist、build等目录的大型前端项目时，光是索引准备就要耗时数秒。排除无关路径后，上下文分析阶段耗时减少63%，补全弹窗几乎“秒出”。
方法一：通过 settings.json 配置
1、按下 Ctrl + Shift + P（Windows/Linux）或 Cmd + Shift + P（macOS），输入并选择「Preferences: Open Settings (JSON)」。
2、在文件中添加以下字段：
"codebuddy.context.excludePatterns": ["**/node_modules/**", "**/dist/**", "**/build/**", "**/*.log", "**/.git/**"]
方法二：图形化界面快速设置
1、进入 CodeBuddy 设置 → 「上下文管理」子页。
2、点击「排除目录」右侧的「+」号，逐个添加 node_modules、dist、build 等文件夹路径。
3、勾选「启用排除规则」并保存，无需重启插件，规则即时生效。
调整自动触发灵敏度
触发太早（比如输入一个字母就弹窗）会导致模型预热频繁、IDE主线程卡顿；触发太晚（比如必须输完函数名加括号）又失去补全意义。关键不是“更灵敏”，而是“更准”。
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 问题
第一步：降低无效触发频率
进入「补全行为」子页 → 将“最小触发字符数”从默认1改为2或3，避免单字符（如“f”）就拉起补全引擎。
第二步：关闭空行干扰
取消勾选「在空行末尾自动触发」——这个选项常导致光标移到空行就弹窗，打断代码块粘贴或注释书写。
第三步：微调响应延迟
找到配置项 codeBuddy.completion.autoTriggerMinDelayMs，将其由500ms改为300ms。数值越小响应越快，但低于200ms可能引发误触发，【不建议设为0或负值】。
禁用非必要补全增强模块
跨文件符号推导和实时类型校验虽能提升补全准确率，但代价是每次触发都需额外解析依赖链。对中小型项目或原型开发阶段，这些模块属于“过度设计”，关掉后补全速度提升40%，且不影响基础变量、方法名、关键字等核心推荐。
1、进入 CodeBuddy 设置 → 「高级补全」选项页。
2、关闭「启用跨文件符号分析」和「启用实时类型推断」两项开关。
3、重启插件服务，验证补全弹窗出现速度是否明显加快——可在任意.py文件中连续输入print(观察括号内候选是否更快浮现。
升级至v2.8.0+并开启Craft流式补全
Craft模式采用增量式token生成，边算边吐，用户能看到补全内容逐字展开，心理等待感大幅降低。实测在长函数体生成场景下，用户感知延迟下降57%，比传统“等整段渲染完再显示”更符合人眼阅读节奏。
1、检查当前版本：在VS Code扩展面板中搜索CodeBuddy，确认版本号 ≥ v2.8.0。
2、若未达版本，点击「更新」按钮完成升级。
3、升级后进入「模型与性能」页 → 开启「启用Craft流式补全」开关。
4、重启IDE，新写一个def函数，输入参数后暂停，观察补全内容是否以流式方式逐字呈现。
