@dommaker/harness 0.13.0 → 0.13.2

package/src/tools/definitions/ext/browser/browser-mcp-debug.yml

@@ -0,0 +1,167 @@
+# browser-mcp-debug.yml - Chrome DevTools 高级调试能力
+name: browser-mcp-debug
+description: |
+  基于 Chrome DevTools Protocol 的高级浏览器调试能力，提供：
+  - 网络监控：捕获所有 HTTP 请求/响应，分析 API 调用
+  - 性能分析：Core Web Vitals、资源加载时间、渲染性能
+  - 内存检测：检测内存泄漏，分析堆增长趋势
+  - 安全审计：检查 HTTPS、CSP、混合内容等安全问题
+
+# 输入参数
+input:
+  url:
+    type: string
+    required: true
+    description: 要分析的页面 URL
+  
+  diagnostic_type:
+    type: string
+    required: false
+    default: "all"
+    enum: [network, performance, memory, security, all]
+    description: 诊断类型
+  
+  timeout:
+    type: number
+    required: false
+    default: 60000
+    description: 超时时间（毫秒）
+
+# 输出
+output:
+  network_analysis:
+    type: object
+    description: 网络分析结果
+    properties:
+      summary:
+        type: object
+        properties:
+          totalRequests: { type: number }
+          successfulResponses: { type: number }
+          failedRequests: { type: number }
+      slowRequests:
+        type: array
+        description: 最慢的 10 个请求
+      apiCalls:
+        type: array
+        description: API 调用列表
+  
+  performance_audit:
+    type: object
+    description: 性能审计结果
+    properties:
+      webVitals:
+        type: object
+        properties:
+          lcp: { type: number, description: "Largest Contentful Paint (ms)" }
+          fcp: { type: number, description: "First Contentful Paint (ms)" }
+          cls: { type: number, description: "Cumulative Layout Shift" }
+          fid: { type: number, description: "First Input Delay (ms)" }
+      metrics:
+        type: object
+        description: 浏览器性能指标
+      resources:
+        type: object
+        description: 资源加载分析
+  
+  memory_analysis:
+    type: object
+    description: 内存分析结果
+    properties:
+      summary:
+        type: object
+        properties:
+          initialHeapMB: { type: number }
+          finalHeapMB: { type: number }
+          growthPercent: { type: number }
+          potentialLeak: { type: boolean }
+      recommendation:
+        type: string
+  
+  security_audit:
+    type: object
+    description: 安全审计结果
+    properties:
+      summary:
+        type: object
+        properties:
+          totalIssues: { type: number }
+          high: { type: number }
+          medium: { type: number }
+          low: { type: number }
+      issues:
+        type: array
+        description: 发现的安全问题
+      secure:
+        type: boolean
+
+# 执行配置
+timeout: 600  # 10 分钟
+agent: codex
+
+# 执行脚本
+handler: script
+script: ./browser-mcp-debug.sh
+
+# 示例用法
+examples:
+  - name: 全量诊断
+    input:
+      url: https://example.com
+      diagnostic_type: all
+  
+  - name: 网络监控
+    input:
+      url: https://api.example.com
+      diagnostic_type: network
+  
+  - name: 性能分析
+    input:
+      url: https://example.com/dashboard
+      diagnostic_type: performance
+  
+  - name: 内存泄漏检测
+    input:
+      url: https://example.com/spa
+      diagnostic_type: memory
+  
+  - name: 安全审计
+    input:
+      url: https://example.com/login
+      diagnostic_type: security
+
+# 与 Puppeteer 的区别
+comparison:
+  puppeteer:
+    strengths:
+      - 简单易用，快速上手
+      - 适合基础 E2E 测试
+      - 稳定可靠，生态成熟
+    limitations:
+      - 需要自己封装 CDP 功能
+      - 调试能力有限
+  
+  browser_mcp_debug:
+    strengths:
+      - 直接暴露 CDP 全部能力
+      - 专业的性能/安全分析
+      - 内存泄漏检测
+      - 详细的网络监控
+    best_for:
+      - 性能优化
+      - 安全审计
+      - 内存问题排查
+      - 深度调试
+
+# 标签
+tags:
+  - browser
+  - debugging
+  - performance
+  - security
+  - memory
+  - cdp
+  - chrome-devtools
+
+# 分类
+category: debugging

