Rust Crate 文档扫描器

解决什么问题

Rust crate 的公开 API 散落在 rustdoc 生成的 HTML 里。当你想审计某个依赖的接口范围——哪些 trait 被导出、哪些 impl 块存在于当前版本、哪些 derive macro 被引入——通常只能打开 docs.rs 手动翻找。在代码评审或依赖升级的场景中，这种人工核对既慢又容易遗漏。

核心工作方式

这个技能用两条数据源重建 API 索引：

• rustdoc JSON 输出：编译器产出的结构化 JSON，包含每个公开项的签名与路径
• cargo-doc 元数据：提供 crate 级别的构建信息，比如目标版本和 feature 组合

索引的公开 API 面覆盖：

• trait 定义及其方法
• impl 块，包括针对 trait 和具体类型的实现
• derive macro 的导出情况

跨 crate 引用通过 docs.rs 集成链接：当被扫描的 crate 依赖了其他 crate 时，对应文档页面会被解析并挂接到本地索引中，避免断链。

适用边界

• 只覆盖公开 API 面，pub(crate) 与私有项不在扫描范围内
• 依赖 docs.rs 上文档的可访问性，离线环境或 docs.rs 未构建的目标版本可能缺失链接
• 不分析宏展开后的实际行为，只登记宏的导出元数据