SuperAPI AI 工具集

graph-export-mermaid

编程与开发

查看项目

更新于 10-15 21:35

技能介绍

用途:将单个文件的知识图谱从 .code-graph/graph.db 导出为 Markdown 中的 Mermaid 流程图,便于可视化文件内部结构。

主要能力:展示文件内的函数、类与测试函数,内部调用关系(调用方与被调用方均在同一文件),类成员以嵌套子图呈现;边类型包括 calls、imports、inherits、implements、tests、depends。非代码文件(如 Markdown、JSON)会渲染出向与入向的 IMPORTS_FROM 边作为引用图。图中还可能包含 MESSAGE_BUS、TRIGGERS_EVENT、API_ENDPOINT 等隐式边。不包含外部或标准库调用、代码文件的跨文件关系,以及 CONTAINS 边(改用子图结构表示)。

使用方式:先确保图谱已构建,若 .code-graph/graph.db 不存在需先运行 $graph-build。环境需 Python 3.10+ 及 tree-sitter、tree-sitter-language-pack、networkx。导出命令:python .claude/scripts/code_graph export-mermaid <relative-path> --json,或使用 --file 标志;可用 -o 指定自定义输出路径。默认输出为 .code-graph/<基于路径的唯一名称>-graph.md。完成后报告文件路径、节点数与边数。

适用场景:重构前理解代码结构、以 Markdown 兼容格式记录架构、审查文件复杂度与耦合度。

限制:需先构建图谱;仅覆盖单文件内部关系;外部调用与跨文件关系不包含;具体平台兼容性与收费信息暂未提供。