支持的 AI 工具

Inspecto 负责连接你的浏览器和 AI 助手。根据你的 AI 工具架构的不同，它支持多种交互模式。

当你使用结构化的 onboarding 流程或 npx @inspecto-dev/cli init 时，CLI 目前会自动探测两个安装面：CLI 工具和 IDE 插件。内置型 IDE 目标（Built-in IDE targets）在运行时仍受支持，但目前暂不会被 CLI 的 onboarding 探测功能自动识别。

接入向导 (Onboarding)

对于大多数用户，默认路径是由助手引导的接入流程 (assistant-first onboarding)：

1. 在目标项目根目录运行 npx @inspecto-dev/cli integrations install <assistant> --host-ide <ide>。
2. 跟随 CLI 拉起的 onboarding 流程，并敲击回车键发送自动填充的提示词。
3. 如果 onboarding 流程没有自动打开，请开启一个新的 assistant 会话并要求其在这个项目中设置 Inspecto。
4. 仅当你想在运行安装之前检查阻止项，或者需要排查问题时，才使用 npx @inspecto-dev/cli integrations doctor <assistant> --host-ide <ide> --compact。

然后在浏览器中打开应用，使用 launcher 体验「检查模式」或「标注模式」，也可以随时使用 Alt + 点击 来触发「快速跳转」。

如果你是在终端里手动设置 Inspecto，请使用 npx @inspecto-dev/cli init 作为引导回退方案。

如果你在开发自己的 agent/runtime 集成，请直接使用结构化的 onboarding 流程：

1. 运行 inspecto onboard --json
2. 如果 status 是 needs_target_selection，先说明这一步是在选择要接入 Inspecto 的本地开发构建目标，然后使用返回结果中的某个 candidate id 带上 --target <candidateId> 重新运行。CLI 也兼容接受返回里的 configPath 作为兜底值。
3. 如果 status 是 needs_confirmation，确认计划的变更后带上 --yes 重新运行
4. 首先完成必选的 ideExtension 步骤（如果可能就自动安装，否则展示安装链接/命令）
5. 然后遵循 verification 指导来重启 dev-server，或提示用户手动验证
6. 如果 status 是 error，运行 inspecto doctor --json

关于字段级的响应语义和状态处理，请参阅 Onboarding 集成 以及 onboarding 命令文档。

当 onboarding 配置为 Agent 驱动的 annotate 交付方式时，返回的 JSON 结果里还可能包含一个结构化的运行时交接信息：

{
  "handoff": {
    "dailyUsage": {
      "mode": "agent",
      "skill": "inspecto-agent",
      "prompt": "Use $inspecto-agent to claim Inspecto tasks continuously",
      "requiresMcp": true
    }
  }
}

如果存在 handoff.dailyUsage，应优先使用它，而不是硬编码后续提示语。它才是日常 MCP 驱动标注工作流的规范化 post-onboarding 入口。

交互模式

你可以把下面这些模式理解成不同的交付路线：

路线	适合场景	是否需要 IDE 插件
IDE route	把 Inspect / Annotate prompt 立即交给 AI 面板	通常需要；内置 IDE 目标除外
CLI route	把 prompt 发送给终端里的 assistant	通常需要，用于打开/管理终端
MCP route	可持久化标注 session、浏览器 timeline、自定义 workflow	不需要
纯浏览器 / 剪贴板 route	手动复制上下文，或配合暂未支持的编辑器	不需要

如果你想使用 deploy、PR、release、测试自动化等自定义 workflow 按钮，优先选择 MCP route。它可以让 Inspecto 创建 workflow session，并让 Agent 使用自身已有的 skill、MCP server 和 tool 执行。

1. 插件模式 (Extension Mode)

AI 工具作为 IDE 插件安装（例如在 VS Code 中）。Inspecto 将使用 IDE 自定义的 URI scheme 将提示词分发到 AI 聊天面板。

支持的工具：

• GitHub Copilot (copilot.extension)
• Claude Code (claude-code.extension)
• Gemini Code Assist (gemini.extension)
• CodeX (codex.extension)

2. 内置模式 (Built-in Mode)

AI 工具原生集成在修改版的 IDE 中。不需要安装任何插件。Inspecto 将打开本地文件并触发原生的 AI 聊天面板。

支持的工具：

• Cursor (cursor.builtin)
• Trae (trae.builtin)
• CodeBuddy (codebuddy.builtin)

3. CLI 模式 (CLI Mode)

AI 工具完全在终端内运行。Inspecto 将在你的 IDE 中打开一个新的终端面板，启动 CLI 工具（如果尚未运行），并粘贴提示词。

支持的工具：

• Claude Code CLI (claude-code.cli)
• Trae CLI / Coco (coco.cli)
• Gemini CLI (gemini.cli)
• CodeX CLI (codex.cli)

切换 Provider

结构化的 onboarding 流程和 init 命令将探测可用的 CLI 工具和兼容 VS Code 的插件，然后提示你选择默认目标。工作区推荐的插件也可能出现在该探测结果中，因此最好将结果视为“可用的集成候选项”，而不是本地已安装 AI 工具的严格列表。

如果之后想要更改，只需更新你的 .inspecto/settings.local.json：

{
  "provider.default": "claude-code.cli"
}

独立运行 / 剪贴板模式支持

如果你不想使用任何 IDE 插件或 CLI 终端，你可以将 Inspecto 配置为独立运行模式：

{
  "ide": "none"
}

在这种模式下，Inspecto 依赖以下方式：

1. MCP (Model Context Protocol)：用于将标注会话交付给正在运行的 agent（请参阅 MCP 集成）
2. 剪贴板集成 (Clipboard)：UI 上会提供一个“复制上下文”按钮，它可以将格式化好的 Markdown 直接写入剪贴板，方便你粘贴到任何地方。