# Auto-Gitee

**Repository Path**: caixukun66666666/Auto-Gitee

## Basic Information

- **Project Name**: Auto-Gitee
- **Description**: 可视化UI工具，用于高效批量创建Gitee仓库，简化项目管理流程，提升团队协作效率。结合了AI大模型自动生成README文件以及仓库名称
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Gitee仓库批量管理工具

一个功能强大的Python应用程序，用于批量创建、初始化Gitee仓库并上传项目文件。提供友好的图形用户界面，支持批量操作多个项目，集成AI智能生成README功能。

## 🌟 功能特点

- ✅ **批量创建Gitee仓库** - 支持一键创建多个仓库
- ✅ **自动Git初始化** - 自动初始化本地Git仓库
- ✅ **批量文件上传** - 自动提交并推送项目文件
- ✅ **AI智能生成README** - 基于DeepSeek AI自动生成项目文档
- ✅ **README预览功能** - 应用内Markdown渲染预览
- ✅ **AI二次调整** - 根据用户需求智能调整README内容
- ✅ **现代化UI界面** - 使用ttkbootstrap构建美观的界面
- ✅ **实时进度显示** - 显示处理进度和详细日志
- ✅ **配置管理** - 支持保存和管理配置信息
- ✅ **错误处理** - 完善的错误处理和日志记录
- ✅ **项目管理** - 支持添加、删除、编辑项目列表
- ✅ **智能命名** - AI辅助生成仓库名称
- ✅ **重名检查** - 自动检查仓库名称冲突

## 📋 系统要求

- Python 3.7 或更高版本
- Windows / macOS / Linux
- 有效的Gitee账户和Access Token
- DeepSeek API Key（可选，用于AI功能）

## 🚀 快速开始

### 1. 安装依赖

```bash
pip install -r requirements.txt
```

### 2. 获取API密钥

