这是一个名为 gitdiagram 的开源工具,可将 GitHub 仓库实时转换为交互式架构图,帮助开发者快速理解代码结构。
核心功能
- 一键可视化:替换 GitHub URL 中的 "hub" 为 "diagram" 即可生成图表
- 交互式导航:点击图表元素直接跳转至源码/目录
- AI 驱动:使用 Claude 3.5 Sonnet(后改为 OpenAI o3-mini)分析代码结构
- 私有仓库支持:通过 GitHub Token 实现私有仓库可视化
- Mermaid.js 集成:生成可交互的 Mermaid 图表
技术架构
- 前端:Next.js + TypeScript + Tailwind
- 后端:FastAPI + Python
- 数据库:PostgreSQL(Drizzle ORM)
- 部署:Vercel(前端) + EC2(后端)
- AI 处理:基于文件树和 README 的提示工程(prompts.py)
使用场景
- 快速理解开源项目结构
- 新成员代码库导览
- 系统架构文档生成
- 私有代码库可视化分析
扩展能力
- 支持通过 API 集成(开发中)
- 本地化部署(Docker + 数据库容器化)
- 自定义提示词修改图表
参考资料:
https://github.com/ahmedkhaleel2004/gitdiagram