foliko 1.0.85 → 1.0.87

package/.agent/skills/agent-browser/TEST_PLAN.md

@@ -0,0 +1,200 @@
+# Agent Browser 技能测试计划
+
+**项目**: agent-browser skill  
+**版本**: v1.0.0  
+**日期**: 2024年  
+**测试环境**: Windows/macOS/Linux + Node.js 18+
+
+---
+
+## 1. 测试范围
+
+### 1.1 功能测试
+- [ ] 安装与初始化
+- [ ] 页面导航操作
+- [ ] 元素定位与交互
+- [ ] 信息获取
+- [ ] 状态检查
+- [ ] 截图功能
+- [ ] 键盘鼠标操作
+- [ ] 网络拦截
+- [ ] 会话管理
+- [ ] 认证管理
+
+### 1.2 集成测试
+- [ ] 与 skill 工具集成
+- [ ] 错误处理
+- [ ] 超时机制
+
+---
+
+## 2. 前置条件
+
+```bash
+# 1. 安装依赖
+npm install -g agent-browser
+
+# 2. 安装 Chrome
+agent-browser install
+
+# 3. 验证安装
+agent-browser --version
+```
+
+---
+
+## 3. 测试用例
+
+### 3.1 安装测试
+
+| ID | 测试项 | 命令 | 预期结果 |
+|----|--------|------|----------|
+| INST-01 | 全局安装 | `npm install -g agent-browser` | 无错误，安装成功 |
+| INST-02 | Chrome 下载 | `agent-browser install` | Chrome 成功下载 |
+| INST-03 | 版本验证 | `agent-browser --version` | 显示版本号 v0.23.4 |
+
+### 3.2 页面导航测试
+
+| ID | 测试项 | 命令 | 预期结果 |
+|----|--------|------|----------|
+| NAV-01 | 打开网页 | `agent-browser open https://example.com` | 浏览器打开页面 |
+| NAV-02 | 获取标题 | `agent-browser get title` | 返回 "Example Domain" |
+| NAV-03 | 获取 URL | `agent-browser get url` | 返回完整 URL |
+| NAV-04 | 刷新页面 | `agent-browser reload` | 页面刷新 |
+| NAV-05 | 关闭浏览器 | `agent-browser close` | 浏览器关闭 |
+
+### 3.3 元素交互测试
+
+| ID | 测试项 | 命令 | 预期结果 |
+|----|--------|------|----------|
+| INT-01 | 获取快照 | `agent-browser snapshot -i --json` | 返回可访问性树和引用 |
+| INT-02 | 点击元素 | `agent-browser click @e1` | 元素被点击 |
+| INT-03 | 填写表单 | `agent-browser fill @input "test@test.com"` | 输入框被填充 |
+| INT-04 | 悬停元素 | `agent-browser hover @e2` | 鼠标悬停 |
+| INT-05 | 滚动页面 | `agent-browser scroll down 500` | 页面滚动 |
+
+### 3.4 信息获取测试
+
+| ID | 测试项 | 命令 | 预期结果 |
+|----|--------|------|----------|
+| GET-01 | 获取文本 | `agent-browser get text @e1` | 返回元素文本 |
+| GET-02 | 获取 HTML | `agent-browser get html @e1` | 返回元素 HTML |
+| GET-03 | 获取属性 | `agent-browser get attr @e1 href` | 返回属性值 |
+| GET-04 | 元素计数 | `agent-browser get count "a"` | 返回链接数量 |
+
+### 3.5 状态检查测试
+
+| ID | 测试项 | 命令 | 预期结果 |
+|----|--------|------|----------|
+| STA-01 | 可见性检查 | `agent-browser is visible @e1` | 返回 true/false |
+| STA-02 | 可用性检查 | `agent-browser is enabled @e1` | 返回 true/false |
+
+### 3.6 截图功能测试
+
+| ID | 测试项 | 命令 | 预期结果 |
+|----|--------|------|----------|
+| SCR-01 | 普通截图 | `agent-browser screenshot test.png` | 生成截图文件 |
+| SCR-02 | 全页面截图 | `agent-browser screenshot --full full.png` | 生成全页面截图 |
+| SCR-03 | 带标注截图 | `agent-browser screenshot --annotate anno.png` | 生成带编号标签的截图 |
+
+### 3.7 语义定位器测试
+
+| ID | 测试项 | 命令 | 预期结果 |
+|----|--------|------|----------|
+| SEM-01 | 按角色查找 | `agent-browser find role button click` | 找到并点击按钮 |
+| SEM-02 | 按文本查找 | `agent-browser find text "Submit" click` | 找到并点击 |
+| SEM-03 | 按标签查找 | `agent-browser find label "Email" fill "test.com"` | 找到并填写 |
+| SEM-04 | 位置选择 | `agent-browser find first "a" click` | 点击第一个链接 |
+
+### 3.8 等待机制测试
+
+| ID | 测试项 | 命令 | 预期结果 |
+|----|--------|------|----------|
+| WAI-01 | 等待元素 | `agent-browser wait "#element"` | 元素出现后继续 |
+| WAI-02 | 等待文本 | `agent-browser wait --text "Success"` | 文本出现后继续 |
+| WAI-03 | 等待网络空闲 | `agent-browser wait --load networkidle` | 网络空闲后继续 |
+
+### 3.9 网络拦截测试
+
+| ID | 测试项 | 命令 | 预期结果 |
+|----|--------|------|----------|
+| NET-01 | 阻止请求 | `agent-browser network route "*.js" --abort` | 资源被阻止 |
+| NET-02 | Mock 响应 | `agent-browser network route "*/api/*" --body '{"ok":true}'` | 返回 Mock 数据 |
+| NET-03 | 查看请求 | `agent-browser network requests` | 列出所有请求 |
+
+### 3.10 会话管理测试
+
+| ID | 测试项 | 命令 | 预期结果 |
+|----|--------|------|----------|
+| SES-01 | 隔离会话 | `agent-browser --session s1 open a.com` | 独立会话打开 |
+| SES-02 | 会话隔离验证 | `agent-browser --session s2 open b.com` | 不同会话状态隔离 |
+
+### 3.11 键盘鼠标操作测试
+
+| ID | 测试项 | 命令 | 预期结果 |
+|----|--------|------|----------|
+| KEY-01 | 键盘输入 | `agent-browser keyboard type "Hello"` | 文本被输入 |
+| KEY-02 | 按键操作 | `agent-browser press Enter` | 按下 Enter 键 |
+| MOU-01 | 移动鼠标 | `agent-browser mouse move 100 200` | 鼠标移动 |
+| MOU-02 | 滚轮滚动 | `agent-browser mouse wheel 100` | 页面滚动 |
+
+---
+
+## 4. 自动化测试脚本
+
+```bash
+# test_basic.sh - 基础功能测试
+#!/bin/bash
+
+echo "=== Agent Browser 基础测试 ==="
+
+# 测试打开网页
+echo "[TEST] 打开网页..."
+agent-browser open https://example.com
+sleep 2
+
+# 测试获取快照
+echo "[TEST] 获取快照..."
+agent-browser snapshot -i --json > snapshot.json
+cat snapshot.json
+
+# 测试截图
+echo "[TEST] 截图..."
+agent-browser screenshot output.png
+
+# 关闭
+echo "[TEST] 关闭浏览器..."
+agent-browser close
+
+echo "=== 测试完成 ==="
+```
+
+---
+
+## 5. 预期产出
+
+| 类型 | 文件 | 说明 |
+|------|------|------|
+| 截图 | `*.png` | 测试截图输出 |
+| 快照 | `snapshot.json` | 页面元素树 JSON |
+| 日志 | `debug.log` | 调试模式日志 |
+
+---
+
+## 6. 风险评估
+
+| 风险 | 影响 | 缓解措施 |
+|------|------|----------|
+| Chrome 未安装 | 无法运行 | 提供 `agent-browser install` 说明 |
+| 网络超时 | 测试失败 | 增加 wait 等待时间 |
+| 元素引用失效 | 交互失败 | 每次操作前重新 snapshot |
+| 端口占用 | 启动失败 | 使用 `--port` 指定端口 |
+
+---
+
+## 7. 通过标准
+
+- [ ] 所有 P0 测试用例通过
+- [ ] 截图功能正常生成图片
+- [ ] 元素交互命令无报错
+- [ ] 会话隔离功能正常

