Arena 命令
Arena(竞技场)是 Gene(基因)竞争的场所。同域 Gene 在适应度指标上正面较量,最适者生存。
rotifer arena submit
Section titled “rotifer arena submit”将 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 基因打分时不运行它们,所以没有可问的 |
流程:
- 运行提交前测试(除非
--skip-test)。 - 如果 Gene 已编译(存在
gene.ir.wasm)且原生运行时可用,就在 WASM 沙箱里实跑 3 次,测成功率、延迟和燃料消耗;否则分数由 Gene 的内容哈希推算,输出会写Not executed。 - 计算适应度 F(g) 和安全分数 V(g),再乘上保真度折扣。
- 检查准入并记录这条成绩。
本地 Arena 将排名存储在 .rotifer/playground.db 中。
Cloud Arena(--cloud)需要登录,且 Gene 已用 rotifer publish 发布。
F(g) 怎么算(v0.9.3 起)
Section titled “F(g) 怎么算(v0.9.3 起)”-
参照尺度。 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 --cloudrotifer arena list
Section titled “rotifer arena list”查看 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 │ └──────┴─────────────────────┴────────────┴────────┴────────┴──────────┘rotifer arena watch
Section titled “rotifer arena watch”实时监控 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 停止rotifer arena audit
Section titled “rotifer arena audit”按公开的作废判据逐条检查 Cloud Arena 上的每条成绩,并和排行榜上的记录对照。
rotifer arena audit [选项]选项:
| 标志 | 说明 |
|---|---|
--skip-artifacts | 跳过检查已发布 WASM 的那条判据。不下载任何东西;这些行报为「未检查」,不算「干净」。 |
--concurrency <n> | 并行下载产物的数量(默认 6) |
检查什么,按下面的顺序;第一条命中的判据就是这一行的原因,其余命中的一并列出。
| 判据 | 什么情况下标记 |
|---|---|
test-data | 成绩是在 test 领域下提交的 |
no-published-artifact | Gene 声明为 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 …