math-formula-calculator

# 数学公式计算专家

## 🎯 核心功能

### 1️⃣ Excel 公式解析

**支持的函数**:
- 逻辑函数：IF, AND, OR, NOT, IFERROR
- 数学函数：MAX, MIN, ROUND, ABS, SUM, AVERAGE
- 比较运算：>, <, >=, <=, =, <>

**解析能力**:
- 识别外层/中间层/内层函数
- 识别变量与常量
- 识别运算符优先级

---

### 2️⃣ 分步计算

**计算流程**:
```
第 1 步：公式原文抄录 → 不修改任何字符
第 2 步：公式结构拆解 → 识别函数层级
第 3 步：变量代入 → 明确每个变量的值
第 4 步：由内向外计算 → 先计算最内层函数
第 5 步：记录中间结果 → 每步保留计算过程
第 6 步：最终结果 → 四舍五入 (如需)
```

**示例**:
```excel
=ROUND(IF(B2<E2,MAX(0,F2-ABS(B2-E2)/E2*100*0.6),IF(B2=E2,F2,MAX(0,F2-ABS(B2-E2)/E2*100*0.9))),2)

变量:
B2 = 207 (报价)
E2 = 176.89445 (基准价)
F2 = 30 (基准分)

计算步骤:
1. B2 < E2? → 207 < 176.89445? → FALSE
2. 进入 ELSE 分支：MAX(0, F2-ABS(B2-E2)/E2*100*0.9)
3. ABS(B2-E2) = ABS(207-176.89445) = 30.10555
4. ABS(...)/E2 = 30.10555/176.89445 = 0.1702
5. ...*100 = 0.1702*100 = 17.02
6. ...*0.9 = 17.02*0.9 = 15.32
7. F2-... = 30-15.32 = 14.68
8. MAX(0, 14.68) = 14.68
9. ROUND(14.68, 2) = 14.68

结果：14.68 分
```

---

### 3️⃣ 边界验证

**验证项目**:
- ✅ 除零检查：分母是否为 0
- ✅ 负数检查：结果是否可能为负
- ✅ 溢出检查：结果是否超出合理范围
- ✅ 临界值测试：测试边界条件

**验证流程**:
```
1. 识别公式中所有分母 → 检查是否为 0 风险
2. 识别 MAX/MIN 函数 → 确认边界处理
3. 代入极端值测试 → 最大值/最小值/临界值
4. 检查结果合理性 → 是否在预期范围内
```

---

### 4️⃣ 招投标价格分计算

**支持的评标方法**:
- 综合评分法
- 最低评标价法
- 竞争性谈判

**价格分公式模板**:

```excel
' 基准价法 (报价>基准价)
=30-ABS(报价 - 基准价)/基准价*100*0.9

' 基准价法 (报价<基准价)
=30-ABS(报价 - 基准价)/基准价*100*0.6

' 完整版 (含边界处理)
=MAX(0,30-ABS(报价 - 基准价)/基准价*100*系数)
```

---

## 🔧 使用方式

### 场景 1: Excel 公式解析

```
用户：解析这个公式 =ROUND(IF(B2<E2,MAX(0,F2-ABS(B2-E2)/E2*100*0.6),...),2)

数学公式计算专家:
1. 外层函数：ROUND(..., 2) → 保留 2 位小数
2. 中间函数：IF(条件，真值，假值)
3. 条件：B2 < E2
4. 真...

# 🧮 Math Formula Calculator

**Version**: 1.0.0  
**Author**: 小竟（OpenClaw）  
**License**: MIT  
**Category**: Tools / Calculation

---

## 📋 Description

专业数学公式计算工具，支持 Excel 公式解析、分步计算、边界验证。

适用于招投标价格分计算、工程预算、财务分析等场景。

---

## ✨ Features

### 核心功能

1. **Excel 公式解析**
   - 支持 IF/ROUND/MAX/MIN/ABS 等常用函数
   - 支持嵌套函数解析
   - 支持条件逻辑处理

2. **分步计算**
   - 由内向外逐步计算
   - 记录每步中间结果
   - 便于验证和调试

3. **边界验证**
   - 除零检查
   - 负数检查
   - 溢出检查

4. **结果校验**
   - 合理性验证
   - 趋势分析
   - 对比验证

---

## 🎯 Use Cases

### 场景 1：招投标价格分计算

```excel
=ROUND(IF(报价<基准价，MAX(0,30-ABS(报价 - 基准价)/基准价*100*0.6),
   IF(报价=基准价，30,MAX(0,30-ABS(报价 - 基准价)/基准价*100*0.9))),2)
```

**计算步骤**：
1. 判断报价与基准价关系
2. 计算差额比例
3. 应用扣分系数（低价 0.6，高价 0.9）
4. 确保结果不为负（MAX(0,...)）
5. 四舍五入保留 2 位小数

---

### 场景 2：工程预算计算

```excel
=SUM(材料费 + 人工费 + 管理费) * (1 + 利润率)
```

---

### 场景 3：财务分析

```excel
=IF(ROE>15%, "优秀", IF(ROE>10%, "良好", "一般"))
```

---

## 🔧 Installation

### 方式 1：ClawHub 安装（推荐）

```bash
npx clawhub@latest install math-formula-calculator
```

### 方式 2：手动安装

```bash
git clone https://github.com/YOUR_USERNAME/math-formula-calculator.git
cp -r math-formula-calculator ~/.openclaw/workspace/skills/
```

---

## 📖 Usage

### 基本用法

```
用户："计算这个公式：=ROUND(IF(A1<B1,MAX(0,30-ABS(A1-B1)/B1*100*0.6),30),2)，A1=200, B1=220"

Math Formula Calculator:
📊 公式解析

外层函数：ROUND(..., 2)
中间层：IF 条件判断
内层：MAX(0, 30-ABS(差额)/B1*100*0.6)

📝 分步计算

步骤 1: 判断条件 A1<B1
  200 < 220 → TRUE

步骤 2: 计算差额
  ABS(200-220) = 20

步骤 3: 计算差额比例
  20/220*100 = 9.09

步骤 4: 应用扣分系数
  9.09*0.6 = 5.45

步骤 5: 计算得分
  30-5.45 = 24.55

步骤 6: 边界验证
  MAX(0, 24.55) = 24.55 ✅

步骤 7: 四舍五入
  ROUND(24.55, 2) = 24.55...