docs: audit and fix standards docs inconsistencies (v1.2)
AssetFolderSpec.md:
- §8.1: Enemies_{Region} → Enemies (match AddressableRules.cs single group)
- §8.4: fix old menu paths (Tools/Verification → Addressables)
- §10.3: fix Skill SO path (Data/Player/Skills → Data/Progression/Skills)
- §10.4: Charm workflow — remove 'bypass editor tools' recommendation
- §3.2: add SPL_ prefix for SpellSO
- Bump to v1.2
AddressablesLabelSpec.md:
- §6 step 7: fix old Verification menu path
- §7.2/7.3/7.4: unify menu notation (→ to /) and fix old Tools/Verification paths
- Bump to v1.2
AddressKeys.cs:
- Remove duplicate <summary> XML doc comment in Labels class
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
This commit is contained in:
@@ -1,6 +1,6 @@
|
||||
# Addressables Label(标签)命名与使用规范
|
||||
|
||||
> **版本**:1.1
|
||||
> **版本**:1.2
|
||||
> **创建日期**:2026-05
|
||||
> **适用范围**:`Assets/_Game/` 目录下所有注册到 Addressables 的资产
|
||||
> **关联文档**:`Standards/AssetFolderSpec.md §8`、`Scripts/Core/Assets/AddressKeys.cs`、`Scripts/Editor/Addressables/AddressableRules.cs`
|
||||
@@ -261,7 +261,7 @@ await Addressables.DownloadDependenciesAsync("Preload", false);
|
||||
4. 在本文档 §2 Label 清单中追加说明行
|
||||
5. 在本文档 §3 对应资产类型的表格中标注
|
||||
6. 运行 Rule Sync(菜单 BaseGames → Addressables → Rule Sync)Scan 验证无遗漏
|
||||
7. 运行 AddressKeyValidator(菜单 BaseGames → Verification → Validate Address Keys)确认
|
||||
7. 运行 AddressKeyValidator(菜单 `BaseGames/Addressables/Validate Address Keys`)确认
|
||||
```
|
||||
|
||||
---
|
||||
@@ -286,7 +286,7 @@ Assets/_Game/Scripts/Editor/Addressables/AddressableRules.cs
|
||||
|
||||
```
|
||||
新建/更新资产后:
|
||||
1. 打开 Rule Sync 窗口(菜单 BaseGames → Addressables → Rule Sync)
|
||||
1. 打开 Rule Sync 窗口(菜单 `BaseGames/Addressables/Rule Sync`)
|
||||
2. 点击 [Scan All] — 扫描所有 Addressable 条目与期望规则的差异
|
||||
3. 查看报告:
|
||||
- Group Mismatch — 资产在错误的分组
|
||||
@@ -301,7 +301,7 @@ Assets/_Game/Scripts/Editor/Addressables/AddressableRules.cs
|
||||
|
||||
```
|
||||
1. 将资产按命名前缀放置到正确目录(见 AssetFolderSpec.md §2–§4)
|
||||
2. 打开 Addressable Batch Tool(菜单 BaseGames → Tools → Addressable Batch Tool)
|
||||
2. 打开 Addressable Batch Tool(菜单 `BaseGames/Addressables/Addressable Batch Tool`)
|
||||
3. 切换到 "② 文件夹批量" 标签,选择目标文件夹,点击 [Register Folder]
|
||||
4. 切换到 "① 同步 AddressKeys" 标签,点击 [Scan],为新注册的资产补充 AddressKeys.cs 常量
|
||||
5. 返回 Rule Sync 窗口执行 Scan → Fix All 统一校正 Group / Label
|
||||
@@ -312,6 +312,6 @@ Assets/_Game/Scripts/Editor/Addressables/AddressableRules.cs
|
||||
|
||||
| 工具 | 菜单路径 | 核心功能 |
|
||||
|------|---------|---------|
|
||||
| **Rule Sync** | `BaseGames → Addressables → Rule Sync` | 扫描 + 修复分组/标签不合规条目;导出 CSV |
|
||||
| **Addressable Batch Tool** | `BaseGames → Tools → Addressable Batch Tool` | 三标签:AddressKeys 同步 / 文件夹批量注册 / Selection 注册 |
|
||||
| **Validate Address Keys** | `BaseGames → Verification → Validate Address Keys` | 验证 AddressKeys.cs 所有常量均已在 Addressables 注册,构建前自动触发 |
|
||||
| **Rule Sync** | `BaseGames/Addressables/Rule Sync` | 扫描 + 修复分组/标签不合规条目;导出 CSV |
|
||||
| **Addressable Batch Tool** | `BaseGames/Addressables/Addressable Batch Tool` | 三标签:AddressKeys 同步 / 文件夹批量注册 / Selection 注册 |
|
||||
| **Validate Address Keys** | `BaseGames/Addressables/Validate Address Keys` | 验证 AddressKeys.cs 所有常量均已在 Addressables 注册,构建前自动触发 |
|
||||
|
||||
Reference in New Issue
Block a user