codebuddy 提供 workspace-aware 依赖图谱、第三方库调用链定位、版本兼容性语义比对及交互式依赖树可视化四大能力，覆盖静态结构、动态调用、跨包影响与可视化诊断。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你在开发中遇到模块调用失败、版本冲突报错或不确定某个包是否被其他子包实际引用时，说明项目依赖关系尚未被清晰识别和验证。CodeBuddy 提供多种方式从不同维度检查依赖关系，覆盖静态结构、动态调用、跨包影响与可视化诊断。
启用 workspace-aware 依赖图谱分析
该方式适用于 monorepo 项目（如 pnpm、Lerna、Nx 管理的多包仓库），能识别包间真实引用路径、peer 依赖隐式约束及导出边界，避免仅靠 package.json 解析导致的误判。
第一步：确认项目根目录存在有效的 workspace 配置文件，例如 【pnpm-workspace.yaml 中 packages 字段必须非空且路径可解析】，若为空数组或路径通配符匹配不到任何子包，后续图谱将为空。
第二步：在 VS Code 或 JetBrains IDE 的 CodeBuddy 设置中，将 “Dependency Analysis Scope” 显式设为 “Workspace-level”。默认值是 “Package-level”，不会跨包扫描。
第三步：执行命令行指令：codebuddy analyze-deps --mode=graph。该命令会生成 deps-graph.svg 并输出环状依赖警告——这类结构极易引发构建失败或运行时循环 require。
查看第三方库在项目中的实际调用链
你不需要逐个打开 node_modules 查源码，CodeBuddy 能自动定位某库在当前项目里被哪些文件、哪几行、以什么参数形式调用过。
方法一：在 VS Code 中点击左侧 CodeBuddy 图标 → 进入“依赖洞察”面板 → 输入库名（如 axios、lodash、@nestjs/common）→ 点击“分析该库”。
方法二：右键编辑器中任意 import 语句（如 import { get } from 'axios'）→ 选择 “CodeBuddy → Find Usages in Project”。这比 IDE 原生查找更准，它会跳过类型声明、测试 mock 和未激活的条件分支。
注意：首次分析需等待 AST 解析完成，大型项目可能耗时 10～30 秒；期间不要关闭面板或切换文件，否则中断后需重试。
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 问题
检测依赖版本兼容性风险
当多个子包引用同一依赖但版本不一致时，TypeScript 类型检查可能通过，但运行时因模块解析歧义而崩溃。CodeBuddy 可基于 TS 接口签名做语义级比对，而非简单字符串匹配。
① 确保每个子包的 tsconfig.json 启用 "composite": true，且 "types" 指向编译后声明文件（如 ./dist/index.d.ts）。
② 在项目根目录运行：codebuddy check-versions --impact=type-safe。
③ 输出结果中带 ⚠️ 标记的条目表示：子包 A 使用 @myorg/utils@2.1.0 导出的接口，子包 B 却依赖其 3.0.0 版本，二者类型定义存在不可兼容变更，即使 package.json 允许共存，TS 构建也会报错。
生成依赖树并定位冲突节点
面对 npm ls 或 yarn list 输出的混乱嵌套，直接看文本难以定位真正冲突源。CodeBuddy 提供结构化可视化能力。
执行：codecli dependency-tree --format=graph。
该命令会启动本地 HTTP 服务，自动打开浏览器展示交互式依赖图——节点大小反映引用深度，红色边线标记版本冲突路径，鼠标悬停显示具体包名与版本号。
若发现某基础工具包（如 lodash）被 12 个子包以 5 种不同版本引入，可立即在根目录 package.json 中添加 resolutions 字段强制统一版本，无需逐个修改子包。
