CodeGraph框架路由完全手册：让AI代理秒懂你的Django/Flask/FastAPI/Express路由

CodeGraph框架路由完全手册让AI代理秒懂你的Django/Flask/FastAPI/Express路由【免费下载链接】codegraphPre-indexed code knowledge graph, auto syncs on code changes, for Claude Code, Codex, Gemini, Cursor, OpenCode, AntiGravity, Kiro, CoPilot, and Hermes Agent — fewer tokens, fewer tool calls, 100% local项目地址: https://gitcode.com/GitHub_Trending/co0degr/codegraphCodeGraph是一款 100% 本地运行的代码知识图谱工具它预先为你构建整个代码库的符号、调用与依赖关系图让 Claude Code、Cursor、Codex、Gemini 等 AI 编码代理用更少的 token 和更少的工具调用直接理解代码。而它最被低估的能力之一是框架路由识别Framework-aware Routes自动把 Django、Flask、FastAPI、Express 等 17 种 Web 框架的 URL 模式与其处理函数连接起来让 AI 代理一问就能回答这个接口在哪里谁在调用它改它会波及哪里 本文是一份面向新手和进阶用户的完整手册带你彻底搞懂 CodeGraph 的框架路由能力。什么是框架路由识别传统的静态分析止步于函数调用了函数。但 Web 项目里真正驱动业务的入口是URLGET /users/id到底由哪个函数处理某个 View 被哪些路由绑定修改中间件会影响哪些接口CodeGraph 的解决方案是在索引阶段识别框架路由文件生成route路由节点并通过references引用边把它链接到对应的处理函数或类。这样查询任何视图/控制器的调用方时绑定的 URL 模式会一并浮现出来。识别逻辑集中在两个核心文件Python 三框架Django/Flask/FastAPIsrc/resolution/frameworks/python.tsExpress/Node.jssrc/resolution/frameworks/express.ts全部 30 个框架解析器注册表src/resolution/frameworks/index.ts框架检测是自动的比如 Django 解析器会检查requirements.txt、pyproject.toml中是否含django或直接探测项目根目录是否存在manage.pysrc/resolution/frameworks/python.ts你无需任何手动配置。一键上手三步完成 CodeGraph 安装与初始化上手 CodeGraph 只需三条命令无需预装 Node.js它自带运行时# 1. 安装 CLImacOS / Linux curl -fsSL https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.sh | sh # 2. 在你的 AI 代理中接线自动配置 MCP codegraph install # 3. 初始化项目构建完整知识图谱自动同步从此开启 cd your-project codegraph initcodegraph init会创建本地.codegraph/目录并一步完成全量建图。之后文件一改动图谱就自动增量同步无需再手动运行。Django 路由识别urls.py 全形态覆盖这是 CodeGraph 框架路由最重的解析器之一。它能识别 urls.py 中的这些形态写法说明path(url, handler)标准函数视图re_path(r..., handler)/url(r..., handler)正则路由path(x/, MyView.as_view())类视图CBV支持点号路径app.views.MyView.as_view()include(app.urls)子模块挂载会建立到子 urlconf 的依赖边更贴心的是DRF 路由注册router.register(rarticles, ArticleViewSet)会被识别为VIEWSET /articles路由节点直接连到 ViewSet 类——这类由 DRF 动态生成的 CRUD 端点是path()语法抓不到的src/resolution/frameworks/python.ts。它还处理 Django 的深水区Model / View / Form 命名约定解析*Model、*View、*ViewSet、*Form等按名称类型匹配优先命中models/、views/等约定目录src/resolution/frameworks/python.tsORM 动态派发桥接QuerySet 里self._iterable_class(self)这种运行时派发静态分析天然断链CodeGraph 会把它桥接到ModelIterable.__iter__让QuerySet → SQL 编译器的调用链在图中完整存在src/resolution/frameworks/python.tsFlask 路由识别Blueprint 与堆叠装饰器Flask 解析器src/resolution/frameworks/python.ts覆盖app.route(/path, methods[...])—— 支持 methods 为列表或元组Blueprint 路由users_bp.route(/id, methods[POST])堆叠装饰器同一个视图上挂多个bp.route()或夹着login_required等中间件装饰器都能正确绑定到下方最近的defFlask-RESTfulapi.add_resource(UserAPI, /users, /users/id)会展开为多条ANY路由节点连到资源类src/resolution/frameworks/python.tsFastAPI 路由识别装饰器路由全覆盖FastAPI 解析器识别所有标准 HTTP 方法装饰器src/resolution/frameworks/python.tsapp.get(...)、router.post(...)、put / patch / delete / options / head路径可为空串挂载在路由前缀根部支持async def处理函数Depends依赖注入get_*、Depends前缀的引用会按名称解析到/dependencies/、/core/等约定目录中的依赖函数src/resolution/frameworks/python.tsExpress 路由识别内联处理器与中间件链Express 解析器src/resolution/frameworks/express.ts针对 Node.js 项目app.get(...)/router.post(...)全方法支持连use中间件挂载也在识别范围内联箭头函数处理器也能正确连接早期正则搞不定跨括号的内联函数现已修复中间件链router.post(/items, auth, createItem)中每个中间件都会成为图中的边智能降噪res.json()、req.next()等框架噪声调用不会污染业务调用链src/resolution/frameworks/express.ts自动探测检查package.json中是否含express、fastify、koa、hapi依赖src/resolution/frameworks/express.ts如何验证路由已进图三个常用命令索引建好后不用打开 AI 代理也能验证# 按名称搜索路由节点 codegraph query GET /users # 一次获取相关符号源码 调用路径 codegraph explore user list endpoint # 查某个处理函数被哪些路由/代码调用 codegraph callers create_itemAI 代理侧对应的是codegraph_explore等 MCP 工具一次调用即可拿到入口、相关源码和影响半径。想确认路由提取的正确性可以看看官方测试用例tests/frameworks.test.ts 里逐条覆盖了 CBV、点号路径、Blueprint、堆叠装饰器、Express 中间件链等场景。常见问题Q路由变更后需要重新索引吗不需要。文件监听器默认 2 秒防抖会在你保存urls.py的瞬间自动增量同步MCP 重连时还会做一次内容哈希对账确保图谱永远新鲜。Q我的框架不在 17 种列表里怎么办框架解析器是可扩展的——通过registerFrameworkResolver注册自定义解析器即可src/resolution/frameworks/index.ts。Q数据会上传吗不会。CodeGraph 100% 本地运行只用本地 SQLite无 API Key、无外部服务。总结框架核心识别形态源码位置Djangopath()/re_path()/include()/.as_view()/ DRFregisterpython.tsFlaskapp.route/ Blueprint / Flask-RESTfulpython.tsFastAPI全方法装饰器路由 / Depends 依赖python.tsExpress方法路由 / 中间件链 / 内联处理器express.ts三条命令装好 CodeGraph让 AI 代理从翻文件猜结构变成查图直接答——框架路由识别正是它理解 Web 项目的第一把钥匙 【免费下载链接】codegraphPre-indexed code knowledge graph, auto syncs on code changes, for Claude Code, Codex, Gemini, Cursor, OpenCode, AntiGravity, Kiro, CoPilot, and Hermes Agent — fewer tokens, fewer tool calls, 100% local项目地址: https://gitcode.com/GitHub_Trending/co0degr/codegraph创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考