# CGA.js 项目架构全景报告

> 生成时间：2026-06-11  
> 覆盖范围：rulepackage.com 全站及所有子站点  
> 分析重点：架构、核心解析器、未来 3D 世界发展规划

---

## 目录

1. [项目架构全景](#一项目架构全景)
2. [所有子站点功能](#二所有子站点功能)
3. [后端 API 架构](#三后端-api-架构)
4. [前端架构](#四前端架构)
5. [引擎核心解析器](#五引擎核心解析器)
6. [NL2CGA AI 生成管道](#六nl2cga-ai-生成管道)
7. [未来发展规划：3D 世界的程序与生成](#七未来发展规划3d-世界的程序与生成)

---

## 一、项目架构全景

```
┌─────────────────────────────────────────────────────────────────────────────┐
│                              用户浏览器层                                      │
│  ┌────────────┐  ┌────────────┐  ┌────────────┐  ┌────────────┐            │
│  │  主站 IDE   │  │ Marketplace│  │  API 文档   │  │  图床 CDN   │            │
│  │ rulepackage │  │ marketplace│  │  apihand   │  │    pic     │            │
│  │   .com     │  │.rulepackage│  │.rulepackage│  │.rulepackage│            │
│  └─────┬──────┘  └─────┬──────┘  └─────┬──────┘  └─────┬──────┘            │
└────────┼───────────────┼───────────────┼───────────────┼────────────────────┘
         │               │               │               │
         ▼               ▼               ▼               ▼
┌─────────────────────────────────────────────────────────────────────────────┐
│                              Nginx 接入层                                      │
│         SSL 终结 / 静态资源 / 反向代理 / 跨域 CORS / 速率限制                    │
│         Let's Encrypt 通配符证书：*.rulepackage.com                           │
└─────────────────────────────────────────────────────────────────────────────┘
         │
         ▼
┌─────────────────────────────────────────────────────────────────────────────┐
│                              FastAPI 服务层 (:8010)                           │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐    │
│  │   编译服务    │  │  NL2CGA 服务  │  │ Marketplace  │  │   认证计费    │    │
│  │  /compile    │  │ /nl2cga/*    │  │ /marketplace │  │ /auth /pay   │    │
│  │  /parse      │  │ /generate    │  │ /feed        │  │ /quota       │    │
│  │  /validate   │  │ /fix         │  │ /download    │  │ /keys        │    │
│  └──────┬───────┘  └──────┬───────┘  └──────┬───────┘  └──────┬───────┘    │
└─────────┼─────────────────┼─────────────────┼─────────────────┼────────────┘
          │                 │                 │                 │
          ▼                 ▼                 ▼                 ▼
┌─────────────────────────────────────────────────────────────────────────────┐
│                              引擎执行层                                        │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐    │
│  │ ProcessPool  │  │  Node.js     │  │   Node.js    │  │   Node.js    │    │
│  │  4 Workers   │──│ Worker #1    │  │ Worker #2    │  │  ...         │    │
│  │ (production) │  │              │  │              │  │              │    │
│  └──────────────┘  └──────────────┘  └──────────────┘  └──────────────┘    │
│  ┌──────────────┐                                                            │
│  │ 2 Workers    │──│ Worker #Beta (dist/)                                    │
│  │ (beta)       │                                                            │
│  └──────────────┘                                                            │
└─────────────────────────────────────────────────────────────────────────────┘
          │
          ▼
┌─────────────────────────────────────────────────────────────────────────────┐
│                              数据层                                            │
│  ┌──────────────────┐  ┌──────────────────┐  ┌──────────────────┐          │
│  │   PostgreSQL     │  │   本地文件系统    │  │    OSS (阿里云)   │          │
│  │   (主数据库)      │  │   (引擎源码/dist) │  │   (Marketplace   │          │
│  │   SQLAlchemy     │  │   Nginx 配置     │  │    文件存储)      │          │
│  └──────────────────┘  └──────────────────┘  └──────────────────┘          │
└─────────────────────────────────────────────────────────────────────────────┘
```

---

## 二、所有子站点功能

| # | 子域名 | 根目录 | 功能定位 | 技术栈 |
|---|--------|--------|----------|--------|
| 1 | **rulepackage.com** / **www.rulepackage.com** | `/www/wwwroot/www.rulepackage.com/` | 主站：IDE、首页、文档、认证、支付、管理后台 | 纯静态 HTML + Vanilla JS + Three.js + CodeMirror |
| 2 | **api.rulepackage.com** | `/www/wwwroot/api.cgajs.com/` | API 网关：FastAPI 文档、NL2CGA 代理 | FastAPI (Python) |
| 3 | **apihand.rulepackage.com** | `/www/wwwroot/apihand.cgajs.com/` | API 参考手册静态站点 | 纯静态 |
| 4 | **marketplace.rulepackage.com** | `/www/wwwroot/marketplace.cgajs.com/` | CGA 资源交易商城 | Vue 前端 + FastAPI 后端 |
| 5 | **pic.rulepackage.com** | `/www/wwwroot/pic.cgajs.com/` | 图床/素材站：纹理、预览图 CDN | 纯静态 (Nginx alias) |

**关键发现：**
- `nl2cga.rulepackage.com` **没有独立站点**，NL2CGA 通过 `api.rulepackage.com/nl2cga/` 反向代理到本地 `:8020`
- 所有站点共享 `.rulepackage.com` Cookie (`cgajs_token`) 实现跨子域认证
- 同时维护 `cgajs.com` 和 `rulepackage.com` 两套品牌域名体系

### 主站页面清单 (www.rulepackage.com)

| 页面 | 功能 |
|------|------|
| `index.html` | 首页：项目介绍、功能特性、统计展示 |
| `ide.html` | **CGA IDE 核心**：编辑器 + 3D预览 + AI生成 + 市场 |
| `nl2cga.html` | NL2CGA 展示：92种建筑风格库浏览 |
| `auth.html` | 登录/注册：邮箱/用户名/密码 + OAuth |
| `profile.html` | 用户中心：API Key、用量统计、订阅状态 |
| `billing.html` | 计费支付：微信/支付宝、套餐选择 |
| `admin.html` | 管理后台：仪表盘、用户管理、系统配置 |
| `admin-monitor.html` | 实时监控：QPS、编译成功率、资源监控 |
| `study.html` | 学习文档：引擎架构分层设计说明 |
| `ku.html` + `ku/` | **知识库**：200+ 函数/操作独立文档页 |
| `roadmap.html` | 项目路线图 |
| `plugin.html` | 插件下载页（SketchUp/Blender/Unity/Unreal等） |
| `updata.html` | 更新日志 |
| `wenti.html` | 常见问题 |

---

## 三、后端 API 架构

### 3.1 核心路由文件

| 文件 | 前缀 | 功能 |
|------|------|------|
| `main.py` | `/api/v1/` | 编译/解析/验证/认证/支付/NL2CGA/用量统计 |
| `admin_routes.py` | `/api/v1/admin/` | 仪表盘/服务器状态/LLM状态/用户管理/自动循环 |
| `marketplace_routes.py` | `/api/v1/marketplace/` | CGA文件上传下载/购买/审核/OSS存储 |
| `learning_routes.py` | `/api/v1/learning/` | 失败案例管理/AI建议审核/自动测试队列 |
| `version_routes.py` | `/api/v1/versions/` | 引擎版本管理/Beta构建/灰度发布/回滚 |
| `function_test_routes.py` | `/api/v1/admin/function-tests/` | 函数契约测试/覆盖率追踪 |
| `oauth_routes.py` | `/api/v1/oauth/` | GitHub/微信 OAuth 登录 |
| `nl2cga_service.py` | 被 main.py 调用 | NL2CGA核心：生成/优化/修复/解释/诊断 |

### 3.2 数据库关键表

| 表名 | 用途 |
|------|------|
| `users` | 用户账户（邮箱、密码、订阅等级、余额、配额） |
| `api_keys` | API Key 管理 |
| `payments` | 支付订单（微信/支付宝） |
| `usage_logs` | 调用日志（端点、状态、费用、响应时间） |
| `cga_files` | Marketplace 资源（标题、价格、作者、OSS Key） |
| `cga_failure_cases` | 编译失败案例（错误类型、根因、频率） |
| `cga_success_cases` | 编译成功案例（训练数据来源） |
| `ai_suggestions` | AI 生成的修复建议 |
| `function_repair_logs` | 函数修复历史记录 |
| `nl2cga_human_fixes` | 人类修正数据（RLHF 训练数据） |
| `auto_loop_profiles/runs` | 自动循环任务配置与执行历史 |

---

## 四、前端架构

- **无现代前端框架**（React/Vue 仅在 Marketplace 子站使用）
- **技术栈**：纯 HTML + Vanilla JS + CSS
- **编辑器**：CodeMirror 5.65.16（自定义 CGA 语法高亮 + 自动补全）
- **3D 渲染**：Three.js 0.164.1（WebGL）
- **引擎加载**：ES Module Import Map → `/cgajs-engine/dist/index.js`
- **构建产物**：Vite 打包生成 `/assets/` 目录

---

## 五、引擎核心解析器

### 5.1 解析器 (Parser)

**ANTLR4 语法文件**：`grammar/CGAGrammar.g4`（380 行）

```
CGA Source → ANTLR4 Lexer → ANTLR4 Parser → Parse Tree
                                               ↓
                                       ASTBuilder (visitors/)
                                               ↓
                                         Typed AST
                                               ↓
                                    Preprocessing:
                                    - CityEngine 语法兼容
                                    - 裸随机分支规范化
```

**AST 节点类型**（`src/parser/ast/types.ts`，379 行）：
- 声明层：`CGAScript`, `AttrDecl`, `FuncDecl`, `RuleDef`
- 规则体层：`OperationSequence`, `ConditionalBody`, `StochasticBody`
- 操作层：`SimpleOperation`, `CompOperation`, `SplitOperation`, `BlockOperation`
- 表达式层：`LiteralExpr`, `BinaryExpr`, `UnaryExpr`, `CallExpr`, `ArrayExpr`

### 5.2 求值器 (Evaluator)

**核心文件**：`src/runtime/evaluator.ts`（1813 行）

```typescript
interface EvalContext {
  script: CGAScript;           // 当前脚本 AST
  shapes: Shape[];             // 生成的形状列表
  seed: number;                // 随机种子
  maxDepth: number;            // 最大递归深度（默认 100）
  currentDepth: number;        // 当前递归深度
  globals: Map<string, CGAValue>;   // 全局常量/属性/枚举
  userFuncs: Map<string, FuncDecl>; // 用户自定义函数
  random: DeterministicRandom; // 确定性随机发生器（xorshift）
  traceLog?: Array<{...}>;     // 性能追踪日志
}
```

**60+ Shape 操作分类**：

| 类别 | 操作 | 复杂度 |
|------|------|--------|
| 几何创建 | `extrude`, `primitiveCube/Sphere/Cylinder/Cone/Disk/Quad` | 中 |
| 变换 | `s/t/r`, `rotateScope`, `translate`, `scale`, `mirror`, `center` | 低 |
| 屋顶 | `roofGable/Hip/Pyramid/Ridge/Shed/Radial/Dutch/Gambrel/HalfHip/Round` | **高** |
| 材质/纹理 | `color`, `texture`, `setMaterial` | 低 |
| UV | `setupProjection`, `projectUV`, `rotateUV`, `scaleUV`, `tileUV` | 中 |
| 分割/组件 | `split`, `comp`, `setback`, `setbackPerEdge`, `innerRectangle` | **高** |
| 布尔 | `union`, `subtract`, `intersect` | **高**（当前为简化实现） |
| 其他 | `tag`, `print`, `assert`, `flatten`, `insert`, `scatter` | 中 |

### 5.3 内置函数 (163+)

**插件化架构**（13 个插件目录）：

| 插件 | 函数数 | 代表函数 |
|------|--------|---------|
| `math` | ~33 | `abs`, `sin`, `cos`, `pow`, `clamp`, `rand` |
| `string` | ~20 | `strlen`, `splitString`, `replace`, `format` |
| `array` | 17 | `size`, `findFirst`, `sort`, `transpose` |
| `color` | 15 | `colorHSVToHex`, `rgb`, `colorRamp` |
| `list` | 16 | `listAdd`, `listClean`, `listRandom` |
| `file` | 10 | `fileSearch`, `readFloatTable` |
| `context` | 6 | `inside`, `overlaps`, `touches` |
| `asset` | 16 | `assetInfo`, `imageInfo`, `assetFitSize` |
| `misc` | ~20 | `convert`, `geometry.area`, `geometry.volume` |

### 5.4 几何引擎

**Shape 数据结构**：
```typescript
interface Shape {
  id: string;
  geometry: PolygonData | BufferGeometry;
  scope: Scope;                // 位置/旋转/缩放 + 轴向量
  pivot: Matrix4;
  attributes: Map<string, CGAValue>;
  tags: Set<string>;
  material: MaterialState;     // PBR 材质全字段
  children: Shape[];
  projections: Map<number, UVProjection>;
}
```

**关键几何模块**：
- **Boolean CSG**（`geometry/operations/boolean/csg.ts`，349 行）：简化版布尔运算，`union` 做顶点焊接，`subtract` 基于 BBox 测试，`intersect` 使用 Sutherland-Hodgman 裁剪
- **Comp 面提取**（`geometry/operations/split/comp-face.ts`，684 行）：`mergeCoplanarFaces` 贪心合并共面三角形，`computeMergedFaceScope` 计算局部坐标系，`compHoles` 提取孔洞
- **Split 操作**（`geometry/operations/split/advanced-split.ts`，727 行）：多边形偏移、沿周长行走分割、L/U/O 型构造
- **Roof 系列**（`geometry/operations/create/roof.ts`，943 行）：11 种屋顶，支持 `byAngle`/`byHeight` 双模式

### 5.5 渲染器集成

**Scene Builder**（`src/renderer/scene-builder.ts`，274 行）：
- 按材质 Key 分组 → 合并同材质几何 → 大幅减少 Draw Call
- Three.js `MeshStandardMaterial` + `TextureLoader`（LRU 缓存上限 50）
- GLB 导出：自定义 GLTF 2.0 JSON 组装器

### 5.6 与 CityEngine 对比

| 维度 | CGA.js | CityEngine 2025.1 | 覆盖率 |
|------|--------|-------------------|--------|
| 解析操作 | 94 个 | ~200+ | ~45% |
| 内置函数 | 163 个 | ~150+ | ~100% |
| 核心建筑生成 | 齐全 | 齐全 | **70~80%** |
| 资产插入 | 简化 | 完整 | ~30% |
| 高级几何修改 | 简化 | 完整 | ~25% |

---

## 六、NL2CGA AI 生成管道

### 6.1 三层生成架构

```
┌─────────────────────────────────────────────────────────────┐
│  Tier 1: 预建模板匹配 (Prebuilt Templates)                   │
│  ── 11个常见建筑类型，0轮LLM调用，精度100%                   │
├─────────────────────────────────────────────────────────────┤
│  Tier 2: 参数化模板引擎 (Parameterized Template Engine)      │
│  ── 10个中国古建模板（太和殿/天安门/六角亭等），100ms生成    │
├─────────────────────────────────────────────────────────────┤
│  Tier 3: LLM 辅助生成 (Knowledge-Augmented LLM)              │
│  ── 意图识别 → 知识检索 → RAG增强 → Prompt组装 → LLM生成   │
└─────────────────────────────────────────────────────────────┘
```

### 6.2 意图识别器 (5 类意图)

| 意图 | 触发条件 | 处理路径 |
|------|---------|---------|
| `ENTITY` | 太和殿、角楼、千秋亭等 8 个建筑实体 | 检索建筑实体库 |
| `PATTERN` | 斗拱、柱网、重檐、歇山顶等 | 检索 CGA 模式模板 |
| `FIX` | "报错"、"修复"、"error"、"fix" | 错误修复模式 |
| `EXPLAIN` | "解释"、"怎么用"、"是什么" | 代码解释模式 |
| `GENERIC` | 未匹配上述任何规则 | 通用 LLM 生成 |

### 6.3 知识库三层

1. **建筑实体库** (`building-entities.json`)：8 个中国宫殿建筑的详细参数
2. **CGA 模式库** (`chinese-palace-patterns.json`)：斗拱、柱网、屋顶等代码模板
3. **RAG 向量索引** (`rag_index.json`)：333 个社区 CGA 文件，关键词 + 向量混合检索

### 6.4 编译验证闭环

```
生成 → 编译验证 → 失败 → 自动修复（10条规则）→ 再验证
                    ↓ 通过
              返回结果 → 沉淀到 CgaSuccessCase
```

### 6.5 数据飞轮

```
用户输入 ──→ 生成代码 ──→ 编译
                            │
                    ┌───────┴───────┐
                    ▼               ▼
              编译成功          编译失败
                    │               │
                    ▼               ▼
            CgaSuccessCase    CgaFailureCase
                                    │
                                    ▼
                            AI分析 (batch-analyze)
                                    │
                            ┌───────┴───────┐
                            ▼               ▼
                        采纳(adopt)      拒绝(reject)
                            │
                            ▼
                    更新 EngineVersion
                            │
                            ▼
                    训练数据沉淀 ──→ LoRA微调 ──→ 更好的模型
```

### 6.6 LLM 多提供商故障转移

**优先级链**：Kimi Code → Kimi Platform → DeepSeek → SiliconFlow → Qwen → OpenAI

**智能冷却策略**：Auth(30min) / RateLimit(5min) / Timeout(2min) / Network(1min) / API(30s)

---

## 七、未来发展规划：3D 世界的程序与生成

### 7.1 愿景

> **让程序化的力量重塑三维世界** —— 从单体建筑到完整城市，从静态模型到动态生态系统，CGA.js 不仅是 CityEngine 的开源替代，更是面向未来"生成式 3D"时代的核心基础设施。

### 7.2 近期目标（2026 Q3）：夯实基础

#### 7.2.1 引擎稳定性攻坚

| 优先级 | 任务 | 说明 |
|--------|------|------|
| **P0** | 替换 Boolean CSG | 引入 `three-bvh-csg` 或 `manifold` 实现真正的网格布尔运算 |
| **P0** | 完善 Split 非 Box 裁剪 | 实现基于几何包围盒的局部坐标裁剪 |
| **P0** | 修复 `instance` 操作 | 在 scene-builder 中检测同材质+同几何，使用 `THREE.InstancedMesh` |
| **P1** | 异步纹理预加载 | 引擎层面支持异步材质预加载，避免首次渲染无纹理 |
| **P1** | 错误恢复模式 | 增加 `errorMode: 'lenient'` 配置，异常时降级而非崩溃 |

#### 7.2.2 模板引擎扩展

- 将参数化模板从 10 个扩展到 **50 个**，覆盖全球主要建筑风格
- 实现 **AST 直接组装**（跳过文本 parse 阶段），速度提升 10 倍
- 建立 **构件库**（柱/梁/窗/门/屋顶），支持组合式生成

#### 7.2.3 IDE 体验优化

- **实时预览**：`requestAnimationFrame` 循环 + `Stats.js` FPS 监控
- **相机控制器**：OrbitControls + FlyControls 双模式
- **多视口**：顶视图/前视图/侧视图 + 3D 透视图
- **撤销重做**：完整的编辑历史栈

### 7.3 中期目标（2026 Q4~2027 Q1）：城市级生成

#### 7.3.1 LOD 系统实现

```
Lod0 (极远鸟瞰):  ~4.7万面  → 方块柱 + 纯色屋顶
Lod1 (城市级):    ~14万面  → 6面柱 + 贴图瓦片
Lod2 (街区级):    ~75万面  → 10面柱 + 简化瓦片
Lod3 (特写级):   ~146万面 → 16面柱 + 完整瓦片 + 斗拱
```

- **CGA 层 LOD 控制**：`@Enum("Lod0","Lod1","Lod2","Lod3") attr lodstep`
- **几何简化**：顶点合并比例、法线平滑、纹理合并
- **距离裁剪**：根据相机距离自动切换 LOD 级别

#### 7.3.2 城市布局生成

```
道路网络 ──→ 地块划分 ──→ 建筑生成 ──→ 植被/设施填充
    │           │            │              │
    ▼           ▼            ▼              ▼
 L-System    Voronoi      CGA Rules     Scatter
 道路生长    地块细分     单体建筑      随机分布
```

- **道路网络**：L-System 生长 + 主干道/次干道/支路分级
- **地块划分**：Voronoi 图 + 用地类型（住宅/商业/工业/绿化）
- **建筑生成**：根据用地类型自动选择 CGA 规则模板
- **植被填充**：Scatter 操作 + 气候带植被库

#### 7.3.3 生态系统集成

- **地形生成**：Perlin Noise / Simplex Noise 地形 + CGA 地形适配
- **水体系统**：河流/湖泊/海洋，支持水面反射和波浪动画
- **天气系统**：晴/雨/雪/雾，影响光照和材质
- **时间系统**：昼夜循环、四季变化、建筑灯光自动开关

#### 7.3.4 资产管道

- **Import 跨文件支持**：引擎层实现 `import` 加载器，支持模块化 CGA 开发
- **外部模型插入**：OBJ/GLB/FBX 格式导入，与 CGA 生成几何融合
- **材质库**：PBR 材质预设库（混凝土/砖/木/金属/玻璃/石材）
- **纹理图集**：自动打包纹理为图集，减少 Draw Call

### 7.4 远期目标（2027 Q2~Q4）：智能世界

#### 7.4.1 多智能体城市模拟

```
┌─────────────────────────────────────────────┐
│              城市模拟引擎                      │
│  ┌─────────┐  ┌─────────┐  ┌─────────┐    │
│  │ 居民Agent│  │ 车辆Agent│  │ 建筑Agent│    │
│  │ (行为树) │  │ (路径规划)│  │ (能耗/寿命)│   │
│  └────┬────┘  └────┬────┘  └────┬────┘    │
│       └─────────────┴─────────────┘         │
│                   │                         │
│                   ▼                         │
│         ┌─────────────────┐                 │
│         │   城市状态机     │                 │
│         │ (时间×空间×事件) │                 │
│         └─────────────────┘                 │
│                   │                         │
│                   ▼                         │
│         ┌─────────────────┐                 │
│         │   CGA 动态更新   │                 │
│         │ (建筑老化/新建)  │                 │
│         └─────────────────┘                 │
└─────────────────────────────────────────────┘
```

- **居民 Agent**：基于行为树（工作/居住/购物/娱乐），驱动建筑使用模式
- **交通 Agent**：A* 路径规划 + 流量模拟，影响道路设计
- **建筑 Agent**：能耗/寿命/维护状态，驱动城市更新
- **事件系统**：自然灾害、政策变化、经济波动，影响城市演化

#### 7.4.2 神经辐射场 (NeRF) 融合

- **照片到 3D**：用户上传建筑照片 → NeRF 重建 → 自动提取 CGA 规则参数
- **风格迁移**：将实景建筑照片风格迁移到 CGA 生成模型
- **虚实融合**：NeRF 实景背景 + CGA 程序化前景

#### 7.4.3 元宇宙集成

- **WebXR 支持**：VR/AR 模式下沉浸式浏览生成场景
- **实时协作**：多用户同时编辑同一场景，WebSocket 同步
- **区块链资产**：CGA 规则作为 NFT，交易市场支持版权追踪
- **数字孪生**：对接 IoT 传感器数据，实时更新建筑状态

#### 7.4.4 自进化引擎

```
┌─────────────────────────────────────────────┐
│           自进化引擎架构                       │
│                                             │
│  编译失败 ──→ AI分析 ──→ 生成修复 ──→ 验证   │
│      │                                     │
│      ▼                                     │
│  训练数据沉淀 ──→ LoRA微调 ──→ 模型更新     │
│      │                                     │
│      ▼                                     │
│  新模型部署 ──→ A/B测试 ──→ 成功率提升      │
│      │                                     │
│      └────────→ 更多编译失败 ──→ 循环迭代    │
│                                             │
│  最终目标：无人干预的引擎自动进化              │
└─────────────────────────────────────────────┘
```

- **自动函数补全**：LLM 根据需求描述自动生成缺失的 CGA 函数实现
- **语法自动扩展**：新语法需求 → ANTLR4 规则生成 → Visitor 实现 → 测试用例生成
- **性能自动优化**：编译结果自动分析瓶颈 → 生成优化建议 → 自动应用

### 7.5 技术路线图

| 阶段 | 时间 | 核心目标 | 里程碑 |
|------|------|---------|--------|
| **Phase 1** | 2026 Q3 | 引擎稳定 + 模板扩展 | Boolean CSG 替换、50个模板、AST组装 |
| **Phase 2** | 2026 Q4 | 城市级生成 | LOD系统、道路网络、地块划分、植被填充 |
| **Phase 3** | 2027 Q1 | 智能模拟 | 多智能体、地形/水体/天气、资产管道 |
| **Phase 4** | 2027 Q2 | AI融合 | NeRF重建、风格迁移、自进化引擎 |
| **Phase 5** | 2027 Q3~Q4 | 元宇宙 | WebXR、实时协作、数字孪生、区块链 |

### 7.6 关键技术指标

| 指标 | 当前 | Phase 1 | Phase 2 | Phase 3 | Phase 5 |
|------|------|---------|---------|---------|---------|
| 编译成功率 | ~85% | **>95%** | >95% | >95% | >98% |
| 生成延迟 | 3~5s | **<500ms** | <1s | <1s | <500ms |
| 场景规模 | 单体建筑 | 单体建筑 | **城市街区** | **完整城市** | 元宇宙城市 |
| 三角面数 | ~50万 | ~100万 | **~500万** | **~1000万** | ~5000万 |
| FPS (WebGL) | ~30 | ~60 | ~30 | ~30 | ~60 (WebGPU) |
| 自动化程度 | 人工驱动 | 半自动 | **自动** | **智能** | **自治** |

---

## 八、总结

CGA.js 已经从一个简单的 CGA 语法解析器，成长为包含完整 IDE、AI 生成引擎、Marketplace、学习闭环的**程序化 3D 建模平台**。其核心优势在于：

1. **完整的 CGA 解释器**：从 ANTLR4 解析到 Three.js 渲染，全链路自研可控
2. **AI 驱动的生成管道**：三层 fallback（模板→参数化→LLM），确保响应速度和精度
3. **数据飞轮**：编译失败自动记录 → AI 分析 → 修复 → 训练数据沉淀 → 模型进化
4. **中国古建专精**：太和殿、角楼、千秋亭等参数化模板，全球首创

未来，CGA.js 将沿着"单体建筑 → 城市街区 → 完整城市 → 智能世界 → 元宇宙"的路径演进，成为**生成式 3D 时代的核心基础设施**。