# E-Language 算子清单 (API)

全部算子提炼自 `projects/elang/` 实际代码。分四组：CRUD 语义算子、数据/分析算子、导出算子、自举/元算子。

## 1. 空间声明算子

### `space<维度>("描述")`
开辟高维张量语义空间。维度决定后续所有张量的形状。
```e
Ω = space<256>("Analytics and Web Dashboard Core");
```

## 2. CRUD 语义算子（`elang_crud_system.py`，四算子流形真实语义）

### `create("意图")`
**增**——流形锚定（MANIFOLD_ANCHOR）。生成归一化随机张量，锚定新状态。
```e
state_A = Ω | create("System Initialized");
// ✨ [CREATE] 变量 'state_A' 已创建，语义: 'System Initialized'，张量范数: 1.00
```

### `update("增量意图")`
**改**——流形演化（MANIFOLD_EVOLVE）。基向量加扰动后重归一化。
```e
state_B = state_A | update("User logged in");
// 🔄 [UPDATE] 变量 'state_B' 已更新，附加语义: 'User logged in'
```

### `read()`
**查**——流形坍缩检索（MANIFOLD_COLLAPSE）。输出当前状态系统签名 Σ。
```e
query_result = state_B | read();
// 🔍 [READ] 检索 'state_B'，当前状态系统签名 (Sum): 0.3500
```

### `delete()`
**删**——拓扑剪枝（MANIFOLD_PRUNE）。目标状态张量归零。
```e
state_final = state_B | delete();
// ❌ [DELETE] 变量 'state_final' 已从流形空间中抹除，范数归零。
```

## 3. 数据分析算子（`elang_transpiler.py` 转译执行）

### `load_csv_metrics("文件.csv")`
载入指标数据流。当前实现降级为 `np.random.randn(50).cumsum()` 模拟数据流（接口保留，可替换为真实 CSV 读取）。
```e
data_stream = Ω | load_csv_metrics("performance_data.csv");
```

### `compute_manifold_stats()`
流形统计计算。当前转译为数据流 ×1.2 变换。
```e
stats = data_stream | compute_manifold_stats();
```

## 4. 导出算子（真产物落盘）

### `generate_matplotlib_chart("输出.png")`
matplotlib 绘制流形演化曲线，**真实 PNG 落盘**。
```e
chart_asset = data_stream | generate_matplotlib_chart("manifold_trend.png");
// ✨ 产物: manifold_trend.png (28705 字节)
```

### `export_html_dashboard("输出.html")`
生成暗色系静态 Web 看板（内嵌图表引用），**真实 HTML 落盘**。
```e
web_output = chart_asset | export_html_dashboard("index.html");
// ✨ 产物: index.html
```

## 5. 热修补进化算子（`elang_self_patch.py`）

### `tensor_fuse("融合意图")`
高维流形融合。**初始编译器白名单不含此算子**——首次出现即触发编译器自我热修补（改写 `compiler_core.e` 白名单并热重载），随后执行 `fused = base×1.5 + sin(base)` 归一化。
```e
state_v2 = state_v1 | tensor_fuse("Cross-Attention State Fusion");
// ⚠️ [进化触发] 检测到未知的语言算子 → 热修补 → 🔥 [DYNAMIC TENSOR_FUSE] 融合完成
```

## 6. 自举/元算子（`elang_build_all.py` / `elangc_v2.py` 语法域）

Style-C 编译前端原生语法，用于零起点与意图编译：

| 算子 | 语义 |
|------|------|
| `project("意图")` | 意图投影，映射到流形吸引子（MAP_TO_MANIFOLD_ATTRACTOR） |
| `autowrap(1e-4)` | 设定收敛容差 |
| `resolve()` | 执行自同构演化直到不动点锁定 |
| `INTENT` / `DIMENSION` / `EPSILON` / `STEPS` | 关键字（elangc_v2 AST 前端） |

```e
Ω = space<1536>("Autonomous AI Core");
Ψ = Ω | project("Initialize Semantic Manifold") | autowrap(1e-4) | resolve();
```

## 7. Agent 调用接口（`elang_agent_tool.py`）

```python
from elang_agent_tool import EpsilonAgentInterface
agent = EpsilonAgentInterface(workspace_dir=".")
agent.compile_intent("my_task", 'Ω = space<128>("Demo"); s = Ω | create("hi");')
# 写入 my_task.e → 编译为 my_task.elc 产物
agent.execute_artifact("my_task.elc")
```

## 错误语义

未知算子在转译器中**硬失败**（非静默跳过）：
```
RuntimeError: transpile fail: unknown operator -> Ω | load_data_source(...)
```
该硬失败是演化闭环的故障信号源。