AB
AiBoss
project

rust-anything - 逐块把现有应用重写成 Rust,并用录制回放验证行为一致

rust-anything 是一个面向渐进式 Rust 迁移的工具:先录制现有 Node.js/TypeScript、Python、C、Go、Ruby、Java 应用的行为,再让编码代理或开发者逐块写出 Rust 实现,并用录制用例逐条比对。项目由 erkamyaman 维护,MIT 许可,截至 2026-11-18 星标 2595。

rust-anything 是一个帮助开发者把已有应用逐步迁移到 Rust 的工具。它不负责翻译代码,而是负责提供迁移过程中编码代理难以自行判断的信息:时间花在哪里、先移植哪一块、如何让原有调用方在不改 API 的情况下调用 Rust、移植结果必须匹配哪些行为,以及什么时候可以判定这一块移植完成。据项目自述,它面向 Node.js(TypeScript/JavaScript)、Python、C、Go、Ruby、Java 编写的 CLI、HTTP 服务与库,PHP 与 C# 处于预览阶段。适合希望保留现有系统可运行状态、同时把热点路径或整个应用逐步换成 Rust 的团队与个人开发者。

维护者与状态

项目由 erkamyaman 维护,仓库创建于 2026-11-16,最后提交时间为 2026-11-18。最新 release 为 v1.5.1,发布于 2026-11-18。截至 2026-11-18,仓库星标数为 2595。项目在 npm 上以 rust-anything 包名发布。

主要能力

以下能力描述来自项目 README,属于项目自述,未经本站独立验证。

  • 行为录制与回放比对:据项目说明,record 会用边界用例以及用户自带的输入运行原实现,保存其返回值或抛出的异常;diff 则把每一条录制用例在 Rust 实现上重放,全部一致之前不进入发布环节。
  • 性能剖析定位热点:profile 步骤在对应语言的剖析器下运行真实负载(如 node、cProfile、go test pprof、JFR、Ruby tracer),给出按 inclusive time 排序的热点函数、调用方以及适合批处理的循环,并会标记已经编译过的代码(如 numba、Cython、JAX),提示这些位置改用 Rust 收益有限。
  • 迁移规划:analyze 输出待移植单元、移植顺序、带 file:line 的风险点、每个单元对应的桥接方式与依赖关系。
  • 桥接层生成:bridge 为不同语言生成调用 Rust 的桥接代码,README 中列出的方式包括 TypeScript/JavaScript 的 napi-rs 或 wasm-bindgen、Python 的 PyO3(abi3)、C 的 extern "C" 函数与头文件、Go 的 cgo 调用、Ruby 的 magnus 扩展、Java 的 JNI 包装类。
  • 批量调用模式:除 C 以外的语言支持 --batch,数据一次性跨语言边界后留在 Rust 中,每次调用在所有核心上批量执行。
  • 整应用迁移框架:据 README,analyze --whole-app、app record、app front-door、app wire、app lift 组成一条链路,让 Rust 从入口点接管,逐单元推进并跟踪回退率。
  • 与编码代理集成:setup 会为 Claude Code、Codex、Cursor、Gemini CLI 注册 MCP 服务器并安装工作流 skill,其他 MCP 客户端可手动把 rust-anything mcp 添加为 stdio 服务器。

README 中给出的性能数字(例如某 TypeScript 侧边栏搜索从每次查询 10 ms 降到 0.5 ms)均为项目自述,并称每个数字在 demo/ 目录下都有先校验结果一致的基准测试;本站未复现这些数据。

使用入口

仓库地址:erkamyaman/rust-anything;npm 包页面:rust-anything。

据项目说明,安装与初始化方式如下:

cargo install rust-anything
rust-anything setup

setup 会把 MCP 服务器写入各代理的配置文件,并安装 skill;重复执行是安全的,--remove 可撤销。JavaScript 项目也可以用 npm install -g rust-anything 安装同一份二进制。README 还提到,没有 Rust 工具链的用户可以使用每个 GitHub release 附带的 macOS、Linux、Windows 预编译二进制。

典型的手动流程为:

rust-anything profile . -- node bench.mjs
rust-anything bridge . src/fuzzy.ts --batch fuzzyScore:text
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

许可与限制

项目采用 MIT 许可证。

据 README 说明,需要注意的边界包括:rust-anything 本身不翻译代码,Rust 实现由编码代理或开发者编写;它只能发现录制用例覆盖到的问题,README 专门用「What it can't catch」一节说明这一局限;PHP 与 C# 仍处于预览阶段,目前支持整应用的录制、回放与 Rust 前置入口,但通过 FFI 或 P/Invoke 移植具体单元尚未完成;README 还声明该项目为独立项目,与 Rust Project 及 Rust Foundation 无隶属或背书关系。