🥮 mooncakes.io

    wasm-tools

    Unified WebAssembly binary toolkit for MoonBit, runnable via moonx

    wasm
    webassembly
    wat
    cli
    moonx
    Download zip
    Version
    0.4.2
    License
    Apache-2.0
    Repository
    Last updated
    5 hours ago
    Downloads
    20

    #wasm-tools

    MoonBit 的 WebAssembly 二进制工具箱。把 wasm_core、wasm_component、 moonrockz/wit 的能力组合成一个统一 CLI，通过 moonx 直接 运行。命令别名为 wsm。

    模块只声明 wasm target；moonx 是本工具的正式入口。

    #安装与运行

    # 无需安装，直接运行
moonx Nanaloveyuki/wasm-tools validate app.wasm

# 想要短命令，可以自己包一层
alias wsm='moonx Nanaloveyuki/wasm-tools'
wsm validate app.wasm

    #命令

    命令作用
    validate [FILE]自动识别 core module / component，解析并验证
    print [FILE]二进制转 WAT；component 按文档分段输出
    parse [FILE]WAT / component WAT 转二进制
    dump [FILE]section 表；--instructions 追加逐指令 offset，--json 输出结构化结果
    strip [FILE]删除 custom section；--keep NAME 保留指定段
    metadata [FILE]展示 name 与 producers custom section
    size [FILE]section、函数体大小与调用图；--top N、--diff FILE、--budget SIZE、--json
    opt [FILE]调用 moon-wasm-opt 优化；-O2/-Oz、--passes、--wasm-opt PATH
    symbolize [FILE] ADDR把 wasm-function[N]:0xOFF 映射到函数名与函数内偏移
    component wit [FILE]从 component 提取内嵌 WIT 包

    通用约定：

    • 输入缺省为 stdin，- 也表示 stdin；-o FILE 指定输出文件。
    • 二进制输出默认写 stdout，重定向由调用方负责（当前没有可移植的 isatty）。
    • 退出码：0 成功，1 内容非法或不支持，2 用法或 IO 错误。

    wsm parse app.wat -o app.wasm
wsm validate app.wasm
wsm print app.wasm -o app.wat
wsm dump --instructions app.wasm | head
wsm strip app.wasm --keep producers -o app.stripped.wasm
wsm metadata --json app.wasm
wsm size app.wasm --top 20
wsm size app.wasm --diff old.wasm
wsm size app.wasm --budget 200KB
wsm opt app.wasm -Oz -o app.opt.wasm
wsm symbolize app.wasm 'wasm-function[34]:0xd8d'
wsm symbolize --json app.wasm 0xd8d
cat app.wasm | wsm validate -

    #范围

    本工具只做二进制层：

    • core module 走 Milky2018/wasm_core（解析、验证、WAT 双向、编码）
    • component 走 Milky2018/wasm_component（解析、验证、WIT）
    • component → WAT 走 moonrockz/wit/decompiler
    • WIT/WAC 的 parse/format/verify 交给 moonx moonrockz/wasm-devkit
    • 优化交给工具链自带的 moon-wasm-opt；opt 只做参数映射与产物校验，不实现 pass

    不做：运行时/JIT、优化 pass、WIT/WAC 语言工具、smith/mutate/shrink、 component new/embed。设计理由见 docs/adr。

    dump/metadata 对 component 使用独立的 section id 表；size 对 component 只报告 section 明细，函数与调用图仅对 core module 有效。

    #路线

    版本内容
    0.1.0validate / print / parse / dump / strip / metadata / component wit
    0.2.0component 感知的 dump/metadata；size v1（section、函数、调用图）
    0.3.0opt（包装 moon-wasm-opt）；size --diff/--budget
    0.4.2（当前）symbolize（name section 符号化）；compose 因上游依赖阻塞

    详细设计与验收见 0004-post-0.1-roadmap。

    #开发

    moon build --target wasm       # 生成 _build/wasm/debug/build/wasm-tools.wasm
moon test                      # 单元测试
./tests/smoke.sh               # CLI 行为检查（Linux）
tests/win-smoke.sh             # Windows 侧检查（WSL interop，需 WIN_MOONRUN/WIN_WASM_OPT）

    ./run.sh 用本地 wasm 构建运行 CLI，tests/smoke.sh 依赖它。

    #结构

    main.mbt          argv 转发与退出码
cli/              参数、IO、帮助、错误（不依赖 wasm 包）
cmd/              每个子命令一个文件
wasm/             唯一的适配层：raw 扫描、core、component、dump
tests/            fixtures、cli.md 场景、smoke.sh
docs/adr/         范围、依赖与发布决策

    依赖方向为 main → cmd → wasm → 上游包。cli 可被 cmd 依赖但不得依赖 wasm；wasm 不得依赖 cmd。

    Source Files

    Powered by MoonBit

    Site sourceReport issueModulesSkillsCLIBuild queueStatistics

    © 2026 mooncakes.io