开源工具将代码库变成 Agent 知识
UmairBaig7 · reddit · 2026-07-16
作者开源了 `okf-generator`，一个把代码库转成结构化知识、供 LLM agent 查询的工具。 ### 解决的问题 传统做法里，agent 想理解一个函数，往往要读整份文件或靠 grep；RAG 虽然能检索，但按文本切块会破坏语法边界，导致上下文不准，甚至让 agent 误判调用关系。 ### 核心方案 它不按文本切块，而是直接解析 AST： - 使用 tree-sitter 覆盖 18 种语言 - 为函数 / 类 / 模块生成 typed concept cards - 解析出 calls、callers、imports 等边 - 单次定位成本从约 14K token 降到约 140 token ### 特点与限制 - 核心抽取完全离线、确定性执行，不需要 LLM、API key 或向量库 - 可选的 `okf enrich --llm` 用于自然语言摘要 - 可选的 `okf enrich --lsp` 利用 LSP 生成更准确的调用图 - 内置 MCP server，方便 agent 直接查询 - 限制：动态分发、反射重的代码处理效果仍有限，部分语言成熟度也不同 作者提供了仓库、文档和当前测试状态（313 tests passing，v0.1.49，MIT）