> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wanyouxi.online/llms.txt
> Use this file to discover all available pages before exploring further.

# 标准资源管理工业流程

> **摘要**：本文聚焦「标准资源管理工业流程」，梳理核心概念、关键方法与落地实践。

> **目标**: 将分散的命名规范、目录结构和热更技术串联成一条完整的**工业化生产管线**。
> **核心文档引用**:
>
> * [命名规范](Asset_Naming.md)
> * [目录结构](Folder_Structure.md)
> * [热更机制](../Tech/Hot_Update_And_Resources.md)

## 1. 🗺️ 全景流程图 (The Pipeline)

```mermaid theme={"theme":{"light":"github-light","dark":"github-dark"}}
graph TD
    A[🎨 美术/策划生产] -->|命名规范| B(导入 Unity)
    B -->|目录结构| C{资源归档}
    C -->|通用资源| D[Assets/_Project/Art]
    C -->|模块资源| E[Assets/_Project/Features]
    D & E -->|AssetPostprocessor| F[自动设置 Import Settings]
    F -->|YooAsset Collector| G[资源收集与分包]
    G -->|构建| H[生成 AssetBundles]
    H -->|HybridCLR| I[注入热更 DLL]
    I -->|上传| J[CDN 分发]
```

## 2. 🏭 阶段一：生产与导入 (Production & Import)

### 2.1 命名作为第一道防线

* **规则**: 所有进入项目的资源必须符合 `[前缀]_[模块]_[名称]_[变体]`。
* **工具**: 启用 `AssetNamingValidator.cs`，任何不合规资源导入时会在 Console 报错。
* **案例**:
  * 美术提交 `goblin_red.fbx` -> **打回**。
  * 美术提交 `SK_Goblin_Red.fbx` -> **通过**。

### 2.2 物理归档 (Physical Layout)

依据 [目录结构](Folder_Structure.md) 的“混合式架构”：

* **通用库 (Shared)**: 地面贴图、通用 UI 框、音效 -> 放入 `_Project/Art/` 或 `_Project/Audio/`。
* **专用库 (Dedicated)**: 哥布林的独有动作、特效、材质 -> 放入 `_Project/Features/Enemies/Goblin/`。

### 2.3 自动化导入设置 (Auto Import Settings)

不要依赖人工手动设置 Texture Type 或 Compression。利用命名规范自动处理：

* 检测到 `T_` 开头 -> 自动设为 `Default`, 开启 Mipmap, 压缩格式 ASTC\_6x6。
* 检测到 `UI_` 开头 -> 自动设为 `Sprite`, 关闭 Mipmap, 压缩格式 ASTC\_4x4。
* 检测到 `SFX_` 开头 -> 自动设为 `DecompressOnLoad`。
* 检测到 `BGM_` 开头 -> 自动设为 `Streaming`。

## 3. 📦 阶段二：分包与构建 (Packaging)

### 3.1 YooAsset 收集策略 (Collector Strategy)

我们将目录结构直接映射到 YooAsset 的收集器规则中，实现**零配置**分包。

| 目录路径                         | 收集规则 (Collector) | 打包方式 (Addressable)         | 对应 Package       |
| :--------------------------- | :--------------- | :------------------------- | :--------------- |
| `_Project/Art/UI/Common`     | `PackDirectory`  | `PackTogether` (打成一个大包)    | `DefaultPackage` |
| `_Project/Scenes/Boot.unity` | `PackFile`       | -                          | `DefaultPackage` |
| `_Project/Features/Chapter1` | `PackDirectory`  | `PackSeparately` (每个文件单独打) | `LevelPackage`   |
| `_Project/Features/Chapter2` | `PackDirectory`  | `PackSeparately`           | `LevelPackage`   |

* **Tag 自动化**:
  * `Features/Chapter1` 下的所有资源，自动打上 `Tag = "Chapter1"`。
  * 游戏运行时，进入第一章前调用 `package.DownloadAsync("Chapter1")` 即可一键下载该目录下所有内容。

### 3.2 依赖管理 (Dependency Management)

* **原则**: `DefaultPackage` (启动包) **严禁** 引用 `LevelPackage` (关卡包) 中的资源。
* **检测**: 构建时运行依赖分析脚本，如果发现 `UI_MainMenu` (Default) 引用了 `T_BossTexture` (Level)，立即报错。

