AI 驱动的 GitHub 项目分析工具，帮助中国开发者快速理解和评估开源项目。
- README 中文翻译 - 智能翻译，保留 Markdown 格式和代码块
- 项目摘要生成 - 一句话概括项目核心价值
- 技术栈识别 - 自动识别语言、框架、工具
- 架构分析 - 目录结构、模块划分、设计模式
- Issues 趋势 - 标签分布、月度趋势、关闭率统计
- 代码语义检索 - 基于 RAG 的代码理解，支持自然语言提问
- 精确代码搜索 - GitHub API 直接搜索，带行号定位
- 对话历史 - 支持多轮对话，上下文理解
- 索引进度 - 实时显示代码索引状态
- 可视化配置 - 在系统设置页面直接配置 API Key，无需手动编辑文件
- 配置热更新 - 配置修改后立即生效，无需重启服务
- 存储管理 - 数据大小查看、历史数据清理
┌─────────────────────────────────────────────────────────┐
│ Frontend (Next.js) │
│ React 19 + Tailwind CSS + shadcn/ui │
└─────────────────────────┬───────────────────────────────┘
│ API
┌─────────────────────────▼───────────────────────────────┐
│ Backend (FastAPI) │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌─────────┐ │
│ │ 分析引擎 │ │ Agent │ │ RAG │ │ 配置 │ │
│ │ │ │(LangGraph)│ │(LangChain)│ │ 管理 │ │
│ └──────────┘ └──────────┘ └──────────┘ └─────────┘ │
└─────────────────────────┬───────────────────────────────┘
│
┌────────────────┼────────────────┐
│ │ │
┌────▼────┐ ┌──────▼──────┐ ┌─────▼─────┐
│ SQLite │ │ ChromaDB │ │ GitHub API│
│ 数据库 │ │ 向量数据库 │ │ │
└─────────┘ └─────────────┘ └───────────┘
技术栈：
- 前端：Next.js 16、React 19、Tailwind CSS、shadcn/ui
- 后端：FastAPI、SQLite、ChromaDB
- AI：LangChain、LangGraph、DashScope Embedding
- 部署：Docker、docker-compose
# 1. 克隆项目
git clone https://github.com/zhouke0929/github-analyzer.git
cd github-analyzer
# 2. 启动服务
docker-compose up -d
# 3. 访问应用
# 前端：http://localhost:3000
# 后端：http://localhost:8001
# 4. 配置 API Key
# 访问 http://localhost:3000/settings，填入你的 API Key 即可使用环境要求： Python 3.11+、Node.js 20+
# 1. 克隆项目
git clone https://github.com/zhouke0929/github-analyzer.git
cd github-analyzer
# 2. 后端
cd backend
pip install -r requirements.txt
python -m uvicorn app.main:app --reload --host 0.0.0.0 --port 8001
# 3. 前端（新终端）
cd frontend
npm install
npm run dev
# 4. 配置 API Key
# 访问 http://localhost:3000/settings，填入你的 API Key 即可使用启动后访问 http://localhost:3000/settings 进行可视化配置：
| 配置项 | 说明 | 是否必填 |
|---|---|---|
| GitHub Token | 提高 API 限额（60→5000 次/小时） | 可选 |
| 聊天模型 API Key | 用于项目分析和智能问答 | 必填 |
| 聊天模型 Base URL | 兼容 OpenAI 接口的服务地址 | 必填 |
| 聊天模型名称 | 如 gpt-4o-mini、mimo-v2.5 | 必填 |
| 向量模型 API Key | 用于代码语义检索 | 必填 |
| 向量模型 Base URL | 兼容 OpenAI 接口的服务地址 | 必填 |
| 向量模型名称 | 如 text-embedding-v4 | 必填 |
所有兼容 OpenAI 接口的 AI 服务均可使用，只需修改 Base URL 和模型名称即可。
- 配置 API Key：首次使用请先访问系统设置页面配置 API Key
- 分析项目：在首页输入 GitHub 仓库地址，点击分析
- 查看结果：查看翻译、摘要、技术栈、架构、Issues 分析
- 智能问答：点击"开始对话"，等待代码索引完成，即可提问
github-analyzer/
├── backend/ # 后端服务
│ ├── app/
│ │ ├── api/ # API 路由
│ │ ├── services/ # 业务服务
│ │ ├── models/ # 数据模型
│ │ └── config.py # 配置管理
│ ├── Dockerfile
│ └── requirements.txt
├── frontend/ # 前端应用
│ ├── src/
│ │ ├── app/ # 页面
│ │ ├── components/ # 组件
│ │ └── lib/ # 工具库
│ └── Dockerfile
├── docker-compose.yml
└── README.md
MIT License