跳转到内容
GBGrok Build Architecture

xai-codebase-graph

工具与工作区

xai-codebase-graph

使用 tree-sitter query 生成符号和代码关系图。

Cargo description: High-performance code graph generation using tree-sitter queries

26生产文件
28Rust 文件总数
8,935生产代码行
30收录公开符号

职责与架构位置

xai-codebase-graph 位于“工具与工作区”层。它的首要职责是：使用 tree-sitter query 生成符号和代码关系图。。源码图谱把 crate 看成一个编译和所有权边界，而不是文件夹标签：直接依赖表示它可以调用的下层能力，反向依赖表示哪些上层模块把它当作稳定接缝。

成员路径为 crates/codegen/xai-codebase-graph，清单位于 Cargo.toml。

关键入口

SOURCElib.rscrates/codegen/xai-codebase-graph/src/lib.rs:1–11103 行 · 模块入口SOURCEMAX_INDEXABLE_FILE_SIZEcrates/codegen/xai-codebase-graph/src/index_manager.rs:40–502,186 行 · 公开符号入口SOURCENodeIndexcrates/codegen/xai-codebase-graph/src/scope_graph/graph.rs:22–321,727 行 · 公开符号入口SOURCENavigationResultcrates/codegen/xai-codebase-graph/src/navigation.rs:12–22845 行 · 公开符号入口SOURCEIndexOperationcrates/codegen/xai-codebase-graph/src/manager/lock.rs:28–38540 行 · 公开符号入口SOURCEIndexErrorcrates/codegen/xai-codebase-graph/src/manager/builder.rs:17–27508 行 · 公开符号入口

入口文件优先按 lib.rs/main.rs、公开符号密度和文件规模选择。这是一条面向阅读的路径，不表示其他文件不重要；下方完整文件索引覆盖该 crate 的全部 Rust 源码、测试、示例、基准与 Fuzz 文件。

依赖与调用者

直接依赖

xai-grok-paths

依赖边来自固定提交中的 Cargo manifest，只表示编译期直接依赖。运行时控制流还需结合 trait 实现、构造位置和消息通道判断；反向依赖为空也不代表 crate 没有入口，它可能直接生成二进制或由外部协议调用。

关键公开符号

类型符号文件与行号
constMAX_INDEXABLE_FILE_SIZEcrates/codegen/xai-codebase-graph/src/index_manager.rs:42
enumFileEventKindcrates/codegen/xai-codebase-graph/src/index_manager.rs:62
structFileEventcrates/codegen/xai-codebase-graph/src/index_manager.rs:75
fnnewcrates/codegen/xai-codebase-graph/src/index_manager.rs:84
fncreatedcrates/codegen/xai-codebase-graph/src/index_manager.rs:89
fnmodifiedcrates/codegen/xai-codebase-graph/src/index_manager.rs:94
fnremovedcrates/codegen/xai-codebase-graph/src/index_manager.rs:99
fnrenamedcrates/codegen/xai-codebase-graph/src/index_manager.rs:104
enumIndexCommandcrates/codegen/xai-codebase-graph/src/index_manager.rs:110
structQueryResultcrates/codegen/xai-codebase-graph/src/index_manager.rs:172
structSymbolLocationcrates/codegen/xai-codebase-graph/src/index_manager.rs:184
fnnewcrates/codegen/xai-codebase-graph/src/index_manager.rs:195
fnwith_symbolcrates/codegen/xai-codebase-graph/src/index_manager.rs:204
fnas_pathcrates/codegen/xai-codebase-graph/src/index_manager.rs:213
enumQueryErrorcrates/codegen/xai-codebase-graph/src/index_manager.rs:220
structIndexManagerHandlecrates/codegen/xai-codebase-graph/src/index_manager.rs:233
fnhas_run_loop_exitedcrates/codegen/xai-codebase-graph/src/index_manager.rs:243
fnsend_eventcrates/codegen/xai-codebase-graph/src/index_manager.rs:248
fnsend_eventscrates/codegen/xai-codebase-graph/src/index_manager.rs:253
fnrebuildcrates/codegen/xai-codebase-graph/src/index_manager.rs:264
fnget_snapshotcrates/codegen/xai-codebase-graph/src/index_manager.rs:272
fnget_snapshot_asynccrates/codegen/xai-codebase-graph/src/index_manager.rs:281
fnget_file_countcrates/codegen/xai-codebase-graph/src/index_manager.rs:290
fnget_statscrates/codegen/xai-codebase-graph/src/index_manager.rs:297
fnget_query_versioncrates/codegen/xai-codebase-graph/src/index_manager.rs:304
fnhas_definition_blockingcrates/codegen/xai-codebase-graph/src/index_manager.rs:317
fnshutdowncrates/codegen/xai-codebase-graph/src/index_manager.rs:329
fngoto_definitioncrates/codegen/xai-codebase-graph/src/index_manager.rs:341
fngoto_referencescrates/codegen/xai-codebase-graph/src/index_manager.rs:364
fnfind_definitionscrates/codegen/xai-codebase-graph/src/index_manager.rs:387

