vitexec
让AI代理在Vite应用内部快速运行脚本
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：vitexec。 它的用途是：让AI代理在Vite应用内部快速运行脚本 完整的 Skill 内容见：https://321skill.com/skills/vitexec/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“使用 vitexec 测试 Three.js 场景中的相机移动，运行脚本：`vitexec --gpu --path /scene 'import { app } from \"/src/app.ts\"; window.dispatchEvent(new KeyboardEvent(\"keydown\", { code: \"KeyW\" })); await new Promise(r => setTimeout(r, 1000)); window.dispatchEvent(new KeyboardEvent(\"keyup\", { code: \"KeyW\" })); const { camera } = app.getSnapshot(); console.log(\"camera position:\", camera.position);'`”，它会启动浏览器，执行脚本，并返回相机位置日志。
介绍
解决什么问题：AI代理在控制浏览器时，每一步点击、等待、检查都非常缓慢，尤其对于交互式应用（如3D场景、游戏、实时画布），需要多步操作才能完成一次测试。vitexec 让代理直接在你的 Vite 应用内部运行一段脚本，而不是通过浏览器一步步操作，大幅提升效率。
怎么用：安装后，只需告诉AI代理使用 $vitexec 并传入脚本。脚本可以导入真实 Vite 模块（如 Three.js 场景对象），驱动键盘/鼠标输入，等待帧渲染，检查运行时状态，并输出日志。每个运行都获得独立的 Vite 服务器和 Playwright 浏览器，支持截图、视频、CPU 分析、网络 HAR 等证据收集。
适合谁：适合前端开发者、测试工程师、智能体开发者，尤其是那些需要频繁测试 Three.js 场景、相机控制、物理模拟、Canvas/WebGL 应用，或者需要从运行时获取精确状态（而非仅凭截图判断）的团队。
使用建议：确保你的项目基于 Vite 构建。脚本编写时可以利用 Async/Await 等待帧或超时，避免直接操作 DOM 的复杂选择器。对于需要精确用户交互（如拖拽到特定坐标）的场景，可能仍需要结合 Playwright 的定位器，但大部分状态检查和流程控制已足够。
核心特点
同类工具（如 Playwright 或 Puppeteer 的 AI 技能）让代理通过浏览器 API 一步步操作，而 vitexec 让代理在应用内部运行完整的 JavaScript 脚本，可以导入真实模块、驱动输入、等待帧、分支状态，并一次性获取日志和证据，无需多次浏览器交互。
注意事项
仅适用于 Vite 构建的项目，且不适合需要精确模拟用户点击、拖拽等复杂交互的测试场景（如需要定位具体 DOM 元素并触发事件）。
常见问题
如何安装 vitexec？
运行 `npx skills add drawcall-ai/vitexec` 即可安装，然后告诉AI代理使用 $vitexec。
vitexec 支持远程浏览器吗？
支持，通过 `--browser-ws-endpoint` 或环境变量 `VITEXEC_BROWSER_WS_ENDPOINT` 连接远程 Playwright 浏览器。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/vitexec/raw/index.md 读取 vitexec 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/vitexec/raw/index.md（查看排版版本）