🥮 mooncakes.io

    wasm-tools

    Unified WebAssembly binary toolkit for MoonBit, runnable via moonx

    wasm
    webassembly
    wat
    cli
    moonx
    Download zip
    Version
    0.1.0
    License
    Apache-2.0
    Repository
    Last updated
    yesterday
    Downloads
    20

    #wasm-tools

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

    #安装与运行

    # 已发布版本，无需安装
moonx Nanaloveyuki/wasm-tools validate app.wasm

# 或安装到 ~/.moon/bin/wasm-tools（wsm 是使用名/别名）
moon install Nanaloveyuki/wasm-tools
alias wsm=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
    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
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

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

    dump 与 metadata 目前拒绝 component 二进制，因为组件的 section id 空间与 core 不同；需要组件结构时用 print（多文档 WAT）或 component wit。

    #开发

    moon build --target wasm       # 生成 _build/wasm/debug/build/wasm-tools.wasm
moon build --target native     # 本地可执行文件
moon test                      # 单元测试（raw 层）
./tests/smoke.sh               # CLI 行为检查，读取 tests/cli.md 的场景

    ./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