package/.agent/skills/sysinfo/SKILL.md

@@ -0,0 +1,38 @@
+---
+name: sysinfo
+description: 使用 Bash 脚本查询系统信息（CPU、内存、磁盘、网络）
+allowed-tools:
+  - get_cpu_info
+  - get_memory_info
+  - get_disk_info
+  - get_network_info
+  - get_full_system_info
+---
+
+# 系统信息查询 (sysinfo)
+
+使用 Bash 脚本查询系统信息，支持模块化查询。
+
+## 使用方法
+
+### 完整系统信息
+```bash
+bash .agent/skills/sysinfo/system-info.sh
+```
+
+### 分模块查询
+```bash
+bash .agent/skills/sysinfo/system-info.sh cpu    # CPU 信息
+bash .agent/skills/sysinfo/system-info.sh memory # 内存信息
+bash .agent/skills/sysinfo/system-info.sh disk   # 磁盘信息
+bash .agent/skills/sysinfo/system-info.sh network # 网络信息
+bash .agent/skills/sysinfo/system-info.sh system  # 系统基本信息
+```
+
+## 输出示例
+
+- **CPU**: 型号、核心数、使用率
+- **Memory**: 总内存、已用、可用、使用率
+- **Disk**: 各分区容量和使用情况
+- **Network**: IP 地址、网卡信息
+- **System**: 主机名、操作系统、内核版本

