用途：Vexor CLI 是用于语义化文件发现的命令行技能，目标是按文件的用途（做什么）而非精确文本查找文件，适合在中大型代码库中定位某功能在哪实现、加载或定义。
主要能力：通过 vexor "<QUERY>" 进行意图搜索，支持 --path/-p 指定根目录、--mode/-m 选择索引与搜索策略、--ext/-e 限定扩展名、--exclude-pattern 按 gitignore 风格排除路径（可重复，.js 展开为 **/*.js）、--top/-k 控制结果数、--include-hidden 包含隐藏文件、--no-respect-gitignore 包含被忽略文件、--no-recursive 仅顶层目录、--format 选择 rich/porcelain/porcelain-z/json 输出、--content 同时打印匹配源码、--no-cache 仅用内存不读写索引缓存。模式包括 auto、name、head、brief、code、outline、full。使用 vexor index --local 创建项目本地 .vexor/ 缓存。
使用方式：首次搜索会建立索引，可能需等待一段时间。结果返回相似度排序、文件位置、行号和片段预览；加 --content 或 --format json 可在同一次调用中获得匹配源码，其文本位于 content_start_line..content_end_line，长符号被拆分成多个块时起始行可能晚于结果的 start_line。若结果出现 stale_line_range，说明文件在索引后已变更，需重跑 vexor index。内容按响应有上限，排名较低的结果可能报 budget_exhausted。
配置：最近的 .vexor/config.json 会自动生效，仅接受 rerank、auto_index、model、embedding_dimensions、batch_size、embed_concurrency、extract_concurrency；batch_size 至少 0，两个并发值至少 1。凭据与端点（api_key、base_url、remote_rerank）及其他字段会被拒绝。优先级为全局配置、项目配置、环境覆盖、显式参数。vexor config --show 会标注每个字段来源，vexor doctor 列出活动覆盖项；修改配置的命令仍仅限全局。
限制与排错：精确标识符搜索效果弱时，可建议执行一次 vexor config --rerank hybrid 融合词法与语义匹配。需要脚本化输出用 --format porcelain（TSV）或 --format porcelain-z（NUL 分隔）。详细帮助用 vexor search --help。若缺少 vexor，按 references/install-vexor.md 安装。