SuperAPI AI 工具集

rust-engineering

编程与开发

查看项目

更新于 10-16 03:39

技能介绍

用途:为构建可靠 Rust 系统提供模式参考,适用于处理文件格式、外部进程集成与跨语言边界的场景。

主要能力:

  1. 数据建模:用枚举替代字符串状态,避免大小写与非法值问题;Serde 加 #[serde(default)] 与 alias 兼容旧字段,不就地改变字段含义。
  2. FFI 边界:UniFFI 使用扁平稳定类型,ID/时间戳用 String,枚举用字符串表示。
  3. 文本安全:按字符或字素簇截断,避免 &s[..N] 字节切片 panic;路径与大小写统一归一化。
  4. 解析与序列化:状态机解析优于正则;用锚定标题行正则精确更新,避免 .contains() 误匹配;保留格式实现无损往返;重复 ID 确定性去重。
  5. 持久化:先落盘再异步增强;临时文件加 rename 原子写入;跨进程写入采用重读-打补丁-原子写回。
  6. 系统集成:PID 存在不等于身份,需校验进程启动时间;子进程输出视为不可信输入,严格解析 JSON 并设超时;时间戳统一秒/毫秒单位,用 saturating_sub 防下溢。
  7. 性能与错误:缓存编译正则与解析结果;目录选择保持确定性;定义显式错误类型,坏输入不 panic,降级保证核心功能可用。
  8. 测试:往返、变更、归一化、黄金文件、契约与属性测试;CI 中用假可执行文件替代真实子进程。

使用方式:作为编码规范与检查清单,在修改相关系统时逐项核对 schema、路径、PID 安全、时间戳与健壮性。

限制:资料未提供安装命令、版本要求、收费或平台信息;示例代码需按项目实际调整。