feat(platform): 插件协议系统 - 支持声明式渠道、工作流与参考媒体映射

web/src/lib/canvas/node-registry/definitions/builtin-nodes.tsx

@@ -16,8 +16,7 @@ const DEFAULT_MIN_SIZE = { width: 220, height: 160 } as const;
  * 尺寸、默认标题与初始 metadata 不在这里重复——它们的数据源是 constant/canvas.ts 的
  * NODE_SPECS，下方装配时统一读取。
  *
- * `satisfies Record<CanvasNodeType, …>` 是刻意的：往 CanvasNodeType 加成员后若不补定义，
- * 这里会编译失败，而不是在运行期悄悄回落成兜底值。
+ * 内置节点保持集中定义；第三方节点通过同一 registry 以命名空间 ID 动态注册。
  */
 const BUILTIN_NODE_TRAITS = {
     [CanvasNodeType.Image]: {
@@ -166,7 +165,7 @@ const BUILTIN_NODE_TRAITS = {
         resourceKind: () => "image",
         inputKind: "image",
     },
-} satisfies Record<CanvasNodeType, Omit<CanvasNodeDefinition, "type" | "defaultTitle" | "defaultSize" | "defaultMetadata">>;
+} satisfies Record<string, 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];

web/src/lib/canvas/node-registry/index.ts

@@ -1,3 +1,3 @@
 export type { CanvasNodeDefinition, CanvasNodeInputKind } from "./node-definition";
-export { getNodeDefinition, getNodeGenerationMode, getNodeIcon, getNodeInputKind, getNodeLabel, getNodeListLabel, getNodeMinSize, getNodeOwnerId, getNodeResourceKind, listCreatableNodeDefinitions, listNodeDefinitions, registerNodeDefinitions, shouldKeepAspectRatio, unregisterNodeDefinitions } from "./node-registry";
+export { getNodeDefinition, getNodeGenerationMode, getNodeIcon, getNodeInputKind, getNodeLabel, getNodeListLabel, getNodeMinSize, getNodeOwnerId, getNodeResourceKind, listCreatableNodeDefinitions, listNodeDefinitions, registerNodeDefinitions, registerPluginCanvasNodes, shouldKeepAspectRatio, unregisterNodeDefinitions } from "./node-registry";
 import "./definitions";

web/src/lib/canvas/node-registry/node-definition.ts

@@ -1,7 +1,8 @@
 import type { ReactNode } from "react";
 
 import type { CanvasResourceKind } from "@/lib/canvas/canvas-resource-references";
-import type { CanvasGenerationMode, CanvasNodeData, CanvasNodeMetadata, CanvasNodeType } from "@/types/canvas";
+import type { CanvasGenerationMode, CanvasNodeData, CanvasNodeMetadata, CanvasNodeTypeId } from "@/types/canvas";
+import type { PluginCanvasNodeContribution } from "@/lib/plugins/plugin-types";
 
 /** 作为上游输入被容量校验计数时归入的类别 */
 export type CanvasNodeInputKind = "image" | "video" | "audio" | "text";
