Преглед на файлове

docs: 添加图片 MCP 与 Playwright MCP 配合使用说明

- 新增"图片 MCP 配合使用"小节
- 说明工作流程:截图 → 图片分析 → 调试修复 → 验证
- 列出优点:直观看到页面效果、识别元素、验证数据、快速定位问题
- 添加示例提示词

Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)

Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>
yourname преди 2 дни
родител
ревизия
ad2c0ea200
променени са 1 файла, в които са добавени 18 реда и са изтрити 0 реда
  1. 18 0
      CLAUDE.md

+ 18 - 0
CLAUDE.md

@@ -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 秒后继续重试即可
+- 这是因为同时启动了多个子代理导致的暂时性限制
+- 系统会自动恢复,重试通常能够成功
+
 ---
 
 ## 其他开发说明