函数目录

运行时会将所有系统函数与扩展函数导出为 fluxon-functions.json，供 VS Code 补全、文档与其他工具共享。

本页是关于函数目录结构的 canonical 参考页。其他页面如需引用字段定义，应链接到这里而不是重复粘贴。

文件位置

默认输出：core/build/fluxon-functions.json（由 :core:dumpFluxonCatalog 任务生成）。

结构定义

目录由 org.tabooproject.fluxon.tool.FunctionDumper 输出，包含三个顶级字段：

generatedAt：生成时间戳（ISO-8601）。
system：系统函数清单（全局函数；是否需要 import 由条目中的 namespace 决定）。
extensions：扩展函数清单，按宿主类型分组（键为 Class#getName()），用于 target::method() 的补全与检索。

示例（截取结构，字段含义以表格为准）：

{
  "generatedAt": "2025-11-12T13:13:17.378940900Z",
  "system": [
    { "name": "print", "params": [1], "async": false, "primarySync": false },
    { "name": "base64", "namespace": "fs:crypto", "params": [0], "async": false, "primarySync": false }
  ],
  "extensions": {
    "java.io.File": [
      { "name": "readText", "namespace": "fs:io", "params": [0], "async": false, "primarySync": false }
    ]
  }
}

函数条目字段

字段	说明
`name`	函数名（脚本侧的调用名）。
`namespace`	可选。若存在，脚本侧需要 `import 'namespace'` 才能解析到该函数/扩展。
`params`	合法的参数个数列表（用于补全与语义检查，不包含参数类型）。
`async`	是否异步函数。若为 `true`，调用通常会返回异步句柄，并需要在支持的上下文中 `await`。
`primarySync`	是否强制在“主线程执行器”上运行（由宿主通过 `FluxonRuntime#setPrimaryThreadExecutor` 提供执行器）。

如何生成

推荐使用 Gradle 任务（自动准备 classpath）：

./gradlew :core:dumpFluxonCatalog
# 输出：core/build/fluxon-functions.json

如需自定义输出路径，可直接调用导出器（需先构建 jar）：

./gradlew :core:jar
java -cp core/build/libs/fluxon-core-*.jar org.tabooproject.fluxon.tool.FunctionDumper ./out/catalog.json

何时重新导出

新增 / 删除 / 重命名运行时函数或扩展函数。
变更参数个数、命名空间或同步/异步属性。
发布 VS Code 扩展或更新文档参考页前。

典型消费方

vscode-extension/scripts/sync-catalog.js：将目录复制到扩展数据目录，驱动补全。
文档：用于说明内置函数与扩展函数的“可用性边界”（但字段定义仅以本页为准）。
外部工具：可按字段含义解析 JSON，自行生成提示或校验。

保持函数目录与源码一致，可以避免补全缺失、文档不匹配等问题。

命令行与资产

术语

文件位置

结构定义

函数条目字段

如何生成

何时重新导出

典型消费方

​文件位置

​结构定义

​函数条目字段

​如何生成

​何时重新导出

​典型消费方

文件位置

结构定义

函数条目字段

如何生成

何时重新导出

典型消费方