# directory-analyzer

**Repository Path**: spider1462/directory-analyzer

## Basic Information

- **Project Name**: directory-analyzer
- **Description**: 这是一个基于Python的目录和文件大小分析工具，提供交互式GUI界面，用于分析目录结构并可视化文件和文件夹大小信息。
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-24
- **Last Updated**: 2026-02-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 目录和文件大小分析器

## 简介

这是一个基于 Python 的交互式工具，用于分析目录结构并显示文件/文件夹的大小。它支持通过 `es.exe` 工具扫描目录生成 CSV 数据，也支持手动加载 CSV 文件进行解析。程序提供图形界面，允许用户点击文件夹进入查看内容，查看文件详情，并自动计算目录的总大小。

## 功能特点

*   **交互式 GUI 界面**：使用 Tkinter 构建，提供直观的浏览体验。
*   **目录扫描**：支持调用 `es.exe` 扫描指定目录并自动生成 CSV 文件。
*   **CSV 手动加载**：支持直接打开 CSV 文件进行解析。
*   **树状导航**：双击文件夹进入子目录，双击文件查看详细信息。
*   **大小显示**：自动计算目录总大小，并格式化显示为 B、KB、MB、GB、TB。
*   **路径处理**：智能处理 Windows 驱动器路径（如 `D:\`）和 UNC 路径（如 `\\server\share`）。
*   **排序功能**：支持按名称、类型或大小进行排序。

## 依赖工具

*   **Python 3**：运行环境。
*   **es.exe**：用于扫描目录的工具。
    *   项目来源：[https://github.com/voidtools/es](https://github.com/voidtools/es)
    *   简介：The Command Line Interface for Everything.

## 使用方法

1.  **运行程序**：
    在终端或命令行中执行：
    ```bash
    python directory_analyzer.py
    ```

2.  **扫描目录**：
    在工具栏输入或选择目标目录路径，点击“🔍 扫描目录”按钮。程序会在后台运行 `es.exe` 并自动加载生成的 CSV。

3.  **手动加载 CSV**：
    点击“📂 加载CSV文件”按钮，选择已有的 CSV 文件进行解析。

4.  **浏览内容**：
    在主界面表格中，双击文件夹图标进入该目录，双击文件图标查看文件详情。使用“⬆ 返回上一级”或“🏠 返回根目录”按钮导航。

## 已知问题

*   **解析延迟**：当 CSV 文件包含大量条目时，解析过程可能会耗时较长，尤其是在目标目录包含大量小文件的情况下。

## 作者与来源

*   **代码编写**：完全由 **GLM5 Agent** 编写。
*   **es.exe 来源**：[https://github.com/voidtools/es](https://github.com/voidtools/es)