# CellVerse

**Repository Path**: devgsj/cell-verse

## Basic Information

- **Project Name**: CellVerse
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# CellVerse: Guardian

基于真实蛋白质/分子机器设定的极简 3D 微观 RTS 原型。

## 项目简介

CellVerse 是一个基于 Web 的 3D 即时战略游戏，玩家控制"表达核心 Commander"，建造工厂，生产蛋白单位，在细胞微观战场中击败敌方表达核心。

**技术栈：**
- Vite + TypeScript
- Three.js
- 无后端，纯前端运行

## 游戏玩法

### 基本操作
- **WASD** - 移动相机
- **鼠标滚轮** - 缩放
- **Q/E** - 旋转视角
- **左键点击** - 选择单位
- **右键地面** - 移动单位
- **右键敌人** - 攻击目标

### 单位类型

| 单位 | 定位 | 生物学原型 |
|---|---|---|
| Expressome Commander | 指挥官/建造者 | RNA polymerase + Ribosome + Chaperone |
| Ribosome Factory | 基础工厂 | 核糖体翻译系统 |
| AMP Raider | 快速突袭单位 | 抗菌肽 |
| Ferritin Bulwark | 肉盾单位 | 铁蛋白笼 |
| Protease Cleaver | 反轻甲近战 | 蛋白酶 |
| Kinase Marker | 远程攻击单位 | 蛋白激酶 |

### 资源系统
- **Amino Acid（氨基酸）**：主要资源
- 初始：500 AA
- 被动收入：+5 AA/秒

### 生产规则
- Commander 建造 Factory：消耗 200 AA，耗时 3 秒
- Factory 生产单位：
  - AMP Raider：50 AA，2 秒
  - Ferritin Bulwark：120 AA，4 秒
  - Protease Cleaver：80 AA，3 秒
  - Kinase Marker：100 AA，3.5 秒

### 胜负条件
- **胜利**：摧毁敌方 Commander
- **失败**：玩家 Commander 被摧毁

## 安装和运行

### 安装依赖
```bash
npm install
```

### 开发模式
```bash
npm run dev
```
访问 http://localhost:3000

### 构建生产版本
```bash
npm run build
```

### 预览生产版本
```bash
npm run preview
```

## 项目结构

```
cellverse-mvp/
├── src/
│   ├── data/           # 数据定义
│   │   ├── types.ts    # 类型定义
│   │   └── unitDefs.ts # 单位属性配置
│   ├── entities/       # 实体类
│   │   ├── Entity.ts
│   │   └── Unit.ts
│   ├── game/           # 游戏系统
│   │   ├── Game.ts             # 主游戏类
│   │   ├── CameraController.ts # 相机控制
│   │   ├── InputController.ts  # 输入处理
│   │   ├── SelectionManager.ts # 选择管理
│   │   ├── ResourceManager.ts  # 资源管理
│   │   └── AIController.ts     # 敌方AI
│   ├── systems/        # 游戏系统
│   │   ├── MovementSystem.ts   # 移动系统
│   │   ├── CombatSystem.ts     # 战斗系统
│   │   └── ProductionSystem.ts # 生产系统
│   ├── ui/             # 用户界面
│   │   └── UIManager.ts
│   ├── utils/          # 工具函数
│   │   ├── math.ts
│   │   └── assetLoader.ts
│   └── main.ts         # 入口文件
├── public/
│   └── models/         # 3D模型文件（可选）
├── index.html
├── package.json
├── tsconfig.json
├── vite.config.ts
└── README.md
```

## 模型加载

游戏支持加载 GLB/GLTF 格式的 3D 模型。将模型文件放入 `public/models/` 目录：

```
public/models/
├── commander.glb
├── ribosome_factory.glb
├── amp_raider.glb
├── ferritin_bulwark.glb
├── protease_cleaver.glb
└── kinase_marker.glb
```

如果模型文件不存在或加载失败，游戏会自动使用几何体作为替代，确保游戏可正常运行。

## 开发说明

### MVP 版本特性
- ✅ 3D 场景渲染
- ✅ 单位选择、移动、攻击
- ✅ 资源管理系统
- ✅ 工厂和单位生产
- ✅ 敌方 AI
- ✅ 胜负判定
- ✅ 模型加载与回退
- ❌ 多人联机
- ❌ 复杂寻路
- ❌ 科技树
- ❌ 真实生物化学模拟

### 后续扩展方向
- 更多单位类型
- 伤害类型克制系统
- 多资源系统（ATP、GTP、离子梯度）
- 地形高度
- 阵型移动
- 多人联机

## 许可证

本项目为 MVP 原型，仅供学习和演示使用。

## 联系方式

如有问题或建议，欢迎提出 Issue。