# gitee_backup_win

**Repository Path**: web/gitee_backup_win

## Basic Information

- **Project Name**: gitee_backup_win
- **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-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: backup

## README

# Git自动备份工具

一款用于Windows系统的Git自动备份工具，支持将指定目录备份到Git仓库，支持增量备份、计划任务和多种Git平台。

## 功能特点

1. **多任务支持** - 可以添加多个备份任务，每个任务将不同目录备份到不同的Git仓库
2. **计划任务** - 支持设置定时备份，默认手动备份
3. **多平台兼容** - 兼容Gitee、GitCode、GitHub等Git平台
4. **增量备份** - 只备份新增和修改的文件，提高备份效率
5. **断点续传** - 如果备份中断，下次可以从断点继续备份
6. **备份日志** - 详细的备份日志记录，方便查看备份历史和故障排查
7. **进度显示** - 实时显示备份进度
8. **冲突处理** - 以本地文件为准，自动处理备份冲突
9. **大文件支持** - 支持大文件分片上传，避免网络中断导致备份失败
10. **时间控制** - 可设置备份时间，避免备份高峰期

## 系统要求

- Windows 7/8/10/11
- Python 3.7+ （如需从源码运行）
- Git 2.0+ （用于Git操作）

## 安装与使用

### 便携版使用

1. 下载最新的便携版压缩包
2. 解压到任意目录
3. 运行 `start.bat` 或直接双击 `GitBackupTool.exe`
4. 首次运行时会自动创建配置目录和日志目录

### 从源码运行

1. 克隆或下载本仓库
2. 安装依赖：`pip install -r requirements.txt`
3. 运行主程序：`python main.py`

## 使用说明

### 添加备份任务

1. 打开程序，切换到"添加任务"标签页
2. 填写任务基本信息：
   - 任务名称：用于标识备份任务
   - 源目录：要备份的本地目录路径
   - 仓库地址：Git仓库的URL（支持HTTPS和SSH）
   - 分支：要推送到的分支（默认为main）
3. 配置Git用户信息：
   - 用户名：Git提交时使用的用户名
   - 邮箱：Git提交时使用的邮箱
4. 设置计划任务（可选）：
   - 勾选"启用计划任务"
   - 设置执行时间（格式：HH:MM，如03:00）
5. 配置高级选项（可选）：
   - 增量备份：只备份更改的文件
   - 断点续传：支持从断点继续备份
   - 大文件分片：对大文件进行分片处理
6. 设置排除模式（可选）：
   - 在文本框中输入要排除的文件或目录模式
   - 每行一个模式，支持通配符（如*.tmp）
7. 点击"添加任务"按钮

### 管理备份任务

1. 切换到"任务管理"标签页
2. 任务列表显示所有已添加的备份任务
3. 选中任务后可以：
   - 运行任务：立即执行备份
   - 停止任务：停止正在运行的任务
   - 删除任务：永久删除备份任务
4. 任务详情区域显示选中任务的详细信息

### 查看备份日志

1. 切换到"备份日志"标签页
2. 从下拉列表中选择要查看的任务
3. 点击"查看日志"按钮显示备份日志
4. 点击"清空日志"按钮清空当前显示的日志

### 全局设置

1. 切换到"设置"标签页
2. 配置全局设置：
   - 默认Git用户名和邮箱
   - 最大并发备份任务数
   - 备份超时时间
3. 点击"保存设置"按钮保存更改

## 注意事项

1. **Git配置**：请确保系统已安装Git并配置好SSH密钥或HTTPS认证
2. **网络稳定**：备份大文件时请确保网络连接稳定
3. **磁盘空间**：请确保有足够的磁盘空间存放临时文件
4. **权限问题**：请确保程序有权限访问源目录和创建临时目录
5. **日志管理**：建议定期清理日志文件以节省磁盘空间

## 常见问题

### Q: 备份失败，提示"认证失败"
A: 请检查Git仓库的URL是否正确，并确保已配置好SSH密钥或HTTPS认证信息。

### Q: 备份速度很慢
A: 检查网络连接是否稳定，考虑启用"增量备份"选项以减少传输量。

### Q: 某些文件没有被备份
A: 检查排除模式设置，确保没有误排除需要备份的文件。

### Q: 如何备份到GitHub私有仓库
A: 在仓库地址中使用HTTPS URL，并确保已配置GitHub访问令牌或SSH密钥。

## 开发说明

### 项目结构

```
git_backup_windows/
├── main.py                # 主程序入口
├── requirements.txt       # 依赖包列表
├── build.py              # 构建脚本
├── README.md             # 说明文档
├── core/                 # 核心功能模块
│   ├── __init__.py
│   └── backup_manager.py # 备份管理器
├── ui/                   # 用户界面模块
│   ├── __init__.py
│   └── main_window.py    # 主窗口
├── utils/                # 工具模块
│   ├── __init__.py
│   └── file_utils.py     # 文件工具
├── config/               # 配置模块
│   ├── __init__.py
│   └── settings.py       # 设置管理
├── assets/               # 资源文件
├── temp/                 # 临时文件
└── logs/                 # 日志文件
```

### 构建可执行文件

1. 安装PyInstaller：`pip install pyinstaller`
2. 运行构建脚本：`python build.py`
3. 构建完成后，可执行文件位于 `dist/GitBackupTool.exe`
4. 便携版压缩包为 `GitBackupTool_Portable.zip`

## 许可证

本项目采用 MIT 许可证，详情请参阅 LICENSE 文件。

## 贡献

欢迎提交Issue和Pull Request来帮助改进项目。