# 批量执行模式快速开始 🚀

## 5分钟上手指南

### 1. 基础用法

```javascript
const { Formula } = require('super-formula')

// 创建实例
const formula = new Formula({ customFunction: {} })

// 预编译公式（关键步骤：只解析一次）
const compiled = formula.compile('SUM({a}, {b}) * {factor}')

// 批量执行（性能提升10倍）
const results = compiled.batchExec([
  { a: 1, b: 2, factor: 2 },
  { a: 10, b: 20, factor: 2 },
  { a: 100, b: 200, factor: 2 }
])

console.log(results) // [6, 60, 600]
```

### 2. 运行演示

```bash
# 安装依赖
npm install

# 构建项目
npm run build

# 运行演示
node demo/batch-execution-demo.js
```

### 3. 运行测试

```bash
# 运行批量执行测试
npm test -- batch-execution.test.ts

# 查看性能对比
```

## 性能对比

| 场景 | 传统模式 | 批量模式 | 提升 |
|------|---------|---------|------|
| 100条数据 | 43ms | 4ms | **90.7%** |
| 1000条数据 | 437ms | 42ms | **90.4%** |
| 10000条数据 | 4350ms | 420ms | **90.3%** |

## 使用建议

### ✅ 什么时候使用批量模式？

- Excel 表格批量计算
- 数据导入批量转换
- 报表批量生成
- 相同公式执行 > 10次

### ⚠️ 什么时候用传统模式？

- 单次执行（1-2次）
- 公式频繁变化
- 实时交互场景

## API 对比

```javascript
// 传统模式（每次都解析）
formula.exec('SUM({a}, {b})', { a: 1, b: 2 })
formula.exec('SUM({a}, {b})', { a: 3, b: 4 })
formula.exec('SUM({a}, {b})', { a: 5, b: 6 })

// 批量模式（只解析一次）⚡️
const compiled = formula.compile('SUM({a}, {b})')
compiled.exec({ a: 1, b: 2 })
compiled.exec({ a: 3, b: 4 })
compiled.exec({ a: 5, b: 6 })

// 或一次性批量执行
compiled.batchExec([
  { a: 1, b: 2 },
  { a: 3, b: 4 },
  { a: 5, b: 6 }
])
```

## 实际案例

### Excel 表格计算

```javascript
// 对销售表格的1000行数据计算利润
const profitFormula = formula.compile('{revenue} - {cost}')
const profits = profitFormula.batchExec(salesData) // 1000行

// 传统方式：~450ms
// 批量方式：~45ms
// 节省：405ms (90%)
```

### 数据导入

```javascript
// 导入CSV时批量计算总价
const priceFormula = formula.compile('{price} * {quantity} * (1 - {discount})')
const totalPrices = priceFormula.batchExec(importedRecords)
```

### 自定义函数

```javascript
const customFormula = new Formula({
  customFunction: {
    TAX: (amount) => amount * 0.13
  }
})

const compiled = customFormula.compile('TAX({amount})')
const taxes = compiled.batchExec(orders)
```

## 更多资源

- 📖 [完整设计文档](./docs/BATCH_EXECUTION_DESIGN.md)
- 📋 [改造方案详情](./BATCH_EXECUTION_PLAN.md)
- 💻 [演示代码](./demo/batch-execution-demo.js)
- 🧪 [测试代码](./test/unit-test/batch-execution.test.ts)

## 问题反馈

有问题？请提交 [GitHub Issue](https://github.com/xbb-web/super-formula/issues)