bartolli/codanna

解决的问题

Codanna 消除了 AI 编码代理通常使用的低效「grep 和读取」循环。它不强制代理手动搜索字符串并逐个打开文件，而是提供结构化、语义化的代码理解，使代理能够通过一次请求即时获取符号上下文、调用图和影响分析。

工作原理

Codanna 在本地磁盘上索引仓库，并创建代码的语义地图。它作为 Model Context Protocol (MCP) 服务器或一次性 CLI 工具运行。它使用本地嵌入模型实现自然语言搜索，并解析 15 种不同语言的代码，以追踪符号、调用者和被调用者之间的关系。这使得它能够在不将源代码发送到远程 API 的情况下，执行语义搜索、依赖项追踪和文档 RAG（检索增强生成）。

适用人群

专为使用 AI 编码代理（如 Claude Code、Cursor、Windsurf、Codex 或 Gemini）的开发者设计，希望为其助手提供「X 光视觉」，以实现更快、更准确的代码导航和修改。

主要亮点

• 本地优先架构：所有索引和嵌入生成都在用户设备上完成；默认情况下源代码不会离开设备。
• 统一上下文检索：一条命令即可返回符号的身份、签名、文档、调用者、被调用者以及变更的潜在「影响范围」。
• 多语言支持：支持 15 种语言，包括 Rust、Python、JavaScript、TypeScript、Java、Go、C++ 和 C#。
• 灵活集成：可作为持久的 MCP 服务器用于长时间会话，也可作为 CLI 用于脚本和 CI/CD 流水线。
• 高性能：具备快速解析吞吐量和暖服务器查询下低于 10ms 的查找速度。