init-playwright

用途：在 Vue 3 + Vite + TypeScript 的 pnpm monorepo 中首次接入 Playwright 工具链，适用于大屏/可视化项目的视觉回归测试，以及为 AI agent 提供浏览器驱动能力。安装命令：pnpm add -D -w @playwright/test @playwright/cli playwright-mcp，随后执行 pnpm exec playwright install chromium 并用 pnpm exec playwright --version 验证。三件套分工为 @playwright/test 编写与运行 e2e/视觉测试、@playwright/cli 生成 skills、playwright-mcp 供 AI 通过 MCP 驱动浏览器（pw_core 为 headless，pw_visual 为 headed）。工作流包括固定各子应用 dev server 端口、编写根级 playwright.config.ts、生成 AI skills 与更新记忆、配置 e2e 与视觉测试脚本及基线截图策略。资料记录两个环境坑：Node 22 下 prettier 的 --experimental-cli 可能导致提交崩溃，以及 playwright webServer 的 pnpm filter 会吞掉 --host 参数。重要限制：headless 并非轻量模式，无头 Chromium 仍执行完整渲染管线，在 3D 大屏页面下 CPU 消耗与有头模式接近；MCP 浏览器为长连接进程不会自动关闭，资料记录了一次 3 天内因 pw_core 反复截图导致 CPU 100% 并最终删除 Playwright 的事故。资料建议优先使用 pw_visual（headed）、控制截图频率、会话结束检查并清理残留 Chromium 进程，并给出 tasklist 与 taskkill 等排查命令。具体项目包名、端口与配置细节请以实际项目为准。