Excel-compatible spreadsheet formula engine in MoonBit
状态(2026-11-17,M8 完成):60 函数引擎(MoonBit)+核心引用语义(跨表 Sheet!A1、工作簿级定义名称、整列整行 A:A/2:2,ADR 0008)、native CLI、wasm-gc playground、mbtexcel 读→算→写示例(多表版);AST 缓存(热态约 2.6×)、增量重算(改一格 5×)、可选迭代计算、错误解释 API(explain + 依赖图)。真实 Excel 答案键语料 1,267/1,267(100%)(桌面 Excel 2024 · 16.0.20527.20196 · zh-CN 生成;2 条奇数参数 IFS + 3 条非法/重复定义名称被 Excel 拒绝录入,显式标为子集外;5 条超出声明子集的探针另存 corpus/excluded/ 不计分),无未归因失败:1,247 精确命中 + 3 clock-tolerance + 16 excel-precision + 1 surrogate-representation。另有 12 条 M8 语义探针(corpus/probes/)与 mbtexcel 0.3.2 的差分对照(docs/comparison-mbtexcel.md)。2026 MoonBit 年度黑客松 11 月赛参赛项目。


export PATH="$HOME/.moon/bin:$PATH"
# 全量验证:双目标构建 + 159 项单测 + 零 IO 守卫
bash scripts/check.sh
# CLI:求值一个含引用链/错误传播/循环引用的网格
moon build --target native
_build/native/debug/build/buguoshixc/mooncalc/cmd/main/main.exe eval --grid tests/fixtures/grid.json
# 跑分:真实 Excel 权威语料(默认 corpus/cases)
bash scripts/run-bench.sh
# 性能基准:进程内大网格重算(默认 1 万格,见 docs/performance.md)
moon build --target native --release
_build/native/release/build/buguoshixc/mooncalc/cmd/main/main.exe perf --cells 100000
# 浏览器 playground(wasm-gc):支持 CSV 拖拽/按钮导入(行主序,=公式格可直接算)
bash scripts/build-playground.sh
(cd playground && python3 -m http.server 8080) # 打开 http://localhost:8080/
# headless Chromium 冒烟(39 断言,零 npm 依赖)
node scripts/smoke.mjsexport PATH="$HOME/.moon/bin:$PATH"
moon run examples/xlsx-demo --target native -- gen # 生成 fixture _build/xlsx-demo/input.xlsx
moon run examples/xlsx-demo --target native -- run # 3 表读→算→写 output.xlsx,并逐表读回断言
# xlsx-demo verification PASS: 65/65 (formula + cached value + literal + expected-result checks)moon add buguoshixc/mooncalcimport {
"buguoshixc/mooncalc" @mooncalc,
}fn main {
let grid = @mooncalc.new_grid()
grid.cells["A1"] = @mooncalc.Cell::Literal(@mooncalc.Value::Num(6.0))
grid.cells["B1"] = @mooncalc.Cell::Formula("=A1*7")
// now: None 时 TODAY/NOW 按契约返回 #NUM!;需要时钟时传入 Excel 序列日。
let out = @mooncalc.recalc(grid, { now: None })
match out.cells.get("B1") {
Some(r) => println(r.value) // Num(42)
None => println("missing")
}
}| 层 | 数字 | 性质 |
|---|---|---|
| 单元/快照测试 | 159/159 | 手写期望(引擎语义回归 + codec + 语法 + bench 桶 + 限制边界 + 确定性 fuzz + 增量等价 + 迭代 + explain) |
| 过渡语料 bench | 34/34(100%) | source: manual,非权威,仅证明流程 |
| 用例规格 | 1,277 条(corpus/spec/,每函数 ≥15 + M8 refs 批 106) | 1,272 条已生成权威答案键(2 条奇数参数 IFS + 3 条非法/重复定义名称被 Excel 拒录);其中 5 条超出声明子集或属非稳态,另存 corpus/excluded/,验收分母 1,267 |
| 真实 Excel 语料 | 1,267/1,267(100%) | 桌面 Excel 为唯一裁判;1,247 match + 3 clock-tolerance + 16 excel-precision + 1 surrogate-representation,0 条未归因失败,见 corpus/reports/real.json;M8 refs 批(98 条)含跨表/名称/整列整行 |
| 族 | 函数 |
|---|---|
| 逻辑 | IF、IFS、SWITCH、AND、OR、NOT、IFERROR、XOR |
| 文本 | LEFT、RIGHT、MID、LEN、TRIM、UPPER、LOWER、CONCAT、TEXTJOIN、TEXT、VALUE、FIND、SUBSTITUTE、REPLACE、SEARCH、PROPER |
| 数学 | ROUND、ROUNDUP、ROUNDDOWN、ABS、INT、MOD、POWER、SQRT、SUM、SUMIF、SUMPRODUCT、CEILING、FLOOR |
| 统计 | AVERAGE、COUNT、COUNTA、COUNTIF、MIN、MAX、MEDIAN、STDEV、VAR、PERCENTILE |
| 查找 | VLOOKUP、XLOOKUP、HLOOKUP、INDEX、MATCH、CHOOSE |
| 日期 | DATE、EOMONTH、YEAR、MONTH、DAY、TODAY、NOW |
_build/native/debug/build/buguoshixc/mooncalc/cmd/main/main.exe bench --corpus corpus/cases --report corpus/reports/real.jsonfn eval_formula(formula : String, grid : Grid, options : EvalOptions) -> Result[EvalOutput, ParseError]fn eval_formula_iterative(formula : String, grid : Grid, options : EvalOptions, iter : IterOptions) -> Result[EvalOutput, ParseError]fn recalc_update(state : RecalcState, grid : Grid, changed : Array[String], options : EvalOptions) -> RecalcOutputfn recalc_update_report(state : RecalcState, grid : Grid, changed : Array[String], options : EvalOptions) -> (RecalcOutput, RecalcReport)fn valid_sheet_name(name : String) -> BoolInstall
Download zipExcel-compatible spreadsheet formula engine in MoonBit