# large-file-analyzer

**Repository Path**: hd_2000/large-file-analyzer

## Basic Information

- **Project Name**: large-file-analyzer
- **Description**: Windows 磁盘大文件分析工具：中文图形界面、多线程扫描、Top N 排名、CSV 与 AI 报告导出，附可直接运行的 EXE。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-14
- **Last Updated**: 2026-10-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 磁盘大文件分析工具

面向 Windows 的只读大文件查找工具。支持中文图形界面和命令行，按文件逻辑大小生成 Top N 排名，帮助定位磁盘空间占用。

## 下载与运行

**无需安装 Python：下载 [大文件分析工具.exe](dist/大文件分析工具.exe)，双击运行。** 在 Gitee 文件页使用“下载/原始数据”下载二进制文件，不能将网页另存为 EXE。也可以下载整个仓库 ZIP，解压后双击 `run_scan.bat`。

1. 选择扫描目录（默认 `C:\`）。
2. 设置排名数量（默认 10）和最小大小（默认 100 MB，0 表示不过滤）。
3. 点击“开始分析”，完成后查看排名；双击一行可定位文件。
4. 按需导出 CSV 或 AI 分析报告。点击“停止”可保留部分结果。

运行文件位于 `dist/`，随源码一起纳入 Git。EXE 为 Windows x64 单文件程序，包含 Python/Tk 运行环境，可单独复制使用；建议 Windows 10/11 x64，其他系统未验证。

## 功能

- 多线程扫描、后台任务、停止扫描和部分结果展示。
- 路径背景比例条，以本次最大文件为 100%。
- CSV 导出（UTF-8 BOM），便于 Excel 打开。
- TXT AI 分析报告，包含路径、大小、类型、时间及分析提示词；不连接 AI 服务。
- 命令行线程数、大小阈值、系统文件过滤等选项。
- 仅读取文件元数据，不读取文件内容，不删除文件，不自动上传扫描结果。

## 文档

- [完整使用手册](docs/USAGE.md)：界面、参数、导出、结果解释和常见问题。
- [开发与打包指南](docs/DEVELOPMENT.md)：结构、环境、测试、打包、发布。
- [版本记录](CHANGELOG.md)
- [运行文件说明](dist/README.md)及 [SHA-256 校验值](dist/SHA256SUMS.txt)

## 源码启动

安装带 Tkinter 的 Python 3.9+，在项目目录执行（当前验证环境为 Python 3.13 x64）：

```powershell
python scan_gui.py
python scan_c_drive.py --path "C:\Users" --top 20 --min-mb 100
python -m unittest -v test_scan
```

运行不依赖第三方 Python 库。打包依赖见 `requirements-build.txt`。

## 项目结构

```text
large-file-analyzer/
├── scan_gui.py          # 图形界面
├── scan_c_drive.py      # 扫描引擎与命令行入口
├── ai_report.py         # AI 文本报告生成
├── run_scan.bat         # 双击启动，优先使用 dist 中的 EXE
├── build_app.bat        # 测试、打包与生成校验值
├── 大文件分析工具.spec   # PyInstaller 打包配置
├── requirements-build.txt
├── test_scan.py         # 自动化测试
├── benchmark_scan.py    # 与旧版实现对照的性能测试
├── docs/               # 使用与开发文档
└── dist/               # 可直接运行的 EXE、说明和校验值
```

`build/`、Python 缓存及根目录历史 EXE 不上传。最新版统一以 `dist/大文件分析工具.exe` 为准。

## 结果边界

排名是文件逻辑大小，不等于实际磁盘占用；硬链接按路径重复计入。无权访问的项目、链接/重解析点会跳过，默认也跳过 pagefile.sys、hiberfil.sys 和 swapfile.sys。扫描中变化的文件可能影响结果。AI 报告仅供辅助判断，不应仅凭排名删除系统或应用数据；分享报告前检查其中的完整路径。

本仓库尚未指定开源许可证；公开可见不代表授予任意使用或再分发许可。