|
|
@@ -33,6 +33,18 @@
|
|
|
- 检查 error 级别的日志
|
|
|
- 常见问题:模块导入失败(如 `Failed to resolve import`)、组件渲染错误、TypeScript/JavaScript 运行时错误
|
|
|
- 示例场景:SSR 渲染超时(`渲染超时,终止请求`)、页面 `#root` 元素为空、模块脚本加载失败
|
|
|
+ - **图片 MCP 配合使用**: Playwright MCP 与图片 MCP(如 zai-mcp-server)配合使用可以更高效地进行测试验证
|
|
|
+ - **工作流程**:
|
|
|
+ 1. 使用 Playwright MCP 导航到页面并截图:`browser_take_screenshot`
|
|
|
+ 2. 使用图片 MCP 查看截图内容,分析页面状态
|
|
|
+ 3. 根据分析结果进行调试或修复问题
|
|
|
+ 4. 在代码审查时使用图片 MCP 验证测试截图的正确性
|
|
|
+ - **优点**:
|
|
|
+ - 可以直观看到页面实际渲染效果
|
|
|
+ - AI 可以识别页面元素和布局问题
|
|
|
+ - 验证测试数据是否正确显示(如脱敏、格式等)
|
|
|
+ - 快速定位 UI 问题而不需要手动查看截图
|
|
|
+ - **示例提示词**: "使用 Playwright MCP 截图后,用图片 MCP 分析截图中的页面元素和测试结果"
|
|
|
- **推荐使用子代理运行**: 运行 Playwright E2E 测试时,使用 Task 工具的 Bash 子代理方式运行,速度更快且多个 Playwright 进程不会冲突
|
|
|
- 示例提示词: "在 web 目录下运行 `pnpm exec playwright test --config=tests/e2e/playwright.config.ts --project=chromium --grep \"测试名称\"`"
|
|
|
- 运行所有E2E测试: `pnpm test:e2e:chromium`
|
|
|
@@ -95,6 +107,12 @@ Task({
|
|
|
- Story 文件: `_bmad-output/implementation-artifacts/*.md`
|
|
|
- Epic 文件: `_bmad-output/planning-artifacts/epics.md`
|
|
|
|
|
|
+### ⚠️ API 并发错误处理
|
|
|
+当子代理在运行时遇到 API 并发报错(如 "您当前使用该API的并发数过高")时:
|
|
|
+- **不要停止工作**,只需要等待 1-2 秒后继续重试即可
|
|
|
+- 这是因为同时启动了多个子代理导致的暂时性限制
|
|
|
+- 系统会自动恢复,重试通常能够成功
|
|
|
+
|
|
|
---
|
|
|
|
|
|
## 其他开发说明
|