企业官网建设流程全解析

CircuitLordVRModInstaller 是一款面向 Windows 的VR Mod 一键安装器，可自动安装并保持 Big Walk VR 与 Titanfall 2 VR 两大 Mod 为最新状态，并在 VR 中一键启动游戏。当 Mod 同时提供稳定版（Stable）与Beta 版时，它支持在版本频道（Channel）之间自由切换，甚至让你用自己的自定义 ZIP 包安装测试构建。本文带你三步完成频道切换，并讲清背后的工作原理。

Stable 与 Beta：版本频道是什么？

每个 Mod 在 manifest-v3.json 中有一个"稳定版"条目，外可选的channels数组。以 Big Walk VR 为例：

两条重要规则：

• 频道仅在版本更新时显示：Beta 版本号必须高于 Stable 才会出现在下拉菜单里，Stable 一旦追平，Beta 入口自动隐藏（逻辑见 Models.cs 的AvailableChannels）。
• 频道被移除后自动回退：如果 manifest 中删掉了 Beta 频道，你的安装器会静默把你切回 Stable，不会出现"选不回去"的情况（见 MainWindow.xaml.cs）。

版本频道切换：三步完成

🎯 切换频道不需要卸载重装，全程只需点几下鼠标：

1. 打开安装器，找到对应 Mod 的卡片（Big Walk VR 或 Titanfall 2 VR）。
2. 点击安装按钮右侧的 ▾ 箭头，弹出频道菜单，通常包含：
   • Stable vX—— 副标题显示Recommended
   • Beta vX—— 副标题显示频道描述，如New features, may be unstable
3. 点击目标频道，安装器立即把选择写入本地设置（%APPDATA%\BigWalkVRInstaller\settings.json中的BigWalkChannel/Titanfall2Channel，见 AppSettings.cs），并自动刷新状态。

💡 切换后如果本地版本与新频道不匹配，按钮会直接显示Switch to beta vX，点一下就完成切换；选中的频道还会以橙色BETA小标签标记在 Mod 名称旁边（UI 定义见 MainWindow.xaml）。

用自定义 ZIP 包安装：测试构建快速上手

Titanfall 2 的频道菜单里还有一个特殊入口：Install from ZIP…（Choose a custom build），适合安装自己构建或社区分享的测试包：

1. 点击 ▾ 箭头，选择Install from ZIP…。
2. 在文件对话框中选择.zip格式的 Mod 包（过滤条件为Mod package (*.zip)|*.zip，见 MainWindow.xaml.cs）。
3. 确认提示框"Only install from sources you trust"—— 自定义包不受 manifest 的 SHA-256 校验保护，务必只安装你信任的来源。

安装完成后，版本行会显示Installed vX custom，表示当前是自定义构建。之后只要从频道菜单选任一官方版本，自定义构建就会被官方包替换掉。

⚠️ZIP 结构要求：包内目录需"镜像游戏目录结构"（PackageInstaller.cs 注释说明）。仓库里可直接参考现成的包，例如 packages/SoloLaunch/SoloLaunch-0.1.1.zip 只含Mods\SoloLaunch.dll一个文件，是最简结构的范例。

幕后原理：频道如何发布与更新（进阶）

• 发布：作者用 repotools/publish-package.ps1 发布时传入-Channel beta，包文件自动命名为BigWalkVR-beta-1.1.4.zip，并把版本号、URL、SHA-256 写入 manifest 的channels数组。脚本注释写道："channels hide in the installer once stable catches up"（Stable 追平后频道自动隐藏）。
• 下载校验：无论 Stable 还是 Beta，下载都会校验 RepoClient.cs 中的 SHA-256，保证包未被篡改。
• 本地调试：开发者可用 repotools/test-local.ps1 生成一个指向本地包、清空channels的临时 manifest，并通过CIRCUITLORD_LOCAL_MANIFEST环境变量让安装器只走 Stable 通道做联调。
• 卸载干净：每次安装都会记录写入的文件，卸载时精确删除这些文件，切换频道留下的旧文件也会被清理，不用担心"残留"。

常见问题 FAQ

Q：Beta 出问题怎么办？点击 ▾ 箭头切回Stable，按钮会提示 Switch，一键回退，校准与配置文件（preserve列表中的文件）在更新过程中会被保留。

Q：为什么菜单里没有 Beta 选项？Beta 版本号不再高于 Stable，或作者已移除该频道。此时安装到 Stable 即最新。

Q：Big Walk 也能装自定义 ZIP 吗？目前Install from ZIP仅出现在 Titanfall 2 的频道菜单中（TitanfallChannels_Click），Big Walk 菜单只有频道选项。

Q：我的频道选择存在哪里？保存在%APPDATA%\BigWalkVRInstaller\settings.json，重装或更新安装器后依然生效。

📌 一句话总结：日常使用选 Stable，想尝鲜点 Beta，测试自建构建用 Install from ZIP—— 三种形态随时可互相切换，且都不影响你本地的游戏与存档。