Vite Pilot 浏览器测试

问题

写前端页面时，agent 或开发者常只能靠代码推断 UI 是否可用。登录按钮没反应、弹窗未渲染、复选框状态错误、Vue/React 的 v-model 未触发 input 事件，这些问题需要在真实浏览器里观察。vite-plugin-pilot 解决的是这种“代码与页面状态不同步”的测试缺口。

工作方式

它通过 HTTP API 与 SSE 在浏览器执行 JS，把页面状态、交互结果和日志带回会话。核心能力包括：

• run 'code' 默认返回代码预览、执行结果、控制台日志和页面快照
• page 查看 compact snapshot，元素以 tag#idx 表示
• 文本匹配函数如 __pilot_clickByText、__pilot_typeByPlaceholder、__pilot_waitFor
• 索引操作函数如 __pilot_click、__pilot_setValue、__pilot_getRect
• 多 tab 实例选择、实例列表与 PILOT_INSTANCE 切换

适用边界

它更适合 Vite 项目或可接入浏览器控制台的调试场景。使用 Vue/React 时，应优先用 __pilot_typeByPlaceholder 或 __pilot_setValueByPlaceholder 触发 input 事件；跨多次执行可能导致状态丢失，相关操作宜在同一 exec 完成。同名按钮、v-if 弹窗、checkbox 更新都要用 snapshot 的 #idx 或等待文本出现后再操作。