package/.agent/skills/sysinfo/system-info.sh

@@ -0,0 +1,130 @@
+#!/bin/bash
+# 系统信息查询脚本（跨平台支持）
+# 用法: system-info [option]
+# 选项: all (默认), cpu, memory, disk, network, system
+
+OPTION=${1:-all}
+
+echo "=========================================="
+echo "         System Info Report - $(date '+%Y-%m-%d %H:%M:%S')"
+echo "=========================================="
+echo ""
+
+# 系统基本信息
+show_system() {
+    echo "[System Info]"
+    echo "  Hostname: $(hostname)"
+    echo "  OS: $(uname -s)"
+    echo "  Kernel: $(uname -r)"
+    echo "  Arch: $(uname -m)"
+    echo ""
+}
+
+# CPU 信息
+show_cpu() {
+    echo "[CPU Info]"
+    if [ -f /proc/cpuinfo ]; then
+        echo "  Model: $(grep 'model name' /proc/cpuinfo | head -1 | cut -d':' -f2 | xargs)"
+        echo "  Cores: $(grep -c ^processor /proc/cpuinfo)"
+    elif command -v powershell &> /dev/null; then
+        cpu_info=$(powershell -NoProfile -Command "
+            \$cpu = Get-CimInstance Win32_Processor | Select-Object -First 1
+            \$cores = (Get-CimInstance Win32_Processor | Measure-Object -Property NumberOfCores -Sum).Sum
+            \$threads = (Get-CimInstance Win32_Processor | Measure-Object -Property NumberOfLogicalProcessors -Sum).Sum
+            Write-Output \"\$(\$cpu.Name)|\$cores|\$threads\"
+        ")
+        cpu_name=$(echo "$cpu_info" | cut -d'|' -f1)
+        cpu_cores=$(echo "$cpu_info" | cut -d'|' -f2)
+        cpu_threads=$(echo "$cpu_info" | cut -d'|' -f3)
+        echo "  Model: $cpu_name"
+        echo "  Cores: $cpu_cores"
+        echo "  Threads: $cpu_threads"
+    else
+        echo "  Model: $(sysctl -n machdep.cpu.brand_string 2>/dev/null || echo 'Unknown')"
+    fi
+    echo ""
+}
+
+# 内存信息
+show_memory() {
+    echo "[Memory Info]"
+    if [ -f /proc/meminfo ]; then
+        mem_total=$(grep MemTotal /proc/meminfo | awk '{printf "%.2f GB", $2/1024/1024}')
+        mem_free=$(grep MemFree /proc/meminfo | awk '{printf "%.2f GB", $2/1024/1024}')
+        mem_avail=$(grep MemAvailable /proc/meminfo 2>/dev/null | awk '{printf "%.2f GB", $2/1024/1024}')
+        echo "  Total: $mem_total"
+        echo "  Free: $mem_free"
+        echo "  Available: ${mem_avail:-N/A}"
+    elif command -v powershell &> /dev/null; then
+        mem_info=$(powershell -NoProfile -Command "
+            \$os = Get-CimInstance Win32_OperatingSystem
+            \$total = [math]::Round(\$os.TotalVisibleMemorySize / 1MB, 2)
+            \$free = [math]::Round(\$os.FreePhysicalMemory / 1MB, 2)
+            \$used = [math]::Round(\$total - \$free, 2)
+            \$pct = [math]::Round((\$used / \$total) * 100, 1)
+            Write-Output \"\$total|\$used|\$free|\$pct\"
+        ")
+        total=$(echo "$mem_info" | cut -d'|' -f1)
+        used=$(echo "$mem_info" | cut -d'|' -f2)
+        free=$(echo "$mem_info" | cut -d'|' -f3)
+        pct=$(echo "$mem_info" | cut -d'|' -f4)
+        echo "  Total: ${total} GB"
+        echo "  Used: ${used} GB (${pct}%)"
+        echo "  Free: ${free} GB"
+    else
+        echo "  Unable to get memory info"
+    fi
+    echo ""
+}
+
+# 磁盘信息
+show_disk() {
+    echo "[Disk Info]"
+    if command -v powershell &> /dev/null; then
+        # Windows PowerShell - 使用 UTF8 编码输出
+        powershell -NoProfile -Command "[Console]::OutputEncoding = [System.Text.Encoding]::UTF8; Get-CimInstance Win32_LogicalDisk -Filter \"DriveType=3\" | Format-Table -AutoSize | Out-String"
+    elif [ -f /proc/mounts ] && command -v df &> /dev/null; then
+        df -h | grep -E '^/dev/' | awk '{
+            printf "  %s: Total %s, Used %s (%s), Free %s\n", $1, $2, $3, $5, $4
+        }'
+    else
+        echo "  Unable to get disk info"
+    fi
+    echo ""
+}
+
+# 网络信息
+show_network() {
+    echo "[Network Info]"
+    echo "  IP Addresses:"
+    if command -v ip &> /dev/null; then
+        ip addr show | grep inet | grep -v '127.0.0.1' | awk '{printf "    %s\n", $2}'
+    elif command -v ifconfig &> /dev/null; then
+        ifconfig | grep 'inet ' | grep -v '127.0.0.1' | awk '{printf "    %s\n", $2}'
+    elif command -v powershell &> /dev/null; then
+        powershell -NoProfile -Command "Get-NetIPAddress -AddressFamily IPv4 | Where-Object { \$_.IPAddress -ne '127.0.0.1' } | ForEach-Object { Write-Output \"    \$(\$_.IPAddress)\" }"
+    fi
+    echo ""
+}
+
+# 执行选项
+case $OPTION in
+    all)
+        show_system
+        show_cpu
+        show_memory
+        show_disk
+        show_network
+        ;;
+    cpu)    show_cpu ;;
+    memory) show_memory ;;
+    disk)   show_disk ;;
+    network) show_network ;;
+    system) show_system ;;
+    *)
+        echo "Usage: system-info [all|cpu|memory|disk|network|system]"
+        exit 1
+        ;;
+esac
+
+echo "=========================================="

