SuperAPI AI 工具集

rust-crate-discovery

编程与开发

查看项目

更新于 10-15 21:48

技能介绍

用途:该技能负责 crate 进入 Cargo.toml 之前的发现与评估阶段,可搜索、深度评估、并排对比 Rust crate,输出健康度评分与采纳建议。不涉及采纳后的治理(属 rust-dependencies)、清单机制(rust-cargo-build)或语义化版本(rust-semver)。

主要能力:按关键词、分类或名称搜索 crates.io 并返回排序候选;对单个 crate 从 crates.io、docs.rs、GitHub、RustSec 四个来源拉取元数据;对 2 个以上 crate 并排对比并展示子分项;按 6 个维度评分(采纳度 30、维护 25、文档 15、成熟度 15、社区 10、许可证 5),总分 0-100 并给出 A/B/C/D/F 等级;标记红旗,如安全公告、超过 12 个月未发布、无 docs.rs 构建、未声明许可证、无源码仓库、单一维护者等;输出人类可读报告或面向智能体的 JSON。

使用方式:需要网络访问与 Python 3.9+(仅标准库)。搜索:python3 scripts/crate_eval.py search "orm",可加 --limit、--category;评估:python3 scripts/crate_eval.py eval rbatis,可加 --json、-v、--skip-github;对比:python3 scripts/crate_eval.py compare rbatis diesel sea-orm sqlx。建议流程:先 search 找候选,挑选采纳量非平凡且有近期活动的 2-4 个名称,再 compare,然后针对首选阅读红旗清单,最后人工核实是否匹配自身用例。

适用场景:选择 ORM、HTTP 客户端、日志库等依赖时,快速判断某个 crate 是否安全、是否仍在维护、API 是否稳定、许可证是什么,以及在多个候选间决策。

限制:评分衡量健康度而非适配度,不匹配用例时以人工核实为准;小众、新发布、fork 或私有 crate 评分可能失真,私有 crate 不在 crates.io 上,工具无法提供帮助,建议人工评审;会向上述四个来源发出站请求,User-Agent 标识该工具,除 URL 路径中的公开 crate 名称外不收集或传输用户数据。