#### Gitee Access Token
1. 登录 [gitee.com](https://gitee.com)
2. 进入 **设置** → **私人令牌**
3. 点击 **生成新令牌**
4. 选择相应权限（至少需要 `projects` 权限）
5. 复制生成的token

#### DeepSeek API Key（可选）
1. 访问 [DeepSeek官网](https://www.deepseek.com)
2. 注册并登录账户
3. 进入API管理页面
4. 创建新的API Key
5. 复制生成的API Key

### 3. 运行程序

```bash
python main.py
```

## 📖 使用说明

### 配置设置

1. **启动程序**后，首先进入"配置设置"选项卡
2. **输入Access Token** - 粘贴从Gitee获取的token
3. **测试连接** - 点击"测试连接"按钮验证token有效性
4. **配置默认设置**：
   - API URL: `https://gitee.com/api/v5` (一般不需要修改)
   - 默认分支: `master` 或 `main`
   - 仓库默认配置: 私有仓库、Issues、Wiki等选项
5. **保存配置** - 点击"保存配置"按钮

### 批量操作

1. **切换到"批量操作"选项卡**
2. **添加项目**：
   - 点击"添加项目"选择单个项目目录
   - 点击"批量添加"选择包含多个项目的父目录
3. **智能命名**：
   - 点击"🤖 批量智能名称"让AI生成仓库名称
   - 点击"⚠️ 检查重名"检查仓库名称冲突
4. **开始处理** - 点击"开始批量处理"
5. **监控进度** - 在下方查看实时日志和进度

### README生成和修改

1. **切换到"README生成和修改"选项卡**
2. **选择仓库** - 点击"📁 选择仓库"选择目标仓库
3. **生成README**：
   - 点击"🤖 AI生成README"使用AI智能生成
   - 或手动编辑README内容
4. **预览效果** - 点击"👁️ 预览效果"查看渲染结果
5. **AI调整** - 在"再次修改"板块输入需求，点击"🤖 AI二次调整"
6. **保存或更新** - 选择保存到本地或更新到仓库

### 项目管理

- **添加项目**: 支持单个添加或批量添加
- **编辑项目**: 双击项目可编辑名称和路径
- **删除项目**: 右键点击项目可删除
- **状态跟踪**: 实时显示每个项目的处理状态

## 🏗️ 项目结构

```
gitee-batch-manager/
├── main.py                    # 主程序入口
├── config.json               # 配置文件
├── demo_config.json          # 演示配置
├── requirements.txt          # Python依赖
├── README.md                # 项目说明
├── build_exe.py             # 构建脚本
├── 构建exe.bat              # Windows构建批处理
├── 启动工具.bat             # 快速启动脚本
├── core/                    # 核心功能模块
│   ├── __init__.py
│   ├── config.py            # 配置管理
│   ├── gitee_api.py         # Gitee API操作
│   ├── gitee_manager.py     # Gitee管理器
│   ├── git_operations.py    # Git操作
│   ├── git_operations_new.py # 新版Git操作
│   ├── git_operations_backup.py # Git操作备份
│   └── deepseek_ai.py       # DeepSeek AI集成
├── gui/                     # 图形界面模块
│   ├── __init__.py
│   ├── main_window.py       # 主窗口
│   ├── components.py        # 自定义组件
│   ├── progress_widget.py   # 进度组件
│   ├── repo_manager.py      # 仓库管理组件
│   └── single_project_rename.py # 单项目重命名对话框
├── utils/                   # 工具模块
│   ├── __init__.py
│   ├── logger.py            # 日志系统
│   ├── validators.py        # 输入验证
│   ├── name_translator.py   # 名称翻译器
│   └── readme_generator.py  # README生成器
├── logs/                    # 日志目录
└── temp/                    # 临时文件目录
```

## ⚙️ 配置文件说明

`config.json` 包含以下配置项：

```json
{
    "gitee": {
        "access_token": "你的Access Token",
        "base_url": "https://gitee.com/api/v5",
        "default_branch": "master"
    },
    "ai": {
        "deepseek_api_key": "你的DeepSeek API Key",
        "timeout": "120"
    },
    "readme": {
        "default_mode": "AI智能生成",
        "default_template": "详细文档",
        "default_update_mode": "api"
    },
    "batch": {
        "prefix": "项目前缀",
        "description_template": "这是一个{project_name}项目"
    },
    "app": {
        "window_title": "Gitee仓库批量管理工具",
        "window_size": "1000x900",
        "theme": "superhero"
    },
    "logging": {
        "level": "INFO",
        "format": "%(asctime)s - %(name)s - %(levelname)s - %(message)s"
    }
}
```

## 📝 日志系统

程序提供完整的日志记录功能：

- **实时日志**: 在界面中显示操作进度和结果
- **文件日志**: 详细日志保存在 `logs/` 目录下
- **日志级别**: INFO、WARNING、ERROR、DEBUG
- **日志导出**: 支持将日志导出为文件

## 🛠️ API说明

### Gitee API 操作

- `create_repository()` - 创建仓库
- `test_connection()` - 测试API连接
- `get_user_repos()` - 获取用户仓库列表
- `delete_repository()` - 删除仓库（谨慎使用）

### Git 操作

- `init_repository()` - 初始化Git仓库
- `add_remote()` - 添加远程仓库
- `add_and_commit()` - 添加并提交文件
- `push_to_remote()` - 推送到远程仓库

## 🚨 注意事项

1. **Access Token安全**: 请妥善保管你的Access Token，不要泄露给他人
2. **仓库名称**: 确保仓库名称符合Gitee命名规范
3. **网络连接**: 确保网络连接稳定，避免上传过程中断
4. **文件大小**: 注意项目文件大小，过大的文件可能上传失败
5. **权限检查**: 确保Access Token具有创建仓库的权限

## 🔧 故障排除

### 常见问题

**Q: 提示"Access Token无效"**
- 检查token是否正确复制
- 确认token未过期
- 验证token权限设置

**Q: 上传失败**
- 检查网络连接
- 确认项目目录存在且有访问权限
- 查看详细错误日志

**Q: 界面显示异常**
- 确认Python版本 >= 3.7
- 重新安装依赖包
- 检查系统兼容性

## 📄 许可证

本项目采用 MIT 许可证。详见 [LICENSE](LICENSE) 文件。

## 🤝 贡献

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

## 📞 支持

如果你在使用过程中遇到问题，可以：

1. 查看日志文件获取详细错误信息
2. 在GitHub上提交Issue
3. 查看Gitee API官方文档

---

**祝使用愉快！** 🎉


如果这个项目对你有帮助，欢迎通过以下方式支持我们：

### 💰 捐助方式

#### 微信支付
![微信支付二维码](收款码.png)