SuperAPI AI 工具集

test-ffi-surface

编程与开发

查看项目

更新于 10-16 02:34

技能介绍

用途:当改动主要位于 crates/ffi、生成的头文件,或 Go 与外部原生调用方使用的 ABI 行为时,使用本技能构建并测试 NeMo Relay 的 FFI 接口。实现或评审时可配合 karpathy-guidelines,保持改动范围收敛、明确假设,并在编辑前定义聚焦的验证方式。

主要能力与默认路径:以 release 模式重建 FFI crate,使共享库与头文件保持同步;运行 cargo fmt --all;运行 just test-rust;运行 cargo clippy --workspace --all-targets -- -D warnings;当导出符号或类型变化时检查生成头文件的差异;若下游消费者也变化,继续运行其绑定专用技能。

常用命令:just build-go(用 FFI 消费者使用的仓库包装器重建共享库);cargo fmt --all;just test-rust;cargo test -p nemo-relay-ffi;cargo clippy --workspace --all-targets -- -D warnings;git diff -- crates/ffi/nemo_relay.h(FFI 接口变化时检查头文件漂移)。

升级条件:若 Go 行为变化,同时使用 test-go-binding;若 FFI 变化反映共享运行时语义而非纯桥接变化,同时使用 validate-change。

参考文件:crates/ffi/Cargo.toml、crates/ffi/build.rs、crates/ffi/cbindgen.toml、crates/ffi/nemo_relay.h、just build-go、.pre-commit-config.yaml、README.md、validate-change。

限制:资料未提供具体平台、收费、价格或效果信息。