codebuddy 默认启用增量索引，需确保项目含标准配置文件、ide正确识别语言且未禁用索引；优化c++大项目可启用“工程理解智能体plus”；monorepo需设workspace-wide上下文并配置exports.json和tsconfig references；cli支持status、debug及--add-dir调试。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
CodeBuddy 的增量索引不是手动“开启”的开关，而是默认启用的智能行为，其效果取决于项目结构、语言特性及配置是否匹配。真正需要你主动配置的是**触发条件、索引范围和语义理解深度**，尤其在大型或复杂工程中。
确认项目已支持增量索引
CodeBuddy 对 C++、TypeScript/JavaScript（含 monorepo）、Python 等主流语言默认启用增量索引，但需满足基础前提：
- 项目根目录存在标准构建/配置文件（如 CMakeLists.txt、tsconfig.json、pyproject.toml）
- IDE 已正确识别为对应语言工程（例如 VS Code 中状态栏显示 TypeScript 或 C++）
- 未强制禁用索引（如设置 "indexing.enabled": false 在配置中）
调高索引精度与响应速度
针对 C++ 大型项目（500+ 头文件），可显式优化符号索引行为：
CodeBuddy CLI for OpenClaw
下载
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 问题
- 在 IDE 设置中启用 “工程理解智能体 Plus” 模块（部分版本需在 Settings → Advanced → Engineering Agent 中勾选）
- 确保 PIMPL、前向声明、多层命名空间等结构被识别：CodeBuddy 会自动扫描
class X;和namespace A::B，无需额外指令 - 首次索引后，后续编辑的符号响应延迟稳定在 180ms 以内，无需重启或手动刷新
monorepo 场景下的跨包增量索引
对 pnpm/Nx/Lerna 管理的多包项目，需扩展上下文感知范围才能实现真正的跨包增量更新：
- 将 Context Awareness Level 设为 Workspace-wide（而非 File 或 Package）
- 在根目录添加
.codebuddy/exports.json，显式声明各子包导出路径，避免因 re-export 不规范导致索引断裂 - 为每个子包 tsconfig.json 启用
"composite": true，并在根tsconfig.json中配置"references"，让 CodeBuddy 复用 tsc 的增量构建图
CLI 环境下验证与调试索引状态
使用 CodeBuddy CLI 可查看实时索引进度与问题：
- 运行
codebuddy status --index查看当前索引状态、已加载文件数、最后更新时间 - 加
--debug参数启动（codebuddy --debug），控制台会输出符号解析日志，便于定位未被索引的头文件或模块 - 若发现某类文件长期未被纳入（如自动生成的
.gen.h），可通过--add-dir手动追加路径：codebuddy --add-dir ./generated
