项目2026-11-18 · 智涌AI

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

rust-anything 项目头图:左侧大字「rust-anything 分块改写 Rust」与钩子「先录原程序行为,每条用例对上才算完」,三张数据卡为 1,908 GitHub 星、6 种语言、MIT 开源许可;右侧终端示意 setup 接入编程 Agent,再依次运行 profile、bridge、record、diff、gate 命令

想把一段慢代码或一整个小工具改成 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 用来跨会话接力。

它管不到的地方

适合谁,不适合谁

适合手里有一段明确的性能热点(搜索、解析、文本处理)的 Node/Python 项目,或者打算把一个小型 CLI、内部服务整体换成 Rust、又希望每一步都有用例兜底的团队。只是想让某个函数快一点、又不想引入 Rust 工具链的,先用 profile 看看瓶颈是否真在计算上。项目刚上线两天、版本迭代很快,用在正式项目前,先挑一个小模块走完 record → diff → gate 一轮。

最后

挑项目里一个纯计算、没有网络和数据库副作用的函数,跑一遍 rust-anything analyze,看它推荐的第一个单元和风险清单,再决定要不要往下走。

关注公众号「智涌AI速递」

每天的 AI 快讯、实用教程和 AI项目实测,也会同步发到微信公众号。在微信里搜索「智涌AI速递」就能关注;不用微信的话,可以用 RSS 订阅本站。