# ngra 技术构想与里程碑路线图（草案）

> 当前阶段：项目尚在早期准备期（正则状态机 + CPU 线代库同步开发），  
> ngra 核心尚未正式开工，因此本文仅作为整体方向与路线规划。

---

## 1. ngra 的核心定位

ngra 是一个以 **“语法岛划分 + token 序列驱动”** 为核心的结构化前端系统，  
目标是支持多语言解析、可扩展语义分析，并最终作为跨语言编译链的一部分。

核心原则：

- 强制内置 token 集，避免不受控的字符正则扩展  
- 规则描述以 **token 序列 + 结构规则** 为主  
- 优先工程可行性与可维护性，而非极端语法自由度

---

## 2. 解析策略

### 2.1 语法岛 + 并行语义模型
- **第一阶段：语法岛划分**
  - 得到最外层符号结构（schema / entity / function / block 等）
- **第二阶段：并行语义分析**
  - 岛屿之间并行解析与语义分析  
  - 外层上下文以只读快照共享

### 2.2 宏处理策略
- 宏视为结构级符号  
- 进行“替换 → 局部重解析”  
- 避免在完整语法解析中引入宏的动态不确定性

---

## 3. 输出形式

ngra 的输出形态计划分为两级：

- **High AST**：语义节点  
- **Low-level C# AST**：可降级、可转译的中间表示  

后续可进一步扩展为 LLVM-like IR 或面向 GLSL 的特化 IR。

---

## 4. 里程碑路线图（先 EXPRESS 后 Lua）

### 里程碑 1：EXPRESS 前端（ISO 10303-11）
**目标**：解决 STEP 文件解析的关键技术依赖  
**原因**：EXPRESS 是 STEP 模型解释的核心语言，必须优先完成  

交付内容：
- EXPRESS 的 token 规则集  
- 语法岛划分策略（schema / entity / type / rule）  
- EXPRESS AST + 语义检查（最小闭环）  
- STEP 文件解析所需的语义映射基础  

---

### 里程碑 2：Lua 前端（通用前端验证）
**目标**：验证 ngra 可作为图灵完备语言前端  
**理由**：Lua 语法稳定、结构清晰，适合验证通用性  

交付内容：
- Lua 最小子集语法  
- Lua AST → Low-level C# AST  
- 最小执行闭环（不依赖外部解释器）  

---

### 里程碑 3：内部脚本系统
**目标**：将 ngra 发展为可扩展脚本前端  

交付内容：
- 统一 AST/IR 接口  
- Low-level C# 执行/编译通道  
- 标准化 token / 规则机制  

---

### 里程碑 4：C# → GLSL（GPGPU 编译链）
**目标**：将符合约束的 C# 子集转译为着色器语言  

交付内容：
- C# 可转译子集规范  
- Low-level C# → GLSL 编译器  
- GPGPU 运行时绑定支持  

---

## 5. 当前阶段说明

当前阶段尚处于准备期：

- 正则状态机仍在开发  
- 同时进行 CPU 线性代数库开发  
- ngra 核心尚未正式启动  

因此本文仅作为 **方向与路线规划**，具体实现细节将在核心启动后展开。

---

## 6. 后续可展开内容（待定）

- EXPRESS 最小语法子集  
- Lua 最小可运行语法集  
- Low-level C# AST 草图  
- C# → GLSL 子集约束清单  
- 规则 DSL 草案