← 返回博客
Ai预计阅读 9 分钟

Rune 是一个 Rust UI 框架,设计初衷是让 agent 能检查自己的工作

发布于 2026年11月15日
Rune 是一个 Rust UI 框架,设计初衷是让 agent 能检查自己的工作

Rune 是 Anomaly 出品的 Rust UI 框架。截至 2026 年 11 月 15 日有 7,199 颗星,MIT 许可,在 macOS、Windows、Linux 和 Web 上原生 GPU 渲染,自带渲染器、文本栈、布局引擎和弹簧动画。这些大多是标配。README 里有一行不是。

> 每个应用都能无头运行,因此 agent 可以渲染成 PNG、导出元素树,并用脚本化输入驱动它。

然后是:

把这个仓库交给你的 coding agent。让它从 examples/hello 和 crates/rune/README.md 开始,然后通过渲染 PNG 和检查元素树来无头检查它自己的工作。

这读起来像是某个构建工具的安装说明,只不过被记录的东西是一个用户界面。

示例是一个开关,而元数据才是有意思的部分

hello 示例是一个电灯开关。删减后:

fn view(s: &State, _: &mut Cx<State>) -> El {
    let t = tok::theme(true);
    let label = text(if s.on { "Lights on" } else { "Lights off" })
        .font(type_::TITLE).color(t.text);
    let knob = el().key("knob").size(18.0, 18.0).radius(9.0).fill(t.knob)
        .absolute(if s.on { 18.0 } else { 2.0 }, 2.0);
    let switch = el().key("switch").role("switch").label("Lights").checked(s.on)
        .focusable(true).size(38.0, 22.0).radius(11.0)
        .fill(if s.on { tok::accent(0, true) } else { t.control_off })
        .motion(motion::SNAPPY)
        .on_press(|s: &mut State| s.on = !s.on)
        .child(knob);
    col().w_full().h_full().center().gap(16.0).fill(t.bg)
        .child(label).child(switch)
}

签名是一个从状态和上下文到元素树的函数。主题通过 tok::theme(true) 处理深色,通过 tok::accent() 处理高亮,这是你传入的值而不是加载的文件。属性是类型化的、可链式调用的:.font、.color、.size、.radius、.fill、.absolute、.key、.role、.label、.checked、.focusable、.on_press。弹簧动画挂在容器上的 .motion(motion::SNAPPY) 预设里。

看看那个开关上声明了什么。.key("switch")、.role("switch")、.label("Lights")、.checked(s.on)、.focusable(true)。每一条都是无障碍元数据,放在那里是为了让屏幕阅读器能说「Lights, switch, on」,而不是「未标注的元素」。它们同时也是测试循环想要的断言:找到 key 为 switch 的节点,确认 role 是 switch,确认 checked 从 false 翻到 true,确认旋钮的绝对 x 从 2.0 移到 18.0。

我怀疑没人是在想着 agent 的情况下写 .role() 的。它来自一个事实:屏幕阅读器和语言模型需要同样的两样东西,一是树中某一部分的稳定名字,二是一个可用来比对的已声明状态。无障碍是第一个需要机器可读语义的消费者。agent 是第二个,它们免费继承了这套词汇。

PNG 是弱信号,树是强信号

截图对文本模型来说是有损通道。你可以把 PNG 喂回多模态模型,得到一个看起来对不对的答案。这个答案不可 diff,也不稳定。把按钮移动两个像素,结论可能毫无理由地翻转。把标签改成有误导性的内容,结论可能完全不变。

元素树的行为不同。它是文本,有顺序,有 key,两次 dump 之间的 diff 就是一份具体的变更清单。agent 可以像测试断言 JSON 那样对它做断言:这个 key 存在,这个 role 已设置,这个文本节点包含那个字符串。可校验的信号,才是让一个循环在没有人类介入的情况下跑多轮的东西。

问题在于,无头渲染证明像素存在,也证明树和你预期的树一致。它不证明布局读起来舒服。一个 38 乘 22 的开关,里面是 18 乘 18 的旋钮,装在 11 半径的轨道里,满足示例里的每一条断言,但在更大的字号下仍然不好看,或者在 gap 16.0 时挤到标签,或者在宽窗口里偏离中心。

