# git-log-analysis

**Repository Path**: zhmwei/git-log-analysis

## Basic Information

- **Project Name**: git-log-analysis
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-05
- **Last Updated**: 2025-11-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# GitLab提交日志分析工具

一个基于AI大模型的智能GitLab提交日志分析工具，能够自动生成专业的工作任务报告，帮助开发团队更好地了解项目进展和代码质量。

## 🌟 主要功能

### 🎯 智能分析报告
- **AI驱动的分析**：基于大语言模型深度分析GitLab提交日志
- **自动生成报告**：智能识别工作类型（功能开发、Bug修复、重构等）
- **数据可视化**：丰富的图表展示提交趋势和分布情况
- **专业摘要**：生成执行摘要和关键成就说明

### ⚙️ 配置管理
- **多项目管理**：支持多个GitLab仓库配置
- **持久化存储**：配置信息本地存储，一次配置永久有效
- **连接测试**：实时验证GitLab连接状态
- **安全管理**：安全的访问令牌管理机制

### 📊 数据分析
- **时间区间选择**：灵活的日期范围选择器
- **提交统计**：详细的提交数量和质量分析
- **趋势分析**：每日提交趋势图表
- **类型分布**：功能开发、Bug修复、重构等分类统计

### 🎨 现代化界面
- **响应式设计**：完美适配桌面端、平板和移动设备
- **流畅动画**：基于Anime.js的流畅交互动画
- **专业视觉**：现代化的设计语言，优雅的视觉效果
- **用户友好**：直观的操作流程和实时反馈

## 🛠️ 技术架构

### 前端技术栈
- **HTML5 + CSS3**：现代化的网页结构和样式
- **Tailwind CSS**：实用优先的CSS框架
- **JavaScript ES6+**：现代JavaScript特性
- **Anime.js**：高性能动画库
- **ECharts.js**：专业数据可视化
- **Splitting.js**：文字动画效果

### 核心库依赖
```javascript
// 动画和交互
- Anime.js: 流畅的页面动画和过渡效果
- Splitting.js: 文字分割和动画效果

// 数据可视化
- ECharts.js: 专业的图表和数据展示

// 样式框架
- Tailwind CSS: 响应式设计和组件样式
```

## 📁 项目结构

```
GitLab-Analyzer/
├── index.html              # 主控制台页面
├── config.html             # 配置管理页面
├── reports.html            # 报告展示页面
├── main.js                 # 主要JavaScript逻辑
├── resources/              # 资源文件夹
│   ├── hero-bg.jpg         # 主页背景图
│   ├── config-bg.jpg       # 配置页面背景
│   └── report-bg.jpg       # 报告页面背景
├── design.md               # 设计规范文档
├── interaction.md          # 交互设计文档
├── outline.md              # 项目概要文档
└── README.md               # 项目说明文档
```

## 🚀 快速开始

### 1. 启动应用
```bash
# 在项目根目录启动本地服务器
python -m http.server 8000

# 或使用Node.js
npx http-server

# 或使用PHP
php -S localhost:8000
```

### 2. 访问应用
在浏览器中打开 `http://localhost:8000`

### 3. 配置GitLab连接
1. 点击"配置管理"页面
2. 添加新的GitLab配置
3. 输入GitLab实例地址、项目名称和访问令牌
4. 测试连接确保配置正确

### 4. 生成分析报告
1. 返回主控制台页面
2. 选择要分析的项目
3. 设置时间范围
4. 点击"生成分析报告"
5. 在报告中心查看结果

## 📋 使用指南

### 配置管理
1. **添加配置**：填写GitLab连接信息
   - 配置名称：易于识别的项目名称
   - GitLab地址：如 https://gitlab.com
   - 项目名称：username/project-name 格式
   - 访问令牌：具有read_api权限的GitLab令牌

2. **测试连接**：验证配置是否正确
3. **编辑配置**：修改现有配置信息
4. **删除配置**：移除不需要的项目配置

### 报告生成
1. **选择项目**：从下拉列表中选择已配置的项目
2. **设置时间范围**：
   - 使用快速选择按钮（今天、本周、本月、本季度）
   - 或手动选择开始和结束日期
3. **生成报告**：系统将自动：
   - 连接GitLab API获取提交日志
   - 分析提交数据和模式
   - 调用AI模型生成智能分析
   - 创建可视化图表和报告

### 报告查看
1. **执行摘要**：AI生成的工作总结
2. **关键指标**：提交数量、功能开发、Bug修复等
3. **数据可视化**：饼图、趋势图等直观展示
4. **详细分析**：具体的功能开发和修复内容
5. **导出功能**：支持PDF和JSON格式导出

## 🔧 自定义配置

### 修改主题色彩
在CSS中修改以下变量：
```css
:root {
    --primary-color: #4299e1;
    --secondary-color: #2b6cb0;
    --success-color: #48bb78;
    --warning-color: #ed8936;
    --error-color: #f56565;
}
```

### 添加新功能
1. 在相应的HTML文件中添加界面元素
2. 在main.js中实现业务逻辑
3. 使用Anime.js添加动画效果
4. 通过ECharts.js实现数据可视化

## 📱 响应式设计

应用完全响应式，支持：
- **桌面端**：三栏布局，充分利用屏幕空间
- **平板端**：两栏自适应布局，优化触摸操作
- **移动端**：垂直堆叠布局，单手操作友好

## 🔒 安全考虑

1. **本地存储**：敏感信息仅存储在本地浏览器
2. **HTTPS支持**：建议在HTTPS环境下使用
3. **访问令牌**：使用最小权限原则
4. **数据保护**：不收集或传输用户敏感信息

## 🎯 最佳实践

1. **定期更新令牌**：建议定期更换GitLab访问令牌
2. **合理设置时间范围**：避免一次性分析过长时间段
3. **及时保存报告**：重要报告建议导出保存
4. **团队协作**：可以分享报告链接给团队成员

## 🐛 故障排除

### 常见问题
1. **连接失败**：检查网络连接和GitLab配置
2. **报告生成慢**：尝试缩小时间范围或减少项目数量
3. **界面显示异常**：清除浏览器缓存后重试
4. **数据不准确**：确认时间范围和项目配置正确

### 浏览器兼容性
- Chrome 80+
- Firefox 75+
- Safari 13+
- Edge 80+

## 📄 许可证

本项目采用 MIT 许可证。

## 🤝 贡献

欢迎提交Issue和Pull Request来改进项目！

---

**享受使用GitLab提交日志分析工具！** 🎉