# ResoursePath

**Repository Path**: skyllyf/resourse-path

## Basic Information

- **Project Name**: ResoursePath
- **Description**: Windows、Linux可用的重复资源查找对比清除工具
- **Primary Language**: Python
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-17
- **Last Updated**: 2026-03-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# 重复文件查找器 (Duplicate File Finder)

一个功能强大的桌面应用程序，用于查找和管理计算机上的重复文件。支持多种扫描模式、智能选择功能和安全的文件删除操作。

## 功能特点

### 🔍 多模式扫描
- **哈希模式**：使用 SHA-256 等算法精确匹配文件内容
- **名称模式**：基于文件名快速查找重复文件
- **大小模式**：按文件大小进行分组和查找
- **综合模式**：结合多种策略进行高效扫描

### 📊 智能选择
- 全选/取消全选
- 反向选择
- 按时间选择（最新/最旧文件优先保留）
- 实时统计选中文件数量和空间占用

### 🗑️ 安全删除
- **移动到回收站**：支持撤销操作
- **永久删除**：彻底移除文件
- 显示删除预估节省空间

### ⚙️ 其他特性
- 支持多线程扫描，提高效率
- 扫描进度实时显示
- 支持自定义文件类型筛选
- 防止系统休眠（可选）
- 文件扩展名显示和管理
- 支持打开文件所在文件夹
- 支持打开文件

## 目录结构

```
duplicate-file-finder/
├── core/
│   ├── file_ops.py      # 文件操作（删除、移动等）
│   ├── hasher.py        # 文件哈希计算
│   └── scanner.py       # 文件扫描核心逻辑
├── models/
│   └── duplicate_model.py  # 重复文件数据模型
├── ui/
│   └── main_window.py   # 主窗口界面
├── main.py              # 程序入口
├── requirements.txt     # 依赖列表
└── version_info.txt     # 版本信息
```

## 安装说明

### 环境要求
- Python 3.7+
- 操作系统：Windows / macOS / Linux

### 安装步骤

1. **克隆项目**
```bash
git clone https://gitee.com/skyllyf/resourse-path.git
cd resourse-path
```

2. **安装依赖**
```bash
pip install -r duplicate-file-finder/requirements.txt
```

3. **运行程序**
```bash
python duplicate-file-finder/main.py
```

## 使用指南

### 基础操作

1. **添加扫描目录**
   - 点击界面上的"添加目录"按钮
   - 选择要扫描的文件夹
   - 支持同时添加多个目录

2. **配置扫描选项**
   - 选择扫描模式（哈希/名称/大小/综合）
   - 设置最小文件大小限制
   - 筛选特定文件类型（如：jpg, png, pdf）

3. **开始扫描**
   - 点击"开始扫描"按钮
   - 扫描进度会实时显示
   - 可随时点击"停止扫描"中断

4. **查看结果**
   - 扫描完成后自动显示结果
   - 点击文件可在右侧预览
   - 双击文件可在默认程序中打开

### 管理重复文件

1. **选择文件**
   - 在树形视图中勾选要删除的文件
   - 使用工具栏按钮进行批量操作
   - 右键菜单提供更多选项

2. **删除文件**
   - 选择"移动到回收站"安全删除
   - 选择"永久删除"彻底移除
   - 删除前会显示预估节省空间

3. **打开文件位置**
   - 右键点击文件选择"打开文件夹"
   - 快速定位文件在磁盘上的位置

## 配置选项

### 扫描模式说明

| 模式 | 描述 | 适用场景 |
|------|------|----------|
| 哈希模式 | 计算完整文件哈希值，完全精确 | 需要绝对准确的重复文件识别 |
| 名称模式 | 比较文件名 | 快速查找同名文件 |
| 大小模式 | 按文件大小分组 | 按大小快速筛选大文件 |
| 综合模式 | 结合多种策略 | 平衡准确性和效率 |

### 文件哈希算法

- **SHA-256**：标准安全哈希算法
- **快速哈希**：只读取文件部分内容（可配置采样大小）

## 系统要求

### 最低配置
- CPU：双核处理器
- 内存：2GB RAM
- 硬盘：100MB 可用空间

### 推荐配置
- CPU：四核或更高
- 内存：4GB+ RAM
- SSD 存储

## 常见问题

**Q: 扫描速度慢怎么办？**
A: 尝试使用"快速哈希"模式，或增加最大工作线程数。

**Q: 误删文件如何恢复？**
A: 使用"移动到回收站"功能，可以在回收站中恢复。

**Q: 支持哪些文件系统？**
A: 支持 NTFS、FAT32、exFAT、HFS+ 等常见文件系统。

## 贡献指南

欢迎提交 Issue 和 Pull Request 改进本项目。

1. Fork 本仓库
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交改动 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 开启 Pull Request

## 许可证

本项目采用 MIT License 开源协议。

## 更新日志

查看 [version_info.txt](duplicate-file-finder/version_info.txt) 了解版本历史。

## 联系方式

- 项目主页：https://gitee.com/skyllyf/resourse-path
- 问题反馈：https://gitee.com/skyllyf/resourse-path/issues

---

**注意**：在使用删除功能前，请确保已备份重要文件。虽然"移动到回收站"功能可以恢复文件，但"永久删除"操作无法撤销。