Skip to content

一个高性能的 Wwise 项目文件清理工具,集成现代图形界面。

Notifications You must be signed in to change notification settings

xmimu/WwiseFileCleaner

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Wwise File Cleaner

一个高性能的 Wwise 项目文件清理工具,集成现代图形界面。

📖 简介

Wwise File Cleaner 是一个专为音频工程师和游戏开发者设计的桌面应用程序,能够快速识别并清理 Wwise 项目中未使用的音频文件,有效释放磁盘空间并优化项目结构。

核心特色:使用 Rust 开发的高性能文件分析引擎,通过 PyO3 和 Maturin 工具链提供 Python 接口,结合 Flet 现代化图形界面,实现快速、安全的文件清理体验。

✨ 功能特性

  • 🚀 高性能扫描:基于 Rust 的核心引擎,快速分析大型 Wwise 项目
  • 🔍 智能识别:精确识别项目中未被引用的音频文件
  • 📁 便捷选择:支持图形界面选择或手动输入项目路径
  • 📊 清晰展示:表格形式展示所有检测到的未使用文件
  • 批量操作:支持复选框批量选择要删除的文件
  • 🛡️ 安全保护:删除前弹出确认对话框,防止误操作
  • 📈 状态反馈:显示扫描结果统计和删除操作结果
  • 🎨 现代界面:基于 Flet 的响应式现代化用户界面
  • 📜 滚动支持:大量文件时支持表格滚动浏览

🎯 使用方法

1. 选择 Wwise 项目

  • 在顶部输入框中直接输入 Wwise 项目文件夹路径
  • 或点击"浏览"按钮通过文件对话框选择项目文件夹

2. 扫描未使用文件

  • 点击"查找未使用文件"按钮开始分析
  • 按钮会显示"正在查找..."状态,防止重复点击
  • Rust 引擎将快速扫描项目结构和引用关系
  • 扫描完成后状态栏显示结果统计,文件表格显示具体文件列表

3. 选择待删除文件

  • 浏览检测结果,查看所有未使用的音频文件
  • 使用复选框选择需要删除的文件(支持单选和批量选择)
  • 通过滚动条浏览大量文件列表

4. 执行安全删除

  • 点击"删除选中文件"按钮
  • 系统将显示详细的确认对话框,包含文件数量信息
  • 确认后执行删除,并显示操作结果统计

🏗️ 技术架构

┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│  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 框架的响应式界面设计,提供流畅的交互体验和清晰的视觉反馈。

⚠️ 使用提醒

  1. 数据安全:删除操作不可逆转,建议在使用前备份重要项目文件
  2. 路径有效性:确保输入的是有效的 Wwise 项目根目录路径
  3. 文件权限:程序需要相应的文件系统读写权限
  4. 资源占用:避免删除正在被其他程序使用的文件

📊 项目结构

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 项目管理效率,用户应谨慎操作,自行承担文件删除风险。

About

一个高性能的 Wwise 项目文件清理工具,集成现代图形界面。

Resources

Stars

Watchers

Forks

Packages

No packages published