@remixmate/cli 0.1.0

package/skills/template-bind/video_dsl/schema/render-plan-v1alpha1.json

@@ -0,0 +1,193 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "video.dsl/render-plan/v1alpha1",
+  "title": "Render Plan v1alpha1",
+  "description": "DSL 与 Remotion 实现之间的防腐层中间态，包含完整时间线、已解析资产和渲染参数。",
+  "type": "object",
+  "required": ["version", "dslVersion", "timeline", "renderConfig"],
+  "properties": {
+    "version": {
+      "type": "string",
+      "const": "v1alpha1"
+    },
+    "dslVersion": {
+      "type": "string"
+    },
+    "createdAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "status": {
+      "type": "string",
+      "enum": ["planning", "resolving-assets", "assets-ready", "compiling", "rendering", "completed", "failed"],
+      "default": "planning"
+    },
+    "resolvedAssets": {
+      "type": "array",
+      "items": { "$ref": "#/definitions/ResolvedAsset" },
+      "description": "所有已解析/已生成的素材"
+    },
+    "timeline": {
+      "type": "array",
+      "items": { "$ref": "#/definitions/TimelineEntry" },
+      "description": "展开后的时间线条目"
+    },
+    "renderConfig": {
+      "$ref": "#/definitions/RenderConfig"
+    },
+    "remotionProps": {
+      "type": "object",
+      "description": "编译后直接传给 Remotion 的顶层 props",
+      "additionalProperties": true
+    },
+    "errors": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "phase": { "type": "string" },
+          "message": { "type": "string" },
+          "sceneId": { "type": "string" },
+          "assetId": { "type": "string" },
+          "timestamp": { "type": "string", "format": "date-time" }
+        }
+      }
+    },
+    "logs": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "phase": { "type": "string" },
+          "message": { "type": "string" },
+          "timestamp": { "type": "string", "format": "date-time" }
+        }
+      }
+    }
+  },
+  "definitions": {
+    "ResolvedAsset": {
+      "type": "object",
+      "required": ["assetId", "type", "status"],
+      "properties": {
+        "assetId": { "type": "string" },
+        "type": {
+          "type": "string",
+          "enum": ["image", "video", "audio", "avatar", "subtitle", "bgm"]
+        },
+        "source": {
+          "type": "string",
+          "enum": ["existing", "gen-image", "gen-video", "gen-voice", "gen-digital-human"]
+        },
+        "status": {
+          "type": "string",
+          "enum": ["pending", "generating", "generated", "failed", "skipped"]
+        },
+        "url": { "type": "string" },
+        "localPath": { "type": "string" },
+        "duration": { "type": "number" },
+        "width": { "type": "integer" },
+        "height": { "type": "integer" },
+        "mimeType": { "type": "string" },
+        "fileSize": { "type": "integer" },
+        "generatedBy": {
+          "type": "object",
+          "properties": {
+            "skill": { "type": "string" },
+            "model": { "type": "string" },
+            "params": { "type": "object", "additionalProperties": true },
+            "startedAt": { "type": "string", "format": "date-time" },
+            "completedAt": { "type": "string", "format": "date-time" }
+          }
+        },
+        "retryCount": { "type": "integer", "default": 0 },
+        "maxRetries": { "type": "integer", "default": 3 }
+      }
+    },
+    "TimelineEntry": {
+      "type": "object",
+      "required": ["sceneId", "startFrame", "endFrame", "durationFrames"],
+      "properties": {
+        "sceneId": { "type": "string" },
+        "startFrame": { "type": "integer" },
+        "endFrame": { "type": "integer" },
+        "durationFrames": { "type": "integer" },
+        "startTime": { "type": "number", "description": "开始时间（秒）" },
+        "endTime": { "type": "number", "description": "结束时间（秒）" },
+        "compositionId": { "type": "string" },
+        "props": {
+          "type": "object",
+          "additionalProperties": true,
+          "description": "该场景对应的 Remotion props"
+        },
+        "layers": {
+          "type": "array",
+          "items": { "$ref": "#/definitions/Layer" }
+        },
+        "subtitleSegments": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "text": { "type": "string" },
+              "startFrame": { "type": "integer" },
+              "endFrame": { "type": "integer" }
+            }
+          }
+        },
+        "transition": {
+          "type": "object",
+          "properties": {
+            "type": { "type": "string" },
+            "durationFrames": { "type": "integer" }
+          }
+        }
+      }
+    },
+    "Layer": {
+      "type": "object",
+      "required": ["layerId", "type"],
+      "properties": {
+        "layerId": { "type": "string" },
+        "type": {
+          "type": "string",
+          "enum": ["visual", "audio", "text", "overlay"]
+        },
+        "assetId": { "type": "string" },
+        "zIndex": { "type": "integer" },
+        "startFrame": { "type": "integer" },
+        "endFrame": { "type": "integer" },
+        "position": {
+          "type": "object",
+          "properties": {
+            "x": { "type": "number" },
+            "y": { "type": "number" }
+          }
+        },
+        "size": {
+          "type": "object",
+          "properties": {
+            "width": { "type": "number" },
+            "height": { "type": "number" }
+          }
+        },
+        "opacity": { "type": "number", "default": 1 },
+        "animation": { "type": "object", "additionalProperties": true }
+      }
+    },
+    "RenderConfig": {
+      "type": "object",
+      "required": ["width", "height", "fps", "totalFrames"],
+      "properties": {
+        "width": { "type": "integer" },
+        "height": { "type": "integer" },
+        "fps": { "type": "integer" },
+        "totalFrames": { "type": "integer" },
+        "totalDuration": { "type": "number", "description": "总时长（秒）" },
+        "codec": { "type": "string", "default": "h264" },
+        "crf": { "type": "integer", "default": 18 },
+        "outputFormat": { "type": "string", "enum": ["mp4", "webm"], "default": "mp4" }
+      }
+    }
+  }
+}

