# gitee-r

**Repository Path**: yangdan1028/gitee-r

## Basic Information

- **Project Name**: gitee-r
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 7
- **Forks**: 0
- **Created**: 2025-01-02
- **Last Updated**: 2025-09-01

## Categories & Tags

**Categories**: vcs

**Tags**: None

## README

# Gitee 年度代码统计报告

一个强大的 Gitee 代码统计工具，可以生成详细的年度代码贡献报告，包括提交频率、工作习惯、代码质量等多个维度的分析。

## 功能特点

- 📊 全面的统计维度

  - 基础统计：总提交次数、最活跃日期、日均提交等
  - 时间分析：工作时间分布、每日/每周/每月趋势
  - 代码质量：提交规模、重构频率、文件影响等
  - 工作习惯：工作日/周末提交对比、时间段分布等
  - 详细分析：提交信息、文件类型、仓库贡献等

- 🚀 强大的分析能力
  - 支持多仓库分析
  - 支持多分支统计
  - 自动去重重复提交
  - 详细的代码质量指标

## 使用方法

1. 安装依赖

```bash
npm install
```

2. 配置环境变量
   创建 `.env` 文件，添加以下配置：

```env
# Gitee API Token (必填)
GITEE_ACCESS_TOKEN=your_token_here

# 要分析的用户邮箱 (必填)
GITEE_USER_EMAIL=your_email@example.com

# 要分析的仓库配置 (必填)
GITEE_REPOS=[
  {
    "url": "https://gitee.com/username/repo1",
    "branches": ["master", "develop"]
  },
  {
    "url": "https://gitee.com/username/repo2",
    "branches": ["main"]
  }
]
```

3. 启动服务

```bash
node index.js
```

4. 访问报告
   打开浏览器访问 `http://localhost:3000`

## ⚠️ 重要提示

1. **处理时间**

   - 当配置的仓库和分支较多时，数据解析可能需要较长时间
   - 这是因为需要获取每个仓库每个分支的所有提交信息
   - 请耐心等待，不要刷新页面
   - 处理进度会在控制台显示

2. **API 限制**

   - Gitee API 有调用频率限制
   - 建议合理配置仓库和分支数量
   - 如果出现 API 限制，请等待一段时间后重试

3. **配置说明**

   - `GITEE_ACCESS_TOKEN`: 在 Gitee 个人设置中生成
   - `GITEE_USER_EMAIL`: 必须是您在 Gitee 提交代码时使用的邮箱
   - `GITEE_REPOS`: 支持配置多个仓库和多个分支

4. **最佳实践**
   - 建议首次使用时先配置 1-2 个仓库进行测试
   - 确认配置正确后再添加更多仓库
   - 可以分批次分析不同的仓库

## 统计维度说明

1. **基础统计**

   - 总提交次数
   - 最活跃的一天
   - 日均提交次数
   - 最长连续提交天数
   - 代码变更行数

2. **工作习惯分析**

   - 工作日/周末提交对比
   - 不同时间段提交分布
   - 最忙碌的工作日/月份/时段

3. **代码质量分析**

   - 提交大小分布
   - 重构比例
   - 文件修改集中度
   - 代码变更特征

4. **提交特征分析**
   - 提交信息质量
   - 提交类型分布
   - 文件类型统计
   - 热点文件分析

## 技术栈

- Node.js
- Express
- EJS 模板引擎
- Chart.js 图表库
- Gitee API V5

## 贡献

欢迎提交 Issue 和 Pull Request 来帮助改进这个项目！