package/.agent/skills/workflow/SKILL.md

@@ -0,0 +1,324 @@
+---
+name: workflow
+description: 工作流引擎 - 定义和执行结构化工作流，支持顺序、条件分支、循环、延迟、工具调用等步骤类型
+allowed-tools: execute_workflow,reloadWorkflows
+---
+
+# Workflow 工作流
+
+工作流引擎用于定义和执行结构化的工作流程，支持多种步骤类型，可以组合使用实现复杂逻辑。
+
+## 快速开始
+
+### 创建工作流文件
+
+工作流定义文件放在 `.agent/workflows/` 目录下，支持 `.json` 和 `.js` 格式：
+
+```json
+{
+  "name": "example-workflow",
+  "description": "示例工作流",
+  "steps": [
+    { "type": "script", "name": "步骤1", "script": "return 'Hello';" },
+    { "type": "tool", "name": "发送通知", "tool": "notification_send", "args": { "title": "标题", "message": "内容" } }
+  ]
+}
+```
+
+### 执行工作流
+
+```javascript
+// 通过 execute_workflow 工具执行
+await execute_workflow({
+  workflow: "get-ip-notify"  // 工作流名称（自动从 .agent/workflows/ 加载）
+})
+
+// 或直接传入工作流定义
+await execute_workflow({
+  workflow: {
+    steps: [
+      { "type": "script", "name": "Hello", "script": "return 'Hello World';" }
+    ]
+  }
+})
+```
+
+### 重要注意事项
+
+1. **script 必须用 return 返回值**：`script` 是函数体，不是表达式
+2. **JSON 中不能使用多行字符串**：所有 script 内容写成单行，用分号分隔
+3. **JSON 中不能有注释**：注释会导致 JSON 解析失败
+
+## 步骤类型
+
+### 1. script - 脚本步骤
+
+执行 JavaScript 代码，**必须用 return 返回值**：
+
+```json
+{
+  "type": "script",
+  "name": "计算",
+  "outputVariable": "result",
+  "script": "var a=10; var b=20; context.variables.sum=a+b; return a+b;"
+}
+```
+
+**正确写法**：
+```json
+{ "script": "return context.variables.value + 1;" }
+```
+
+**错误写法**（缺少 return）：
+```json
+{ "script": "context.variables.value + 1;" }
+```
+
+**JSON 中 script 只能写单行**，不能换行。如果逻辑复杂，建议拆成多个 script 步骤。
+
+**script 中的可用对象**：
+- `context.input` - 工作流输入参数
+- `context.variables` - 工作流变量（可读写），存储在 outputVariable 中的值
+- `context.lastResult` - 上一步骤的返回值
+- `context.variables.loopIndex` - 循环中的当前索引
+
+### 2. tool - 工具调用步骤
+
+在工作流中调用框架注册的工具：
+
+```json
+{
+  "type": "tool",
+  "name": "发送通知",
+  "tool": "notification_send",
+  "args": {
+    "title": "标题",
+    "message": "内容"
+  },
+  "outputVariable": "result"
+}
+```
+
+**参数说明**：
+
+| 字段 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `tool` | string | 是 | 工具名称 |
+| `args` | object | 否 | 工具参数 |
+| `outputVariable` | string | 否 | 结果保存到的变量名，可通过 `context.variables.xxx` 访问 |
+
+**args 中支持变量引用**：
+
+使用 `{{variableName}}` 语法引用 context.variables 中的变量：
+
+```json
+{
+  "type": "tool",
+  "name": "发送通知",
+  "tool": "notification_send",
+  "args": {
+    "title": "IP 信息",
+    "message": "当前公网IP: {{currentIp}}"
+  }
+}
+```
+
+变量引用规则：
+- `{{currentIp}}` → 从 context.variables.currentIp 获取
+- `{{emailResult.success}}` → 支持嵌套属性访问
+
+**完整示例 - 获取IP并发送通知**：
+
+```json
+{
+  "name": "get-ip-notify",
+  "description": "获取本机IP并发送通知",
+  "steps": [
+    {
+      "type": "tool",
+      "name": "获取IP信息",
+      "tool": "fetch",
+      "args": {
+        "url": "https://api.ipify.org?format=json",
+        "proxy": true
+      },
+      "outputVariable": "ipResult"
+    },
+    {
+      "type": "script",
+      "name": "提取IP",
+      "outputVariable": "currentIp",
+      "script": "var r=context.variables.ipResult; return (r&&r.success&&r.body)?(typeof r.body==='object'?r.body.ip:r.body.trim()):'获取失败';"
+    },
+    {
+      "type": "tool",
+      "name": "发送通知",
+      "tool": "notification_send",
+      "args": {
+        "title": "IP 信息",
+        "message": "当前公网IP: {{currentIp}}"
+      }
+    }
+  ]
+}
+```
+
+### 3. condition - 条件分支
+
+根据条件选择执行分支：
+
+```json
+{
+  "type": "condition",
+  "name": "判断",
+  "branches": [
+    {
+      "name": "大于10",
+      "condition": "context.variables.value > 10",
+      "steps": [
+        { "type": "script", "name": "处理大数", "script": "context.variables.status='big'; return true;" }
+      ]
+    },
+    {
+      "name": "小于等于10",
+      "condition": "context.variables.value <= 10",
+      "steps": [
+        { "type": "script", "name": "处理小数", "script": "context.variables.status='small'; return true;" }
+      ]
+    }
+  ]
+}
+```
+
+**condition 中的 condition 写法**：
+- 比较运算符：`>`、`<`、`>=`、`<=`、`===`、`!==`
+- 逻辑运算符：`&&`、`||`、`!`
+- 必须返回 boolean 值
+
+### 4. loop - 循环步骤
+
+重复执行一组步骤：
+
+```json
+{
+  "type": "loop",
+  "name": "循环3次",
+  "maxIterations": 3,
+  "loopVariable": "i",
+  "until": "context.variables.i >= 2",
+  "steps": [
+    { "type": "script", "name": "迭代", "script": "context.variables.count=context.variables.i+1; return context.variables.i;" }
+  ]
+}
+```
+
+### 5. delay - 延迟步骤
+
+等待指定时间：
+
+```json
+{
+  "type": "delay",
+  "name": "等待1秒",
+  "delayMs": 1000
+}
+```
+
+### 6. sequential - 顺序步骤
+
+将多个步骤组合为顺序执行（可嵌套使用）：
+
+```json
+{
+  "type": "sequential",
+  "name": "顺序执行",
+  "steps": [
+    { "type": "script", "name": "步骤1", "script": "return 1;" },
+    { "type": "script", "name": "步骤2", "script": "return 2;" }
+  ]
+}
+```
+
+## sessionId 传递
+
+工作流执行时会自动获取当前 sessionId，所有 tool 调用都会使用该 sessionId。
+
+**调用流程**：
+1. `execute_workflow` 从执行上下文获取 sessionId
+2. sessionId 存入 `context.variables._sessionId`
+3. ToolStep 执行工具时使用该 sessionId
+
+**这确保了通知会发送到当前会话**。
+
+## 工具
+
+### execute_workflow
+
+执行指定的工作流。
+
+```javascript
+// 按名称执行（从 .agent/workflows/ 加载）
+await execute_workflow({
+  workflow: "get-ip-notify"
+})
+
+// 传入工作流定义
+await execute_workflow({
+  workflow: {
+    steps: [
+      { "type": "script", "script": "return 'test';" }
+    ]
+  }
+})
+
+// 带输入参数
+await execute_workflow({
+  workflow: "my-workflow",
+  input: { key: "value" }
+})
+```
+
+### reloadWorkflows
+
+重载所有工作流（当添加或修改工作流后调用）。
+
+```javascript
+await reloadWorkflows()
+```
+
+## 最佳实践
+
+1. **script 必须 return**：`script` 是函数体，必须用 return 返回值
+2. **JSON 中 script 单行写**：用分号分隔多个语句，不要换行
+3. **拆分复杂逻辑**：复杂的 script 拆成多个简单步骤
+4. **使用 outputVariable**：需要跨步骤使用的值，存入 context.variables
+5. **条件判断加 else**：condition 分支要有兜底处理
+6. **合理设置循环次数**：loop 的 maxIterations 不要过大
+
+**错误示例**：
+```json
+// ❌ 错误 - script 没有 return
+{ "type": "script", "script": "context.variables.count + 1;" }
+
+// ❌ 错误 - JSON 多行字符串
+{
+  "script": "
+    const a = 10;
+    return a + 1;
+  "
+}
+
+// ❌ 错误 - JSON 中有注释
+{
+  "script": "return 1; // 这是注释"
+}
+```
+
+**正确示例**：
+```json
+// ✅ 正确
+{ "type": "script", "outputVariable": "count", "script": "return (context.variables.count||0) + 1;" }
+
+// ✅ 正确 - 复杂逻辑拆成多步
+{ "type": "script", "script": "context.variables.a=10; context.variables.b=20; return context.variables.a+context.variables.b;" }
+```