BTL Reference HTML 站点构建与分发

1. 定位

本页只描述 reconstruction/docs/btl-reference/ 的 HTML 展示层。

Markdown 与 reports/btl_reference/*.json 继续承担 BTL Reference 的正文和机器 authority。VitePress 配置、主题和构建产物不得反向定义字段语义、版本规则或写入权限。

2. 固定工具链

当前展示层固定：

text

Node.js: 24.x compatible
VitePress: 2.0.0-alpha.19 (exactly pinned)
Resolved Vite: 8.2.1
Dependency lock: package-lock.json

安装依赖：

text

npm ci

本地编辑预览：

text

npm run docs:dev

正式静态构建：

text

npm run docs:build

构建输出：

text

.vitepress/dist/

本地检查正式构建：

text

npm run docs:preview

构建、内部链接、核心页面、搜索索引和 HTTP smoke 的 focused gate：

text

npm run docs:check

联网依赖安全检查：

text

npm run docs:audit

.vitepress/dist/ 和 node_modules/ 都是可重建本地产物，不进入 Git。

3. 当前站点能力

当前站点使用 VitePress 默认文档主题并做有限 CSS 扩展，提供：

简体中文导航；
Header、Country、Building、Unit、Event、Reinforcement、Extension 等固定侧栏；
每页二至四级标题目录；
深色/浅色模式；
为大 offset 表放宽的正文区域；
横向滚动字段表；
代码高亮；
浏览器内本地全文搜索；
针对中文单字、双字与 0x25、ArmyAIConfig 等技术字符串的定制 tokenizer；
桌面与移动端响应式布局；
可立即关闭的“交流与支持”弹窗：展示 QQ 群入口和自愿赞赏码；默认每个浏览器会话最多显示一次，勾选“今日不再显示”后按本地自然日抑制到次日。

4. Web 分发

默认 base 为 /，适合部署在独立域名或站点根路径。

如果以后部署到子路径，例如：

text

https://example.invalid/wc4-btl/

构建时设置：

text

WC4_BTL_DOCS_BASE=/wc4-btl/

该值必须以 / 开头并以 / 结尾；站点配置会在构建时验证。VitePress 不支持相对 base。因此当前正式发布目标是静态 HTTP/HTTPS 托管，而不是直接双击 file://.../index.html。

如果未来需要“解压后双击即可离线使用”，应单独实现 OfflineExport，不能通过修改正文 Markdown 或伪造相对路由破坏主站。

5. 当前生产部署

2026-08-10 已通过官方 EdgeOne CLI 直接上传生产构建，建立独立发布项目：

text

Provider: Tencent EdgeOne Makers
Project: wc4-btl-reference
Project ID: makers-g42c5rliovy1
Environment: production
Acceleration area: overseas
Source artifact: .vitepress/dist/
Public domain: btl.wc4.top

overseas 表示全球可用区（不含中国大陆节点），因此绑定自定义域名时不要求中国大陆 ICP 备案。平台生成项目域名和部署域名不是面向中国大陆用户的正式入口；公开分发应使用自定义域名 btl.wc4.top。

当前远程状态：生产构建已经部署成功，btl.wc4.top 已完成 EdgeOne 自定义域名绑定和 Cloudflare DNS CNAME 配置，并可通过 HTTPS 正常访问。后续 Reference 更新仍必须先通过本地 docs:check 等门禁，再独立执行 R3 生产发布。不得在仓库中保存 EdgeOne 登录 token、Cloudflare API token、浏览器 cookie 或临时带 token 的预览 URL。

生产源码 authority 与防回归规则

文档站生产源码不能再由任意专题分支自行充当。当前生产站点由 ci/workstreams.json 中以下 workstream 路由：

text

btl-reference-production-site-reconciliation-20260915

任何新的 R3 文档站发布都必须先读取该 workstream 的 exact authorityCommit，并满足以下条件：

发布工作树必须包含当前生产 authority commit，或以明确的内容并集方式把当前生产树全部带入；
专题分支若不包含当前生产 authority，不得直接执行全站部署；
当前生产内容并集由 production_baseline.json 机器记录固定；其中保存已部署 substantive commit、Deployment ID、必保页面/语义 marker、搜索 marker、Promo bundle marker 与两个静态资产 SHA-256；
普通内容验证仍使用 npm run docs:check；任何 R3 全站发布前必须在已提交且 Git-clean（忽略项除外） 的发布工作树上额外运行 npm run docs:production-check。该命令会重新构建站点，并 fail closed 检查 Git ancestry、工作树清洁度、生产页面/marker、搜索索引、Promo asset SHA-256 与 bundle marker；
开发中的未提交改动只能使用 node scripts/validate-production-baseline.js --allow-dirty 做内容门禁预检；--allow-dirty 不是发布许可，R3 发布不得使用；
每次 R3 发布完成后，必须把新的 substantive commit、Deployment ID 和公网内容验收结果写回本页，并在部署证据提交中把 production_baseline.json.productionSourceCommit 前进到实际构建并部署的 substantive commit；production-site workstream 的 authorityCommit 仍指向 substantive authority，部署证据提交可以包含但不得冒充新的站点正文；
自动化公网验收只证明 HTTP/content，不能冒充人工视觉验收。

这条规则用于防止 2026-09-12 / 2026-09-14 那类“专题内容正确，但从较旧源码树全站发布，覆盖掉此前已上线页面”的回归再次发生。

2026-09-16 production route 漂移复核与收敛

当前 production_baseline.json 仍准确记录已经部署并通过公网内容验收的 Android 1.30 生产版本：substantive commit 20a5ec6f625a3a5d0fc5255b5df83f7dcecb3c51、deployment evidence 26e84f247105e9a729ecef0791ed38dbefcedead、Deployment ID dp8zhxt4bhpr。该既有部署继续有效，不回滚、不重写。

本轮最初从旧 administrative checkout a6d4e9662f6d8c8a75d0726098e9c9386b0388ef 观察到 production-site workstream 缺失，因此临时按 fail-closed 记录了 R3 NoGo。随后按根 CURRENT_HANDOFF.md 重新进入当前 portfolio routing authority，并在 mod-toolkit-encrypted-asset-pack-portfolio-update-v1 的当前 authority 中确认：

text

workstream     = btl-reference-production-site-reconciliation-20260915
branch         = btl-reference-production-baseline-maintenance-v1
authorityCommit at reconciliation start = e6c4c2c4dc96657e6945afb900fd19b39f0cbb71
routingState   = Active

因此先前的“当前 registry 缺路由”只说明旧 checkout 不是当前管理 authority，不再构成生产发布 blocker。生产分支随后只允许以 ff-only 方式前进；每次 R3 前仍必须满足：当前 portfolio ci/workstreams.json 的 exact authorityCommit 与待发布 substantive HEAD 同步、工作树 clean、docs:production-check 通过。任何旧 worktree 名称、历史部署记录或旧 checkout 都不能替代这三个门禁。

机器审计保留在 reports/btl_reference/production_route_drift_20260916.json，其中同时记录初始误判来源和当前收敛结论。

2026-08-10 Event producer/lifecycle Reference 更新

本次 substantive Reference 发布对应本地 authority commit：

text

1997cb96aca6cb7afcb0698e002f75bf25ea396f

EdgeOne production deployment：

text

Deployment ID: dpa0day0v1ko
Environment: production
Area: overseas
Result: Deploy Success

发布后对正式域名进行了自动化公网内容验收，而不只检查部署命令退出码：

text

https://btl.wc4.top/records/building       HTTP 200 + 新增 native 指令地址命中
https://btl.wc4.top/records/reinforcement  HTTP 200 + 新增 spawned-Unit death Event 证据命中
https://btl.wc4.top/records/event          HTTP 200 + Type3 / executed lifecycle 新统计命中
https://btl.wc4.top/values/event           HTTP 200 + 对应值域正文命中

结果：PUBLIC_VERIFY_PASS。本次只记录自动化 HTTP/content acceptance；没有把它冒充成人工浏览器视觉验收。EdgeOne CLI 的原始临时输出可能含 tokenized URL，因此不进入仓库。

2026-08-10 Type5 Move Undo / save-resume lifecycle Reference 更新

本次 substantive Reference 发布对应本地 authority commit：

text

2cb58e322eee218d16262b00218b9e0714c93156

EdgeOne production deployment：

text

Deployment ID: dpb1macjrwbn
Environment: production
Area: overseas
Result: Deploy Success

发布后对正式域名执行严格 HTTPS 内容验收：

text

https://btl.wc4.top/values/event.html   HTTP 200 + Move Undo-state + save/resume 内容命中
https://btl.wc4.top/records/event.html  HTTP 200 + Move Undo-state + save/resume 内容命中

结果：PUBLIC_VERIFY_PASS。本次闭合的 Type5 +0x22==0 对 pending movement rollback / Move Undo state 的失效行为，以及 Event+0x28 executed latch 在原版正常 Battle packed save/resume 中的持久化边界继续有效。该次部署同时错误地把 Battle action-command namespace 的 0x14 Move Undo 行为映射成了 BTL Event.ActionType 0x14；这部分随后由 BtlEventActionTypeNamespaceCorrection/v1 明确 supersede。只记录自动化 HTTP/content acceptance，不宣称人工视觉验收。

2026-08-10 BTL Event.ActionType namespace 紧急纠错

纠错 authority commit：

text

bfb540e6929aa22b8bc08e4e49017f9dc74be5a5

纠错内容：上一部署将 Battle action-command namespace 的 0x14 Move Undo completion 行为误映射为 BTL Event.ActionType 0x14。直接复核原版 FUN_003835B4 jump table 后，BTL Event 0x13..0x16 已改为 FUN_0048E44C helper-family dispatch，其中 0x14 -> FUN_0048E44C(countryContext, Event+0x18, 1)；具体 gameplay effect 与正式 enum 名仍 Unknown。Type5 +0x22==0 对 pending movement rollback state 的 invalidation 结论不受影响。

EdgeOne production deployment：

text

Deployment ID: dpf9qroc8r7j
Environment: production
Area: overseas
Result: Deploy Success

正式域名自动化验收：

text

https://btl.wc4.top/values/event.html   HTTP 200; action14Helper=True; wrongAlias=False; type5RollbackInvalidation=True
https://btl.wc4.top/records/event.html  HTTP 200; action14Helper=True; wrongAlias=False; type5RollbackInvalidation=True

结果：PUBLIC_NAMESPACE_CORRECTION_VERIFY_PASS。未把自动化内容验收冒充人工视觉验收。

2026-08-10 Event ActionType 全表 / Type3 reachability v2 更新

本次 substantive Reference 发布对应本地 authority commit：

text

48136f200a5d1ee962900103b7efd975f4d07ee4

本次更新将 BTL Event.ActionType 0x00..0x18 的 25 个 stock 值全部提升到至少功能族级 characterization，并同步闭合 Event+0x22 为通用 disabled flag；同时将 Type3 的 57 条 no-known-producer 记录更新为 audited activation graph 下的 dormant / seed-unreachable characterization，仍不宣称全局永久死数据。

EdgeOne production deployment：

text

Deployment ID: dp7u3znfrc8h
Environment: production
Area: overseas
Result: Deploy Success

正式域名自动化 HTTPS 内容验收：

text

https://btl.wc4.top/values/event.html   HTTP 200; BattleMoney=True; BattleAtomic=True; scripted-target=True; status-duration=True; linked-carrier=True
https://btl.wc4.top/records/event.html  HTTP 200; disabled-flag=True; Type3-57=True; FUN_00383AC8=True; Event+0x22=True; BattleAtomic=True

结果：PUBLIC_VERIFY_PASS。只记录自动化 HTTP/content acceptance，不宣称人工浏览器视觉验收。EdgeOne CLI 生成的临时 tokenized URL 不进入仓库。

2026-08-13 CC BY-SA 4.0 内容许可上线

本次生产发布对应 substantive authority commit：

text

e6c45ab149c993e8db97a1bb68ed8bab5ebe301b

发布内容只调整 WC4 BTL Reference 的许可与展示边界：新增 CC BY-SA 4.0 内容许可页面、全站页脚提示和 HTML rel="license"；同时明确原版 WC4 资产、第三方受保护材料、原始 APK/SO/BTL/存档/二进制材料、商标和第三方软件不在本站 CC BY-SA 4.0 授权范围内。

EdgeOne production deployment：

text

Deployment ID: dpu0xmcjx0t3
Environment: production
Area: overseas
Result: Deploy Success

正式域名自动化 HTTPS 内容验收：

text

https://btl.wc4.top/                  HTTP 200; CC-BY-SA=True; rel-license=True
https://btl.wc4.top/LICENSE.html      HTTP 200; license-page=True; third-party-exclusion=True
https://btl.wc4.top/values/event.html HTTP 200; CC-BY-SA=True; rel-license=True

结果：PUBLIC_LICENSE_VERIFY_PASS。这里只记录自动化 HTTP/content acceptance，不宣称人工浏览器视觉验收。EdgeOne CLI 产生的临时 tokenized 预览 URL 不进入仓库，也不作为正式发布入口。

2026-08-13 交流与支持弹窗上线

本次生产发布对应 substantive authority commit：

text

bd9a5d72c583d4d053a9318d502e737bb506bc94

发布内容新增可关闭的“交流与支持”弹窗、QQ 群入口、用户提供赞赏码的裁剪展示副本，以及“今日不再显示”的浏览器本地自然日抑制逻辑；同时扩展 docs:check 对弹窗 bundle marker 和两个静态资产的检查。

EdgeOne production deployment：

text

Deployment ID: dplzjb2tj1kg
Environment: production
Area: overseas
Result: Deploy Success

正式域名自动化 HTTPS 验收：

text

https://btl.wc4.top/                                      HTTP 200; current app bundle=True; CC-BY-SA=True
https://btl.wc4.top/assets/chunks/theme.CkFIOVgI.js       HTTP 200; session-key=True; day-key=True; group=True; join-url=True; local/public SHA-256 identical
https://btl.wc4.top/promo/sponsor.webp                    HTTP 200; SHA-256=26dcdef64ace3bf884c8f1aa4ba9ffed3c07055b4ba838fdd7d26a10bcfd34f7
https://btl.wc4.top/promo/qq-group.svg                    HTTP 200; SHA-256=392cdb58f65327deeb669dcd496c494b34b22b87e7d6fc917cec6ee647516cc9

结果：PUBLIC_PROMO_VERIFY_PASS。这里只记录构建、bundle 和公网内容验收，不宣称人工浏览器视觉验收。EdgeOne CLI 产生的临时 tokenized 预览 URL 不进入仓库，也不作为正式发布入口。

2026-08-16 Unit 海陆转换限制 / Event 0x09 语义纠错发布

本次生产发布对应文档站 substantive authority commit：

text

0c9e5a783a1bf819a2cb4b814d9187f5fc229799

发布内容将 BTL Unit +0x1E / runtime Unit+0x140 从旧的 AI subtype 解释纠正为单位级 LandSeaTransitionRestriction：0 不增加方向禁令、1 禁止海→陆、2 禁止陆→海；同步将 ArmyAIConfig action 1 与 Event ActionType 0x09 解释为动态写该字段，并明确玩家普通移动与 fallback AI 都消费同一 common-path legality gate。Event 0x19 的 Unit+0x140=0 也同步解释为解除该海陆转换限制，而不是清 AI subtype。

EdgeOne production deployment：

text

Deployment ID: dp8ydxab8p6j
Environment: production
Area: overseas
Result: Deploy Success

正式域名自动化 HTTPS/content 验收：

text

https://btl.wc4.top/records/unit.html      HTTP 200; LandSeaTransitionRestriction=True; block-land-to-sea=True
https://btl.wc4.top/records/behavior.html  HTTP 200; ArmyAIConfig-action1=True; LandSeaTransitionRestriction=True
https://btl.wc4.top/values/event.html      HTTP 200; ActionType-0x09=True; not-AI-subtype=True; block-land-to-sea=True

结果：PUBLIC_LAND_SEA_RESTRICTION_VERIFY_PASS。这里只记录自动化 HTTP/content acceptance；不宣称人工浏览器视觉验收。EdgeOne CLI 输出中的临时 tokenized URL 不进入仓库。

2026-09-11 Fallback AI 主行为 0~4 深度 Reference 发布

本次生产发布对应 substantive authority commit：

text

7224d3c5f424fd9a6649fd46d6705723f7cfef82

发布内容新增 Fallback AI 主行为 0~4 专题页，串联 BTL Unit +0x1D、ArmyAIConfig action 0、Event ActionType 0x06 与 runtime Unit+0x13C；公开 0..4 顶层候选组分派、0x1000~0x8000 机制边界、mode2 的 0x4000 相邻一格 strategic landing gate、mode0/mode2 精确正分数 RNG finalization、mode4 pressure/support 权重，以及 1.28 corpus 中 mode3 -> mode2 的阶段性 authoring pattern。页面明确区分 Android 1.28 native/corpus 证据与当前 1.29 BTL 结构统计，并保留原作者正式 enum/UI 名为 Unknown。

本地发布前门禁：

text

npm run docs:check  PASS
npm run docs:audit  PASS (0 vulnerabilities)
python tools/validate_text_format.py  PASS
python tools/validate_repository_safety.py  PASS

EdgeOne production deployment：

text

Deployment ID: dpn6iazjvdqp
Project: wc4-btl-reference
Environment: production
Area: overseas
Result: Deploy Success

正式域名自动化 HTTPS/content 验收：

text

https://btl.wc4.top/semantics/fallback_ai_behavior.html HTTP 200; mode2-adjacent=True; mode2-label=True; support-scale=True; version-boundary=True
https://btl.wc4.top/records/behavior.html               HTTP 200; AI-reference-link=True; quarter-band=True
https://btl.wc4.top/records/event.html                  HTTP 200; AI-reference-link=True; ActionType-0x06=True
https://btl.wc4.top/records/unit.html                   HTTP 200; AI-reference-link=True; FallbackBehaviorMainType=True
https://btl.wc4.top/                                    HTTP 200; AI-nav-link=True

结果：PUBLIC_FALLBACK_AI_REFERENCE_VERIFY_PASS。这里只记录自动化构建、链接、搜索索引和公网内容验收，不宣称人工浏览器视觉验收。EdgeOne CLI 输出中的临时 tokenized URL 不进入仓库。

本工作使用最后一次已确认生产站点源码 6908c83031c295a1620a1415e91cc18925c5715d 作为发布基底，以避免当前 portfolio checkout 中较旧 BTL 页面副本回退已经上线的 FallbackBehaviorMainType / LandSeaTransitionRestriction 语义。当前全 portfolio governance validator 对该 2026-08-16 历史生产基线报告四个 stale/mismatch 项（新增 vanilla-plus Variant 和派生 portfolio status），属于生产基线与 2026-09 当前治理拓扑的已知时间漂移；本次没有为文档发布改写该历史治理状态。

2026-09-12 Terrain layered Reference v2 更新

本次 substantive Reference 发布对应本地 authority commit：

text

6717535182fe203d6aad49afcafe87dcde4b5578

本次更新将 Terrain 从仅保留四个 uint32 Raw* 的 Raw Reference 提升为 layered Reference：明确 embedded / external 来源、16-byte 前 12 byte 的三个 visual slice、def_mapterrain -> def_terraintype -> Runtime Tile 规则链、ordinary/external 表现分层与动态 mutation 的 NoGo 边界；+0x0C..+0x0F 继续保持 Unknown/raw-preserve。

EdgeOne production deployment：

text

Deployment ID: dpd3qjclcyy0
Environment: production
Area: global / overseas
Project ID: makers-g42c5rliovy1
Result: Deploy Success

正式域名自动化 HTTPS 内容验收：

text

https://btl.wc4.top/records/terrain.html  HTTP 200
Authoritative Reference v2                  present
PrimaryTerrainId                            present
def_mapterrain                              present
Raw tail / Unknown boundary                 present
Terrain top navigation                      present

结果：PUBLIC_VERIFY_PASS。只记录自动化 HTTP/content acceptance，不宣称人工浏览器视觉验收。EdgeOne CLI 输出的临时 tokenized preview URL 未写入仓库。

2026-09-14 Extension writer foundation Reference 更新

本次 substantive Reference 发布对应本地 authority commit：

text

1bd8f67f5459db14db93d81cb2cc421228881b06

本次更新加入 BattleArmyExArgs Extension writer definition/foundation Reference：记录 bynameId / legendArmyId 的 scoped low-level writer foundation、lossless local wire rewrite、精确 inverse、独立 variable-length preservation / validated Save As，以及 1.28 原版 corpus 的 407/407 nonempty Extension lossless no-op、112/112 unique Army authoring controlled mutation + strict reparse + byte-exact inverse 结果。Production writer、Scenario Editor admission、blocked Army fields、source overwrite 和 automatic repair 继续保持 NoGo。

EdgeOne production deployment：

text

Deployment ID: dpmi9k0n31gt
Environment: production
Area: overseas
Project ID: makers-g42c5rliovy1
Result: Deploy Success

正式域名自动化 HTTPS 内容验收：

text

https://btl.wc4.top/extension/writer_foundation.html  HTTP 200; BtlExtensionWireTransformer=True; ValidatedBtlExtensionSaveService=True; 407/407=True; 112/112=True
https://btl.wc4.top/extension/writer_gate.html        HTTP 200; Foundation Completed=True; BtlExtensionPackageBoundaryQualification/v1=True
https://btl.wc4.top/extension/army_ex.html            HTTP 200; tunnelFromArea=True; steelWillValue=True; 0x59=True; Implemented+CorpusQualified=True
https://btl.wc4.top/extension/battle_ex_args.html     HTTP 200; Implemented+CorpusQualified=True; Scenario Editor admission=True; H54=True

结果：PUBLIC_VERIFY_PASS。只记录自动化 HTTP/content acceptance，不宣称人工浏览器视觉验收。EdgeOne CLI 输出的临时 tokenized preview URL 未写入仓库。

2026-09-15 生产基线 reconciliation / Fallback AI 恢复

本次生产发布对应实际构建并部署的 substantive authority commit：

text

0e7080f0de7b282fa6da85e9fbd710909ce61316

本次不是单独恢复一个页面，而是把已经分别上线过、但被后续较旧源码树全站部署覆盖掉的生产内容重新做并集收敛：

恢复 CC BY-SA 4.0 内容许可与 License 页面；
恢复交流/支持弹窗和两个静态 Promo 资产；
恢复 2026-08-16 Unit +0x1E / Unit+0x140 的 LandSeaTransitionRestriction 纠错；
恢复 2026-09-11 Fallback AI 主行为 0..4 深度 Reference 与 Behavior / ArmyAIConfig action 0..6 consumer-scoped 解码；
保留 2026-09-12 Terrain layered Reference v2；
保留 2026-09-14 Extension writer foundation Reference；
新增 production-site exact authority 与发布前内容并集/回归门禁，禁止不包含当前生产 authority 的专题分支直接覆盖整个站点。

本地发布门禁：

text

npm run docs:check   PASS
HTML pages           40
references checked   2214
missing references   0
missing core pages   0
missing search terms 0
missing promo assets 0
missing promo markers 0
HTTP smoke           all 200
npm run docs:audit   PASS / 0 vulnerabilities
python tools/validate_text_format.py       PASS
python tools/validate_repository_safety.py PASS / 0 warnings
git diff --check                          PASS

EdgeOne production deployment：

text

Deployment ID: dp4yy70bv5gi
Environment: production
Area: overseas
Project ID: makers-g42c5rliovy1
Result: Deploy Success

正式域名自动化 HTTPS/content 验收：

text

/semantics/fallback_ai_behavior.html  HTTP 200; 004afb34=True; 分步战略推进型=True; support-scale=True
/records/behavior.html                HTTP 200; Raw04-action-selector=True; action0=True; LandSeaTransitionRestriction=True
/records/unit.html                    HTTP 200; LandSeaTransitionRestriction=True
/records/event.html                   HTTP 200; ActionType-0x06=True; LandSeaTransitionRestriction=True
/records/terrain.html                 HTTP 200; def_mapterrain=True
/extension/writer_foundation.html     HTTP 200; BtlExtensionWireTransformer=True
/LICENSE.html                         HTTP 200; CC-BY-SA-4.0=True
/                                    HTTP 200; fallback-ai navigation link=True
/promo/qq-group.svg                   HTTP 200
/promo/sponsor.webp                   HTTP 200

结果：PUBLIC_PRODUCTION_RECONCILIATION_VERIFY_PASS。这里只记录自动化构建、搜索、链接与公网内容验收；没有把它冒充成人工浏览器视觉验收。本次部署输出中的预览 URL/其他 tokenized URL 未进入仓库。

2026-09-16 Android 1.30 BTL 主基线升级

本次生产发布对应实际构建并部署的 substantive authority commit：

text

20a5ec6f625a3a5d0fc5255b5df83f7dcecb3c51

本次发布把 BTL Reference 的当前物理/corpus 主基线推进到 Android WC4 1.30.0，同时保留未重新完成 native/producer/reachability 审计的旧版本证据标签。主要新增/更新：

原版 BTL corpus 更新为 1383 个，1383/1383 按既有 v1/v2/v3 物理布局精确切分到 EOF；未观察到 v4、新 section 或 Unit/Reinforcement record-size 变化；
Unit+0x2F 获得 1.30 官方正样本并闭合为 EliteSkinIndexRaw 的字段身份：全量 133934 条 Unit 中 30 条为 1，全部位于 conquest9.btl，30/30 可按 (Army, Index) 命中 EliteSkinSettings.Index=1；
conquest9.btl 虽为 v3，但 H54=0，直接排除精英皮肤数据位于 ExtensionArea 的解释；
1.30 非空 ExtensionArea 为 415 个，415/415 按 1.30 descriptor wire 校验通过；1.29 -> 1.30 的 BattleExArgs 可达 17 message / 78 fields schema 不变，没有新增 EliteSkin Extension 字段；
Event corpus 更新为 15674 条，1.30 stock 已观察完整 ActionType 0..25；0x19/25 从 1.29 native-supported / stock=0 推进为 1.30 stock=24，24/24 的 CountryRecordId + GeneralId 结构引用与已恢复 native handler 预期一致；
Behavior、Country、Reinforcement、Terrain、Building、Header、Auxiliary fixed records、值域页与机器索引同步 1.30 可直接重扫的 corpus 事实；旧的深层 native/producer/reachability 专项仍保留明确历史版本标签；
EliteSkinIndexRaw 完整 Index 值域、非法/缺失定义行为与 writer 仍未闭合；Event 0x19 的 1.30 设备动态表现也未在本工作单元执行，因此 writer 继续 NoGo。

本地发布门禁：

text

JSON machine evidence consistency      PASS
npm run docs:check                     PASS
HTML pages                             40
references checked                     2214
missing references                     0
missing core pages                     0
missing search terms                   0
missing promo assets / markers         0
HTTP smoke                             all 200
npm run docs:audit                     PASS / 0 vulnerabilities
python tools/validate_text_format.py   PASS
python tools/validate_repository_safety.py PASS / 0 warnings
python tools/validate_build_entrypoints.py PASS
git diff --check                       PASS
npm run docs:production-check          PASS on clean substantive commit

EdgeOne production deployment：

text

Deployment ID: dp8zhxt4bhpr
Environment: production
Area: overseas
Project ID: makers-g42c5rliovy1
Result: Deploy Success

正式域名自动化 HTTPS/content 验收：

text

/                                   HTTP 200; Android 1.30.0=True; Unit+0x2F=True
/records/unit.html                  HTTP 200; EliteSkinIndexRaw=True; 133934=True; conquest9.btl=True
/extension/battle_ex_args.html      HTTP 200; 415/415=True; 1.30=True; H54=True
/records/event.html                 HTTP 200; 15674=True; 0x19=True; 24/24=True
/values/event.html                  HTTP 200; 15674=True; 0x19=True; 24/24=True

结果：PUBLIC_ANDROID_1300_BASELINE_VERIFY_PASS。这里只记录自动化构建、链接、搜索、机器索引一致性与公网 HTTP/content 验收；没有把它冒充成人工浏览器视觉验收，也没有执行 Android 设备行为验收。EdgeOne CLI 输出中的临时/tokenized URL 未写入仓库。

2026-09-16 Android 1.30 值域补完与 production-route 收敛发布

本次生产发布实际构建自 substantive authority commit：

text

1ee3cae3f93992a992d2aa21328889653869d99d

该提交建立在已上线 Android 1.30 主基线上，并补齐本轮官方 1.30 corpus 可直接证明的值域/引用事实；同时将早先由旧 administrative checkout 引起的 production-route 临时 NoGo 收敛到当前 portfolio authority。发布前 exact route、clean worktree 与 docs:production-check 三项门禁全部通过。

本轮新增的公开 Reference 事实包括：

Unit Army type/domain：官方 1.30 stock 正样本补入 ArmyTypeId=104 / AS-90 等当前可直接证明的值域；
Unit MovementRaw：补入当前 corpus 的原始值分布与代表性 stock 正样本，保持未闭合枚举继续 raw/Partial；
Reinforcement：同步 1.30 stock 新增 Army type / General 等直接引用值域；
Extension：同步 1.30 非空 Extension corpus 中新增的当前正样本值，同时维持 wire/schema 未变化以及未知枚举值不臆测命名的纪律；
既有 EliteSkinIndexRaw、Event 0x19、Behavior、Terrain、writer NoGo 等 1.30 主基线结论保持不回退。

发布前门禁：

text

portfolio exact route authority         1ee3cae3f93992a992d2aa21328889653869d99d
production branch HEAD                  1ee3cae3f93992a992d2aa21328889653869d99d
production worktree clean               PASS
npm run docs:production-check           PASS
HTML pages                              40
references checked                      2214
missing references/core/search/assets  0
local HTTP smoke                        all 200

EdgeOne production deployment：

text

Deployment ID: dpmak5oids81
Environment: production
Area: overseas
Project ID: makers-g42c5rliovy1
Result: Deploy Success

正式域名自动化 HTTPS/content 验收：

text

all existing production_baseline required pages   HTTP 200 / all markers present
/records/unit.html                                ArmyTypeId=104; AS-90; 32500; MovementRaw; 532; EliteSkinIndexRaw
/records/reinforcement.html                       ArmyTypeId=104; AS-90; 1819; 9706
/values/extension.html                            8467; 8421; 8405; 8265

结果：PUBLIC_ANDROID_1300_VALUE_DOMAIN_POLISH_VERIFY_PASS。本结论只覆盖自动化生产构建与正式域名 HTTP/content acceptance；人工浏览器视觉验收为 NotRun，Android 设备行为验收不属于本发布工作单元。EdgeOne CLI 输出中的临时/tokenized preview URL 未写入仓库。

2026-09-18 ArmyBuff / armyStats runtime 语义闭合发布

本次生产发布实际构建自 substantive authority commit：

text

3944517791b23c42507220f76bdcc884cb1db36e

该提交从既有 production baseline 以 ff-only 方式前进，并按顺序吸收 Android 1.30 ArmyBuff runtime acceptance gate、armyStats.statType 1..17 语义扩展，以及剩余 8 / 9 / 10 / 0x0C 的最终静态闭合。现网既有 Android 1.30、Fallback AI、Terrain、Event、writer foundation、许可与 promo 内容均由 production_baseline.json 门禁保护，没有从专题旧树整站覆盖生产站点。

当前 portfolio 中此前的 production-site route 已发生漂移缺失。本轮在独立治理 worktree 中恢复同一 workstream id，并由登记提交 c3f9e2837928c0d80a73966f63494e49a06b1ddc 将 exact authority 指向本次 substantive commit 3944517791b23c42507220f76bdcc884cb1db36e。未触碰并行 Animation Studio 的未提交治理改动。

本轮新增/收紧的公开 Reference 事实包括：

SArmyBuffArgs.buffId runtime identity 闭合为 ArmyBuffSettings.Id；Android 1.30 已审计 BTL load/post-load/native-save path 中未观察到额外 ArmyBuff Type/BattleMode acceptance whitelist；
BTL importer 对 lookup 成功的 armyBuffs 逐条 direct append，不套用正常 runtime add/refresh 的同 Id/同 Type 合并规则；
armyStats.statType runtime namespace 至少覆盖 1..17，并明确其属于短生命周期 keyed runtime state map，而不是基础攻击/防御/生命属性表；
statType 8 闭合到 Leclerc Division / LegendTactics Type28 recipient-local Morale +1 防重复 latch；
statType 9 闭合到 Skill173 Marshall Plan 本回合三格内击杀奖励计数，最多 3 次，每次 +40 Industry / +4 Technology；
statType 0x0C 闭合到 ArmyFeature Type153 Aerial Countermeasures 的移动/恢复生命周期计数；
statType 10 producer/owner 闭合到 Lightning Division / LegendTactics Type32 / Id10602 / Effect=20，但 exact Android 1.30 stock 未观察到 gameplay consumer，因此保留为 NoConsumerObserved，不臆测 20 的伤害/百分比公式。

发布前门禁：

text

portfolio route registration commit        c3f9e2837928c0d80a73966f63494e49a06b1ddc
portfolio exact route authority            3944517791b23c42507220f76bdcc884cb1db36e
production branch HEAD                     3944517791b23c42507220f76bdcc884cb1db36e
production worktree clean                  PASS
npm run docs:check                         PASS
npm run docs:audit                         PASS / 0 vulnerabilities
npm run docs:production-check              PASS
HTML pages                                 40
references checked                         2214
missing references/core/search/assets     0
local HTTP smoke                           all 200
python tools/validate_text_format.py       PASS
python tools/validate_repository_safety.py PASS / 0 warnings
python tools/validate_build_entrypoints.py PASS
git diff --check                           PASS

EdgeOne production deployment：

text

Deployment ID: dptnp2aqzm76
Environment: production
Area: overseas
Project ID: makers-g42c5rliovy1
Result: Deploy Success

正式域名自动化 HTTPS/content 验收：

text

production_baseline required pages         11/11 HTTP 200 / all markers present
/extension/army_ex.html                    HTTP 200; Marshall Plan; Leclerc Division; Lightning Division; NoConsumerObserved; Aerial Countermeasures
/values/extension.html                     HTTP 200; Marshall Plan; Leclerc Division; Lightning Division; NoConsumerObserved; Aerial Countermeasures
promo/qq-group.svg                         HTTP 200; SHA-256=392cdb58f65327deeb669dcd496c494b34b22b87e7d6fc917cec6ee647516cc9
promo/sponsor.webp                         HTTP 200; SHA-256=26dcdef64ace3bf884c8f1aa4ba9ffed3c07055b4ba838fdd7d26a10bcfd34f7

结果：PUBLIC_ARMY_STATS_SEMANTIC_CLOSURE_VERIFY_PASS。本结论只覆盖静态语义、生产构建、正式域名 HTTP/content 与生产资产哈希验收；人工浏览器视觉验收为 NotRun，Android 设备行为验收不属于本发布工作单元。EdgeOne CLI 输出中的临时/tokenized preview URL 未写入仓库。

6. 第三方许可

直接展示层依赖为精确固定的 VitePress 2.0.0-alpha.19，许可证为 MIT。它是预发布版本，因此升级必须单独运行完整 docs:check；当前选择该版本是为了避免 VitePress 1.6.4 稳定版依赖链中的已知 Vite dev-server 高危漏洞。精确依赖树由 package-lock.json 固定，当前 npm audit --audit-level=high 为 0 vulnerabilities。

公开分发构建产物前，应同时保留构建所包含第三方组件要求的版权和许可证通知。当前直接依赖说明见 THIRD_PARTY_NOTICES.md。

7. Reference 内容许可

btl.wc4.top 的内容许可与第三方权利边界由同目录 LICENSE.md 统一说明。除另有明确说明外，本站贡献者原创且有权许可的文档表达采用 CC BY-SA 4.0；原版 WC4 资产、第三方受保护材料、原始 APK/SO/BTL/存档/二进制材料、商标和第三方软件不因此获得 CC BY-SA 4.0 授权。

8. 交流与支持弹窗

站点主题包含一个轻量的“交流与支持”弹窗，只承担交流群入口和自愿赞赏展示，不改变 Reference 内容、许可、搜索、阅读权限或字段 authority。

当前交互契约：首次满足展示条件时在页面加载约 900 ms 后显示；直接关闭、点击遮罩、按 Escape 或点击加群入口后，当前浏览器会话不再显示。若勾选“今日不再显示”，则按浏览器本地自然日记录抑制状态，次日本地日期变化后重新允许显示。站内 SPA 路由切换不会重复显示。

BTL Reference HTML 站点构建与分发 ​

1. 定位 ​

2. 固定工具链 ​

3. 当前站点能力 ​

4. Web 分发 ​

5. 当前生产部署 ​

生产源码 authority 与防回归规则 ​

2026-09-16 production route 漂移复核与收敛 ​

2026-08-10 Event producer/lifecycle Reference 更新 ​

2026-08-10 Type5 Move Undo / save-resume lifecycle Reference 更新 ​

2026-08-10 BTL Event.ActionType namespace 紧急纠错 ​

2026-08-10 Event ActionType 全表 / Type3 reachability v2 更新 ​

2026-08-13 CC BY-SA 4.0 内容许可上线 ​

2026-08-13 交流与支持弹窗上线 ​

2026-08-16 Unit 海陆转换限制 / Event 0x09 语义纠错发布 ​

2026-09-11 Fallback AI 主行为 0~4 深度 Reference 发布 ​

2026-09-12 Terrain layered Reference v2 更新 ​

2026-09-14 Extension writer foundation Reference 更新 ​

2026-09-15 生产基线 reconciliation / Fallback AI 恢复 ​

2026-09-16 Android 1.30 BTL 主基线升级 ​

2026-09-16 Android 1.30 值域补完与 production-route 收敛发布 ​

2026-09-18 ArmyBuff / armyStats runtime 语义闭合发布 ​

6. 第三方许可 ​

7. Reference 内容许可 ​

8. 交流与支持弹窗 ​

BTL Reference HTML 站点构建与分发

1. 定位

2. 固定工具链

3. 当前站点能力

4. Web 分发

5. 当前生产部署

生产源码 authority 与防回归规则

2026-09-16 production route 漂移复核与收敛

2026-08-10 Event producer/lifecycle Reference 更新

2026-08-10 Type5 Move Undo / save-resume lifecycle Reference 更新

2026-08-10 BTL Event.ActionType namespace 紧急纠错

2026-08-10 Event ActionType 全表 / Type3 reachability v2 更新

2026-08-13 CC BY-SA 4.0 内容许可上线

2026-08-13 交流与支持弹窗上线

2026-08-16 Unit 海陆转换限制 / Event 0x09 语义纠错发布

2026-09-11 Fallback AI 主行为 0~4 深度 Reference 发布

2026-09-12 Terrain layered Reference v2 更新

2026-09-14 Extension writer foundation Reference 更新

2026-09-15 生产基线 reconciliation / Fallback AI 恢复

2026-09-16 Android 1.30 BTL 主基线升级

2026-09-16 Android 1.30 值域补完与 production-route 收敛发布

2026-09-18 ArmyBuff / armyStats runtime 语义闭合发布

6. 第三方许可

7. Reference 内容许可

8. 交流与支持弹窗