代码库索引(Codebase Indexing)
Kiro 会自动为你的代码库和文档建立索引,以便提供智能的代码建议、导航支持以及上下文感知的辅助功能。本指南将介绍索引的工作原理以及如何进行管理。
索引何时发生(When Indexing Occurs)
自动索引(Automatic Indexing)
Kiro 会在以下几种情况中自动执行索引:
- 项目导入(Project Import):当你首次在 Kiro 中打开项目时,它会自动开始索引工作区中的所有文件
- 文件变更(File Changes):当你新建或添加文件到项目中时,这些文件会被自动索引
- 外部变更(External Changes):如果文件在 Kiro 之外被修改(例如通过 git 操作),它们也会被重新索引
手动索引(Manual Indexing)
当你需要时,也可以通过 Command Palette(命令面板)手动触发索引:
- macOS:
Cmd+Shift+P
- Windows/Linux:
Ctrl+Shift+P
可用的索引命令(Available Indexing Commands)
Kiro 通过 Command Palette 提供以下索引相关命令:
代码库索引(Codebase Indexing)
Kiro: Codebase Force Re-Index
:强制对整个代码库进行重新索引。适用于以下场景:- 你怀疑当前索引已损坏或不完整
- 项目发生了重大结构变更
- Kiro 提供的代码建议显得过时
Kiro: Rebuild codebase index
:从零开始彻底重建代码库索引,比强制重新索引更彻底。适用于:- 索引严重损坏
- 经常性遇到代码导航或智能建议异常的问题
文档索引(Documentation Indexing)
Kiro: Docs Index
:开始对项目中的文档文件进行索引Kiro: Docs Force Re-Index
:强制对所有文档文件进行重新索引
监控索引进度(Monitoring Indexing Progress)
你可以通过 Kiro 的日志面板来查看索引的执行情况:
- 打开 Kiro 的 Output(输出)面板
- 在下拉菜单中选择 “Kiro Logs”
- 查看索引的实时进度和状态更新
日志内容包括:
- 索引开始和结束的时间
- 检测并处理的文件数量
- 对于大型代码库的进度百分比
- 索引操作的完成时间
索引的内容类型(Indexed Content)
Kiro 会对以下类型的内容建立索引,以实现智能辅助功能:
- Source Code(源代码):工作区中所有编程语言的代码文件
- Documentation(文档):Markdown、MDX 及其他格式的文档文件
- Configuration(配置):项目的配置文件和 manifest
- Dependencies(依赖):依赖包定义和依赖关系信息
这些索引数据支持以下功能:
- 智能代码补全(Intelligent code completion)
- 跨文件导航(Cross-file navigation)
- 上下文感知建议(Context-aware suggestions)
- 文档快速查找(Documentation lookup)
- 代码重构辅助(Code refactoring assistance)