{"id":28571000,"url":"https://github.com/cnmenghan/uztools.largecleaning","last_synced_at":"2025-06-10T18:15:00.996Z","repository":{"id":295755236,"uuid":"991133261","full_name":"CNMengHan/uzTools.LargeCleaning","owner":"CNMengHan","description":"Find large files on your computer","archived":false,"fork":false,"pushed_at":"2025-05-27T07:20:51.000Z","size":80,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-05-27T08:29:30.062Z","etag":null,"topics":["cleaner","cleanup","cleanup-tool","cpp","cpp17","file-management","file-manager","filesystem","mit-license","uuz","visual-studio"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/CNMengHan.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-05-27T07:11:05.000Z","updated_at":"2025-05-27T07:28:05.000Z","dependencies_parsed_at":"2025-05-27T08:30:14.834Z","dependency_job_id":"442eb509-5bb2-4716-8cf5-5c5bc2b89c05","html_url":"https://github.com/CNMengHan/uzTools.LargeCleaning","commit_stats":null,"previous_names":["cnmenghan/uztools.largecleaning"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CNMengHan%2FuzTools.LargeCleaning","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CNMengHan%2FuzTools.LargeCleaning/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CNMengHan%2FuzTools.LargeCleaning/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CNMengHan%2FuzTools.LargeCleaning/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CNMengHan","download_url":"https://codeload.github.com/CNMengHan/uzTools.LargeCleaning/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CNMengHan%2FuzTools.LargeCleaning/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259123990,"owners_count":22808879,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cleaner","cleanup","cleanup-tool","cpp","cpp17","file-management","file-manager","filesystem","mit-license","uuz","visual-studio"],"created_at":"2025-06-10T18:14:58.929Z","updated_at":"2025-06-10T18:15:00.989Z","avatar_url":"https://github.com/CNMengHan.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Windows Large File Management Tool\n\nA simple and efficient Windows desktop application built with C++ Win32 API, designed to help users identify and manage large files (1GB and above) on their local fixed drives. It leverages the C++17 `std::filesystem` library for efficient file scanning and `std::async` for background operations, ensuring a responsive user interface.\n\n### ✨ Features\n\n*   **Comprehensive Scanning:** Scans all fixed drives for files larger than 1GB.\n*   **User-Friendly List View:** Displays scan results in a sortable ListView (by file size and absolute path).\n*   **Real-time Progress:** Shows scanning progress directly in the window title.\n*   **Flexible Deletion:**\n    *   Delete selected files to Recycle Bin (undoable).\n    *   Force delete selected files (irreversible).\n*   **Easy Navigation:** Open the location of selected files in Windows Explorer.\n*   **System Directory Exclusion:** Automatically skips system directories (e.g., `C:\\Windows`, `Program Files`, `Recycle Bin`, `System Volume Information`) to enhance performance and prevent accidental critical file operations.\n*   **Responsive UI:** Background scanning thread prevents UI freezing.\n\n### 🚀 Getting Started\n\n#### Installation\n\n1.  **Download:** Go to the [Releases](https://github.com/CNMengHan/uzTools.LargeCleaning/releases) page and download the latest `FindALLbigFileToListProj.zip` (or `.exe` if provided directly).\n2.  **Extract \u0026 Run:** Extract the contents of the zip file. You can then simply run `FindALLbigFileToListProj.exe`.\n\n#### Usage\n\n1.  **Start Scan:** Click the \"开始扫描\" (Start Scan) button. The application will begin scanning all fixed drives for files larger than 1GB. The window title will update with the scanning progress.\n2.  **View Results:** Files found will be listed in the main window.\n3.  **Sort:** Click on the \"文件大小 (GB)\" (File Size (GB)) or \"文件绝对路径\" (File Absolute Path) column headers to sort the results. Clicking again will reverse the sort order.\n4.  **Manage Files (Right-Click Menu):**\n    *   **删除文件 (到回收站)** (Delete File (to Recycle Bin)): Moves the selected file to the Recycle Bin.\n    *   **强制删除** (Force Delete): Permanently deletes the selected file, bypassing the Recycle Bin. *Use with caution!*\n    *   **在资源管理器中打开** (Open in Explorer): Opens the directory containing the selected file in Windows Explorer, with the file highlighted.\n\n### 💻 Development Setup\n\nTo build this project from source, you will need:\n\n*   **Visual Studio:** Visual Studio 2022 (or a compatible newer version) is recommended.\n*   **Workload:** Ensure the \"Desktop development with C++\" workload is installed with Visual Studio.\n\n**Steps:**\n\n1.  **Clone the repository:**\n    ```bash\n    git clone https://github.com/CNMengHan/uzTools.LargeCleaning.git\n    cd uzTools.LargeCleaning/FindALLbigFileToListProj\n    ```\n2.  **Open Solution:** Open the `FindALLbigFileToListProj.sln` file with Visual Studio.\n3.  **Build:** Build the solution (e.g., F7 or Build -\u003e Build Solution). The executable will be generated in the `x64/Debug` or `x64/Release` directory, depending on your build configuration.\n\n### 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n---\n\n## 中文 | 🇨🇳\n\n一个简单高效的 Windows 桌面应用程序，使用 C++ Win32 API 构建，旨在帮助用户识别和管理本地固定驱动器上大于 1GB 的大型文件。它利用 C++17 的 `std::filesystem` 库进行高效的文件扫描，并使用 `std::async` 进行后台操作，以确保用户界面的响应性。\n\n### ✨ 功能特性\n\n*   **全面扫描：** 扫描所有固定驱动器上大于 1GB 的文件。\n*   **友好的列表视图：** 在可排序的列表视图 (ListView) 中显示扫描结果（支持按文件大小和绝对路径排序）。\n*   **实时进度显示：** 在窗口标题中实时显示扫描进度。\n*   **灵活删除：**\n    *   将选定的文件删除到回收站（可撤销）。\n    *   强制删除选定的文件（此操作不可逆，请谨慎使用！）。\n*   **轻松导航：** 在 Windows 资源管理器中打开选定文件所在的目录。\n*   **系统目录排除：** 自动跳过系统目录（例如 `C:\\Windows`、`Program Files`、`Recycle Bin`、`System Volume Information`），以提高扫描性能并防止误操作关键系统文件。\n*   **响应式界面：** 后台扫描线程确保 UI 不会冻结。\n\n### 🚀 快速开始\n\n#### 安装\n\n1.  **下载：** 访问 [Releases](https://github.com/CNMengHan/uzTools.LargeCleaning/releases) 页面，下载最新的 `FindALLbigFileToListProj.zip` (或直接提供的 `.exe` 文件)。\n2.  **解压运行：** 解压 zip 文件内容。然后直接运行 `FindALLbigFileToListProj.exe` 即可。\n\n#### 使用方法\n\n1.  **开始扫描：** 点击 \"开始扫描\" 按钮。应用程序将开始扫描所有固定驱动器上大于 1GB 的文件。窗口标题将实时更新扫描进度。\n2.  **查看结果：** 找到的文件将显示在主窗口的列表中。\n3.  **排序：** 点击 \"文件大小 (GB)\" 或 \"文件绝对路径\" 列头可以对结果进行排序。再次点击将反转排序顺序。\n4.  **文件管理（右键菜单）：**\n    *   **删除文件 (到回收站)：** 将选定的文件移动到回收站。\n    *   **强制删除：** 永久删除选定的文件，绕过回收站。*请务必谨慎操作！*\n    *   **在资源管理器中打开：** 在 Windows 资源管理器中打开选定文件所在的目录，并突出显示该文件。\n\n### 💻 开发环境设置\n\n要从源代码构建此项目，您需要：\n\n*   **Visual Studio：** 建议使用 Visual Studio 2022 (或兼容的更新版本)。\n*   **工作负载：** 确保 Visual Studio 已安装 \"使用 C++ 的桌面开发\" 工作负载。\n\n**步骤：**\n\n1.  **克隆仓库：**\n    ```bash\n    git clone https://github.com/CNMengHan/uzTools.LargeCleaning.git\n    cd uzTools.LargeCleaning/FindALLbigFileToListProj\n    ```\n2.  **打开解决方案：** 使用 Visual Studio 打开 `FindALLbigFileToListProj.sln` 解决方案文件。\n3.  **构建：** 构建解决方案 (例如，按 F7 或选择 \"生成\" -\u003e \"生成解决方案\")。可执行文件将生成在 `x64/Debug` 或 `x64/Release` 目录中，具体取决于您的构建配置。\n\n### 📄 许可证\n\n本项目采用 MIT 许可证开源 - 详情请参阅 [LICENSE](LICENSE) 文件。\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcnmenghan%2Fuztools.largecleaning","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcnmenghan%2Fuztools.largecleaning","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcnmenghan%2Fuztools.largecleaning/lists"}