# 狸花猫红警联机平台

**Repository Path**: WuJie-byte/Dragon-Li-ra2

## Basic Information

- **Project Name**: 狸花猫红警联机平台
- **Description**: 基于 Tauri、React、NestJS 和 CnCNet Spawner 的红警2/尤里的复仇联机平台
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-18
- **Last Updated**: 2026-08-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 狸花猫联机平台

> **EA has not endorsed and does not support this product.**
>
> 本项目是非官方社区联机工具，与 Electronic Arts（EA）及其许可方无隶属、合作或授权关系。

狸花猫联机平台是一个 Windows 联机房间与本地启动管理工具，可与用户自行合法安装的《红色警戒 2》及《尤里的复仇》配合使用。当前源码版本为 `0.2.22`。

本仓库和正式安装包均不得包含、下载、修复或分发游戏本体、游戏资源、音乐、地图包及第三方启动二进制文件。产品名称和图标只使用狸花猫自有品牌；游戏名称仅用于说明兼容性。

## 项目结构

```text
apps/client/        React + Vite 前端和 Tauri Windows 桌面端
apps/server/        NestJS 房间、会话、更新和管理后台服务
packages/shared/    客户端与服务端共享协议、房间规则和类型
tools/              平台构建、更新、部署和开发辅助工具
docs/               当前状态、设计和发布检查文档
```

服务端当前使用内存保存玩家、房间、聊天和在线状态，不使用 PostgreSQL、MySQL 或 Redis；服务重启后临时状态会清空。

## 开发环境

- Windows 10/11 x64
- Node.js 20 LTS 和 npm
- Rust stable，目标 `x86_64-pc-windows-msvc`
- Visual Studio 2022 Build Tools（使用 C++ 的桌面开发）
- Microsoft Edge WebView2 Runtime
- Git

```powershell
git clone https://gitee.com/WuJie-byte/Dragon-Li-ra2.git
cd Dragon-Li-ra2
npm install
Copy-Item .env.example .env
npm test
npm run typecheck
```

启动服务端和浏览器界面：

```powershell
npm run dev:server
npm run dev:client
```

启动 Windows 桌面开发端：

```powershell
npm run dev:desktop -w @ra-platform/client
```

## 本地游戏目录

1. 用户或开发者自行通过合法渠道安装游戏。
2. 推荐将完整游戏环境放入平台程序旁的 `game` 文件夹，平台会自动识别；也可以在“设置 -> 游戏”中填写其他目录。
3. 平台不会联网下载游戏；使用包含本地修复源的私有构建时，可在“设置 -> 诊断”中恢复经过清单校验的启动组件。
4. 游戏地图缩略图在本机从用户已有文件生成，不上传到服务器，也不随平台发布。
5. 浏览器开发模式使用模拟适配器，不能启动真实游戏。

默认游戏路径是相对于平台程序的 `game` 文件夹。手动选择其他路径后，该路径只保存在当前用户的本地配置中。

## 构建

```powershell
npm test
npm run typecheck
npm run build
npm run build:desktop -w @ra-platform/client
npm run build:portable
npm run build:installer
npm run build:update
```

`build:portable`、不带额外参数的 `build:installer` 和 `build:update` 只生成平台客户端。构建检查会拒绝常见游戏文件和第三方启动组件进入便携包。自动更新也只更新平台，不修改用户选择的游戏目录。

仅在维护者已经确认相关文件的使用和再分发权限时，可为私有测试安装包提供本机修复源：

```powershell
powershell -NoProfile -ExecutionPolicy Bypass -File tools/installer/build-installer.ps1 `
  -RepairSourceGameDirectory "D:\game\Lihua-Online\game"
```

该参数会按照 `launch-components.manifest.json` 校验本机文件，并把修复脚本与修复归档加入安装包；二进制文件仍不会进入 Git 仓库。

安装器和便携包默认输出到 `outputs/public/`。公开发布时只使用该目录；`outputs/` 中其他历史产物仅供本地留档，不得对外分发。

## 协作与发布

- 不提交游戏本体、游戏资源、第三方二进制、服务器密码、管理员密钥或签名私钥。
- 第三方组件必须由用户自行合法取得；仓库只保存兼容性接口、文件名和校验元数据。
- 每项工作从 `main` 创建分支，通过 Pull Request 合并。
- 提交前运行 `npm test`、`npm run typecheck` 和相关构建。
- 每次发布必须完成 [发布合规检查](docs/RELEASE_COMPLIANCE.md)。

完整协作流程见 [CONTRIBUTING.md](CONTRIBUTING.md)，第三方说明见 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)，法律说明见 [LEGAL.md](LEGAL.md)。