Socraticode 代码库智能索引

解决什么问题

当编码代理（Claude Code、Cursor、VS Code 等）面对十万行以上的代码库时，纯字符串匹配很快失效：语义相近但命名不同的代码无法召回，调用链与依赖关系要靠人工翻找，改动影响面几乎无法评估。代理把大量往返浪费在「这个函数在哪里被调用」这类基础问题上。

核心能力

Socraticode 为代理提供一层本地代码库智能索引：

• AST 感知分块：按语法结构切分代码，而非按固定字符数截断，函数与类不会被切成碎片
• 混合检索：语义向量搜索 + BM25 关键词搜索，通过 RRF（倒数排名融合）合并结果，兼顾意图匹配与精确符号查找
• 依赖图与调用流：多语言依赖图支持影响面分析与调用路径调查
• 默认本地私有：Docker 自动管理、零配置，无需 API key，数据不离开本机
• 可上云：向量存储可选 Qdrant，embedding 可接 OpenAI 或 Google Gemini

工作方式与注意点

索引构建后，代理通过 MCP 协议直接查询，把「猜文件名、翻目录」替换为结构化检索。工作流大致是：指定代码库 → 构建索引 → 代理在编码任务中查询调用点与依赖 → 评估改动影响。

需要注意：环境要求 Node.js 18+ 与 Docker；索引质量取决于代码库的语言支持与结构；接入云端 embedding 或 Qdrant 时代码片段会离开本地，仓库敏感时应保持默认的本地模式。