foliko 1.1.13 → 1.1.14

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

@@ -1,200 +0,0 @@
-# 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

@@ -1,38 +0,0 @@
----
-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

@@ -1,130 +0,0 @@
-#!/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

@@ -1,324 +0,0 @@
----
-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;" }
-```