# assets manager

**Repository Path**: abeir/assets-manager

## Basic Information

- **Project Name**: assets manager
- **Description**: 素材管理器
- **Primary Language**: Rust
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-19
- **Last Updated**: 2026-03-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 游戏资产管理器 (Game Assets Manager)

一个基于 Tauri v2 + Vue 3 的桌面端游戏资源管理应用，支持对图片、音频、视频、3D 模型等游戏资源进行高效的本地存储、索引和检索。

## 功能特性

- 🚀 **快速检索**: 基于 SQLite FTS5 全文搜索，毫秒级响应
- 📁 **多格式支持**: 图片 (PNG/JPG/GIF/WEBP)、音频 (MP3/WAV/OGG)、视频 (MP4/AVI/MKV)、3D 模型 (FBX/OBJ)
- 🖼️ **缩略图预览**: 自动生成 WebP 格式缩略图，LRU 缓存优化
- 🔍 **智能索引**: 文件监听自动同步，增量更新
- 🎨 **深色主题**: Naive UI 深色模式，适合游戏开发工具
- ⚡ **高性能**: 虚拟滚动支持万级数据流畅浏览

## 技术栈

### 前端
- **框架**: Vue 3.4 + Vite
- **UI 库**: Naive UI
- **状态管理**: Pinia
- **路由**: Vue Router
- **虚拟滚动**: vue-virtual-scroller
- **3D 渲染**: Three.js + Tres.js

### 后端
- **应用框架**: Tauri v2
- **数据库**: SQLite + FTS5
- **文件监听**: notify
- **图像处理**: image
- **哈希算法**: SHA256

## 环境要求

- Node.js >= 18.x
- pnpm >= 8.x
- Rust >= 1.70
- FFmpeg (可选，用于媒体处理)

## 安装步骤

### 1. 安装依赖

```bash
# 安装前端依赖
pnpm install

# Tauri 会自动安装 Rust 依赖
```

### 2. 开发模式

```bash
pnpm tauri dev
```

### 3. 生产构建

```bash
pnpm tauri build
```

构建产物位于 `src-tauri/target/release/bundle/`

## 项目结构

```
assets_manager/
├── src/                          # 前端源码
│   ├── components/               # Vue 组件
│   │   ├── common/               # 通用组件
│   │   │   ├── AssetCard.vue     # 资源卡片
│   │   │   ├── AssetGrid.vue     # 资源网格
│   │   │   └── SearchBar.vue     # 搜索栏
│   │   └── layout/               # 布局组件
│   ├── stores/                   # Pinia 状态管理
│   ├── router/                   # 路由配置
│   ├── types/                    # TypeScript 类型
│   └── views/                    # 页面视图
│
├── src-tauri/                    # Rust 后端
│   ├── src/
│   │   ├── commands/             # Tauri 命令
│   │   ├── db/                   # 数据库模块
│   │   ├── services/             # 业务服务
│   │   └── utils/                # 工具函数
│   └── resources/
│       └── schema.sql            # 数据库结构
│
└── package.json
```

## 核心功能说明

### 资源索引
- 递归扫描指定目录
- 自动识别支持的媒体格式
- 提取元数据（尺寸、时长、格式等）
- 计算 SHA256 哈希用于去重
- 生成缩略图并缓存

### 文件监听
- 使用 notify crate 实时监控
- 自动检测新增/修改/删除
- 事件去抖避免重复处理
- 增量更新索引

### 搜索功能
- FTS5 全文搜索文件名和路径
- 多条件筛选（类型、大小、日期）
- 多种排序方式
- 游标分页支持大数据集

## 开发计划

- [ ] 完善索引服务实现
- [ ] 实现缩略图生成逻辑
- [ ] 添加媒体预览组件
- [ ] 实现标签系统
- [ ] 添加导出功能
- [ ] 性能优化和测试

## 许可证

MIT License