UnityAI/modules/frameworks/资源管理/README.md

# 资源管理

## 分类

- 核心框架

## 目的

管理 AssetBundle、语言资源、图集、prefab、DllBytes 等资源的加载、缓存和释放。

---

## 核心路径

- AssetBundle：`Assets/Game/GameHFScripte/CopyToHF/AssetBundle/`
- 图集：`Assets/Game/GameHFScripte/CopyToHF/SpriteAtlas/`
- 资源目录：`Assets/Game/GameHFResource/CN/`、`EN/`、`DllBytes/`

---

## 核心类

| 类 | 职责 |
|---|---|
| `HFABMgr` | AssetBundle 资源管理器单例 |
| `HFAssetLoader` | 具体资源加载器 |
| `HFAssetRequest` | 资源加载请求 |
| `HFAssetBundlePathAttribute` | 资源路径属性，标记资源根目录、相对路径、语言包规则等 |
| `HFGlobal_SpriteAtlas` | 图集全局管理 |

---

## 资源路径规则

`HFAssetBundlePathAttribute` 记录：

- 资源根目录
- 相对路径
- 是否忽略语言包
- 是否场景
- 线程优先级

`ChangeLanguage` 生成：

- `editorPath`
- `assetBundlePath`
- `assetBundleKey`
- `assetName`

`HFABMgr.OnCheckAssetBundlePathAttributeLanguage` 在当前语言无资源时回退默认语言。

---

## 加载流程

```text
HFABMgr.LoadInMemory(pathAttr)
  -> OnReadAssetBundleManifest()
  -> OnCheckAssetBundlePathAttributeLanguage()
  -> new HFAssetRequest(...)
  -> OnStartLoad()
  -> 获取或创建 HFAssetLoader
  -> HFAssetLoader.LoadAsset()
```

---

## 加载模式

### Editor 模式

```text
enHFAbLoadModel.Editor
  -> SFAssetUtility_Unity.LoadFromFile(editorPath)
  -> 直接读取编辑器资源
```

### 非 Editor 模式

```text
读取 AssetBundleManifest
  -> 解析依赖
  -> AssetBundle.LoadFromMemoryAsync 读取主资源
```

### CDN / 边玩边下

```text
缺失资源进入 WaitDownload
  -> HFAssetsDownLoadManager 下载
  -> HFABMgr.SaveFile 保存到本地
  -> 加载完成
```

---

## 图集加载

```text
SpriteAtlasManager.atlasRequested
  -> HFGlobal_SpriteAtlas.Instance.GetSpriteAtlasPath(spriteAtlasName)
  -> HFABMgr.OnLoadInMemory(spriteAtlasAttribute)
  -> callback(SpriteAtlas)
```

---

## 使用规则

- 资源路径统一通过 `HFAssetBundlePathAttribute` 配置。
- 加载资源统一走 `HFFunCatalogue.Asset.LoadAsset()` 或 `HFABMgr.LoadInMemory()`。
- 语言资源按 `GameHFResource/<lang>/` 分目录存放。
- 图集按业务或 UI 模块划分。

---

## 相关模块

- [UI 窗口系统](../UI窗口系统/README.md)
- [实体系统](../实体系统/README.md)
- [场景系统](../场景系统.md)

## 子文档

- [资源管理使用指南](使用指南.md)
- [资源加载重构方案](资源加载重构方案.md)

---

## 文档关联

> 当本文档发生变更时，应同步检查以下关联文档，避免信息不一致。

| 文档 | 关联原因 |
|---|---|
| [modules/模块索引.md](../../模块索引.md) | 模块索引是项目知识总入口 |
| [modules/frameworks/UI窗口系统/README.md](../UI窗口系统/README.md) | UI 资源加载依赖资源管理 |
| [modules/frameworks/实体系统/README.md](../实体系统/README.md) | 实体资源加载依赖资源管理 |
| [modules/frameworks/场景系统.md](../场景系统.md) | 场景资源加载依赖资源管理 |
| [modules/frameworks/资源管理/资源加载重构方案.md](资源加载重构方案.md) | AssetBundle 加载链路重构方案 |
| [rules/10-架构说明.md](../../../rules/10-架构说明.md) | 架构说明定义总体分层和依赖方向 |
| [rules/30-模块登记规则.md](../../../rules/30-模块登记规则.md) | 模块登记规则定义分类和状态口径 |