Vexor 语义文件搜索

要解决什么问题

在大型仓库里用 grep 或文件名搜索，往往只能匹配字面量；当你想找「处理 OAuth 回调的那段逻辑」「和向量索引相关的配置」这类语义相近但关键词不一致的文件时，传统工具很容易漏掉或需要多轮试错。

Vexor 走的是基于向量的 CLI 路径：把文件内容（或片段）嵌入向量空间，再用自然语言或短句查询做语义检索，更适合「我知道在干什么，但不知道叫什么文件」的场景。

技能如何帮你用

本技能不替代 Vexor 二进制本身，而是为 Agent 提供使用模式与边界说明，便于在 Claude / Codex 工作流里正确调用：

• 明确何时应优先用语义搜索，而不是全文 grep 或目录遍历
• 把「查询意图 → CLI 参数 / 结果解读」整理成可复用的对话上下文
• 与 Claude/Codex 技能配合，减少误用（例如把向量结果当成唯一真相而不做二次打开文件确认）

具体命令与索引策略以源仓库文档为准；技能侧重点是检索思路与协作方式。

适用边界

• 依赖本地或项目内已建立的向量索引；索引未更新时，语义结果可能滞后于最新提交
• 语义搜索适合缩小候选文件范围，关键改动仍应打开文件核对行级上下文
• 若仓库极小或问题已是精确符号名，字面搜索往往更快，不必强行走向量路径