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 圖形探索器，用於導航程式碼相依關係。