## 4. 🚀 阶段三：热更与发布 (Hot Update)

### 4.1 代码与资源的同步

* **问题**: 修改了 C# 代码 (例如增加了新怪物逻辑)，同时增加了新怪物的 Prefab。
* **同步流**:
  1. 运行 `HybridCLR/CompileDll` 生成 `Assembly-CSharp.dll`。

  2. 脚本自动将 DLL 复制到 `_Project/StreamingAssets/RawFiles/` (归属 `RawFilePackage`)。

  3. 运行 YooAsset 构建，生成资源版本 `v1.0.100`。

  4. **原子性发布**: 客户端检测到版本 `v1.0.100` 时，会同时下载新的 DLL 和新的 AssetBundle，确保逻辑与资源匹配。

### 4.2 兜底策略 (Fallback)

* **资源损坏**: YooAsset 自带 CRC 校验，下载后校验失败会自动重试。
* **代码崩溃**: 如果热更 DLL 导致启动崩溃，客户端应有“安全模式” (Safe Mode)，允许用户在启动页清除本地缓存，强制重新下载最新版本。

## 5. 🔍 案例分析：复杂 UI 面板 (Case Study)

> **场景**: 一个 "背包面板" (InventoryPanel)，包含：
>
> 1. **1 个独特的背景图**: `UI_Inventory_Bg.png` (仅此面板使用)。
> 2. **2 个通用底板**: `UI_Common_Frame.png`, `UI_Common_Button.png` (全游戏通用)。
> 3. **100 个道具图标**: `UI_Icon_Sword.png`... (全游戏通用)。

### 5.1 物理存放 (按维护性优先)

我们坚持 **"维护性 > 性能"** 的原则进行物理存放，性能问题交给构建管线解决。

* `Assets/_Project/Features/Inventory/Art/UI_Inventory_Bg.png`
  * *理由*: 这是模块独有的，删了背包模块，这个图也该消失。
* `Assets/_Project/Art/UI/Common/UI_Common_Frame.png`
  * *理由*: 这是通用的，属于核心资产。
* `Assets/_Project/Art/UI/Icons/Items/UI_Icon_Sword.png`
  * *理由*: 图标库通常极其庞大，且被多个模块（商城、背包、战斗）引用，必须独立存放。

### 5.2 图集打包 (Sprite Atlas 策略)

在构建阶段，我们通过 `SpriteAtlas` 来解决 DrawCall 问题，而不是通过移动文件。

1. **Common Atlas**: 包含 `_Project/Art/UI/Common` 下的所有小图。
   * *结果*: 背包面板加载时，常驻内存。
2. **Icon Atlas**: 包含 `_Project/Art/UI/Icons` 下的所有图标。

   * *策略*: 如果图标太多 (1000+)，按功能拆分 (e.g., `Icon_Weapon_Atlas`, `Icon_Potion_Atlas`)。
   * *结果*: 打开背包时加载。
3. **Unique BG**: **不打入图集**。

   * *理由*: 全屏背景图通常很大 (1024x1024+)，打入图集会造成巨大的内存浪费（因为你很难填满剩余空间）。直接作为 `Sprite (Single)` 加载即可。

### 5.3 运行时 DrawCall 估算

1. **BG (Unique)**: 1 DrawCall (独立纹理)。

2. **Frame/Buttons (Common)**: 1 DrawCall (Common Atlas)。

3. **Icons (Item)**: 1 DrawCall (Icon Atlas)。

4. **Text**: 1 DrawCall (Font Texture)。

* **总计**: 约 4-5 DrawCalls。这是非常健康的。

**结论**: **物理上按功能分，逻辑上按图集聚。** 不要为了减少 1 个 DrawCall 而破坏项目结构的清晰度。

## 6. ✅ 开发者日常自查清单 (Daily Checklist)

1. [ ] **命名**: 新建文件是否符合 `Prefix_Name` 规范？

2. [ ] **位置**: 它是通用资源还是模块独享资源？放对文件夹了吗？

3. [ ] **引用**: 核心 UI 是否错误引用了关卡内的大贴图？

4. [ ] **测试**: 提交前是否在 `EditorSimulateMode` 下运行测试过？