SuperAPI AI 工具集

graph-connect-api

编程与开发

查看项目

更新于 10-15 21:35

技能介绍

用途:在知识图谱中建立前端 HTTP 调用与后端路由定义之间的对应关系,生成 API_ENDPOINT 边,供前端到后端的链路追踪使用。

主要能力:扫描前端文件中的 HTTP 调用与后端文件中的路由定义,归一化 URL 路径后按多策略匹配,策略按置信度从高到低依次为精确匹配(1.0)、前缀补全(0.95)、后缀匹配(0.9)、深度剥离(0.85)、双侧深度剥离(0.8);支持控制器解析,将配置的路由占位符解析为实际路由归属名。支持零配置自动检测框架:前端依据 react、vue.config.js、next.config.js、svelte.config.js 及 package.json 等标记;后端依据 pom.xml/build.gradle 中的 spring-boot、express、@nestjs/core、fastapi、Django 的 manage.py、Rails 的 Gemfile、Go 的 go.mod 等标记。

使用方式:通常无需手动运行,构建/更新/同步后会自动执行,首次 trace、query、connections 时也会自动运行一次。手动运行命令为 python .claude/scripts/code_graph connect-api --json,随后报告前端调用数、后端路由数、匹配数与边数。可在 docs/project-config.json 的 graphConnectors.apiEndpoints 中配置前端/后端框架、路径、routePrefix 与 customPatterns;自定义模式为扩展内置模式而非替换,显式配置会覆盖自动检测的路径配置。

适用场景:需要梳理前后端接口对应关系、进行系统全链路追踪或影响面分析的项目。

限制:依赖知识图谱已构建(需先执行 $graph-build);匹配结果按置信度分级,需以 file:line 证据支撑且置信度高于 80% 才可据以行动;自定义 HTTP 模式需项目自行配置;资料未提供收费、价格与平台支持范围等信息。