foliko 1.1.36 → 1.1.39

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;" }
+```

package/.agent/test-agent.js

@@ -0,0 +1,35 @@
+const fs = require("fs");
+const path = require("path");
+
+const agentsDir = path.join(".", "agents");
+const files = fs.readdirSync(agentsDir);
+console.log("子Agent文件:", files);
+
+const { SubAgentConfigManager } = require("../src/core/sub-agent-config.js");
+const configManager = new SubAgentConfigManager(agentsDir);
+
+// 需要调用 loadAll() 来加载配置
+configManager.loadAll();
+
+const configs = configManager.getAll();
+console.log("\n加载的子Agent配置:", configs.map(c => c.getName()));
+
+// 测试 getAllConfigs
+const configs2 = configManager.getAllConfigs();
+console.log("getAllConfigs():", configs2.size, "个");
+configs2.forEach((config, name) => {
+    console.log(`  - ${name}: valid=${config.isValid()}`);
+});
+
+// 测试 orchestrator-demo
+const demoConfig = configManager.get("orchestrator-demo");
+if (demoConfig) {
+    console.log("\norchestrator-demo 配置:");
+    console.log("  名称:", demoConfig.getName());
+    console.log("  描述:", demoConfig.getDescription());
+    console.log("  技能:", demoConfig.getSkills());
+    console.log("  工具:", demoConfig.getTools());
+    console.log("  模型:", demoConfig.getModel());
+} else {
+    console.log("\n未找到 orchestrator-demo 配置");
+}

package/.agent/weixin.json

@@ -0,0 +1,6 @@
+{
+  "token": "456b1c0cb5f7@im.bot:06000038355b2b75ffe34f60575352ea07fcb8",
+  "baseUrl": "https://ilinkai.weixin.qq.com",
+  "accountId": "456b1c0cb5f7@im.bot",
+  "userId": "o9cq80zgZqKPA2-s59PN43GdDy1w@im.wechat"
+}

package/.agent/workflows/email-digest.json

@@ -0,0 +1,50 @@
+{
+  "name": "email-digest",
+  "description": "邮件摘要工作流 - 读取未读邮件并生成摘要",
+  "steps": [
+    {
+      "type": "tool",
+      "name": "获取未读数",
+      "tool": "email_unread_count",
+      "args": {},
+      "outputVariable": "unreadResult"
+    },
+    {
+      "type": "condition",
+      "name": "检查是否有新邮件",
+      "branches": [
+        {
+          "name": "有新邮件",
+          "condition": "context.variables.unreadResult && context.variables.unreadResult.unreadCount > 0",
+          "steps": [
+            {
+              "type": "script",
+              "name": "记录状态",
+              "script": "context.variables.status='有新邮件'; return true;"
+            }
+          ]
+        },
+        {
+          "name": "无新邮件",
+          "condition": "!context.variables.unreadResult || context.variables.unreadResult.unreadCount === 0",
+          "steps": [
+            {
+              "type": "script",
+              "name": "记录状态",
+              "script": "context.variables.status='无新邮件'; return false;"
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "type": "tool",
+      "name": "发送通知",
+      "tool": "notification_send",
+      "args": {
+        "title": "邮件摘要",
+        "message": "未读邮件数: {{unreadResult.unreadCount}}"
+      }
+    }
+  ]
+}

package/.agent/workflows/file-backup.json

@@ -0,0 +1,21 @@
+{
+  "name": "file-backup",
+  "description": "文件备份工作流",
+  "steps": [
+    {
+      "type": "script",
+      "name": "准备路径",
+      "outputVariable": "backupInfo",
+      "script": "context.variables.source='.'; context.variables.dest='/backup'; return {source:'.',dest:'/backup'};"
+    },
+    {
+      "type": "tool",
+      "name": "发送通知",
+      "tool": "notification_send",
+      "args": {
+        "title": "备份开始",
+        "message": "开始备份文件"
+      }
+    }
+  ]
+}

package/.agent/workflows/get-ip-notify.json

@@ -0,0 +1,32 @@
+{
+  "name": "get-ip-notify",
+  "description": "从 ifconfig.me 获取公网 IP 地址并发送系统通知",
+  "steps": [
+    {
+      "type": "tool",
+      "name": "获取IP信息",
+      "tool": "fetch",
+      "args": {
+        "url": "https://ifconfig.me/ip",
+        "timeout": 30000,
+        "proxy": true
+      },
+      "outputVariable": "ipResult"
+    },
+    {
+      "type": "script",
+      "name": "提取IP",
+      "outputVariable": "currentIp",
+      "script": "var r=context.variables.ipResult; var ip=r&&r.success&&r.body?r.body.trim():null; return ip||'获取失败';"
+    },
+    {
+      "type": "tool",
+      "name": "发送通知",
+      "tool": "notification_send",
+      "args": {
+        "title": "IP 信息",
+        "message": "当前公网IP: {{currentIp}}"
+      }
+    }
+  ]
+}