用途:在 next dev 的编辑—验证循环中,改完代码后确认改动在运行时真实生效,而不只是编译或类型检查通过。
主要能力:通过同一运行应用的两个观察面互相印证。/ _next/mcp 是 Next.js 暴露的 HTTP 端点,了解路由、segment、RSC、server actions、服务端日志与错误;先调用 tools/list 查看可用工具。agent-browser 是驱动真实 Chrome 的 CLI,了解 DOM、控制台、网络、React fiber、vitals;首次使用前运行 agent-browser skills get core 获取版本匹配的用法说明。
使用要求:Next.js 16.3+ 且使用 Turbopack,agent-browser >= 0.31.1,均为硬性下限;缺任一条件应告知用户升级并停止,不要退回到 grep 源码或更弱的探测方式。升级命令:pnpm next upgrade(或 npx next upgrade);安装或升级 agent-browser:npm i -g agent-browser@latest。
用法:会话开始时做 preflight。用 agent-browser session id --scope worktree --prefix next-dev-loop 生成稳定会话 id,导出 AGENT_BROWSER_SESSION 与 AGENT_BROWSER_RESTORE,然后以 agent-browser --session "$SESSION" --restore --enable react-devtools open <url> 打开目标 URL。探测 /_next/mcp 的 tools/list,确认可达且包含 get_compilation_issues,并从 next dev 输出读取端口,必要时设置 NEXT_MCP_URL。编辑前用 /_next/mcp 定位当前路由由哪些文件渲染,缩小搜索范围;编辑后依次核查四类失败:能否编译、运行时有无错误、行为是否符合预期、React 层行为(组件树、props、state、渲染次数)。结束用 agent-browser --session "$SESSION" --restore close 关闭会话,保留 next dev 继续下一轮。
适用场景:日常在 next dev 中修改应用代码后的验证。
限制与注意:运行期间保留 .next 目录,移动或删除会断开服务器与生成状态的连接;两个观察面不一致时先怀疑工具链,例如陈旧或指向错误的浏览器会话;导航后 React introspection 输出会过期,需重新运行;/_next/mcp 回复是 SSE,需从 data: 行读取 JSON;get_errors 与 get_page_metadata 需要至少一次导航。仅当项目已加载托管 Next.js 反馈说明时才参与 agent 反馈。其他细节暂未提供。