# 资源检查

**Repository Path**: luckyface/resource-check

## Basic Information

- **Project Name**: 资源检查
- **Description**: No description available
- **Primary Language**: JavaScript
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-02-10
- **Last Updated**: 2025-03-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Directory Analyzer

一个用于分析目录结构的桌面应用程序，专门用于检测包含图片但缺少对应 atlas 文件的目录，以及分析 prefab 文件中的特定资源引用。

## 功能特点

- 📁 可视化目录树结构
- 🔍 自动检测图片文件（.png, .jpg, .jpeg, .gif）
- 📊 自动检测 .atlas 文件
- ⚠️ 高亮显示包含图片但缺少 atlas 文件的目录
- 🚀 快速打开目标文件夹
- 📦 检查 .pac 和 .plist 文件组合
- 🎮 扫描 prefab 文件中的粒子系统资源引用

## 技术栈

- Electron
- React
- TypeScript
- Material-UI
- Vite

## 开发环境要求

- Node.js >= 14.0.0
- npm >= 6.0.0

## 安装

```bash

# 安装依赖
pnpm install
```

## 运行

### 开发模式

```bash
npm run electron:dev
```

### 构建应用

```bash
npm run electron:build
```

## 使用说明

1. 点击"选择文件夹"按钮选择要分析的目录
2. 程序会自动扫描目录结构并显示目录树
3. 带有警告图标(⚠️)的目录表示该目录下有图片文件但缺少 atlas 文件
4. 点击目录旁边的启动图标可以在系统文件管理器中打开该目录
5. 使用展开/折叠箭头来浏览目录结构
6. 点击"检查文件组合"按钮可以检查同时包含 .pac 和 .plist 的目录
7. 点击"扫描Prefab"按钮可以分析 prefab 文件中的粒子系统资源引用

### Prefab 扫描功能

扫描 prefab 文件中的特定资源引用，具体功能包括：

- 扫描目录中所有的 .prefab 文件
- 检测包含 cc.ParticleSystemEx 组件的 prefab
- 提取符合条件的 spriteFrame UUID
- 生成详细的扫描报告（JSON格式）
- 结果保存在 `electron/output/particle-system-scan-result.json`

## 项目结构

```
directory-analyzer/
├── electron/
│   ├── main.js          # Electron 主进程
│   ├── prefab-scanner.js # Prefab 文件扫描模块
│   └── output/          # 扫描结果输出目录
├── src/
│   ├── App.tsx          # 主应用组件
│   └── main.tsx         # 应用入口
├── index.html           # HTML 模板
└── package.json         # 项目配置文件
```

## 开发说明

- `electron/main.js` - 包含 Electron 主进程代码，处理文件系统操作
- `electron/prefab-scanner.js` - 处理 prefab 文件的扫描和分析
- `src/App.tsx` - React 主组件，实现目录树显示和用户交互
- `src/main.tsx` - React 应用入口，配置主题和渲染根组件

## 输出文件

### particle-system-scan-result.json

扫描结果将保存为 JSON 文件，包含以下信息：
```json
{
  "scanTime": "扫描时间",
  "basePath": "扫描的根目录路径",
  "files": [
    {
      "path": "prefab文件相对路径",
      "spriteFrameUuids": ["uuid1", "uuid2", ...]
    }
  ]
}
```

## 注意事项

- 确保有足够的权限访问要分析的目录
- 大型目录的扫描可能需要一些时间
- 目前支持的图片格式：.png, .jpg, .jpeg, .gif
- atlas 文件必须使用 .atlas 扩展名
- prefab 扫描结果会保存在 electron/output 目录下
- 每次扫描都会覆盖之前的结果文件

## 错误处理

- 如果扫描过程中出现错误，会在界面底部显示错误提示
- 详细的错误日志可以在开发者工具的控制台中查看
- 文件访问权限不足时会提示相应的错误信息