# 项目结构说明

## 📁 项目根目录结构

```
test/
├── 📁 scripts/           # 脚本文件（按功能分类）
│   ├── 📁 core/         # 核心系统脚本
│   ├── 📁 data/         # 数据管理脚本
│   ├── 📁 inventory/    # 库存系统脚本
│   ├── 📁 production/   # 生产系统脚本
│   └── 📁 ui/           # 用户界面脚本
├── 📁 scenes/           # 场景文件
├── 📁 data/             # 数据文件
│   ├── 📁 config/       # 配置文件
│   ├── 📁 translations/ # 本地化文件
│   └── 📁 imports/      # 导入配置文件
├── 📁 assets/           # 资源文件
└── 📄 project.godot     # 项目配置文件
```

## 📂 详细文件分类

### 🔧 scripts/ - 脚本文件

#### 📁 core/ - 核心系统
- `GameScene.cs` - 主游戏场景控制器

#### 📁 data/ - 数据管理
- `GameData.cs` - 游戏数据管理器
- `ResourceCategoryManager.cs` - 资源分类管理器

#### 📁 inventory/ - 库存系统
- `InventoryManager.cs` - 库存管理器（单例）
- `InventoryTableManager.cs` - 库存表格UI管理器
- `InventoryCategoryManager.cs` - 库存分类管理器

#### 📁 production/ - 生产系统
- `ManualCollectionPanel.cs` - 手动采集面板
- `ResourceGrid.cs` - 资源网格组件

#### 📁 ui/ - 用户界面
- `DynamicTabManager.cs` - 动态标签页管理器（管理"合成"和"生产线"标签）
- `MainMenu.cs` - 主菜单控制器

### 📁 scenes/ - 场景文件
- `game_scene.tscn` - 主游戏场景
- `ItemPanel.tscn` - 物品面板模板
- `InventoryItem.tscn` - 库存物品模板

### 📁 data/ - 数据文件

#### 📁 config/ - 配置文件
- `items.csv` - 物品数据配置
- `resource_categories.json` - 资源分类配置
- `inventory_categories.json` - 库存分类配置

#### 📁 translations/ - 本地化文件
- `items.*.translation` - 物品数据本地化文件（Godot自动生成）

#### 📁 imports/ - 导入配置
- `*.import` - Godot资源导入配置文件

### 📁 assets/ - 资源文件
- 图片、音频、字体等游戏资源

## 🎮 游戏标签页结构

### 📋 合成标签
包含以下分类：
- **手动采集** - 可手动采集的基础资源
- **基础资源** - 原始材料
- **液体资源** - 液体类资源
- **冶炼成品** - 冶炼后的材料
- **建筑设施** - 基础建筑和设备

### 🏭 生产线标签
包含以下分类：
- **生产设备** - 高级生产设备（组装机、化工厂等）

## 🎯 设计原则

1. **功能分离**: 按照功能模块分类存放脚本
2. **数据分离**: 配置文件与自动生成文件分开存放
3. **清晰结构**: 每个文件夹都有明确的职责
4. **易于维护**: 相关功能的文件集中管理

## 📋 自动加载顺序

项目中的自动加载脚本按以下顺序加载：
1. `GameData` - 游戏基础数据
2. `ResourceCategoryManager` - 资源分类管理
3. `InventoryManager` - 库存管理
4. `InventoryCategoryManager` - 库存分类管理

## 🔄 依赖关系

- UI层依赖于数据层和库存层
- 生产系统依赖于库存系统
- 所有系统都依赖于核心数据管理器

## ⚠️ 重要维护说明

### 防止 Translation 文件自动生成

Godot 会自动将 CSV 文件识别为本地化资源并生成 `.translation` 文件。为了保持 `data/config/` 文件夹的整洁：

1. **CSV 导入设置**：确保 `data/config/items.csv.import` 使用 `importer="keep"`
2. **文件夹隔离**：使用 `.gdignore` 文件让 Godot 忽略 `translations/` 和 `imports/` 文件夹
3. **定期清理**：如果发现 config 文件夹中出现新的 `.translation` 文件，及时删除

详细说明请参考 `data/README.md` 文件。