foliko 1.0.74 → 1.0.76

package/src/utils/sandbox.js

@@ -0,0 +1,292 @@
+/**
+ * 安全沙箱工具
+ * 用于替代 new Function() 执行不可信代码
+ * 提供安全的代码执行环境，限制对系统资源的访问
+ */
+
+const { VM, VMScript } = require('vm2')
+
+/**
+ * 创建安全的沙箱上下文
+ * @param {Object} customContext - 自定义上下文变量
+ * @param {Object} options - 配置选项
+ * @returns {Object} 沙箱上下文
+ */
+function createSandboxContext(customContext = {}, options = {}) {
+  const {
+    timeout = 5000,        // 超时时间（毫秒）
+    allowSync = false,     // 是否允许同步执行
+    mockConsole = true      // 是否模拟 console
+  } = options
+
+  // 创建安全的 console 对象
+  const safeConsole = mockConsole ? {
+    log: (...args) => { /* 静默执行，阻止日志泄露 */ },
+    error: (...args) => { /* 静默执行 */ },
+    warn: (...args) => { /* 静默执行 */ },
+    info: (...args) => { /* 静默执行 */ },
+    debug: (...args) => { /* 静默执行 */ }
+  } : console
+
+  return {
+    // 用户提供的上下文
+    ...customContext,
+    // 安全的 console
+    console: safeConsole,
+    // 安全的 Math 对象
+    Math,
+    // 安全的 JSON 对象
+    JSON: {
+      parse: JSON.parse,
+      stringify: JSON.stringify
+    },
+    // 安全的 Array 对象（限制方法）
+    Array: {
+      isArray: Array.isArray,
+      from: Array.from,
+      of: Array.of
+    },
+    // 安全的 String 对象
+    String: {
+      fromCharCode: String.fromCharCode,
+      fromCodePoint: String.fromCodePoint,
+      raw: String.raw
+    },
+    // 安全的 Number 对象
+    Number: {
+      isNaN: Number.isNaN,
+      isFinite: Number.isFinite,
+      parseInt: Number.parseInt,
+      parseFloat: Number.parseFloat
+    },
+    // 安全的 Boolean 对象
+    Boolean,
+    // 安全的 Object 对象
+    Object: {
+      keys: Object.keys,
+      values: Object.values,
+      entries: Object.entries,
+      assign: Object.assign,
+      create: Object.create,
+      freeze: Object.freeze
+    },
+    // 安全的 Date 对象
+    Date: {
+      now: Date.now
+    },
+    // 安全的 RegExp 对象
+    RegExp,
+    // 安全的 Error 对象
+    Error,
+    // 安全的 Promise 对象
+    Promise,
+    // 安全的 Set 对象
+    Set,
+    // 安全的 Map 对象
+    Map,
+    // 安全的 WeakMap 对象
+    WeakMap,
+    // 安全的 WeakSet 对象
+    WeakSet,
+    // 安全的 Symbol
+    Symbol,
+    // 安全的 Proxy
+    Proxy,
+    // 安全的 Reflect
+    Reflect
+  }
+}
+
+/**
+ * 在沙箱中执行异步代码
+ * @param {string} code - 要执行的代码
+ * @param {Object} context - 上下文变量
+ * @param {Object} options - 配置选项
+ * @returns {Promise<any>} 执行结果
+ */
+async function runInSandbox(code, context = {}, options = {}) {
+  const { timeout = 5000 } = options
+
+  try {
+    const vm = new VM({
+      timeout,
+      sandbox: createSandboxContext(context, options),
+      eval: false,
+      wasm: false
+    })
+
+    // 包装代码为异步函数
+    const wrappedCode = `(async () => { ${code} })()`
+    return await vm.run(wrappedCode)
+  } catch (error) {
+    throw new Error(`Sandbox execution error: ${error.message}`)
+  }
+}
+
+/**
+ * 在沙箱中执行表达式（同步）
+ * @param {string} expression - 要执行的表达式
+ * @param {Object} context - 上下文变量
+ * @param {Object} options - 配置选项
+ * @returns {any} 执行结果
+ */
+function evaluateInSandbox(expression, context = {}, options = {}) {
+  const { timeout = 5000 } = options
+
+  try {
+    const vm = new VM({
+      timeout,
+      sandbox: createSandboxContext(context, options),
+      eval: false,
+      wasm: false
+    })
+
+    return vm.run(expression)
+  } catch (error) {
+    throw new Error(`Sandbox evaluation error: ${error.message}`)
+  }
+}
+
+/**
+ * 安全执行脚本（用于工作流中的用户脚本）
+ * @param {string} script - 脚本代码
+ * @param {Object} context - 上下文变量
+ * @param {Object} options - 配置选项
+ * @returns {Promise<any>} 执行结果
+ */
+async function runScriptSafely(script, context = {}, options = {}) {
+  const { timeout = 10000 } = options
+
+  try {
+    const vm = new VM({
+      timeout,
+      sandbox: createSandboxContext(context, options),
+      eval: false,
+      wasm: false
+    })
+
+    // 将脚本包装在异步 IIFE 中
+    const wrappedCode = `
+      (async () => {
+        const { input, input_data, variables, previousResult, console } = context;
+        ${script}
+      })()
+    `
+
+    return await vm.run(wrappedCode)
+  } catch (error) {
+    throw new Error(`Script execution error: ${error.message}`)
+  }
+}
+
+/**
+ * 安全执行工作流定义
+ * @param {string} workflowCode - 工作流代码
+ * @param {Object} engine - 工作流引擎
+ * @param {Object} options - 配置选项
+ * @returns {any} 执行结果
+ */
+function runWorkflowSafely(workflowCode, engine, options = {}) {
+  const { timeout = 5000 } = options
+
+  try {
+    const vm = new VM({
+      timeout,
+      sandbox: {
+        engine,
+        console: {
+          log: () => {},
+          error: () => {},
+          warn: () => {},
+          info: () => {}
+        },
+        Math,
+        JSON,
+        Promise,
+        Array,
+        Object,
+        Date,
+        RegExp,
+        Error,
+        Symbol,
+        Map,
+        Set
+      },
+      eval: false,
+      wasm: false
+    })
+
+    return vm.run(`(function(engine) { return (${workflowCode}) })(engine)`)
+  } catch (error) {
+    throw new Error(`Workflow execution error: ${error.message}`)
+  }
+}
+
+/**
+ * 安全执行工作流加载脚本
+ * @param {string} content - 文件内容
+ * @param {Object} options - 配置选项
+ * @returns {Object} module.exports
+ */
+function runWorkflowFileSafely(content, options = {}) {
+  const { timeout = 10000 } = options
+
+  try {
+    const vm = new VM({
+      timeout,
+      sandbox: {
+        module: { exports: {} },
+        exports: {},
+        require: () => { throw new Error('require is not allowed in sandbox') },
+        process: { 
+          env: {},
+          cwd: () => '/'
+        },
+        console: {
+          log: () => {},
+          error: () => {},
+          warn: () => {},
+          info: () => {}
+        },
+        __dirname: '/',
+        __filename: '/workflow.js',
+        Math,
+        JSON,
+        Promise,
+        Array,
+        Object,
+        Date,
+        RegExp,
+        Error,
+        Symbol,
+        Map,
+        Set
+      },
+      eval: false,
+      wasm: false
+    })
+
+    const wrappedCode = `
+      (function(module, exports, require, process, console, __dirname, __filename) {
+        ${content}
+      })
+    `
+
+    const fn = vm.run(wrappedCode)
+    const moduleObj = { exports: {} }
+    fn(moduleObj, moduleObj.exports, () => {}, { env: {}, cwd: () => '/' }, { log: () => {}, error: () => {}, warn: () => {}, info: () => {} }, '/', '/workflow.js')
+    
+    return moduleObj.exports.default || moduleObj.exports
+  } catch (error) {
+    throw new Error(`Workflow file execution error: ${error.message}`)
+  }
+}
+
+module.exports = {
+  createSandboxContext,
+  runInSandbox,
+  evaluateInSandbox,
+  runScriptSafely,
+  runWorkflowSafely,
+  runWorkflowFileSafely
+}

