工作区索引

工作区索引可增强上下文理解能力，从而提升智能体回答准确性。首次打开项目时，你可以选择创建索引；后续更新支持配置以增量方式自动更新索引。可通过 .gitignore 和 .qoderignore 排除无需索引的文件，并支持 Workspace 级别的跨工程索引。 在数据处理上，工作区索引仅上传必要的代码文件（不包括配置、密钥等文件），用于在云端生成向量数据。生成后上传的代码文件即被销毁，云端仅保留向量数据。 索引用于提高跨代码库检索的相关性，不能替代打开并核对本次修改依赖的源文件。将生成产物、依赖目录、日志和本地敏感文件排除在索引外，可以让检索结果更聚焦于需要维护的项目内容。

​

检查工作区

1. 打开用户菜单并选择设置，或使用设置快捷键。
2. 在编码下选择工作区索引。
3. 选择要检查的工作区。
4. 查看索引状态。

状态为未索引时，选择开始索引。开启自动索引后，Qoder 会自动为文件数少于 10,000 的代码库创建并更新索引。 在索引排除中选择管理可编辑工作区根目录下的 .qoderignore。其匹配规则与 .gitignore 一致，并且 .gitignore 中列出的内容默认也会被排除。

​

排除不需要索引的文件

在 .qoderignore 中每行写一个匹配规则： 编辑完成后点击保存。不要仅为缩短索引时间而排除仍需要 Agent 查找的源代码目录；被排除的内容无法通过工作区索引检索。

​

确认结果

更新后，返回同一工作区中的任务，让 Qoder 查找一个已知符号或刚修改的文件。确认结果引用了预期文件，不要只依据设置页中的状态判断索引可用。

​

排查索引问题

索引没有按预期更新时，先确认工作区路径仍可访问，再检查 .gitignore 和 .qoderignore 是否排除了目标文件。返回设置 → 工作区索引并重新选择该工作区检查状态。文件数量达到 10,000 或更多的代码库不会由自动索引自动创建索引，请手动选择开始索引。