快速开始

把 Hover MCP 加到你已经在用的编码 agent，然后让它测试你的应用。你的应用、bundler 配置、依赖都不用改。

前置条件

一个会说 MCP 的编码 agent——Claude Code、Cursor 或类似的，已安装并登录。Hover 搭载它运行的模型；无需新的 API key。
一个你已经在跑的 dev server——任何 Hover 能通过 CDP 触达的框架（Vite、Next.js、Nuxt、Astro、webpack）。

还没有编码 agent？

Claude Code — npm install -g @anthropic-ai/claude-code，然后 claude login。用的是你可能已经付费的 Claude Pro / Max 订阅。
Cursor — 任何支持 MCP 的 agent 都行；在它的配置里把 @hover-dev/mcp 加为一个 MCP server。

全局安装 MCP，然后注册这个 bin（下面以 Claude Code 为例——任何支持 MCP 的 agent 都一样）：

npm i -g @hover-dev/mcp
claude mcp add hover -- hover-mcp

这就是全部安装。Hover 作为一个 MCP server 跑在你的 agent 之下——项目里没有插件、无需改 bundler 配置、无新依赖，也没有 Hover 自己的 key。

用你平时用的命令即可：

pnpm dev          # 或 `npm run dev`、`yarn dev`、`bun dev`

Hover 通过 CDP 驱动你现有的 dev server——不替换、不包裹、不重启它。

首次运行的调试版 Chrome

首次运行时，Hover 会提示你在 9222 端口启动一个隔离的调试版 Chrome（与你日常浏览器分开——<tmpdir>/hover-chrome 下的一个干净 profile）。之后的运行会复用它。Hover 绝不碰你正常的 Chrome 会话。

在你的 agent 里运行 Hover 工具：

/mcp__hover__test_app           # 探索应用并结晶出一整套 spec
/mcp__hover__test_app login     # …或只针对某一条流程

agent 通过 Hover 的接地浏览器工具探索你的应用——click_control / fill_control 等，它们按 role+name 定位控件，所以驱动动作的那个 selector 正是被存下来的那个。当一条流程验证通过，Hover 就结晶它。

spec 落在 __vibe_tests__/，是一个 <slug>.spec.ts 文件——纯 @playwright/test 代码，没有 LLM 在写代码（结晶是确定性的）。它进 git，在 CI 里以零 Hover 依赖运行。

这就是闭环：问一次 → agent 探索 → 结晶 → CI 永远回放，且保持 record == replay 的保真度。

存下来的 spec 就是纯 Playwright。在任何地方运行，无 AI、无 token、无 key：

npx playwright test __vibe_tests__

用 BASE_URL 把它们指向任意环境；同一套 spec 可跑在本地、staging 或 PR 预览上。Hover 能生成一个在每个 PR 上运行它们的 GitHub Actions workflow。