agent 可以验证它造出了它想造的东西。它无法验证它想造的东西是好的。这个项目让 UI 工作中机械的那一半变得可验证,把品味那一半留在原地。

安装靠一个 git 修订号,而 Windows 需要 dlltool

Rune 是预发布版本。你不是按版本号添加它:

rune = { git = "https://github.com/anomalyco/rune", rev = "<dev rev>" }

README 说要把 rev 固定在 dev 的某个提交,并说 dev 永不被重写。在某一个很窄的意义上,这比 semver 是更强的承诺,因为 rev 不可变,昨天能构建的今天仍然能解析。在显而易见的那方面它更弱,因为没有已发布的版本,也不保证你固定的 API 和下个月的 dev 长得像。

在 Windows 上有一个具体的坑。MSVC 工具链是 rustup 的默认,只需要 Visual Studio C++ 生成工具。GNU 工具链还需要 PATH 上有 MinGW-w64 binutils,原因是有层次的:windows-link 位于 parking_lot、libloading、windows-core 和 windows-sys 之下,也就是位于每一个 Windows UI crate 之下,它用 raw-dylib 导入;rustc 在 GNU 目标上用 dlltool 构建这些导入库;而 rustup 的 rust-mingw 里的 dlltool 没有随附 as,无法运行,这就是 rust-lang/rust#140704。构建停在 windows-result,报 "error calling dlltool 'dlltool.exe': program not found"。

修复方法写在 README 里,这已经比大多数项目做得多:安装 MSYS2,运行 pacman -S mingw-w64-ucrt-x86_64-binutils,把 C:\msys64\ucrt64\bin 加到 PATH,或者传 RUSTFLAGS=-Cdlltool=C:\msys64\ucrt64\bin\dlltool.exe。底层 bug 属于 rustup 的打包,但代价落在 Rune 的第一小时,落在任何用 GNU 工具链的人身上。

不接受 pull request

摘自 README,原文照录:

> 我们不接受 pull request。让你的 agent 开一个 issue 描述 bug 或想法,我们的 agent 通常很快就能处理。

这是我读过的第一个贡献指南,一句话里关上一扇门又打开另一扇。作为关于接下来由谁写软件的陈述,它和上面的一切都对得上。如果工作流已经是 agent 驱动的,人类提交的 pull request 到达时的形状就不匹配这条流水线。用散文写的 issue 匹配。

作为关于你可能依赖的项目的赌注,它风险更高。不接受 pull request 意味着永远没有外部贡献者能把代码库熟到能成为维护者的程度。bus factor 停在第一天:坐在 Anomaly 背后的人,加上他们的 agent。而「我们的 agent 通常很快就能处理」是一个你无法从外部审计的说法。

这些都不说明这个选择是错的。它说明这是一个有代价的选择,而代价落在任何采用预发布框架、期待围绕它形成一个社区的人身上。社区围绕贡献路径形成。这一条被刻意做窄了。

这个模式比一个仓库更大

我现在会在一个部分面向 agent 的新工具里找的功能,是一张短清单:无头渲染,这样没有显示器也能检查输出;确定性的元素树,而不是不透明的 framebuffer;脚本化输入,这样循环不用鼠标也能点击;固定的修订号,这样循环能复现昨天。Rune 四个都有,并且以此为先。

这个排序才是新闻。API 仍然服务于人,因为总得有人读 view 函数并决定开关该是 38 像素宽。但塑造无头模式、元素 dump 和输入脚本的那个约束,是一个看不见的消费者。一个第一读者是循环的框架,看起来和一个第一读者是人的框架不一样。demo 文件夹说明了它走了多远:一个 coding-agent 应用、一个聊天界面、一个分栏 diff、一个液态金属效果、一个设置窗口。这就是人们现在用来写软件的工具的家具。

如果你有一个下午,可以试一件具体的事:拿那个开关示例,在 100% 和 150% 缩放下各无头渲染一次,把两棵树都 dump 出来,做 diff,数一数差异里有多少是布局、多少是文本度量。这个 diff 比星数更能告诉你 Rune 是否适合你的项目。

相关文章