SuperAPI AI 工具集

rust-review

编程与开发

查看项目

更新于 10-16 09:50

技能介绍

用途:为 Coglet 的 Rust 代码(crates/ 目录)提供代码审查准则。该服务器在 Cog 容器内运行,负责 HTTP 请求、worker 进程管理和预测执行。

主要能力与审查要点: 错误处理:库代码用 thiserror 定义类型化错误,应用错误用 anyhow;非测试代码避免 .unwrap()/.expect(),除非不变量有文档说明;错误上下文用 .context() 或 .with_context(),而非裸 ?。 所有权与生命周期:检查本可用借用却克隆、暗示设计问题的生命周期问题,以及存在更简单模式时仍用 Arc/Mutex。 Async(tokio):async 上下文中的阻塞操作应改用 spawn_blocking;关注缺失 .await、取消处理与清理、任务/JoinHandle 泄漏。 安全性:任何 unsafe 块需有理由和安全注释;关注 PyO3 FFI 边界的 panic 与 GIL 处理;父进程与 worker 进程间 IPC 的内存安全。 架构:crates/coglet/ 为核心(HTTP 服务器、worker 编排、IPC),crates/coglet-python/ 为 PyO3 Python 预测器绑定;采用父进程(HTTP+编排)与 worker(Python 执行)双进程架构;不要混淆 IPC 与 HTTP 处理;快照测试用 insta,检查快照是否需更新。 依赖:新依赖需有理由,由 crates/deny.toml 审计;小任务优先用 std 或现有依赖。

已知由工具覆盖、应跳过的项:clippy 在 CI 中运行,cargo-deny 审计依赖的许可与安全公告问题,不要重复标记这些工具能发现的问题。

限制:资料未提供安装命令、价格、平台支持范围或具体使用步骤。