giancarloerra/SocratiCode

解决的问题

SocratiCode 是一个代码库上下文引擎，为 AI 助手提供对大规模代码库的深层语义理解。它解决了 AI 代理在复杂、数百万行代码的代码库中导航时遇到的难题——简单的文本搜索（grep）不足以理解架构模式、依赖关系和符号级影响。

工作原理

该系统使用 Model Context Protocol (MCP) 服务器与 AI 主机集成。它采用 AST 感知的代码分块和混合搜索方法——结合密集向量嵌入（语义搜索）和 BM25 稀疏向量（关键词搜索），通过 Reciprocal Rank Fusion (RRF) 在 Qdrant 向量数据库中融合。同时，构建多语言依赖图，以实现跨 18 种语言的符号级影响分析和调用流追踪。

适用人群

专为在企业级大型代码库（已测试至 4000 万行代码）中工作的开发者设计，他们使用 Claude Code、Cursor、VS Code Copilot 或 Gemini CLI 等 AI 编码助手，并希望获得一个跨不同 AI 工具持久存在的、与工具无关的上下文层。

核心亮点

• 混合搜索：结合语义搜索与关键词搜索，实现高精度代码检索。
• 深度智能：支持跨 18 种语言的符号级影响范围与调用流追踪。
• 零配置：通过 Docker 自动部署 Qdrant 和 Ollama，实现本地优先的隐私保护。
• 工具无关：单一索引可跨多个 AI 代理和 IDE 共享。
• 可恢复索引：支持带检查点的分批索引，可应对大规模代码库中的崩溃或中断。
• 可视化探索：内置交互式 HTML 图形探索器，用于导航代码依赖关系。