公开符号用于快速判断 crate 对外暴露的数据、trait 和执行入口。私有实现仍会出现在完整文件索引中；本文不会仅凭 pub 推断某个符号就是长期稳定 API。

关联深度文章

Codebase Graph解释 tree-sitter 查询、增量索引和代码关系图的生成。

完整 Rust 文件索引

共 28 个 Rust 文件，其中 26 个被覆盖校验认定为生产源码。测试、示例、基准和 Fuzz 文件不会从图谱删除，而是使用不同标签展示。

生产源码crates/codegen/xai-codebase-graph/src/bin/bench_file_listing.rs234 行 · 0 个公开符号生产源码crates/codegen/xai-codebase-graph/src/bin/bench_index.rs65 行 · 0 个公开符号生产源码crates/codegen/xai-codebase-graph/src/bin/code_graph.rs395 行 · 0 个公开符号生产源码crates/codegen/xai-codebase-graph/src/index_manager.rs2,186 行 · 12 个公开符号生产源码crates/codegen/xai-codebase-graph/src/interner.rs414 行 · 12 个公开符号生产源码crates/codegen/xai-codebase-graph/src/languages/golang.rs74 行 · 1 个公开符号生产源码crates/codegen/xai-codebase-graph/src/languages/javascript.rs95 行 · 1 个公开符号生产源码crates/codegen/xai-codebase-graph/src/languages/mod.rs147 行 · 10 个公开符号生产源码crates/codegen/xai-codebase-graph/src/languages/python.rs39 行 · 1 个公开符号生产源码crates/codegen/xai-codebase-graph/src/languages/rust.rs199 行 · 1 个公开符号生产源码crates/codegen/xai-codebase-graph/src/languages/ts.rs242 行 · 1 个公开符号生产源码crates/codegen/xai-codebase-graph/src/languages/types.rs83 行 · 11 个公开符号生产源码crates/codegen/xai-codebase-graph/src/lib.rs103 行 · 0 个公开符号生产源码crates/codegen/xai-codebase-graph/src/manager/builder.rs508 行 · 11 个公开符号生产源码crates/codegen/xai-codebase-graph/src/manager/cache.rs107 行 · 9 个公开符号生产源码crates/codegen/xai-codebase-graph/src/manager/lock.rs540 行 · 8 个公开符号生产源码crates/codegen/xai-codebase-graph/src/manager/mod.rs15 行 · 0 个公开符号生产源码crates/codegen/xai-codebase-graph/src/navigation.rs845 行 · 12 个公开符号生产源码crates/codegen/xai-codebase-graph/src/scope_graph/edges.rs23 行 · 1 个公开符号生产源码crates/codegen/xai-codebase-graph/src/scope_graph/graph.rs1,727 行 · 12 个公开符号生产源码crates/codegen/xai-codebase-graph/src/scope_graph/mod.rs39 行 · 2 个公开符号生产源码crates/codegen/xai-codebase-graph/src/scope_graph/nodes.rs181 行 · 12 个公开符号生产源码crates/codegen/xai-codebase-graph/src/types/file_event.rs79 行 · 4 个公开符号生产源码crates/codegen/xai-codebase-graph/src/types/location.rs109 行 · 12 个公开符号生产源码crates/codegen/xai-codebase-graph/src/types/mod.rs120 行 · 10 个公开符号生产源码crates/codegen/xai-codebase-graph/src/types/range.rs366 行 · 12 个公开符号测试crates/codegen/xai-codebase-graph/tests/incremental_memory.rs137 行 · 0 个公开符号测试crates/codegen/xai-codebase-graph/tests/memory_integration.rs683 行 · 0 个公开符号

覆盖说明

该页面由固定源码基线生成。CI 会重新扫描 crates/codegen/xai-codebase-graph，验证文件数量、行数、公开符号、依赖和入口是否与提交到站点的数据一致。若上游基线升级而图谱没有重新生成，构建会失败，避免页面显示已经不存在的路径。

GBA / 2026

非官方社区学习项目。Grok、xAI 及相关商标归其权利人所有；源码摘录来自 Apache-2.0 许可的公开仓库。
豫ICP备2026029221号-1