用途：为 Agent Brain 文档搜索系统完成安装与配置，涵盖可插拔的嵌入提供商、摘要提供商、存储后端以及可选的 MCP 服务器和 GraphRAG 图索引。
主要能力：支持多运行时插件安装（Claude Code、OpenCode、Gemini CLI、Codex 等），命令如 agent-brain install-agent --agent claude；支持 --global 用户级安装与 --dry-run 预览。提供 /agent-brain-setup 引导向导，交互式询问嵌入提供商、摘要提供商、存储后端（chroma 或 postgres）、GraphRAG 开关和默认查询模式，并写入 config.yaml。嵌入提供商可选 ollama/nomic-embed-text、openai/text-embedding-3-large、cohere/embed-multilingual-v3.0、gemini/text-embedding-004 等；摘要提供商可选 ollama/llama3.2、anthropic/claude-haiku-4-5-20251001、openai/gpt-4o-mini、gemini/gemini-2.0-flash、grok/grok-3-mini-fast 等。
必要用法：安装 pip install agent-brain-rag agent-brain-cli，用 agent-brain --version 验证；本地免费方案需安装并运行 Ollama 后 ollama pull nomic-embed-text、ollama pull llama3.2，设置 EMBEDDING_PROVIDER、SUMMARIZATION_PROVIDER 等环境变量，然后 agent-brain init、start、status。云端方案设置 OPENAI_API_KEY 等。配置可写入 config.yaml（项目级 .agent-brain/config.yaml 或用户级 ~/.agent-brain/config.yaml）或用环境变量。MCP 服务器通过 pip install agent-brain-ag-mcp 安装，可用 agent-brain install-agent --agent claude --with-mcp 注册。远程服务支持 OAuth 2.1（v10.4）。
限制：需 Python 3.10+；典型文档集合约 500MB 内存，启用 GraphRAG 约 1GB；GraphRAG 需索引时加 --include-code，Kuzu 后端需额外安装 graphrag-kuzu。config.yaml 含密钥需 chmod 600 且不应提交到 git。Anthropic/Claude 摘要用户需注意 langextract 不识别 Claude 模型 id，未显式覆盖时会自动转用 openai/gpt-4o-mini。MCP 的 HTTP 传输仅允许回环地址。定价、平台支持与效果数据暂未提供。