package/skills/template-bind/video_dsl/schema/template-binding-v1alpha1.json

@@ -0,0 +1,122 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "video.dsl/template-binding/v1alpha1",
+  "title": "Template Binding v1alpha1",
+  "description": "将 Video DSL 中的 scene 绑定到模板的具体 slot，产出可供渲染的绑定结果。",
+  "type": "object",
+  "required": ["version", "dslVersion", "templateId", "bindings"],
+  "properties": {
+    "version": {
+      "type": "string",
+      "const": "v1alpha1"
+    },
+    "dslVersion": {
+      "type": "string",
+      "description": "对应的 Video DSL 版本"
+    },
+    "templateId": {
+      "type": "string",
+      "description": "选中的模板 ID"
+    },
+    "templateName": {
+      "type": "string"
+    },
+    "matchScore": {
+      "type": "number",
+      "minimum": 0,
+      "maximum": 1,
+      "description": "模板匹配得分 0-1"
+    },
+    "matchReason": {
+      "type": "string",
+      "description": "匹配理由说明"
+    },
+    "alternatives": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "templateId": { "type": "string" },
+          "templateName": { "type": "string" },
+          "matchScore": { "type": "number" },
+          "matchReason": { "type": "string" }
+        }
+      },
+      "description": "备选模板列表"
+    },
+    "globalOverrides": {
+      "type": "object",
+      "description": "模板级全局覆写",
+      "properties": {
+        "typography": {
+          "type": "object",
+          "properties": {
+            "titleFont": { "type": "string" },
+            "bodyFont": { "type": "string" },
+            "titleSize": { "type": "integer" },
+            "bodySize": { "type": "integer" },
+            "primaryColor": { "type": "string" },
+            "secondaryColor": { "type": "string" }
+          }
+        },
+        "motionPreset": {
+          "type": "string",
+          "enum": ["minimal", "smooth", "energetic", "cinematic"],
+          "default": "smooth"
+        },
+        "colorScheme": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
+    },
+    "bindings": {
+      "type": "array",
+      "items": { "$ref": "#/definitions/SceneBinding" },
+      "minItems": 1
+    }
+  },
+  "definitions": {
+    "SceneBinding": {
+      "type": "object",
+      "required": ["sceneId", "slotId", "compositionId"],
+      "properties": {
+        "sceneId": {
+          "type": "string",
+          "description": "对应 DSL scene.id"
+        },
+        "slotId": {
+          "type": "string",
+          "description": "模板中的 slot 标识"
+        },
+        "compositionId": {
+          "type": "string",
+          "description": "Remotion Composition ID"
+        },
+        "layoutVariant": {
+          "type": "string",
+          "description": "该场景在模板中的布局变体"
+        },
+        "props": {
+          "type": "object",
+          "description": "传给 Remotion Composition 的场景级 props",
+          "additionalProperties": true
+        },
+        "transitionIn": {
+          "type": "object",
+          "properties": {
+            "type": { "type": "string" },
+            "durationFrames": { "type": "integer" }
+          }
+        },
+        "transitionOut": {
+          "type": "object",
+          "properties": {
+            "type": { "type": "string" },
+            "durationFrames": { "type": "integer" }
+          }
+        }
+      }
+    }
+  }
+}

