一个高性能的 Wwise 项目文件清理工具,集成现代图形界面。
Wwise File Cleaner 是一个专为音频工程师和游戏开发者设计的桌面应用程序,能够快速识别并清理 Wwise 项目中未使用的音频文件,有效释放磁盘空间并优化项目结构。
核心特色:使用 Rust 开发的高性能文件分析引擎,通过 PyO3 和 Maturin 工具链提供 Python 接口,结合 Flet 现代化图形界面,实现快速、安全的文件清理体验。
- 🚀 高性能扫描:基于 Rust 的核心引擎,快速分析大型 Wwise 项目
- 🔍 智能识别:精确识别项目中未被引用的音频文件
- 📁 便捷选择:支持图形界面选择或手动输入项目路径
- 📊 清晰展示:表格形式展示所有检测到的未使用文件
- ✅ 批量操作:支持复选框批量选择要删除的文件
- 🛡️ 安全保护:删除前弹出确认对话框,防止误操作
- 📈 状态反馈:显示扫描结果统计和删除操作结果
- 🎨 现代界面:基于 Flet 的响应式现代化用户界面
- 📜 滚动支持:大量文件时支持表格滚动浏览
- 在顶部输入框中直接输入 Wwise 项目文件夹路径
- 或点击"浏览"按钮通过文件对话框选择项目文件夹
- 点击"查找未使用文件"按钮开始分析
- 按钮会显示"正在查找..."状态,防止重复点击
- Rust 引擎将快速扫描项目结构和引用关系
- 扫描完成后状态栏显示结果统计,文件表格显示具体文件列表
- 浏览检测结果,查看所有未使用的音频文件
- 使用复选框选择需要删除的文件(支持单选和批量选择)
- 通过滚动条浏览大量文件列表
- 点击"删除选中文件"按钮
- 系统将显示详细的确认对话框,包含文件数量信息
- 确认后执行删除,并显示操作结果统计
┌─────────────────┐ ┌──────────────────┐ ┌─────────────────┐
│ Flet UI Layer │ │ Python Binding │ │ Rust Core │
│ (用户界面) │ -> │ (PyO3 绑定) │ -> │ (文件分析引擎) │
└─────────────────┘ └──────────────────┘ └─────────────────┘
- Rust 核心引擎 (
wclean_core):高性能文件分析和引用关系解析 - PyO3 绑定层 (
wclean_ui):Rust 功能的 Python 接口 - Flet 用户界面:现代化的桌面应用程序界面
- Maturin 构建:自动化的 Rust-Python 绑定构建流程
- 核心引擎:Rust - 高性能文件系统操作和文本解析
- Python 绑定:PyO3 - Rust 到 Python 的无缝集成
- 构建工具:Maturin - 自动化 Python 扩展模块构建
- UI 框架:Flet - 基于 Flutter 的跨平台 Python GUI
- 文件操作:标准库
os模块辅助文件系统操作
使用 Rust 的零成本抽象和内存安全特性,实现高效的文件系统遍历和文本解析,处理大型项目时性能显著优于纯 Python 实现。
通过 PyO3 提供的 Python 原生接口,Rust 核心功能可以像普通 Python 模块一样使用,无需额外的 FFI 配置。
基于 Flet 框架的响应式界面设计,提供流畅的交互体验和清晰的视觉反馈。
- 数据安全:删除操作不可逆转,建议在使用前备份重要项目文件
- 路径有效性:确保输入的是有效的 Wwise 项目根目录路径
- 文件权限:程序需要相应的文件系统读写权限
- 资源占用:避免删除正在被其他程序使用的文件
wclean-ui/
├── src/
│ ├── lib.rs # Rust 库入口
│ └── parser.rs # 文件解析逻辑
├── main.py # Python 主程序
├── Cargo.toml # Rust 项目配置
├── pyproject.toml # Python 项目配置
└── README.md # 项目文档
确保已构建 Rust 扩展模块后,直接运行:
flet main.py或
python main.py使用声明:本工具旨在提高 Wwise 项目管理效率,用户应谨慎操作,自行承担文件删除风险。