用途:根据代码库的导入语句和跨模块依赖,生成 Mermaid 流程图,直观展示模块、包或插件之间的依赖方向与结构。适合用来理解依赖关系、查找循环依赖、分析模块耦合,或在重构前评估“改动某模块会影响什么”。
主要能力:先由代码库探索代理扫描指定范围,返回结构化模型,再转换为 Mermaid 语法。图中用 flowchart LR 表示依赖方向,每条边从依赖方指向被依赖方(A --> B 表示 A 依赖 B);内部依赖用默认箭头,外部或可选依赖用虚线箭头(-.->),关键路径依赖用粗箭头(==>);可按包或插件分组为 subgraph;若提供 depth 参数,可限制传递依赖的层级;检测到循环依赖时用红色样式高亮。
使用方式:第一步,调用 Agent(cartograph:codebase-explorer),让其探索指定范围并聚焦导入语句和跨模块依赖,区分内部与外部导入;第二步,把结构模型转换为 Mermaid 依赖图语法;第三步,调用 mcp__claude_ai_Mermaid_Chart__validate_and_render_mermaid_diagram 渲染,参数包括 prompt、mermaidCode、diagramType 为 flowchart、clientName 为 claude-code,若渲染失败可修正语法并重试,最多重试两次;第四步,展示成图并附分析说明,包含模块总数与依赖数量、被依赖最多(高扇入)的模块、依赖最多(高扇出)的模块,以及检测到的循环依赖。
适用场景:依赖关系梳理、循环依赖排查、耦合度分析、重构影响评估。
限制:不用于分析运行时调用路径(可用 cartograph:call-chain)和类型层次结构(可用 cartograph:class-diagram)。其他限制暂未提供。