快速开始
Inspecto 适合这样一种场景：你已经在浏览器里看到了问题，现在想立刻定位源码，或者把正确上下文交给当前配置的 AI Agent。
快速接入
第一次使用时，不需要先理解 MCP、IDE route 或各种安装层级。只要做一件事：选你正在用的编辑器 / AI 助手，然后运行一条命令。
这条命令会帮你接入最常用的完整体验：
- 浏览器里点击组件，自动带上源码上下文；
Alt + 点击直接打开源码；- 在 Inspect / Annotate 模式里把上下文交给你的 AI 助手。
- 后续也可以增加项目专属 workflow 按钮，例如
Deploy Preview、Review & PR或Release。
在项目根目录运行其中一条命令：
npx @inspecto-dev/cli integrations install copilot --host-ide vscodenpx @inspecto-dev/cli integrations install claude-code --scope project --host-ide vscodenpx @inspecto-dev/cli integrations install cursor --host-ide cursornpx @inspecto-dev/cli integrations install trae --host-ide trae-cnnpx @inspecto-dev/cli integrations install codex --host-ide vscodenpx @inspecto-dev/cli integrations install gemini --host-ide vscodenpx @inspecto-dev/cli integrations install coco --host-ide trae-cnnpx @inspecto-dev/cli integrations install codebuddy --host-ide codebuddy-cn(如果你使用其他包管理器，可以用 pnpm dlx、yarn dlx 或 bunx 代替 npx)。
不知道选哪条？按这个规则选：
- 用 VS Code + Copilot：选
Copilot。 - 用 Cursor：选
Cursor。 - 用 Trae CN：选
Trae；如果你用的是 Coco，选Coco。 - 用 CodeBuddy：选
CodeBuddy。 - 只想要源码跳转、不接 AI：看手动安装。
- 只想让独立 MCP Agent 处理任务、不装 IDE 扩展：看 MCP 集成。
命令执行后，Inspecto 会尝试在你的 IDE 中打开 onboarding 会话。如果没有自动打开，请开启一个 AI 助手聊天并发送下面这句固定英文口令：
"Set up Inspecto in this project"
需要了解自动接入做了什么？请查看 Onboarding 集成。
接入完成后
- 重启开发服务器（如
npm run dev），让 Inspecto 插件读取到新配置。 - 在浏览器中打开你的应用 —— 你应该能看到 Inspecto 的 launcher 悬浮层。
- 试试看：
Alt + 点击任意组件跳转到源码- 点击 launcher 选择「检查模式」或「标注模式」
- 在「标注模式」里收集一个或多个 UI 批注；MCP 通道点击「创建任务」创建结构化任务，IDE 通道则点击「问 AI」进行一次性派发
如果你的项目使用 MCP 标注链路（"delivery.mode": "mcp"），标注侧栏还会展示最近任务的 timeline。你可以用它确认任务已经入队、被 Agent 领取、收到进度回复，并最终完成或关闭。
如果你想做自定义自动化，可以在 .inspecto/prompts.json 中增加 kind: "workflow" 条目。它们会显示为「标注模式」里的 workflow 按钮。按钮可以把 deploy、PR、release 或 review 指令交给 Agent；Agent 再利用自身已有的 skill、MCP server 和 tool 完成任务，同时由 Inspecto 追踪 session 进度。
如果组件没有高亮，或者 IDE 没有收到代码，请运行：
npx @inspecto-dev/cli doctor遇到问题？
常见问题的排查（快捷键冲突、IDE 插件无响应等），请参考常见问题与排查指南 (FAQ)。