codebuddy 通过混元大模型与 dependency graph 技术实现多文件上下文理解：一、craft 智能体驱动跨文件协同生成；二、@codebase 增强跳转与解释；三、代码诊断模块提取可视化依赖图。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在开发中需要跨多个文件协调修改逻辑、同步更新配置与实现，却发现传统工具仅能聚焦单文件内容，则可能是由于缺乏项目级依赖建模与语义关联能力。CodeBuddy 的多文件上下文理解能力依托混元代码大模型与 Dependency Graph 解析技术，在 IDE 内直接构建全项目结构化索引，实现函数调用链穿透、模块职责映射与变更影响面预判。以下是验证与强化该能力的具体方式：
一、启用 Craft 智能体驱动的多文件协同生成
该方法通过需求指令触发智能体自动识别相关文件边界并批量生成/改写，适用于新增页面、扩展 API 或重构模块等需跨文件联动的场景，避免人工逐个定位与手动同步。
1、在 VS Code 或微信开发者工具中，确保已安装 CodeBuddy 插件并完成项目首次索引扫描。
2、打开命令面板（Ctrl+Shift+P / Cmd+Shift+P），输入并选择 “Craft: Start New Task”。
3、输入自然语言指令，例如：“添加用户注销功能，需修改登录态管理 service、前端登出按钮组件、云函数 logout 接口及 app.json 页面路由”。
4、等待 Craft 智能体分析依赖图谱，自动生成包含四类文件的初始代码，并在编辑器中以差异视图高亮展示变更位置。
二、使用 @Codebase 上下文增强跳转与解释
此方法在光标悬停或跳转定义时，动态注入跨文件引用信息，使函数解释不再孤立于当前文件，而是绑定真实调用路径与上下游模块语义，特别适用于阅读遗留系统或排查跨层 Bug。
1、将光标置于任意函数名上，按 Alt+Click（Windows/Linux）或 Option+Click（macOS）跳转至其定义。
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、在定义文件顶部工具栏点击 “Explain with @Codebase” 按钮。
3、CodeBuddy 将返回该函数的实际调用频次统计、上游触发入口文件列表、下游被调用模块名称及对应文件路径。
4、点击任一上游文件路径，可一键跳转至具体调用行，并查看该调用点的参数传递上下文快照。
三、运行代码诊断模块提取跨文件依赖图
该方式基于静态分析引擎主动构建项目级依赖关系图（Dependency Graph），输出可视化结构，支持反向追溯调用源头与正向追踪影响范围，适用于架构评审或安全合规审查。
1、右键点击项目根目录或任意源码文件夹，选择 “Run Code Diagnosis”。
2、在诊断面板中勾选 “Analyze Cross-File Dependencies” 选项。
3、点击 “Generate Dependency Graph”，系统将渲染交互式图谱，节点为文件，连线标注调用类型（import / require / extends / call）。
4、点击任一节点，面板将显示该文件内被外部引用的符号列表、引用它的全部文件路径、以及每个引用点所在的行号与上下文代码片段。
