BTLX Reference

外观

BTLX Reference HTML 站点构建与分发 ​

1. 定位 ​

本目录只负责 EasyTech BTLX Reference 的 HTML 展示层。

正式 schema / corpus / native evidence authority 仍位于 shared/btlx/corpus/、shared/btlx/docs/ 与对应 recovery tools。VitePress 页面不得反向定义字段语义。

本站产品形态参考现有 btl.wc4.top，但源码与构建完全位于 EasyTech 仓库；没有 WC4 source、binary、package、runtime 或 build dependency。

2. 固定工具链 ​

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

安装依赖：

text
npm ci

生成 schema 页面：

text
npm run docs:generate

本地预览：

text
npm run docs:dev

正式静态构建：

text
npm run docs:build

focused gate：

text
npm run docs:check

联网依赖安全检查：

text
npm run docs:audit

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

3. Schema 自动生成 ​

scripts/generate_schema_pages.py 每次构建都从 canonical tracked JSON 重新生成：

  • Schema 总览；
  • EW7 3.5.0 BattleArgs 可达 message graph；
  • WS 3.2.2 BattleArgs 可达 message graph；
  • BattleArgs cross-title differences；
  • Unknown / 未闭合路径；
  • generated manifest。

因此更新 descriptor/profile 后，不需要人工同步抄写 message 字段表。

4. Web 分发 ​

默认 base 为 /，目标独立域名：

text
https://btlx.wc4.top/

若部署到子路径，可设置：

text
EASYTECH_BTLX_DOCS_BASE=/btlx/

该值必须以 / 开头并以 / 结尾。

5. 生产部署目标 ​

沿用 BTL Reference 已验证的发布形态：

text
Provider: Tencent EdgeOne Makers
Project: easytech-btlx-reference
Environment: production
Acceleration area: overseas
Source artifact: .vitepress/dist/
Public domain: btlx.wc4.top

EdgeOne 登录 token、Cloudflare API token、cookie 和临时 tokenized deployment URL 不进入仓库。

发布完成后必须额外对正式 HTTPS 域名执行 HTTP/content acceptance；部署命令成功不能替代公开域名验收。人工浏览器视觉验收仍单独记录。

6. DNS / domain ​

如果 EdgeOne 项目创建后自定义域名尚未绑定，则需要在 EdgeOne 控制台添加 btlx.wc4.top，再按平台给出的 target 在 Cloudflare DNS 创建对应 CNAME。实际 target 必须以本次新项目返回值为准，不能复用 btl.wc4.top 的旧 target。

7. 第三方许可 ​

直接展示层依赖为 VitePress 2.0.0-alpha.19，MIT。精确传递依赖由 lockfile 固定；公开分发前保留 THIRD_PARTY_NOTICES.md。