air

    air —— moonair 的 moonx 命令面:wget 风格断电续传下载 + aria2 兼容 JSON-RPC 服务

    command-line
    moonx
    wasm
    aria2
    downloader
    Download zip
    Author
    Version
    0.0.15
    License
    Apache-2.0
    Last updated
    yesterday
    Downloads
    158

    #air

    air 是 MoonAir(aria2 协议核的 MoonBit 验证实现,thy1016/moonair)的 moonx 命令面:薄模块,根包即可执行, preferred_target = "wasm"。

    状态:实验性(0.x)。命令行面仍可能随反馈调整(随 CHANGELOG)。

    air 是独立实现的命令入口,不是 aria2 的官方项目、衍生版本或直接替代品; 命令行旗名按 aria2 1.36.0 --help 原文收,不凭记忆写,仅作互操作对位。

    #moonx 形

    moonx 只跑注册表预编译 wasm(经 moonrun 宿主;moonbitlang/async 在 wasm 上走 moonrun 的宿主实现,API 与 native 同一栈,非降级形)。安装 MoonBit 工具链后:

    moonx thy1016/air@latest --version moonx thy1016/air@latest -O file.bin https://example.com/file.bin moonx thy1016/air@latest --enable-rpc --rpc-secret=<token>

    #两用法(2026-11-05 拍,X-3)

    air [wget 旗] <url>... 下载(moonwget 引擎:断电续传,-c/-O/-q/-i/--save-session) air "magnet:?xt=urn:btih:…" 磁力直入(0.0.7) air --enable-rpc [旗] aria2 兼容 JSON-RPC 服务(POST /jsonrpc) --rpc-listen-port=<n> 端口 1024-65535,缺省 6800(aria2c 1.36.0 原文) --rpc-secret=<token> 令牌(params 首位 "token:<token>") --rpc-listen-all 监听全部网卡(必须带 --rpc-secret;缺省只听回环) -d, --dir=<dir> 下载根目录(缺省当前目录) --save-session=<file> 会话落档;起服时在场即自动恢复(RS2) air --help | air --version

    DHT 入网与 BT 做种旗(--enable-dht / --dht-listen-port / --dht-entry-point / --listen-port,BT 下载完成即对 swarm 做种) 自 0.0.8 起随发布面可用(moonx thy1016/air@0.0.8 …)。

    血统:命令面形状与 cli/wget(moonbit-community/cmd)同源致敬。勘定与 裁决(X-1~X-5)记于本地卷 .mingspace/air_ming.md(简明回灌卷;全卷 正本住 moonair 仓本地卷——两卷均不入仓,本节与 spec.md 携其要)。

    #包结构

    包职责入口
    thy1016/air(根)moonx 薄启动器:argv → command 库,非零码经 moonbitlang/x/sys 可移植 exitair [旗] <url>...
    thy1016/air/command两用法解析与分派;RPC 旗解析(aria2 原文对位);air_main 返退出码库(parse_air_args / air_main)
    thy1016/air/progress传输界面渲染件(air 自持,零依赖纯件):单行进度(百分数 + [===>] 棒 + 1024 进位尺寸 + 速率/ETA),后续帧 ESC[1A\r 光标上覆写(换行收口过 wasm 行缓冲闸),非 tty 退化周期整行;接线候 moonair 进度钩库(ProgressMeter::frame)
    driver/e2e.sh进程外 e2e 台:native 可执行件 + moonrun 直跑 wasm 双运行时 × 下载 / 404 退出码 / RPC 三判sh driver/e2e.sh
    driver/gate.sh一令门:物化区外 workspace + 双目标 check/test + e2e 台,判行收口sh driver/gate.sh

    #环境要求

    • MoonBit 工具链;moonx 用法另需 moonrun(moonx 自带拉取)
    • e2e 台需要 python3、curl、sha256sum
    • 依赖 thy1016/moonair(注册表在册;源码对位开发见「开发」)

    #快速开始(源码跑形)

    moon run --target native . -- -O file.bin https://example.com/file.bin moon run --target wasm . -- --enable-rpc --rpc-listen-port=6800 moonrun <wasm 产物> -- --version # moonrun 直跑 = moonx 本地对位

    #开发(依赖未发布期)

    thy1016/moonair 的最新服务面若尚未发版,叠层走仓内 moon.work (gitignore 忽略,不入仓;成员写本机绝对路径)——裸 moon check / IDE 靠爬升即得,无 env 依赖:

    # <air 仓>/moon.work(不入仓) members = [ "<air 仓绝对路径>", "<moonair 仓绝对路径>", ]

    或直接 sh driver/gate.sh(自动物化 + 全门;成员变更才落笔并清残 build——迁址假读数根因)。

    工作区模式坑:moon check 会顺手改写成员仓的 pkg.generated.mbti (检查用 --no-mbti,跑完核一次 moonair 仓 git status); moon check -p <包名> 会把包名当目录解析(传目录路径)。

    发版后删 moon.work 即回注册表解析。

    #构建与测试

    一令门(物化 workspace + 双目标 check/test + e2e 台):

    sh driver/gate.sh # 判行 AIR-GATE: PASS

    分面:

    门判
    moon check --deny-warn(native 与 wasm 双目标)0 错 0 警
    moon test -p thy1016/air/command --target native|wasm解析罐双腿
    moon test -p thy1016/air/progress --target native|wasm渲染罐 9/9 双腿(格式钉死 + 帧序列 + ANSI 形)
    sh driver/e2e.sh(N=3)判行 AIR-E2E: PASS(10 判:两运行时 × 下载 sha / 非静默进度终帧 / 404 退出码 8 / RPC 令牌门 + addUri → complete + sha)
    moon info 接口件随提交

    #当前限制

    • 0.x 实验期,命令行面不作稳定性承诺(跨 minor 可断,随 CHANGELOG)。
    • RPC 词表为 aria2 公开接口子集(现役 36 方法,以 system.listMethods 现查为准)。
    • wasm 线性内存上的大文件吞吐 / BT 多连性能未测(性能役口径:合同不变, 读数定)。

    #演进

    0.0.x 实验期;跨 minor 可断(随 CHANGELOG)。二版候拍:torrent / Metalink 输入面(BT 接 RPC 码面役之后)。

    #许可证与独立性

    本项目采用 Apache License 2.0。air 的实现与发行独立于 aria2; 旗名与协议行为仅用于描述互操作目标,不构成对任何上游项目的归属、授权 延伸或官方背书。

    Source Files