调用方（WorkflowNode、API等）
    │
    ▼
CodeExecutorFactory          ← 统一入口，根据语言路由到对应 Provider
    │
    ├── GraalVmCodeExecutor  ← Provider 1: GraalVM 沙箱 (JS / Python)
    ├── LocalCodeExecutor    ← Provider 2: 本地命令行 (Shell)
    └── RemoteCodeExecutor   ← Provider 3: 远程 Sandbox API (预留扩展)

sandbox/
├── CodeLanguage.java           # 语言类型枚举 (JAVASCRIPT / PYTHON / SHELL)
├── CodeExecutionException.java # 结构化异常 (含 ErrorType 枚举)
├── CodeExecutionResult.java    # 执行结果 (成功/失败/耗时)
├── CodeExecutorFactory.java    # 工厂门面，统一调度
├── provider/
│   ├── CodeExecutor.java       # 执行器接口
│   ├── GraalVmCodeExecutor.java    # GraalVM Polyglot 实现
│   ├── LocalCodeExecutor.java      # 本地命令行实现
│   └── RemoteCodeExecutor.java     # 远程 API 实现 (预留)
├── JavaScriptExecutorTest.java # JS 测试用例 (19项：基础运算/网络限制验证/高级特性/错误处理)
├── PythonExecutorTest.java     # Python 测试用例 (20项：基础运算/标准库/网络限制验证/数据聚合/错误处理)
└── ShellExecutorTest.java      # Shell 测试用例 (32项：基础命令/网络请求/磁盘目录/IP获取/系统信息/文本处理)

public interface CodeExecutor {
    // 执行代码，返回结构化结果
    CodeExecutionResult execute(String code, Map<String, Object> params,
                                CodeLanguage language, int timeoutSeconds);
    // 支持的语言集合
    Set<CodeLanguage> supportedLanguages();
    // 执行器名称
    String getName();
}

// 方式一：快捷调用（抛异常）
String result = CodeExecutorFactory.execute(code, params, "javascript");

// 方式二：获取结构化结果（不抛异常）
CodeExecutionResult result = CodeExecutorFactory.executeWithResult(
    code, params, CodeLanguage.PYTHON, 60);
if (result.isSuccess()) {
    System.out.println(result.getOutput());
} else {
    System.out.println(result.getErrorMessage());
}

// 方式三：注册自定义执行器（如远程 Sandbox）
CodeExecutorFactory.register(new RemoteCodeExecutor("http://sandbox:8080"));

用户代码 → 格式校验(main函数) → 参数JSON序列化 → 拼接调用代码 → GraalVM执行 → 返回结果

// 用户代码
function main(params) {
    return { result: params.x + params.y };
}

// === LangChat Sandbox ===（自动拼接）
var __lc_params = {"x":1,"y":2};
var __lc_result = main(__lc_params);
JSON.stringify(__lc_result);

# 用户代码
def main(params):
    return {"result": params["x"] + params["y"]}

# === LangChat Sandbox ===（自动拼接）
import json
__lc_params = json.loads('{"x":1,"y":2}')
__lc_result = main(__lc_params)
print(json.dumps(__lc_result))

<dependency>
    <groupId>dev.langchain4j</groupId>
    <artifactId>langchain4j-code-execution-engine-graalvm-polyglot</artifactId>
</dependency>

<dependency>
    <groupId>dev.langchain4j</groupId>
    <artifactId>langchain4j-community-code-execution-engine-local</artifactId>
</dependency>

# GET 请求
curl -s --connect-timeout 5 --max-time 10 'https://httpbin.org/get?name=LangChat'

# POST JSON
curl -s -X POST -H 'Content-Type: application/json' \
    -d '{"key":"value"}' 'https://httpbin.org/post'

# 获取 HTTP 状态码
curl -s -o /dev/null -w '%{http_code}' 'https://httpbin.org/status/200'

# 带认证的请求
curl -s -H 'Authorization: Bearer token' 'https://api.example.com/data'

Shell curl → JSON 响应 → 作为 params 传入 → JS/Python 沙箱解析处理