package/test/tool-registry-validation.test.js

@@ -0,0 +1,218 @@
+/**
+ * 工具参数验证测试
+ */
+
+const { ToolRegistry } = require('../src/core/tool-registry');
+const { z } = require('zod');
+
+async function runTests() {
+  console.log('🧪 开始工具参数验证测试\n');
+  let passed = 0;
+  let failed = 0;
+
+  // 创建工具注册表
+  const registry = new ToolRegistry({ circuitBreaker: false });
+
+  // 注册带 Zod schema 的工具
+  registry.register({
+    name: 'greet',
+    description: '打招呼工具',
+    inputSchema: z.object({
+      name: z.string().describe('姓名'),
+      age: z.number().optional().describe('年龄'),
+      role: z.enum(['admin', 'user', 'guest']).optional().describe('角色'),
+    }),
+    execute: async (args) => {
+      return `Hello, ${args.name}! You are ${args.age || 'unknown age'}.`;
+    },
+  });
+
+  // 注册带 JSON Schema 的工具
+  registry.register({
+    name: 'calculate',
+    description: '计算工具',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        expression: {
+          type: 'string',
+          description: '数学表达式',
+        },
+        precision: {
+          type: 'integer',
+          description: '精度',
+          minimum: 0,
+          maximum: 10,
+        },
+      },
+      required: ['expression'],
+    },
+    execute: async (args) => {
+      return `Calculating: ${args.expression}`;
+    },
+  });
+
+  // 注册无 schema 的工具
+  registry.register({
+    name: 'echo',
+    description: '回声工具',
+    execute: async (args) => {
+      return args;
+    },
+  });
+
+  // 测试1: 有效的 Zod schema 参数
+  try {
+    const result = await registry.execute('greet', { name: 'Alice', age: 25 });
+    console.log('✅ 测试1 通过: 有效的 Zod schema 参数');
+    console.log(`   结果: ${result}\n`);
+    passed++;
+  } catch (err) {
+    console.log('❌ 测试1 失败:', err.message, '\n');
+    failed++;
+  }
+
+  // 测试2: 缺少必需参数（Zod schema）
+  try {
+    await registry.execute('greet', { age: 25 });
+    console.log('❌ 测试2 失败: 应该抛出验证错误\n');
+    failed++;
+  } catch (err) {
+    if (err.validationErrors) {
+      console.log('✅ 测试2 通过: 缺少必需参数正确抛出验证错误');
+      console.log(`   错误详情: ${JSON.stringify(err.validationErrors, null, 2)}\n`);
+      passed++;
+    } else {
+      console.log('❌ 测试2 失败: 错误格式不正确\n');
+      failed++;
+    }
+  }
+
+  // 测试3: 参数类型错误（Zod schema）
+  try {
+    await registry.execute('greet', { name: 123, age: 'twenty-five' });
+    console.log('❌ 测试3 失败: 应该抛出验证错误\n');
+    failed++;
+  } catch (err) {
+    if (err.validationErrors) {
+      console.log('✅ 测试3 通过: 参数类型错误正确抛出验证错误');
+      console.log(`   错误详情: ${JSON.stringify(err.validationErrors, null, 2)}\n`);
+      passed++;
+    } else {
+      console.log('❌ 测试3 失败: 错误格式不正确\n');
+      failed++;
+    }
+  }
+
+  // 测试4: 有效的 JSON Schema 参数
+  try {
+    const result = await registry.execute('calculate', { expression: '2+2', precision: 2 });
+    console.log('✅ 测试4 通过: 有效的 JSON Schema 参数');
+    console.log(`   结果: ${result}\n`);
+    passed++;
+  } catch (err) {
+    console.log('❌ 测试4 失败:', err.message, '\n');
+    failed++;
+  }
+
+  // 测试5: 缺少必需参数（JSON Schema）
+  try {
+    await registry.execute('calculate', { precision: 2 });
+    console.log('❌ 测试5 失败: 应该抛出验证错误\n');
+    failed++;
+  } catch (err) {
+    if (err.validationErrors) {
+      console.log('✅ 测试5 通过: JSON Schema 缺少必需参数正确抛出验证错误');
+      console.log(`   错误详情: ${JSON.stringify(err.validationErrors, null, 2)}\n`);
+      passed++;
+    } else {
+      console.log('❌ 测试5 失败: 错误格式不正确\n');
+      failed++;
+    }
+  }
+
+  // 测试6: 超出范围验证（JSON Schema）
+  try {
+    await registry.execute('calculate', { expression: '2+2', precision: 15 });
+    console.log('❌ 测试6 失败: 应该抛出验证错误\n');
+    failed++;
+  } catch (err) {
+    if (err.validationErrors) {
+      console.log('✅ 测试6 通过: JSON Schema 范围验证正确');
+      console.log(`   错误详情: ${JSON.stringify(err.validationErrors, null, 2)}\n`);
+      passed++;
+    } else {
+      console.log('❌ 测试6 失败: 错误格式不正确\n');
+      failed++;
+    }
+  }
+
+  // 测试7: 无 schema 工具接受任意参数
+  try {
+    const result = await registry.execute('echo', { foo: 'bar', num: 42 });
+    console.log('✅ 测试7 通过: 无 schema 工具接受任意参数');
+    console.log(`   结果: ${JSON.stringify(result)}\n`);
+    passed++;
+  } catch (err) {
+    console.log('❌ 测试7 失败:', err.message, '\n');
+    failed++;
+  }
+
+  // 测试8: 不存在的工具
+  try {
+    await registry.execute('nonexistent', {});
+    console.log('❌ 测试8 失败: 应该抛出工具不存在错误\n');
+    failed++;
+  } catch (err) {
+    if (err.message.includes('not found')) {
+      console.log('✅ 测试8 通过: 工具不存在正确抛出错误\n');
+      passed++;
+    } else {
+      console.log('❌ 测试8 失败: 错误类型不正确\n');
+      failed++;
+    }
+  }
+
+  // 测试9: 可选参数默认值
+  try {
+    const result = await registry.execute('greet', { name: 'Bob' });
+    console.log('✅ 测试9 通过: 可选参数使用默认值');
+    console.log(`   结果: ${result}\n`);
+    passed++;
+  } catch (err) {
+    console.log('❌ 测试9 失败:', err.message, '\n');
+    failed++;
+  }
+
+  // 测试10: enum 验证
+  try {
+    await registry.execute('greet', { name: 'Charlie', role: 'hacker' });
+    console.log('❌ 测试10 失败: enum 值不正确应抛出错误\n');
+    failed++;
+  } catch (err) {
+    if (err.validationErrors) {
+      console.log('✅ 测试10 通过: enum 验证正确');
+      console.log(`   错误详情: ${JSON.stringify(err.validationErrors, null, 2)}\n`);
+      passed++;
+    } else {
+      console.log('❌ 测试10 失败: 错误格式不正确\n');
+      failed++;
+    }
+  }
+
+  // 输出测试摘要
+  console.log('='.repeat(50));
+  console.log(`测试摘要: ${passed} 通过, ${failed} 失败`);
+  console.log('='.repeat(50));
+
+  return failed === 0;
+}
+
+runTests()
+  .then((success) => {
+    process.exit(success ? 0 : 1);
+  })
+  .catch((err) => {
+    console.error('测试执行失败:', err);
+    process.exit(1);
+  });

