refactor(canvas): 节点注册表 - 收敛节点展示与几何知识到单一数据源

每加一种画布节点，叫什么、长什么样、能不能自由拉伸要在 4-5 处各写一遍。实际后果是节点标签出现三份且互相矛盾（NODE_DEFAULT_SIZE.title / 创建菜单 label / 搜索弹窗 nodeTypeLabel），canvas-node-size.ts 里还有第四份硬编码兜底。新增 lib/canvas/node-registry/，镜像现有 tool-registry/ 的结构：静态定义带 satisfies Record<CanvasNodeType, ...> 做编译期穷尽性检查（往枚举加成员不补定义即编译失败），再注册进模块级 Map 并按 ownerId 归属，为后续扩展留出隔离位。尺寸与初始 metadata 的数据源仍是 constant/canvas.ts 的 NODE_SPECS，定义文件读它而非复制，现有约 40 处布局计算未动；渲染层 nodeContentRenderers 已是查表结构，本次不改。标签刻意分三个字段各司其职，界面文案零变化： - defaultTitle 新建节点默认名（Note/Audio/未命名背板原样保留） - label UI 短标签 - listLabel 列表标签，缺省派生为 label + 节点；背板显式钉住为背板接入 3 处调用点：创建菜单标签与图标、搜索弹窗类型标签、canvas-node.tsx 的 minWidth/minHeight 与 keepRatio。导演台落在节点分区但开的是工作台、不是节点类型，故不走注册表。 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-08-20 22:22:28 +08:00
parent 7a817d6847
commit af84cf5772
8 changed files with 232 additions and 29 deletions
--- a/web/src/lib/canvas/node-registry/definitions/builtin-nodes.tsx
+++ b/web/src/lib/canvas/node-registry/definitions/builtin-nodes.tsx
@@ -0,0 +1,97 @@
+import { Clapperboard, Image as ImageIcon, Music2, PanelTop, Pencil, Settings2, Sparkles, Type, Video } from "lucide-react";
+
+import { NODE_SPECS } from "@/constant/canvas";
+import { MEDIA_NODE_MIN_SIZE } from "@/lib/canvas/canvas-node-size";
+import { CanvasNodeType, type CanvasNodeData } from "@/types/canvas";
+
+import type { CanvasNodeDefinition } from "../node-definition";
+import { registerNodeDefinitions } from "../node-registry";
+
+/** 非媒体节点的拉伸下限 */
+const DEFAULT_MIN_SIZE = { width: 220, height: 160 } as const;
+
+/**
+ * 每种内置节点的自有特征。
+ *
+ * 尺寸、默认标题与初始 metadata 不在这里重复——它们的数据源是 constant/canvas.ts 的
+ * NODE_SPECS，下方装配时统一读取。
+ *
+ * `satisfies Record<CanvasNodeType, …>` 是刻意的：往 CanvasNodeType 加成员后若不补定义，
+ * 这里会编译失败，而不是在运行期悄悄回落成兜底值。
+ */
+const BUILTIN_NODE_TRAITS = {
+    [CanvasNodeType.Image]: {
+        label: "图片",
+        icon: <ImageIcon />,
+        minSize: MEDIA_NODE_MIN_SIZE,
+        keepAspectRatio: (node: CanvasNodeData) => !node.metadata?.freeResize,
+        showInCreateMenu: true,
+    },
+    [CanvasNodeType.Text]: {
+        label: "文本",
+        icon: <Type />,
+        minSize: DEFAULT_MIN_SIZE,
+        showInCreateMenu: true,
+    },
+    [CanvasNodeType.Drawing]: {
+        label: "绘图",
+        icon: <Pencil />,
+        minSize: DEFAULT_MIN_SIZE,
+        showInCreateMenu: true,
+    },
+    [CanvasNodeType.Script]: {
+        label: "分镜脚本",
+        icon: <Clapperboard />,
+        // 分镜脚本的表格布局需要更宽的下限；高度仍由内容动态撑开（见 canvas-node.tsx）。
+        minSize: { width: 800, height: DEFAULT_MIN_SIZE.height },
+        showInCreateMenu: true,
+    },
+    [CanvasNodeType.Skill]: {
+        label: "技能",
+        icon: <Sparkles />,
+        minSize: DEFAULT_MIN_SIZE,
+        // 技能节点由技能库插入，不占创建菜单格位。
+        showInCreateMenu: false,
+    },
+    [CanvasNodeType.Config]: {
+        label: "生成配置",
+        icon: <Settings2 />,
+        minSize: DEFAULT_MIN_SIZE,
+        // 生成配置由连线时自动创建。
+        showInCreateMenu: false,
+    },
+    [CanvasNodeType.Video]: {
+        label: "视频",
+        icon: <Video />,
+        minSize: MEDIA_NODE_MIN_SIZE,
+        keepAspectRatio: () => true,
+        showInCreateMenu: true,
+    },
+    [CanvasNodeType.Audio]: {
+        label: "音频",
+        icon: <Music2 />,
+        minSize: DEFAULT_MIN_SIZE,
+        showInCreateMenu: true,
+    },
+    [CanvasNodeType.Frame]: {
+        label: "背板",
+        // 背板在列表里就叫「背板」，不是「背板节点」——显式钉住，避免被 label 派生改写。
+        listLabel: "背板",
+        icon: <PanelTop />,
+        minSize: DEFAULT_MIN_SIZE,
+        showInCreateMenu: true,
+    },
+} satisfies Record<CanvasNodeType, Omit<CanvasNodeDefinition, "type" | "defaultTitle" | "defaultSize" | "defaultMetadata">>;
+
+export const BUILTIN_NODE_DEFINITIONS: CanvasNodeDefinition[] = (Object.keys(BUILTIN_NODE_TRAITS) as CanvasNodeType[]).map((type) => {
+    const spec = NODE_SPECS[type];
+    return {
+        type,
+        ...BUILTIN_NODE_TRAITS[type],
+        defaultTitle: spec.title,
+        defaultSize: { width: spec.width, height: spec.height },
+        defaultMetadata: spec.metadata,
+    };
+});
+
+registerNodeDefinitions(BUILTIN_NODE_DEFINITIONS);
--- a/web/src/lib/canvas/node-registry/definitions/index.ts
+++ b/web/src/lib/canvas/node-registry/definitions/index.ts
@@ -0,0 +1,4 @@
+/**
+ * 导入此模块会触发所有内置节点定义的注册。
+ */
+import "./builtin-nodes";