create-dwy 0.16.1 → 0.17.0

package/templates/ai-tools/skills//350/207/252/345/252/222/344/275/223/uc-media-0070-package/shots.schema.json

@@ -0,0 +1,186 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://my-channel.local/schemas/media-package-shots-v1.json",
+  "title": "media package shots.json",
+  "description": "0070 成片施工图（机读）。0080/配音/渲染只认本结构。version 必须为 1。",
+  "type": "object",
+  "required": ["version", "fps", "width", "height", "chapters", "shots"],
+  "additionalProperties": true,
+  "properties": {
+    "version": {
+      "type": "integer",
+      "const": 1,
+      "description": "Schema 主版本。不兼容变更时递增。"
+    },
+    "fps": { "type": "number", "exclusiveMinimum": 0 },
+    "width": { "type": "integer", "minimum": 1 },
+    "height": { "type": "integer", "minimum": 1 },
+    "visual_style": { "type": "string" },
+    "playback_rule": {
+      "type": "string",
+      "description": "如 progressive_reveal"
+    },
+    "asset_root": {
+      "type": "string",
+      "description": "素材根相对 episode 或 work_dir，如 media/assets 或 制作/assets"
+    },
+    "cue_timeline_file": {
+      "type": "string",
+      "description": "可选。知识小城等精确对轨风格的机读真源，如 media/0070-package/cue-timeline.json。"
+    },
+    "voiceover": {
+      "type": "object",
+      "description": "可选。场景级旁白的文件与时码状态；真实音频生成后必须更新 timing_status。",
+      "properties": {
+        "file": {"type": "string"},
+        "timing_status": {"type": "string", "enum": ["estimated", "aligned_to_audio"]}
+      },
+      "additionalProperties": true
+    },
+    "total_duration_sec": { "type": "number", "minimum": 0 },
+    "total_duration_frames": { "type": "integer", "minimum": 0 },
+    "source": {
+      "type": "object",
+      "description": "上游追溯",
+      "properties": {
+        "script_dir": { "type": "string" },
+        "assets_dir": { "type": "string" },
+        "vo_file": { "type": "string" },
+        "storyboard_file": { "type": "string" },
+        "elements_file": { "type": "string" }
+      },
+      "additionalProperties": true
+    },
+    "chapters": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "required": ["chapter_id", "letter", "title", "shot_ids"],
+        "additionalProperties": true,
+        "properties": {
+          "chapter_id": { "type": "string", "minLength": 1 },
+          "letter": { "type": "string", "minLength": 1 },
+          "title": { "type": "string" },
+          "target_sec": { "type": "number", "minimum": 0 },
+          "shot_ids": {
+            "type": "array",
+            "minItems": 1,
+            "items": { "type": "string", "minLength": 1 }
+          }
+        }
+      }
+    },
+    "shots": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "$ref": "#/$defs/shot" }
+    }
+  },
+  "$defs": {
+    "shot": {
+      "type": "object",
+      "required": [
+        "shot_id",
+        "chapter_id",
+        "order",
+        "vo_text",
+        "duration_sec",
+        "duration_frames"
+      ],
+      "additionalProperties": true,
+      "properties": {
+        "shot_id": {
+          "type": "string",
+          "pattern": "^[A-Z][0-9]{2}$",
+          "description": "全局唯一镜号，如 A00、B01、P03"
+        },
+        "chapter_id": { "type": "string", "minLength": 1 },
+        "chapter_letter": { "type": "string" },
+        "order": { "type": "integer", "minimum": 0 },
+        "vo_text": {
+          "type": "string",
+          "minLength": 1,
+          "description": "本镜口播全文；配音唯一念白源"
+        },
+        "duration_sec": { "type": "number", "exclusiveMinimum": 0 },
+        "duration_frames": {
+          "type": "integer",
+          "exclusiveMinimum": 0,
+          "description": "应 ≈ round(duration_sec * fps)"
+        },
+        "fps": { "type": "number", "exclusiveMinimum": 0 },
+        "main_visual": { "type": "string" },
+        "visual_delta": { "type": "string" },
+        "reveal": {
+          "type": "string",
+          "description": "如 add | hold | replace"
+        },
+        "builds_on": {
+          "type": ["string", "null"],
+          "description": "上一镜 shot_id；章首可为 null"
+        },
+        "motion": {
+          "type": "object",
+          "properties": {
+            "preset": {
+              "type": "string",
+              "enum": [
+                "hold",
+                "fade_up",
+                "scale_in",
+                "draw_on",
+                "highlight_pulse",
+                "slide_in",
+                "crossfade"
+              ]
+            },
+            "target": { "type": "string" },
+            "window": {
+              "type": "object",
+              "properties": {
+                "start": { "type": "number", "minimum": 0, "maximum": 1 },
+                "end": { "type": "number", "minimum": 0, "maximum": 1 }
+              },
+              "additionalProperties": true
+            },
+            "hold_after_sec": { "type": "number", "minimum": 0 }
+          },
+          "additionalProperties": true
+        },
+        "on_screen_text": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "assets": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["role", "path"],
+            "additionalProperties": true,
+            "properties": {
+              "role": {
+                "type": "string",
+                "description": "bg | content | sticker | logo | main | …"
+              },
+              "path": { "type": "string", "minLength": 1 },
+              "enter_order": { "type": "integer", "minimum": 0 },
+              "type_only": { "type": "boolean" }
+            }
+          }
+        },
+        "sfx": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "cue_ids": {
+          "type": "array",
+          "description": "可选。对应 cue-timeline.json 的 cueId；Remotion 用此建立镜头与字幕/音频映射。",
+          "items": {"type": "string", "minLength": 1}
+        },
+        "elements_ref": { "type": "string" },
+        "notes": { "type": "string" }
+      }
+    }
+  }
+}

