#MoonODS

#先确认版本与证据

#0.5.0 发行候选源码

#从当前默认分支源码运行

python3 scripts/install-ci-sdk.py --dest "$PWD/.toolchains/ci-sdk"
export MOON_REGISTRY_API=1
export MOON_HOME="$PWD/.toolchains/ci-sdk"
export PATH="$MOON_HOME/bin:$PATH"
python3 scripts/restore_deps.py
moon update
moon test --target js
moon run examples/generate --target js

#公共 API

fn make_report() -> Bytes raise @ods.OdsError {
  let workbook = @ods.Workbook::new()
  let sheet = workbook.add_sheet("销售")
  sheet.set(0, 0, @ods.Cell::new(Text("十月销售")).styled(Header))
  sheet.merge(0, 0, 1, 2)
  sheet.set(1, 0, @ods.Cell::new(Date(2026, 10, 1)).styled(DateISO))
  sheet.set(1, 1, @ods.Cell::new(Number(399.88)).styled(Decimal2))
  sheet.set(2, 1, @ods.Cell::formula("of:=[.B2]*2", Number(799.76)))
  sheet.set_column_width(1, 45)
  workbook.to_ods()
}

#读取、修改和导出

mkdir -p /tmp/moonods-example-output
ODS_INPUT=tests/reader-fixtures/external/libreoffice-dev-types.ods \
ODS_ACCEPT_LOSS=1 ODS_SET=0,1,0,8.5 \
ODS_OUTPUT=/tmp/moonods-example-output/edited.ods \
ODS_CSV=/tmp/moonods-example-output/details.csv \
ODS_CSV_CACHE=1 ODS_CSV_REJECT_FORMULA_TEXT=1 \
moon run examples/ods_tool --target js

#采购数量修正与预算复核

mkdir -p /tmp/moonods-procurement/input /tmp/moonods-procurement/output
REPORT_OUTPUT=/tmp/moonods-procurement/input moon run examples/procurement --target js
printf '订单,数量\r\nSYN-202610-001,5\r\nSYN-202610-004,0\r\n' > /tmp/moonods-procurement/changes.csv
RECONCILE_INPUT=/tmp/moonods-procurement/input/procurement.ods \
RECONCILE_CHANGES=/tmp/moonods-procurement/changes.csv \
RECONCILE_OUTPUT=/tmp/moonods-procurement/output RECONCILE_ACCEPT_LOSS=1 \
moon run examples/reconcile --target js

#验证与范围

#边界

• 默认拒绝有损读取，需要显式接受；基础格式与扩展类型分别显式开启。
• 仅解释根 spreadsheet 数据模型。附加部件可安全解析包结构，但嵌入文档不验证 XML、不保留语义；签名丢弃且不验签。
• 保留安全路径、CRC、条目数量、4 MiB总解压、XML深度/实体预算等资源限制；超限是实现限制，不称为标准禁止。
• 支持类型、值、公式缓存、合并及有限基础格式，不承诺图片、宏、图表、全样式、加密、ZIP64或打印保真。
• 没有 Microsoft Office 互通实测；金额使用binary64，非精确十进制金融计算。
• 每个输出文件独立rename，多文件不是整体事务；业务模板只重算已知算术关系。
• ods_tool 必须同时检查退出码与 stderr：输入已接受的 stdout 不等于后续导出成功。验证/用法错误在 stdout 报 ERROR，其他 MoonBit 捕获错误报 FAILED；Node 文件系统异常在 stderr 报错并退出 1。CLI 不是逐行 JSON 协议，不能只查找 stdout 的 ERROR 判断失败。

#许可与来源

#精确物理布局（有边界）

#新布局182阶段的实际GUI互通

历史 182 阶段记录；本节不是 0.5.0 候选的再次 GUI 验证。

#Subsequent normative regression fixes

#Typed lexical normalization