package/src/tools/definitions/ext/browser/browser-start.sh

@@ -0,0 +1,101 @@
+#!/bin/bash
+# browser-start.sh - 启动浏览器会话
+# ============================================================================
+# 功能：启动浏览器并打开指定 URL
+# 底层：使用 agent-browser-stealth (abs)
+# 用途：为 E2E 测试、浏览器自动化提供会话
+# ============================================================================
+
+set -e
+
+# 参数
+URL="${1:-}"
+HEADLESS="${2:-true}"
+BROWSER="${3:-chromium}"
+SESSION_NAME="${SESSION_NAME:-browser-session-$(date +%s)}"
+
+# 颜色输出
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m'
+
+log_info() { echo -e "${GREEN}[INFO]${NC} $1"; }
+log_error() { echo -e "${RED}[ERROR]${NC} $1"; }
+
+# 显示帮助
+show_help() {
+  cat << EOF
+启动浏览器会话
+
+用法:
+  $0 <url> [headless] [browser]
+
+参数:
+  url       要打开的 URL
+  headless  是否无头模式 (true/false，默认 true)
+  browser   浏览器类型 (chromium/firefox/webkit，默认 chromium)
+
+环境变量:
+  SESSION_NAME  会话名称（默认自动生成）
+
+输出:
+  JSON 格式的会话信息
+
+示例:
+  $0 https://example.com
+  $0 https://example.com false chromium
+  SESSION_NAME=my-session $0 https://example.com
+EOF
+  exit 0
+}
+
+# 检查参数
+if [[ "$1" == "-h" || "$1" == "--help" || -z "$URL" ]]; then
+  show_help
+fi
+
+# 检查 abs 是否安装
+if ! command -v abs &> /dev/null; then
+  log_error "agent-browser-stealth (abs) 未安装"
+  echo '{"success": false, "error": "abs not found"}'
+  exit 1
+fi
+
+# 构建参数
+ARGS="--session-name $SESSION_NAME"
+
+if [[ "$HEADLESS" == "false" ]]; then
+  ARGS="$ARGS --visible"
+fi
+
+# 启动浏览器
+log_info "启动浏览器会话: $SESSION_NAME"
+log_info "URL: $URL"
+log_info "无头模式: $HEADLESS"
+
+# 调用 abs 打开 URL
+abs open "$URL" $ARGS 2>/dev/null
+
+# 检查是否成功
+if [[ $? -eq 0 ]]; then
+  # 输出 JSON 结果
+  cat << EOF
+{
+  "success": true,
+  "session_id": "$SESSION_NAME",
+  "page_id": "$SESSION_NAME-page",
+  "url": "$URL",
+  "headless": $HEADLESS,
+  "browser": "$BROWSER"
+}
+EOF
+else
+  cat << EOF
+{
+  "success": false,
+  "error": "Failed to start browser"
+}
+EOF
+  exit 1
+fi

package/src/tools/definitions/ext/browser/browser-start.yml

@@ -0,0 +1,62 @@
+# browser-start.yml - 启动浏览器
+# ============================================================================
+# 工具类型: 浏览器
+# 用途: 启动浏览器会话
+# ============================================================================
+
+name: browser/browser-start
+description: |
+  启动浏览器会话
+  
+  支持：
+  - 无头模式（headless）
+  - 指定 URL 打开
+  - 会话管理
+
+input:
+  - name: url
+    type: string
+    required: true
+    description: 要打开的 URL
+  
+  - name: headless
+    type: boolean
+    required: false
+    default: true
+    description: 是否使用无头模式
+  
+  - name: browser
+    type: string
+    required: false
+    default: chromium
+    enum: [chromium, firefox, webkit]
+    description: 浏览器类型
+
+output:
+  - name: session_id
+    type: string
+    description: 浏览器会话 ID
+  
+  - name: page_id
+    type: string
+    description: 页面 ID
+
+# 实现说明
+implementation:
+  type: script
+  script: ./browser-start.sh
+  note: |
+    使用 agent-browser-stealth (abs) 启动浏览器
+    
+    1. 调用 abs open 打开 URL
+    2. 返回 session_id
+    3. 支持无头模式和会话管理
+
+# 元数据
+metadata:
+  author: Agent Studio
+  version: 1.0.0
+  tags:
+    - browser
+    - puppeteer
+    - e2e