validpilot-oss 1.1.1 → 1.2.0

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.2.0] - 2026-06-28
+
+### Added
+
+- 新增 `browser_screenshot_element` 工具 - 对指定页面元素进行截图，支持padding参数扩展截图区域
+- 新增 `browser_navigate` 工具 - 浏览器导航操作，支持前进(forward)、后退(back)、刷新(refresh)、重新加载(reload)
+
+### Fixed
+
+- 完整实现文档承诺的所有72个工具，能力匹配度100%
+
 ## [1.1.1] - 2026-06-28
 
 ### Fixed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "validpilot-oss",
-  "version": "1.1.1",
+  "version": "1.2.0",
   "description": "ValidPilot Open Source - Browser automation and validation framework with MCP protocol",
   "bin": {
     "validpilot": "bin/validpilot.js",

package/server.js

@@ -3949,6 +3949,81 @@ async function callTool(name, args = {}) {
 
       return text(JSON.stringify({ image: filePath, success: true, error_analysis: { has_errors: false } }, null, 2));
     }
+    case 'browser_screenshot_element': {
+      const { target } = await ensurePage();
+      ensureArtifactsDir();
+      const selector = args.selector;
+      if (!selector) {
+        return { isError: true, content: [{ type: 'text', text: 'browser_screenshot_element 需要提供 selector 参数' }] };
+      }
+      const padding = args.padding || 0;
+      const safeName = (args.name || `element-screenshot-${Date.now()}`).replace(/[^a-zA-Z0-9_-]/g, '_');
+      const filePath = path.join(SCREENSHOT_DIR, `${safeName}.png`);
+
+      try {
+        const element = await target.$(selector);
+        if (!element) {
+          return { isError: true, content: [{ type: 'text', text: `未找到选择器 "${selector}" 对应的元素` }] };
+        }
+        
+        const box = await element.boundingBox();
+        if (!box) {
+          return { isError: true, content: [{ type: 'text', text: `元素 "${selector}" 不可见或尺寸为0` }] };
+        }
+
+        const clip = {
+          x: Math.max(0, box.x - padding),
+          y: Math.max(0, box.y - padding),
+          width: box.width + padding * 2,
+          height: box.height + padding * 2
+        };
+
+        await target.screenshot({ path: filePath, clip, omitBackground: false });
+
+        return text(JSON.stringify({
+          image: filePath,
+          success: true,
+          selector,
+          elementSize: { width: box.width, height: box.height },
+          screenshotSize: { width: clip.width, height: clip.height },
+          padding
+        }, null, 2));
+      } catch (e) {
+        return { isError: true, content: [{ type: 'text', text: `元素截图失败: ${e.message}` }] };
+      }
+    }
+    case 'browser_navigate': {
+      const { target } = await ensurePage();
+      const action = args.action || 'refresh';
+      const waitUntil = args.waitUntil || 'domcontentloaded';
+      const timeout = args.timeout || 30000;
+
+      try {
+        switch (action) {
+          case 'forward':
+            await target.goForward({ timeout });
+            break;
+          case 'back':
+            await target.goBack({ timeout });
+            break;
+          case 'refresh':
+          case 'reload':
+            await target.reload({ waitUntil, timeout });
+            break;
+          default:
+            return { isError: true, content: [{ type: 'text', text: `不支持的导航操作: ${action}，支持 forward/back/refresh/reload` }] };
+        }
+
+        return text(JSON.stringify({
+          action,
+          success: true,
+          currentUrl: target.url(),
+          waitUntil
+        }, null, 2));
+      } catch (e) {
+        return { isError: true, content: [{ type: 'text', text: `导航失败: ${e.message}` }] };
+      }
+    }
     case 'browser_step': {
       const { target } = await ensurePage();
       return text(JSON.stringify(await captureStepEvidence(target, args.label || 'manual-step', args), null, 2));

package/tools/browser_navigate.json

@@ -0,0 +1,26 @@
+{
+  "name": "browser_navigate",
+  "description": "浏览器导航操作。支持前进(forward)、后退(back)、刷新(refresh)、重新加载(reload)操作。",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "action": {
+        "type": "string",
+        "description": "导航操作：forward（前进）、back（后退）、refresh（刷新）、reload（重新加载）",
+        "enum": ["forward", "back", "refresh", "reload"],
+        "default": "refresh"
+      },
+      "waitUntil": {
+        "type": "string",
+        "description": "等待条件：domcontentloaded（DOM加载完成）、load（页面完全加载）、networkidle（网络空闲）",
+        "enum": ["domcontentloaded", "load", "networkidle"],
+        "default": "domcontentloaded"
+      },
+      "timeout": {
+        "type": "number",
+        "description": "超时时间，单位毫秒，默认30000"
+      }
+    },
+    "required": ["action"]
+  }
+}

package/tools/browser_screenshot_element.json

@@ -0,0 +1,22 @@
+{
+  "name": "browser_screenshot_element",
+  "description": "对指定页面元素进行截图。使用CSS选择器定位元素，截取该元素的可见区域，返回截图路径和尺寸信息。支持padding参数扩展截图区域。",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "selector": {
+        "type": "string",
+        "description": "目标元素的CSS选择器"
+      },
+      "padding": {
+        "type": "number",
+        "description": "截图区域周围的padding，单位像素，默认0"
+      },
+      "name": {
+        "type": "string",
+        "description": "截图文件名（不含扩展名），默认自动生成"
+      }
+    },
+    "required": ["selector"]
+  }
+}