facebookincubator/Glean

说明与用途

**项目简介**
facebookincubator/Glean 是一个用于收集、推导和查询源码事实的系统，帮助开发者以结构化方式存储代码元数据，从而实现高效的代码搜索、依赖分析和自动化审计。

**价值**

• **统一事实库**：把编译信息、依赖关系、注解、测试覆盖等多维度数据统一写入可查询的事实库，消除散落在不同工具链中的信息孤岛。
• **强大查询能力**：基于自研的查询语言（类似 SQL）可以快速检索跨语言、跨仓库的代码事实，支持复杂的依赖图、变更影响分析等场景。
• **提升生产力**：在代码审查、迁移、自动生成文档或安全审计时，直接使用已有事实即可避免重复解析和手工统计。

**典型接入方式**

1. **构建阶段集成**：在 CI/CD 流水线中加入 Glean 的编译插件（Hack/Cpp/Java 等），让编译器在生成对象文件时同步生成事实（FactDB）。
2. **事实导入**：使用 glean import 将已有的 build metadata（Bazel、Buck、CMake 等）或第三方工具输出（Clang AST、LSP）导入 Glean。
3. **查询服务部署**：启动 Glean server（基于 SQLite/rocksdb）并通过 HTTP/gRPC 暴露查询接口，供内部工具或 IDE 插件调用。
4. **权限与治理**：结合组织的 SSO/LDAP 为不同团队配置查询权限，确保敏感代码事实受控访问。

**生产可用性**

• **成熟度**：项目已有 1355+ stars、88 forks，最近一次提交在 2026‑06‑26，活跃度尚可。
• **适用范围**：适合内部原型、代码分析平台或作为大型 monorepo 的事实层；在生产环境使用前建议完成以下检查：
• **依赖审计**：确认所使用的 Hack 运行时、数据库后端以及 CI 插件与现有技术栈兼容。
• **运维准备**：评估事实库的规模（TB 级别时需考虑分片或外部存储），并制定备份/恢复策略。
• **安全评审**：审查查询接口的访问控制，防止代码事实泄露。
• **风险**：元数据中缺乏明确的接入指南，集成路径需要手动探索和实验。若团队能够投入一定的前期调研和脚本开发，Glean 在内部工作流中可达到 **中等** 的生产就绪度；在对可靠性要求极高的对外服务中仍需更充分的测试与运维支撑。

实际用途

facebookincubator/Glean may be useful when its README and activity match a concrete workflow.

限制与审查说明

Medium: useful for prototypes or internal workflows, with dependency and maintenance checks before production.