企业官网建设流程全解析

TeamAI双轨提取机制详解：AST轨与启发式轨并行时谁说了算

【免费下载链接】teamai-cliMake Every Team AI Native项目地址: https://gitcode.com/GitHub_Trending/te/teamai-cli

TeamAI 是一款面向团队的 AI 原生 CLI 工具（Make Every Team AI Native），它的代码知识图谱引擎采用双轨提取机制：AST 轨与启发式轨同时运行，为代码库生成依赖关系边。很多新手都会问：两条轨道结果重叠时，到底谁说了算？答案是——AST 轨优先。下面用 5 分钟讲清这套机制的分工、合并规则与降级策略。

双轨提取是什么：两条轨道的分工

TeamAI 的代码知识提取位于 src/wiki-engine/code-knowledge/ 目录，两条轨道的分工如下：

简单理解：

• 🧠AST 轨负责"精准"——真正解析语法树，把import/require、跨文件调用、TS 的implements子句，解析成精确的文件到文件关系边（DEPENDS_ON/REFERENCES/IMPLEMENTS）。
• 🧩启发式轨负责"兜底"——用正则模式提取，覆盖 AST 轨尚未支持的语言（比如 Java 和 Rust），保证任何语言都能提取到基础结构。

AST 轨的解析器是纯 JavaScript 依赖（WASM 格式），无需任何原生编译工具链，安装即用。支持的语言与扩展名映射见 src/wiki-engine/code-knowledge/ast/parser-registry.ts。

谁说了算：合并规则（AST 优先）

两轨结果并不简单拼接，而是经过一层专门的合并逻辑，核心实现在 src/wiki-engine/code-knowledge/ast/merge-edges.ts：

1. 键去重，AST 赢：每条事实用类型:名称:文件:起始行作为唯一键，AST 轨事实占位后，启发式轨的重复项直接被丢弃。
2. 同行关系，整行让位：如果启发式轨的一条关系事实与 AST 轨关系事实位于同一文件的同一行，该启发式事实也会被丢弃——避免同一行出现两条"打架"的边。
3. 最终仍做一次全量去重，保证输出干净。

这个合并动作在提取主流程中被调用：

• 提取入口：src/codebase-extract.ts
• 启发式语言分发注册表（决定哪些语言走正则提取）：src/wiki-engine/code-knowledge/extractors/index.ts
• 事实的数据结构定义（CodeFact，含confidence字段）：src/wiki-engine/code-knowledge/code-extractors.ts

AST 轨如何生成"高精度"边

AST 轨的主流程在 src/wiki-engine/code-knowledge/ast/index.ts，分三步：

1. 逐文件解析：WASM 解析器遍历符号、import 语句、调用点、implements子句；
2. import 解析：把导入路径解析到真实目标文件，生成DEPENDS_ON边——成功解析且置信度为EXTRACTED时权重 0.9，否则 0.5（解析器见 src/wiki-engine/code-knowledge/ast/import-resolver.ts）；
3. 调用与接口解析：跨文件调用生成REFERENCES边，implements解析生成IMPLEMENTS边（权重 0.9）。

每条边都附带证据（哪个文件、哪一行、什么原因），让图谱里的每条关系都可追溯、可核查。

降级策略：AST 加载失败怎么办

万一 WASM 解析器加载失败，提取不会中断，而是自动降级到纯启发式轨，并记录一条AST_UNAVAILABLEgap 供排查（见 src/codebase-extract.ts）。你还可以通过环境变量强制关闭 AST 轨：

TEAMAI_SKIP_AST=1 teamai codebase --extract

对应的可用性检测逻辑在 src/wiki-engine/code-knowledge/ast/index.ts。

总结：一句话记住这套机制

双轨设计的精髓在于：精度归 AST，覆盖归启发式，冲突时 AST 一票否决。这种"高精度轨 + 兜底轨"的组合，是 TeamAI 能把多年迭代的大型代码库变成可追溯知识图谱的关键。更多使用细节可参考 docs/usage-guide.zh-CN.md。

【免费下载链接】teamai-cliMake Every Team AI Native项目地址: https://gitcode.com/GitHub_Trending/te/teamai-cli