package/templates/ai-tools/skills//350/207/252/345/252/222/344/275/223/uc-media-0070-package//344/272/272/345/256/241/345/214/205.template.md

@@ -0,0 +1 @@
+> 已并入 [`成片包.template.md`](./成片包.template.md)。每集只产 **成片包.md**，不再单独产人审包.md。

package/templates/ai-tools/skills//350/207/252/345/252/222/344/275/223/uc-media-0070-package//344/272/272/345/256/241/350/257/264/346/230/216.md

@@ -0,0 +1,15 @@
+# 人审说明（skill 内指南）
+
+| 看什么 | 路径 |
+|--------|------|
+| 进度 | `执行清单.md` |
+| 事实 | `0030-facts/事实-*.md` |
+| 脚本 | `0040-script/脚本-*.md` |
+| 设计 | `0050-design/design-lock.md` |
+| 素材 | `0060-assets/素材清单.md` |
+| **冻结（优先）** | **`0070-package/成片包.md`** |
+| 机读 | `0070-package/shots.json` |
+| 工厂 | `0080-factory/适配说明.md`（**用户选** remotion / hyperframe） |
+
+录音认成片包 / `vo_text`；工厂不得改口播语义。  
+校验：`python …/uc-media-0070-package/scripts/validate_shots.py …/0070-package/shots.json`

package/templates/ai-tools/skills//350/207/252/345/252/222/344/275/223/uc-media-0070-package//346/210/220/347/211/207/345/214/205.template.md

@@ -0,0 +1,49 @@
+# 成片包 · {主题}
+
+| 项 | 内容 |
+|----|------|
+| 总时长 | _ s / _ 帧 |
+| 画幅 · fps | 1920×1080 · 30 |
+| style_id | （自 design-lock） |
+| production_stack | remotion / hyperframe / … |
+| shots.json | version=1 · 校验：OK / 失败原因 |
+| cue-timeline.json | 可选；知识小城风格必填 · 校验：OK / 失败原因 |
+| 旁白时码 | `estimated` / `aligned_to_audio` |
+| 上游脚本 | `../0040-script/脚本-….md` |
+| 上游 design | `../0050-design/design-lock.md` |
+| 上游素材清单 | `../0060-assets/素材清单.md` |
+
+---
+
+## 1. 脉络摘要
+
+**主线：** …  
+
+| 章 | 标题 | 记住一句 | 秒 |
+|----|------|----------|-----|
+| | | | |
+
+---
+
+## 2. 录音总表（播放序）
+
+| 镜号 | 章 | 秒 | 口播全文 | 主视觉 | 素材就绪 |
+|------|----|----|----------|--------|----------|
+| A00 | | | | | ✅/⚠ |
+
+---
+
+## 3. 风险与缺口
+
+-  
+
+---
+
+## 4. 签字
+
+- [ ] 脉络 OK  
+- [ ] 口播可念、无说教腔  
+- [ ] 镜号与素材对齐  
+- [ ] **可以开录 / 可以进工厂适配**  
+
+审阅：________  日期：________

package/templates/ai-tools/skills//350/207/252/345/252/222/344/275/223/uc-media-0080-factory/SKILL.md

@@ -0,0 +1,58 @@
+---
+name: uc-media-0080-factory
+description: |
+  工厂适配（0080）：package 冻结后，由用户选择 Remotion 或 HyperFrame 生成/映射工程。
+  触发词：Remotion、HyperFrame、工厂、适配、出片工程、0080。
+  不要用于：改口播语义、改事实、当 flow。
+---
+
+# uc-media-0080-factory · 工厂适配
+
+> **可单独执行。** 上游须有合法 `0070-package/shots.json`。
+
+**上游 schema：** [`../uc-media-0070-package/shots.schema.json`](../uc-media-0070-package/shots.schema.json)
+
+## 行为（本 skill 内聚）
+
+1. validate package；读 design 偏好；**选型确认后**映射/脚手架、写 `适配说明.md`。  
+2. **工厂未确认 → 停，不写工程**。  
+3. 不发明镜号、不私自改 vo/秒。  
+
+---
+
+## 大步骤契约
+
+| 项 | 内容 |
+|----|------|
+| **序** | 0080 |
+| **stage** | `factory` |
+| **上游** | `0070-package/shots.json` validate OK |
+| **主文档** | **`0080-factory/适配说明.md`** |
+| **工程目录** | `{episode_dir}/remotion/` **或** `hyperframe/` |
+| **禁止** | 静默替用户选定工厂 |
+
+## 0. 用户选择工厂（硬停）
+
+| 选项 | 工程根 |
+|------|--------|
+| **A. Remotion** | `{episode_dir}/remotion/` |
+| **B. HyperFrame** | `{episode_dir}/hyperframe/` |
+
+## 1. 校验
+
+```bash
+# 校验脚本在兄弟 skill（sync 后与本 skill 同级）
+python3 ../uc-media-0070-package/scripts/validate_shots.py \
+  "{work_dir}/0070-package/shots.json"
+```
+
+失败 → 回 0070。
+
+## 2. 适配说明.md
+
+选型 · 上游路径 · 校验 · 工程根 · 镜号映射 · 已做/未做 ·「改口播回 0040/0070」
+
+## 3A/3B
+
+Remotion：同号映射 · frames · durations/catalog  
+HyperFrame：按模板映射；无模板列缺口