foliko 1.0.66 → 1.0.67

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "foliko",
-  "version": "1.0.66",
+  "version": "1.0.67",
   "description": "简约的插件化 Agent 框架",
   "main": "src/index.js",
   "bin": {

package/plugins/email.js

@@ -44,19 +44,19 @@ class EmailPlugin extends Plugin {
       return this
     }
 
-    if (process.env.IMAP_USER && process.env.IMAP_PASS) {
-      console.log('[Email] Auto-starting email watch...')
-      this._startEmailWatch({
-        interval: 60,
-        host: process.env.IMAP_HOST,
-        port: parseInt(process.env.IMAP_PORT) || 993,
-        user: process.env.IMAP_USER,
-        password: process.env.IMAP_PASS,
-        box: 'INBOX'
-      })
-    } else {
-      console.log('[Email] IMAP credentials not configured, skipping auto-start')
-    }
+    // if (process.env.IMAP_USER && process.env.IMAP_PASS) {
+    //   console.log('[Email] Auto-starting email watch...')
+    //   this._startEmailWatch({
+    //     interval: 60,
+    //     host: process.env.IMAP_HOST,
+    //     port: parseInt(process.env.IMAP_PORT) || 993,
+    //     user: process.env.IMAP_USER,
+    //     password: process.env.IMAP_PASS,
+    //     box: 'INBOX'
+    //   })
+    // } else {
+    //   console.log('[Email] IMAP credentials not configured, skipping auto-start')
+    // }
     return this
   }
 

package/skills/workflow-guide/SKILL.md

@@ -138,6 +138,45 @@ allowed-tools: execute_workflow,reloadWorkflows
 }
 ```
 
+**重要：使用 `{{result}}` 引用上一步结果（推荐）**
+
+上一步骤的结果自动保存在 `{{result}}` 中，可以直接提取字段：
+
+```json
+{
+  "type": "tool",
+  "name": "获取IP",
+  "tool": "fetch",
+  "args": {
+    "url": "https://api.ipify.org?format=json"
+  }
+},
+{
+  "type": "tool",
+  "name": "发送通知",
+  "tool": "notification_send",
+  "args": {
+    "title": "IP 信息",
+    "message": "当前公网IP: {{result.body.ip}}"
+  }
+}
+```
+
+支持的引用格式：
+
+| 格式 | 说明 |
+|------|------|
+| `{{result}}` | 上一步完整结果 |
+| `{{result.body}}` | 提取 body 字段 |
+| `{{result.body.ip}}` | 从 body 提取嵌套字段 |
+| `{{result.body.data[0].name}}` | 支持数组索引 |
+| `{{lastResult}}` | result 的别名 |
+| `{{lastResult.error}}` | 从错误对象提取信息 |
+| `{{variables.xxx}}` | 显式引用 context.variables |
+| `{{input.xxx}}` | 引用工作流输入参数 |
+
+**自动 JSON 解析**：如果字段值是 JSON 字符串，会自动解析为对象后再提取嵌套字段。
+
 ### 3. loop - 循环步骤
 
 重复执行一组步骤：
@@ -215,6 +254,7 @@ allowed-tools: execute_workflow,reloadWorkflows
 
 ### 示例：获取IP并发送通知
 
+**推荐写法**（使用 `{{result}}` 直接引用上一步结果）：
 ```json
 {
   "name": "get-ip-notify",
@@ -227,23 +267,41 @@ allowed-tools: execute_workflow,reloadWorkflows
       "args": {
         "url": "https://api.ipify.org?format=json",
         "proxy": true
-      },
+      }
+    },
+    {
+      "type": "tool",
+      "name": "发送通知",
+      "tool": "notification_send",
+      "args": {
+        "title": "IP 信息",
+        "message": "当前公网IP: {{result.body.ip}}"
+      }
+    }
+  ]
+}
+```
+
+**旧写法**（仍支持，但不推荐）：
+```json
+{
+  "name": "get-ip-notify-old",
+  "steps": [
+    {
+      "type": "tool",
+      "tool": "fetch",
+      "args": { "url": "https://api.ipify.org?format=json" },
       "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}}"
-      }
+      "args": { "message": "当前公网IP: {{currentIp}}" }
     }
   ]
 }
@@ -282,13 +340,15 @@ allowed-tools: execute_workflow,reloadWorkflows
 
 ## 注意事项
 
-1. **script 必须 return**：`script` 是函数体，必须用 return 返回值
-2. **JSON 中 script 单行写**：用分号分隔多个语句，不要换行
-3. **JSON 中不能有注释**：注释会导致 JSON 解析失败
-4. **context.variables** 在所有步骤间共享，可存储中间结果
-5. **context.input** 是工作流的输入参数
-6. 循环变量 `i` 从 0 开始计数
-7. 条件分支的 `condition` 是 JavaScript 表达式字符串
+1. **优先使用 `{{result}}` 引用**：上一步结果直接用 `{{result.field}}` 提取，比 script 更简洁
+2. **script 必须 return**：`script` 是函数体，必须用 return 返回值
+3. **JSON 中 script 单行写**：用分号分隔多个语句，不要换行
+4. **JSON 中不能有注释**：注释会导致 JSON 解析失败
+5. **context.variables** 在所有步骤间共享，可存储中间结果
+6. **context.input** 是工作流的输入参数
+7. 循环变量 `i` 从 0 开始计数
+8. 条件分支的 `condition` 是 JavaScript 表达式字符串
+9. **自动 JSON 解析**：`{{result.body}}` 如果是 JSON 字符串会自动解析
 
 ## 最佳实践
 

package/src/capabilities/workflow-engine.js

@@ -328,12 +328,29 @@ class StepExecutor {
 
   _resolveValue(value, context) {
     if (typeof value === 'string') {
+      // 支持多种引用格式：
+      // {{result}} - 上一步结果 (lastResult)
+      // {{result.body.ip}} - 从上一步结果提取嵌套字段
+      // {{variables.xxx}} - 显式引用 context.variables
+      // {{context.xxx}} - 显式引用 context 根属性
+      // {{lastResult}} - 上一步结果（result 的别名）
       return value.replace(/\{\{(\w+(?:\.\w+)*)\}\}/g, (match, path) => {
+        // result 和 lastResult 都指向 context.lastResult
+        if (path === 'result' || path === 'lastResult') {
+          return context.lastResult ?? match
+        }
+        if (path.startsWith('result.') || path.startsWith('lastResult.')) {
+          const nestedPath = path.replace(/^(result|lastResult)\./, '')
+          const val = this._getNestedValue(context.lastResult, nestedPath)
+          if (val !== undefined) return val
+          return match
+        }
         if (path.startsWith('variables.')) {
           return this._getNestedValue(context, path) ?? match
         } else if (path.startsWith('context.')) {
           return this._getNestedValue(context, path) ?? match
         } else {
+          // 先从 variables 查找，再从 context 根属性查找
           const val = this._getNestedValue(context.variables, path)
           if (val !== undefined) return val
           return this._getNestedValue(context, path) ?? match
@@ -357,6 +374,14 @@ class StepExecutor {
     let current = obj
     for (const part of parts) {
       if (current === null || current === undefined) return undefined
+      // 如果当前值是字符串，尝试解析为 JSON
+      if (typeof current === 'string' && part !== '0' && part !== 'length') {
+        try {
+          current = JSON.parse(current)
+        } catch {
+          // 解析失败，继续用原值
+        }
+      }
       current = current[part]
     }
     return current