@dsh-gis/dsh-video-studio-skill 0.8.1 → 1.0.2

package/schemas/film.schema.json

@@ -23,18 +23,7 @@
     },
     "style": {
       "type": "string",
-      "enum": [
-        "auto",
-        "tech-deep",
-        "magazine",
-        "paper",
-        "vivid",
-        "mono",
-        "cinema",
-        "lo-fi",
-        "epic"
-      ],
-      "description": "风格包 id：一套决定画风+配乐+旁白+节奏。“auto”= 按内容自动选；不写这个键 = v0.4 legacy 行为（逐样本兼容）。枚举真值来自 stylekit.STYLES，新增风格时先改那边再改这里"
+      "description": "**已废弃（v1.0.1）**：不再有内置风格表，这个键不决定任何外观，写了也不生效（保留只为了让老剧本继续通过契约校验）。外观的唯一来源是 work/design.json（propose.py --confirm 冻结，渲染前由 designkit.design_to_plan 解析）；没有设计就渲染会明确报错，而不是回落到某个默认风格。这里**故意不放 enum**：v1.0.1 起没有任何合法风格 id 可列，列一份清单只会误导 IDE 补全。"
     },
     "engine": {
       "type": "string",
@@ -239,6 +228,173 @@
           "voice": {
             "type": "string",
             "description": "显式 edge-tts voice id（覆盖 persona 底子）"
+          },
+          "type": {
+            "type": "string",
+            "enum": [
+              "hero",
+              "statement",
+              "list",
+              "stat",
+              "compare",
+              "process",
+              "quote",
+              "chapter",
+              "chart",
+              "outro"
+            ],
+            "description": "视觉场景类型（v0.9，可选）：决定这段画面长成什么构图——hero 封面 / statement 金句 / list 要点列表 / stat 数字卡 / compare 左右对比 / process 流程轴 / quote 引语 / chapter 章节卡 / chart 数据条 / outro 收尾。与 kind **正交**：kind 管声线、语气、配乐能量，type 只管构图，所以没有新增 kind 值；不写 = 由 grammar.py 按内容自动推导（写错值 filmcheck.py 会报 error）。枚举真值来自 grammar.SCENE_TYPES 与 assets/scenes.py 的 _DRAWERS 键，改那边要同步这里"
+          },
+          "quote": {
+            "type": "string",
+            "description": "引语原文（type=quote 时用）：打在屏幕上的引文。它和 text 是两件事——text 是 TTS 念的那句，quote 是画面上那句话本身"
+          },
+          "by": {
+            "type": "string",
+            "description": "引语出处/作者（type=quote 时用），如“—— 某本书 · 某作者”；与 quote 配套，缺省不画署名"
+          },
+          "stats": {
+            "type": "array",
+            "description": "数字卡原料（type=stat）：每项 {value, unit, label, note}。value 必填（数字或字符串，字符串用于“>3x”“1/2”这类写法）；unit 是单位后缀，label 是指标名，note 是小字补充",
+            "items": {
+              "type": "object",
+              "required": [
+                "value"
+              ],
+              "additionalProperties": true,
+              "properties": {
+                "value": {
+                  "type": [
+                    "number",
+                    "string"
+                  ],
+                  "description": "数字主体（必填）：数字，或“>3x”“1/2”这类字符串写法"
+                },
+                "unit": {
+                  "type": "string",
+                  "description": "单位/后缀，如“秒”“%”“fps”"
+                },
+                "label": {
+                  "type": "string",
+                  "description": "指标名，如“帧率”"
+                },
+                "note": {
+                  "type": "string",
+                  "description": "补充说明（小字），可省略"
+                }
+              }
+            }
+          },
+          "series": {
+            "type": "array",
+            "description": "数据条原料（type=chart）：每项 {label, value, unit}。label 是条形名（必填），value 是条长（必填，数字或数值字符串）",
+            "items": {
+              "type": "object",
+              "required": [
+                "label",
+                "value"
+              ],
+              "additionalProperties": true,
+              "properties": {
+                "label": {
+                  "type": "string",
+                  "description": "条形名（必填）"
+                },
+                "value": {
+                  "type": [
+                    "number",
+                    "string"
+                  ],
+                  "description": "条长（必填）：数字或数值字符串（“0.8”“80%”由绘制器解析）"
+                },
+                "unit": {
+                  "type": "string",
+                  "description": "单位/后缀，如“GB”“%”"
+                }
+              }
+            }
+          },
+          "steps": {
+            "type": "array",
+            "description": "流程轴原料（type=process）：每项 {label, note}，数组顺序即节点顺序",
+            "items": {
+              "type": "object",
+              "required": [
+                "label"
+              ],
+              "additionalProperties": true,
+              "properties": {
+                "label": {
+                  "type": "string",
+                  "description": "节点名（必填）"
+                },
+                "note": {
+                  "type": "string",
+                  "description": "节点补充说明（小字），可省略"
+                }
+              }
+            }
+          },
+          "sides": {
+            "type": "object",
+            "additionalProperties": true,
+            "description": "左右对比原料（type=compare）：{left, right}，每侧 {head, items[]}；items 里每项可写字符串，也可写对象 {text}（两种都认：短条目直接写字符串更省事）",
+            "properties": {
+              "left": {
+                "type": "object",
+                "additionalProperties": true,
+                "description": "左侧",
+                "properties": {
+                  "head": {
+                    "type": "string",
+                    "description": "左侧小标题"
+                  },
+                  "items": {
+                    "type": "array",
+                    "description": "左侧条目：字符串或对象 {text} 两种写法都行",
+                    "items": {
+                      "type": [
+                        "string",
+                        "object"
+                      ],
+                      "properties": {
+                        "text": {
+                          "type": "string",
+                          "description": "条目文字（写对象时用它；写字符串时字符串本身就是文字）"
+                        }
+                      }
+                    }
+                  }
+                }
+              },
+              "right": {
+                "type": "object",
+                "additionalProperties": true,
+                "description": "右侧",
+                "properties": {
+                  "head": {
+                    "type": "string",
+                    "description": "右侧小标题"
+                  },
+                  "items": {
+                    "type": "array",
+                    "description": "右侧条目：字符串或对象 {text} 两种写法都行",
+                    "items": {
+                      "type": [
+                        "string",
+                        "object"
+                      ],
+                      "properties": {
+                        "text": {
+                          "type": "string",
+                          "description": "条目文字（写对象时用它；写字符串时字符串本身就是文字）"
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+            }
           }
         }
       }
@@ -373,7 +529,7 @@
     "music": {
       "type": "object",
       "additionalProperties": true,
-      "description": "配乐：scorekit 程序化生成 / v0.2 和弦床 / 外部 wav / 关掉。不写 mode 时走 v0.2 兼容链（有 bpm 就生成，没有就沿用）",
+      "description": "配乐：musicgen 按参数现场编排 / v0.2 和弦床 / 外部 wav / 关掉。不写 mode 时走兼容链（有 bpm 就生成，没有就沿用）。v1.0.1 起没有配乐风格表，不要指望选一个 id 得到一种现成配乐",
       "properties": {
         "enabled": {
           "type": "boolean",
@@ -387,11 +543,11 @@
             "file",
             "off"
           ],
-          "description": "score = scorekit 程序化配乐；bed = v0.2 和弦床；file = 用外部 work/music.wav；off = 不要配乐（不读也不删 music.wav）"
+          "description": "score = musicgen 参数化编排（bpm/key/scale/mood/sections 全可写）；bed = v0.2 和弦床；file = 用外部 work/music.wav；off = 不要配乐（不读也不删 music.wav）"
         },
         "style": {
           "type": "string",
-          "description": "\"auto\" 或风格 id：配乐风格（缺省跟随全片 style）"
+          "description": "已废弃：v1.0.1 删除了配乐风格表，写风格 id 没有意义（保留字段只为老剧本校验不失败）"
         },
         "mood": {
           "type": "string",

package/schemas/proposal.schema.json

@@ -0,0 +1,133 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "$id": "https://github.com/znlgis/dsh-video-studio-skill/schemas/proposal.schema.json",
+ "title": "video-studio proposal（v1.0 提案）",
+ "description": "work/proposal.json：一次提案的 N 个候选 + 用户确认状态。status=confirmed 才允许出片。",
+ "type": "object",
+ "required": [
+  "schema",
+  "rev",
+  "status",
+  "candidates"
+ ],
+ "additionalProperties": true,
+ "properties": {
+  "schema": {
+   "type": "integer",
+   "const": 1
+  },
+  "rev": {
+   "type": "integer",
+   "minimum": 1
+  },
+  "parentRev": {
+   "type": [
+    "integer",
+    "null"
+   ]
+  },
+  "at": {
+   "type": "string"
+  },
+  "status": {
+   "type": "string",
+   "enum": [
+    "draft",
+    "confirmed",
+    "rejected"
+   ]
+  },
+  "chosen": {
+   "type": [
+    "string",
+    "null"
+   ],
+   "description": "confirmed 时必填的候选 id"
+  },
+  "confirmedAt": {
+   "type": "string"
+  },
+  "confirmedBy": {
+   "type": "string"
+  },
+  "confirmNote": {
+   "type": "string"
+  },
+  "designHash": {
+   "type": "string",
+   "description": "确认时 design.json 的指纹（用于判 stale）"
+  },
+  "brief": {
+   "type": "object"
+  },
+  "feedback": {
+   "type": "string"
+  },
+  "seed": {},
+  "wall_s": {
+   "type": "number"
+  },
+  "candidates": {
+   "type": "array",
+   "minItems": 2,
+   "items": {
+    "type": "object",
+    "required": [
+     "id",
+     "design",
+     "design_fp"
+    ],
+    "properties": {
+     "id": {
+      "type": "string",
+      "pattern": "^[A-H][0-9]*$"
+     },
+     "label": {
+      "type": "string"
+     },
+     "pitch": {
+      "type": "string"
+     },
+     "design": {
+      "type": "object"
+     },
+     "design_fp": {
+      "type": "string"
+     },
+     "preview": {
+      "type": "object"
+     },
+     "cost": {
+      "type": "object"
+     },
+     "diversity": {
+      "type": [
+       "object",
+       "null"
+      ]
+     }
+    }
+   }
+  }
+ },
+ "allOf": [
+  {
+   "if": {
+    "properties": {
+     "status": {
+      "const": "confirmed"
+     }
+    },
+    "required": [
+     "status"
+    ]
+   },
+   "then": {
+    "required": [
+     "chosen",
+     "designHash"
+    ]
+   }
+  }
+ ]
+}