version: '3.8'
services:
  qdrant:
    image: qdrant/qdrant
    ports:
      - "6333:6333"
    volumes:
      - qdrant_storage:/qdrant/storage
volumes:
  qdrant_storage:

第 3 步：设置嵌入提供商

Google Gemini 设置（推荐）- 免费

从 Google AI Studio 获取 API 密钥（目前免费）
在 Roo Code 设置中：

提供商：Google Gemini
API 密钥：您的 Google AI Studio 密钥

其他可用提供商
虽然本指南重点介绍 Google Gemini，因为它目前是免费的，但 Roo Code 还支持 OpenAI、Ollama 和兼容 OpenAI 的提供商。您可以在配置下拉菜单中探索这些选项。

第 4 步：保存

点击“保存并开始索引”

状态指示器将显示：

黄色（正在索引）：正在处理文件
绿色（已索引）：已准备好进行搜索
红色（错误）：检查故障排除部分

管理和配置索引器

您可以直接从 Roo Code 聊天界面监控状态和管理代码库索引器的所有配置。

状态图标

在聊天输入的右下角，您会找到代码库索引状态图标。此图标可让您快速、一目了然地了解索引器的当前状态。

图标的颜色表示状态：

🟢 绿色：已索引。索引是最新的，已准备好进行搜索。
🟡 黄色：正在索引。系统正在主动处理文件。仍然可以执行搜索，但结果可能不完整。
🔴 红色：错误。发生了问题（例如，未能连接到 Qdrant 或嵌入提供商）。请参阅故障排除部分寻求帮助。
⚪ 灰色：待机。索引器正在等待配置或已被禁用。

多文件夹工作区：在多文件夹工作区中，每个文件夹都有自己的索引状态和配置。状态图标反映了所有工作区文件夹的组合状态。

配置弹出窗口

点击状态图标会打开主配置弹出窗口。在这里，您可以查看详细状态并管理所有设置。

状态：一条详细消息，显示当前状态，例如“已索引 - 文件监视器已启动”或正在进行的扫描进度。
设置：包含用于连接到嵌入提供商和向量数据库的主要字段。
高级配置：允许您微调搜索参数，如相似性阈值。
清除索引数据：删除 Qdrant 集合中的所有数据并清除本地文件缓存。当您想从头开始重新索引整个项目时，请使用此选项。此操作无法撤消。
保存：应用您的配置更改。如果更改了关键设置（例如 API 密钥或模型），索引器将自动重新启动。

详细配置字段

本指南解释了配置弹出窗口中可用的每个设置。

设置字段

嵌入提供商
- 目的：选择用于生成 AI 嵌入的源。
- 行为：此下拉菜单决定显示哪些配置字段。您的选项是 OpenAI、Google Gemini、Ollama 和 OpenAI 兼容。
API 密钥（适用于 OpenAI、Gemini、OpenAI 兼容）
- 目的：用于与您选择的提供商进行身份验证的密钥。
- 行为：此输入字段是所有基于云的提供商的必需字段，并安全地存储在您的 VS Code 密钥存储中。
基本 URL（适用于 Ollama、OpenAI 兼容）
- 目的：用于连接到提供商 API 的端点。
- 行为：对于 Ollama，这通常是 http://localhost:11434。对于 Azure 等兼容 OpenAI 的提供商，这是完整的部署 URL。
模型
- 目的：选择您想要使用的特定嵌入模型。
- 行为：可用模型的列表根据所选提供商而变化。将显示模型的向量维度（例如，1536 维），因为更改维度需要完全重新索引。
Qdrant URL
- 目的：您的 Qdrant 向量数据库的连接端点。
- 行为：这必须是指向您的本地或云端 Qdrant 实例的有效 URL（例如，http://localhost:6333）。
Qdrant API 密钥
- 目的：用于安全 Qdrant 实例的身份验证密钥。
- 行为：此字段是可选的，仅当您的 Qdrant 部署需要 API 密钥时才应使用。

高级配置字段

搜索得分阈值
- 目的：控制将代码片段视为匹配所需的最小相似性得分。
- 行为：使用滑块设置介于 0.0 和 1.0 之间的值。较低的值返回更多（但可能不那么相关）的结果，而较高的值返回更少、更精确的结果。
- 推荐设置：
  - 低 (0.15-0.3)：更广泛的结果，适合探索
  - 中 (0.4-0.5)：平衡的精确度和召回率（默认值：0.4）
  - 高 (0.6-0.8)：仅精确匹配
最大搜索结果数
- 目的：设置单个 codebase_search 返回的代码片段的最大数量。
- 行为：使用滑块调整限制。这有助于控制提供给 AI 的上下文量。