Fluxon

JVM scripting language runtime: lexer/parser/runtime, interpreter, and bytecode compiler.

Fluxon 是一个运行在 JVM 上的轻量脚本语言实现（解析器 + 解释器 + 字节码编译器），支持表达式化控制流、扩展函数与 :: 上下文调用，可用于嵌入式脚本、REPL 与 JSR223。

模块结构

• core：语言核心（lexer/parser/runtime/interpreter/bytecode）
• core-console：CLI/REPL（脚本文件 + -e/--eval）
• core-jsr223：JSR223 ScriptEngine（fluxon）
• core-web-backend：最小化 HTTP 执行后端（可选）

构建与测试

./gradlew build
./gradlew test
# 过滤单个用例：
./gradlew test --tests 'org.tabooproject.fluxon.parser.ParserTest'

Windows 可使用 gradlew.bat。

运行（Console / REPL）

启动 REPL

./gradlew :core-console:run

执行脚本文件

./gradlew :core-console:run --args "<path/to/script.fs>"

执行表达式（-e/--eval）

--args 的值以 - 开头时，建议使用 = 形式传参：

./gradlew :core-console:run --args="-e 1 + 2"
./gradlew :core-console:run --args="-e print('hello')"
./gradlew :core-console:run --args="-e x = 1; print(&x + 2)"

脚本片段：

x = 1
print(&x + 2)

Windows PowerShell（推荐用绝对路径 + 将 Gradle 缓存放在工作区，避免默认 %USERPROFILE%\.gradle 的锁文件问题）：

$script = (Resolve-Path "core-syntax.fs").Path
$env:GRADLE_USER_HOME = "$PWD/.gradle-local"  # optional
./gradlew --no-daemon :core-console:run --args "$script"

生成函数目录（catalog）

./gradlew :core:dumpFluxonCatalog

输出：core/build/fluxon-functions.json

嵌入式使用（Java）

import org.tabooproject.fluxon.Fluxon;
import org.tabooproject.fluxon.compiler.CompilationContext;
import org.tabooproject.fluxon.runtime.Environment;
import org.tabooproject.fluxon.runtime.FluxonRuntime;

Environment env = FluxonRuntime.getInstance().newEnvironment();
CompilationContext ctx = new CompilationContext("x = 1; &x + 2");
ctx.setAllowReflectionAccess(false); // 需要 '.' 反射访问时再开启

Object result = Fluxon.eval(Fluxon.parse(env, ctx), env);
System.out.println(result); // 3

安全提示

• 反射成员访问 . 与 Java 构造 new 都是可开关能力；对不可信脚本建议保持禁用。
• import 可通过编译上下文禁用，并支持黑名单（见 core/src/main/java/org/tabooproject/fluxon/compiler/CompilationContext.java）。

跨 ClassLoader 函数共享

支持不同 ClassLoader 中的 Fluxon 运行时实例之间共享函数（典型场景：Bukkit 插件间共享）。

底层使用 System.getProperties() 作为 JVM 全局单例锚点，通过 MethodHandle + 版本化 Object[] 元组实现零依赖的跨 CL 调用。

导出函数

FluxonRuntime runtime = FluxonRuntime.getInstance();
runtime.setSharingIdentity("MyPlugin");  // 通常用 plugin.getName()

// 方式 1：直接导出 MethodHandle
MethodHandle mh = MethodHandles.lookup().findStatic(MyClass.class, "heal", MethodType.methodType(int.class, int.class));
runtime.exportFunction("heal", mh);

// 方式 2：导出已注册的函数
runtime.registerFunction("greet", sig, ctx -> { ... });
runtime.exportRegisteredFunction("greet");

// 方式 3：通过 ExtensionBuilder 一步注册+导出
runtime.registerExtension(Player.class).sharedFunction("heal", sig, ctx -> { ... });

// 方式 4：@Export(shared = true) 注解自动导出

导入函数

// 导入指定函数
runtime.importSharedFunction("OtherPlugin", "heal");

// 导入指定插件的所有共享函数
runtime.importAllSharedFunctions("OtherPlugin");

// 导入所有插件的所有共享函数
runtime.importAllSharedFunctions();

// 显式查找（不自动注册到本地运行时）
Function f = env.getSharedFunction("OtherPlugin", "heal");

插件卸载

// 移除所有已导出的共享函数
runtime.unexportAll();