CodeBuddy需通过四步实现深度项目理解：一、创建并完善CODEBUDDY.md以构建项目快照；二、主动触发快照重建以捕获跨文件调用关系；三、添加人工语义锚点对齐隐式约定；四、启用Craft Mode分步验证重构建议。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您正在使用CodeBuddy处理一个包含几十个文件的大型项目，但发现它未能准确识别重复逻辑或提出针对性重构建议，则可能是由于AI尚未建立完整的项目上下文感知。以下是实现深度项目理解与精准建议的关键操作路径：
一、确保CODEBUDDY.md配置文件存在并完整
CODEBUDDY.md是CodeBuddy构建项目快照（project snapshot）的锚点文件，缺失或内容不全将导致AI仅能进行片段级分析，无法形成跨文件逻辑关联。该文件需明确声明技术栈、核心模块职责、关键依赖关系及数据流向。
1、在项目根目录下检查是否存在CODEBUDDY.md文件。
2、若不存在，手动创建该文件，并填入项目语言类型、主入口文件路径、数据库连接方式等基础元信息。
3、在文件中补充关键模块说明，例如：“/src/services/order/OrderService.js负责订单创建与状态流转，其sendNotification方法与/src/services/user/UserService.js中的notifyUser存在90%逻辑重合”。
二、主动触发项目快照重建
CodeBuddy依赖静态扫描与动态执行日志联合构建上下文，仅靠首次加载无法捕获全部语义。必须通过显式指令强制刷新快照，使AI重新索引所有文件间的调用链与数据契约。
1、在CodeBuddy问答区输入指令：“请基于当前全部源码重建项目快照，特别关注/src/controllers和/src/services目录下的函数间调用关系”。
2、等待工具完成扫描后，确认右下角状态栏显示“Project Snapshot: Ready (N files indexed)”。
3、立即发起二次提问：“列出所有参数签名相似、返回值结构一致且命名语义接近的函数对”。
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 问题
三、提供人工标注的高价值锚点
当项目存在隐式约定（如统一错误码格式、中间件注入规则）时，AI需借助开发者标记的“语义锚点”才能对齐理解维度。这些锚点作为推理基准，可显著提升跨文件分析准确率。
1、在任意JS/TS文件顶部添加注释块，格式为// @CB-ANCHOR: AUTH_MIDDLEWARE_CHAIN。
2、在CODEBUDDY.md中对应位置声明该锚点含义：“AUTH_MIDDLEWARE_CHAIN：所有路由守卫均在此处注册，后续服务层不得重复校验token有效性”。
3、向CodeBuddy提交问题：“检查/src/routes/*.js是否违反AUTH_MIDDLEWARE_CHAIN约束，并标出违规行号”。
四、启用Craft Mode进行多步推理验证
Craft Mode支持将复杂分析任务拆解为可验证子步骤，避免AI一次性生成不可靠结论。针对大型项目，必须启用该模式以确保每条建议均可追溯至具体代码证据。
1、点击工具栏Craft Mode开关，确保状态为激活。
2、输入指令：“分三步执行：第一步，提取所有含‘calculate’字样的函数签名；第二步，对比其输入参数类型与业务上下文注释；第三步，合并具有相同参数组合与计算目标的函数”。
3、逐项查看CodeBuddy返回的每步执行结果，对存疑步骤追加反向验证指令，例如：“请展示calculateDiscountV2与calculateDiscountV1在/src/utils/pricing.js中的调用栈差异”。
