codebuddy大文件补全问题可通过五种上下文管理技巧解决：一、启用分块滑动窗口并配置半径与头部保留；二、添加@cb-context锚点引导关键逻辑；三、禁用编辑时全文ast重建以提速；四、用@cb-scope划分作用域并绑定差异化补全规则；五、预载高频片段为本地缓存。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用 CodeBuddy 编辑超过 5000 行的单个源文件（如大型配置生成器、遗留协议解析器或巨型 TypeScript 工具类）时发现补全建议缺失、响应延迟严重或仅对光标附近局部生效，则可能是由于默认上下文窗口截断、词元溢出或语义索引策略未适配长文件结构所致。以下是针对大文件代码补全的多种上下文管理技巧：
一、启用分块上下文滑动窗口
CodeBuddy 默认采用固定长度的全局上下文窗口，对超长文件会丢弃远端代码段。启用滑动窗口机制后，模型将动态聚焦于光标前后 N 行构成的“感知切片”，并保留关键函数签名与类型定义锚点，避免语义断裂。
1、进入 CodeBuddy 设置面板，定位「高级性能」选项页。
2、开启「启用长文件滑动上下文」开关。
3、将「滑动窗口半径」设为 300（即光标前后各 300 行，共约 600 行参与实时分析）。
4、勾选「保留顶部导出声明与类型定义」以强制缓存文件头部 interface/class/type 块。
5、保存设置并重启插件服务，再次打开大文件验证补全是否覆盖跨区域调用（如底部函数调用顶部 const enum）。
二、手动标注关键上下文锚点
对于无明确模块划分的巨型文件，CodeBuddy 可能无法自动识别逻辑边界。通过添加特殊注释锚点，可显式引导模型将指定代码段纳入高优先级上下文，提升补全相关性与类型推导精度。
1、在文件中关键区域上方插入注释：// @CB-CONTEXT: CORE-UTILS。
2、在另一处核心逻辑块前插入：// @CB-CONTEXT: NETWORK-PROTOCOL。
3、确保每个锚点后紧跟至少一个完整函数/类定义（不可仅跟空行或变量声明）。
4、执行命令行指令：codebuddy reload-context-anchors，触发锚点重注册。
三、禁用全文语法树重建（仅限编辑阶段）
大文件的 AST 全量解析耗时显著，尤其在频繁键入时易造成补全阻塞。关闭非必要语法树更新可释放主线程资源，转而依赖轻量级 token 流匹配与锚点缓存，换取响应速度提升。
1、在 settings.json 中添加配置项："codebuddy.parser.fullAstOnEdit": false。
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、同时设置："codebuddy.suggestionDelay": 150（降低触发延迟阈值）。
3、重启 IDE 后，在大文件中连续输入时观察补全弹窗是否在按键后 200ms 内出现。
4、注意：该模式下跨函数体的深层类型推导能力将受限，适用于以补全命名、参数和基础结构为主的场景。
四、拆分补全上下文作用域
当单文件内混杂多种职责（如同时含数据结构定义、序列化逻辑、CLI 参数绑定），默认统一上下文会导致语义干扰。通过人工划分作用域，可让 CodeBuddy 在不同区域加载差异化补全策略。
1、在文件中使用注释界定作用域：// @CB-SCOPE: TYPES 与 // @CB-SCOPE: CLI。
2、在 CodeBuddy 设置中启用「按作用域加载补全规则」。
3、为 TYPES 区域关联 TypeScript 类型补全模型，为 CLI 区域绑定 yargs/commander 专用提示集。
4、保存后，在 CLI 区域输入 .option( 时，补全候选应精确显示 --help、--version 等标准参数而非泛型类型名。
五、预载高频访问片段至本地缓存
针对反复引用的长文件内部结构（如通用状态机跳转表、固定格式的 JSON Schema 描述块），可将其提取为独立缓存单元，绕过每次解析开销，实现毫秒级补全响应。
1、选中目标代码段（建议长度 ≤ 200 行），右键选择「CodeBuddy: Cache as Context Snippet」。
2、在弹出对话框中命名为 state-transition-table 并确认。
3、在其他位置输入该名称前缀（如 stt_），触发补全时将优先返回已缓存片段。
4、执行 codebuddy list-cached-snippets 验证缓存条目已注册。
