# 文件同步工具

**Repository Path**: yushunliee/file-synchronization-tool

## Basic Information

- **Project Name**: 文件同步工具
- **Description**: 同步两个文件夹的内容
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-03-26
- **Last Updated**: 2025-03-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 文件同步工具

一个简单易用的文件夹同步工具，使用Python编写，提供图形用户界面。

## 功能特点

- 直观的图形界面，方便操作
- 支持单向和双向同步
- 文件比较功能，可以在同步前查看差异
- 实时同步进度显示
- 详细的同步日志
- 支持取消正在进行的同步操作
- 支持删除目标位置中不存在于源位置的文件（可选）
- 基于文件修改时间和内容哈希值的智能同步

## 屏幕截图

![应用界面](screenshots/app_screenshot.png)

## 安装方法

### 前提条件

- Python 3.6 或更高版本
- tkinter (通常包含在Python标准库中)

### 安装步骤

1. 克隆或下载此仓库
   ```
   git clone https://github.com/yourusername/file-sync-tool.git
   cd file-sync-tool
   ```

2. 安装依赖
   ```
   pip install -r requirements.txt
   ```

## 使用方法

1. 运行程序
   ```
   python main.py
   ```

2. 选择源文件夹和目标文件夹
   - 点击"浏览..."按钮选择相应文件夹

3. 选择同步选项
   - 同步模式：双向同步或单向同步
   - 是否删除目标位置中不存在于源位置的文件

4. 操作
   - 点击"比较差异"可以查看两个文件夹的内容差异
   - 点击"开始同步"开始同步过程
   - 同步过程中可以点击"取消"终止同步

## 同步过程说明

### 双向同步
双向同步会确保源文件夹和目标文件夹内容完全一致。程序会先将源文件夹中新增或修改的文件复制到目标文件夹，然后将目标文件夹中新增或修改的文件复制到源文件夹。

### 单向同步
单向同步只会将变更从一个文件夹同步到另一个文件夹，不会反向同步。

### 文件比较
文件比较功能会分析两个文件夹的内容，并显示以下信息：
- 只在源文件夹中存在的文件
- 只在目标文件夹中存在的文件
- 两个文件夹中都存在但内容不同的文件

## 贡献

欢迎提交问题报告和改进建议！如果您想贡献代码，请提交拉取请求。

## 许可证

此项目采用 MIT 许可证 - 详情请查看 [LICENSE](LICENSE) 文件。

## 作者

[您的名字]

## 版本历史

- 1.0.0 (2025-01-01): 初始版本发布