跳转到内容

Arena 命令

Arena(竞技场)是 Gene(基因)竞争的场所。同域 Gene 在适应度指标上正面较量,最适者生存。

将 Gene 提交到 Arena 参与竞争排名。

终端窗口
rotifer arena submit <gene-name> [选项]

参数:

参数必填说明
gene-name是要提交的 Gene 名称

选项:

标志说明
--cloud提交到 Cloud Arena(需要登录)
--skip-test跳过提交前的测试
--allow-credentials <list>允许外来基因使用你环境变量里的这些凭证,每个只发往对应的 host:KEY@api.example.com,KEY2@other.example.com。目前不起作用:只有 Hybrid 基因能声明凭证,而 arena submit 给 Hybrid 基因打分时不运行它们,所以没有可问的

流程:

  1. 运行提交前测试(除非 --skip-test)。
  2. 如果 Gene 已编译(存在 gene.ir.wasm)且原生运行时可用,就在 WASM 沙箱里实跑 3 次,测成功率、延迟和燃料消耗;否则分数由 Gene 的内容哈希推算,输出会写 Not executed。
  3. 计算适应度 F(g) 和安全分数 V(g),再乘上保真度折扣。
  4. 检查准入并记录这条成绩。

本地 Arena 将排名存储在 .rotifer/playground.db 中。
Cloud Arena(--cloud)需要登录,且 Gene 已用 rotifer publish 发布。

  • 参照尺度。 F(g) 里的延迟项和成本项,拿来对比的是同一领域、同一保真度的 Gene 在本赛季的中位数。每位作者的 Gene 只算一次(取最新发布的版本),只算作者本人记录的运行,已作废的成绩不计入。

  • 退回常数。 本赛季这样的 Gene 至少有 5 个实测过,才用中位数;不足 5 个,或连不上注册表时,改用固定常数(延迟 1000 ms、成本 10,000 燃料)。输出总会写明用的是哪种:

    Reference scale: season <N> median of <n> <domain> / <fidelity> genes (L_ref <ms> ms, Cost_ref <fuel> fuel)
    Reference scale: fixed constants — too few measured <domain> / <fidelity> genes this season for a median
  • 仍是估计值。 F(g) 的两项输入(效用、鲁棒性)还是占位值,所以每条成绩都记为 estimated,不进排行榜排名。在此期间,适应度门槛 τ 暂停执行(待按归一值域 [0, 1] 重新标定),不拦提交,只由 V(g) ≥ 0.7 决定准入,输出写 Admission: PASSED (V(g) only)。

  • 实测记录会上传。 加 --cloud 时,每次运行的实测记录(结果、输出 schema 校验、延迟、燃料)会上传到公开的运行账本,即使分数本身是估计值;不加 --cloud 则只留在本机。

  • 再次提交会更新。 同一个 Gene 再提交一次,更新的是它原来那条 Arena 记录,不会多出第二条。

示例:

终端窗口
# 本地 Arena,已编译的 Gene
$ rotifer arena submit genesis-web-search
ℹ Running pre-submission tests...
✓ Pre-submission tests passed
ℹ Executing gene in WASM sandbox...
ℹ Reference scale: fixed constants — too few measured search / Native genes this season for a median
✓ Sandbox execution: 3/3 passed (avg 473.7ms)
✓ Gene 'genesis-web-search' submitted to Arena
Domain: search
Fidelity: Native
F(g): 0.0037 (× 1.00 native discount)
V(g): 1.0000
Admission: PASSED (V(g) only)
Execution: Sandbox verified (3 runs)
Recorded as: estimated
# Cloud Arena(需要登录;同时上传实测记录)
$ rotifer arena submit my-search --cloud

查看 Arena 排名,支持按域过滤。

终端窗口
rotifer arena list [选项]

选项:

标志说明
-d, --domain <域>按功能域过滤
--cloud显示 Cloud Arena 排名

输出列:

  • # — 域内排名
  • Name — Gene 名称
  • Domain — 功能域
  • F(g) — 适应度分数(0.0–1.0)
  • V(g) — 安全分数(0.0–1.0)
  • Fidelity — Native / Wrapped / Hybrid
  • Creator — 发布者(仅 Cloud)

示例:

终端窗口
$ rotifer arena list
┌──────┬─────────────────────┬────────────┬────────┬────────┬──────────┐
│ # │ Name │ Domain │ F(g) │ V(g) │ Fidelity │
├──────┼─────────────────────┼────────────┼────────┼────────┼──────────┤
│ 1 │ genesis-web-search │ search.web │ 0.9200 │ 0.9500 │ Native │
│ 2 │ my-search │ search.web │ 0.8234 │ 0.9100 │ Wrapped │
│ 3 │ genesis-search-lite │ search.web │ 0.7100 │ 0.8900 │ Native │
└──────┴─────────────────────┴────────────┴────────┴────────┴──────────┘

实时监控 Arena 排名变化。

终端窗口
rotifer arena watch <域> [选项]

参数:

参数必填说明
域是要监控的域

选项:

标志说明
--cloud监控 Cloud Arena(轮询模式)
--interval <毫秒>轮询间隔(默认 3000)

示例:

终端窗口
$ rotifer arena watch search.web
正在监控 search.web 排名...
[14:32:01] 排名变化:my-search ↑ #3 → #2(F: 0.82 → 0.85)
[14:32:04] 新进入:fast-search 排名 #4
[14:32:07] 无变化
按 Ctrl+C 停止

按公开的作废判据逐条检查 Cloud Arena 上的每条成绩,并和排行榜上的记录对照。

终端窗口
rotifer arena audit [选项]

选项:

标志说明
--skip-artifacts跳过检查已发布 WASM 的那条判据。不下载任何东西;这些行报为「未检查」,不算「干净」。
--concurrency <n>并行下载产物的数量(默认 6)

检查什么,按下面的顺序;第一条命中的判据就是这一行的原因,其余命中的一并列出。

判据什么情况下标记
test-data成绩是在 test 领域下提交的
no-published-artifactGene 声明为 Native,却没有已发布的 WASM
async-express-artifact已发布的 WASM 里有异步的 express()

它还会报告漂移,也就是判据和排行榜对不上的地方:

漂移含义
missing判据标记了,排行榜还没标(作废任务跑过之前属于正常)
unreproducible排行榜标了作废,但没有哪条判据能复现:判据过时,或被手工改过
reason-mismatch双方都认为该作废,但原因不同

所有输入都是公开的,任何人跑都能得到同样的结果,不需要登录。判据全文见 arena-invalidation-criteria.md。

只有读不到 Arena 时退出码才是 1;有被标记的行或有漂移都不改变退出码。加 --json 得到机器可读的输出。

示例:

终端窗口
$ rotifer arena audit --skip-artifacts
Arena invalidation audit
──────────────────────────
Rows: 110
Flagged: 29
Clean: 45
Unchecked: 36
2 test-data
27 no-published-artifact
0 async-express-artifact
Flagged rows
no-published-artifact <gene-name>
genes.fidelity = Native, genes.wasm_size = 0, genes.wasm_path = null
…