接入 AI Agent
接入支持的 AI Agent，并了解它何时使用 Zvec-Grep。
zg --install 将受支持的 AI Agent 接入 Zvec-Grep。Agent 与 CLI 使用同一个工作区索引，并获得紧凑且带来源位置的证据。
安装
使用引导式安装，或直接配置一个或多个目标：
zg --install
zg --install --target codex --yes
zg --install --target claude --target cursor --yes支持的目标包括 codex、claude、qwen、qoder、opencode、cursor、copilot、vscode、grok、pi、all 和 auto。安装器会保留 Zvec-Grep 管理块之外的配置。安装后请重启 Agent 或新建会话。
默认 stdio 连接会自动管理本地服务，无需手动配置 Server。
升级已有接入
将已有 0.2.x 启动配置迁移到原生 CLI，不增加新的接入：
zg --install --upgrade-installed --dry-run
zg --install --upgrade-installed修改过的配置文件旁会生成 .zg-upgrade-*.bak 备份。之后重新连接 Agent；HTTP 用户可运行 zg --server on 替换旧的后台服务。
可用的 MCP Tool
默认 Agent 接入只会暴露一个 Zvec-Grep 工具：
| 工具 | 用途 |
|---|---|
zvec_grep_search | 当措辞或位置未知，或需要语义理解、跨文件理解时，在索引中发现相关证据 |
使用默认工具集时，精确词语、文件名、路径和正则仍使用 Agent 自带的 grep 或 rg。--mcp-toolset full 还会暴露 Zvec-Grep 的 rg、索引管理和状态工具，参见本地 Server。
检索路由
Zvec-Grep 增加了工作区语义发现能力，但不会取代精确搜索工具：
| 意图 | 路径 |
|---|---|
| 精确词语、原文、标识符、文件名、路径或正则已经足够 | 原生 grep 或 rg |
| 措辞或位置未知，或需要跨文件理解信息 | zvec_grep_search |
| 已知精确线索，但仍需要更广的上下文 | 先 zvec_grep_search，再定向 grep 或 rg |
| 最新外部事实或与工作区无关的开放知识 | 外部信息源，而非 Zvec-Grep |
默认 Agent 工具集只暴露索引检索。索引缺失时，支持交互式设置的客户端可以提示用户选择模型并批准后台构建，构建完成后重试搜索。不支持该交互时，请先运行 zg --index；重建和删除仍需显式执行。
移除
zg --uninstall --target codex --yes
zg --uninstall --target all --yes该操作只移除 Zvec-Grep 管理的 Agent 配置，不会删除 npm 包或工作区索引。如果安装或连接失败，请查看故障排查。