package/skills/template-bind/video_dsl/schema/template-definition-v1alpha1.json

@@ -0,0 +1,247 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "video.dsl/template-definition/v1alpha1",
+  "title": "Template Definition v1alpha1",
+  "description": "视频模板定义规范，描述模板的匹配条件、slot 绑定规则、默认样式和扩展配置。",
+  "type": "object",
+  "required": ["templateId", "name", "version", "slotMapping", "remotionEntry"],
+  "properties": {
+    "templateId": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9-]*$",
+      "description": "模板唯一标识，kebab-case"
+    },
+    "name": {
+      "type": "string",
+      "description": "模板显示名称"
+    },
+    "description": {
+      "type": "string",
+      "description": "模板用途说明"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$",
+      "description": "语义化版本号"
+    },
+    "supportedAspectRatios": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": ["16:9", "9:16", "1:1", "4:3", "3:4", "21:9"]
+      },
+      "minItems": 1,
+      "description": "支持的宽高比列表"
+    },
+    "supportedDurations": {
+      "type": "object",
+      "properties": {
+        "min": { "type": "number", "minimum": 0, "description": "最短时长（秒）" },
+        "max": { "type": "number", "minimum": 1, "description": "最长时长（秒）" }
+      },
+      "required": ["min", "max"]
+    },
+    "styleTags": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "风格标签，用于匹配 DSL meta.style"
+    },
+    "scenePatterns": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": ["opening", "intro", "point", "example", "explanation", "transition", "highlight", "cta", "ending", "default"]
+      },
+      "description": "模板支持的场景 purpose 类型"
+    },
+    "assetRequirements": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": ["image", "video", "audio", "avatar", "subtitle", "bgm"]
+      },
+      "description": "模板需要的素材类型"
+    },
+    "slotMapping": {
+      "type": "object",
+      "description": "purpose → slot 绑定规则映射，必须包含 default。值可以是完整 SlotDefinition 或 {\"$ref\": \"<purpose>\"} 别名引用另一个 purpose 的定义。",
+      "additionalProperties": {
+        "oneOf": [
+          { "$ref": "#/definitions/SlotDefinition" },
+          { "$ref": "#/definitions/SlotRef" }
+        ]
+      },
+      "required": ["default"]
+    },
+    "defaultTypography": { "$ref": "#/definitions/Typography" },
+    "defaultMotionPreset": {
+      "type": "string",
+      "enum": ["minimal", "smooth", "energetic", "cinematic"],
+      "default": "smooth"
+    },
+    "defaultColorScheme": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "默认配色方案 HEX 值列表"
+    },
+    "remotionEntry": {
+      "type": "object",
+      "description": "按宽高比映射 Remotion 根 Composition ID",
+      "additionalProperties": { "type": "string" }
+    },
+    "themeConfig": {
+      "type": "object",
+      "description": "模板专属主题配置，透传给 Remotion Composition",
+      "additionalProperties": true
+    },
+    "imageStyleGuide": {
+      "$ref": "#/definitions/ImageStyleGuide",
+      "description": "图片生成视觉风格指南，用于增强自动生成的 image prompt"
+    },
+    "constraints": {
+      "type": "object",
+      "description": "模板级约束条件",
+      "additionalProperties": true
+    },
+    "extensions": {
+      "type": "object",
+      "description": "模板专属扩展类型声明（如 slideBlockTypes）",
+      "additionalProperties": true
+    },
+    "compositionMap": {
+      "type": "object",
+      "description": "（已废弃）旧版 purpose → compositionId 映射，请迁移到 slotMapping",
+      "additionalProperties": { "type": "string" }
+    },
+    "slotSchema": {
+      "type": "object",
+      "description": "（已废弃）旧版 slot 描述，请迁移到 slotMapping",
+      "additionalProperties": true
+    }
+  },
+  "definitions": {
+    "SlotRef": {
+      "type": "object",
+      "description": "引用另一个 purpose 的 SlotDefinition，消除重复定义",
+      "required": ["$ref"],
+      "properties": {
+        "$ref": {
+          "type": "string",
+          "description": "目标 purpose 名称，如 \"point\" 或 \"cta\""
+        }
+      },
+      "additionalProperties": false
+    },
+    "SlotDefinition": {
+      "type": "object",
+      "required": ["slotId", "compositionId"],
+      "properties": {
+        "slotId": {
+          "type": "string",
+          "description": "模板 slot 标识"
+        },
+        "compositionId": {
+          "type": "string",
+          "description": "对应 Remotion Composition ID"
+        },
+        "description": {
+          "type": "string"
+        },
+        "propExtractors": {
+          "type": "object",
+          "description": "props 提取规则：propName → 提取配置",
+          "additionalProperties": { "$ref": "#/definitions/PropExtractor" }
+        },
+        "requiredProps": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "必需的 props"
+        },
+        "optionalProps": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "可选的 props"
+        }
+      }
+    },
+    "PropExtractor": {
+      "oneOf": [
+        {
+          "type": "object",
+          "description": "从 textLayers 按 role 提取",
+          "required": ["from", "role"],
+          "properties": {
+            "from": { "type": "string", "const": "textLayers" },
+            "role": { "type": "string" }
+          }
+        },
+        {
+          "type": "object",
+          "description": "从 scene 按点分路径提取",
+          "required": ["from"],
+          "properties": {
+            "from": { "type": "string", "description": "点分路径，如 visuals.background.assetRef" }
+          }
+        }
+      ]
+    },
+    "Typography": {
+      "type": "object",
+      "properties": {
+        "titleFont": { "type": "string" },
+        "bodyFont": { "type": "string" },
+        "titleSize": { "type": "integer" },
+        "bodySize": { "type": "integer" },
+        "primaryColor": { "type": "string" },
+        "secondaryColor": { "type": "string" }
+      }
+    },
+    "ImageStyleGuide": {
+      "type": "object",
+      "description": "图片生成视觉风格指南",
+      "properties": {
+        "baseStyle": {
+          "type": "string",
+          "description": "基础视觉风格描述，追加到所有 prompt 末尾"
+        },
+        "colorDirective": {
+          "type": "string",
+          "description": "色彩方向指令（文字描述，非 HEX）"
+        },
+        "negativePrompt": {
+          "type": "string",
+          "description": "全局负向提示词，描述不希望出现的元素"
+        },
+        "guidanceScale": {
+          "type": "number",
+          "description": "推荐引导系数（如 7.5），控制生成图片对 prompt 的遵循程度"
+        },
+        "purposeOverrides": {
+          "type": "object",
+          "description": "按场景 purpose 覆盖的风格配置",
+          "additionalProperties": {
+            "$ref": "#/definitions/PurposeStyleOverride"
+          }
+        }
+      }
+    },
+    "PurposeStyleOverride": {
+      "type": "object",
+      "description": "针对特定 purpose 的风格覆盖",
+      "properties": {
+        "promptTemplate": {
+          "type": "string",
+          "description": "prompt 模板，支持 {narration_summary} {topic} {style_suffix} {scene_title} 变量"
+        },
+        "styleModifier": {
+          "type": "string",
+          "description": "追加的风格修饰符"
+        },
+        "negativePrompt": {
+          "type": "string",
+          "description": "覆盖全局的负向提示词"
+        }
+      }
+    }
+  }
+}