# 虚幻引擎缓存清理工具 **Repository Path**: hoshinokennji/UnrealEngineCacheCtrl ## Basic Information - **Project Name**: 虚幻引擎缓存清理工具 - **Description**: 虚幻引擎缓存清理工具 - **Primary Language**: C# - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 1 - **Forks**: 0 - **Created**: 2022-07-22 - **Last Updated**: 2025-08-08 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 虚幻引擎缓存清理工具 [![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE) [![.NET Framework](https://img.shields.io/badge/.NET%20Framework-4.6-orange.svg)](https://dotnet.microsoft.com/download/dotnet-framework/net46) [![Platform](https://img.shields.io/badge/platform-Windows-lightgrey.svg)](https://www.microsoft.com/windows) [![Version](https://img.shields.io/badge/version-1.1.2-green.svg)](https://gitee.com/hoshinokennji/UnrealEngineCacheCtrl/releases) 一个专为虚幻引擎项目设计的智能缓存清理工具，帮助开发者快速清理项目中的各种缓存文件、编译文件和临时文件，释放磁盘空间并保持项目目录整洁。支持多种清理模式，从基础清理到深度清理，满足不同开发场景的需求。 ## ✨ 主要特性 - 🎯 **智能项目检测** - 自动识别虚幻引擎项目并验证项目文件有效性 - 🌍 **多语言支持** - 支持简体中文、繁体中文、英语、日语、韩语界面 - 🛡️ **安全保护机制** - Content文件夹保护、Manifest文件保护，避免误删重要文件 - 📊 **详细统计信息** - 显示将要删除的文件数量、目录数量和总大小 - 🔧 **多种清理模式** - 从基础清理到深度清理，满足不同需求 - 💻 **命令行支持** - 支持交互式菜单和命令行参数两种使用方式 - ⚡ **高性能扫描** - 快速扫描大型项目目录结构 - 🚀 **智能性能优化** - 自动内存管理和系统资源优化 - 📊 **实时性能监控** - 内存使用监控和并发操作管理 - 🔧 **完整部署支持** - 集成测试验证和部署包准备 ## 🚀 快速开始 ### 系统要求 - Windows 操作系统 - .NET Framework 4.6 或更高版本 - 虚幻引擎项目目录 ### 安装方法 1. 从 [Releases](https://gitee.com/hoshinokennji/UnrealEngineCacheCtrl/releases) 页面下载最新版本 2. 解压到任意目录 3. 将可执行文件路径添加到系统环境变量（可选） ### 基本使用 #### 交互式模式 ```bash # 在虚幻引擎项目根目录下运行 UnrealEngineCacheCtrl.exe ``` #### 命令行模式 ```bash # 清理自动保存文件 UnrealEngineCacheCtrl.exe autosave # 清理编译文件 UnrealEngineCacheCtrl.exe binary # 超强缓存清理 UnrealEngineCacheCtrl.exe all # 清理SCM垃圾文件 UnrealEngineCacheCtrl.exe scm # 无差别删除（危险操作） UnrealEngineCacheCtrl.exe full ``` ## 💡 使用示例 ### 基本清理操作 ```bash # 日常清理 - 清理自动保存文件 UnrealEngineCacheCtrl.exe autosave # 编译清理 - 清理编译产生的文件 UnrealEngineCacheCtrl.exe binary # 深度清理 - 包含引擎缓存 UnrealEngineCacheCtrl.exe all ``` ### 高级功能使用 ```bash # 性能监控模式 - 显示详细性能信息 UnrealEngineCacheCtrl.exe --performance-monitor # 诊断模式 - 分析删除失败原因 UnrealEngineCacheCtrl.exe --diagnose-directory "C:\MyProject\Binaries" # 部署准备 - 完整的部署验证流程 UnrealEngineCacheCtrl.exe --prepare-deployment ``` ### 交互式高级选项 在交互模式下，工具会自动： - 监控内存使用情况并提供优化建议 - 根据系统负载调整并发操作数量 - 显示实时性能统计信息 - 在高内存压力时自动执行垃圾回收 ## 📋 清理模式详解 ### 🗂️ 自动保存清理 (autosave) 清理项目的自动保存文件，释放不必要的磁盘空间。 - 删除 `Saved` 目录及其所有内容 - 保护 Content 文件夹不被扫描 - 适合日常清理使用 ### ⚙️ 编译数据清理 (binary) 清理编译产生的二进制文件和中间文件。 - 删除 `Binaries`、`Intermediate`、`Build` 等目录 - 清理 IDE 缓存目录（`.vs`、`.vscode`、`.idea`） - 保留 `ThirdParty` 目录 - 保护包含 Manifest 文件的目录 ### 🔥 超强缓存清理 (all) 执行深度清理，包括本地引擎缓存。 - 清理项目本地所有缓存文件 - 清理引擎相关的本地缓存 - 解析项目文件获取引擎关联信息 - 清理本地应用数据目录中的引擎缓存 ### 📁 SCM垃圾文件清理 (scm) 清理版本控制系统产生的垃圾文件。 - 递归扫描项目目录查找 SCM 相关临时文件 - 清理 Plastic SCM 产生的异常垃圾文件 - **唯一允许扫描 Content 文件夹的模式** ### ⚠️ 无差别删除 (full) 执行最彻底的清理，忽略所有保护规则。 - **危险操作**：会显示警告信息并要求明确确认 - 删除所有缓存目录，不保留任何文件 - 忽略 Manifest 文件保护机制 - 仅建议高级用户在特殊情况下使用 ## 🛡️ 安全保护机制 ### Content文件夹保护 - **保护范围**：除 SCM 模式外的所有清理模式都会跳过 Content 文件夹 - **保护原因**：Content 文件夹包含项目的核心资源文件（模型、贴图、音频等） - **例外情况**：SCM 模式下会正常扫描 Content 文件夹中的版本控制垃圾文件 ### Manifest文件保护 - **保护机制**：包含 "Manifest_" 开头 txt 文件的文件夹在非 Full 模式下被保护 - **保护原因**：这些文件包含重要的清单信息，误删可能导致项目问题 - **例外情况**：Full 模式下会忽略此保护机制 ## 🌍 多语言支持 工具支持以下语言，会根据系统区域设置自动选择： - 🇨🇳 简体中文 - 🇹🇼 繁体中文 - 🇺🇸 English - 🇯🇵 日本語 - 🇰🇷 한국어 如果系统语言不在支持列表中，将默认使用英语界面。 ## 📊 使用统计 在执行删除操作前，工具会显示详细的统计信息： ``` 扫描完成: G:\MyProject 将要删除: 15 个目录, 1,234 个文件, 总大小: 2G 456M 789K 123B 将要删除的目录: - G:\MyProject\Binaries - G:\MyProject\Intermediate - G:\MyProject\.vs ... 是否确认删除? (y/n): ``` ## ⚡ 性能特性 - **快速扫描**：优化的目录遍历算法，快速处理大型项目 - **智能内存管理**：自动内存压力监控和垃圾回收优化 - **动态并发控制**：基于系统资源自动调整并发操作数量 - **实时性能监控**：详细的性能指标收集和分析报告 - **并发安全**：支持文件被其他程序占用时的安全处理 - **错误恢复**：遇到单个文件删除失败时继续处理其他文件 - **资源优化**：进程优先级调整和系统资源智能分配 ## 🚀 高级功能 ### 智能性能优化 - **自动内存管理**：实时监控内存使用情况，自动执行垃圾回收 - **动态并发控制**：根据系统资源自动调整并发操作数量 - **性能压力监控**：分级内存压力监控（正常/中等/高/严重） - **资源优化建议**：基于当前系统状态提供优化建议 ### 部署和集成 - **完整部署流程**：从系统验证到部署包准备的完整自动化流程 - **集成测试验证**：全面的回归测试和质量保证 - **部署包管理**：自动生成包含文档、脚本的完整部署包 - **部署报告生成**：详细的部署状态和验证报告 ### 诊断和监控 - **目录删除诊断**：深度分析删除失败的具体原因 - **实时性能监控**：CPU使用率、内存使用量、磁盘I/O监控 - **操作统计报告**：详细的性能指标和操作历史记录 - **并发操作管理**：活动操作跟踪和并发度控制 ## 🔧 开发信息 ### 技术栈 - **开发语言**：C# - **框架版本**：.NET Framework 4.6 - **项目类型**：控制台应用程序 - **架构模式**：模块化设计 ### 项目结构 ``` UnrealEngineCacheCtrl/ ├── Program.cs # 主程序入口和流程控制 ├── ProgramText.cs # 多语言文本管理 ├── UnrealEngineConfig.cs # 引擎配置和检测 ├── Interfaces/ # 接口定义 │ ├── IFileSystemService.cs │ ├── IProjectService.cs │ └── IUnrealEngineService.cs ├── Models/ # 数据模型 │ ├── DeploymentResults.cs │ ├── ProjectStructureAnalysis.cs │ ├── UnrealBuildInfo.cs │ ├── UnrealEngineInstallInfo.cs │ └── UnrealProjectDescription.cs ├── Services/ # 核心服务模块 │ ├── CleanupService.cs # 清理服务 │ ├── CommandLineService.cs # 命令行处理 │ ├── FileSystemService.cs # 文件系统操作 │ ├── ProjectService.cs # 项目管理 │ ├── UnrealEngineService.cs # 引擎服务 │ ├── PerformanceMonitoringService.cs # 性能监控 │ ├── AdvancedPerformanceOptimizationService.cs # 高级性能优化 │ ├── DeploymentManager.cs # 部署管理器 │ ├── DeploymentService.cs # 部署服务 │ ├── DirectoryDeletionDiagnosticService.cs # 目录删除诊断 │ ├── ErrorHandlingService.cs # 错误处理 │ ├── LoggingService.cs # 日志服务 │ ├── ProgressDisplayService.cs # 进度显示 │ └── UserExperienceService.cs # 用户体验 ├── Utilities/ # 工具类 │ ├── ConfigUtilities.cs # 配置工具 │ └── FileUtilities.cs # 文件工具 └── Tests/ # 测试模块 ├── UnitTests/ # 单元测试 └── ManualTests/ # 手动测试 ``` ## 🤝 贡献指南 欢迎提交 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 ## 📝 更新日志 ### v1.1.2 (2025-01-27) - 🚀 **新增高级性能优化服务** - 智能内存管理和系统资源优化 - 📊 **增强性能监控系统** - 实时内存压力监控和并发控制 - 🔧 **部署管理器** - 完整的集成测试和部署准备流程 - ⚡ **智能并发控制** - 基于系统资源动态调整并发度 - 🛡️ **增强错误恢复机制** - 更强的异常处理和恢复能力 - 📈 **详细性能报告** - 全面的性能分析和优化建议 - 🧪 **扩展测试框架** - 包含性能测试、边界测试和集成测试 - 🔍 **目录删除诊断服务** - 深度分析删除失败原因 - 💾 **内存优化算法** - 自动垃圾回收和内存压力管理 - 🎯 **用户体验优化** - 更友好的进度显示和错误提示 ### v1.0.0 (2025-01-26) - ✨ 初始版本发布 - 🎯 支持5种清理模式（autosave、binary、all、scm、full） - 🌍 多语言界面支持（中文、英语、日语、韩语） - 🛡️ 完善的安全保护机制（Content文件夹保护、Manifest文件保护） - 💻 命令行参数和交互式菜单双重支持 - ⚡ 高性能文件扫描和删除算法 - 📊 详细的统计信息和进度显示 - 🔧 模块化架构设计，易于扩展和维护 - 🧪 完整的单元测试和性能测试套件 ## ⚠️ 注意事项 1. **备份重要数据**：虽然工具有保护机制，但建议在使用前备份重要项目文件 2. **确认删除操作**：删除操作不可逆，请仔细确认统计信息后再执行 3. **关闭相关程序**：清理前建议关闭虚幻引擎编辑器和 Visual Studio 等相关程序 4. **管理员权限**：某些情况下可能需要管理员权限才能删除特定文件 ## 📄 许可证 本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情。 ## 👨‍💻 作者 **星野谦二** - [hoshinokennji](https://gitee.com/hoshinokennji) ## 🙏 致谢 感谢所有为这个项目做出贡献的开发者和用户！ --- 如果这个工具对你有帮助，请给个 ⭐ Star 支持一下！