BTL 值域速查

状态：Authoritative Reference v1 / Semantic Closure Incomplete

本目录把已经有证据支持的“数值 -> 原版语义”集中成可搜索的速查表。

它不是第二套 enum authority，也不把当前未知值补成完整枚举。每个值域条目仍引用对应 Record Reference、native consumer、corpus 或动态证据。

1. 阅读规则

值域速查统一遵守：

Confirmed：该数值与所述精确结论已有直接证据；
FunctionConfirmed：功能族已经直接闭合，但原版正式名称或部分参数/边界仍未知；
Characterized：已有足够证据描述某个 scoped 行为特征，但还不能推广为完整类型定义；
Observed：原版 corpus 明确出现该值，但 type-specific 功能映射仍未闭合；
Partial：只闭合了分支族、用途范围或部分参数；
Unknown：当前不能给出安全用户侧语义；
NameStatus=Unknown 可以与 FunctionConfirmed/Characterized 同时成立：不知道原版正式名称，不等于不知道它大概做什么；
未列出的数值 不等于无效，也不等于原版支持；
corpus 中未出现的值 不等于不存在；
writer 权限必须单独证明，值域已知不自动授权写入。

特别注意：像 ActionType、TriggerType 这样的字段会让相邻参数槽形成 union。查到一个 type 的值后，还必须按该 type 阅读参数，不能把同一 offset 的解释推广到所有 type。

2. 当前速查入口

值域	入口	当前闭合程度
`Event.ActionType`	Event 类型值域	1.30 stock 已观察 `0x00..0x19` 全 26 项；`0x19/25` 从 1.29 native-supported / stock=0 提升为 1.30 stock=24，且 24/24 的 CountryRecordId + GeneralId 结构引用可解析；正式 enum 名、动态异常边界与 writer validity 仍 Unknown/NoGo
`Event.TriggerType`	Event 类型值域	stock 0..5 全部列出；0x00/0x03 direct EventId callback gate 已精确化；Building CaptureEvent raw↔runtime 投影已闭合；0x01/0x04 stock reference-role 已闭合；0x05 已闭合 caller Country.RecordId gate + 六角半径圈外→圈内算法、Move Undo invalidation 与 battle save/resume-preserved executed latch
`CountryStrategy.OperationType`	核心值域	0/1/2 已闭合 dispatch
`WeatherTypeRaw`	核心值域	0..3 dispatch 已确认；具体天气效果 Unknown
`Header.MapSource`	核心值域	0/1 已闭合
`Country.ControllerSeedRaw`	核心值域	0 / nonzero 方向已闭合，保留 mode caveat
`Country.DefeatConditionRaw`	核心值域	0..7 corpus 已知；只有部分 branch 语义闭合
`SSecondaryConditionArgs.condition`	Extension 值域	9/13 已闭合 audited progress consumer

3. 快速搜索建议

站点搜索可以直接输入：

text

ActionType 0x19
ActionType 0x0D
TriggerType 1
TriggerType 2
TriggerType 4
TriggerType 5
OperationType 2
WeatherType 3
MapSource 1
ControllerSeedRaw 0
DefeatConditionRaw 6
condition 13

4. 明确不能安全枚举的值域

当前下列字段虽然确认是 active/dispatch input，但还不具备可发布的完整值 -> 语义表：

Unit.FallbackBehaviorMainType 的原作者正式 enum/UI 名；机制值 0..4 已恢复，255 仅恢复 fallback 控制流；
Unit.LandSeaTransitionRestriction 的原作者 enum/UI 名；字段已确认投影到 runtime Unit+0x140，且 0/1/2 机械语义已闭合为无方向禁令 / 禁止海→陆 / 禁止陆→海；
Unit.BehaviorStateRaw 的完整用户侧 enum；
Unit.MoraleRaw 的完整用户侧 enum；
Unit.PackedFlags2B；
Building.PackedState14Raw；
Building.PackedState17Raw；
Building.PackedNuclearAndFlagsRaw 的高位；
Header victory type-dependent parameter union；
全部 SecondaryCondition.condition；
Event ActionType 的原版正式 enum 名、0x19 的 1.30 动态/GeneralId=0/无匹配/重复匹配 author 边界、0x0D/0x18 完整 spawn 异常/表现边界、0x0E/0x0F 长尾清理边界、status definition 逐 ID 效果以及 1.29 native 0..25 外 parser/runtime 边界；
Event TriggerType 的原版正式名称；Type3 57 条当前已升级为 audited normal Battle graph 下 dormant/unreachable，但仍非全局 ConfirmedDeadCode；Type1/4 其他未覆盖 role；Type2 的排序/repeat 特例；Type5 +0x22 非零值语义、seed-ineligible lifecycle 等剩余边界。

详见未闭合值域。

5. 机器索引

机器可读值域索引：

text

reports/btl_reference/value_domains.json

该 JSON 只汇总 Reference 已有结论，不替代底层证据。

BTL 值域速查 ​

1. 阅读规则 ​

2. 当前速查入口 ​

3. 快速搜索建议 ​

4. 明确不能安全枚举的值域 ​

5. 机器索引 ​