报错只知道意思，不知道函数名？Kilo Code 可以按语义找代码

维护一个不熟悉的项目，知道要找“接口请求失败后的处理”，却猜不到代码里用了哪个函数名。这时只靠全文搜索，可能要轮番试 error、retry、fallback，得到一堆相关程度不同的命中。Kilo Code 的 semantic_search 提供另一种起点：按功能含义找代码块，再带着位置继续调查。

这个功能属于它的 Codebase Indexing，而不是装好聊天插件就自动具备的全部能力。值得展开的是搜索结果怎样帮助开发者进入真实源码。官方工具文档对此给出了明确输入与输出。

输入概念，拿回可继续读的代码

query 是必填的自然语言查询，path 是可选目录范围。官方样例包括“API 请求的错误处理”“数据库连接池设置”“测试数据和 mock 的准备”等，寻找的是实现概念，不要求代码中恰好包含同样文字。

搜索返回相关代码片段，以及工作区相对文件路径、起止行号和相似度。对于排错，这几样信息各有作用：片段帮助判断是不是目标逻辑，路径与行号让你打开源码，相似度用于安排候选顺序。它并没有直接给出“这里一定是 Bug”。

以官方的 API 错误处理查询为线索，可以先找 HTTP 错误响应与异常处理，再把范围限定到 src/api。如果项目把重试逻辑放在共享网络层，结果可能提示还要扩大目录。这里的工作仍是根据候选检查调用关系；语义检索解决的是从哪里开始看。

查的是建立好的索引

工具把查询转成 embedding，使用与代码索引一致的提供方，再到 Qdrant 中查找相近向量。可选的路径过滤随后把结果限制在相应目录。与全文搜索相比，这条路线多了“事先理解并索引代码块”的准备。

因此，采用条件应紧贴用途：需要在设置中启用并配置 Codebase Indexing，准备 embedding 服务与可访问的 Qdrant，仓库也要处于可搜索的索引状态。文档列出了 API 或 Ollama 等配置路径；走外部服务还是本地服务，会影响代码处理的数据流向与资源成本。

如果代码没有进入索引，搜索结果里就不会凭空出现它。官方还列出文件大小和 Tree-sitter 语言支持等范围限制。找不到目标时，先区分“概念没命中”与“文件没被索引”，避免不断修改提示词却没有触及问题。

把分数当线索，继续看实现

文档展示了按相似度排序的结果。这个数字描述查询与代码块的语义接近程度，不是程序正确率，也不是该位置导致报错的概率。最终还要结合日志、调用者和能复现问题的输入，判断应该改哪一处。

Kilo Code 仓库采用 MIT 许可，提供编辑器和 CLI 等入口；模型与索引服务的用量另算。对于经常进入陌生大项目的人，我会把它放在调查的前半段：先用问题含义找到几处可读源码，再用现有调试工具把候选收窄。它让不知道函数名时也有路可走，而不把阅读代码这一步省略掉。