GitDiagram:把 GitHub 代码仓库转换成交互式架构图
一分钟看懂
GitDiagram 是一个代码库架构可视化工具。它读取 GitHub 仓库树、README 和受限源码片段,用 AI 生成系统级组件关系图,并提供可点击的源码链接、Mermaid 导出和图片下载。
你可以用它做什么
- 快速理解陌生开源仓库的主要模块和依赖关系。
- 将公开或获授权的私有 GitHub 仓库生成为交互图。
- 点击图中组件跳回对应 GitHub 文件或目录。
- 复制 Mermaid 源码,或下载渲染后的 PNG 图像。
主要能力
- 侧重系统架构关系,而非简单绘制目录树。
- 对模型输出的节点、连线、路径和连通性进行确定性校验。
- 支持流式说明、取消生成和已生成结果复用。
- 可使用托管模型,也能在自部署时选择 OpenRouter 等提供商。
适合哪些人
适合需要快速熟悉代码库的开发者、技术评审者和学习者,也适合在文档或讨论中需要可编辑架构草图的团队。
怎么开始使用
在线使用时打开项目网站并输入 GitHub 仓库;私有仓库需在浏览器中提供具备只读权限的细粒度 GitHub Token。自行开发时按仓库文档安装 Bun 依赖,并配置对象存储、Redis、GitHub 凭据和至少一个 AI 提供商。
使用前需要知道
架构图由有限源码片段和模型推断生成,可能遗漏动态行为或误判关系,不能替代源码审查。私有仓库模式会处理代码和访问令牌,应限制 Token 权限并核对部署的数据保留策略;托管 AI 还可能产生费用。项目采用 MIT 许可证。