@dommaker/harness 0.13.0 → 0.13.2

package/src/tools/definitions/core/validation/validate-readme-stats.yml

@@ -0,0 +1,155 @@
+# validate-readme-stats.yml - README 统计一致性检查
+# ============================================================================
+# 能力类型: validation（工具型）
+# 执行方式: 纯脚本，检查统计数字
+# 用途: 验证 README 中的统计数据与实际文件数量一致
+# ============================================================================
+
+name: validate-readme-stats
+description: 检查 README 统计数据是否与实际文件数量一致
+category: validation
+version: 1.0.0
+
+# 铁律
+iron_law:
+  rule: "README STATS MUST REFLECT REALITY"
+  message: "README 中的统计数据必须与实际文件数量一致"
+
+# 输入
+input:
+  readme_path:
+    type: path
+    required: false
+    default: "README.md"
+    description: README 文件路径
+  
+  tools_dir:
+    type: path
+    required: false
+    default: "tools"
+    description: tools 目录路径
+  
+  steps_dir:
+    type: path
+    required: false
+    default: "steps"
+    description: steps 目录路径
+  
+  workflows_dir:
+    type: path
+    required: false
+    default: "workflows"
+    description: workflows 目录路径
+
+# 输出
+output:
+  actual_tools:
+    type: number
+    description: 实际 tools 数量
+  
+  actual_steps:
+    type: number
+    description: 实际 steps 数量
+  
+  actual_workflows:
+    type: number
+    description: 实际 workflows 数量
+  
+  readme_tools:
+    type: number
+    description: README 中记录的 tools 数量
+  
+  readme_steps:
+    type: number
+    description: README 中记录的 steps 数量
+  
+  readme_workflows:
+    type: number
+    description: README 中记录的 workflows 数量
+  
+  passed:
+    type: boolean
+    description: 是否全部一致
+
+# 执行脚本
+script: |
+  #!/bin/bash
+  set -euo pipefail
+  
+  README_PATH="{{readme_path}}"
+  TOOLS_DIR="{{tools_dir}}"
+  STEPS_DIR="{{steps_dir}}"
+  WORKFLOWS_DIR="{{workflows_dir}}"
+  
+  echo "🔍 检查 README 统计一致性"
+  echo "  README: $README_PATH"
+  echo ""
+  
+  # 计算实际数量
+  ACTUAL_TOOLS=$(find "$TOOLS_DIR" -name "*.yml" -o -name "*.yaml" 2>/dev/null | grep -v README | wc -l)
+  ACTUAL_STEPS=$(find "$STEPS_DIR" -name "*.yml" -o -name "*.yaml" 2>/dev/null | grep -v README | wc -l)
+  ACTUAL_WORKFLOWS=$(find "$WORKFLOWS_DIR" -name "*.yml" -o -name "*.yaml" 2>/dev/null | wc -l)
+  
+  echo "📊 实际统计:"
+  echo "  Tools: $ACTUAL_TOOLS"
+  echo "  Steps: $ACTUAL_STEPS"
+  echo "  Workflows: $ACTUAL_WORKFLOWS"
+  echo ""
+  
+  # 从 README 提取统计
+  # 格式: | **Tools** | 25 | ... |
+  README_TOOLS=$(grep -E "\*\*Tools\*\*" "$README_PATH" | grep -oE '\|[ ]*[0-9]+' | head -1 | grep -oE '[0-9]+' || echo "0")
+  README_STEPS=$(grep -E "\*\*Steps\*\*" "$README_PATH" | grep -oE '\|[ ]*[0-9]+' | head -1 | grep -oE '[0-9]+' || echo "0")
+  README_WORKFLOWS=$(grep -E "\*\*Workflows\*\*" "$README_PATH" | grep -oE '\|[ ]*[0-9]+' | head -1 | grep -oE '[0-9]+' || echo "0")
+  
+  echo "📝 README 统计:"
+  echo "  Tools: $README_TOOLS"
+  echo "  Steps: $README_STEPS"
+  echo "  Workflows: $README_WORKFLOWS"
+  echo ""
+  
+  # 对比
+  ERRORS=0
+  
+  echo "🔍 对比结果:"
+  
+  if [ "$ACTUAL_TOOLS" = "$README_TOOLS" ]; then
+    echo "  ✅ Tools: $ACTUAL_TOOLS = $README_TOOLS"
+  else
+    echo "  ❌ Tools: 实际=$ACTUAL_TOOLS, README=$README_TOOLS"
+    ERRORS=$((ERRORS + 1))
+  fi
+  
+  if [ "$ACTUAL_STEPS" = "$README_STEPS" ]; then
+    echo "  ✅ Steps: $ACTUAL_STEPS = $README_STEPS"
+  else
+    echo "  ❌ Steps: 实际=$ACTUAL_STEPS, README=$README_STEPS"
+    ERRORS=$((ERRORS + 1))
+  fi
+  
+  if [ "$ACTUAL_WORKFLOWS" = "$README_WORKFLOWS" ]; then
+    echo "  ✅ Workflows: $ACTUAL_WORKFLOWS = $README_WORKFLOWS"
+  else
+    echo "  ❌ Workflows: 实际=$ACTUAL_WORKFLOWS, README=$README_WORKFLOWS"
+    ERRORS=$((ERRORS + 1))
+  fi
+  
+  echo ""
+  
+  if [ $ERRORS -gt 0 ]; then
+    echo "================================"
+    echo "❌ 发现 $ERRORS 处不一致"
+    echo ""
+    echo "请更新 README.md 中的统计数据:"
+    echo ""
+    echo "| 层级 | 数量 |"
+    echo "|------|------|"
+    echo "| **Tools** | $ACTUAL_TOOLS |"
+    echo "| **Steps** | $ACTUAL_STEPS |"
+    echo "| **Workflows** | $ACTUAL_WORKFLOWS |"
+    echo "================================"
+    exit 1
+  fi
+  
+  echo "✅ README 统计数据与实际一致"
+  exit 0

