des-twin

DES digital twin helpers: takt beat (JPH × speed) and station wall-clock wait for n8n workflows

Package Information

Released: 6 mo ago

Downloads: 8 weekly / 155 monthly

Latest Version: 0.2.1

Author: DES-AI

Available Nodes

Documentation generating…

DES 节拍放行

按 JPH 与倍速生成串行放行批次（每条 item 一台车序号），供下游 MySQL / HTTP 等节点消费。与 DES-AI 前端仿真中的节拍语义对齐。

DES 工位墙钟

根据工位在 1× 下的作业时长与倍速，计算墙钟等待秒数/毫秒，便于衔接 n8n「Wait」等节点。

DES 信号灯闸门

按灯相（绿/黄/红）与黄灯缓冲队列上限判定是否放行：绿灯行、红灯阻塞、黄灯在队列未满时进入缓冲语义。可在每条 item 上携带 queueDepth 与可选灯相字段。

DES 双路分支

根据每条 item 上字段值与支路 A/B 配置匹配，输出到两个主输出（对应 Vue Flow 中 branchSwitch 的 br-a / br-b）。未匹配项走默认支路。

DES 可视化上报

将当前批次的 item.json 作为数组 POST 到可视化/看板服务（无额外 npm 依赖，使用 n8n 内置 httpRequest）。用于驱动前端小车等展示。

Documentation

n8n-nodes-des-twin

面向 DES-AI 数字孪生产线 的 n8n 自定义社区节点包（v0.2.1）：节拍、工位墙钟、信号灯闸门、双路分支、可视化上报；与内置 MySQL、Wait、HTTP Request（PLC） 组合即可完成整条编排。

一、n8n 社区节点机制（摘要）

形态：独立 npm 包，包名 n8n-nodes-*，package.json 的 n8n.nodes 指向 dist 下各 *.node.js。
实现：每节点一个类实现 INodeType（description + execute），图标为同目录 file:*.svg。
构建：npm run build → tsc + scripts/copy-icons.mjs（避免部分环境下 @n8n/node-cli 的 ESM 冲突）。
安装：自托管设置 N8N_CUSTOM_EXTENSIONS 指向本包根目录并重启；或 Settings → Community nodes 安装已发 npm 的包名。需与实例的 n8n / n8n-workflow 大版本 匹配（本包 peerDependencies: n8n-workflow@^2）。

二、目录结构

n8n-nodes-des-twin/
├── .npmrc                 # 强制官方 registry，避免镜像导致 publish 404
├── package.json
├── LICENSE
├── tsconfig.json
├── scripts/
│   ├── copy-icons.mjs
│   └── pre-publish-check.mjs
├── nodes/
│   ├── DesTaktBeat/
│   ├── DesStationTiming/
│   ├── DesTrafficLightGate/
│   ├── DesBranchRoute/
│   └── DesVisualizationPing/
├── dist/                 # 构建生成
└── README.md

三、节点一览

节点	`name`	作用
DES 节拍放行	`desTaktBeat`	按 JPH、倍速、批条数生成多条 `item`；输出 `runId`、`correlationKey`、`spawnIntervalSimMs` 等（与 `useVehicleFlow.ts` 公式一致）。
DES 工位墙钟	`desStationTiming`	按工位 1× 秒数与倍速写入 `desStation.waitWallMs` / `waitWallSeconds`，供 Wait 引用。
DES 信号灯闸门	`desTrafficLightGate`	绿灯放行、红灯阻塞、黄灯在 `queueDepth < yellowQueueCapacity` 时缓冲，否则视为队列满阻塞；结果写入 `desTraffic`；可选阻塞抛错。
DES 双路分支	`desBranchRoute`	双主输出：按 `branchKey`（可配置路径）匹配支路 A/B，写入 `desBranch.sourceHandle`（`br-a` / `br-b`），未匹配走默认支路。
DES 可视化上报	`desVisualizationPing`	使用 n8n 内置 `helpers.httpRequest`（无额外 runtime 依赖）将批次或逐条 POST 到看板/前端接口，回写 `desVisual`。

刻意不重复实现的能力：MySQL 取数、PLC HTTP 使用 n8n 自带节点即可；本包只补充 DES 域语义与分流。

四、推荐工作流拓扑

[触发] → [DES 节拍放行]
       → [MySQL]（LIMIT / 关联 correlationKey、vehicleSerial）
       → [DES 信号灯闸门]（item 可带 trafficPhase、queueDepth）
       → [DES 双路分支]（按库中 branchKey）
            ├→ 支路 A → [DES 工位墙钟] → [Wait] → [HTTP PLC] …
            └→ 支路 B → …
       → [DES 可视化上报]（POST 到 Vue 看板，驱动小车等）

Wait：Wait 节点持续时间可用表达式引用上一步的 $json.desStation.waitWallSeconds（秒）。
节拍串行：放车间隔由节拍节点给出的 spawnIntervalSimMs 换算为墙钟秒后接 Wait 或 Schedule 子流，按你们习惯组装。
安全：可视化上报 URL 由你们控制；生产环境请配合鉴权网关或仅内网地址。

五、构建

cd n8n-nodes-des-twin
npm install
npm run build

仓库根目录亦可：npm run n8n-nodes:build。

安装后在节点面板搜索 「DES」 应出现 5 个节点。

六、发布到 npm（本仓库已尽量「一步到位」）

本包已包含：

.npmrc：在本目录执行命令时固定 https://registry.npmjs.org/，避免淘宝/企业镜像下 npm publish 出现 PUT 404。
npm run publish:npm：先跑 scripts/pre-publish-check.mjs（检查 registry、npm whoami 是否已登录、dist 是否存在，缺则自动 build），再 npm publish。

你本机只需执行（无法由他人代登录）：

cd n8n-nodes-des-twin
npm install
npm login          # 浏览器/邮箱/2FA 按 npm 官网提示完成
npm run publish:npm

若 npm 账号开启了 2FA（一次性密码）：

npm run publish:npm -- --otp=你的六位验证码

成功后，在私有化 n8n：Settings → Community nodes，安装包名 n8n-nodes-des-twin（或指定版本 n8n-nodes-des-twin@0.2.1），重启 n8n（若提示需要）。

可选：在 package.json 增加 "repository" 指向真实 Git 仓库，便于 npm 页展示；与 Creator Portal 认证、GitHub Actions provenance 无冲突时再按需接入。

七、许可

MIT。

des-twinInstall