| FMRS | 67 / 100 · C | 80 / 100 · B | 76 / 100 · B |
|---|
| 可靠性 | 9 / 20 | 14 / 20 | 13 / 20 |
|---|
| 安全与权限 | 14 / 20 | 16 / 20 | 14 / 20 |
|---|
| 维护活跃度 | 13 / 20 | 17 / 20 | 18 / 20 |
|---|
| 文档质量 | 18 / 20 | 15 / 20 | 17 / 20 |
|---|
| 安装易用性 | 13 / 20 | 18 / 20 | 14 / 20 |
|---|
| 适合谁 | - 需要长期维护、代码量很大(数百万行以上)的企业级或多语言代码库
- 希望嵌入与索引数据完全留在本机、不外传的隐私敏感团队
- 已在使用 Claude Code、Cursor、VS Code Copilot 或 Gemini CLI,想让 AI 助手更少读文件、更多用语义搜索和依赖图的开发者
- 多个 AI 代理或多人协作、共享同一份代码索引的团队
| - 使用变化较快的框架/库、担心 AI 助手给出过时代码建议的开发者
- 希望零配置直接获得文档检索能力的场景
| - 需要让 AI 助手直接操作 GitHub 仓库和协作流程的团队
- 已经在使用 GitHub Copilot 生态、想要远程零部署方案的用户
|
|---|
| 不适合谁 | - 无法在本机或 CI 环境运行 Docker(或不允许运行容器)的场景
- 只有几百行代码的小型项目,配置 Docker/Qdrant/Ollama 的成本大于收益
- 需要完全托管、开箱即用的云端共享索引的团队(SocratiCode Cloud 仍处于私测阶段,尚未正式发布)
- 对新增本地容器、后台文件监视进程和第三方 npm 包有严格安全审批限制的环境
| - 需要检索内部私有代码库文档的场景（Context7 面向公开发布的开源库）
- 对文档来源覆盖率有极高要求、需要覆盖冷门小众库的场景（覆盖范围取决于 Context7 平台收录情况）
| - 不希望 AI 助手拥有仓库写权限的场景（应仅启用只读 toolset）
- 对私有仓库有严格网络隔离要求、不能使用官方远程端点的环境
|
|---|
| 所需权限 | - 读取本地项目代码库文件系统,用于 AST 分块与索引
- 通过 Docker 启动并管理本地 Qdrant(向量数据库)与 Ollama(嵌入模型)容器
- 本地文件系统写入权限,用于持久化索引、图谱数据及可选的交互式 HTML 图谱文件
- 文件系统监视权限,用于实时检测文件变更并增量更新索引
- 如配置云端嵌入或外部 Qdrant,需要出站网络访问以及对应的 API 密钥(OPENAI_API_KEY、GOOGLE_API_KEY、QDRANT_API_KEY 等)
| - 无需 API Key 即可使用（有免费额度限制），CONTEXT7_API_KEY 为可选的更高配额凭据
- 只读检索文档内容，不涉及执行代码或访问本地文件
| - 个人访问令牌（PAT）或 OAuth App Token，权限范围取决于令牌本身的 scope
- 启用 actions/issues/pull_requests 等 toolset 后可对仓库进行写操作，需按最小权限原则申请令牌
|
|---|
| 风险与副作用 | - 默认会自动拉取并运行 Docker 镜像(Qdrant、Ollama),需要信任这些容器镜像及其运行时行为
- 若切换到 OpenAI 或 Google 云端嵌入,代码片段会被发送至第三方 API,不再是“完全本地私有”,需评估代码保密性要求
- API 密钥(OPENAI_API_KEY、GOOGLE_API_KEY、QDRANT_API_KEY)以环境变量形式配置,需注意密钥泄露及配置文件的访问权限
- 若使用外部/远程 Qdrant 实例并配置不当,索引内容(可能包含代码片段乃至敏感字符串)存在暴露风险
- 项目采用 AGPL-3.0 许可,与部分商业/闭源软件集成时需评估许可证合规性
- MCP 客户端一旦连接,即拥有对索引、图谱和上下文产物的全部读写与删除权限,缺少细粒度的工具级权限控制
- 依赖静态分析的调用图无法捕获动态派发、反射、框架魔法(如依赖注入、装饰器路由)等,存在“零调用者”误判风险,不能完全替代人工审查
| - 免费额度有限，高频使用场景可能遇到速率限制
- 文档内容来自 Context7 平台索引，其准确性和更新频率取决于该平台的抓取周期
| - 写权限 toolset（如创建/合并 PR、触发 workflow）如果令牌权限过大，可能造成误操作；建议先用只读 toolset 试运行
- 远程托管模式下凭据通过 Authorization 头传输，需确保客户端到 api.githubcopilot.com 的连接受信任
|
|---|
| 支持客户端 | Claude Code, VS Code, Cursor, Gemini CLI, Claude Desktop, Windsurf, Cline, Roo Code, Zed, OpenAI Codex CLI, OpenCode | Claude Code, VS Code, Cursor, Cline, Amp | Claude Desktop, Claude Code, VS Code, Cursor, Windsurf, JetBrains, Zed, Amp |
|---|
| 工具能力 | 21 | 2 | 15 |
|---|