package/src/tools/definitions/core/validation/validate-yaml-syntax.yml

@@ -0,0 +1,134 @@
+# validate-yaml-syntax.yml - YAML 语法检查
+# ============================================================================
+# 能力类型: validation（工具型）
+# 执行方式: 纯脚本，检查 YAML 语法
+# 用途: 验证所有 YAML 文件语法正确
+# ============================================================================
+
+name: validate-yaml-syntax
+description: 检查所有 YAML 文件语法正确性
+category: validation
+version: 1.0.0
+
+# 铁律
+iron_law:
+  rule: "YAML MUST BE VALID"
+  message: "所有 YAML 文件必须通过语法检查"
+
+# 输入
+input:
+  search_dirs:
+    type: array
+    required: false
+    default: ["tools", "steps", "workflows"]
+    description: 要检查的目录列表
+  
+  exclude_patterns:
+    type: array
+    required: false
+    default: ["README"]
+    description: 排除的模式列表
+
+# 输出
+output:
+  total_files:
+    type: number
+    description: 检查的文件总数
+  
+  valid_files:
+    type: number
+    description: 有效的文件数量
+  
+  invalid_files:
+    type: array
+    description: 无效文件列表及错误
+  
+  passed:
+    type: boolean
+    description: 是否全部通过
+
+# 执行脚本
+script: |
+  #!/bin/bash
+  set -euo pipefail
+  
+  echo "🔍 检查 YAML 语法"
+  echo ""
+  
+  # 检查是否安装了 yamllint
+  if ! command -v yamllint &> /dev/null; then
+    echo "⚠️  yamllint 未安装，使用基础检查"
+    USE_YAMLLINT=false
+  else
+    USE_YAMLLINT=true
+  fi
+  
+  TOTAL=0
+  VALID=0
+  INVALID=()
+  
+  # 检查函数
+  check_yaml() {
+    local file="$1"
+    
+    if $USE_YAMLLINT; then
+      # 使用 yamllint
+      if yamllint -d "{extends: relaxed, rules: {line-length: disable}}" "$file" > /dev/null 2>&1; then
+        return 0
+      else
+        return 1
+      fi
+    else
+      # 使用 Python yaml 模块
+      if python3 -c "import yaml; yaml.safe_load(open('$file'))" 2>/dev/null; then
+        return 0
+      else
+        return 1
+      fi
+    fi
+  }
+  
+  # 遍历目录
+  for dir in tools steps workflows; do
+    if [ -d "$dir" ]; then
+      for f in $(find "$dir" -name "*.yml" -o -name "*.yaml" 2>/dev/null | grep -v README | sort); do
+        TOTAL=$((TOTAL + 1))
+        
+        if check_yaml "$f"; then
+          VALID=$((VALID + 1))
+          echo "  ✅ $f"
+        else
+          INVALID+=("$f")
+          echo "  ❌ $f"
+          # 显示错误详情
+          if $USE_YAMLLINT; then
+            yamllint -d "{extends: relaxed, rules: {line-length: disable}}" "$file" 2>&1 | head -5
+          else
+            python3 -c "import yaml; yaml.safe_load(open('$f'))" 2>&1 | head -3
+          fi
+          echo ""
+        fi
+      done
+    fi
+  done
+  
+  echo ""
+  echo "================================"
+  echo "📊 统计:"
+  echo "  总计: $TOTAL 个文件"
+  echo "  有效: $VALID 个"
+  echo "  无效: ${#INVALID[@]} 个"
+  echo "================================"
+  
+  if [ ${#INVALID[@]} -gt 0 ]; then
+    echo ""
+    echo "❌ 发现无效 YAML 文件:"
+    for f in "${INVALID[@]}"; do
+      echo "  - $f"
+    done
+    exit 1
+  fi
+  
+  echo ""
+  echo "✅ 所有 YAML 文件语法正确"
+  exit 0

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

@@ -0,0 +1,255 @@
+#!/bin/bash
+# browser-automate.sh - 浏览器自动化测试脚本
+# 基于 agent-browser-stealth 实现（Puppeteer + 隐身增强）
+
+set -e
+
+# 参数解析
+ACTION="${1:-test}"
+URL="${2:-}"
+SCRIPT="${3:-}"
+OUTPUT_DIR="${4:-/tmp/browser-test-$(date +%s)}"
+SESSION_NAME="browser-test-$(date +%s)"
+HEADLESS="${HEADLESS:-true}"
+
+# 颜色输出
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m'
+
+log_info() {
+  echo -e "${GREEN}[INFO]${NC} $1"
+}
+
+log_warn() {
+  echo -e "${YELLOW}[WARN]${NC} $1"
+}
+
+log_error() {
+  echo -e "${RED}[ERROR]${NC} $1"
+}
+
+log_debug() {
+  echo -e "${BLUE}[DEBUG]${NC} $1"
+}
+
+# 检查 agent-browser-stealth 是否安装
+check_abs() {
+  if ! command -v abs &> /dev/null; then
+    log_warn "agent-browser-stealth not found, installing..."
+    npm install -g agent-browser-stealth
+    abs install
+  fi
+}
+
+# 运行浏览器测试（使用 agent-browser-stealth）
+run_browser_test() {
+  local url="$1"
+  local actions="$2"
+  
+  log_info "Starting browser automation test (agent-browser-stealth)..."
+  log_info "URL: $url"
+  log_info "Session: $SESSION_NAME"
+  log_info "Output: $OUTPUT_DIR"
+  
+  mkdir -p "$OUTPUT_DIR"
+  
+  # 结果数组
+  declare -a RESULTS=()
+  
+  # 检查 abs 命令
+  check_abs
+  
+  # 1. 打开页面
+  log_info "Opening URL..."
+  if ! abs open "$url" --session-name "$SESSION_NAME" 2>&1 | tee -a "$OUTPUT_DIR/test.log"; then
+    log_error "Failed to open URL: $url"
+    RESULTS+=("{\"action\":\"navigate\",\"status\":\"failed\",\"url\":\"$url\"}")
+    echo "{\"results\":[$(IFS=,; echo "${RESULTS[*]}")],\"errors\":[\"Failed to open URL\"]}"
+    exit 1
+  fi
+  RESULTS+=("{\"action\":\"navigate\",\"status\":\"success\",\"url\":\"$url\"}")
+  
+  # 2. 等待页面加载
+  sleep 2
+  
+  # 3. 初始截图
+  abs screenshot "$OUTPUT_DIR/screenshot-initial.png" --session-name "$SESSION_NAME" 2>/dev/null || true
+  
+  # 4. 获取元素映射
+  log_info "Getting element snapshot..."
+  SNAPSHOT_OUTPUT=$(abs snapshot -i --session-name "$SESSION_NAME" 2>&1) || true
+  
+  # 保存 snapshot 输出供调试
+  echo "$SNAPSHOT_OUTPUT" > "$OUTPUT_DIR/snapshot.txt"
+  
+  # 5. 执行测试脚本
+  if [ -n "$actions" ] && [ "$actions" != "[]" ]; then
+    log_info "Executing test actions..."
+    
+    # 解析 JSON actions 并执行
+    echo "$actions" | jq -c '.[]' 2>/dev/null | while read -r action; do
+      action_type=$(echo "$action" | jq -r '.type')
+      selector=$(echo "$action" | jq -r '.selector // ""')
+      value=$(echo "$action" | jq -r '.value // ""')
+      delay=$(echo "$action" | jq -r '.delay // 500')
+      filename=$(echo "$action" | jq -r '.filename // "screenshot.png"')
+      should_exist=$(echo "$action" | jq -r '.shouldExist // true')
+      
+      log_debug "Action: $action_type, Selector: $selector"
+      
+      case "$action_type" in
+        click)
+          # 尝试使用 @ref 引用，否则直接使用 selector
+          if abs click "$selector" --session-name "$SESSION_NAME" 2>&1 | tee -a "$OUTPUT_DIR/test.log"; then
+            log_info "Click success: $selector"
+            sleep 0.5
+          else
+            log_warn "Click failed: $selector"
+          fi
+          ;;
+        
+        type)
+          if abs type "$selector" "$value" --session-name "$SESSION_NAME" 2>&1 | tee -a "$OUTPUT_DIR/test.log"; then
+            log_info "Type success: $selector"
+          else
+            log_warn "Type failed: $selector"
+          fi
+          ;;
+        
+        wait)
+          log_info "Waiting for: $selector"
+          sleep "${delay::-3}2"  # 转换为秒
+          ;;
+        
+        screenshot)
+          abs screenshot "$OUTPUT_DIR/$filename" --session-name "$SESSION_NAME" 2>&1 | tee -a "$OUTPUT_DIR/test.log" || true
+          log_info "Screenshot saved: $filename"
+          ;;
+        
+        assert)
+          # 使用 abs eval 检查元素是否存在
+          if abs eval "document.querySelector('$selector')" --session-name "$SESSION_NAME" 2>&1 | grep -q "null"; then
+            log_warn "Element not found: $selector"
+          else
+            log_info "Element found: $selector"
+          fi
+          ;;
+        
+        scroll)
+          abs eval "window.scrollBy(0, ${value:-500})" --session-name "$SESSION_NAME" 2>&1 | tee -a "$OUTPUT_DIR/test.log" || true
+          log_info "Scrolled: ${value:-500}px"
+          ;;
+        
+        *)
+          log_warn "Unknown action: $action_type"
+          ;;
+      esac
+    done
+  fi
+  
+  # 6. 最终截图
+  abs screenshot "$OUTPUT_DIR/screenshot-final.png" --full-page --session-name "$SESSION_NAME" 2>/dev/null || true
+  
+  # 7. 获取性能指标
+  METRICS=$(abs eval "JSON.stringify(performance.getEntriesByType('navigation')[0])" --session-name "$SESSION_NAME" 2>/dev/null || echo "{}")
+  echo "$METRICS" > "$OUTPUT_DIR/metrics.json"
+  
+  # 8. 关闭浏览器
+  abs close --session-name "$SESSION_NAME" 2>/dev/null || true
+  
+  # 9. 生成结果
+  log_info "Generating test results..."
+  
+  # 构建结果 JSON
+  cat > "$OUTPUT_DIR/test-results.json" << EOF
+{
+  "results": [
+    {"action": "navigate", "status": "success", "url": "$url"},
+    {"action": "session", "status": "success", "sessionName": "$SESSION_NAME"}
+  ],
+  "screenshots": [
+    "$OUTPUT_DIR/screenshot-initial.png",
+    "$OUTPUT_DIR/screenshot-final.png"
+  ],
+  "metrics": $METRICS,
+  "outputDir": "$OUTPUT_DIR"
+}
+EOF
+  
+  log_info "Test completed. Results:"
+  cat "$OUTPUT_DIR/test-results.json"
+}
+
+# 交互式测试模式
+run_interactive_test() {
+  local url="$1"
+  
+  log_info "Starting interactive browser session..."
+  log_info "URL: $url"
+  log_info "Session: $SESSION_NAME"
+  log_info ""
+  log_info "Commands:"
+  log_info "  abs snapshot -i           # Get interactive element references"
+  log_info "  abs click @e1             # Click element by reference"
+  log_info "  abs type @e1 'text'       # Type text"
+  log_info "  abs screenshot out.png    # Take screenshot"
+  log_info "  abs close                 # Close browser"
+  log_info ""
+  
+  check_abs
+  abs open "$url" --session-name "$SESSION_NAME"
+}
+
+# 示例测试脚本
+example_login_test() {
+  cat << 'EOF'
+[
+  {"type": "wait", "selector": "input[name='username']"},
+  {"type": "type", "selector": "input[name='username']", "value": "test@example.com"},
+  {"type": "type", "selector": "input[name='password']", "value": "password123"},
+  {"type": "click", "selector": "button[type='submit']"},
+  {"type": "wait", "selector": ".dashboard", "delay": 2000},
+  {"type": "screenshot", "filename": "dashboard.png"}
+]
+EOF
+}
+
+# 主函数
+main() {
+  case "$ACTION" in
+    test)
+      if [ -z "$URL" ]; then
+        log_error "URL is required for test action"
+        echo "Usage: $0 test <url> [script]"
+        echo "Example: $0 test https://example.com '$(example_login_test)'"
+        exit 1
+      fi
+      run_browser_test "$URL" "$SCRIPT"
+      ;;
+    
+    interactive)
+      if [ -z "$URL" ]; then
+        log_error "URL is required for interactive mode"
+        echo "Usage: $0 interactive <url>"
+        exit 1
+      fi
+      run_interactive_test "$URL"
+      ;;
+    
+    example)
+      echo "Example login test script:"
+      example_login_test
+      ;;
+    
+    *)
+      log_error "Unknown action: $ACTION"
+      echo "Actions: test, interactive, example"
+      exit 1
+      ;;
+  esac
+}
+
+main "$@"

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

