RA2 Explorer

EA has not endorsed and does not support this product.

RA2 Explorer 是一个在浏览器中运行的《命令与征服：红色警戒 2 / 尤里的复仇》资产浏览器。本地版直接只读解析你电脑上的官方安装，不启动游戏 EXE，不上传素材，也不需要 Electron、WebView 或其他 UI 组件；在线版使用预先生成的只读派生资料库。

下载与使用

1. 从 Releases 下载 RA2-Explorer-Web-x64.zip。
2. 完整解压 ZIP；不要直接在压缩包里运行，也不要删除 _internal。
3. 双击 RA2 Explorer.exe。程序会在 127.0.0.1:46120 启动本地服务，并用已有的 Edge 或 Chrome 打开页面。
4. 首次打开时，选择你合法安装的《红色警戒 2 / 尤里的复仇》目录。扫描可能持续数秒，原始目录始终只读。

当前发行包面向 Windows x64。它不包含游戏文件；你需要先通过合法渠道安装游戏。安装目录识别与导入说明见 游戏文件指南。

应用可由用户主动检查更新，不会静默下载或覆盖程序。版本信息和安装包统一来自本项目的 GitHub Releases；“设置”始终显示当前应用版本。更新策略见 应用更新说明。

在线浏览

打开 GitHub Pages 精简版。无需安装或导入游戏，打开即可浏览 559 个单位和 3,322 个声音，包括单位模型、帧动画、规则关联、中英文台词、语音和音效。

在线版只包含预先生成并通过审计的派生 WebP、模型场景 JSON、Opus 声音和语义元数据，不包含游戏 EXE，也不包含 MIX、BAG、INI、CSF 等原始游戏文件。资源按当前页面和用户操作延迟加载；目录与卡片图集优先由 jsDelivr 分发，失败会自动回退到 GitHub Pages，不会在打开网页时下载整个资料库。地图、地形、原始文件导出和本机游戏目录解析仍由完整本地版提供。在线版的体积、流量和发布结构见 GitHub Pages 说明。

可以浏览什么

• 载具、航空器、步兵和建筑，以及其主体、炮塔、炮管、主体动作与建造/运行图层；武器、弹体、战斗部和残骸保留为规则依赖，不把孤立效果冒充为完整战斗动画；
• 单位语音、EVA 播报、按战役关卡与事件组织的任务对白、多人通讯、环境与战斗音效，并关联实际规则事件和中英文文本；
• VXL/HVA 三维模型、SHP 多帧动画、地图、地形、PCX、调色板、规则和本地化文本；
• 默认 grid 与双列 list、单位和声音共用的全局搜索、简繁中文与英文模糊匹配、中文与拼音混合输入、全拼/拼音首字母补全，以及独立搜索结果页；
• 按规则归属筛选盟军、苏军、尤里和无阵营对象；卡片主体按游戏玩家色显示盟军蓝、苏军红和尤里紫，归属文字也使用对应颜色，中立或共用资产保持原色；
• 游戏建造栏顺序、可叠加的可建造优先、独立详情窗口、可调布局、帧步进和浏览位置记忆；
• 单位动画按主体、建造和运行语义在同一页分组；分层建筑以全部可见主体图层共同取景，避免核弹发射井、心灵控制塔等预览偏移或截断；
• 原始资产导出，以及按需生成的 PNG、WAV、模型 JSON 和视频预览。

所有派生结果都进入应用目录下的 .runtime\RA2MD-Ext，不会改写游戏安装。普通浏览直接读取 MIX 区段，不再复制每个读过的原始成员。

“设置”集中提供显示与载入偏好、原版目录解析、.ra2pack 导入/导出和用户可选的更新检查。卡片、声音和模型缓存由应用自动调度：Pages 将同类单位缩略图合并为单个 WebP 图集，本地版则在进入分类后持续预取并复用缩略图；声音列表会在空闲时预取即将播放的条目，并由单一播放器无缝切换；交互式模型只预测当前单位附近的少量项目，并使用有界缓存。用户不需要管理性能实现，也不会在启动时一次载入约数百 MiB 派生数据。已生成的索引、关联和浏览器预览可以导出为不含原始游戏文件的 .ra2pack，用于备份和迁移；格式边界见 派生资源包说明。

统一搜索只保留可勾选的“单位 / 声音”目标，按 Ctrl+K 可从任意页面直接聚焦。关键词和补全在单位、语音、音效页面间保持一致，单位建议显示缩略图，声音建议按语音与音效区分图标和颜色；点击结果会切换到所属分类并把对应卡片滚动到视图中央。空输入时可查看、逐项删除或清空本机保存的搜索历史与最近访问。当前浏览分类只提高相关结果的排序权重，不会形成隐藏过滤条件。按回车或点击“搜索”会进入完整结果页，再按单位类型、阵营、声音类型与用途筛选结果；集合上方的浏览筛选仍只作用于正常浏览列表。

下载与磁盘占用

当前 Windows x64 本地包解压后约 56 MiB，ZIP 约 34 MiB。首次导入直接关联本机游戏目录，不会再复制数百 MiB 的 MIX，因此普通用户只需下载发行 ZIP。

Pages 精简资料解包后约 140.0 MiB，固定数据 ZIP 约 76.8 MiB，但浏览器不会下载 ZIP 或在启动时读取整站。单位页只先请求约 471 KiB 的当前语言单位目录和当前分类的一张缩略图图集，不再为侧栏计数提前读取完整声音目录，也不会为几十张卡片分别承担网络往返。高频数据包解包约 7.0 MiB，浏览器仍只通过 CDN 读取其中实际需要的单个文件。模型、详情和声音继续按操作加载；完整遍历全部内容时流量才可能接近整站体积。

预览、可播放音频和模型会按需缓存在本机。可用 CLI 查看或清理可再生成的缓存：

ra2exp.exe cache stats
ra2exp.exe cache prune

cache prune 默认只删除与 MIX 重复的显式解包副本，保留索引、图片预览、模型、转码音频和视频。发行模式、实际体积和构建方式见 发行与体积说明。

本机构建

已下载的 ra2exp.exe 可以为同一台电脑预建完整索引，但仍不复制游戏数据：

ra2exp.exe package --game-dir "D:\Games\RA2" --output "D:\RA2 Explorer Local"

这个 linked 构建会记录本机绝对路径，只适合当前电脑，不应分享。只有在你确认拥有相应再分发权限并确实需要可移动素材包时，才显式增加 --include-game-data；程序仍会排除游戏 EXE、DLL、脚本与驱动。

隐私与安全

• 服务只监听本机回环地址，不开放局域网访问；
• 浏览与搜索不会把游戏文件、路径或派生结果上传到第三方；
• Windows Release 不含游戏资产、本机路径、开发缓存、Playwright 或 FFmpeg；
• 提交前钩子和 CI 会扫描令牌、私钥、个人路径、邮箱及其他常见泄露。

安全边界、误报处理和报告方式见 隐私说明。

开发

源码搭建、测试、后台服务、CLI 与发布命令已移至 开发指南；文档索引 汇总了架构、发行、隐私与游戏源输入说明。

许可证

RA2 Explorer 源代码采用 MIT License。该许可证只适用于本项目代码，不授予 Electronic Arts、Westwood 或其他权利人的游戏文件、名称、图像、音频及其他素材的权利。

RA2 Explorer 与 Electronic Arts 或其许可方没有隶属关系。游戏内容的使用与再分发仍须遵守适用法律、平台条款和你实际取得的授权。