# qdiff

**Repository Path**: harry_bao/qdiff

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-23
- **Last Updated**: 2026-03-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# QDiff - 文件夹比较工具

QDiff 是一款基于 Python 的图形化文件夹比较工具，帮助用户快速比较两个目录之间的差异。

## 功能特性

- **文件夹比较**：比较两个目录下的所有文件和子目录
- **多种比较方式**：基于文件内容哈希或修改时间进行比较
- **结果过滤**：支持按文件名模式过滤结果
- **右键菜单**：便捷的文件操作菜单
- **进度显示**：实时显示比较进度
- **日志记录**：记录比较过程中的详细信息

## 安装依赖

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

## 使用方法

1. 运行程序：
   ```bash
   python app.py
   ```

2. 在界面中选择两个要比较的文件夹（左目录和右目录）

3. 可选：设置过滤模式（支持正则表达式）来筛选结果

4. 点击"开始比较"按钮

5. 在结果列表中查看差异，可以：
   - 双击目录查看其下的差异文件
   - 右键点击文件打开所在位置
   - 复制文件路径到剪贴板

## 主要类说明

### FileComparator
核心比较类，负责文件夹的比较逻辑：
- `compare_folders(path_left, path_right)` - 比较两个文件夹
- `_scan_files(root)` - 扫描目录下的所有文件
- `_check_file_identity(p1, p2)` - 检查两个文件是否相同
- `_matches_filter(filename)` - 过滤文件

### App
基于 ttk 的 GUI 主窗口类，提供用户界面交互。

## 依赖

- Python 3.x
- ttk (Tkinter  themed widgets)
- 其他标准库模块