@@ -0,0 +1,166 @@
+# browser-automate.yml - 浏览器自动化测试能力
+name: browser-automate
+description: 基于 agent-browser-stealth 的浏览器自动化测试（Puppeteer + 隐身增强），支持反检测、会话保持、调试能力
+
+# 输入参数
+input:
+  url:
+    type: string
+    required: true
+    description: 要测试的页面 URL
+  
+  actions:
+    type: array
+    required: false
+    description: 测试动作列表
+    default: []
+    items:
+      type: object
+      properties:
+        type:
+          type: string
+          enum: [click, type, wait, screenshot, assert, scroll]
+          description: 动作类型
+        selector:
+          type: string
+          description: CSS 选择器
+        value:
+          type: string
+          description: 输入值（type 动作）
+        delay:
+          type: number
+          description: 延迟时间（毫秒）
+        filename:
+          type: string
+          description: 截图文件名
+        shouldExist:
+          type: boolean
+          description: 断言元素是否存在
+
+  headless:
+    type: boolean
+    required: false
+    default: true
+    description: 是否无头模式运行
+
+  timeout:
+    type: number
+    required: false
+    default: 30000
+    description: 页面加载超时时间（毫秒）
+
+# 输出
+output:
+  results:
+    type: array
+    description: 测试结果列表
+  
+  screenshots:
+    type: array
+    description: 截图文件路径列表
+  
+  metrics:
+    type: object
+    description: 页面性能指标
+  
+  errors:
+    type: array
+    description: 错误列表
+
+# 执行配置
+timeout: 300  # 秒
+agent: codex
+
+# 执行脚本
+handler: script
+script: ./browser-automate.sh
+
+# 示例用法
+examples:
+  - name: 登录测试
+    input:
+      url: https://example.com/login
+      actions:
+        - type: wait
+          selector: "input[name='username']"
+        - type: type
+          selector: "input[name='username']"
+          value: "test@example.com"
+        - type: type
+          selector: "input[name='password']"
+          value: "password123"
+        - type: click
+          selector: "button[type='submit']"
+        - type: wait
+          selector: ".dashboard"
+          delay: 2000
+        - type: screenshot
+          filename: "dashboard.png"
+        - type: assert
+          selector: ".user-profile"
+          shouldExist: true
+
+  - name: 表单填写测试
+    input:
+      url: https://example.com/form
+      actions:
+        - type: wait
+          selector: "form"
+        - type: type
+          selector: "#name"
+          value: "测试用户"
+        - type: type
+          selector: "#email"
+          value: "test@example.com"
+        - type: click
+          selector: "button[type='submit']"
+        - type: wait
+          selector: ".success-message"
+        - type: screenshot
+          filename: "form-success.png"
+
+# 与 agent-browser-stealth 集成说明
+integration:
+  agent_browser_stealth:
+    description: |
+      本 Tool 底层已使用 agent-browser-stealth 作为引擎，提供：
+      
+      1. 反检测 - 多层指纹伪装、行为人性化
+      2. 会话保持 - --session-name 支持多会话
+      3. 调试能力 - trace、profiler、console、errors
+      4. 元素引用 - snapshot -i 获取 @e1, @e2 引用
+      5. 引擎选择 - Chrome + Lightpanda
+      
+    cli_commands: |
+      # 交互式使用（更灵活）
+      abs open https://example.com --session-name my-session
+      abs snapshot -i                    # 获取元素引用 @e1, @e2, ...
+      abs click @e1                      # 点击元素
+      abs type @e2 "hello" --delay 50    # 模拟人类输入
+      abs screenshot result.png          # 截图
+      abs close                          # 关闭
+      
+    advanced: |
+      # 反检测模式
+      abs open https://example.com --risk-mode warn
+      
+      # 使用 Lightpanda 引擎（更快）
+      abs open https://example.com --engine lightpanda
+      
+      # 调试模式
+      abs open https://example.com --trace --verbose
+
+# 标签
+tags:
+  - browser
+  - e2e
+  - testing
+  - automation
+  - puppeteer
+  - stealth
+  - agent-browser-stealth
+  - dom
+  - anti-detection
+
+# 分类
+category: testing