调用方（WorkflowNode、API等）
    │
    ▼
CodeExecutorFactory                     ← 统一入口，根据语言路由到对应执行器
    │
    ├── graalvm/GraalVmCodeExecutor     ← GraalVM 沙箱 (JS / Python)
    ├── local/LocalCodeExecutor         ← 本地命令行 (Shell)
    └── opensandbox/OpenSandboxCodeExecutor  ← 阿里 OpenSandbox (全语言)
                                               ↑
                                        AbstractCodeExecutor ← 模板方法基类

sandbox/
├── CodeLanguage.java              # 语言类型枚举 (JS/Python/Shell/Go/Java/TypeScript)
├── CodeExecutionException.java    # 结构化异常 (含 ErrorType 枚举)
├── CodeExecutionResult.java       # 执行结果 (成功/失败/耗时)
├── CodeExecutor.java              # 执行器接口
├── AbstractCodeExecutor.java      # 模板方法基类 (校验/计时/异常兜底)
├── CodeExecutorFactory.java       # 工厂门面，统一调度
├── graalvm/
│   └── GraalVmCodeExecutor.java   # GraalVM Polyglot 实现 (JS/Python)
├── local/
│   └── LocalCodeExecutor.java     # 本地命令行实现 (Shell)
├── opensandbox/
│   └── OpenSandboxCodeExecutor.java  # 阿里 OpenSandbox 实现 (全语言)
└── ARCHITECTURE.md                # 本文档

CodeExecutor (接口)
    └── AbstractCodeExecutor (抽象基类：模板方法)
            ├── GraalVmCodeExecutor   — 覆写 validate() 追加 main 函数检查
            ├── LocalCodeExecutor     — 覆写 getMaxCodeLength() 返回 50,000
            └── OpenSandboxCodeExecutor — 远程沙箱，全语言支持

public interface CodeExecutor {
    CodeExecutionResult execute(String code, Map<String, Object> params,
                                CodeLanguage language, int timeoutSeconds);
    Set<CodeLanguage> supportedLanguages();
    String getName();
}

execute(code, params, language, timeout)
    │
    ├── 1. validate(code, language)         ← 可覆写：null/blank/长度 + 子类自定义校验
    │       └── 失败 → 返回 CodeExecutionResult.failure
    │
    ├── 2. doExecute(code, params, ...)     ← 子类实现实际执行逻辑
    │
    └── 3. catch Exception                  ← 兜底异常处理
            └── 返回 CodeExecutionResult.failure

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

// 方式二：获取结构化结果（不抛异常）
CodeExecutionResult result = CodeExecutorFactory.executeWithResult(
    code, params, CodeLanguage.PYTHON, 60);

// 方式三：注册 OpenSandbox（仅为 Go/Java/TypeScript 补充，不覆盖已有引擎）
CodeExecutorFactory.registerOpenSandbox("http://sandbox:8080", "api-key");

// 方式四：注册 OpenSandbox 为所有语言的执行器（覆盖 GraalVM 和 Local）
CodeExecutorFactory.registerOpenSandboxForAll("http://sandbox:8080", "api-key");

<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>

<dependency>
    <groupId>com.alibaba.opensandbox</groupId>
    <artifactId>code-interpreter</artifactId>
    <version>1.0.3</version>
</dependency>