| FMRS | 67 / 100 · C | 79 / 100 · B |
|---|
| 可靠性 | 9 / 20 | 12 / 20 |
|---|
| 安全与权限 | 14 / 20 | 18 / 20 |
|---|
| 维护活跃度 | 13 / 20 | 16 / 20 |
|---|
| 文档质量 | 18 / 20 | 18 / 20 |
|---|
| 安装易用性 | 13 / 20 | 15 / 20 |
|---|
| 适合谁 | - 需要长期维护、代码量很大(数百万行以上)的企业级或多语言代码库
- 希望嵌入与索引数据完全留在本机、不外传的隐私敏感团队
- 已在使用 Claude Code、Cursor、VS Code Copilot 或 Gemini CLI,想让 AI 助手更少读文件、更多用语义搜索和依赖图的开发者
- 多个 AI 代理或多人协作、共享同一份代码索引的团队
| - 需要规模化运行 AI 编码代理并控制成本的工程团队
- 需要可审计、可回滚代理执行记录的平台/平台工程团队
- 同时使用 Claude、Codex、Gemini 等多种代理并希望统一治理流程的组织
|
|---|
| 不适合谁 | - 无法在本机或 CI 环境运行 Docker(或不允许运行容器)的场景
- 只有几百行代码的小型项目,配置 Docker/Qdrant/Ollama 的成本大于收益
- 需要完全托管、开箱即用的云端共享索引的团队(SocratiCode Cloud 仍处于私测阶段,尚未正式发布)
- 对新增本地容器、后台文件监视进程和第三方 npm 包有严格安全审批限制的环境
| - 只需要单个简单代码补全、不需要运行治理的开发者
- 无法接受本地 JSONL 运行记录存储与 HMAC 签名机制的团队
- 不使用受支持 CLI 适配器（Claude/Codex/Gemini/direct-provider/verifier-only）的环境
|
|---|
| 所需权限 | - 读取本地项目代码库文件系统,用于 AST 分块与索引
- 通过 Docker 启动并管理本地 Qdrant(向量数据库)与 Ollama(嵌入模型)容器
- 本地文件系统写入权限,用于持久化索引、图谱数据及可选的交互式 HTML 图谱文件
- 文件系统监视权限,用于实时检测文件变更并增量更新索引
- 如配置云端嵌入或外部 Qdrant,需要出站网络访问以及对应的 API 密钥(OPENAI_API_KEY、GOOGLE_API_KEY、QDRANT_API_KEY 等)
| - 对指定仓库根目录的读写权限（可用 --allow-path/--deny-path 限制写入范围）
- 调用所选代理 CLI（Claude/Codex/Gemini 等）及其底层模型账号的权限
- 本地磁盘写入运行记录、回执与 share 输出（share/run-receipt. 等）
- 执行用户配置的验证命令（如 npm test）
|
|---|
| 风险与副作用 | - 默认会自动拉取并运行 Docker 镜像(Qdrant、Ollama),需要信任这些容器镜像及其运行时行为
- 若切换到 OpenAI 或 Google 云端嵌入,代码片段会被发送至第三方 API,不再是“完全本地私有”,需评估代码保密性要求
- API 密钥(OPENAI_API_KEY、GOOGLE_API_KEY、QDRANT_API_KEY)以环境变量形式配置,需注意密钥泄露及配置文件的访问权限
- 若使用外部/远程 Qdrant 实例并配置不当,索引内容(可能包含代码片段乃至敏感字符串)存在暴露风险
- 项目采用 AGPL-3.0 许可,与部分商业/闭源软件集成时需评估许可证合规性
- MCP 客户端一旦连接,即拥有对索引、图谱和上下文产物的全部读写与删除权限,缺少细粒度的工具级权限控制
- 依赖静态分析的调用图无法捕获动态派发、反射、框架魔法(如依赖注入、装饰器路由)等,存在“零调用者”误判风险,不能完全替代人工审查
| - 验证命令会被执行，恶意或不当的验证命令可能带来安全风险（MartinLoop 会预检策略，但仍需谨慎配置）
- 预算与用量数据可能仅为估算值（标注为 estimated），不应作为最终账务依据
- 回执完整性必须为 verified 才能作为可信证据；回滚证据缺失时标注为 EVIDENCE_BOUNDARY
- 策略默认来自 martin.config.yaml，CLI 标志可覆盖，误配置可能放宽安全边界
|
|---|
| 支持客户端 | Claude Code, VS Code, Cursor, Gemini CLI, Claude Desktop, Windsurf, Cline, Roo Code, Zed, OpenAI Codex CLI, OpenCode | Claude Code, Codex, Gemini CLI, Cursor, VS Code, GitHub Copilot, Continue |
|---|
| 工具能力 | 21 | 0 |
|---|