# EcoGenesis

**Repository Path**: xiaoluoGame/eco-genesis

## Basic Information

- **Project Name**: EcoGenesis
- **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-06
- **Last Updated**: 2026-05-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# EcoGenesis

> 2D 进化人工生命模拟平台 — 从冷启动逐步涌现复杂的捕食、协作、通讯与生态稳定性。

详细设计文档见 [docs/](docs/) 目录(00–18 共 19 篇专题 + 根目录 `设计文档.md` / `设想计划.md`)。
开发计划保存在会话记忆 `/memories/session/plan.md` 中,按里程碑 M0–M13 推进。

---

## 仓库结构

```
.
├── apps/
│   └── web/                # Vite + React + TS 应用壳(Phase 2)
├── packages/
│   ├── schemas/            # 共享数据 Schema(TS + Rust 镜像 + JSON Schema)
│   │   └── rust/           # Rust 镜像 crate(workspace 成员)
│   └── ui/                 # 共享 UI 原语(Phase 2 起填充)
├── crates/
│   ├── ecogenesis-core/    # 模拟核心:World / Tick / RNG 子流 / EventBus
│   ├── physics-port/       # 物理引擎 trait(Phase 6 接入 Rapier2D)
│   ├── wasm-bindings/      # 浏览器 Worker 用的 WASM 绑定
│   └── ecogenesis-cli/     # 长时训练后台进程(`ecogenesis` 二进制)
├── tools/                  # 代码生成 / 校验 / 夹具
├── docs/                   # 设计文档
├── Cargo.toml              # Rust workspace
├── package.json            # pnpm workspace 根
└── pnpm-workspace.yaml
```

## 关键架构决策

1. **纯 Web 前端**(不引入 Tauri/Electron)。
2. **双进程分工**:浏览器 WASM Worker 仅作调试 / 单步 / 小规模交互;长时间训练交给 `ecogenesis-cli` (Rust native) 在本地后台跑,产物落到项目目录文件,Web 通过共享 Schema 读取。
3. **物理**:单押 Rapier2D。
4. **身体创建拆三段**:预制模板(11a)/ 随机变体生成(11b)/ 人工结构编辑器(11c)。
5. **大地图节奏**:严格 M7 → M8 → M9 串行。

## 前置工具

- Node.js ≥ 18.17(已验证 18.17.0)
- pnpm ≥ 9.0(全局安装:`npm i -g pnpm@9.12.0`)
- Rust 1.78(`rustup`,后续 Phase 4+ 需要;Phase 0 不强制)
- 推荐:`wasm32-unknown-unknown` target(`rustup target add wasm32-unknown-unknown`)

## 常用命令

```pwsh
# JS 侧
pnpm install
pnpm dev               # 启动 Web 应用(端口 5173)
pnpm build             # 构建所有 JS 包
pnpm typecheck
pnpm format

# Rust 侧(需要本地安装 Rust 工具链)
pnpm rust:build
pnpm rust:test
pnpm rust:fmt
pnpm rust:lint
```

## 当前进度

- [x] Phase 0 — 仓库与工具链初始化
- [ ] Phase 1 — Schema 包与版本治理
- [ ] Phase 2 — 前端应用壳
- [ ] Phase 3 — 数据服务层

完整路线图见 plan(M0–M13),共约 40 个 Phase + Research 分支。