@@ -13,7 +14,7 @@ export type CanvasNodeInputKind = "image" | "video" | "audio" | "text";
  * 避免同一份知识散落到创建菜单、搜索弹窗、拉伸逻辑等多处后各自漂移。
  */
 export type CanvasNodeDefinition = {
-    type: CanvasNodeType;
+    type: CanvasNodeTypeId;
     /** UI 短标签——创建菜单等处显示，如「文本」 */
     label: string;
     /** 列表/搜索标签，缺省派生为 `${label}节点` */
@@ -45,4 +46,23 @@ export type CanvasNodeDefinition = {
      * 不设表示不参与计数（生成配置、背板）。与 resourceKind 不同，计数不看内容。
      */
     inputKind?: CanvasNodeInputKind;
+    plugin?: {
+        pluginId: string;
+        renderer: PluginCanvasNodeContribution["renderer"];
+        schema: Record<string, unknown>;
+    };
 };
+
+export function canvasNodeDefinitionFromPlugin(pluginId: string, contribution: PluginCanvasNodeContribution): CanvasNodeDefinition {
+    return {
+        type: contribution.id,
+        label: contribution.label,
+        icon: null,
+        defaultTitle: contribution.defaultTitle,
+        defaultSize: contribution.defaultSize,
+        defaultMetadata: { pluginId, pluginNodeId: contribution.id, pluginData: {}, content: "" },
+        minSize: { width: Math.min(contribution.defaultSize.width, 220), height: Math.min(contribution.defaultSize.height, 160) },
+        showInCreateMenu: true,
+        plugin: { pluginId, renderer: contribution.renderer, schema: contribution.schema },
+    };
+}

web/src/lib/canvas/node-registry/node-registry.ts

@@ -1,11 +1,12 @@
-import type { CanvasNodeData, CanvasNodeType } from "@/types/canvas";
+import type { CanvasNodeData, CanvasNodeTypeId } from "@/types/canvas";
+import type { PluginCanvasNodeContribution } from "@/lib/plugins/plugin-types";
 
-import type { CanvasNodeDefinition } from "./node-definition";
+import { canvasNodeDefinitionFromPlugin, type CanvasNodeDefinition } from "./node-definition";
 
 /** 模块级注册表 */
-const definitions = new Map<CanvasNodeType, CanvasNodeDefinition>();
+const definitions = new Map<CanvasNodeTypeId, CanvasNodeDefinition>();
 /** 节点类型 → 归属方。内置节点归属 "builtin"，为后续扩展留出隔离位。 */
-const ownerByType = new Map<CanvasNodeType, string>();
+const ownerByType = new Map<CanvasNodeTypeId, string>();
 
 /** 未注册类型的兜底最小尺寸——与非媒体节点的历史下限一致 */
 const FALLBACK_MIN_SIZE = { width: 220, height: 160 } as const;
@@ -18,6 +19,11 @@ export function registerNodeDefinitions(defs: CanvasNodeDefinition[], ownerId =
     }
 }
 
+/** Registers schema-driven canvas nodes from the unified plugin manifest. */
+export function registerPluginCanvasNodes(pluginId: string, nodes: PluginCanvasNodeContribution[]) {
+    registerNodeDefinitions(nodes.map((node) => canvasNodeDefinitionFromPlugin(pluginId, node)), pluginId);
+}
+
 /**
  * 注销某归属方的全部节点定义。
  * 只删归属该 ownerId 的条目——内置节点不会被其他归属方的增删波及。
@@ -30,11 +36,11 @@ export function unregisterNodeDefinitions(ownerId: string) {
     }
 }
 
-export function getNodeDefinition(type: CanvasNodeType) {
+export function getNodeDefinition(type: CanvasNodeTypeId) {
     return definitions.get(type);
 }
 
-export function getNodeOwnerId(type: CanvasNodeType) {
+export function getNodeOwnerId(type: CanvasNodeTypeId) {
     return ownerByType.get(type) || "builtin";
 }
 
@@ -48,23 +54,23 @@ export function listCreatableNodeDefinitions() {
 }
 
 /** UI 短标签 */
-export function getNodeLabel(type: CanvasNodeType) {
+export function getNodeLabel(type: CanvasNodeTypeId) {
     return definitions.get(type)?.label || "未知节点";
 }
 
 /** 列表/搜索标签，缺省派生自 label */
-export function getNodeListLabel(type: CanvasNodeType) {
+export function getNodeListLabel(type: CanvasNodeTypeId) {
     const def = definitions.get(type);
     if (!def) return "未知节点";
     return def.listLabel || `${def.label}节点`;
 }
 
-export function getNodeIcon(type: CanvasNodeType) {
+export function getNodeIcon(type: CanvasNodeTypeId) {
     return definitions.get(type)?.icon ?? null;
 }
 
 /** 手动拉伸的最小尺寸 */
-export function getNodeMinSize(type: CanvasNodeType) {
+export function getNodeMinSize(type: CanvasNodeTypeId) {
     return definitions.get(type)?.minSize ?? FALLBACK_MIN_SIZE;
 }
 
@@ -87,6 +93,6 @@ export function getNodeGenerationMode(node: CanvasNodeData) {
 }
 
 /** 该节点作为上游输入被计数时的类别，不参与计数返回 undefined */
-export function getNodeInputKind(type: CanvasNodeType) {
+export function getNodeInputKind(type: CanvasNodeTypeId) {
     return definitions.get(type)?.inputKind;
 }