rust-anything 是什么:让 Agent 分块改写 Rust 还不走样

想把一段慢代码或一整个小工具改成 Rust,难的往往不是写 Rust,而是证明改完以后行为没变。rust-anything 是一个 MIT 开源的命令行工具,同时带 MCP 服务和一份 Agent Skill:它先录下原程序在各种边界输入下的真实输出,再让 Claude Code、Codex 这类编程 Agent 一块一块写 Rust,每写完一块就拿录像逐条比对,全部对上才算完成。这篇按仓库 README、SKILL.md 和发布页整理它能做什么、怎么装、哪些情况它管不到。
它是什么
可以把它看成给「改写成 Rust」配的一条回归测试流水线,每一步都做成了 Agent 能调用的工具。原程序始终是标准答案,调用方的 API 全程不变。
| 仓库 | github.com/erkamyaman/rust-anything |
|---|---|
| 作者 | Erkam Yaman(个人项目,README 声明与 Rust 官方无关) |
| 许可证 | MIT;移植出来的代码归你 |
| 热度 | GitHub 1,908 星、139 fork(GitHub API,2026-11-18 15:15 北京时间);npm 包 11-10 至 11-16 一周下载 580 次 |
| 运行要求 | CLI 用 cargo 或 npm 装,也有 macOS/Linux/Windows 预编译包;录制时要有原语言运行时:Node 22.6+、Python 3.9+、Go 1.21+、Ruby 3+、JDK 17+,C 另需编译器 |
| 最新版本 | v1.4.0(2026-11-18 09:23 北京时间);v1.0.0 发布于 11-16 20:46 |
解决什么问题
直接让 Agent「把这个模块改成 Rust」,常见结果是能编译、看着也对,但 UTF-16 和 UTF-8 的字符串下标、正则语法、Map 的插入顺序、浮点数打印这些地方悄悄变了。rust-anything 把能自动化的部分都包了:
| 步骤 | 命令 | 做什么 |
|---|---|---|
| 找热点 | profile | 用原语言的 profiler 跑真实负载,列出热函数、调用者,提示哪些循环该整体搬 |
| 排计划 | analyze | 拆单元、排移植顺序,按 文件:行号 列风险,给出最适合先动的单元 |
| 搭桥 | bridge | 生成 Rust crate 和绑定(napi-rs、wasm、PyO3、cgo、JNI 等),留出待写的 port.rs |
| 录制 | record | 用非 ASCII、emoji、-0、NaN、溢出边界等输入跑原程序,存成 cases.jsonl |
| 比对 | diff / bench | 回放全部用例,列出不一致;再把原版和 Rust 版连同桥接开销一起计时 |
| 上线 | shadow / gate | 线上两边同跑、返回原结果、上报差异;gate 通过才算完工 |
gate 的门槛不低:fmt、clippy -D warnings、测试、unsafe 审计,原程序会报错的地方不许用 unwrap/panic! 糊过去,移植代码行数超过原版 3 倍加 50 行也直接失败。
Rust 不一定更快,它会直说
README 里的案例很坦白。作者把 x18n 核心里 29 个能原样迁移的函数全部移植,7,925 条录制用例逐条吻合,gate 全过,可 bench 显示从 JS 逐个调用这些 Rust 函数反而比原来的 TS 慢,桥接本身就比函数里那点活更贵。
真正提速的办法是把整个循环搬过去。bridge --batch 生成批处理类,数据一次性交给 Rust,之后每次调用在 Rust 里跑完全部数据。在 5 万个 key 的搜索上,每次查询从 TS 的 10 ms 降到 0.45–0.56 ms(4 核,约 18–22 倍),单线程 wasm 版 0.95 ms。同一方法用在 Python 的 slugify 上快 17 倍,Go 和 Java 只有 4 倍和 3 倍,原本就是编译型语言,单条已经很快。
Rust 由 Agent 来写;这块该不该搬、搬完还对不对,看 bench 和 diff 的结果。
怎么用
1. 安装并接入 Agent。README 给的两条命令:
cargo install rust-anything # 或 JS 项目里:npm install -g rust-anything
rust-anything setup # 写入 Claude Code、Codex、Cursor、Gemini CLI 的配置
setup 改已有文件前会在旁边存一份 .rust-anything.bak,可重复运行,setup --remove 只删自己加的条目。Claude Code 也能走插件:/plugin install rust-anything --marketplace erkamyaman/rust-anything(CLI 仍要在 PATH 里)。其他 MCP 客户端手动加一个 stdio 服务 rust-anything mcp 即可。
2. 用一句话交给 Agent。重启 Agent 后,README 建议这样说:
这个搜索很慢,用 rust-anything 做 profile,把热循环搬到 Rust。
用 rust-anything 规划把 src/parser/ 迁到 Rust,先移植第一个单元并证明行为一致。
3. 或者自己一步步跑。以 TS 里的模糊匹配函数为例:
rust-anything profile . -- node bench.mjs
rust-anything bridge . src/fuzzy.ts --batch fuzzyScore:text
# 写好 rust/fuzzy-rs 里的 port.rs 之后:
rust-anything record rust/fuzzy-rs && rust-anything build rust/fuzzy-rs
rust-anything diff rust/fuzzy-rs # 每条录制用例都要对上
rust-anything bench rust/fuzzy-rs # 看是否真的更快
rust-anything gate rust/fuzzy-rs # 通过才算完成
4. 整个应用迁移。Skill 里的 whole-app 流程先像 grill-me 那样一轮轮追问你做决定,写进 rust/DECISIONS.md(作者注明这套做法改编自 Matt Pocock 的 Skill 集);接着用 app record 从外部录下整个 CLI 或 HTTP 服务的行为,用 app front-door 让 Rust 接管入口、未移植的命令回落到原程序,逐个单元 app wire,回落率归零后 app lift 得到纯 Rust 程序。rust/MAP.md 和 HANDOFF.md 用来跨会话接力。
它管不到的地方
- 只证明录到的用例。生成的边界输入有上限,README 建议把生产样本、bug 报告、原项目测试夹具都喂进
--inputs。 - 正则最容易出事。Rust 的
regexcrate 不支持环视和反向引用,换成 fancy-regex 也可能在土耳其语无点 ı、零宽连接符上表现不同。 - 输出以外的东西不比。耗时、内存、并发压力、网络请求、数据库写入、信号都不在比对范围。
- 浮点和平台。
--float-tolerance只容忍舍入误差,不容忍格式差异;录像只证明在录制那台机器上成立,依赖硬件的 C 代码 analyze 会建议留在 C。 - 只吃源码。APK、JAR、exe 这类编译产物没法移植;Kotlin、Swift 还不支持。
适合谁,不适合谁
适合手里有一段明确的性能热点(搜索、解析、文本处理)的 Node/Python 项目,或者打算把一个小型 CLI、内部服务整体换成 Rust、又希望每一步都有用例兜底的团队。只是想让某个函数快一点、又不想引入 Rust 工具链的,先用 profile 看看瓶颈是否真在计算上。项目刚上线两天、版本迭代很快,用在正式项目前,先挑一个小模块走完 record → diff → gate 一轮。
最后
挑项目里一个纯计算、没有网络和数据库副作用的函数,跑一遍 rust-anything analyze,看它推荐的第一个单元和风险清单,再决定要不要往下走。