# Unity PackageSystem_基于SO的背包系统管理工具

**Repository Path**: PXY2333/unity-so-management-tool

## Basic Information

- **Project Name**: Unity PackageSystem_基于SO的背包系统管理工具
- **Description**: 用于UnitySO文件管理的小工具，以后会集成更多功能
- **Primary Language**: C#
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-05
- **Last Updated**: 2025-11-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Package System 工具使用指南

## 工具简介

Package System 是一个 Unity 编辑器扩展工具，用于高效管理和编辑项目中的各类 Package 数据。该工具提供了友好的界面，支持数据的查看、编辑、搜索、导入导出等功能，帮助开发者更便捷地管理游戏中的道具、材料、蓝图等数据。

## 安装方法

1. 将 `PackageSystem` 文件夹复制到你的 Unity 项目的 `Assets/Scripts/` 目录下
2. Unity 会自动编译编辑器脚本
3. 安装完成后，在 Unity 编辑器顶部菜单栏中选择 `Tools > Package Data Manager` 打开工具窗口

## 功能概述

### 1. 数据文件管理
- 加载和切换不同的 Package 数据文件
- 创建新的数据文件（支持 ItemsPackageSO、MaterialsPackageSO、BluePrintPackageSO 等类型）
- 删除数据文件
- 导入/导出 Xlsx 格式数据

### 2. 数据编辑
- 查看和编辑列表中的各项数据
- 添加新元素
- 删除选中元素
- 支持序列递增功能，自动为新元素生成递增的 ID

### 3. 搜索功能
- SO 文件搜索：快速查找和打开项目中的数据文件
- 属性搜索：按不同属性字段筛选列表中的数据

### 4. 精灵表导入
- 支持从精灵表批量导入精灵并自动创建数据项

### 5. 模型预览
- 支持在详情面板中预览模型对象

## 使用教程

### 打开工具

在 Unity 编辑器中，依次点击 `Tools > Package Data Manager` 打开工具窗口。

### 选择数据文件

有三种方式可以选择数据文件：

1. **常用数据**：点击顶部的「选择数据」下拉菜单，选择已添加的常用数据文件
2. **直接选择**：在「数据文件」字段中直接拖拽或选择数据文件
3. **搜索查找**：展开「搜索SO文件」面板，输入关键字搜索并选择数据文件

### 添加常用数据文件

1. 点击顶部的「设置」按钮打开设置窗口
2. 在设置窗口中，点击「添加」按钮选择要添加为常用的数据文件
3. 使用上下箭头调整常用数据的顺序
4. 点击「保存」按钮应用设置

### 编辑数据

1. 加载数据文件后，左侧列表会显示所有数据项
2. 点击列表中的任意项查看和编辑其详情
3. 在右侧详情面板中修改数据，修改会自动保存

### 添加新数据项

1. 点击左侧列表上方的「+」按钮
2. 或在列表聚焦时按下键盘上的「+」、「=」键
3. 新项会自动添加到列表末尾
4. 如果启用了「序列递增」功能，新项的 ID 会自动设置为上一项 ID + 1

### 删除数据项

1. 在列表中选择一个或多个要删除的项
2. 点击左侧列表上方的「-」按钮
3. 或在列表聚焦时按下键盘上的「-」、「Delete」键

### 使用属性搜索

1. 展开「属性搜索」面板
2. 从下拉菜单中选择要搜索的属性字段
3. 在「关键字」输入框中输入搜索关键词
4. 点击「搜索」按钮或按回车键执行搜索
5. 列表会筛选出符合条件的数据项
6. 点击「清空」按钮清除搜索条件

### 导入/导出数据

#### 导出为 Xlsx
1. 加载数据文件
2. 点击顶部的「导出Xlsx」按钮
3. 选择保存位置和文件名
4. 导出的 Xlsx 文件会包含所有字段的数据

#### 从 Xlsx 导入
1. 点击顶部的「导入Xlsx」按钮
2. 选择要导入的 Xlsx 文件
3. 系统会自动验证文件格式和数据完整性
4. 导入的数据会追加到现有数据后面

### 导入精灵表

1. 点击左侧列表上方的「导入精灵表」按钮
2. 选择包含精灵的图片文件
3. 系统会自动从精灵表中提取所有精灵并创建对应的数据项
4. 如果启用了「序列递增」功能，新项的 ID 会自动设置

## 注意事项

1. **数据保存**：编辑完成后，Unity 会自动保存数据文件的修改，但建议定期手动保存项目
2. **数据格式**：导入 Xlsx 文件时，必须包含 ID 列（不区分大小写）
3. **精灵引用**：导出的 Xlsx 文件中，精灵会保存为路径#精灵名的格式
4. **性能优化**：当处理大量数据时，可能会有一定的性能消耗，建议分批处理

## 常见问题

### Q: 为什么属性搜索不起作用？
A: 请确保：
1. 已正确选择属性字段
2. 输入了有效的搜索关键词
3. 数据中确实存在匹配的项

### Q: 导入 Xlsx 失败怎么办？
A: 检查以下几点：
1. Xlsx 文件格式是否正确
2. 是否包含必需的 ID 列
3. ID 列中是否有重复值
4. 文件是否被其他程序占用

### Q: 如何快速跳转到特定 ID 的项？
A: 使用属性搜索功能，在 ID 属性中输入目标 ID 进行搜索。

## 版本历史

### v1.0.0
- 初始版本
- 支持基本的数据管理功能
- 支持导入导出 Xlsx
- 支持属性搜索功能

### v1.1.0
- 修复属性搜索功能的 bug
- 改进常用数据管理
- 优化列表显示性能

---

如有任何问题或建议，请联系工具开发者。