外观
BTLX Reference 权威总览
本 Reference 面向 EasyTech BTLX 研究、未来 lossless codec/CLI、MOD 工具作者与格式研究者。它复用 btl.wc4.top 的 Reference 产品形态，但其源码、构建和数据 authority 全部位于独立 EasyTech 仓库，不建立 EasyTech ↔ WC4 的 source/build/runtime 依赖。
当前覆盖
| Profile | 根消息 | 根消息状态 | Corpus |
|---|---|---|---|
| EW7 Android 3.5.0 | Game.ProtoBuf.BattleArgs | Confirmed | 1901 |
| WS Android 3.2.2 | Game.ProtoBuf.BattleArgs | StronglySupported | 1939 |
两套 corpus 合计 3840 个 BTLX，当前严格 protobuf wire parse 和 byte-preserving round-trip 均为 3840/3840。
状态词
| 状态 | 含义 |
|---|---|
| Confirmed | 当前证据足以确认该层结论 |
| StronglySupported | 多条独立证据高度一致，但仍保留明确未闭合边界 |
| Hypothesis | 有依据的研究假设，不能当作格式事实 |
| Unknown | 当前证据不足，不补名字、不补行为 |
| Conflict | 同号字段、来源或版本之间存在明确冲突，必须按 profile 区分 |
权威边界
本站字段表优先展示 exact native Game.proto descriptor；root corpus coverage 来自 schema profile；递归 Unknown 来自 descriptor validation。
以下内容不是由 descriptor 自动证明的：
- 枚举数值对应的实际玩法含义；
- 某字段在 AI、事件或战斗逻辑中的具体行为；
- native 中精确的
BattleArgsconsumer / serializer 调用点； - 游戏 runtime 是否会把 asset BTLX 按同一方式重新写回。
这些内容必须继续保持 Unknown / Hypothesis，直到有更强静态或动态证据。
生成原则
schema/ 下的 message、版本差异和 Unknown 页面由 scripts/generate_schema_pages.py 从 canonical JSON 自动生成。生成结果不进入 Git，构建前重新生成，避免 schema 文档和 research authority 漂移。