feat(addressables): 补全 catalog 可校验字段

补充 JSON/compact catalog 的 provider ID、bundle name、资源类型、hash、size、CRC 和依赖字段，并贯通 ResourceEntry、SQLite 资源索引和回归 golden。对 compact extra data 与 resource type index 的损坏返回明确错误，不再把 bundle name 当作 hash fallback。\n\n验证：cargo fmt --check；cargo test -p bat-core --locked；cargo test -p bat-adapters --locked；cargo test -p bat-infrastructure --locked；git diff --check。\n\nClippy 仍受既有 core/src/domain/game_client.rs:141 的 needless-question-mark 和 items-after-test-module 基线问题影响，未混入本 issue 修复。\n\nFixes #2

docs/architecture/assetbundle.md

@@ -1,6 +1,6 @@
 # AssetBundle 与资源解析路线图
 
-- **更新时间**：2026-07-26
+- **更新时间**：2026-08-19
 - **适用范围**：Rust 解析引擎、官方同步后的解析缓存、CAS/ResourceRepository 接入、后续文本提取和 Patch 发布。
 - **权威关联**：`PROJECT_PLAN.md` Milestone 3/4/5/8，`docs/reports/CURRENT_GAPS.md` G-005/G-007/G-011/G-011D。
 - **维护冻结**：解析扩展遵循 [`docs/reports/PARSER_FREEZE.md`](../reports/PARSER_FREEZE.md)，冻结期只接受稳定性、诊断、真实回归和文档一致性修复。
@@ -28,7 +28,7 @@
 | 层级 | 输入 | 输出 | 当前状态 |
 | --- | --- | --- | --- |
 | 官方 seed manifest | `TableCatalog.bytes`、`BundlePackingInfo.bytes`、`MediaCatalog.bytes` | 完整下载 URL、相对路径、hash 校验边界 | 已用于下载计划，仍需沉淀更多结构化字段 |
-| Addressables catalog | `catalog_*.zip` 内 JSON/bin catalog、`catalog_*.hash` | asset path、provider、dependencies、size、CRC、bundle name | JSON/compact 当前样本已覆盖，仍需更多真实结构变体 |
+| Addressables catalog | `catalog_*.zip` 内 JSON/bin catalog、`catalog_*.hash` | asset path、provider、dependencies、size、CRC、bundle name | JSON/compact 当前目标字段已覆盖；未知结构返回明确错误 |
 | UnityFS container | `.bundle`、zip 内 bundle | header、block、directory、解压文件、基础摘要 | 已支持基础解包、LZ4/LZMA、边界校验 |
 | Serialized file | UnityFS directory 文件 | header、type table、TypeTree node、object table、TextAsset bytes | 已支持基础表结构和 TextAsset bytes |
 | Unity 对象字段 | TextAsset、MonoBehaviour、ScriptableObject | 可翻译文本单元、上下文、资源定位 | TypeTree 基础字段读取、`SerializedReference` / prefixed managed-reference metadata alias、payload 提取和字符串提取已落地，真实结构覆盖继续扩大 |
