SocratiCode全本地部署指南零云端、零API Key的隐私优先企业级代码搜索【免费下载链接】SocratiCodeEnterprise-grade (40m LOC) codebase intelligence, zero-setup, local private Plugin/Skill/Extension or MCP: hybrid semantic search, polyglot dependency graphs, symbol-level impact analysis call-flow, interactive HTML viewer, cross-project branch-aware search, DB/API/infra knowledge. 61% less tokens, 84% fewer calls, 37x faster. Cloud in beta.项目地址: https://gitcode.com/gh_mirrors/so/SocratiCodeSocratiCode 是一款开源的代码库智能搜索引擎本指南带你完成它的全本地部署混合语义代码搜索、多语言依赖图谱、符号级影响分析全部运行在你自己的机器上零云端、零 API Key源码与索引永不出内网天然适配企业级隐私场景。小彩蛋标识中苏格拉底像背后的代码来自阿波罗 11 号制导计算机AGC的原始源码Comanche055一个古老代码与代码智能的巧妙呼应。一、为什么选择全本地的代码搜索AI 编程助手默认靠读文件 grep理解代码库既费 Token 又依赖网络。SocratiCode 把理解工作提前算好并存在本地带来三重收益收益说明 隐私代码分片发给本机Ollama 做向量化索引存在本机Qdrant无任何外部 API 调用 零成本无需 OpenAI/Gemini 等云端 Embedding 的 API Key没有按量计费没有 Token 限制 更省更快官方在 245 万行代码库实测上下文消耗减少 61%、工具调用减少 84%、响应快 37 倍默认部署由三个部分组成全部自动管理组件角色运行方式SocratiCode MCP 引擎索引、搜索、图谱的大脑Node.js 进程你本机Qdrant向量数据库存索引Docker 容器本机Ollama本地 Embedding 模型负责向量化Docker 容器本机默认二、部署前提只需准备 2 样东西Node.js 18.17 或更新版本PATH 中可用npx——运行 MCP 引擎。Docker 处于运行状态——自动托管 Qdrant 和 Ollama 容器。 macOS / Windows 用户提示Docker 容器无法调用 GPU。中小项目直接用默认配置即可中大型仓库建议额外安装原生 OllamaSocratiCode 启动时会自动探测端口 11434并优先使用它获得 Metal/CUDA 加速无需改动任何配置。三、第 1 步三行配置接入你的 AI 助手SocratiCode 是一个标准的本地 stdio MCP 服务器。在你的 MCP 宿主Claude Code、VS Code、Cursor、Zed 等配置中加入我们仓库里现成的 mcp.json 即可{ mcpServers: { socraticode: { command: npx, args: [-y, --prefer-online, socraticodelatest] } } }不同宿主Claude Code 插件、VS Code 扩展、Cursor、Gemini CLI 等各有专用安装方式官方提供了按宿主划分的快速指南入口在 docs/guides/README.md纯本地场景可重点参考 docs/guides/local-only.md。四、第 2 步零配置本地栈自动拉起重启宿主后什么都不用做。首次使用时引擎会自动完成检查 Docker拉取所需镜像启动托管容器socraticode-qdrant与socraticode-ollama并挂载持久化数据卷首次调用时自动下载本地 Embedding 模型nomic-embed-text。这套栈的容器编排定义在 docker-compose.yml 中几个贴心的设计非标端口Qdrant 用 16333/16334Ollama 用 11435避免与你已有的 Qdrant/Ollama 实例冲突--restart unless-stopped容器自动恢复数据存于本机卷重启不丢索引。初始设置约需 5 分钟取决于网速之后再启动只需几秒。五、第 3 步首次索引与第一次搜索打开任意代码项目对 AI 助手说Index this codebase索引这个代码库后台开始索引随时问What is the codebase index status?查看进度。300 万行代码首次索引在 Mac M4 上不到 10 分钟中断、崩溃都会自动断点续传已处理文件凭哈希跳过。索引完成后你问 AI背后动作你会得到认证逻辑在哪里实现混合语义 BM25 关键词搜索RRF 融合跨整个代码库的 Top 相关代码片段改这个函数会影响谁符号级影响分析逐跳hop展开的爆炸半径清单画一下依赖图依赖图谱可视化浏览器中打开的交互式 HTML 图谱页离线可用内嵌 Cytoscape无 CDN有哪些循环依赖环形依赖检测成环的模块链文件监听器默认开启之后每次文件变更索引自动增量更新无需任何手动操作。六、进阶更严格的纯本地姿势默认配置已经完全本地但官方为源码必须全程不离开机器的场景提供了 local-only 指南核心是给 MCP 服务器加两个环境变量OLLAMA_MODEexternal OLLAMA_URLhttp://localhost:11434即强制使用你原生安装的 Ollama而非 Docker 容器其余全部保持默认Embedding 走本地 Ollama默认nomic-embed-text、向量库走托管本地 Qdrant。修改后重启 MCP 服务器生效。⚠️ 注意一条边界SocratiCode 保证的是索引与搜索链路不出本机你使用的 AI 编程助手本身提示词与工具结果的传输遵循其自身服务商的策略涉及敏感源码前请先确认这条边界。七、常见问题速查Q1内网/离线环境能用吗初始下载 npm 包、Docker 镜像和模型需要一次联网之后索引、搜索、图谱可视化HTML 资源全部随包内置全程零网络适合气隙部署。Q2索引到一半断网/关机了直接重新发起索引即可——引擎按批检查点自动跳过已完成的文件从断点继续进度不丢。Q3换了 Embedding 模型会怎样已有集合保留原模型构建的向量继续可用状态工具会提示待生效确认切换后再删除并重建索引即可。Q4多个 AI 助手能共用一个索引吗可以。多实例通过跨进程文件锁自动协调一个负责索引与监听其余并发搜索互不冲突。Q5只想让 AI 读文档里的配置和数据库结构在项目根目录放一个.socraticodecontextartifacts.json把 SQL schema、OpenAPI 规范、K8s 清单登记为上下文工件它们会和代码一起被本地索引与语义搜索。写在最后从三行配置到完整跑通SocratiCode 的全本地部署没有任何云账号、没有 API Key、没有配置文件的繁琐——你得到的是一套代码不出内网的企业级代码搜索与智能分析能力。更多安装路径与全部环境变量请查阅 README.md 的 Quick Start 与 Environment Variables 章节。【免费下载链接】SocratiCodeEnterprise-grade (40m LOC) codebase intelligence, zero-setup, local private Plugin/Skill/Extension or MCP: hybrid semantic search, polyglot dependency graphs, symbol-level impact analysis call-flow, interactive HTML viewer, cross-project branch-aware search, DB/API/infra knowledge. 61% less tokens, 84% fewer calls, 37x faster. Cloud in beta.项目地址: https://gitcode.com/gh_mirrors/so/SocratiCode创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
