动态节点注册与发布

用途

管理员通过受控定义和版本生命周期扩展无限画布节点目录，同时保持内置节点和历史画布数据不变。

配图占位

页面：动态节点管理

状态：草稿校验通过并显示可发布状态

重点区域：revision、执行器、端口、Prompt 映射和发布操作

脱敏要求：隐藏账号信息和 Prompt 正文

使用前准备

该能力仅供管理员使用。动态节点必须使用 custom: kind、系统内置的受控执行器和已注册 Prompt；不能上传脚本、Worker 路径或自定义任务类型。

操作步骤

通过 /api/admin/config-center/canvas-node-definitions 创建和编辑草稿。定义端口、配置 Schema、默认值及 Prompt 变量映射后，先调用 /{definitionId}/validate 校验，再调用 /{definitionId}/publish 发布。所有修改接口都必须提交服务端最近返回的 expectedRevision。

发布后，GET /api/canvas/node-types 的 schema v2 目录会返回该节点及固定的 definitionVersionId。归档使用 /{definitionId}/archive，恢复使用 /{definitionId}/restore。

结果与状态

草稿、已发布版本和定义归档状态彼此独立。发布会原子切换当前发布指针并保留旧版本；目录修订值 catalogRevision 会随可见目录变化。Prompt 内容和变量运行值不会出现在公开目录中。

权限和限制

只有已发布且未归档的定义进入实时目录。执行器只允许文本、图片生成、图片编辑、视频生成和文本转语音五类。配置 Schema 仅接受受控的扁平基础字段，禁止远程 $ref、正则和组合 Schema。

新增注册表不会修改 production_canvas_nodes，也不会给历史内置节点补写版本字段。

常见问题

为什么发布返回版本冲突？

其他管理员已更新该定义。重新读取详情，检查新 revision 后再提交，避免覆盖他人的草稿。

归档会删除旧版本吗？

不会。归档只从实时目录隐藏定义，旧发布版本仍保留。