代码库索引(Codebase Indexing)

Kiro 会自动为你的代码库和文档建立索引,以便提供智能的代码建议、导航支持以及上下文感知的辅助功能。本指南将介绍索引的工作原理以及如何进行管理。

索引何时发生(When Indexing Occurs)

自动索引(Automatic Indexing)

Kiro 会在以下几种情况中自动执行索引:

  1. 项目导入(Project Import):当你首次在 Kiro 中打开项目时,它会自动开始索引工作区中的所有文件
  2. 文件变更(File Changes):当你新建或添加文件到项目中时,这些文件会被自动索引
  3. 外部变更(External Changes):如果文件在 Kiro 之外被修改(例如通过 git 操作),它们也会被重新索引

手动索引(Manual Indexing)

当你需要时,也可以通过 Command Palette(命令面板)手动触发索引:

  • macOS:Cmd+Shift+P
  • Windows/Linux:Ctrl+Shift+P

可用的索引命令(Available Indexing Commands)

Kiro 通过 Command Palette 提供以下索引相关命令:

Kiro indexing commands in 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 的日志面板来查看索引的执行情况:

  1. 打开 Kiro 的 Output(输出)面板
  2. 在下拉菜单中选择 “Kiro Logs”
  3. 查看索引的实时进度和状态更新

Kiro Logs showing indexing progress

日志内容包括:

  • 索引开始和结束的时间
  • 检测并处理的文件数量
  • 对于大型代码库的进度百分比
  • 索引操作的完成时间

索引的内容类型(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)