102 lines
3.1 KiB
Markdown
102 lines
3.1 KiB
Markdown
|
# 基于大模型的开源项目质量分析系统
|
|||
|
|
|
|||
|
|
## 项目简介
|
|||
|
|
|
|||
|
|
本项目是一个基于九格大模型的开源项目质量智能分析系统，旨在为红山开源平台提供自动化、智能化的项目质量评估服务。系统通过分析项目的代码质量、文档完整性、社区活跃度等多维度指标，生成全面的质量分析报告。
|
|||
|
|
|
|||
|
|
## 功能特性
|
|||
|
|
|
|||
|
|
- 🔍 **多维度质量分析**：代码质量、文档完整性、项目活跃度、社区健康度
|
|||
|
|
- 🤖 **AI智能评估**：基于九格大模型的智能分析与建议
|
|||
|
|
- 📊 **可视化报告**：直观的图表展示和详细的分析报告
|
|||
|
|
- 🎯 **自动化评分**：综合评分系统，快速了解项目质量
|
|||
|
|
- 💡 **改进建议**：AI生成针对性的改进建议
|
|||
|
|
|
|||
|
|
## 技术栈
|
|||
|
|
|
|||
|
|
- **后端**: Python 3.8+, Flask
|
|||
|
|
- **AI模型**: 九格大模型 API
|
|||
|
|
- **数据分析**: pandas, numpy
|
|||
|
|
- **可视化**: matplotlib, plotly
|
|||
|
|
- **代码分析**: pylint, radon
|
|||
|
|
- **前端**: HTML5, CSS3, JavaScript, Bootstrap
|
|||
|
|
|
|||
|
|
## 快速开始
|
|||
|
|
|
|||
|
|
### 环境要求
|
|||
|
|
|
|||
|
|
- Python 3.8 或更高版本
|
|||
|
|
- pip 包管理器
|
|||
|
|
|
|||
|
|
### 安装步骤
|
|||
|
|
|
|||
|
|
1. 克隆项目
|
|||
|
|
```bash
|
|||
|
|
git clone <repository-url>
|
|||
|
|
cd 开源项目质量评估
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
2. 安装依赖
|
|||
|
|
```bash
|
|||
|
|
pip install -r requirements.txt
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
3. 配置API密钥
|
|||
|
|
在 `config.py` 中配置九格大模型的API密钥
|
|||
|
|
|
|||
|
|
4. 运行应用
|
|||
|
|
```bash
|
|||
|
|
python app.py
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
5. 访问应用
|
|||
|
|
打开浏览器访问 `http://localhost:5000`
|
|||
|
|
|
|||
|
|
## 使用说明
|
|||
|
|
|
|||
|
|
1. 在主页输入GitHub仓库URL或上传项目压缩包
|
|||
|
|
2. 系统自动分析项目结构和代码质量
|
|||
|
|
3. AI模型生成智能分析报告
|
|||
|
|
4. 查看可视化图表和改进建议
|
|||
|
|
5. 导出PDF格式的质量报告
|
|||
|
|
|
|||
|
|
## 项目结构
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
开源项目质量评估/
|
|||
|
|
├── app.py # Flask应用主程序
|
|||
|
|
├── config.py # 配置文件
|
|||
|
|
├── requirements.txt # 依赖包列表
|
|||
|
|
├── analyzer/ # 分析模块
|
|||
|
|
│ ├── code_analyzer.py # 代码质量分析
|
|||
|
|
│ ├── doc_analyzer.py # 文档分析
|
|||
|
|
│ ├── activity_analyzer.py # 活跃度分析
|
|||
|
|
│ └── ai_analyzer.py # AI智能分析
|
|||
|
|
├── templates/ # HTML模板
|
|||
|
|
│ ├── index.html # 主页
|
|||
|
|
│ └── report.html # 报告页面
|
|||
|
|
├── static/ # 静态资源
|
|||
|
|
│ ├── css/ # 样式文件
|
|||
|
|
│ ├── js/ # JavaScript文件
|
|||
|
|
│ └── images/ # 图片资源
|
|||
|
|
└── docs/ # 文档目录
|
|||
|
|
├── 策划书.md # 项目策划书
|
|||
|
|
├── 技术说明文档.md # 技术文档
|
|||
|
|
└── 使用手册.md # 使用手册
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 应用价值
|
|||
|
|
|
|||
|
|
1. **提升项目质量**：帮助开发者识别项目问题，提供改进方向
|
|||
|
|
2. **辅助决策**：为红山平台项目推荐和筛选提供数据支持
|
|||
|
|
3. **促进社区健康**：通过质量分析促进开源社区良性发展
|
|||
|
|
4. **节省时间**：自动化分析替代人工审核，提高效率
|
|||
|
|
|
|||
|
|
## 许可证
|
|||
|
|
|
|||
|
|
MIT License
|
|||
|
|
|
|||
|
|
## 联系方式
|
|||
|
|
|
|||
|
|
如有问题或建议，欢迎提Issue或PR。
|