package/test_report.md

@@ -0,0 +1,70 @@
+# 协同测试报告
+
+## 基本信息
+
+- **测试日期**：2026-04-01 02:34:06
+- **测试环境**：Windows
+- **测试人员**：-
+
+## 测试目的
+
+本文档用于记录协同测试的相关信息和测试结果，验证系统在协同工作场景下的功能表现和稳定性。
+
+### 主要测试目标
+
+1. 验证系统核心功能的正常运行
+2. 测试多模块协同工作的能力
+3. 检查数据交互和状态同步的准确性
+4. 评估系统在高负载场景下的表现
+
+## 测试结果
+
+| 测试项 | 状态 | 备注 |
+|--------|------|------|
+| - | - | - |
+
+## 问题记录
+
+| 序号 | 问题描述 | 严重程度 | 处理状态 |
+|------|----------|----------|----------|
+| - | - | - | - |
+
+## 系统测试结果
+
+### 系统配置汇总
+
+| 项目 | 配置信息 |
+|------|----------|
+| 主机名 | Foliko |
+| 操作系统 | Windows 11 |
+| CPU | Intel Core i3-1220P 12核心 |
+| 内存 | 23.75GB (已用 60.6%) |
+
+### 公网连接信息
+
+| 项目 | 信息 |
+|------|------|
+| 公网IP | 172.71.182.212 |
+| 地理位置 | 荷兰阿姆斯特丹 |
+| ISP | Cloudflare |
+
+## 协同测试总结
+
+### 各Agent执行状态
+
+| Agent | 状态 | 备注 |
+|-------|------|------|
+| code-assistant | ✅ 正常 | 代码助手已就绪 |
+| email-assistant | ✅ 正常 | 邮件助手已就绪 |
+| file-assistant | ✅ 正常 | 文件助手已就绪 |
+| system-assistant | ✅ 正常 | 系统助手已就绪 |
+| web-assistant | ✅ 正常 | Web助手已就绪 |
+
+### 测试完成时间戳
+
+- **测试开始时间**：2026-04-01 02:34:06
+- **测试完成时间**：2026-04-01 02:34:36
+- **测试持续时长**：30秒
+
+## 总结
+