@genroc/eval-node

中文文档
0.31.0发布于 2026/11/13Apache-2.0ES Module构建来源已验证近 30 天下载 5421

节点的 genroc 脚本任务: 作者- 时间捆绑器和队列工人

中文使用文档
文档目录7 节
  1. 快开始
  2. 添加到现有项目
  3. 写入脚本
  4. 经营工人
  5. 错误
  6. 限制
  7. 链接

@genroc/eval-node (英语)

类型脚本任务 流派。软件包提供了两个二进制:

  • genroc-import:捆绑人. genctl 运行在每一个 apply 财务报告和审定财务报表 generate 转向 $import: ./script.ts 输入一个已选中的自定义模块字符串.
  • genroc-eval-node曰:工人来也. 它从 genroc 队列中声称脚本任务并运行每个任务 一个在新鲜的工人线.

要求数 节点24+。完整指南 : 类型脚本评价。 。 。 .

快开始

genctl init --eval-node

这台脚手架上有一个项目 包,一个 .genroc 登记 解析器, a tsconfig.json,可重用 script-node 儿童过程,a compose.yaml 那个 经营工人.

添加到现有项目

npm i -D @genroc/eval-node

在 .genroc 除定义外:

resolvers:
  - name: import
    phase: typed
    ext: [.ts]
    command: [npx, genroc-import]
    types:
      Input: task.action.input.input
      Output: task.action.result

然后引用任务中的脚本 。 最简单的方式是传播 script-node 那个孩子 genctl init --eval-node 生成 :

- id: greet
  action:
    type: child
    <<: "$process: ./script-node.genroc.yaml"
    input:
      code: "$import: ./greet.ts"
      input: { who: "$: input.who" }
    result_schema:
      type: object
      properties: { greeting: { type: string } }
      required: [greeting]

写入脚本

脚本是ES模块. 它的默认导出收到 input,其返回值变为 任务结果。 该函数可能是同位素.

import type { Input, Output } from "./greet.genroc";

export default function (input: Input): Output {
  return { greeting: `hello, ${input.who}` };
}
  • genctl generate 写入 greet.genroc.d.ts 除了剧本. Input 财务报告和审定财务报表 Output 来自 定义,所以不匹配会失败类型检查 .
  • genctl apply 类型检查和捆绑. 类型错误或缺少默认导出失败 应用.
  • 导入的文件和 npm 包被嵌入到捆绑中, 所以一个存储的定义永远不会 取决于以后安装什么。 节点内建( N)node:fs,.)保持为进口并解决 对工人.
  • 生成的配置扩展您最近的 tsconfig.json。使用节点环球和 内建, 添加 "types": ["node"] 对它.

经营工人

docker run -e GENROC_SERVER=http://host:8448 ghcr.io/genroc/eval-node:latest
# or
GENROC_SERVER=http://localhost:8448 npx genroc-eval-node

工人与genroc相接,而不是相反,所以它只需要外出访问.

环境默认
GENROC_SERVERhttp://localhost:8448流派服务器
GENROC_TOKEN 编号 : GENROC_TOKEN_FILE(无)当服务器使用时, 指示符, 或持有它的文件 --auth
PROCESS 编号 : TASKscript-node 编号 : eval_node进程和任务 ID 这个工人的主张; 默认是脚本节点的。 设定 PROCESS 重命名为副本。 也可能是空的.
CONCURRENCY4脚本立即运行
LEASE_MS30000索赔租赁,每三分之一续租一次
POLL_MS250闲置民意调查间隔
WORKER_IDevaluator-<pid>索赔人的姓名

在启用了认证后,创建一个只有 worker 权限 :

genctl token create --perms worker --label evaluator -q

如果拒绝批准,工人将退出,而不是重新试验.

错误

当一个脚本失败时, 工人会为您报告五个错误代码中的一个 on_error 规则 相匹配的。 匹配的。 重试对其中任何一个都无济于事,因为同一代码失败的方式相同:

代码何时
threw脚本扔出或拒绝
timeout它跑过了任务 timeout (任务无时为5000毫秒)
compile_error模块不解析或没有默认导出功能
nonserializable返回值不能序列化为 JSON(周期, a) BigInt(中文(简体) )
exited脚本调用 process.exit()

error.data 实值 {name, stack?}。 。 。 . name 错误的类名, 所以丢弃自己的 class LimitExceeded extends Error {} 区分失败; 设置 e.name 推翻它, 和被扔的无Error 实值 Thrown。堆栈被映射回您的源线.

如果工人本身有过失,则会为另一名工人释放任务,并报告没有出错.

任务就是 timeout 是脚本的预算,在包含的队列中等待。 工人停下来了 之前的剧本和答案 timeout这样 external.timeout 意味着没有工人回答 一点也不 与 script-node,设置它通过 timeout_ms 输入.

限制

  • 不是一个沙盒. 脚本有工人宿主的文件系统,网络和环境. 只运行你信任的代码.
  • 不是决定主义的. 在一次重试中, 脚本再次以真实的时钟和随机运行 数字。 传递任何必须保持稳定的值 input。 。 。 .
  • 记忆不是孤立的. 一部没有记忆的剧本 摧毁了整个工人.
  • 运行即是选入. 如果一个工人中途死亡, 任务再次要求和脚本 再次运行。 标记任务 only_once 如果您的脚本有副作用.
  • 内置代码需要逃跑. 当你写的时候 code 直接在YAML中而不是 $import,写入 ${ 作为 $${,因为流派读取 ${ 作为插入。 脚本在 .ts 文件不需要逃跑 .

版本与发布记录

@genroc/eval-node 共发布 374 个版本,首次发布于 2026/09/01;过去 12 个月发布了 374 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.31.0latest2026/11/133 天前
0.0.0-edge.c30783fbedge2026/11/133 天前
0.0.0-edge.249fac072026/11/115 天前
0.30.02026/11/115 天前
0.0.0-edge.02055f442026/11/115 天前
0.0.0-edge.2ef1ae242026/10/2620 天前

关于 @genroc/eval-node 的常见问题

@genroc/eval-node 是什么?

节点的 genroc 脚本任务: 作者- 时间捆绑器和队列工人

如何安装 @genroc/eval-node?

在项目目录运行 npm install @genroc/eval-node,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 genroc-import、genroc-eval-node,可以用 npx genroc-import 直接运行。

@genroc/eval-node 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/genroc__eval-node 是否存在。

@genroc/eval-node 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@genroc/eval-node 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=24。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@genroc/eval-node 可以商用吗?

@genroc/eval-node 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@genroc/eval-node 的下载量有多少?

根据 npm 官方下载统计,@genroc/eval-node 在 2026/10/16 – 2026/11/14 这 30 天内被下载 5,421 次,日均约 181 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@genroc/eval-node 还在维护吗?

最新版本 0.31.0 发布于 2026/11/13(3 天前);至今共发布 374 个版本,其中过去 12 个月发布了 374 个;首次发布于 2026/09/01。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。