SuperAPI AI 工具集

rust

编程与开发

查看项目

更新于 10-16 03:39

技能介绍

用途:这是一份 Rust 工程指南,面向需要处理文件数据、外部进程集成与跨语言边界的可靠系统开发。核心原则是默认保守:来自文件、子进程和外部系统的输入均视为不可信,优先避免误报、保证同输入同输出(确定性),并避免因坏输入在用户机器上 panic。

主要能力:强调规范模型所有权,当 Rust 作为事实来源时,区分内部领域模型(表达性枚举与丰富类型)、FFI DTO(扁平稳定、以 String 为主)、文件格式(带版本、可往返)与外部输入(严格校验、绝不信任)四层。全部模式仅使用安全 Rust,不依赖 unsafe,通过生态 crate 提供安全抽象。

使用方式:按领域加载对应参考文档,包括数据建模(Serde、UniFFI、强类型、版本化 schema)、文件 I/O(原子写入、并发控制、文件监听)、进程集成(PID 校验、子进程处理、时间戳)、文本与解析(UTF-8 安全、路径规范化、状态机)以及测试(往返测试、模糊测试、Clippy lint)。错误处理上,库的公共 API 用 thiserror 按操作定义细粒度错误类型,应用内部用 anyhow 提供上下文;错误应降级功能而非崩溃,但宽松处理时需记录日志。

适用场景:编写处理文件格式、持久化、FFI 边界与系统集成的 Rust 代码时。限制:资料未提供具体安装命令、版本要求或平台支持细节;部分条目(如 Rust 1.80+ 的 LazyLock)为文中提及的版本信息。