@@ -54,7 +54,7 @@
 当前还不能宣称完整：
 
 1. TypeTree-covered managed reference 字段和 registry 记录已可结构化解码并参与文本提取，常见 registry 命名别名（含 `m_ManagedReferences`、`RefIds`、`m_RefIds`、verbose type 字段）、metadata 命名别名（含 `id`、`typeInfo`）、payload 命名别名（含 `data`、`value`、`payload`、`object`、`managedReferencePayload`、`referencePayload`、`serializedReferencePayload`、`managedReferenceValue`、`referenceValue`、`serializedReferenceValue`、`managedReferenceObject`、`referenceObject`、`serializedReferenceObject`、`managedReferenceData`、`referenceData`、`serializedData`）、full typename 拆解和 payload-only TextUnit 提取已有回归覆盖，多记录 registry 聚合也已有单元回归；fallback 字段遍历会跳过常见 registry 元数据字符串，避免误入翻译队列，并按记录前缀或子字段可推导 metadata 保留 managed-reference TextUnit context。enum `value__` backing field 和 `LayerMask` / `BitField` 的 `m_Bits` backing field 已可语义化解码和替换；`Vector2f/3f/4f`、`Quaternionf`、`ColorRGBA`、`Rectf`、`AABB/Bounds/Ray`、`Matrix4x4f`、`Vector2Int/Vector3Int`、`RectInt`、`BoundsInt`、`RangeInt`、`GUID`、`Hash128` 等固定 Unity 值类型的 leaf 和 direct child TypeTree 形态已可结构化解码和语义替换；array/vector/staticvector/List/HashSet/map 元素与 registry payload 字段已保留独立 field path、offset 和 byte size，可用于字符串元素 patch，managed-reference registry payload 字符串、enum、bit_field、unknown fixed-size raw bytes、object 字段组合和 TypeTree schema 支撑的 array/vector/List/HashSet/map 已可整体变长替换，`first/second` 与 `key/value` map entry schema 已有 serialized 和 UnityFS 重建回归，ScriptableObject `key/value` map 解析、变长替换和 UnityFS 重建已有专门回归，且嵌套 vector `Array`、`List<T>` / `HashSet<T>` 集合 alias、enum、bit_field、unknown fixed-size raw bytes 与 managed-reference payload 字段已有重建回归覆盖；解析模块当前处于维护冻结，未见样本驱动的完整 managed reference registry / map entry 变体、unknown 字段结构语义和版本差异冻结后再推进。
-2. Addressables bin/compact catalog 结构变体仍需真实样本驱动补齐。
+2. Addressables 当前目标 JSON/compact 字段链已补齐；未识别的独立二进制格式仍返回明确错误，不静默降级。
 3. 官方 release 已可配置导入 CAS + ResourceRepository，并可通过 `resource.index` 查询现有资源索引；Resource metadata 已记录 release、平台、bundle path、parse status、TextAsset 名称和 TextUnit 摘要。
 4. 不能完成复杂对象字段重打包，也不能从真实 Crowdin 结果自动生成完整汉化文件集合。
 
@@ -98,6 +98,11 @@
 4. 将 Windows/Android catalog 样本拆成可复现 fixture，不把大文件纳入 Git。
 5. 对未知结构返回明确错误或保真 raw metadata，不静默丢字段。
 
+本次 issue #2 交付已完成上述 JSON/compact 字段链：provider ID、bundle name、
+primary/dependency key、resource type、hash、size 和 CRC 会进入 `ResourceEntry`，
+并通过 SQLite `ResourceRepository` 持久化；旧索引会按列迁移继续可读。独立二进制
+catalog 仍按“明确不支持”处理，不把低保真路径伪装成完整解析。
+
 验收：
 
 1. 当前目标版本 Windows/Android catalog 样本集合解析通过。

docs/guides/development.md

@@ -271,6 +271,7 @@ worker 状态、parse status、TextUnit format、队列 reason 和 provider fail
 `translation-handoff.json` 与 SQLite 状态，返回 job、unit、provider run 的完整交接
 视图；
 `resource-index` 返回的资源 JSON 包含 release、平台、bundle path、TextAsset 和 TextUnit metadata，
+以及 Addressables entry 的 provider ID、bundle name、hash、size、CRC 和依赖关系；
 并可按 release、平台、destination、bundle path、archive entry、parse status 和 TextUnit format 做资源级过滤；
 `localized-status` 只有在 `localized-version-state.json`、`current` symlink 和
 `localized-patch-manifest.json` 都匹配当前官方 release 时才返回 `localized`；

docs/reference/rpc-backend-api.md

@@ -123,8 +123,9 @@ SQLite `ResourceRepository`，索引不存在时返回 `ok=true` 且
 `entry` 外会包含 `metadata`：`official_release_id`、`platform`、
 `bundle_path`、`archive_entries`、`parse_statuses`、`unity_versions`、
 `text_assets`、`text_unit_count`、`text_unit_formats` 和
-`text_unit_error_count` 等字段。旧索引库会通过 `metadata_json` 迁移列得到
-默认空 metadata。
+`text_unit_error_count` 等字段。`entry` 还会保留 Addressables 的
+`provider_id`、`bundle_name`、`hash`、`size`、`crc` 和 `dependencies`。
+旧索引库会通过 `metadata_json` 以及资源字段兼容迁移得到默认空值。
 
 `resource.state`、`catalog.status`、`parse.status` 和 `localized.status`
 都会返回当前观察面的短状态 `status` 与稳定状态码 `status_code`。`status_code`

docs/reports/CURRENT_GAPS.md

@@ -180,15 +180,15 @@ issue 43 例外说明：新增的 `parse repack` 只编排已有 TextAsset、Typ
 
 ### G-007：Addressables Catalog 解析不完整
 
-状态：**部分关闭**
+状态：**当前目标字段已关闭，独立二进制格式待后续**
 
 现象：
 
 - `AddressablesCatalogDriver` 已能解析当前真实形态 JSON catalog fixture/golden。
-- 已输出 path、hash、size、resource_type、address、dependencies、metadata，并已提取 `m_Crc` 到 `crc` 字段。
+- 已输出 path、hash、size、resource_type、address、dependencies、provider ID、bundle name、metadata，并已提取 `m_Crc` 到 `crc` 字段。
 - compact catalog 解析已补充 hash/size/CRC 的非 0 回归、资源计数 metadata，以及 blob 解码失败时的明确错误；不再在 compact 字段损坏时静默退回低保真 `m_InternalIds`。
-- `bat-core` 已提供 `crc32_ieee` 和 `ResourceEntry::verify_downloaded_bytes`，SQLite `ResourceRepository` 已有 `crc` 列迁移。
-- 仍需覆盖更多官方 catalog 结构变体、provider/bundle name 持久化字段，以及真实 Windows/Android catalog 样本集合。
+- `bat-core` 已提供 `crc32_ieee` 和 `ResourceEntry::verify_downloaded_bytes`，SQLite `ResourceRepository` 已有 `crc`、provider_id、bundle_name 兼容迁移。
+- 当前 JSON/compact 目标字段已通过 expanded、alias、compact 和真实形态 golden 回归；独立二进制 catalog 仍明确拒绝，不静默丢字段。
 
 影响：
 
@@ -197,7 +197,7 @@ issue 43 例外说明：新增的 `parse repack` 只编排已有 TextAsset、Typ
 验收：
 
 - 能解析项目目标版本的真实 Catalog 样本集合。
-- 解析结果包含资源 key、provider、dependency、hash、size、path、CRC。
+- 解析结果包含资源 key、provider、dependency、hash、size、path、bundle name、CRC。
 - 对不支持的 catalog 结构返回明确错误，而不是静默丢字段。
 - 解析结果能反查 bundle 文件、依赖链和本地下载 manifest 条目。
 - Windows/Android 样本集合需要覆盖 JSON、compact JSON 和后续二进制 catalog 入口。

docs/reports/PARSER_FREEZE.md

@@ -37,6 +37,18 @@
 
 该例外不解冻解析器，不新增 UnityFS/AssetBundle/Addressables/TypeTree 解析类型、字段覆盖、catalog 结构或合成 fixture 能力。后续任何扩大解析覆盖的变更仍需单独解冻授权。
 
+## issue 2/3 的开发例外
+
+授权时间：2026-08-19
+
+用户明确授权将 issue #2/#3 作为解析开发进展继续推进。本次例外允许：
+
+- Addressables JSON/compact catalog 的 provider、bundle name、hash、size、CRC、资源类型和依赖关系字段补全，以及对应 SQLite/fixture 回归；
+- UnityFS 已有 header、block、directory、压缩和 alignment 能力的校验加固，以及隔离真实 bundle 回归；
+- 更新解析路线图、状态和 RPC/CLI 资源索引字段说明。
+
+本次例外不包含发布级复杂对象重打包、完整 Unity 版本兼容承诺或新的汉化发布控制面；这些仍按后续 Patch/发布路线单独验收。
+
 ## 禁止变更
 
 冻结期禁止以下解析相关变更：